ViewFilter.IOleCommandTarget.QueryStatus(Guid, UInt32, OLECMD[], IntPtr) Método

Definição

Determina se há suporte para os comandos especificados no grupo de comandos fornecido.

 virtual int Microsoft.VisualStudio.OLE.Interop.IOleCommandTarget.QueryStatus(Guid % guidCmdGroup, System::UInt32 cCmds, cli::array <Microsoft::VisualStudio::OLE::Interop::OLECMD> ^ prgCmds, IntPtr pCmdText) = Microsoft::VisualStudio::OLE::Interop::IOleCommandTarget::QueryStatus;
int IOleCommandTarget.QueryStatus (ref Guid guidCmdGroup, uint cCmds, Microsoft.VisualStudio.OLE.Interop.OLECMD[] prgCmds, IntPtr pCmdText);
abstract member Microsoft.VisualStudio.OLE.Interop.IOleCommandTarget.QueryStatus : Guid * uint32 * Microsoft.VisualStudio.OLE.Interop.OLECMD[] * nativeint -> int
override this.Microsoft.VisualStudio.OLE.Interop.IOleCommandTarget.QueryStatus : Guid * uint32 * Microsoft.VisualStudio.OLE.Interop.OLECMD[] * nativeint -> int
Function QueryStatus (ByRef guidCmdGroup As Guid, cCmds As UInteger, prgCmds As OLECMD(), pCmdText As IntPtr) As Integer Implements IOleCommandTarget.QueryStatus

Parâmetros

guidCmdGroup
Guid

no O GUID do grupo de comandos.

cCmds
UInt32

no O número de IDs de comando listadas na prgCmds matriz.

prgCmds
OLECMD[]

[entrada, saída] Uma matriz de OLECMD estruturas que especificam as IDs de comando sobre as quais você está consultando. No retorno, o status de habilitação de cada comando é armazenado em cada estrutura.

pCmdText
IntPtr

[entrada, saída] Um ponteiro umarshaled para uma OLECMDTEXT estrutura que recebe o nome de cada comando com suporte.

Retornos

Int32

Se bem-sucedido, retorna S_OK ; caso contrário, retorna um código de erro. Um código de erro típico que pode ser retornado é OLECMDERR_E_UNKNOWNGROUP , indicando que não há suporte para o grupo de comandos.

Implementações

Comentários

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

Esse método é uma implementação do QueryStatus método na IOleCommandTarget interface.

O método base chama o QueryCommandStatus método para cada comando na lista e armazena o resultado na OLECMD estrutura para esse comando. Se o QueryCommandStatus retornar um erro (como OLECMDERR_E_UNKNOWNGROUP ), o método base chamará o QueryStatus método no próximo destino de comando na cadeia e retornará o resultado imediatamente, ignorando todos os comandos restantes na lista (isso significa que o QueryCommandStatus método deve relatar um status válido (com suporte ou sem suporte) para todos os comandos fornecidos a ele, a menos que o grupo inteiro não tenha suporte nesse caso, QueryCommandStatus retorna OLECMDERR_E_UNKNOWNGROUP ). O método base não define o nome do comando na pCmdText estrutura, pois a implementação padrão da estrutura de pacote gerenciada das classes de serviço de linguagem não precisa alterar o nome de qualquer comando existente.

Aplica-se a