Constantes d’événement (Winuser.h)
Cette rubrique décrit les événements générés par le système d’exploitation et par les applications serveur. Les constantes sont répertoriées par ordre alphabétique.
Avant d’utiliser ces événements, les applications clientes doivent utiliser Accessible Event Watcher pour vérifier que ces événements sont utilisés par les éléments d’interface utilisateur.
Pour plus d’informations sur les événements en général, consultez Qu’est-ce que WinEvents ? et Événements au niveau du système et au niveau de l’objet. Pour plus d’informations sur les événements envoyés par le système, consultez Annexe A : Référence des éléments d’interface utilisateur pris en charge.
| Constante/valeur | Description |
|---|---|
|
Plage de valeurs de constante WinEvent spécifiées par l’Alliance d’interopérabilité d’accessibilité (AIA) pour une utilisation dans l’ensemble du secteur. Pour plus d’informations, consultez Allocation d’ID WinEvent. |
|
Valeurs d’événement les plus faibles et les plus élevées possibles. |
|
La propriété KeyboardShortcut d’un objet a changé. Les applications serveur envoient cet événement pour leurs objets accessibles. |
|
Envoyé lorsqu’une fenêtre est masquée. Une fenêtre masquée existe toujours, mais elle est invisible pour l’utilisateur. |
|
Le défilement d’un objet de fenêtre est terminé. Contrairement à EVENT_SYSTEM_SCROLLEND, cet événement est associé à la fenêtre de défilement. Que le défilement soit horizontal ou vertical, cet événement doit être envoyé chaque fois que l’action de défilement est terminée. Le paramètre hwnd de la fonction de rappel WinEventProc décrit la fenêtre de défilement ; le paramètre idObject est OBJID_CLIENT et le paramètre idChildest CHILDID_SELF. |
|
Un objet a été créé. Le système envoie cet événement pour les éléments d’interface utilisateur suivants : caret, contrôle d’en-tête, contrôle d’affichage de liste, contrôle tabulation, contrôle de barre d’outils, contrôle d’arborescence et objet window . Les applications serveur envoient cet événement pour leurs objets accessibles. Avant d’envoyer l’événement pour l’objet parent, les serveurs doivent l’envoyer pour tous les objets enfants d’un objet. Les serveurs doivent s’assurer que tous les objets enfants sont entièrement créés et prêts à accepter les appels IAccessible des clients avant que l’objet parent envoie cet événement. Étant donné qu’un objet parent est créé après ses objets enfants, les clients doivent s’assurer que le parent d’un objet a été créé avant d’appeler IAccessible::get_accParent, en particulier si des fonctions de crochet en contexte sont utilisées. |
|
La propriété DefaultAction d’un objet a changé. Le système envoie cet événement pour des boîtes de dialogue. Les applications serveur envoient cet événement pour leurs objets accessibles. |
|
La propriété Description d’un objet a changé. Les applications serveur envoient cet événement pour leurs objets accessibles. |
|
Un objet a été détruit. Le système envoie cet événement pour les éléments d’interface utilisateur suivants : caret, contrôle d’en-tête, contrôle d’affichage de liste, contrôle tabulation, contrôle de barre d’outils, contrôle d’arborescence et objet window. Les applications serveur envoient cet événement pour leurs objets accessibles. Les clients supposent que tous les enfants d’un objet sont détruits lorsque l’objet parent envoie cet événement. Après avoir reçu cet événement, les clients n’appellent pas les propriétés ou méthodes IAccessible d’un objet. Toutefois, le pointeur d’interface doit rester valide tant qu’il y a un nombre de références sur celui-ci (en raison de règles COM), mais l’élément d’interface utilisateur peut ne plus être présent. D’autres appels sur le pointeur d’interface peuvent renvoyer des erreurs d’échec ; pour éviter cela, les serveurs créent des objets proxy et surveillent leur durée de vie. |
|
L’utilisateur a commencé à faire glisser un élément. Les paramètres hwnd, idObject et idChild de la fonction de rappel WinEventProc identifient l’objet déplacé. |
|
L’utilisateur a mis fin à une opération de glisser avant de supprimer l’élément déplacé sur une cible de déplacement. Les paramètres hwnd, idObject et idChild de la fonction de rappel WinEventProc identifient l’objet déplacé. |
|
L’utilisateur a supprimé un élément sur une cible de suppression. Les paramètres hwnd, idObject et idChild de la fonction de rappel WinEventProc identifient l’objet déplacé. |
|
L’utilisateur a fait glisser un élément dans la limite d’une cible de suppression. Les paramètres hwnd, idObject et idChild de la fonction de rappel WinEventProc identifient la cible de suppression. |
|
L’utilisateur a fait glisser un élément hors de la limite d’une cible de suppression. Les paramètres hwnd, idObject et idChild de la fonction de rappel WinEventProc identifient la cible de suppression. |
|
L’utilisateur a supprimé un élément sur une cible de suppression. Les paramètres hwnd, idObject et idChild de la fonction de rappel WinEventProc identifient la cible de suppression. |
|
Valeur d’événement d’objet la plus élevée. |
|
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 de liste, barre de menus, menu contextuel, fenêtre switch, contrôle tabulation, contrôle arborescence et objet fenêtre. Les applications serveur envoient cet événement pour leurs objets accessibles. Le paramètre hwnd de la fonction de rappel WinEventProc identifie la fenêtre qui reçoit le focus du clavier. |
|
La propriété Help d’un objet a changé. Les applications serveur envoient cet événement pour leurs objets accessibles. |
|
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 envoient cet événement pour leurs objets accessibles. Lorsque cet événement est généré pour un objet parent, tous les objets enfants sont déjà masqués. Les applications serveur n’envoient pas cet événement pour les objets enfants. Les objets masqués incluent l’indicateur STATE_SYSTEM_INVISIBLE ; les objets affichés n’incluent pas cet indicateur. L’événement EVENT_OBJECT_HIDE indique également que l’indicateur STATE_SYSTEM_INVISIBLE est défini. Par conséquent, les serveurs n’envoient pas l’événement EVENT_OBJECT_STATECHANGE dans ce cas. |
|
Une fenêtre qui héberge d’autres objets accessibles a modifié les objets hébergés. Un client peut avoir besoin d’interroger la fenêtre hôte pour découvrir les nouveaux objets hébergés, en particulier si le client surveille les événements à partir de la fenêtre. Un objet hébergé est un objet provenant d’une infrastructure d’accessibilité (MSAA ou UI Automation) qui est différent de celui de l’hôte. Les modifications apportées aux objets hébergés provenant de la même infrastructure que l’hôte doivent être transmises avec les événements de changement structurel, tels que EVENT_OBJECT_CREATE pour MSAA. Pour plus d’informations, consultez commentaires dans winuser.h. |
|
Une fenêtre IME est masquée. |
|
Une fenêtre IME est devenue visible. |
|
La taille ou la position d’une fenêtre IME a changé. |
|
Un objet a été appelé ; par exemple, l’utilisateur a cliqué sur un bouton. Cet événement est pris en charge par les contrôles courants et est utilisé par UI Automation. Pour cet événement, les paramètres hwnd, ID et idChild de la fonction de rappel WinEventProc identifient l’élément appelé. |
|
Un objet qui fait partie d’une région dynamique a changé. Une région dynamique est une zone d’une application qui change fréquemment et/ou de manière asynchrone. |
|
Un objet a changé d'emplacement, de forme ou de taille. Le système envoie cet événement pour les éléments d’interface utilisateur suivants : objets caret et window. Les applications serveur envoient cet événement pour leurs objets accessibles. Cet événement est généré en réponse à une modification de l’objet de niveau supérieur dans la hiérarchie des objets ; il n’est pas généré pour les enfants que l’objet peut avoir. 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, la barre de défilement ou d’autres objets qui ont également changé. Le système n'envoie pas cet événement pour chaque fenêtre enfant non flottante quand le parent est déplacé. Toutefois, si une application redimensionne explicitement les fenêtres enfants à la suite du redimensionnement de la fenêtre parente, 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, le serveur envoie EVENT_OBJECT_LOCATIONCHANGE chaque fois que l’objet change d’emplacement. Si un objet n’a pas cet état, les serveurs déclenchent uniquement cet événement lorsque l’objet se déplace par rapport à son parent. Pour cette notification d’événement, le paramètre idChild de la fonction de rappel WinEventProc identifie l’objet enfant qui a changé. |
|
La propriété Name d’un objet a changé. Le système envoie cet événement pour les éléments d’interface utilisateur suivants : case activée zone, curseur, contrôle d’affichage de liste, bouton pousseur, case d’option, contrôle de barre d’status, contrôle d’arborescence et objet window. Les applications serveur envoient cet événement pour leurs objets accessibles. |
|
Un objet a un nouvel objet parent. Les applications serveur envoient cet événement pour leurs objets accessibles. |
|
Un objet conteneur a ajouté, supprimé ou modifié l'ordre de 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 d’affichage de liste, contrôle de barre d’outils et objet window. Les applications serveur envoient cet événement suivant les besoins pour leurs objets accessibles. Par exemple, cet événement est généré par un objet list-view lorsque le nombre d’éléments enfants ou l’ordre des éléments change. Cet événement est également envoyé par une fenêtre parente lorsque l’ordre Z des fenêtres enfants change. |
|
La sélection dans un objet conteneur a changé. Le système envoie cet événement pour les éléments d’interface utilisateur suivants : contrôle list-view, tabulation, contrôle arborescence et objet window. Les applications serveur envoient cet événement pour leurs objets accessibles. Cet événement signale une sélection unique : soit un enfant est sélectionné dans un conteneur qui ne contenait pas d’enfants sélectionnés, soit la sélection a changé d’un enfant à l’autre. Les paramètres hwnd et idObject de la fonction de rappel WinEventProc décrivent le conteneur ; le paramètre idChild identifie l’objet sélectionné. Si l’enfant sélectionné est une fenêtre qui contient également des objets, le paramètre idChild est OBJID_WINDOW. |
|
Un enfant dans un objet conteneur a été ajouté à une sélection existante. Le système envoie cet événement pour les éléments d’interface utilisateur suivants : zone de liste, contrôle d’affichage de liste et contrôle d’arborescence. Les applications serveur envoient cet événement pour leurs objets accessibles. Les paramètres hwnd et idObject de la fonction de rappel WinEventProc décrivent le conteneur. Le paramètre idChild est l’enfant ajouté à la sélection. |
|
Un élément dans un objet conteneur a été supprimé de 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 de liste et contrôle d’arborescence. Les applications serveur envoient cet événement pour leurs objets accessibles. Cet événement signale qu’un enfant est supprimé d’une sélection existante. Les paramètres hwnd et idObject de la fonction de rappel WinEventProc décrivent le conteneur ; le paramètre idChild identifie l’enfant qui a été supprimé de la sélection. |
|
Plusieurs modifications de sélection se sont produites dans un objet conteneur. Le système envoie cet événement pour les zones de liste ; les applications serveur l’envoient pour leurs objets accessibles. Cet événement est envoyé lorsque les éléments sélectionnés au sein d’un contrôle ont sensiblement changé. L’événement informe le client que de nombreuses modifications de sélection se sont produites et qu’il est envoyé au lieu de plusieurs événements EVENT_OBJECT_SELECTIONADD ou EVENT_OBJECT_SELECTIONREMOVE . Le client interroge les éléments sélectionnés en appelant la méthode IAccessible::get_accSelection de l’objet conteneur et en énumérant les éléments sélectionnés. Pour cette notification d’événement, les paramètres hwnd et idObject de la fonction de rappel WinEventProc décrivent le conteneur dans lequel les modifications se sont produites. |
|
Un objet masqué est affiché. Le système envoie cet événement pour les éléments d'interface utilisateur suivants : signe insertion, curseur et objet window. Les applications serveur envoient cet événement pour leurs objets accessibles. Les clients supposent que lorsque cet événement est envoyé par un objet parent, tous les objets enfants sont déjà affichés. Par conséquent, les applications serveur n’envoient pas cet événement pour les objets enfants. Les objets masqués incluent l’indicateur STATE_SYSTEM_INVISIBLE ; les objets affichés n’incluent pas cet indicateur. L’événement EVENT_OBJECT_SHOW indique également que l’indicateur STATE_SYSTEM_INVISIBLE est effacé. Par conséquent, les serveurs n’envoient pas l’événement EVENT_OBJECT_STATECHANGE dans ce cas. |
|
L'état d'un objet a changé. Le système envoie cet événement pour les éléments d’interface utilisateur suivants : case activée zone, zone de liste déroulante, contrôle d’en-tête, bouton pousseur, case d’option, barre de défilement, contrôle de barre d’outils, contrôle d’arborescence, contrôle haut vers le bas et objet de fenêtre. Les applications serveur envoient cet événement pour leurs objets accessibles. Par exemple, un changement d’état se produit lorsqu’un objet bouton est cliqué ou libéré, ou lorsqu’un objet est activé ou désactivé. Pour cette notification d’événement, le paramètre idChild de la fonction de rappel WinEventProc identifie l’objet enfant dont l’état a changé. |
|
La cible de conversion au sein d’une composition IME a changé. La cible de conversion est le sous-ensemble de la composition IME qui est activement sélectionnée comme cible pour les conversions initiées par l’utilisateur. |
|
La sélection de texte d’un objet a changé. Cet événement est pris en charge par les contrôles courants et est utilisé par UI Automation. Les paramètres hwnd, ID et idChild de la fonction de rappel WinEventProc décrivent l’élément contenu dans la sélection de texte mise à jour. |
|
Envoyé lorsqu’une fenêtre est déshabillée. Une fenêtre masquée existe toujours, mais elle est invisible pour l’utilisateur. |
|
La propriété Value d’un objet a changé. Le système envoie cet événement pour les éléments d’interface utilisateur qui incluent la barre de défilement et les contrôles suivants : modification, en-tête, touche d’accès rapide, barre de progression, curseur et haut vers le bas. Les applications serveur envoient cet événement pour leurs objets accessibles. |
|
Plage de valeurs de constante d’événement réservées aux oem. Pour plus d’informations, consultez Allocation d’ID WinEvent. |
|
Une alerte a été générée. Les applications serveur ne doivent pas envoyer cet événement. |
|
Un rectangle d’aperçu s’affiche. |
|
Une fenêtre a perdu la capture de la souris. Cet événement est envoyé par le système, jamais par les serveurs. |
|
Une fenêtre a reçu la capture de la souris. Cet événement est envoyé par le système, jamais par les serveurs. |
|
Une fenêtre a quitté le mode d’aide contextuelle. Cet événement n’est pas envoyé de manière cohérente par le système. |
|
Une fenêtre est entrée en mode d’aide contextuel. Cet événement n’est pas envoyé de manière cohérente par le système. |
|
Le bureau actif a été basculé. |
|
Une boîte de dialogue a été fermée. Le système envoie cet événement pour les boîtes de dialogue standard ; les serveurs l’envoient pour les boîtes de dialogue personnalisées. Cet événement n’est pas envoyé de manière cohérente par le système. |
|
Une boîte de dialogue s’est affichée. Le système envoie cet événement pour les boîtes de dialogue standard, qui sont créées à l’aide de modèles de ressources ou de fonctions de boîte de dialogue Win32. Les serveurs envoient cet événement pour les boîtes de dialogue personnalisées, qui sont des fenêtres qui fonctionnent comme des boîtes de dialogue, mais qui ne sont pas créées de manière standard. Cet événement n’est pas envoyé de manière cohérente par le système. |
|
Une application va quitter le mode glisser-déplacer. Les applications qui prennent en charge les opérations de glisser-déplacer doivent envoyer cet événement ; le système n’envoie pas cet événement. |
|
Une application va passer en mode glisser-déplacer. Les applications qui prennent en charge les opérations de glisser-déplacer doivent envoyer cet événement, car le système ne l’envoie pas. |
|
Valeur d’événement système la plus élevée. |
|
La fenêtre de premier plan a changé. Le système envoie cet événement même si la fenêtre de premier plan a été remplacée par une autre fenêtre dans le même thread. Les applications serveur n'envoient jamais cet événement. Pour cet événement, le paramètre hwnd de la fonction de rappel WinEventProc est le handle de la fenêtre qui se trouve au premier plan, le paramètre idObject est OBJID_WINDOW et le paramètre idChildest CHILDID_SELF. |
|
Un menu contextuel a été fermé. Le système envoie cet événement pour les menus standard ; les serveurs l’envoient pour les menus personnalisés. Lorsqu’un menu contextuel est fermé, le client reçoit ce message, puis l’événement EVENT_SYSTEM_MENUEND . Cet événement n’est pas envoyé de manière cohérente par le système. |
|
Un menu contextuel s’affiche. Le système envoie cet événement pour les menus standard, identifiés par HMENU, et créés à l’aide de ressources de modèle de menu ou de fonctions de menu Win32. Les serveurs envoient cet événement pour les menus personnalisés, qui sont des éléments d’interface utilisateur qui fonctionnent comme des menus, mais qui ne sont pas créés de manière standard. Cet événement n’est pas envoyé de manière cohérente par le système. |
|
Un menu de la barre de menus a été fermé. Le système envoie cet événement pour les menus standard ; les serveurs l’envoient pour les menus personnalisés. Pour cet événement, les paramètres hwnd, idObject et idChild de la fonction de rappel WinEventProc font référence au contrôle qui contient la barre de menus ou au contrôle qui active le menu contextuel. Le paramètre hwnd est le handle de la fenêtre liée à l’événement. Le paramètre idObject est OBJID_MENU ou OBJID_SYSMENU pour un menu, ou OBJID_WINDOW pour un menu contextuel. Le paramètre idChild est CHILDID_SELF. |
|
Un élément de menu dans la barre de menus a été sélectionné. Le système envoie cet événement pour les menus standard, qui sont identifiés par HMENU, créés à l’aide de ressources de modèle de menu ou d’éléments d’API de menu Win32. Les serveurs envoient cet événement pour les menus personnalisés, qui sont des éléments d’interface utilisateur qui fonctionnent comme des menus, mais qui ne sont pas créés de manière standard. Pour cet événement, les paramètres hwnd, idObject et idChild de la fonction de rappel WinEventProc font référence au contrôle qui contient la barre de menus ou au contrôle qui active le menu contextuel. Le paramètre hwnd est le handle de la fenêtre liée à l’événement. Le paramètre idObject est OBJID_MENU ou OBJID_SYSMENU pour un menu, ou OBJID_WINDOW pour un menu contextuel. Le paramètre idChild est CHILDID_SELF. Le système déclenche plusieurs événements EVENT_SYSTEM_MENUSTART qui ne correspondent pas toujours à l’événement EVENT_SYSTEM_MENUEND . |
|
Un objet window est sur le point d’être restauré. Cet événement est envoyé par le système, jamais par les serveurs. |
|
Un objet window est sur le point d’être réduit. Cet événement est envoyé par le système, jamais par les serveurs. |
|
Le déplacement ou le redimensionnement d’une fenêtre est terminé. Cet événement est envoyé par le système, jamais par les serveurs. |
|
Une fenêtre est déplacée ou redimensionnée. Cet événement est envoyé par le système, jamais par les serveurs. |
|
Le défilement est terminé sur une barre de défilement. Cet événement est envoyé par le système pour les contrôles de barre de défilement standard et pour les barres de défilement attachées à une fenêtre. Les serveurs envoient cet événement pour les barres de défilement personnalisées, qui sont des éléments d’interface utilisateur qui fonctionnent comme des barres de défilement, mais qui ne sont pas créées de manière standard. Le paramètre idObject envoyé à la fonction de rappel WinEventProc est OBJID_HSCROLL pour les barres de défilement horizontales et OBJID_VSCROLL pour les barres de défilement verticales. |
|
Le défilement a commencé sur une barre de défilement. Le système envoie cet événement pour les contrôles de barre de défilement standard et pour les barres de défilement attachées à une fenêtre. Les serveurs envoient cet événement pour les barres de défilement personnalisées, qui sont des éléments d’interface utilisateur qui fonctionnent comme des barres de défilement, mais qui ne sont pas créées de manière standard. Le paramètre idObject envoyé à la fonction de rappel WinEventProc est OBJID_HSCROLL pour les barres de défilement horizontal et OBJID_VSCROLL pour les barres de défilement verticales. |
|
Un son a été joué. Le système envoie cet événement lorsqu’un son système, tel qu’un pour un menu, est lu même si aucun son n’est audible (par exemple, en raison de l’absence d’un fichier sonore ou d’un son carte). Les serveurs envoient cet événement chaque fois qu’un élément d’interface utilisateur personnalisé génère un son. Pour cet événement, la fonction de rappel WinEventProc reçoit la valeur OBJID_SOUND en tant que paramètre idObject . |
|
L’utilisateur a publié ALT+TAB. Cet événement est envoyé par le système, jamais par les serveurs. Le paramètre hwnd de la fonction de rappel WinEventProc identifie la fenêtre vers laquelle l’utilisateur a basculé. Si une seule 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. |
|
L’utilisateur a appuyé sur ALT+TAB, ce qui active la fenêtre de commutateur. Cet événement est envoyé par le système, jamais par les serveurs. Le paramètre hwnd de la fonction de rappel WinEventProc identifie la fenêtre vers laquelle l’utilisateur bascule. Si une seule 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. |
|
Plage de valeurs de constante d’événement réservées aux identificateurs d’événement UI Automation. Pour plus d’informations, consultez Allocation d’ID WinEvent. |
|
Plage de valeurs de constante d’événement réservées aux identificateurs d’événement modifiés par la propriété UI Automation. Pour plus d’informations, consultez Allocation d’ID WinEvent. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour