Instrucciones de selección de ubicación de comandoCommand Placement Guidelines

Prácticas recomendadas 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. Comandos se definen y se sitúa de acuerdo con la información de archivos de vsct.Commands are defined and positioned according to the information in .vsct files.

Prácticas recomendadas 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 un gráfico de la estructura del comando de antemano.Prepare a chart of the command structure in advance. Identificar los comandos, 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.

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

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

  • Cuando coloca un comando en un menú existente, el nombre del comando para que se desactive su propósito y no confundirse 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.

Prácticas recomendadas para conjuntos de comandos pequeñoBest Practices for Small Command Sets

Si está desarrollando un VSPackage que tiene unos pocos comandos, seguir estas directrices:If you are developing a VSPackage that has just a few commands, also follow these guidelines:

  • Cuando sea posible, use la elemento primario de un comando, el cuadro combinado, el grupo o el 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.

  • Asignar 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 elemento Group.The parent of a child menu or a command must be a Group Element. Asignar comandos y 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 elemento sección después de la definición del comando y, a continuación, agregar a la CommandPlacements Element una CommandPlacement elemento para cada uno 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.

Prácticas recomendadas para 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, seguir estas directrices:If your VSPackage will have many commands that will appear in multiple contexts, also follow these guidelines:

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

  • Use CommandPlacement Element entradas en la CommandPlacements Element sección para colocar los menús, los grupos y los comandos en los archivos y grupos de menús principal.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, las entradas que rellenan un menú determinado o grupo debe ser adyacente entre sí.In the CommandPlacements section, the entries that populate a given menu or group should be adjacent to one another. Esto ayuda a mejorar la legibilidad y hace el Priority clasificaciones más fáciles de determinar.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 de tabla de comandos de Visual Studio (.Vsct)Visual Studio Command Table (.Vsct) Files