Constantes d’état de l’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 0x10000000	(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 en vue. Cet état est également approprié pour toute invite ou opération qui doit être effectuée avant que l’utilisateur puisse continuer.
STATE_SYSTEM_ALERT_MEDIUM 0x8000000	(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 des informations importantes sont disponibles, sans interrompre le travail de l’utilisateur. L’utilisateur peut ensuite interroger les informations d’alerte quand c’est pratique.
STATE_SYSTEM_ALERT_LOW 0x4000000	(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 0x4000	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 0x800	Le contrôle ne peut pas accepter l’entrée pour l’instant.
STATE_SYSTEM_CHECKED 0x10	La case à cocher de l’objet est cochée.
STATE_SYSTEM_COLLAPSED 0x400	Les enfants de l’objet qui ont le rôle ROLE_SYSTEM_OUTLINEITEM sont masqués.
STATE_SYSTEM_DEFAULT 0x100	Cet état représente le bouton par défaut dans une fenêtre.
STATE_SYSTEM_EXPANDED 0x200	Les enfants de l’objet qui ont le rôle ROLE_SYSTEM_OUTLINEITEM sont affichés.
STATE_SYSTEM_EXTSELECTABLE 0x2000000	Indique qu’un objet étend sa sélection à l’aide de SELFLAG_EXTENDSELECTION dans la méthode IAccessible ::accSelect.
STATE_SYSTEM_FLOATING 0x1000	(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 il ne se déplace pas automatiquement lorsque le parent se déplace.
STATE_SYSTEM_FOCUSABLE 0x100000	L’objet se trouve sur la fenêtre active et est prêt à recevoir le focus clavier.
STATE_SYSTEM_FOCUSED 0x4	L’objet a le focus clavier. Ne confondez pas le focus de l’objet avec la sélection d’objets. 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 les 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 0x40000000	Lorsqu’il est appelé, l’objet affiche un menu contextuel ou une fenêtre.
STATE_SYSTEM_HOTTRACKED 0x80	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 0x8000	L’objet est masqué par programmation. Par exemple, les itèmes 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 des 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 définies. 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 0x400000	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 0x2000	Indique le défilement ou le déplacement de texte ou de graphiques.
STATE_SYSTEM_MIXED 0x20	Indique que l’état d’une case à cocher à trois états ou d’un bouton de barre d’outils n’est pas déterminé. La case à cocher n’est ni activée ni désactivée et se trouve donc dans le troisième ou 'état de mixte.
STATE_SYSTEM_MOVEABLE 0x40000	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 0x1000000	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 0	Indique que l’objet n’a pas d’autre état qui lui est affecté.
STATE_SYSTEM_OFFSCREEN 0x10000	L’objet est clippé ou a fait défiler l’affichage, mais il n’est pas masqué par programmation. Si l’utilisateur agrandit la fenêtre d’affichage, plus l’objet sera visible sur l’écran de l’ordinateur.
STATE_SYSTEM_PRESSED 0x8	L’objet est appuyé.
STATE_SYSTEM_PROTECTED 0x20000000	L’objet est un contrôle d’édition protégé par mot de passe.
STATE_SYSTEM_READONLY 0x40	L’objet est désigné en lecture seule.
STATE_SYSTEM_SELECTABLE 0x200000	L’objet accepte la sélection.
STATE_SYSTEM_SELECTED 0x2	L’objet est sélectionné.
STATE_SYSTEM_SELFVOICING 0x80000	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 0x20000	L’objet peut être redimensionné. Par exemple, un utilisateur peut modifier la taille d’une fenêtre en le faisant glisser par la bordure.
STATE_SYSTEM_TRAVERSED 0x800000	L’objet est un lien hypertexte qui a été visité (précédemment cliqué) par un utilisateur.
STATE_SYSTEM_UNAVAILABLE 0x1	L’objet n’est pas disponible.

Exigences

Exigence	Valeur
En-tête	Oleacc.h