Compartilhar via

Diretrizes de posicionamento de comando

  • Artigo

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.

Conteúdo relacionado