View.AnnounceForAccessibility Methode

[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

Parameter

Attribute

RegisterAttribute

Hinweise

Convenience-Methode zum Senden eines AccessibilityEvent#TYPE_ANNOUNCEMENTAccessibilityEvent , um vorzuschlagen, dass ein Barrierefreiheitsdienst den angegebenen Text an seine Benutzer angibt.

Hinweis: Das mit dieser API generierte Ereignis hat keine semantische Bedeutung und ist nur in Ausnahmefällen angemessen. Apps können in der Regel das richtige Verhalten für die Barrierefreiheit erzielen, indem sie die Semantik ihrer Benutzeroberfläche genau bereitstellen. Sie sollten nicht angeben müssen, was genau den Benutzern angekündigt wird.

Im Allgemeinen werden nur Übergänge angekündigt und keine Bestätigungsmeldung für einfache Aktionen wie ein Schaltflächendruck generiert. Beschriften Sie ihre Steuerelemente präzise und präzise, und für erhebliche UI-Änderungen wie Fensteränderungen, Verwendung android.app.Activity#setTitle(CharSequence) und #setAccessibilityPaneTitle(CharSequence).

Wird verwendet #setAccessibilityLiveRegion(int) , um den Benutzer über Änderungen an kritischen Ansichten innerhalb der Benutzeroberfläche zu informieren. Diese sollten immer noch sparsam verwendet werden, da sie Ankündigungen jedes Mal generieren können, wenn eine Ansicht aktualisiert wird.

Um Benutzer über Fehler zu informieren, z. B. in einem Anmeldebildschirm mit Text, der eine "falsche Kennwortbenachrichtigung" anzeigt, sollte diese Ansicht stattdessen ein AccessibilityEvent vom Typ AccessibilityEvent#CONTENT_CHANGE_TYPE_ERROR senden und stattdessen festlegen AccessibilityNodeInfo#setError(CharSequence) . Benutzerdefinierte Widgets sollten Fehlereinstellungsmethoden verfügbar machen, die die Barrierefreiheit automatisch unterstützen. Verwenden android.widget.TextView#setError(CharSequence)Sie z. B. anstelle des expliziten Sendens dieses Ereignisses bei Verwendung eines TextView-Steuerelements .

Wird verwendet #setStateDescription(CharSequence) , um Zustandsänderungen an Ansichten innerhalb der Benutzeroberfläche zu vermitteln. Während eine Liveregion möglicherweise verschiedene Arten von Ereignissen sendet, die von der Ansicht generiert werden, sendet AccessibilityEvent#TYPE_WINDOW_CONTENT_CHANGED die Statusbeschreibung Ereignisse vom Typ AccessibilityEvent#CONTENT_CHANGE_TYPE_STATE_DESCRIPTION.

Java Dokumentation für android.view.View.announceForAccessibility(java.lang.CharSequence).

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.

public void AnnounceForAccessibility(string? text);

member this.AnnounceForAccessibility : string -> unit

Parameter

Hinweise

Convenience-Methode zum Senden eines AccessibilityEvent#TYPE_ANNOUNCEMENTAccessibilityEvent , um vorzuschlagen, dass ein Barrierefreiheitsdienst den angegebenen Text an seine Benutzer angibt.

Hinweis: Das mit dieser API generierte Ereignis hat keine semantische Bedeutung und ist nur in Ausnahmefällen angemessen. Apps können in der Regel das richtige Verhalten für die Barrierefreiheit erzielen, indem sie die Semantik ihrer Benutzeroberfläche genau bereitstellen. Sie sollten nicht angeben müssen, was genau den Benutzern angekündigt wird.

Im Allgemeinen werden nur Übergänge angekündigt und keine Bestätigungsmeldung für einfache Aktionen wie ein Schaltflächendruck generiert. Beschriften Sie ihre Steuerelemente präzise und präzise, und für erhebliche UI-Änderungen wie Fensteränderungen, Verwendung android.app.Activity#setTitle(CharSequence) und #setAccessibilityPaneTitle(CharSequence).

Wird verwendet #setAccessibilityLiveRegion(int) , um den Benutzer über Änderungen an kritischen Ansichten innerhalb der Benutzeroberfläche zu informieren. Diese sollten immer noch sparsam verwendet werden, da sie Ankündigungen jedes Mal generieren können, wenn eine Ansicht aktualisiert wird.

Um Benutzer über Fehler zu informieren, z. B. in einem Anmeldebildschirm mit Text, der eine "falsche Kennwortbenachrichtigung" anzeigt, sollte diese Ansicht stattdessen ein AccessibilityEvent vom Typ AccessibilityEvent#CONTENT_CHANGE_TYPE_ERROR senden und stattdessen festlegen AccessibilityNodeInfo#setError(CharSequence) . Benutzerdefinierte Widgets sollten Fehlereinstellungsmethoden verfügbar machen, die die Barrierefreiheit automatisch unterstützen. Verwenden android.widget.TextView#setError(CharSequence)Sie z. B. anstelle des expliziten Sendens dieses Ereignisses bei Verwendung eines TextView-Steuerelements .

Wird verwendet #setStateDescription(CharSequence) , um Zustandsänderungen an Ansichten innerhalb der Benutzeroberfläche zu vermitteln. Während eine Liveregion möglicherweise verschiedene Arten von Ereignissen sendet, die von der Ansicht generiert werden, sendet AccessibilityEvent#TYPE_WINDOW_CONTENT_CHANGED die Statusbeschreibung Ereignisse vom Typ AccessibilityEvent#CONTENT_CHANGE_TYPE_STATE_DESCRIPTION.

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.