Commandes, menus et barres d’outilsCommands, menus, and toolbars

Menus et barres d’outils sont que les manière dont les utilisateurs accéder aux commandes dans votre VSPackage.Menus and toolbars are the way users access commands in your VSPackage. Les commandes sont des fonctions qui accomplissent des tâches, comme l’impression d’un document, l’actualisation d’une vue ou la création d’un fichier.Commands are functions that accomplish tasks, such as printing a document, refreshing a view, or creating a new file. Les menus et barres d’outils s’avèrent pratiques pour présenter graphiquement vos commandes aux utilisateurs.Menus and toolbars are convenient graphical ways to present your commands to users. En règle générale, les commandes associées sont regroupées dans le même menu ou la même barre d’outils.Typically, related commands are clustered together on the same menu or toolbar.

  • Les menus apparaissent généralement sous la forme de chaînes contenant un seul mot rassemblées sur une ligne en haut de l’environnement de développement intégré (IDE) ou d’une fenêtre Outil.Menus typically are displayed as one-word strings clustered in a row at the top of the integrated development environment (IDE) or a tool window. Ils peuvent également apparaître après un clic droit et sont alors appelés menus contextuels.Menus also can be displayed as the result of a right-click event, and are referred to as shortcut menus in that context. Quand vous cliquez dessus, les menus se développent pour présenter une ou plusieurs commandes.When clicked, menus expand to display one or more commands. Les commandes, quand vous cliquez dessus, permettent d’effectuer des tâches ou de lancer des sous-menus qui contiennent d’autres commandes.Commands, when clicked, can carry out tasks or launch submenus that contain additional commands. Certains noms de menu connu fichier, modifier, vue, et fenêtre.Some well-known menu names are File, Edit, View, and Window. Pour plus d’informations, consultez étendre des menus et commandes.For more information, see Extend menus and commands.

  • Les barres d’outils sont généralement des rangées de boutons et autres contrôles, comme des zones de liste modifiable, des zones de liste, des zones de texte et des contrôleurs de menu.Toolbars typically are rows of buttons and other controls, such as combo boxes, list boxes, text boxes, and menu controllers. Tous les contrôles de barre d’outils sont associés à des commandes.All toolbar controls are associated with commands. Quand vous cliquez sur un bouton de barre d’outils, sa commande associée est activée.When you click a toolbar button, its associated command is activated. Les boutons de barre d’outils comportent généralement des icônes qui suggèrent les commandes sous-jacentes, comme une imprimante pour une commande Imprimer.Toolbar buttons usually have icons that suggest the underlying commands, such as a printer for a Print command. Dans un contrôle de liste déroulante, chaque élément de la liste est associé à une commande différente.In a drop-down list control, each item in the list is associated with a different command. 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 présente des commandes supplémentaires quand vous cliquez dessus.A menu controller is a hybrid in which one side of the control is a toolbar button and the other side is a down arrow that displays additional commands when clicked. Pour plus d’informations, consultez ajouter un contrôleur de menu à une barre d’outils.For more information, see Add a menu controller to a toolbar.

  • Quand vous créez une commande, vous devez également lui créer un gestionnaire d’événements.When you create a command, you also must create an event handler for it. 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 correctement (« itinéraires ») lors de son activation.The event handler determines when the command is visible or enabled, allows you to modify its text, and ensures that the command responds appropriately ("routes") when activated. Dans la plupart des cas, l’IDE gère les commandes à l’aide de l’interface IOleCommandTarget.In most instances, the IDE handles commands using the IOleCommandTarget interface. Les commandes de Visual StudioVisual Studio défilent de façon hiérarchique, en commençant par le contexte de commande le plus central, selon la sélection locale, puis en continuant avec le contexte le plus périphérique, selon la sélection globale.Commands in Visual StudioVisual Studio route in a hierarchical manner, starting with the innermost command context, based on the local selection, and proceeding to the outermost context, based on the global selection. Les commandes ajoutées au menu principal sont immédiatement disponibles pour les scripts.Commands added to the main menu are immediately available for scripting. Pour plus d’informations, consultez MenuCommands et. OleMenuCommands et les objets de contexte de sélection.For more information, see MenuCommands vs. OleMenuCommands and Selection context objects.

    Pour définir de nouveaux menus et barres d’outils, vous devez les décrire dans une table de commandes de Visual Studio (.vsct) fichier.To define new menus and toolbars, you must describe them in a Visual Studio command table (.vsct) file. 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, les barres d’outils et les éditeurs que vous avez sélectionné dans le modèle.The Visual Studio package template creates this file for you, along with the necessary elements to support whatever commands, toolbars, and editors you selected in the template. Vous pouvez également écrire votre propre .vsct de fichiers, en utilisant le schéma XML décrit ici : référence du schéma XML VSCT.Alternatively, you can write your own .vsct file, using the XML schema described here: VSCT XML schema reference.

    Pour plus d’informations sur l’utilisation de .vsct de fichiers, consultez fichiers Visual Studio command table (.vsct).For more information about working with .vsct files, see Visual Studio command table (.vsct) files.

    Les rubriques de cette section expliquent le fonctionnement des commandes, menus et barres d’outils dans les VSPackages.The topics in this section explain how commands, menus, and toolbars work in VSPackages.

Dans cette sectionIn this section

Comment VSPackages ajoute des éléments d’interface utilisateurHow VSPackages add user interface elements
Une description détaillée de la spécification de format de table de commande.An in-depth description of the command table format specification.

Visual Studio fichiers command table (.vsct)Visual Studio command table (.vsct) files
Décrit une syntaxe basée sur XML et le compilateur pour les tables de la commande.Describes an XML-based syntax and compiler for command tables.

Placement de commande, le groupe et barre d’outils par défautDefault command, group, and toolbar placement
Décrit les barres d’outils, des groupes, des menus et des commandes prédéfinies.Describes predefined commands, groups, menus, and toolbars.

Groupes, les menus et commandes définies par l’IDEIDE-defined commands, menus, and groups
Spécifie les menus prédéfinis, les commandes et les groupes de commandes disponibles pour une utilisation par le Visual StudioVisual Studio IDE.Specifies the predefined menus, commands, and command groups available for use by the Visual StudioVisual Studio IDE.

Conception de la commandeCommand design
Explique comment concevoir des commandes.Explains how to design commands.

Optimiser les commandes de menu et barre d’outilsOptimize menu and toolbar commands
Donne des indications pour les commandes.Gives guidelines for commands.

Rendre les commandes disponiblesMake commands available
Explique comment rendre les commandes disponibles pour Visual Studio.Explains how to make commands available to Visual Studio.

Commandes et des menus qui utilisent des assemblys d’interopérabilitéCommands and menus that use interop assemblies
Explique comment implémenter des commandes qui utilisent des assemblys d’interopérabilité.Explains how to implement commands that use interop assemblies.

Routage des commandes dans VSPackagesCommand routing in VSPackages
Explique le routage des commandes dans VSPackages.Explains command routing in VSPackages.