Compartilhar via


COleDocObjectItem::ExecCommand

Chamar essa função de membro para executar o comando especificado pelo usuário.

HRESULT ExecCommand( 
   DWORD nCmdID, 
   DWORD nCmdExecOpt = OLECMDEXECOPT_DONTPROMPTUSER, 
   const GUID* pguidCmdGroup = NULL  
);

Parâmetros

  • nCmdID
    O identificador de comando para executar. Deve estar no grupo identificado por pguidCmdGroup.

  • nCmdExecOpt
    Opções de comando especifica execução. Por padrão, defina para executar o comando sem avisar o usuário. Consulte OLECMDEXECOPT para obter uma lista de valores.

  • pguidCmdGroup
    Identificador exclusivo do grupo de comando. Por padrão, NULO, que especifica o grupo padrão. O comando passado em nCmdID deve pertencer ao grupo.

Valor de retorno

Retorna se S_OK com êxito; caso contrário, retornará um dos seguintes códigos de erro.

Valor

Descrição

E_UNEXPECTED

Erro inesperado ocorreu.

E_FAIL

Erro ocorreu.

E_NOTIMPL

Indica que o MFC próprio deve tentar converter e distribuir o comando.

OLECMDERR_E_UNKNOWNGROUP

pguidCmdGroup éNULO não mas não especifica um grupo de comando reconhecido.

OLECMDERR_E_NOTSUPPORTED

nCmdID não é reconhecido como um comando válido no pGroup de grupo.

OLECMDERR_DISABLED

O comando identificado por nCmdID é desativado e não pode ser executado.

OLECMDERR_NOHELP

O chamador solicitado a ajuda no comando identificado pela nCmdID mas não há ajuda está disponível.

OLECMDERR_CANCELLED

o usuário cancelou a execução.

Comentários

pguidCmdGroup e parâmetros de nCmdID juntos identificam exclusivamente invocar o comando. O parâmetro de nCmdExecOpt especifica a ação exata executar.

Requisitos

Cabeçalho: afxole.h

Consulte também

Referência

Classe COleDocObjectItem

Gráfico da hierarquia

IOleCommandTarget::Exec