View.DispatchPopulateAccessibilityEvent(AccessibilityEvent) Methode

Definition

Namespace:: Android.Views

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Verteilt ein Objekt AccessibilityEvent an das View Element, um den Textinhalt der Ansicht und seiner untergeordneten Elemente hinzuzufügen.

[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

Parameter

e: AccessibilityEvent

Das Ereignis.

Gibt zurück

Boolean

True, wenn die Ereignispopulation abgeschlossen wurde.

Attribute: RegisterAttribute

Hinweise

Verteilt ein Objekt AccessibilityEvent an das View Element, um den Textinhalt der Ansicht und seiner untergeordneten Elemente hinzuzufügen.

Hinweis: Diese Methode sollte nur mit event.setText() verwendet werden. Vermeiden Sie das Stummschalten eines anderen Ereigniszustands in dieser Methode. Fügen Sie im Allgemeinen UI-Metadaten in den Knoten ein, damit Dienste auf einfache Weise abfragen können. <ul><li> Wenn Sie andere Ereigniseigenschaften ändern, können Sie die Semantik-Barrierefreiheitsdienste möglicherweise vermeiden. Senden Sie stattdessen ein separates Ereignis mithilfe #sendAccessibilityEvent(int) und Überschreiben #onInitializeAccessibilityEvent(AccessibilityEvent). </li li><>Wenn Sie nach Typ AccessibilityEvent#TYPE_WINDOW_STATE_CHANGED suchen, um Fenster-/Titelankündigungen zu generieren, verursachen Sie möglicherweise störende Ankündigungen (oder überhaupt keine Ankündigungen). Folgen Sie stattdessen den in View#announceForAccessibility(CharSequence). Hinweis: Dadurch wird kein Aufruf von announceForAccessibility() vorgeschlagen, sondern die in der Dokumentation aufgeführten Vorschläge verwendet. </li li><>Wenn Sie Änderungen basierend auf dem Status der Barrierefreiheit vornehmen, z. B. die Überprüfung auf einen Ereignistyp, um ein Ui-Update auszulösen, während gut beabsichtigt, erstellen Sie spröde, weniger gut gepflegten Code, der für einige Benutzer funktioniert, aber nicht für andere. Nutzen Sie stattdessen vorhandenen Code für gerechte Erfahrungen und weniger technische Schulden. Ein Beispiel finden Sie unter AccessibilityManager#isEnabled(). </li></ul>

Beachten Sie, dass der Ereignistext in einem separaten Verteilerpfad (#onPopulateAccessibilityEvent(AccessibilityEvent)) aufgefüllt wird, da wir dem Ereignis nicht nur den Text der Quelle, sondern auch den Text aller untergeordneten Elemente hinzufügen.

Eine typische Implementierung ruft #onPopulateAccessibilityEvent(AccessibilityEvent) diese Ansicht auf und ruft dann die #dispatchPopulateAccessibilityEvent(AccessibilityEvent) einzelnen untergeordneten elemente oder das erste untergeordnete Element auf, das sichtbar ist. Überschreiben Sie diese Methode, wenn eine benutzerdefinierte Grundgesamtheit des Ereignistextinhalts erforderlich ist.

Wenn ein AccessibilityDelegate Anruf angegeben #setAccessibilityDelegate(AccessibilityDelegate) wurde, ist er AccessibilityDelegate#dispatchPopulateAccessibilityEvent(View, AccessibilityEvent) für die Behandlung dieses Anrufs verantwortlich.

Wenn diese Ansicht festgelegt wird #isAccessibilityDataSensitive() , sollte diese Ansicht nur vertrauliche Informationen an ein Ereignis anfügen, das ebenfalls festgelegt wird AccessibilityEvent#isAccessibilityDataSensitive().

Hinweis: Barrierefreiheitsereignisse bestimmter Typen werden nicht zum Auffüllen des Ereignistexts über diese Methode verteilt. Weitere Informationen finden Sie unter AccessibilityEvent.

Java Dokumentation für android.view.View.dispatchPopulateAccessibilityEvent(android.view.accessibility.AccessibilityEvent).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: