Compartilhar via


Diretrizes de posicionamento de comando

As práticas recomendadas para posicionar comandos no ambiente de desenvolvimento integrado (IDE) do Visual Studio variam dependendo do tamanho do conjunto de comandos. Os comandos são definidos e posicionados de acordo com as informações nos arquivos .vsct .

Práticas recomendadas para todos os conjuntos de comandos

Para cada conjunto de comandos, siga estas diretrizes:

  • Prepare um gráfico da estrutura de comando com antecedência. Identifique os comandos, caixas de combinação, grupos de comandos e menus de atalho que serão usados em mais de um local.

  • Os comandos que aparecem no mesmo grupo devem ser relacionados.

  • Grupos que contêm apenas um comando são aceitáveis.

  • Os pacotes não devem adicionar muitos comandos aos menus existentes do Visual Studio. Em vez disso, eles devem criar menus ou submenus para hospedar os novos comandos.

  • Quando você coloca um comando em um menu existente, nomeie o comando para que sua finalidade fique clara e ele não seja confundido com comandos existentes.

Práticas recomendadas para conjuntos de comandos pequenos

Se você estiver desenvolvendo um VSPackage que tenha apenas alguns comandos, siga também estas diretrizes:

  • Quando possível, use o elemento pai de um comando, caixa de combinação, grupo ou menu filho para colocá-lo no grupo apropriado.

  • Atribua esses grupos aos menus exibidos pelo VSPackage.

  • O pai de um menu filho ou de um comando deve ser um elemento Group . Atribua comandos e menus filho a grupos e, em seguida, atribua os grupos a menus pai.

  • Você pode colocar um comando em grupos adicionais adicionando uma seção do elemento CommandPlacements após a definição do comando e, em seguida, adicionando ao CommandPlacements elemento um elemento CommandPlacement para cada grupo adicional.

Práticas recomendadas para grandes conjuntos de comandos

Se o VSPackage tiver muitos comandos que aparecerão em vários contextos, siga também estas diretrizes:

  • Crie menus, grupos e comandos de autoparentalidade. Ou seja, não atribua um Parent elemento na definição do item.

  • Use CommandPlacement entradas de elemento na seção de CommandPlacements elementos para colocar menus, grupos e comandos em seus menus e grupos pai.

  • Na seção de CommandPlacements elementos, as entradas que preenchem um determinado menu ou grupo devem ser adjacentes umas às outras. Isso ajuda na legibilidade e torna os Priority rankings mais fáceis de determinar.