View.DispatchPopulateAccessibilityEvent(AccessibilityEvent) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Envía a AccessibilityEventView para agregar el contenido de texto de la vista y sus elementos secundarios.
[Android.Runtime.Register("dispatchPopulateAccessibilityEvent", "(Landroid/view/accessibility/AccessibilityEvent;)Z", "GetDispatchPopulateAccessibilityEvent_Landroid_view_accessibility_AccessibilityEvent_Handler")]
public virtual bool DispatchPopulateAccessibilityEvent(Android.Views.Accessibility.AccessibilityEvent? e);
[<Android.Runtime.Register("dispatchPopulateAccessibilityEvent", "(Landroid/view/accessibility/AccessibilityEvent;)Z", "GetDispatchPopulateAccessibilityEvent_Landroid_view_accessibility_AccessibilityEvent_Handler")>]
abstract member DispatchPopulateAccessibilityEvent : Android.Views.Accessibility.AccessibilityEvent -> bool
override this.DispatchPopulateAccessibilityEvent : Android.Views.Accessibility.AccessibilityEvent -> bool
Parámetros
Evento .
Devoluciones
True si se completó el rellenado de eventos.
- Atributos
Comentarios
Envía a AccessibilityEventView para agregar el contenido de texto de la vista y sus elementos secundarios.
<b>Nota:</b> Este método solo debe usarse con event.setText(). Evite la mutación de otro estado de evento en este método. En general, coloque los metadatos de la interfaz de usuario en el nodo para que los servicios puedan consultar fácilmente.
<ul><li> Si va a modificar otras propiedades de evento, es posible que esté eliminando los servicios de accesibilidad semántica. En su lugar, envíe un evento independiente mediante #sendAccessibilityEvent(int) e invalide #onInitializeAccessibilityEvent(AccessibilityEvent).
</li li><>Si está comprobando el tipo AccessibilityEvent#TYPE_WINDOW_STATE_CHANGED para generar anuncios de ventana o título, es posible que esté causando anuncios perjudiciales (o que no realice ningún anuncio). En su lugar, siga las prácticas descritas en View#announceForAccessibility(CharSequence).
<b>Nota:</b> esto no sugiere llamar a announceForAccessibility(), pero usando las sugerencias enumeradas en su documentación.
</li li><>Si va a realizar cambios en función del estado de accesibilidad, como comprobar un tipo de evento para desencadenar una actualización de la interfaz de usuario, mientras está creando código frágil y menos bien mantenido que funciona para algunos usuarios, pero no para otros. En su lugar, aproveche el código existente para experiencias equitativas y menos deuda técnica. Consulte AccessibilityManager#isEnabled() para obtener un ejemplo.
</li></ul>
Tenga en cuenta que el texto del evento se rellena en una ruta de acceso de distribución independiente (#onPopulateAccessibilityEvent(AccessibilityEvent)), ya que agregamos al evento no solo el texto del origen, sino también el texto de todos sus descendientes.
Una implementación típica llamará a #onPopulateAccessibilityEvent(AccessibilityEvent) en esta vista y, a continuación, llamará a #dispatchPopulateAccessibilityEvent(AccessibilityEvent) en cada elemento secundario o en el primer elemento secundario que esté visible. Invalide este método si se requiere un rellenado personalizado del contenido del texto del evento.
Si se ha especificado un AccessibilityDelegate objeto mediante una llamada #setAccessibilityDelegate(AccessibilityDelegate) a su AccessibilityDelegate#dispatchPopulateAccessibilityEvent(View, AccessibilityEvent) es responsable de controlar esta llamada.
Si esta vista establece #isAccessibilityDataSensitive() , esta vista solo debe anexar información confidencial a un evento que también establece AccessibilityEvent#isAccessibilityDataSensitive().
<em>Note:</em> Accessibility events of certain types are not dispatched for populing the event text via this method. Para obtener más información, consulte AccessibilityEvent.
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.