mx.accessibilityAccConst La classe AccConst définit des constantes définies dans la spécification MSAA (Microsoft Active Accessibility). Object La classe AccConst définit des constantes définies dans la spécification MSAA (Microsoft Active Accessibility). Elles sont utilisées pour implémenter des sous-classes de la classe AccessibilityImplementation.

Etant donné que Flash Player utilise MSAA pour assurer l’accessibilité, les noms des constantes de ce fichier sont issus littéralement du SDK MSAA Microsoft. Leurs descriptions ont été reprises avec de légères modifications. Gardez à l’esprit lors de leur lecture que Flash Player est considéré comme une « application serveur MSAA » car les objets DisplayObject d’un fichier SWF fournissent des informations MSAA aux clients MSAA, tels que les lecteurs d’écran, via une interface COM appelée IAccessible.

EVENT_OBJECT_ACCELERATORCHANGE Evénement MSAA indiquant que la propriété MSAA KeyboardShortcut d’un objet a été modifiée. 0x8012 Evénement MSAA indiquant que la propriété MSAA KeyboardShortcut d’un objet a été modifiée.

Les applications serveur MSAA envoient cet événement pour leurs objets accessibles.

EVENT_OBJECT_CONTENTSCROLLED Evénement MSAA indiquant que le défilement d’un objet fenêtre est terminé. 0x8015 Evénement MSAA indiquant que le défilement d’un objet fenêtre est terminé. (MSAA 2.0)

Contrairement à l’événement similaire (EVENT_SYSTEM_SCROLLEND), cet événement sera associé à la fenêtre de défilement. Il n’existe aucune différence entre le défilement horizontal ou vertical.

Cet événement doit être publié à l’issue d’une action de défilement, y compris lorsqu’elle est exécutée par des barres de défilement, une molette de souris ou des touches de navigation du clavier.

EVENT_OBJECT_CREATE Evénement MSAA indiquant la création d’un objet. 0x8000 Evénement MSAA indiquant la création d’un objet.

Le système envoie cet événement pour les éléments d’interface utilisateur suivants : caret, contrôle d’en-tête, contrôle de l’affichage par liste, contrôle onglet, contrôle de la barre d’outils, contrôle arborescence et objet fenêtre. Les applications serveur MSAA envoient cet événement pour leurs objets accessibles. Les serveurs doivent envoyer cet événement pour l’ensemble des objets enfant d’un objet avant d’envoyer l’événement pour l’objet parent. Les serveurs doivent s’assurer que tous les objets enfant sont entièrement créés et prêts à accepter les appels IAccessible des clients lorsque l’objet parent envoie cet événement.

EVENT_OBJECT_DEFACTIONCHANGE Evénement MSAA indiquant que la propriété MSAA DefaultAction d’un objet a été modifiée. 0x8011 Evénement MSAA indiquant que la propriété MSAA DefaultAction d’un objet a été modifiée.

Le système envoie cet événement pour les boîtes de dialogue. Les applications serveur MSAA envoient cet événement pour leurs objets accessibles.

EVENT_OBJECT_DESCRIPTIONCHANGE Evénement MSAA indiquant que la propriété MSAA Description d’un objet a été modifiée. 0x800D Evénement MSAA indiquant que la propriété MSAA Description d’un objet a été modifiée.

Les applications serveur MSAA envoient cet événement pour leurs objets accessibles.

EVENT_OBJECT_DESTROY Evénement MSAA indiquant la destruction d’un objet. 0x8001 Evénement MSAA indiquant la destruction d’un objet.

Le système envoie cet événement pour les éléments d’interface utilisateur suivants : caret, contrôle d’en-tête, contrôle de l’affichage par liste, contrôle onglet, contrôle de la barre d’outils, contrôle arborescence et objet fenêtre. Les applications serveur MSAA envoient cet événement pour leurs objets accessibles. Cet événement peut être ou ne pas être envoyé pour les objets enfant. Toutefois, les clients peuvent supposer que tous les enfants d’un objet ont été détruits lorsque l’objet parent envoie cet événement.

EVENT_OBJECT_FOCUS Evénement MSAA indiquant qu’un objet a reçu le focus clavier. 0x8005 Evénement MSAA indiquant qu’un objet a reçu le focus clavier.

Le système envoie cet événement pour les éléments d’interface utilisateur suivants : contrôle d’affichage par liste, barre de menus, menu contextuel, fenêtre de changement, contrôle onglet, contrôle arborescence et objet fenêtre. Les applications serveur MSAA envoient cet événement pour leurs objets accessibles.

EVENT_OBJECT_HELPCHANGE Evénement MSAA indiquant que la propriété MSAA Help d’un objet a été modifiée. 0x8010 Evénement MSAA indiquant que la propriété MSAA Help d’un objet a été modifiée.

Les applications serveur MSAA envoient cet événement pour leurs objets accessibles.

EVENT_OBJECT_HIDE Evénement MSAA indiquant qu’un objet est masqué. 0x8003 Evénement MSAA indiquant qu’un objet est masqué.

Le système envoie cet événement pour les éléments d’interface utilisateur suivants : caret et curseur. Les applications serveur MSAA envoient cet événement pour leurs objets accessibles. Lorsque cet événement est généré pour un objet parent, tous les objets enfant sont déjà masqués. Par conséquent, les applications serveur n’ont pas besoin d’envoyer cet événement pour les objets enfant. Les objets masqués incluent l’indicateur STATE_SYSTEM_INVISIBLE, contrairement aux objets affichés. L’événement EVENT_OBJECT_HIDE indique également que l’indicateur STATE_SYSTEM_INVISIBLE n’a pas été défini. Par conséquent, les serveurs n’ont pas besoin d’envoyer l’événement EVENT_STATE_CHANGE dans ce cas.

EVENT_OBJECT_INVOKED Evénement MSAA indiquant qu’un objet a été appelé ; par exemple, l’utilisateur a cliqué sur un bouton. 0x8013 Evénement MSAA indiquant qu’un objet a été appelé ; par exemple, l’utilisateur a cliqué sur un bouton. (MSAA 2.0) EVENT_OBJECT_LOCATIONCHANGE Evénement MSAA indiquant que l’emplacement, la forme ou la taille d’un objet a été modifié. 0x800B Evénement MSAA indiquant que l’emplacement, la forme ou la taille d’un objet a été modifié.

Le système envoie cet événement pour les éléments d’interface utilisateur suivants : caret et objet fenêtre. Les applications serveur MSAA envoient cet événement pour leurs objets accessibles. Cet événement est généré en réponse à l’objet de niveau supérieur dans la hiérarchie d’objets modifiée, et non pour les enfants qu’il peut contenir. Par exemple, si l’utilisateur redimensionne une fenêtre, le système envoie cette notification pour la fenêtre, mais pas pour la barre de menus, la barre de titre, les barres de défilement ou d’autres objets qui ont également été modifiés. Le système n’envoie pas cet événement pour chaque fenêtre enfant sans virgule flottante lorsque le parent se déplace. Toutefois, si une application redimensionne explicitement les fenêtres enfant suite à son propre redimensionnement, le système envoie plusieurs événements pour les enfants redimensionnés. Si la propriété State d’un objet est définie sur STATE_SYSTEM_FLOATING, les serveurs doivent envoyer EVENT_OBJECT_LOCATIONCHANGE lorsque l’emplacement de l’objet est modifié. Si un objet ne possède pas cet état, les serveurs doivent déclencher cet événement uniquement lorsque l’objet se déplace par rapport à son parent.

EVENT_OBJECT_NAMECHANGE Evénement MSAA indiquant que la propriété MSAA Name d’un objet a été modifiée. 0x800C Evénement MSAA indiquant que la propriété MSAA Name d’un objet a été modifiée.

Le système envoie cet événement pour les éléments d’interface utilisateur suivants : case à cocher, curseur, contrôle de l’affichage par liste, bouton poussoir, bouton radio, contrôle de la barre d’état, contrôle arborescence et objet fenêtre. Les applications serveur MSAA envoient cet événement pour leurs objets accessibles.

EVENT_OBJECT_PARENTCHANGE Evénement MSAA indiquant qu’un objet a un nouvel objet parent. 0x800F Evénement MSAA indiquant qu’un objet a un nouvel objet parent.

Les applications serveur MSAA envoient cet événement pour leurs objets accessibles.

EVENT_OBJECT_REORDER Evénement MSAA indiquant qu’un objet container a ajouté, supprimé ou réorganisé ses enfants. 0x8004 Evénement MSAA indiquant qu’un objet container a ajouté, supprimé ou réorganisé ses enfants.

Le système envoie cet événement pour les éléments d’interface utilisateur suivants : contrôle d’en-tête, contrôle de l’affichage par liste, contrôle de la barre d’outils et objet fenêtre. Les applications serveur MSAA envoient cet événement pour leurs objets accessibles, le cas échéant. Par exemple, cet événement est généré par un objet d’affichage par liste lorsque le nombre d’éléments enfant ou l’ordre des éléments change. Cet événement est également envoyé par une fenêtre parent lorsque l’ordre de plan des fenêtres enfant est modifiée.

EVENT_OBJECT_SELECTIONADD Evénement MSAA indiquant qu’un élément d’un objet container a été ajouté à la sélection. 0x8007 Evénement MSAA indiquant qu’un élément d’un objet container a été ajouté à la sélection.

Le système envoie cet événement pour les éléments d’interface utilisateur suivants : zone de liste, contrôle d’affichage par liste et contrôle arborescence. Les applications serveur MSAA envoient cet événement pour leurs objets accessibles. Cet événement signale qu’un enfant a été ajouté à une sélection existante.

EVENT_OBJECT_SELECTIONREMOVE Evénement MSAA indiquant qu’un élément d’un objet container a été supprimé de la sélection. 0x8008 Evénement MSAA indiquant qu’un élément d’un objet container a été supprimé de la sélection.

EVENT_OBJECT_SELECTIONWITHIN Evénement MSAA indiquant que de nombreuses modifications de sélection ont eu lieu dans un objet container. 0x8009 Evénement MSAA indiquant que de nombreuses modifications de sélection ont eu lieu dans un objet container.

Le système envoie cet événement pour les zones de liste. Les applications serveur MSAA envoient cet événement pour leurs objets accessibles. Cet événement peut être envoyé lorsque les éléments sélectionnés au sein d’un contrôle ont considérablement changé. Cet événement informe le client que de nombreuses modifications de sélection se sont produites (au lieu d’envoyer plusieurs événements EVENT_OBJECT_SELECTIONADD ou EVENT_OBJECT_SELECTIONREMOVE). Le client peut interroger les éléments sélectionnés en appelant la méthode IAccessible::get_accSelection de l’objet container et en énumérant les éléments sélectionnés.

EVENT_OBJECT_SELECTION Evénement MSAA indiquant que la sélection a été modifiée dans un objet container. 0x8006 Evénement MSAA indiquant que la sélection a été modifiée dans un objet container.

Le système envoie cet événement pour les éléments d’interface utilisateur suivants : contrôle de l’affichage par liste, contrôle onglet, contrôle arborescence et objet fenêtre. Les applications serveur MSAA envoient cet événement pour leurs objets accessibles. Cet événement signale une sélection unique : un enfant a été sélectionné dans un conteneur ne contenant précédemment pas d’enfants sélectionnés ou la sélection a été modifiée d’un enfant à un autre.

EVENT_OBJECT_SHOW Evénement MSAA indiquant qu’un objet masqué est affiché. 0x8002 Evénement MSAA indiquant qu’un objet masqué est affiché.

Le système envoie cet événement pour les éléments d’interface utilisateur suivants : caret, curseur et objet fenêtre. Les applications serveur MSAA envoient cet événement pour leurs objets accessibles. Les clients peuvent supposer que lorsque cet événement est envoyé par un objet parent, tous les objets enfant ont déjà été affichés. Par conséquent, les applications serveur n’ont pas besoin d’envoyer cet événement pour les objets enfant. Les objets masqués incluent l’indicateur STATE_SYSTEM_INVISIBLE, contrairement aux objets affichés. L’événement EVENT_OBJECT_SHOW indique également que l’indicateur STATE_SYSTEM_INVISIBLE a été effacé. Par conséquent, les serveurs n’ont pas besoin d’envoyer l’événement EVENT_STATE_CHANGE dans ce cas.

EVENT_OBJECT_STATECHANGE Evénement MSAA indiquant que l’état d’un objet a été modifié. 0x800A Evénement MSAA indiquant que l’état d’un objet a été modifié.

Le système envoie cet événement pour les éléments d’interface utilisateur suivants : case à cocher, liste déroulante, contrôle de l’en-tête, bouton poussoir, bouton radio, barre de défilement, contrôle de la barre d’outils, contrôle arborescence, contrôle haut/bas et objet fenêtre. Les applications serveur MSAA envoient cet événement pour leurs objets accessibles. Par exemple, une modification de l’état peut se produire lorsqu’un objet bouton a été enfoncé ou relâché ou lorsqu’un objet est activé ou désactivé.

EVENT_OBJECT_TEXTSELECTIONCHANGED Evénement MSAA indiquant que la sélection de texte d’un objet a été modifiée. 0x8014 Evénement MSAA indiquant que la sélection de texte d’un objet a été modifiée. (MSAA 2.0) EVENT_OBJECT_VALUECHANGE Evénement MSAA indiquant que la propriété MSAA Value d’un objet a été modifiée. 0x800E Evénement MSAA indiquant que la propriété MSAA Value d’un objet a été modifiée.

Le système envoie cet événement pour les éléments d’interface utilisateur suivants : contrôle d’édition, contrôle d’en-tête, contrôle des touches d’accès rapides, contrôle de la barre de progression, barre de défilement, contrôle du curseur et contrôle haut-bas. Les applications serveur MSAA envoient cet événement pour leurs objets accessibles.

EVENT_SYSTEM_ALERT Evénement MSAA indiquant la génération d’une alerte. 0x0002 Evénement MSAA indiquant la génération d’une alerte.

Les applications serveur MSAA envoient cet événement à chaque modification importante de l’interface utilisateur susceptible de devoir être signalée à l’utilisateur.

EVENT_SYSTEM_CAPTUREEND Evénement MSAA indiquant que la fenêtre a perdu la capture de la souris. 0x0009 Evénement MSAA indiquant que la fenêtre a perdu la capture de la souris.

Cet événement est envoyé par le système ; les applications serveur MSAA n’envoient jamais cet événement.

EVENT_SYSTEM_CAPTURESTART Evénement MSAA indiquant que la fenêtre a reçu la capture de la souris. 0x0008 Evénement MSAA indiquant que la fenêtre a reçu la capture de la souris.

Cet événement est envoyé par le système ; les applications serveur MSAA n’envoient jamais cet événement.

EVENT_SYSTEM_CONTEXTHELPEND Evénement MSAA indiquant que la fenêtre a quitté le mode d’aide contextuelle. 0x000D Evénement MSAA indiquant que la fenêtre a quitté le mode d’aide contextuelle. EVENT_SYSTEM_CONTEXTHELPSTART Evénement MSAA indiquant que la fenêtre a lancé le mode d’aide contextuelle. 0x000C Evénement MSAA indiquant que la fenêtre a lancé le mode d’aide contextuelle. EVENT_SYSTEM_DIALOGEND Evénement MSAA indiquant qu’une boîte de dialogue a été fermée. 0x0011 Evénement MSAA indiquant qu’une boîte de dialogue a été fermée.

Cet événement est envoyé par le système pour les boîtes de dialogue standard. Les applications serveur MSAA envoient cet événement pour les boîtes de dialogue personnalisées.

EVENT_SYSTEM_DIALOGSTART Evénement MSAA indiquant qu’une boîte de dialogue a été affichée. 0x0010 Evénement MSAA indiquant qu’une boîte de dialogue a été affichée.

Cet événement est envoyé par le système pour les boîtes de dialogue standard. Les applications serveur MSAA envoient cet événement pour les boîtes de dialogue personnalisées (les fenêtres qui fonctionnent en tant que boîtes de dialogue mais qui ne sont pas créées de manière classique).

EVENT_SYSTEM_DRAGDROPEND Evénement MSAA indiquant qu’une application est sur le point de quitter le mode glisser-déposer. 0x000F Evénement MSAA indiquant qu’une application est sur le point de quitter le mode glisser-déposer.

Les applications qui prennent en charge les opérations de glisser-déposer doivent envoyer cet événement, contrairement au système.

EVENT_SYSTEM_DRAGDROPSTART Evénement MSAA indiquant qu’une application est sur le point de lancer le mode glisser-déposer. 0x000E Evénement MSAA indiquant qu’une application est sur le point de lancer le mode glisser-déposer.

Les applications qui prennent en charge les opérations de glisser-déposer doivent envoyer cet événement, contrairement au système.

EVENT_SYSTEM_FOREGROUND Evénement MSAA indiquant que la fenêtre de premier plan a été modifiée. 0x0003 Evénement MSAA indiquant que la fenêtre de premier plan a été modifiée.

Le système envoie cet événement même si la fenêtre de premier plan est remplacée par une autre fenêtre du même thread. Les applications serveur MSAA n’envoient jamais cet événement.

EVENT_SYSTEM_MENUEND Evénement MSAA indiquant qu’un menu de la barre de menus a été fermé. 0x0005 Evénement MSAA indiquant qu’un menu de la barre de menus a été fermé.

Le système envoie cet événement pour les menus standard. Les applications serveur MSAA envoient cet événement pour les menus personnalisés.

EVENT_SYSTEM_MENUPOPUPEND Evénement MSAA indiquant qu’un menu contextuel a été fermé. 0x0007 Evénement MSAA indiquant qu’un menu contextuel a été fermé.

Le système envoie cet événement pour les menus standard. Les applications serveur MSAA envoient cet événement pour les menus personnalisés. Lorsqu’un menu contextuel est fermé, le client reçoit ce message suivi presque immédiatement par l’événement EVENT_SYSTEM_MENUEND.

EVENT_SYSTEM_MENUPOPUPSTART Evénement MSAA indiquant qu’un menu contextuel a été affiché. 0x0006 Evénement MSAA indiquant qu’un menu contextuel a été affiché.

EVENT_SYSTEM_MENUSTART Evénement MSAA indiquant qu’un menu de la barre de menus a été sélectionné. 0x0004 Evénement MSAA indiquant qu’un menu de la barre de menus a été sélectionné.

Le système envoie cet événement pour les menus standard. Les applications serveur MSAA envoient cet événement pour les menus personnalisés (éléments d’interface utilisateur faisant office de menus mais qui ne sont pas créés de manière classique). Le système peut déclencher plusieurs événements EVENT_SYSTEM_MENUSTART qui peuvent correspondre ou pas à un événement EVENT_SYSTEM_MENUEND.

EVENT_SYSTEM_MINIMIZEEND Evénement MSAA indiquant qu’un objet fenêtre a été réduit ou agrandi. 0x0017 Evénement MSAA indiquant qu’un objet fenêtre a été réduit ou agrandi.

Cet événement est envoyé par le système ; les applications serveur MSAA n’envoient jamais cet événement.

EVENT_SYSTEM_MINIMIZESTART Evénement MSAA indiquant qu’un objet fenêtre est sur le point d’être réduit ou agrandi. 0x0016 Evénement MSAA indiquant qu’un objet fenêtre est sur le point d’être réduit ou agrandi.

Cet événement est envoyé par le système ; les applications serveur MSAA n’envoient jamais cet événement.

EVENT_SYSTEM_MOVESIZEEND Evénement MSAA indiquant que le déplacement ou le redimensionnement d’une fenêtre est terminé. 0x000B Evénement MSAA indiquant que le déplacement ou le redimensionnement d’une fenêtre est terminé.

Cet événement est envoyé par le système ; les applications serveur MSAA n’envoient jamais cet événement.

EVENT_SYSTEM_MOVESIZESTART Evénement MSAA indiquant que la fenêtre est déplacée ou redimensionnée. 0x000A Evénement MSAA indiquant que la fenêtre est déplacée ou redimensionnée.

Cet événement est envoyé par le système ; les applications serveur MSAA n’envoient jamais cet événement.

EVENT_SYSTEM_SCROLLINGEND Evénement MSAA indiquant que le défilement est terminé sur une barre de défilement. 0x0013 Evénement MSAA indiquant que le défilement est terminé sur une barre de défilement.

EVENT_SYSTEM_SCROLLINGSTART Evénement MSAA indiquant que le défilement a commencé sur une barre de défilement. 0x0012 Evénement MSAA indiquant que le défilement a commencé sur une barre de défilement.

Cet événement est envoyé par le système pour les barres de défilement associées à une fenêtre et pour les contrôles de barre de défilement standard. Les applications serveur MSAA envoient cet événement pour les barres de défilement personnalisées (éléments d’interface utilisateur faisant office de barres de défilement mais qui ne sont pas créés de manière classique).

EVENT_SYSTEM_SOUND Evénement MSAA indiquant qu’un son a été lu. 0x0001 Evénement MSAA indiquant qu’un son a été lu.

Le système envoie cet événement lorsqu’un son système (pour les menus, par exemple) est lu même si aucun son n’est audible (en cas d’absence de fichier audio ou de carte son, par exemple). Les applications serveur MSAA envoient cet événement lorsqu’un élément d’interface utilisateur personnalisé génère un son.

EVENT_SYSTEM_SWITCHEND Evénement MSAA indiquant que l’utilisateur a relâché ALT+TAB. 0x0015 Evénement MSAA indiquant que l’utilisateur a relâché ALT+TAB.

Cet événement est envoyé par le système ; les applications serveur MSAA n’envoient jamais cet événement. Si seule une application est en cours d’exécution lorsque l’utilisateur appuie sur ALT+TAB, le système envoie cet événement sans événement EVENT_SYSTEM_SWITCHSTART correspondant.

EVENT_SYSTEM_SWITCHSTART Evénement MSAA indiquant que l’utilisateur a appuyé sur ALT+TAB, ce qui active la fenêtre de changement. 0x0014 Evénement MSAA indiquant que l’utilisateur a appuyé sur ALT+TAB, ce qui active la fenêtre de changement.

Cet événement est envoyé par le système ; les applications serveur MSAA n’envoient jamais cet événement. Si seule une application est en cours d’exécution lorsque l’utilisateur appuie sur ALT+TAB, le système envoie un événement EVENT_SYSTEM_SWITCHEND sans événement EVENT_SYSTEM_SWITCHSTART correspondant.

ROLE_SYSTEM_ALERT Rôle MSAA indiquant que cet objet représente une alerte ou une condition dont l’utilisateur doit être averti. 0x8 Rôle MSAA indiquant que cet objet représente une alerte ou une condition dont l’utilisateur doit être averti.

Ce rôle doit être utilisé uniquement pour les objets qui représentent une alerte mais qui ne sont pas associés à un autre élément d’interface utilisateur, tel qu’une boîte de message, un graphique, du texte ou un son.

ROLE_SYSTEM_ANIMATION Rôle MSAA indiquant que cet objet représente un contrôle d’animation dont le contenu est modifié dans le temps, par exemple un contrôle affichant une série d’images bitmap, tel qu’un storyboard. 0x36 Rôle MSAA indiquant que cet objet représente un contrôle d’animation dont le contenu est modifié dans le temps, par exemple un contrôle affichant une série d’images bitmap, tel qu’un storyboard.

Les contrôles d’animation sont généralement affichés lorsque les fichiers sont copiés ou lorsqu’une autre tâche longue est en cours d’exécution.

ROLE_SYSTEM_APPLICATION Rôle MSAA indiquant que l’objet représente la fenêtre principale d’une application. 0xE Rôle MSAA indiquant que l’objet représente la fenêtre principale d’une application. ROLE_SYSTEM_BORDER Rôle MSAA indiquant que l’objet représente un bordure de fenêtre. 0x13 Rôle MSAA indiquant que l’objet représente un bordure de fenêtre.

L’ensemble de la bordure est représenté par un seul objet, plutôt que par des objets distincts pour chaque côté.

ROLE_SYSTEM_BUTTONDROPDOWNGRID Rôle MSAA indiquant que l’objet représente un bouton qui déroule une grille. 0x3A Rôle MSAA indiquant que l’objet représente un bouton qui déroule une grille. ROLE_SYSTEM_BUTTONDROPDOWN Rôle MSAA indiquant que l’objet représente un bouton qui déroule une liste d’éléments. 0x38 Rôle MSAA indiquant que l’objet représente un bouton qui déroule une liste d’éléments. ROLE_SYSTEM_BUTTONMENU Rôle MSAA indiquant que l’objet représente un bouton qui déroule un menu. 0x39 Rôle MSAA indiquant que l’objet représente un bouton qui déroule un menu. ROLE_SYSTEM_CARET Rôle MSAA indiquant que l’objet représente le caret système. 0x7 Rôle MSAA indiquant que l’objet représente le caret système. ROLE_SYSTEM_CELL Rôle MSAA indiquant que l’objet représente une cellule d’un tableau. 0x1D Rôle MSAA indiquant que l’objet représente une cellule d’un tableau. ROLE_SYSTEM_CHARACTER Rôle MSAA indiquant que l’objet représente un objet graphique de type dessin animé, tel que l’Assistant Microsoft Office qui est généralement affiché pour aider les utilisateurs d’une application. 0x20 Rôle MSAA indiquant que l’objet représente un objet graphique de type dessin animé, tel que l’Assistant Microsoft Office qui est généralement affiché pour aider les utilisateurs d’une application. ROLE_SYSTEM_CHART Rôle MSAA indiquant que l’objet représente une image graphique utilisée pour représenter des données. 0x11 Rôle MSAA indiquant que l’objet représente une image graphique utilisée pour représenter des données. ROLE_SYSTEM_CHECKBUTTON Rôle MSAA indiquant que l’objet représente un contrôle de case à cocher, une option qui peut être activée ou désactivée indépendamment des autres options. 0x2C Rôle MSAA indiquant que l’objet représente un contrôle de case à cocher, une option qui peut être activée ou désactivée indépendamment des autres options. ROLE_SYSTEM_CLIENT Rôle MSAA indiquant que l’objet représente la zone cliente d’une fenêtre. 0xA Rôle MSAA indiquant que l’objet représente la zone cliente d’une fenêtre. ROLE_SYSTEM_CLOCK Rôle MSAA indiquant que l’objet représente un contrôle affichant l’heure. 0x3D Rôle MSAA indiquant que l’objet représente un contrôle affichant l’heure. ROLE_SYSTEM_COLUMNHEADER Rôle MSAA indiquant que l’objet représente un en-tête de colonne, fournissant une étiquette visuelle d’une colonne d’un tableau. 0x19 Rôle MSAA indiquant que l’objet représente un en-tête de colonne, fournissant une étiquette visuelle d’une colonne d’un tableau. ROLE_SYSTEM_COLUMN Rôle MSAA indiquant que l’objet représente une colonne de cellules dans un tableau. 0x1B Rôle MSAA indiquant que l’objet représente une colonne de cellules dans un tableau. ROLE_SYSTEM_COMBOBOX Rôle MSAA indiquant que l’objet représente une liste déroulante, c’est-à-dire un contrôle de modification avec une zone de liste associée fournissant un ensemble de choix prédéfinis. 0x2E Rôle MSAA indiquant que l’objet représente une liste déroulante, c’est-à-dire un contrôle de modification avec une zone de liste associée fournissant un ensemble de choix prédéfinis. ROLE_SYSTEM_CURSOR Rôle MSAA indiquant que l’objet représente le pointeur de la souris du système. 0x6 Rôle MSAA indiquant que l’objet représente le pointeur de la souris du système. ROLE_SYSTEM_DIAGRAM Rôle MSAA indiquant que l’objet représente une image graphique utilisée pour représenter des données sous forme de diagramme. 0x35 Rôle MSAA indiquant que l’objet représente une image graphique utilisée pour représenter des données sous forme de diagramme. ROLE_SYSTEM_DIALOG Rôle MSAA indiquant que l’objet représente une boîte de dialogue ou de message. 0x12 Rôle MSAA indiquant que l’objet représente une boîte de dialogue ou de message. ROLE_SYSTEM_DIAL Rôle MSAA indiquant que l’objet représente un bouton rotatif ou un pommeau. 0x31 Rôle MSAA indiquant que l’objet représente un bouton rotatif ou un pommeau.

Il peut également s’agir d’un objet en lecture seule avec un compteur de vitesse.

ROLE_SYSTEM_DOCUMENT Rôle MSAA indiquant que l’objet représente une fenêtre de document. 0xF Rôle MSAA indiquant que l’objet représente une fenêtre de document.

Une fenêtre de document est toujours contenue dans une fenêtre d’application. Ce rôle s’applique uniquement à une interface multidocument (MDI) et fait référence à l’objet qui contient la barre de titre MDI.

ROLE_SYSTEM_DROPLIST Rôle MSAA indiquant que l’objet représente un zone de liste déroulante. 0x2F Rôle MSAA indiquant que l’objet représente un zone de liste déroulante.

Il affiche un élément et permet à l’utilisateur d’en afficher et sélectionner un autre à partir d’une liste de valeurs alternatives.

ROLE_SYSTEM_EQUATION Rôle MSAA indiquant que l’objet représente une équation mathématique. 0x37 Rôle MSAA indiquant que l’objet représente une équation mathématique. ROLE_SYSTEM_GRAPHIC Rôle MSAA indiquant que l’objet représente une image. 0x28 Rôle MSAA indiquant que l’objet représente une image. ROLE_SYSTEM_GRIP Rôle MSAA indiquant que l’objet représente un pointeur de souris spécial qui permet à l’utilisateur de manipuler les éléments d’une interface utilisateur, tels qu’une fenêtre. 0x4 Rôle MSAA indiquant que l’objet représente un pointeur de souris spécial qui permet à l’utilisateur de manipuler les éléments d’une interface utilisateur, tels qu’une fenêtre.

Par exemple, un utilisateur peut cliquer et faire glisser une poignée de dimensionnement dans le coin inférieur droit d’une fenêtre pour la redimensionner.

ROLE_SYSTEM_GROUPING Rôle MSAA indiquant que l’objet regroupe logiquement d’autres objets. 0x14 Rôle MSAA indiquant que l’objet regroupe logiquement d’autres objets.

Il peut y avoir ou non une relation parent-enfant entre l’objet de regroupement et les objets qu’il contient.

ROLE_SYSTEM_HELPBALLOON Rôle MSAA indiquant que l’objet affiche l’aide sous la forme d’une info-bulle ou d’une bulle d’aide. 0x1F Rôle MSAA indiquant que l’objet affiche l’aide sous la forme d’une info-bulle ou d’une bulle d’aide. ROLE_SYSTEM_HOTKEYFIELD Rôle MSAA indiquant que l’objet représente un champ de touche d’accès rapide qui permet à l’utilisateur d’entrer une combinaison ou une séquence de touches. 0x32 Rôle MSAA indiquant que l’objet représente un champ de touche d’accès rapide qui permet à l’utilisateur d’entrer une combinaison ou une séquence de touches. ROLE_SYSTEM_INDICATOR Rôle MSAA indiquant que l’objet représente un indicateur tel qu’un pointeur graphique qui pointe vers l’élément actif. 0x27 Rôle MSAA indiquant que l’objet représente un indicateur tel qu’un pointeur graphique qui pointe vers l’élément actif. ROLE_SYSTEM_IPADDRESS Rôle MSAA indiquant que l’objet représente un contrôle de modification conçu pour une adresse IP. 0x3F Rôle MSAA indiquant que l’objet représente un contrôle de modification conçu pour une adresse IP. Le contrôle de modification est divisé en sections correspondant aux différentes parties de l’adresse IP. ROLE_SYSTEM_LINK Rôle MSAA indiquant que l’objet représente un lien vers autre chose. 0x1E Rôle MSAA indiquant que l’objet représente un lien vers autre chose.

Cet objet peut ressembler à du texte ou à un graphique, mais il agit comme un bouton.

ROLE_SYSTEM_LISTITEM Rôle MSAA indiquant que l’objet représente un élément d’une zone de liste ou la partie liste d’une liste déroulante ou d’une zone de liste déroulante. 0x22 Rôle MSAA indiquant que l’objet représente un élément d’une zone de liste ou la partie liste d’une liste déroulante ou d’une zone de liste déroulante. ROLE_SYSTEM_LIST Rôle MSAA indiquant que l’objet représente une zone de liste permettant à l’utilisateur de sélectionner un ou plusieurs éléments. 0x21 Rôle MSAA indiquant que l’objet représente une zone de liste permettant à l’utilisateur de sélectionner un ou plusieurs éléments. ROLE_SYSTEM_MENUBAR Rôle MSAA indiquant que l’objet représente la barre de menus, située généralement en dessous de la barre de titre de la fenêtre, qui permet à l’utilisateur de sélectionner les menus. 0x2 Rôle MSAA indiquant que l’objet représente la barre de menus, située généralement en dessous de la barre de titre de la fenêtre, qui permet à l’utilisateur de sélectionner les menus. ROLE_SYSTEM_MENUITEM Rôle MSAA indiquant que l’objet représente un élément de menu, qui correspond à une entrée d’un menu qu’un utilisateur peut sélectionner pour exécuter une commande, sélectionner une option ou afficher un autre menu. 0xC Rôle MSAA indiquant que l’objet représente un élément de menu, qui correspond à une entrée d’un menu qu’un utilisateur peut sélectionner pour exécuter une commande, sélectionner une option ou afficher un autre menu.

D’un point de vue fonctionnel, un élément de menu peut être équivalent à un bouton-poussoir, un bouton radio, une case à cocher ou un menu.

ROLE_SYSTEM_MENUPOPUP Rôle MSAA indiquant que l’objet représente un menu, qui présente une liste d’options permettant à l’utilisateur d’effectuer une sélection en vue d’exécuter une action. 0xB Rôle MSAA indiquant que l’objet représente un menu, qui présente une liste d’options permettant à l’utilisateur d’effectuer une sélection en vue d’exécuter une action.

Tous les types de menus doivent posséder ce rôle, notamment les menus déroulants qui sont affichés par sélection à partir d’une barre de menus et les menus de raccourcis qui s’affichent lorsque le bouton droit de la souris est activé.

ROLE_SYSTEM_OUTLINEBUTTON Rôle MSAA indiquant que l’objet représente des éléments dans lesquels la navigation s’effectue comme dans un élément de contour. 0x40 Rôle MSAA indiquant que l’objet représente des éléments qui naviguent comme un élément de contour. Vous pouvez utiliser les flèches vers le haut et vers le bas pour vous déplacer dans le contour. Toutefois, au lieu de développer et réduire les menus à l’aide des flèches gauche et droite, le développement ou la réduction de ces menus survient lorsque la barre d’espace ou la touche d’entrée est enfoncée et que l’élément a le focus. ROLE_SYSTEM_OUTLINEITEM Rôle MSAA indiquant que l’objet représente un élément dans un contour ou une structure arborescente. 0x24 Rôle MSAA indiquant que l’objet représente un élément dans un contour ou une structure arborescente. ROLE_SYSTEM_OUTLINE Rôle MSAA indiquant que l’objet représente un contour ou une structure arborescente, tel qu’un contrôle arborescence, qui affiche une liste hiérarchique et permet généralement à l’utilisateur de développer et de réduire des branches. 0x23 Rôle MSAA indiquant que l’objet représente un contour ou une structure arborescente, tel qu’un contrôle arborescence, qui affiche une liste hiérarchique et permet généralement à l’utilisateur de développer et de réduire des branches. ROLE_SYSTEM_PAGETABLIST Rôle MSAA indiquant que l’objet représente un conteneur de contrôles d’onglet de page. 0x3C Rôle MSAA indiquant que l’objet représente un conteneur de contrôles d’onglet de page. ROLE_SYSTEM_PAGETAB Rôle MSAA indiquant que l’objet représente un onglet de page. 0x25 Rôle MSAA indiquant que l’objet représente un onglet de page. En général, le seul enfant d’un contrôle d’onglet de page est un objet ROLE_SYSTEM_GROUPING contenant le contenu de la page associée. ROLE_SYSTEM_PANE Rôle MSAA indiquant que l’objet représente un volet d’une fenêtre frame ou de document. 0x10 Rôle MSAA indiquant que l’objet représente un volet d’une fenêtre frame ou de document.

Les utilisateurs peuvent naviguer d’un volet à l’autre ainsi que dans le contenu du volet actif mais ne peuvent pas naviguer d’un élément à l’autre dans différents volets. Par conséquent, les volets représentent un niveau de regroupement inférieur à celui des fenêtres frame ou des documents, mais supérieur à celui des options individuelles. En règle générale, l’utilisateur navigue d’un volet à l’autre en appuyant sur les touches TAB, F6 ou Ctrl+TAB, selon le contexte.

ROLE_SYSTEM_PROGRESSBAR Rôle MSAA indiquant que l’objet représente une barre de progression indiquant dynamiquement à l’utilisateur le pourcentage d’achèvement d’une opération en cours. 0x30 Rôle MSAA indiquant que l’objet représente une barre de progression indiquant dynamiquement à l’utilisateur le pourcentage d’achèvement d’une opération en cours.

Cette option ne nécessite généralement aucune entrée utilisateur.

ROLE_SYSTEM_PROPERTYPAGE Rôle MSAA indiquant que l’objet représente une feuille de propriété. 0x26 Rôle MSAA indiquant que l’objet représente une feuille de propriété. ROLE_SYSTEM_PUSHBUTTON Rôle MSAA indiquant que l’objet représente un contrôle de bouton-poussoir. 0x2B Rôle MSAA indiquant que l’objet représente un contrôle de bouton-poussoir. ROLE_SYSTEM_RADIOBUTTON Rôle MSAA indiquant que l’objet représente un bouton d’option (également appelé bouton radio). 0x2D Rôle MSAA indiquant que l’objet représente un bouton d’option (également appelé bouton radio).

Il fait partie d’un groupe d’options qui s’excluent mutuellement. Tous les objets partageant un seul parent qui ont cet attribut sont considérés comme faisant partie d’un groupe unique mutuellement exclusif. Vous pouvez utiliser des objets ROLE_SYSTEM_GROUPING pour les diviser en groupes distincts lorsque cela est nécessaire.

ROLE_SYSTEM_ROWHEADER Rôle MSAA indiquant que l’objet représente un en-tête de ligne, fournissant une étiquette visuelle pour une ligne d’un tableau. 0x1A Rôle MSAA indiquant que l’objet représente un en-tête de ligne, fournissant une étiquette visuelle pour une ligne d’un tableau. ROLE_SYSTEM_ROW Rôle MSAA indiquant que l’objet représente une ligne de cellules dans un tableau. 0x1C Rôle MSAA indiquant que l’objet représente une ligne de cellules dans un tableau. ROLE_SYSTEM_SCROLLBAR Rôle MSAA indiquant que l’objet représente une barre de défilement verticale ou horizontale pouvant faire partie de la zone cliente ou pouvant être utilisée dans un contrôle. 0x3 Rôle MSAA indiquant que l’objet représente une barre de défilement verticale ou horizontale pouvant faire partie de la zone cliente ou pouvant être utilisée dans un contrôle. ROLE_SYSTEM_SEPARATOR Rôle MSAA indiquant que l’objet est utilisé pour diviser visuellement un espace en deux régions, tel qu’un élément de menu séparateur ou une barre divisant des volets fractionnés dans une fenêtre. 0x15 Rôle MSAA indiquant que l’objet est utilisé pour diviser visuellement un espace en deux régions, tel qu’un élément de menu séparateur ou une barre divisant des volets fractionnés dans une fenêtre. ROLE_SYSTEM_SLIDER Rôle MSAA indiquant que l’objet représente un curseur permettant à l’utilisateur d’ajuster un paramètre selon des incréments donnés entre des valeurs minimum et maximum. 0x33 Rôle MSAA indiquant que l’objet représente un curseur permettant à l’utilisateur d’ajuster un paramètre selon des incréments donnés entre des valeurs minimum et maximum. ROLE_SYSTEM_SOUND Rôle MSAA indiquant que l’objet représente un son système associé à différents événements système. 0x5 Rôle MSAA indiquant que l’objet représente un son système associé à différents événements système. ROLE_SYSTEM_SPINBUTTON Rôle MSAA indiquant que l’objet représente une zone de sélection numérique, qui est un contrôle permettant à l’utilisateur d’incrémenter ou de décrémenter la valeur affichée dans un contrôle associé relatif à la zone de sélection numérique. 0x34 Rôle MSAA indiquant que l’objet représente une zone de sélection numérique, qui est un contrôle permettant à l’utilisateur d’incrémenter ou de décrémenter la valeur affichée dans un contrôle associé relatif à la zone de sélection numérique. ROLE_SYSTEM_SPLITBUTTON Rôle MSAA indiquant que l’objet représente un bouton d’une barre d’outils sur laquelle il est immédiatement adjacent à une icône de liste déroulante. 0x3E Rôle MSAA indiquant que l’objet représente un bouton d’une barre d’outils sur laquelle il est immédiatement adjacent à une icône de liste déroulante. ROLE_SYSTEM_STATICTEXT Rôle MSAA indiquant que l’objet représente du texte en lecture seule, tel que les étiquettes d’autres contrôles ou les instructions dans une boîte de dialogue. 0x29 Rôle MSAA indiquant que l’objet représente du texte en lecture seule, tel que les étiquettes d’autres contrôles ou les instructions dans une boîte de dialogue.

Un texte statique ne peut pas être modifié ou sélectionné.

ROLE_SYSTEM_STATUSBAR Rôle MSAA indiquant que l’objet représente une barre d’état, c’est-à-dire une zone généralement située au bas d’une fenêtre qui affiche des informations sur l’opération en cours, l’état de l’application ou l’objet sélectionné. 0x17 Rôle MSAA indiquant que l’objet représente une barre d’état, c’est-à-dire une zone généralement située au bas d’une fenêtre qui affiche des informations sur l’opération en cours, l’état de l’application ou l’objet sélectionné.

La barre d’état peut posséder plusieurs champs qui affichent différents types d’informations.

ROLE_SYSTEM_TABLE Rôle MSAA indiquant que l’objet représente un tableau composé de lignes et colonnes de cellules et, éventuellement, d’en-têtes de ligne et de colonne. 0x18 Rôle MSAA indiquant que l’objet représente un tableau composé de lignes et colonnes de cellules et, éventuellement, d’en-têtes de ligne et de colonne. ROLE_SYSTEM_TEXT Rôle MSAA indiquant que l’objet représente du texte sélectionnable qui peut être modifiable ou en lecture seule. 0x2A Rôle MSAA indiquant que l’objet représente du texte sélectionnable qui peut être modifiable ou en lecture seule. ROLE_SYSTEM_TITLEBAR Rôle MSAA indiquant que l’objet représente la barre de titre ou de légende d’une fenêtre. 0x1 Rôle MSAA indiquant que l’objet représente la barre de titre ou de légende d’une fenêtre. ROLE_SYSTEM_TOOLBAR Rôle MSAA indiquant que l’objet représente une barre d’outils, c’est-à-dire un groupe de contrôles qui permettent d’accéder facilement aux fonctionnalités fréquemment utilisées. 0x16 Rôle MSAA indiquant que l’objet représente une barre d’outils, c’est-à-dire un groupe de contrôles qui permettent d’accéder facilement aux fonctionnalités fréquemment utilisées. ROLE_SYSTEM_WHITESPACE Rôle MSAA indiquant que l’objet représente un espace entre d’autres objets. 0x3B Rôle MSAA indiquant que l’objet représente un espace entre d’autres objets. ROLE_SYSTEM_WINDOW Rôle MSAA indiquant que l’objet représente le cadre de la fenêtre qui contient généralement des objets enfant, tels qu’une barre de titre, un client et d’autres objets généralement contenus dans une fenêtre. 0x9 Rôle MSAA indiquant que l’objet représente le cadre de la fenêtre qui contient généralement des objets enfant, tels qu’une barre de titre, un client et d’autres objets généralement contenus dans une fenêtre. SELFLAG_ADDSELECTION Indicateur de sélection MSAA qui ajoute l’objet à la sélection actuelle, ce qui peut occasionner une sélection non contiguë. 0x8 Indicateur de sélection MSAA qui ajoute l’objet à la sélection actuelle, ce qui peut occasionner une sélection non contiguë.

Cet indicateur ne modifie pas le focus ou l’ancrage de sélection sauf s’il est combiné avec SELFLAG_TAKEFOCUS. Le comportement de SELFLAG_ADDSELECTION | SELFLAG_TAKEFOCUS équivaut à l’ajout manuel d’un élément à une sélection en maintenant la touche CTRL enfoncée et en cliquant sur un objet non sélectionné dans l’Explorateur Windows.

Cet indicateur ne peut pas être combiné avec SELFLAG_REMOVESELECTION ou SELFLAG_TAKESELECTION.

SELFLAG_EXTENDSELECTION Indicateur de sélection MSAA qui modifie la sélection de sorte que tous les objets situés entre l’ancrage de sélection et cet objet acceptent l’état de sélection de l’objet d’ancrage. 0x4 Indicateur de sélection MSAA qui modifie la sélection de sorte que tous les objets situés entre l’ancrage de sélection et cet objet acceptent l’état de sélection de l’objet d’ancrage.

Ainsi, si l’objet d’ancrage n’est pas sélectionné, les objets sont supprimés de la sélection ; si l’objet d’ancrage est sélectionné, la sélection est étendue à cet objet et à tous les objets intermédiaires. Vous pouvez définir l’état de sélection en combinant cet indicateur avec SELFLAG_ADDSELECTION ou SELFLAG_REMOVESELECTION.

Cet indicateur ne modifie pas le focus ou l’ancrage de sélection sauf s’il est combiné avec SELFLAG_TAKEFOCUS. Le comportement de SELFLAG_EXTENDSELECTION | SELFLAG_TAKEFOCUS équivaut à l’ajout manuel d’un élément à une sélection en maintenant la touche MAJ enfoncée et en cliquant sur un objet non sélectionné dans l’Explorateur Windows.

Cet indicateur ne peut pas être combiné avec SELFLAG_TAKESELECTION.

SELFLAG_NONE Constante représentant l’absence d’indicateurs de sélection MSAA. 0 Constante représentant l’absence d’indicateurs de sélection MSAA. SELFLAG_REMOVESELECTION Indicateur de sélection MSAA qui supprime l’objet de la sélection actuelle, ce qui peut occasionner une sélection non contiguë. 0x10 Indicateur de sélection MSAA qui supprime l’objet de la sélection actuelle, ce qui peut occasionner une sélection non contiguë.

Cet indicateur ne modifie pas le focus ou l’ancrage de sélection sauf s’il est combiné avec SELFLAG_TAKEFOCUS. Le comportement de SELFLAG_REMOVESELECTION | SELFLAG_TAKEFOCUS équivaut à la suppression manuelle d’un élément d’une sélection en maintenant la touche CTRL enfoncée tout en cliquant sur un objet sélectionné dans l’Explorateur Windows.

Cet indicateur ne peut pas être combiné avec SELFLAG_ADDSELECTION ou SELFLAG_TAKESELECTION.

SELFLAG_TAKEFOCUS Indicateur de sélection MSAA qui définit le focus sur l’objet et en fait l’ancrage de sélection. 0x1 Indicateur de sélection MSAA qui définit le focus sur l’objet et en fait l’ancrage de sélection.

Utilisé tout seul, cet indicateur n’a pas d’incidence sur la sélection. Son comportement équivaut à déplacer le focus manuellement en appuyant sur les touches de direction tout en maintenant la touche CTRL enfoncée dans l’Explorateur Windows ou dans une zone de liste à sélection multiple.

Avec des objets présentant l’état STATE_SYSTEM_MULTISELECTABLE, SELFLAG_TAKEFOCUS peut être combiné aux valeurs suivantes :

SELFLAG_TAKESELECTION
SELFLAG_EXTENDSELECTION
SELFLAG_ADDSELECTION
SELFLAG_REMOVESELECTION
SELFLAG_ADDSELECTION | SELFLAG_EXTENDSELECTION
SELFLAG_REMOVESELECTION | SELFLAG_EXTENDSELECTION

SELFLAG_TAKESELECTION Indicateur de sélection MSAA qui sélectionne l’objet et supprime la sélection de tous les autres objets du conteneur. 0x2 Indicateur de sélection MSAA qui sélectionne l’objet et supprime la sélection de tous les autres objets du conteneur.

Cet indicateur ne modifie pas le focus ou l’ancrage de sélection sauf s’il est combiné avec SELFLAG_TAKEFOCUS. Le comportement de SELFLAG_TAKESELECTION | SELFLAG_TAKEFOCUS est équivalent à un clic simple sur un élément dans l’Explorateur Windows.

Cet indicateur ne doit pas être combiné avec les indicateurs suivants :

SELFLAG_ADDSELECTION
SELFLAG_REMOVESELECTION
SELFLAG_EXTENDSELECTION

SELFLAG_VALID Masque binaire représentant tous les indicateurs de sélection MSAA valides. 0x1F Masque binaire représentant tous les indicateurs de sélection MSAA valides. STATE_SYSTEM_ALERT_HIGH Indicateur d’état MSAA indiquant que l’objet affiche des informations importantes devant être transmises à l’utilisateur immédiatement. 0x10000000 Indicateur d’état MSAA indiquant que l’objet affiche des informations importantes devant être transmises à l’utilisateur immédiatement.

Par exemple, un indicateur de batterie tombant à un niveau faible peut effectuer la transition vers cet état. Dans ce cas, un utilitaire d’accès masqué peut annoncer ces informations immédiatement à l’utilisateur, tandis qu’un programme d’agrandissement d’écran peut faire défiler l’écran pour afficher l’indicateur de batterie. Cet état est également approprié pour les invites ou les opérations qui doivent être achevées avant que l’utilisateur puisse poursuivre.

STATE_SYSTEM_ALERT_LOW Indicateur d’état MSAA indiquant que l’objet affiche des informations de faible priorité qui ne sont pas importantes pour l’utilisateur. 0x4000000 Indicateur d’état MSAA indiquant que l’objet affiche des informations de faible priorité qui ne sont pas importantes pour l’utilisateur.

Cet état peut être utilisé, par exemple, lorsque Word modifie l’apparence du bouton Assistant Conseil sur sa barre d’outils pour indiquer qu’il a un conseil pour l’utilisateur.

STATE_SYSTEM_ALERT_MEDIUM Indicateur d’état MSAA indiquant que l’objet affiche des informations importantes qu’il n’est pas nécessaire de transmettre à l’utilisateur immédiatement. 0x8000000 Indicateur d’état MSAA indiquant que l’objet affiche des informations importantes qu’il n’est pas nécessaire de transmettre à l’utilisateur immédiatement.

Par exemple, lorsque l’indicateur de batterie commence à atteindre un niveau faible, il peut générer un message d’avertissement de niveau moyen. Les utilitaires d’accès masqué peuvent alors générer un son pour signaler à l’utilisateur que des informations importantes sont disponibles, sans pour autant l’interrompre dans son travail. L’utilisateur peut alors consulter les informations du message d’alerte à sa guise.

STATE_SYSTEM_ANIMATED Indicateur d’état MSAA indiquant que l’aspect de l’objet change rapidement ou constamment. 0x4000 Indicateur d’état MSAA indiquant que l’aspect de l’objet change rapidement ou constamment.

Les graphiques qui sont parfois animés doivent être décrits en tant que ROLE_SYSTEM_GRAPHIC en définissant la propriété State sur STATE_SYSTEM_ANIMATED. Cet état ne doit pas être utilisé pour indiquer que l’emplacement de l’objet est modifié.

STATE_SYSTEM_BUSY Indicateur d’état MSAA indiquant que l’objet ne peut pas accepter d’entrée pour l’instant. 0x800 Indicateur d’état MSAA indiquant que l’objet ne peut pas accepter d’entrée pour l’instant. STATE_SYSTEM_CHECKED Indicateur d’état MSAA indiquant que la case de l’objet est cochée. 0x10 Indicateur d’état MSAA indiquant que la case de l’objet est cochée. STATE_SYSTEM_COLLAPSED Indicateur d’état MSAA indiquant que les enfants de cet objet possédant le rôle ROLE_SYSTEM_OUTLINEITEM sont masqués. 0x400 Indicateur d’état MSAA indiquant que les enfants de cet objet possédant le rôle ROLE_SYSTEM_OUTLINEITEM sont masqués. STATE_SYSTEM_DEFAULT Indicateur d’état MSAA indiquant le bouton ou l’élément de menu par défaut. 0x100 Indicateur d’état MSAA indiquant le bouton ou l’élément de menu par défaut. STATE_SYSTEM_EXPANDED Indicateur d’état MSAA indiquant que les enfants de cet objet possédant le rôle ROLE_SYSTEM_OUTLINEITEM sont affichés. 0x200 Indicateur d’état MSAA indiquant que les enfants de cet objet possédant le rôle ROLE_SYSTEM_OUTLINEITEM sont affichés. STATE_SYSTEM_EXTSELECTABLE Indicateur d’état MSAA indiquant que l’objet peut étendre sa sélection à l’aide de SELFLAG_EXTENDSELECTION dans la méthode IAccessible::accSelect. 0x2000000 Indicateur d’état MSAA indiquant que l’objet peut étendre sa sélection à l’aide de SELFLAG_EXTENDSELECTION dans la méthode IAccessible::accSelect. STATE_SYSTEM_FLOATING Indicateur d’état MSAA indiquant que l’objet n’est pas attaché à la limite de son objet parent et ne se déplace pas automatiquement en même temps que le parent. 0x1000 Indicateur d’état MSAA indiquant que l’objet n’est pas attaché à la limite de son objet parent et ne se déplace pas automatiquement en même temps que le parent. STATE_SYSTEM_FOCUSABLE Indicateur d’état MSAA indiquant que l’objet se trouve sur la fenêtre active et peut recevoir le focus du clavier. 0x100000 Indicateur d’état MSAA indiquant que l’objet se trouve sur la fenêtre active et peut recevoir le focus du clavier. STATE_SYSTEM_FOCUSED Indicateur d’état MSAA indiquant que l’objet a actuellement le focus clavier. 0x4 Indicateur d’état MSAA indiquant que l’objet a actuellement le focus clavier.

Ne confondez pas le focus d’objet avec la sélection d’objet.

STATE_SYSTEM_HASPOPUP Indicateur d’état MSAA indiquant que l’objet a un menu contextuel. 0x40000000 Indicateur d’état MSAA indiquant que l’objet a un menu contextuel. (MSAA 2.0) STATE_SYSTEM_HOTTRACKED Indicateur d’état MSAA indiquant que l’objet est actuellement mis en surbrillance par la souris, ce qui signifie que son apparence a été modifiée pour indiquer que le pointeur de la souris se trouve au-dessus de celui-ci. 0x80 Indicateur d’état MSAA indiquant que l’objet est actuellement mis en surbrillance par la souris, ce qui signifie que son apparence a été modifiée pour indiquer que le pointeur de la souris se trouve au-dessus de celui-ci. STATE_SYSTEM_INVISIBLE Indicateur d’état MSAA indiquant que l’objet est masqué ou non visible. 0x8000 Indicateur d’état MSAA indiquant que l’objet est masqué ou non visible.

La liste des noms de fichiers d’une zone de liste peut contenir plusieurs centaines de noms, mais seuls certains sont visibles par l’utilisateur. Le reste est tronqué par le parent et doit être défini sur STATE_SYSTEM_INVISIBLE.

Les objets qui ne sont jamais visibles doivent être définis sur STATE_SYSTEM_OFFSCREEN. Notez qu’un objet peut être considéré comme visible (c’est-à-dire que l’indicateur STATE_SYSTEM_INVISIBLE n’est pas défini) et être tout de même masqué par une autre application. Il n’est donc pas visible par l’utilisateur. Par exemple, un objet est considéré comme visible s’il apparaît dans la fenêtre principale d’une application, même s’il est masqué par une boîte de dialogue.

STATE_SYSTEM_LINKED Indicateur d’état MSAA indiquant que l’objet est lié. 0x400000 Indicateur d’état MSAA indiquant que l’objet est lié. STATE_SYSTEM_MARQUEED Indicateur d’état MSAA indiquant que l’objet affiche du texte ou des graphiques défilants ou en mouvement. 0x2000 Indicateur d’état MSAA indiquant que l’objet affiche du texte ou des graphiques défilants ou en mouvement. STATE_SYSTEM_MIXED Indicateur d’état MSAA indiquant que l’état d’une case à cocher ou d’un bouton de barre d’outils à trois états n’est pas déterminé. 0x20 Indicateur d’état MSAA indiquant que l’état d’une case à cocher ou d’un bouton de barre d’outils à trois états n’est pas déterminé.

La case n’est ni cochée ni désélectionnée et possède donc le troisième état (mixte).

STATE_SYSTEM_MOVEABLE Indicateur d’état MSAA indiquant que l’objet peut être déplacé. 0x40000 Indicateur d’état MSAA indiquant que l’objet peut être déplacé. STATE_SYSTEM_MULTISELECTABLE Indicateur d’état MSAA indiquant que l’objet peut accepter plusieurs éléments sélectionnés (c’est-à-dire que SELFLAG_ADDSELECTION pour la méthode IAccessible::accSelect est valide). 0x1000000 Indicateur d’état MSAA indiquant que l’objet peut accepter plusieurs éléments sélectionnés (c’est-à-dire que SELFLAG_ADDSELECTION pour la méthode IAccessible::accSelect est valide). STATE_SYSTEM_NORMAL Constante représentant l’absence d’indicateurs d’état MSAA. 0 Constante représentant l’absence d’indicateurs d’état MSAA. STATE_SYSTEM_OFFSCREEN Indicateur d’état MSAA indiquant que l’objet n’est pas représenté à l’écran. 0x10000 Indicateur d’état MSAA indiquant que l’objet n’est pas représenté à l’écran.

Un objet son ou alerte ou une fenêtre masquée qui ne sera jamais visible peut avoir cet état.

STATE_SYSTEM_PRESSED Indicateur d’état MSAA indiquant que cet objet est enfoncé. 0x8 Indicateur d’état MSAA indiquant que cet objet est enfoncé. STATE_SYSTEM_PROTECTED Indicateur d’état MSAA indiquant que l’objet est un contrôle de modification protégé par mot de passe. 0x20000000 Indicateur d’état MSAA indiquant que l’objet est un contrôle de modification protégé par mot de passe. STATE_SYSTEM_READONLY Indicateur d’état MSAA indiquant que l’objet est en lecture seule. 0x40 Indicateur d’état MSAA indiquant que l’objet est en lecture seule. STATE_SYSTEM_SELECTABLE Indicateur d’état MSAA indiquant que l’objet peut accepter la sélection. 0x200000 Indicateur d’état MSAA indiquant que l’objet peut accepter la sélection. STATE_SYSTEM_SELECTED Indicateur d’état MSAA indiquant que l’objet est sélectionné. 0x2 Indicateur d’état MSAA indiquant que l’objet est sélectionné. STATE_SYSTEM_SELFVOICING Indicateur d’état MSAA indiquant que l’objet peut utiliser la synthèse vocale pour se décrire. 0x80000 Indicateur d’état MSAA indiquant que l’objet peut utiliser la synthèse vocale pour se décrire.

Une aide d’accessibilité reposant sur la synthèse vocale ne doit pas annoncer d’informations lorsqu’un objet avec cet état a le focus, car l’objet annonce automatiquement des informations le concernant.

STATE_SYSTEM_SIZEABLE Indicateur d’état MSAA indiquant que l’objet peut être redimensionné. 0x20000 Indicateur d’état MSAA indiquant que l’objet peut être redimensionné. STATE_SYSTEM_TRAVERSED Indicateur d’état MSAA indiquant que l’objet a été parcouru. 0x800000 Indicateur d’état MSAA indiquant que l’objet a été parcouru. STATE_SYSTEM_UNAVAILABLE Indicateur d’état MSAA indiquent que l’objet n’est pas disponible. 0x1 Indicateur d’état MSAA indiquent que l’objet n’est pas disponible. STATE_SYSTEM_VALID Masque binaire représentant tous les indicateurs d’état MSAA valides. 0x7FFFFFFF Masque binaire représentant tous les indicateurs d’état MSAA valides. UIComponentAccProps UIComponentAccProps est une sous-classe de la classe AccessibilityProperties utilisable par plusieurs composants UIComponents. flash.accessibility:AccessibilityProperties UIComponentAccProps est une sous-classe de la classe AccessibilityProperties utilisable par plusieurs composants UIComponents. Elle est utilisée pour fournir une accessibilité à Form, ToolTip et Error ToolTip. UIComponentAccProps Constructeur.componentmx.core:UIComponentOccurrence UIComponent dont cette occurrence AccessibilityProperties assure l’accessibilité. Constructeur. enableAccessibility Active l’accessibilité dans la classe UIComponent. Active l’accessibilité dans la classe UIComponent.

Cette méthode est appelée par le code de démarrage de l’application qui est autogénéré par le compilateur MXML. Ensuite, lorsque des occurrences de UIComponent sont initialisées, leur propriété accessibilityImplementation est définie sur une occurrence de cette classe.

eventHandler Gestionnaire d’événement générique. event Gestionnaire d’événement générique. Toutes les sous-classes UIComponentAccProps doivent l’implémenter pour écouter les événements de son composant principal. master Référence à la classe UIComponent. mx.core:UIComponent Référence à la classe UIComponent. AccImpl AccImpl est la classe d’implémentation d’accessibilité de base pour les composants Spark et MX. flash.accessibility:AccessibilityImplementation AccImpl est la classe d’implémentation d’accessibilité de base pour les composants Spark et MX.

Il s’agit d’une sous-classe de la classe AccessibilityImplementation de Flash Player.

Lorsqu’un composant MX ou Spark est créé, sa propriété accessibilityImplementation est définie en tant qu’occurrence d’une sous-classe de cette classe. Flash Player utilise ensuite cet objet pour permettre aux clients MSAA, tels que les lecteurs d’écran, de voir et de manipuler le composant. Pour plus d’informations sur les classes d’implémentation d’accessibilité et MSAA, voir la classe flash.accessibility.AccessibilityImplementation.

Enfants

Flash Player ne prend pas en charge une vraie hiérarchie d’objets accessibles. Si un objet DisplayObject possède un objet accessibilityImplementation, alors les objets accessibilityImplementation de ses enfants sont ignorés. Cependant, le lecteur permet à la classe d’implémentation d’accessibilité d’un composant d’exposer des informations MSAA pour ses parties internes. (Par exemple, une liste expose des informations MSAA sur ses éléments.)

Le nombre d’enfants (parties internes) et d’ID d’enfant utilisés pour les identifier sont déterminés par la méthode getChildIDArray(). Dans la classe de base AccessibilityImplementation du lecteur, cette méthode renvoie simplement null. La classe AccImpl Flex la remplace pour renvoyer un tableau vide. Elle fournit également une méthode utilitaire protégée createChildIDArray() que les sous-classes avec parties internes peuvent utiliser dans leurs remplacements.

Rôle

Le rôle MSAA d’un composant et de ses parties internes est déterminé par la méthode get_accRole(). Dans la classe de base AccessibilityImplementation du lecteur, cette méthode renvoie une erreur d’exécution, étant donné qu’il est attendu des sous-classes qu’elles l’ignorent. La classe AccImpl de Flex possède une propriété protégée role que les sous-classes définissent généralement dans leur constructeur et il remplace get_accRole() pour renvoyer cette propriété.

Nom

Le nom MSAA d’un composant et de ses parties internes est déterminé par la méthode get_accName(). Dans la classe de base AccessibilityImplementation du lecteur, cette méthode renvoie simplement null. La classe AccImpl de Flex le remplace pour construire un nom comme suit, en commençant par une chaîne vide et séparant les parties ajoutées par un seul espace :

Si un enfant simple (par exemple, un élément d’une liste déroulante) est demandé, seul le nom par défaut de l’enfant est renvoyé. Le reste des étapes ci-dessous s’applique uniquement au composant lui-même (childID 0).
Si le composant est imbriqué dans un formulaire :
- Si le formulaire possède un FormHeading et que le composant est à l’intérieur d’un composant FormItem, le texte d’en-tête est ajouté. Les développeurs qui souhaitent éviter cela doivent définir accessibilityName du FormHeading sur un espace (" ").
- Si le champ est obligatoire, la chaîne dépendante des paramètres régionaux « champ obligatoire » est ajoutée.
- Si le composant est imbriqué dans un FormItem, le texte du libellé du FormItem est ajouté. Les développeurs qui souhaitent éviter cela doivent définir le accessibilityName du FormItem sur un espace (" ").
Le nom du composant est alors déterminé comme suit :
- Si le accessibilityName du composant (c’est-à-dire accessibilityProperties.name) est un espace, aucun nom de composant n’est ajouté.
- Dans le cas contraire, si le nom du composant est spécifié (c’est-à-dire qu’il n’est pas null et n’est pas vide), il est ajouté.
- Dans le cas contraire, une méthode protégée getName(), définie par AccImpl et implémentée par chaque sous-classe, est appelée pour fournir un nom par défaut. (Par exemple, ButtonAccImpl implémente getName() pour spécifier que le nom par défaut d’un Button est le libellé qu’il affiche.) Si elle n’est pas vide, la valeur de retour de getName() est ajoutée.
- Dans le cas contraire (getName() renvoie une valeur vide), si la propriété toolTip du composant est définie, cette chaîne est ajoutée.
- Si la propriété errorString du composant est définie, cette chaîne est ajoutée.

Description

La description MSAA est déterminée uniquement par l’objet accessibilityProperties d’un composant et non par son objet accessibilityImplementation. Il n’y a donc pas de logique dans AccessibilityImplementation ou AccImpl ou dans les sous-classes de AccImpl relatives à la description. La procédure normale pour définir la description dans Flex est par le biais de la propriété accessibilityDescription sur UIComponent, qui définit simplement accessibilityProperties.description.

Etat

L’état MSAA d’un composant et de ses parties internes est déterminé par la méthode get_accState(). Dans la classe de base AccessibilityImplementation du lecteur, cette méthode renvoie une erreur d’exécution, étant donné qu’il est attendu des sous-classes qu’elles l’ignorent. La classe AccImpl de Flex ne l’écrase pas, mais fournit la méthode utilitaire protégée getState(), que les sous-classes peuvent utiliser dans leurs remplacements. La méthode getState() détermine l’état en tant que combinaison de :

STATE_SYSTEM_UNAVAILABLE (lorsqu’enabled est false sur ce composant ou sur l’un de ses ancêtres)
STATE_SYSTEM_FOCUSABLE
STATE_SYSTEM_FOCUSED (lorsque le composant lui-même a le focus, non défini pour toutes les sous-parties éventuelles du composant)

Notez que, par défaut, tous les composants sont considérés à priori comme étant capables de recevoir le focus. Les classes d’implémentation d’accessibilité pour les composants n’étant pas en mesure de recevoir le focus (tels que Label) doivent donc effacer cet indicateur d’état. Lorsqu’un composant possède un état « non disponible », l’état « en mesure de recevoir le focus » est supprimé par la classe d’implémentation d’accessibilité.

Valeur

La valeur MSAA d’un composant et de ses parties internes est déterminé par la méthode get_accValue(). Dans la classe de base AccessibilityImplementation du lecteur, cette méthode renvoie simplement null. La classe AccImpl de Flex ne la remplace pas, contrairement aux sous-classes de composants tels que TextInput.

Emplacement

L’emplacement MSAA des parties internes d’un composant, et non le composant lui-même, est déterminé par la méthode get_accLocation(). Cette méthode n’est jamais appelée avec un childID de 0 ; au lieu de cela, Flash Player détermine l’emplacement MSAA d’un composant en fonction de son rectangle de délimitation tel que déterminé par getBounds(). La classe AccImpl de Flex ne remplace pas cette méthode, contrairement aux sous-classes de composants ayant des parties internes.

Action par défaut

L’action par défaut DefaultAction MSAA d’un composant et de ses parties internes est déterminée par la méthode get_accDefaultAction(). Dans la classe de base AccessibilityImplementation du lecteur, cette méthode renvoie simplement null. La classe AccImpl de Flex ne la remplace pas, contrairement aux sous-classes ayant des actions par défaut. Ces sous-classes remplacent également la méthode accDoDefaultAction() d’implémentation d’accessibilité pour exécuter l’action par défaut qu’ils annoncent.

Autre

Les événements MSAA EVENT_OBJECT_SHOW et EVENT_OBJECT_HIDE sont envoyés lorsque l’objet est affiché ou masqué. Leurs états correspondants sont couverts par Flash Player qui ne rend pas les composants MSAA qui sont masqués. Lorsque le composant est affiché, les états mentionnés pour AccImpl sont utilisés.

AccImpl Constructeur.mastermx.core:UIComponentOccurrence UIComponent dont cette occurrence AccImpl assure l’accessibilité. Constructeur. eventHandler Gestionnaire d’événement générique. event Gestionnaire d’événement générique. Toutes les sous-classes AccImpl doivent l’implémenter pour écouter les événements de son composant principal. getFormName Méthode prenant en charge l’accessibilité de Form. componentmx.core:UIComponent Méthode prenant en charge l’accessibilité de Form. Elle est appelée à partir de get_accName() dans cette classe AccImpl. Egalement appelée à partir du constructeur UIComponentAccProps. getName Renvoie le nom du composant accessible. childID Renvoie le nom du composant accessible. Toutes les sous-classes doivent l’implémenter à la place de la méthode get_accName(). getState Méthode d’utilitaire déterminant l’état du composant accessible. childID Méthode d’utilitaire déterminant l’état du composant accessible. isAncestorDisabled Renvoie true si la propriété enabled d’un ancêtre du composant est définie sur false. true si le composant est doté d’un ancêtre désactivé. componentmx.core:UIComponentLe composant UIComponent dans lequel rechercher un ancêtre désactivé. Renvoie true si la propriété enabled d’un ancêtre du composant est définie sur false. Le composant donné lui-même n’est pas vérifié. master Référence à l’occurrence UIComponent dont AccImpl assure l’accessibilité. mx.core:UIComponent Référence à l’occurrence UIComponent dont AccImpl assure l’accessibilité. role Rôle d’accessibilité du composant rendu accessible. Rôle d’accessibilité du composant rendu accessible. eventsToHandle Toutes les sous-classes doivent remplacer cette fonction en renvoyant un tableau de chaînes des événements à écouter. Toutes les sous-classes doivent remplacer cette fonction en renvoyant un tableau de chaînes des événements à écouter.