Partager via


Écoute des événements du ruban

L’infrastructure du ruban Windows utilise l’infrastructure De suivi d’événements pour Windows (ETW) pour permettre aux développeurs d’apprendre comment les utilisateurs interagissent avec le ruban de leur application.

Introduction

Le mécanisme d’événement de l’infrastructure du ruban est conçu de telle sorte que l’infrastructure signale les événements de l’interface utilisateur du ruban à l’application afin que vous puissiez surveiller l’activité des utilisateurs, découvrir leurs modèles d’interaction et évaluer les tendances d’utilisation. Ces informations peuvent être utilisées pour affiner l’expérience utilisateur pour les itérations futures de votre application de ruban.

L’utilisation des événements de l’infrastructure du ruban implique les éléments suivants :

  1. L’application de ruban doit inscrire un écouteur de suivi d’événements pour Windows (ETW) pour recevoir des notifications d’événements de ruban à partir de l’infrastructure du ruban.
  2. L’infrastructure du ruban déclenche les rappels d’événements d’interface utilisateur du ruban au moment de l’exécution, si l’application a inscrit un écouteur de suivi d’événements pour Windows (ETW ).

Événements pris en charge

Les événements exposés aux applications de ruban sont décrits dans le tableau suivant.

Événement Rapport d’événements
Onglet activé ID de commande
Nom de commande
Verbe d’événement
Onglet contextuel activé ID de commande
Nom de commande
Verbe d’événement
Menu de l’application ouvert Verbe d’événement
Menu de l’application fermé Verbe d’événement
Menu (normal ou galerie) ouvert ID de commande
Nom de commande
Verbe d’événement
Note: Les événements de menu QAT ne sont pas exposés.
Menu (normal ou galerie) fermé ID de commande
Nom de commande
Verbe d’événement
Note: Les événements de menu QAT ne sont pas exposés.
Commande ID de commande
Nom de commande
Verbe d’événement
L’un des emplacements d’événements suivants :
-RUBAN
-QUICKACCESSTOOLBAR
- APPLICATIONMENU
- CONTEXTPOPUP
ID de commande parent
Nom de la commande parente
L’une des méthodes invoke suivantes :
-CLIQUEZ SUR
- INFO-BULLE
-CLAVIER
-TOUCHER
Note: Les galeries d’éléments et les zones de liste déroulante incluent l’index de l’élément sélectionné, mais n’incluent pas les valeurs de chaîne et d’entier. Les spinners n’incluent pas la valeur entière.
Ruban réduit Verbe d’événement
Ruban développé (bouton développer avec un clic ou appuyez sur épinglé) Verbe d’événement
Mode d’application basculé Verbe d’événement
ID de mode (valeur définie via SetModes)
Note: L’application est chargée de décompresser cet entier pour déterminer les modes définis.
Info-bulle affichée Verbe d’événement
ID de commande parent
Nom de la commande parente

Guides du développeur de l’infrastructure du ruban Windows

Déclaration de commandes et de contrôles avec le balisage du ruban

Instructions relatives à l’expérience utilisateur du ruban

Processus de conception du ruban