Constantes d’état d’objet

Cette rubrique décrit les valeurs constantes utilisées pour décrire l’état des objets dans l’interface utilisateur d’une 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 d’état d’objet 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 :

Constante	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 critiquement bas, 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 de l’écran fait défiler l’écran afin que l’indicateur de batterie soit visible. 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 faible, 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 des informations importantes sont disponibles, sans interrompre réellement le travail de l’utilisateur. L’utilisateur peut ensuite interroger les informations d’alerte lorsque cela est pratique.
STATE_SYSTEM_ALERT_LOW	(Cette constante d’état d’objet n’est pas prise en charge.) Indique des informations de faible priorité qui ne sont pas importantes pour l’utilisateur. Cet état est utilisé, par exemple, quand Word modifie l’apparence du bouton TipWizard dans sa barre d’outils pour indiquer qu’il dispose d’un indicateur pour l’utilisateur.
STATE_SYSTEM_ANIMATED	L’apparence de l’objet change rapidement ou constamment. Les graphiques animés occasionnellement sont 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 d’entrée pour l’instant.
STATE_SYSTEM_CHECKED	La zone case activée de l’objet est sélectionné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 coupé à 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 dans 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’objet. Pour plus d’informations, consultez Propriétés et méthodes de sélection et 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 case activée si STATE_SYSTEM_OFFSCREEN est également défini. Si ce deuxième état est défini, les clients peuvent communiquer les informations relatives à l’objet aux utilisateurs. Par exemple, une zone de liste peut avoir STATE_SYSTEM_INVISIBLE et STATE_SYSTEM_OFFSCREEN définis. 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 qui est 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 en tant que 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 zone de case activée ou d’un bouton de barre d’outils à trois états n’est pas déterminé. La zone case activée n’est ni sélectionnée, ni désactivée et est donc à l’état troisième ou 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 qui lui est attribué.
STATE_SYSTEM_OFFSCREEN	L’objet est coupé ou a fait défiler hors de la vue, mais il n’est pas masqué par programmation. Si l’utilisateur agrandit la fenêtre d’affichage, une plus grande partie de l’objet sera visible sur l’écran de l’ordinateur.
STATE_SYSTEM_PRESSED	L’objet est appuyé.
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 à l’accessibilité basée sur la parole n’annonce pas d’informations, car l’objet les 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.

Spécifications

Condition requise	Valeur
En-tête	Oleacc.h