Compartilhar via


Diretrizes de posicionamento de comando

As práticas recomendadas para posicionar comandos no IDE (ambiente de desenvolvimento integrado) do Visual Studio variam dependendo do tamanho do conjunto de comandos. Os comandos são definidos e posicionados de acordo com as informações em 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 comandos com antecedência. Identifique os comandos, as caixas de combinação, os grupos de comandos e os menus de atalho que serão usados em mais de um local.

  • Os comandos que aparecem no mesmo grupo devem estar 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ê colocar um comando em um menu existente, nomeie o comando para que sua finalidade fique clara e não seja confundida com os comandos existentes.

Práticas recomendadas para conjuntos de comandos pequenos

Se você estiver desenvolvendo um VSPackage que tenha apenas alguns comandos, siga 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 a 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 atribua os grupos aos menus pai.

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

Práticas recomendadas para conjuntos de comandos grandes

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

  • Torne menus, grupos e comandos autogerenciáveis. Ou seja, não atribua um Parent elemento na definição do item.

  • Use as entradas de CommandPlacement elemento na seção de CommandPlacements elemento para posicionar 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 as Priority classificações mais fáceis de determinar.