Instructions de sélection élective 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éfinis et positionnées en fonction des informations dans les fichiers .vsct.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 jeu de commandes, suivez ces instructions :For every set of commands, follow these guidelines:

  • Préparer un plan de la structure de la commande à l’avance.Prepare a chart of the command structure in advance. Identifier les commandes, zones de liste déroulante, 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.

  • Les 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 la commande de petits jeuxBest Practices for Small Command Sets

Si vous développez un VSPackage qui dispose 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 élément Parent 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 élément Group.The parent of a child menu or a command must be a Group Element. Affecter des commandes et les menus enfants à des groupes, puis affecter les groupes de menus du parent.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 élément section après la définition de la commande d’ajout à la CommandPlacements Element 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 utilise 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’attribuez pas une Parent Element dans la définition de l’élément.That is, do not assign a Parent Element in the definition of the item.

  • Utilisez CommandPlacement Element entrées dans la CommandPlacements Element section à 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, les entrées qui remplissent un menu ou groupe doit être adjacent à un autre.In the CommandPlacements 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 les VSPackages ajouter les éléments d’Interface utilisateur How VSPackages Add User Interface Elements
Fichiers Visual Studio Command Table (.Vsct)Visual Studio Command Table (.Vsct) Files