Método ViewFilter.IOleCommandTarget.QueryStatus

Artigo
10/26/2012

Determina se os comandos especificados no grupo determinado comando são suportados.

Namespace: Microsoft.VisualStudio.Package
Assemblies:   Microsoft.VisualStudio.Package.LanguageService (em Microsoft.VisualStudio.Package.LanguageService.dll)
  Microsoft.VisualStudio.Package.LanguageService.10.0 (em Microsoft.VisualStudio.Package.LanguageService.10.0.dll)
  Microsoft.VisualStudio.Package.LanguageService.9.0 (em Microsoft.VisualStudio.Package.LanguageService.9.0.dll)
  Microsoft.VisualStudio.Package.LanguageService.11.0 (em Microsoft.VisualStudio.Package.LanguageService.11.0.dll)

Sintaxe

'Declaração
Private Function QueryStatus ( _
    ByRef guidCmdGroup As Guid, _
    cCmds As UInteger, _
    prgCmds As OLECMD(), _
    pCmdText As IntPtr _
) As Integer Implements IOleCommandTarget.QueryStatus

int IOleCommandTarget.QueryStatus(
    ref Guid guidCmdGroup,
    uint cCmds,
    OLECMD[] prgCmds,
    IntPtr pCmdText
)

Parâmetros

guidCmdGroup
Tipo: System.Guid%
[in] O GUID do grupo de comandos.

cCmds
Tipo: System.UInt32
[in] O número de IDs de comando listado o prgCmds array.

prgCmds
Tipo: array<Microsoft.VisualStudio.OLE.Interop.OLECMD[]
[in, out] Uma matriz de OLECMD estruturas que especificam as IDs de comando que está sendo consultadas sobre.No retorno, o status de ativação de cada comando é armazenado em cada estrutura.

pCmdText
Tipo: System.IntPtr
[in, out] Um ponteiro de umarshaled para um OLECMDTEXT estrutura que recebe o nome para cada comando que é suportado.

Valor de retorno

Tipo: System.Int32
Se bem-sucedida, retorna S_OK; Caso contrário, retorna um código de erro.Um código de erro típica que pode ser retornado é OLECMDERR_E_UNKNOWNGROUP, indicando que o grupo de comando não é suportado.

Implementações

IOleCommandTarget.QueryStatus(Guid%, UInt32, array<OLECMD[], IntPtr)

Comentários

Esse método é chamado para obter o status de suporte de todos os comandos na lista para o grupo de comando especificado.Essas informações são usadas para ativar ou desativar opções do menu e para determinar quais comandos devem ser passados para o Exec método na IOleCommandTarget interface (embora Exec deve fazer sua própria verificação de suporte também).

Este método é uma implementação da QueryStatus método na IOleCommandTarget interface.

As chamadas de método base a QueryCommandStatus método para cada comando na lista e armazena o resultado na OLECMD estrutura para esse comando.Se QueryCommandStatus retorna um erro (como OLECMDERR_E_UNKNOWNGROUP), e depois chama o método base a QueryStatus método no seu próximo destino na cadeia e retorna o resultado imediatamente, ignorando todos os demais comandos na lista (Isso significa que o QueryCommandStatus método deve informar um status válido (oferece ou não suporte) para todos os comandos dadas a ele, a menos que o grupo inteiro caso em que não há suporte para QueryCommandStatus retorna OLECMDERR_E_UNKNOWNGROUP).O método base não define o nome do comando pCmdText estruturar uma vez que a implementação da estrutura de pacote gerenciado padrão das classes de serviço de linguagem não precisa alterar o nome de qualquer comando existente.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

ViewFilter Classe

Namespace Microsoft.VisualStudio.Package

Compartilhar via