Commandes, menus et barres d’outils

Les menus et les barres d’outils sont la façon dont les utilisateurs accèdent aux commandes dans votre VSPackage. Les commandes sont des fonctions qui effectuent des tâches, telles que l’impression d’un document, l’actualisation d’un affichage ou la création d’un fichier. Les menus et les barres d’outils sont des méthodes graphiques pratiques pour présenter vos commandes aux utilisateurs. En règle générale, les commandes associées sont regroupées dans le même menu ou barre d’outils.

Les menus s’affichent généralement sous forme de chaînes à un mot en cluster dans une ligne en haut de l’environnement de développement intégré (IDE) ou d’une fenêtre d’outil. Les menus peuvent également être affichés à la suite d’un événement de clic droit et sont appelés menus contextuels dans ce contexte. Lorsque vous cliquez sur ce bouton, les menus s’étendent pour afficher une ou plusieurs commandes. Les commandes, lorsqu’elles sont cliquées, peuvent effectuer des tâches ou lancer des sous-menus qui contiennent des commandes supplémentaires. Certains noms de menus connus sont Fichier, Édition, Affichage et Fenêtre. Pour plus d’informations, consultez Étendre les menus et les commandes.
Les barres d’outils sont généralement des rangées de boutons et d’autres contrôles, tels que les zones combinées, les zones de liste, les zones de texte et les contrôleurs de menu. Tous les contrôles de barre d’outils sont associés aux commandes. Lorsque vous cliquez sur un bouton de barre d’outils, sa commande associée est activée. Les boutons de barre d’outils ont généralement des icônes qui suggèrent les commandes sous-jacentes, telles qu’une imprimante pour une commande Imprimer. Dans un contrôle de liste déroulante, chaque élément de la liste est associé à une commande différente. Un contrôleur de menu est un hybride dans lequel un côté du contrôle est un bouton de barre d’outils et l’autre côté est une flèche vers le bas qui affiche des commandes supplémentaires lorsque vous cliquez sur. Pour plus d’informations, consultez Ajouter un contrôleur de menu à une barre d’outils.
Lorsque vous créez une commande, vous devez également créer un gestionnaire d’événements pour celui-ci. Le gestionnaire d’événements détermine quand la commande est visible ou activée, vous permet de modifier son texte et garantit que la commande répond de manière appropriée (« itinéraires ») lorsqu’elle est activée. Dans la plupart des cas, l’IDE gère les commandes à l’aide de l’interface IOleCommandTarget . Les commandes dans Visual Studio routent de manière hiérarchique, en commençant par le contexte de commande le plus interne, en fonction de la sélection locale et en continuant vers le contexte le plus externe, en fonction de la sélection globale. Les commandes ajoutées au menu principal sont immédiatement disponibles pour le script. Pour plus d’informations, consultez MenuCommands vs. OleMenuCommands et objets de contexte de sélection.

Pour définir de nouveaux menus et barres d’outils, vous devez les décrire dans un fichier de table de commandes Visual Studio (.vsct). Le modèle de package Visual Studio crée ce fichier pour vous, ainsi que les éléments nécessaires pour prendre en charge les commandes, barres d’outils et éditeurs que vous avez sélectionnés dans le modèle. Vous pouvez également écrire votre propre fichier .vsct à l’aide du schéma XML décrit ici : référence de schéma XML VSCT.

Pour plus d’informations sur l’utilisation des fichiers .vsct, consultez les fichiers de la table de commandes Visual Studio (.vsct).

Les rubriques de cette section expliquent comment fonctionnent les commandes, les menus et les barres d’outils dans VSPackages.