ViewFilter.IOleCommandTarget.QueryStatus(Guid, UInt32, OLECMD[], IntPtr) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.