Instrucciones de selección de ubicación de comandoCommand placement guidelines

Procedimientos recomendados para la colocación de comandos en el entorno de desarrollo integrado (IDE) de Visual Studio varían según el tamaño del conjunto de comandos.Best practices for positioning commands in the Visual Studio integrated development environment (IDE) vary depending on the size of the command set. Los comandos se definen y se coloca según la información de .vsct archivos.Commands are defined and positioned according to the information in .vsct files.

Procedimientos recomendados para todos los conjuntos de comandosBest practices for all command sets

Para cada conjunto de comandos, siga estas instrucciones:For every set of commands, follow these guidelines:

  • Preparar de antemano un gráfico de la estructura del comando.Prepare a chart of the command structure in advance. Identificar los comandos, los cuadros combinados, grupos de comandos y menús contextuales que se usará en más de una ubicación.Identify the commands, combo boxes, command groups, and shortcut menus that will be used in more than one location.

  • Deben estar relacionado con los comandos que aparecen en el mismo grupo.Commands that appear in the same group should be related.

  • Los grupos que contienen un solo comando son aceptables.Groups that contain just one command are acceptable.

  • Los paquetes no deben agregar una gran cantidad de comandos a menús existentes de Visual Studio.Packages should not add lots of commands to existing Visual Studio menus. En su lugar, deben crear menús o submenús para alojar los nuevos comandos.Instead, they should create menus or submenus to host the new commands.

  • Cuando se coloca un comando en un menú existente, el nombre del comando para que su finalidad sea clara y no confundir con los comandos existentes.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.

Procedimientos recomendados para los conjuntos de comandos pequeñoBest practices for small command sets

Si está desarrollando un VSPackage que tenga solo unos comandos, también siga estas instrucciones:If you are developing a VSPackage that has just a few commands, also follow these guidelines:

  • Cuando sea posible, use el primario elemento de un comando, cuadro combinado, grupo o menú secundario para colocarla en el grupo adecuado.When possible, use the Parent element of a command, combo box, group, or child menu to put it in the appropriate group.

  • Asigne a estos grupos a los menús mostrados por el VSPackage.Assign these groups to menus displayed by the VSPackage.

  • El elemento primario de un menú secundario o un comando debe ser un grupo elemento.The parent of a child menu or a command must be a Group element. Asignar comandos y los menús secundarios a grupos y, a continuación, asignar a los grupos a los menús primarios.Assign commands and child menus to groups, and then assign the groups to parent menus.

  • Puede colocar un comando en grupos adicionales mediante la adición de un CommandPlacements sección del elemento después de la definición del comando y, a continuación, agregar a la CommandPlacements elemento un CommandPlacement elemento para cada grupo adicional.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.

Procedimientos recomendados para los conjuntos de comandos de gran tamañoBest practices for large command sets

Si el paquete de VS tendrá muchos comandos que va a aparecer en varios contextos, también siga estas instrucciones:If your VSPackage will have many commands that will appear in multiple contexts, also follow these guidelines:

  • Asegúrese de menús, grupos y comandos automáticamente relaciones jerárquicas.Make menus, groups, and commands self-parenting. Es decir, no asigne un Parent elemento de la definición del elemento.That is, do not assign a Parent element in the definition of the item.

  • Use CommandPlacement entradas de elemento en el CommandPlacements colocar menús, grupos y comandos en sus los menús primarios y los grupos de sección del elemento.Use CommandPlacement element entries in the CommandPlacements element section to put menus, groups, and commands in their parent menus and groups.

  • En la CommandPlacements sección del elemento, las entradas que rellenan un menú determinado o un grupo deben ser adyacentes entre sí.In the CommandPlacements element section, the entries that populate a given menu or group should be adjacent to one another. Esto ayuda a mejorar la legibilidad y hace que el Priority clasificaciones determinar con facilidad.This aids readability and makes the Priority rankings easier to determine.

Vea tambiénSee also

Cómo VSPackages agregar elementos de la interfaz de usuario How VSPackages add user interface elements
Archivos visuales Studio comando table (.vsct)Visual Studio command table (.vsct) files