View.AnnounceForAccessibility Méthode

[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

Paramètres

Attributs

RegisterAttribute

Remarques

Méthode pratique pour envoyer un AccessibilityEvent#TYPE_ANNOUNCEMENTAccessibilityEvent message pour suggérer qu’un service d’accessibilité annonce le texte spécifié à ses utilisateurs.

Remarque : L’événement généré avec cette API n’a aucune signification sémantique et est approprié uniquement dans des situations exceptionnelles. Les applications peuvent généralement obtenir un comportement correct pour l’accessibilité en fournissant avec précision la sémantique de leur interface utilisateur. Ils ne doivent pas avoir besoin de spécifier exactement ce qui est annoncé aux utilisateurs.

En règle générale, annoncez uniquement les transitions et ne générez pas de message de confirmation pour des actions simples comme une pression sur un bouton. Étiquetez vos contrôles de manière concise et précise à la place, et pour les modifications significatives de l’interface utilisateur, telles que les modifications de fenêtre, l’utilisation android.app.Activity#setTitle(CharSequence) et #setAccessibilityPaneTitle(CharSequence).

Permet #setAccessibilityLiveRegion(int) d’informer l’utilisateur des modifications apportées aux vues critiques dans l’interface utilisateur. Ceux-ci doivent toujours être utilisés avec parcimonie, car ils peuvent générer des annonces chaque fois qu’une vue est mise à jour.

Pour informer les utilisateurs des erreurs, telles que dans un écran de connexion avec du texte qui affiche une notification « mot de passe incorrect », cette vue doit envoyer un AccessibilityEvent de type AccessibilityEvent#CONTENT_CHANGE_TYPE_ERROR et définir AccessibilityNodeInfo#setError(CharSequence) à la place. Les widgets personnalisés doivent exposer automatiquement des méthodes de définition d’erreur qui prennent en charge l’accessibilité. Par exemple, au lieu d’envoyer explicitement cet événement lors de l’utilisation d’un TextView, utilisez android.widget.TextView#setError(CharSequence).

Permet #setStateDescription(CharSequence) de transmettre les modifications d’état aux vues au sein de l’interface utilisateur. Si une région active peut envoyer différents types d’événements générés par l’affichage, la description de l’état envoie AccessibilityEvent#TYPE_WINDOW_CONTENT_CHANGED des événements de type AccessibilityEvent#CONTENT_CHANGE_TYPE_STATE_DESCRIPTION.

Java documentation pour android.view.View.announceForAccessibility(java.lang.CharSequence).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

public void AnnounceForAccessibility(string? text);

member this.AnnounceForAccessibility : string -> unit

Paramètres

Remarques

Méthode pratique pour envoyer un AccessibilityEvent#TYPE_ANNOUNCEMENTAccessibilityEvent message pour suggérer qu’un service d’accessibilité annonce le texte spécifié à ses utilisateurs.

Remarque : L’événement généré avec cette API n’a aucune signification sémantique et est approprié uniquement dans des situations exceptionnelles. Les applications peuvent généralement obtenir un comportement correct pour l’accessibilité en fournissant avec précision la sémantique de leur interface utilisateur. Ils ne doivent pas avoir besoin de spécifier exactement ce qui est annoncé aux utilisateurs.

En règle générale, annoncez uniquement les transitions et ne générez pas de message de confirmation pour des actions simples comme une pression sur un bouton. Étiquetez vos contrôles de manière concise et précise à la place, et pour les modifications significatives de l’interface utilisateur, telles que les modifications de fenêtre, l’utilisation android.app.Activity#setTitle(CharSequence) et #setAccessibilityPaneTitle(CharSequence).

Permet #setAccessibilityLiveRegion(int) d’informer l’utilisateur des modifications apportées aux vues critiques dans l’interface utilisateur. Ceux-ci doivent toujours être utilisés avec parcimonie, car ils peuvent générer des annonces chaque fois qu’une vue est mise à jour.

Pour informer les utilisateurs des erreurs, telles que dans un écran de connexion avec du texte qui affiche une notification « mot de passe incorrect », cette vue doit envoyer un AccessibilityEvent de type AccessibilityEvent#CONTENT_CHANGE_TYPE_ERROR et définir AccessibilityNodeInfo#setError(CharSequence) à la place. Les widgets personnalisés doivent exposer automatiquement des méthodes de définition d’erreur qui prennent en charge l’accessibilité. Par exemple, au lieu d’envoyer explicitement cet événement lors de l’utilisation d’un TextView, utilisez android.widget.TextView#setError(CharSequence).

Permet #setStateDescription(CharSequence) de transmettre les modifications d’état aux vues au sein de l’interface utilisateur. Si une région active peut envoyer différents types d’événements générés par l’affichage, la description de l’état envoie AccessibilityEvent#TYPE_WINDOW_CONTENT_CHANGED des événements de type AccessibilityEvent#CONTENT_CHANGE_TYPE_STATE_DESCRIPTION.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.