命令放置指南

在 Visual Studio 集成开发环境(IDE)中定位命令的最佳做法因命令集的大小而异。 根据 .vsct 文件中的信息定义和定位命令。

所有命令集的最佳做法

对于每组命令,请遵循以下准则:

  • 提前准备命令结构的图表。 标识将在多个位置中使用的命令、组合框、命令组和快捷菜单。

  • 出现在同一组中的命令应该相关。

  • 仅包含一个命令的组是可以接受的。

  • 包不应向现有 Visual Studio 菜单添加大量命令。 相反,它们应创建菜单或子菜单来托管新命令。

  • 在现有菜单上放置命令时,请命名该命令,使其用途清晰,并且不会与现有命令混淆。

小型命令集的最佳做法

如果要开发仅包含几个命令的 VSPackage,请遵循以下准则:

  • 如果可能,请使用 命令、组合框、组或子菜单的 Parent 元素将其放入相应的组中。

  • 将这些组分配给 VSPackage 显示的菜单。

  • 子菜单或命令的父级必须是 Group 元素。 将命令和子菜单分配给组,然后将组分配给父菜单。

  • 可以通过在命令定义后添加 CommandPlacements 元素节,然后将命令添加到 CommandPlacements 每个附加组的 CommandPlacement 元素,从而将命令放入其他组中。

大型命令集的最佳做法

如果 VSPackage 将有多个命令将显示在多个上下文中,也遵循以下准则:

  • 创建菜单、组和命令自父级。 也就是说,不要在项的定义中分配 Parent 元素。

  • 使用 CommandPlacement 元素节中的 CommandPlacements 元素条目在其父菜单和组中放置菜单、组和命令。

  • 在元素节中 CommandPlacements ,填充给定菜单或组的条目应彼此相邻。 这有助于提高可读性,并使 Priority 排名更易于确定。