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