View.AccessibilityLiveRegion Propiedad

public virtual Android.Views.AccessibilityLiveRegion AccessibilityLiveRegion { [Android.Runtime.Register("getAccessibilityLiveRegion", "()I", "GetGetAccessibilityLiveRegionHandler")] get; [Android.Runtime.Register("setAccessibilityLiveRegion", "(I)V", "GetSetAccessibilityLiveRegion_IHandler")] set; }

[<get: Android.Runtime.Register("getAccessibilityLiveRegion", "()I", "GetGetAccessibilityLiveRegionHandler")>]
[<set: Android.Runtime.Register("setAccessibilityLiveRegion", "(I)V", "GetSetAccessibilityLiveRegion_IHandler")>]
member this.AccessibilityLiveRegion : Android.Views.AccessibilityLiveRegion with get, set

Valor de propiedad

Modo de región activa para la vista.

Atributos

RegisterAttribute

Comentarios

Documentación del captador de propiedades:

Obtiene el modo de región activa para esta vista.

Java documentación para android.view.View.getAccessibilityLiveRegion().

Documentación del establecedor de propiedades:

Establece el modo de región activa para esta vista. Esto indica a los servicios de accesibilidad si deben notificar automáticamente al usuario los cambios en la descripción o el texto del contenido de la vista, o en las descripciones de contenido o el texto de los elementos secundarios de la vista (si procede).

Hay diferentes niveles de prioridad disponibles: ul<>li<>: #ACCESSIBILITY_LIVE_REGION_POLITEindica que las actualizaciones de la región deben presentarse al usuario. Adecuado en la mayoría de los casos para actualizaciones destacadas dentro del contenido de la aplicación que no requieren la atención inmediata del usuario. </li li><>#ACCESSIBILITY_LIVE_REGION_ASSERTIVE: indica que las actualizaciones de la región tienen la prioridad más alta y deben presentarse al usuario inmediatamente. Esto puede dar lugar a notificaciones perjudiciales de un servicio de accesibilidad, lo que puede interrumpir otros comentarios o acciones del usuario, por lo que generalmente solo se debe usar para información crítica y sensible al tiempo. </li><li>#ACCESSIBILITY_LIVE_REGION_NONE: deshabilita los anuncios de cambio (el valor predeterminado para la mayoría de las vistas). </li></ul>

Ejemplos: <ul><li> Selecting an option in a dropdown menu updates a panel below with the updated content. Este panel se puede marcar como una región activa con #ACCESSIBILITY_LIVE_REGION_POLITE para notificar a los usuarios el cambio. Un lector de pantalla puede poner en cola los cambios como anuncios que no interrumpen la voz en curso. </li li><> Una alerta de emergencia puede marcarse con #ACCESSIBILITY_LIVE_REGION_ASSERTIVE para informar inmediatamente a los usuarios de la emergencia. </li></ul>

Para las notificaciones de error, como una advertencia de "contraseña incorrecta" en una pantalla de inicio de sesión, las vistas deben enviar con AccessibilityEvent#TYPE_WINDOW_CONTENT_CHANGEDAccessibilityEvent un tipo AccessibilityEvent#CONTENT_CHANGE_TYPE_ERROR de cambio de contenido y establecer AccessibilityNodeInfo#setError(CharSequence). Los widgets personalizados deben proporcionar métodos de configuración de errores que admitan la accesibilidad. Por ejemplo, use android.widget.TextView#setError(CharSequence) en lugar de enviar eventos explícitamente.

No use regiones activas para actualizar con frecuencia elementos de la interfaz de usuario (por ejemplo, barras de progreso), ya que esto puede sobrecargar al usuario con comentarios de los servicios de accesibilidad. Si es necesario, use AccessibilityNodeInfo#setMinDurationBetweenContentChanges(Duration) para limitar los comentarios y reducir las interrupciones.

<aparte><b>Nota:</b> Se usa androidx.core.view.ViewCompat#setAccessibilityLiveRegion(View, int) para la compatibilidad con versiones anteriores. </aside>

Java documentación para android.view.View.setAccessibilityLiveRegion(int).

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.

Consulte también

• AccessibilityLiveRegion