Constantes d’état d’objet

Cette rubrique décrit les valeurs constantes utilisées pour décrire l’état des objets dans une interface utilisateur d’application. Les constantes d’état sont définies dans oleacc.h.

Un objet est associé à une ou plusieurs de ces valeurs d’état à tout moment. Les constantes d’état d’objet suivantes ne sont pas utilisées : STATE_SYSTEM_ALERT_HIGH, STATE_SYSTEM_ALERT_MEDIUM, STATE_SYSTEM_ALERT_LOW et STATE_SYSTEM_FLOATING.

Les clients récupèrent l’état d’un objet en appelant IAccessible::get_accState, qui retourne un entier qui est une combinaison des indicateurs de bits suivants. Les clients appellent GetStateText avec la valeur d’état pour récupérer une chaîne localisée qui décrit l’état de l’objet.

Lorsque l’état d’un objet change, les serveurs doivent appeler NotifyWinEvent avec la constante d’événement EVENT_OBJECT_STATECHANGE . Toutefois, les objets avec les constantes STATE_SYSTEM_INVISIBLE, STATE_SYSTEM_FOCUSED et STATE_SYSTEM_ SELECTED ont leurs propres constantes d’événement. Pour ces objets, n’utilisez pas EVENT_OBJECT_STATECHANGE. Utilisez plutôt la constante d’événement individuelle.

Voici les constantes d’état d’objet :

Constant Description
STATE_SYSTEM_ALERT_HIGH
(Cette constante d’état d’objet n’est pas prise en charge.)
Indique des informations importantes à transmettre immédiatement à l’utilisateur. Par exemple, lorsqu’une batterie atteint un niveau critique faible, un indicateur de niveau génère une alerte de haut niveau. Par conséquent, un outil d’accès aveugle annonce immédiatement ces informations à l’utilisateur, et un programme d’agrandissement d’écran fait défiler l’écran afin que l’indicateur de batterie soit en mode. Cet état est également approprié pour toute invite ou opération qui doit être terminée avant que l'utilisateur puisse continuer.
STATE_SYSTEM_ALERT_MEDIUM
(Cette constante d’état d’objet n’est pas prise en charge.)
Indique des informations importantes qui ne sont pas transmises immédiatement à l’utilisateur. Par exemple, lorsqu’une batterie commence à atteindre un niveau bas, un indicateur de niveau génère une alerte de niveau moyen. Un outil d’accès aveugle génère ensuite un son pour informer l’utilisateur que les informations importantes sont disponibles, sans interrompre le travail de l’utilisateur. L’utilisateur peut ensuite interroger les informations d’alerte quand il est pratique.
STATE_SYSTEM_ALERT_LOW
(Cette constante d’état d’objet n’est pas prise en charge.)
Indique les informations de faible priorité qui ne sont pas importantes pour l’utilisateur. Cet état est utilisé, par exemple, lorsque Word modifie l’apparence du bouton TipWizard dans sa barre d’outils pour indiquer qu’il a un indicateur pour l’utilisateur.
STATE_SYSTEM_ANIMATED
L’apparence de l’objet change rapidement ou constamment. Les graphiques animés sont parfois décrits comme ROLE_SYSTEM_GRAPHIC avec la propriété State définie sur STATE_SYSTEM_ANIMATED. Cet état est utilisé pour indiquer que l’emplacement de l’objet change.
STATE_SYSTEM_BUSY
Le contrôle ne peut pas accepter l’entrée à ce stade.
STATE_SYSTEM_CHECKED
La case à cocher de l’objet est activée.
STATE_SYSTEM_COLLAPSED
Les enfants de l’objet qui ont le rôle ROLE_SYSTEM_OUTLINEITEM sont masqués.
STATE_SYSTEM_DEFAULT
Cet état représente le bouton par défaut dans une fenêtre.
STATE_SYSTEM_EXPANDED
Les enfants de l’objet qui ont le rôle ROLE_SYSTEM_OUTLINEITEM sont affichés.
STATE_SYSTEM_EXTSELECTABLE
Indique qu’un objet étend sa sélection à l’aide de SELFLAG_EXTENDSELECTION dans la méthode IAccessible::accSelect.
STATE_SYSTEM_FLOATING
(Cette constante d’état d’objet n’est pas prise en charge.)
L’objet n’est pas clippé à la limite de son objet parent et ne se déplace pas automatiquement lorsque le parent se déplace.
STATE_SYSTEM_FOCUSABLE
L’objet se trouve sur la fenêtre active et est prêt à recevoir le focus clavier.
STATE_SYSTEM_FOCUSED
L’objet a le focus clavier. Ne confondez pas le focus d’objet avec la sélection d’objets. Pour plus d’informations, consultez Sélection et Propriétés et méthodes de focus. Pour les objets avec cet état d’objet, envoyez le EVENT_OBJECT_SHOW ou EVENT_OBJECT_HIDE WinEvents pour informer les applications clientes des modifications d’état. N’utilisez pas EVENT_OBJECT_STATECHANGE.
STATE_SYSTEM_HASPOPUP
Lorsqu’il est appelé, l’objet affiche un menu contextuel ou une fenêtre.
STATE_SYSTEM_HOTTRACKED
L’objet est suivi à chaud par la souris, ce qui signifie que l’apparence de l’objet a changé pour indiquer que le pointeur de la souris se trouve sur celui-ci.
STATE_SYSTEM_INVISIBLE
L’objet est masqué par programmation. Par exemple, les itmes de menu sont masqués par programmation jusqu’à ce qu’un utilisateur active le menu. Étant donné que les objets avec cet état ne sont pas disponibles pour les utilisateurs, les applications clientes ne doivent pas communiquer d’informations sur l’objet aux utilisateurs. Toutefois, si les applications clientes trouvent un objet avec cet état, elles doivent vérifier si STATE_SYSTEM_OFFSCREEN est également définie. Si ce deuxième état est défini, les clients peuvent communiquer les informations sur l’objet aux utilisateurs. Par exemple, une zone de liste peut avoir à la fois STATE_SYSTEM_INVISIBLE et STATE_SYSTEM_OFFSCREEN ensemble. Dans ce cas, l’application cliente peut communiquer tous les éléments de la liste aux utilisateurs.
Si une application cliente navigue dans une arborescence IAccessible et rencontre un objet parent invisible, Microsoft Active Accessibility n’expose pas d’informations sur les enfants possibles du parent tant que le parent est invisible.
STATE_SYSTEM_LINKED
Indique que l’objet est mis en forme comme lien hypertexte. Le rôle de l’objet est généralement ROLE_SYSTEM_TEXT.
STATE_SYSTEM_MARQUEED
Indique le défilement ou le déplacement de texte ou de graphiques.
STATE_SYSTEM_MIXED
Indique que l’état d’une case à cocher à trois états ou le bouton de barre d’outils n’est pas déterminé. La case à cocher n’est ni activée ni désactivée et est donc dans le troisième ou l’état mixte .
STATE_SYSTEM_MOVEABLE
Indique que l’objet peut être déplacé. Par exemple, un utilisateur peut cliquer sur la barre de titre de l’objet et faire glisser l’objet vers un nouvel emplacement.
STATE_SYSTEM_MULTISELECTABLE
Indique que l’objet accepte plusieurs éléments sélectionnés ; autrement dit, SELFLAG_ADDSELECTION pour la méthode IAccessible::accSelect est valide.
STATE_SYSTEM_NORMAL
Indique que l’objet n’a pas d’autre état affecté.
STATE_SYSTEM_OFFSCREEN
L’objet est clippé ou a fait défiler l’affichage, mais il n’est pas masqué par programmation. Si l’utilisateur rend la fenêtre d’affichage plus grande, plus l’objet sera visible sur l’écran de l’ordinateur.
STATE_SYSTEM_PRESSED
L’objet est enfoncé.
STATE_SYSTEM_PROTECTED
L’objet est un contrôle d’édition protégé par mot de passe.
STATE_SYSTEM_READONLY
L’objet est désigné en lecture seule.
STATE_SYSTEM_SELECTABLE
L’objet accepte la sélection.
STATE_SYSTEM_SELECTED
L’objet est sélectionné.
STATE_SYSTEM_SELFVOICING
L’objet ou l’enfant utilise la technologie de synthèse vocale (TTS) à des fins de description. Lorsqu’un objet avec cet état a le focus, une aide d’accessibilité basée sur la reconnaissance vocale n’annonce pas d’informations, car l’objet l’annonce automatiquement.
STATE_SYSTEM_SIZEABLE
L’objet peut être redimensionné. Par exemple, un utilisateur peut modifier la taille d’une fenêtre en la faisant glisser par la bordure.
STATE_SYSTEM_TRAVERSED
L’objet est un lien hypertexte qui a été visité (précédemment cliqué) par un utilisateur.
STATE_SYSTEM_UNAVAILABLE
L’objet n’est pas disponible.

Configuration requise

Condition requise Valeur
En-tête
Oleacc.h