Disponibilidade de comando

O contexto do Visual Studio determina quais comandos estão disponíveis. O contexto pode mudar dependendo do projeto atual, do editor atual, dos VSPackages carregados e de outros aspectos do IDE (ambiente de desenvolvimento integrado).

Contextos de comando

Os seguintes contextos de comando são os mais comuns:

• IDE: Os comandos fornecidos pelo IDE estão sempre disponíveis.

• VSPackage: Os VSPackages podem definir quando os comandos devem ser mostrados ou escondidos.

• Projeto: os comandos do project aparecem apenas para o projeto selecionado no momento.

• Editor: somente um editor pode estar ativo por vez. Os comandos do editor ativo estão disponíveis. Um editor trabalha em estreita colaboração com um serviço de idioma. O serviço de idioma deve processar seus comandos no contexto do editor associado.

• Tipo de arquivo: um editor pode carregar mais de um tipo de arquivo. Os comandos disponíveis podem ser alterados dependendo do tipo de arquivo.

• Janela ativa: a última janela do documento ativo define o contexto da interface do usuário para associações de chave. No entanto, uma janela de ferramentas que tem uma tabela de associação de chave que se assemelha ao navegador da Web interno também pode definir o contexto da interface do usuário. Para janelas de documentos com várias guias, como o editor HTML, cada guia tem um GUID de contexto de comando diferente. Depois que uma janela de ferramentas é registrada, ela está sempre disponível no menu Exibir .

• Contexto da interface do usuário: os contextos de interface do usuário são identificados pelos valores da VSConstants.UICONTEXT classe, por exemplo, SolutionBuilding_guid quando a solução está sendo criada ou Debugging_guid quando o depurador está ativo. Vários contextos de interface do usuário podem estar ativos ao mesmo tempo.

Definir GUIDs de contexto personalizado

Se um GUID de contexto de comando apropriado ainda não estiver definido, você poderá definir um em seu VSPackage e programá-lo para que ele seja ativo ou inativo, conforme necessário, para controlar a visibilidade de seus comandos:

1. Registre GUIDs de contexto chamando o método GetCmdUIContextCookie.

2. Obtenha o estado de um GUID de contexto chamando o IsCmdUIContextActive método.

3. Ative e desative GUIDs de contexto chamando o método SetCmdUIContext.

Conteúdo relacionado

• Objetos de contexto de seleção
• Como os VSPackages adicionam elementos de interface do usuário