Instructions de positionnement de commandeCommand placement guidelines

Meilleures pratiques pour le positionnement des commandes dans l’environnement de développement intégré (IDE) Visual Studio varient selon la taille du jeu de commandes.Best practices for positioning commands in the Visual Studio integrated development environment (IDE) vary depending on the size of the command set. Commandes sont définies et positionnés selon les informations contenues dans .vsct fichiers.Commands are defined and positioned according to the information in .vsct files.

Meilleures pratiques pour tous les jeux de commandesBest practices for all command sets

Pour chaque ensemble de commandes, suivez ces instructions :For every set of commands, follow these guidelines:

  • Préparer un graphique de la structure de commande à l’avance.Prepare a chart of the command structure in advance. Identifier les commandes, les zones de liste déroulante, les groupes de commandes et les menus contextuels qui seront utilisés dans plusieurs emplacements.Identify the commands, combo boxes, command groups, and shortcut menus that will be used in more than one location.

  • Commandes qui s’affichent dans le même groupe doivent être liés.Commands that appear in the same group should be related.

  • Les groupes qui contiennent une simple commande sont acceptables.Groups that contain just one command are acceptable.

  • Les packages ne devraient pas ajouter un grand nombre de commandes à des menus de Visual Studio existants.Packages should not add lots of commands to existing Visual Studio menus. Au lieu de cela, ils doivent créer des menus ou sous-menus pour héberger les nouvelles commandes.Instead, they should create menus or submenus to host the new commands.

  • Lorsque vous placez une commande sur un menu existant, le nom de la commande afin que son objectif est clair, et il ne sera pas confondre avec les commandes existantes.When you put a command on an existing menu, name the command so that its purpose is clear and it will not be confused with existing commands.

Meilleures pratiques pour les jeux de commandes petitBest practices for small command sets

Si vous développez un VSPackage doté de quelques commandes, également suivre ces instructions :If you are developing a VSPackage that has just a few commands, also follow these guidelines:

  • Si possible, utilisez le Parent élément d’une commande, zone de liste déroulante, groupe ou menu enfant à placer dans le groupe approprié.When possible, use the Parent element of a command, combo box, group, or child menu to put it in the appropriate group.

  • Ces groupes affectés aux menus affichés par le VSPackage.Assign these groups to menus displayed by the VSPackage.

  • Le parent d’un menu enfant ou d’une commande doit être un groupe élément.The parent of a child menu or a command must be a Group element. Affecter des commandes et les menus enfants aux groupes et ensuite affecter les groupes aux menus parents.Assign commands and child menus to groups, and then assign the groups to parent menus.

  • Vous pouvez placer une commande dans des groupes supplémentaires en ajoutant un CommandPlacements section de l’élément après la définition de la commande et en ajoutant à la CommandPlacements élément un CommandPlacement élément pour chaque groupe supplémentaire.You can put a command in additional groups by adding a CommandPlacements element section after the definition of the command, and then adding to the CommandPlacements element a CommandPlacement element for each additional group.

Meilleures pratiques pour les jeux de commandes volumineuxBest practices for large command sets

Si votre VSPackage doit avoir de nombreuses commandes qui seront affiche dans plusieurs contextes, également suivre ces instructions :If your VSPackage will have many commands that will appear in multiple contexts, also follow these guidelines:

  • Vérifiez les menus, les groupes et les commandes apparenter automatique.Make menus, groups, and commands self-parenting. Autrement dit, n’affectez pas un Parent élément dans la définition de l’élément.That is, do not assign a Parent element in the definition of the item.

  • Utilisez CommandPlacement entrées d’élément dans la CommandPlacements section de l’élément à placer des menus, les groupes et les commandes dans leurs menus parents et les groupes.Use CommandPlacement element entries in the CommandPlacements element section to put menus, groups, and commands in their parent menus and groups.

  • Dans la CommandPlacements section de l’élément, les entrées qui remplissent un menu donné ou un groupe doivent être adjacentes à l’autre.In the CommandPlacements element section, the entries that populate a given menu or group should be adjacent to one another. Cela facilite la lisibilité et rend le Priority classements déterminer plus faciles.This aids readability and makes the Priority rankings easier to determine.

Voir aussiSee also

Comment VSPackages ajoute des éléments d’interface utilisateur How VSPackages add user interface elements
Visual Studio fichiers command table (.vsct)Visual Studio command table (.vsct) files