OleMenuCommandService.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.
Define o status do comando.
virtual int Microsoft.VisualStudio.OLE.Interop.IOleCommandTarget.QueryStatus(Guid % commandGroup, System::UInt32 nCmdId, cli::array <Microsoft::VisualStudio::OLE::Interop::OLECMD> ^ oleCmd, IntPtr oleText) = Microsoft::VisualStudio::OLE::Interop::IOleCommandTarget::QueryStatus;
int IOleCommandTarget.QueryStatus (ref Guid commandGroup, uint nCmdId, Microsoft.VisualStudio.OLE.Interop.OLECMD[] oleCmd, IntPtr oleText);
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 commandGroup As Guid, nCmdId As UInteger, oleCmd As OLECMD(), oleText As IntPtr) As Integer Implements IOleCommandTarget.QueryStatus
Parâmetros
- commandGroup
- Guid
System. GUID guidGroup . O grupo de menus. Essa implementação mapeia o grupo para CommandID. GUID.
- nCmdId
- UInt32
System. UInt32 nCmdId . O código de ID do comando. Essa implementação mapeia nCmdId para CommandID.ID.
- oleCmd
- OLECMD[]
Microsoft.OLE.Interop._tagOLECMD [] oleCmd . Uma estrutura de comando que contém dados sobre o status do comando.
- oleText
- IntPtr
System. IntPtr oleText . Um ponteiro para um texto BSTR. Se o comando for um verbo, o nome do verbo será preenchido aqui.
Retornos
Um código HRESULT que indica o êxito ou a falha da chamada. Os HRESULTs a seguir podem ser retornados: ValueDescription S_OK O comando foi invocado com êxito. OLECMDERR_E_UNKNOWNGROUP O GUID do grupo não correspondeu à propriedade GUID do commandID para nenhum comando ou verbo. OLECMDERR_E_NOTSUPPORTED O grupo foi encontrado, mas não há nenhum comando ou verbo com uma ID correspondente. Isso também é retornado se a propriedade OleStatus de um comando que foi encontrado retorna zero.
Implementações
Comentários
Esse método é definido como uma implementação de interface privada para o IOleCommandTarget . Para usá-lo, uma ferramenta ou janela de documento geralmente IOleCommandTarget se implementa e, em seguida, encaminha as chamadas para a implementação contida no MenuCommandService . Essa implementação de QueryStatus usará FindCommand se um comando existir e, em seguida, definirá oleCmd. cmdf como o código de status retornado pela propriedade OleStatus do comando.