View.AccessibilityLiveRegion Propriété

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

Valeur de propriété

Mode de région dynamique pour l’affichage.

Attributs

RegisterAttribute

Remarques

Documentation getter de propriété :

Obtient le mode de région dynamique pour cette vue.

Java documentation pour android.view.View.getAccessibilityLiveRegion().

Documentation du jeu de propriétés :

Définit le mode de région dynamique pour cette vue. Cela indique aux services d’accessibilité s’ils doivent avertir automatiquement l’utilisateur des modifications apportées à la description ou au texte de contenu de la vue, ou aux descriptions de contenu ou au texte des enfants de la vue (le cas échéant).

Différents niveaux de priorité sont disponibles : <ul><li>#ACCESSIBILITY_LIVE_REGION_POLITE : indique que les mises à jour de la région doivent être présentées à l’utilisateur. Convient dans la plupart des cas pour les mises à jour importantes dans le contenu de l’application qui ne nécessitent pas l’attention immédiate de l’utilisateur. </li li><>#ACCESSIBILITY_LIVE_REGION_ASSERTIVE : indique que les mises à jour de la région ont la priorité la plus élevée et doivent être présentées immédiatement à l’utilisateur. Cela peut entraîner des notifications perturbatrices d’un service d’accessibilité, susceptibles d’interrompre d’autres commentaires ou actions utilisateur, de sorte qu’elles doivent généralement être utilisées uniquement pour les informations critiques et sensibles au temps. </li li><>#ACCESSIBILITY_LIVE_REGION_NONE : désactive les annonces de modification (valeur par défaut pour la plupart des vues). </li></ul>

Exemples : <ul><li> Sélection d’une option dans un menu déroulant met à jour un panneau ci-dessous avec le contenu mis à jour. Ce panneau peut être marqué comme une région dynamique avec #ACCESSIBILITY_LIVE_REGION_POLITE pour informer les utilisateurs de la modification. Un lecteur d’écran peut mettre en file d’attente les modifications en tant qu’annonces qui ne perturbent pas la parole en cours. </li li><> Une alerte d’urgence peut être marquée avec #ACCESSIBILITY_LIVE_REGION_ASSERTIVE pour informer immédiatement les utilisateurs de l’urgence. </li></ul>

Pour les notifications d’erreur, comme un avertissement « mot de passe incorrect » dans un écran de connexion, les affichages doivent envoyer un AccessibilityEvent#TYPE_WINDOW_CONTENT_CHANGEDAccessibilityEvent type AccessibilityEvent#CONTENT_CHANGE_TYPE_ERROR de modification de contenu et définir AccessibilityNodeInfo#setError(CharSequence). Les widgets personnalisés doivent fournir des méthodes de paramètre d’erreur qui prennent en charge l’accessibilité. Par exemple, utilisez android.widget.TextView#setError(CharSequence) plutôt que d’envoyer explicitement des événements.

N’utilisez pas de régions actives pour les éléments d’interface utilisateur fréquemment mis à jour (par exemple, les barres de progression), car cela peut submerger l’utilisateur avec des commentaires provenant des services d’accessibilité. Si nécessaire, utilisez cette option AccessibilityNodeInfo#setMinDurationBetweenContentChanges(Duration) pour limiter les commentaires et réduire les perturbations.

<en dehors><de b>Remarque :</b> Utiliser androidx.core.view.ViewCompat#setAccessibilityLiveRegion(View, int) pour la compatibilité descendante. </aside>

Java documentation pour android.view.View.setAccessibilityLiveRegion(int).

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.

Voir aussi

• AccessibilityLiveRegion