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 : _ alerte de système d’état _ _ haute, moyenne des alertes du système d’état _ _ , niveau d’alerte de système d’état _ _ _ _ bas et système d’état _ _ flottant.

Les clients récupèrent l’état d’un objet en appelant IAccessible :: obtenir _ accState, qui retourne un entier qui est une combinaison des indicateurs binaires suivants. Les clients appellent GetStateText avec la valeur State 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 à l’aide de la constante d’événement STATECHANGE de l' _ objet _ d’événement . Toutefois, les objets avec le système d’État invisible, les constantes de système d’État axées sur le système d’état _ _ et les _ _ _ _ constantes d’état d’objet sélectionnées ont leurs propres constantes d’événement. Pour ces objets, n’utilisez pas l' _ objet _ d’événement STATECHANGE. Au lieu de cela, utilisez la constante d’événement individuelle.

Les éléments suivants sont des constantes d’état d’objet :

Constante Description
alerte du système d’état _ _ _ élevée
(Cette constante d’état d’objet n’est pas prise en charge.)
Indique des informations importantes qui doivent être transmises immédiatement à l’utilisateur. Par exemple, lorsqu’une batterie atteint un niveau critique, un indicateur de niveau génère une alerte de haut niveau. En conséquence, 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 pour que l’indicateur de la 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.
_moyenne des _ alertes du système d’état _
(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 quand c’est possible.
alerte du système d’état _ _ _ faible
(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, lorsque Word modifie l’apparence du bouton Assistant Conseil dans sa barre d’outils pour indiquer qu’il a un indicateur pour l’utilisateur.
système d’état _ _ animé
L’apparence de l’objet change rapidement ou en permanence. Les graphiques animés occasionnellement sont décrits comme un _ _ graphique de système de rôle avec la propriété état définie sur état _ système _ animé. Cet État est utilisé pour indiquer que l’emplacement de l’objet est modifié.
système d’état _ _ occupé
Le contrôle ne peut pas accepter d’entrée pour l’instant.
système d’état _ _ vérifié
La case à cocher de l’objet est activée.
système d’état _ _ réduit
Les enfants de l’objet qui ont le rôle _ _ OUTLINEITEM du système de rôle sont masqués.
État du _ système _ par défaut
Cet état représente le bouton par défaut dans une fenêtre.
système d’état _ _ développé
Les enfants de l’objet qui ont le rôle _ _ OUTLINEITEM du système de rôle sont affichés.
_EXTSELECTABLE système d’état _
Indique qu’un objet étend sa sélection à l’aide de SELFLAG _ EXTENDSELECTION dans la méthode IAccessible :: accSelect.
système d’état _ _ flottant
(Cette constante d’état d’objet n’est pas prise en charge.)
L’objet n’est pas tronqué à la limite de son objet parent et ne se déplace pas automatiquement lorsque le parent est déplacé.
système d’État pouvant être _ _ actif
L’objet se trouve dans la fenêtre active et est prêt à recevoir le focus clavier.
système d’état _ _ concentré
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 l’objet d' événement _ _ Show ou Event _ Object _ Hide WinEvents pour notifier les modifications d’État aux applications clientes. N’utilisez pas l' _ objet _ d’événement STATECHANGE.
_HASPOPUP système d’état _
Lorsqu’il est appelé, l’objet affiche un menu contextuel ou une fenêtre.
_HOTTRACKED système d’état _
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.
système d’état _ _ invisible
L’objet est masqué par programmation. Par exemple, les éléments 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 l’état du _ système _ est également défini sur l’écran. 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 à la fois le système d’état _ _ invisible et le système d’état défini à l' _ _ écran. Dans ce cas, l’application cliente peut communiquer tous les éléments de la liste aux utilisateurs.
Si une application cliente parcourt 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.
système d’état _ _ lié
Indique que l’objet est mis en forme en tant que lien hypertexte. Le rôle de l’objet est généralement le _ _ texte du système de rôle.
système d’état _ _ défilant
Indique le défilement ou le déplacement de texte ou de graphiques.
système d’état _ _ mixte
Indique que l’état d’une case à cocher ou d’un bouton de barre d’outils à trois États n’est pas déterminé. La case à cocher n’est ni activée ni désactivée, et est par conséquent dans le troisième ou l’état mixte .
système d’état _ _ mobile
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.
système d’état _ _ multisélectionnable
Indique que l’objet accepte plusieurs éléments sélectionnés ; autrement dit, SELFLAG _ ADDSELECTION pour la méthode IAccessible :: accSelect est valide.
système d’état _ _ normal
Indique que l’objet n’a pas d’autre État qui lui est assigné.
système d’état _ _ hors écran
L’objet est détouré ou défilant hors de la vue, 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.
système d’état _ _ enfoncé
L’objet est enfoncé.
système d’état _ _ protégé
L’objet est un contrôle d’édition protégé par mot de passe.
système d’État en _ _ lecture seule
L’objet est désigné en lecture seule.
système d’état _ _ sélectionnable
L’objet accepte la sélection.
système d’état _ _ sélectionné
L’objet est sélectionné.
_SELFVOICING système d’état _
L’objet ou l’enfant utilise la technologie TTS (Text-to-Speech) à des fins de description. Quand 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 l’annonce automatiquement.
système d’état _ _ dimensionnable
L’objet peut être redimensionné. Par exemple, un utilisateur peut modifier la taille d’une fenêtre en la faisant glisser sur la bordure.
ÉTAT _ parcouru par le système _
L’objet est un lien hypertexte qui a été visité (précédemment cliqué) par un utilisateur.
système d’état _ _ non disponible
L’objet n’est pas disponible.

Configuration requise

Condition requise Valeur
En-tête
Oleacc. h