View.AnnounceForAccessibility Método

[Android.Runtime.Register("announceForAccessibility", "(Ljava/lang/CharSequence;)V", "GetAnnounceForAccessibility_Ljava_lang_CharSequence_Handler")]
public virtual void AnnounceForAccessibility(Java.Lang.ICharSequence? text);

[<Android.Runtime.Register("announceForAccessibility", "(Ljava/lang/CharSequence;)V", "GetAnnounceForAccessibility_Ljava_lang_CharSequence_Handler")>]
abstract member AnnounceForAccessibility : Java.Lang.ICharSequence -> unit
override this.AnnounceForAccessibility : Java.Lang.ICharSequence -> unit

Parámetros

Atributos

RegisterAttribute

Comentarios

Método de conveniencia para enviar un AccessibilityEvent#TYPE_ANNOUNCEMENTAccessibilityEvent para sugerir que un servicio de accesibilidad anuncie el texto especificado a sus usuarios.

Nota: El evento generado con esta API no tiene ningún significado semántico y solo es adecuado en situaciones excepcionales. Por lo general, las aplicaciones pueden lograr un comportamiento correcto para la accesibilidad proporcionando con precisión la semántica de su interfaz de usuario. No deben tener que especificar lo que se anuncia exactamente a los usuarios.

En general, solo anuncia transiciones y no genera un mensaje de confirmación para acciones simples como una pulsación de botón. Etiquete los controles de forma concisa y precisa en su lugar, y para cambios significativos de la interfaz de usuario, como los cambios de ventana, use android.app.Activity#setTitle(CharSequence) y #setAccessibilityPaneTitle(CharSequence).

Use #setAccessibilityLiveRegion(int) para informar al usuario de los cambios en las vistas críticas dentro de la interfaz de usuario. Todavía se deben usar con moderación, ya que pueden generar anuncios cada vez que se actualiza una vista.

Para notificar a los usuarios los errores, como en una pantalla de inicio de sesión con texto que muestra una notificación de "contraseña incorrecta", esa vista debe enviar un AccessibilityEvent de tipo AccessibilityEvent#CONTENT_CHANGE_TYPE_ERROR y establecer AccessibilityNodeInfo#setError(CharSequence) en su lugar. Los widgets personalizados deben exponer métodos de configuración de errores que admiten la accesibilidad automáticamente. Por ejemplo, en lugar de enviar explícitamente este evento cuando se usa textView, use android.widget.TextView#setError(CharSequence).

Use #setStateDescription(CharSequence) para transmitir los cambios de estado a las vistas dentro de la interfaz de usuario. Aunque una región activa puede enviar diferentes tipos de eventos generados por la vista, la descripción del estado enviará AccessibilityEvent#TYPE_WINDOW_CONTENT_CHANGED eventos de tipo AccessibilityEvent#CONTENT_CHANGE_TYPE_STATE_DESCRIPTION.

Java documentación para android.view.View.announceForAccessibility(java.lang.CharSequence).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

public void AnnounceForAccessibility(string? text);

member this.AnnounceForAccessibility : string -> unit

Parámetros

Comentarios

Método de conveniencia para enviar un AccessibilityEvent#TYPE_ANNOUNCEMENTAccessibilityEvent para sugerir que un servicio de accesibilidad anuncie el texto especificado a sus usuarios.

Nota: El evento generado con esta API no tiene ningún significado semántico y solo es adecuado en situaciones excepcionales. Por lo general, las aplicaciones pueden lograr un comportamiento correcto para la accesibilidad proporcionando con precisión la semántica de su interfaz de usuario. No deben tener que especificar lo que se anuncia exactamente a los usuarios.

En general, solo anuncia transiciones y no genera un mensaje de confirmación para acciones simples como una pulsación de botón. Etiquete los controles de forma concisa y precisa en su lugar, y para cambios significativos de la interfaz de usuario, como los cambios de ventana, use android.app.Activity#setTitle(CharSequence) y #setAccessibilityPaneTitle(CharSequence).

Use #setAccessibilityLiveRegion(int) para informar al usuario de los cambios en las vistas críticas dentro de la interfaz de usuario. Todavía se deben usar con moderación, ya que pueden generar anuncios cada vez que se actualiza una vista.

Para notificar a los usuarios los errores, como en una pantalla de inicio de sesión con texto que muestra una notificación de "contraseña incorrecta", esa vista debe enviar un AccessibilityEvent de tipo AccessibilityEvent#CONTENT_CHANGE_TYPE_ERROR y establecer AccessibilityNodeInfo#setError(CharSequence) en su lugar. Los widgets personalizados deben exponer métodos de configuración de errores que admiten la accesibilidad automáticamente. Por ejemplo, en lugar de enviar explícitamente este evento cuando se usa textView, use android.widget.TextView#setError(CharSequence).

Use #setStateDescription(CharSequence) para transmitir los cambios de estado a las vistas dentro de la interfaz de usuario. Aunque una región activa puede enviar diferentes tipos de eventos generados por la vista, la descripción del estado enviará AccessibilityEvent#TYPE_WINDOW_CONTENT_CHANGED eventos de tipo AccessibilityEvent#CONTENT_CHANGE_TYPE_STATE_DESCRIPTION.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.