Instructions relatives à l’emplacement des commandes

Les meilleures pratiques de positionnement des commandes dans l’environnement de développement intégré (IDE) visual Studio varient en fonction de la taille du jeu de commandes. Les commandes sont définies et positionnées en fonction des informations contenues dans les fichiers .vsct .

Meilleures pratiques pour tous les jeux de commandes

Pour chaque ensemble de commandes, suivez ces instructions :

  • Préparez un graphique de la structure de commandes à l’avance. Identifiez les commandes, les zones de liste déroulante, les groupes de commandes et les menus contextuels qui seront utilisés dans plusieurs emplacements.

  • Les commandes qui apparaissent dans le même groupe doivent être associées.

  • Les groupes qui contiennent une seule commande sont acceptables.

  • Les packages ne doivent pas ajouter de nombreuses commandes aux menus Visual Studio existants. Au lieu de cela, ils doivent créer des menus ou des sous-menus pour héberger les nouvelles commandes.

  • Lorsque vous placez une commande dans un menu existant, nommez la commande pour que son objectif soit clair et qu’elle ne soit pas confondue avec les commandes existantes.

Meilleures pratiques pour les petits ensembles de commandes

Si vous développez un VSPackage qui n’a que quelques commandes, suivez également ces instructions :

  • Si possible, utilisez l’élément Parent d’une commande, d’une zone de liste déroulante, d’un groupe ou d’un menu enfant pour le placer dans le groupe approprié.

  • Affectez ces groupes aux menus affichés par VSPackage.

  • Le parent d’un menu enfant ou d’une commande doit être un élément Group . Affectez des commandes et des menus enfants à des groupes, puis affectez les groupes aux menus parents.

  • Vous pouvez placer une commande dans des groupes supplémentaires en ajoutant une section d’élément CommandPlacements après la définition de la commande, puis en ajoutant à l’élément CommandPlacements un élément CommandPlacement pour chaque groupe supplémentaire.

Meilleures pratiques pour les jeux de commandes volumineux

Si votre VSPackage a de nombreuses commandes qui s’affichent dans plusieurs contextes, suivez également les instructions suivantes :

  • Créez des menus, des groupes et des commandes auto-parenting. Autrement dit, n’affectez pas d’élément Parent dans la définition de l’élément.

  • Utilisez CommandPlacement des entrées d’élément dans la CommandPlacements section d’élément pour placer des menus, des groupes et des commandes dans leurs menus et groupes parents.

  • Dans la CommandPlacements section d’élément, les entrées qui remplissent un menu ou un groupe donné doivent être adjacentes les unes aux autres. Cela facilite la lisibilité et facilite la détermination des Priority classements.