COleDocObjectItem::ExecCommand
ユーザーが指定したコマンドを実行するには、このメンバー関数を呼び出します。
HRESULT ExecCommand(
DWORD nCmdID,
DWORD nCmdExecOpt = OLECMDEXECOPT_DONTPROMPTUSER,
const GUID* pguidCmdGroup = NULL
);
パラメーター
nCmdID
実行するコマンドの識別子。pguidCmdGroupによって識別されたグループに配置する必要があります。nCmdExecOpt
コマンド実行オプションを指定します。既定では、ユーザーのメッセージを表示せずにコマンドを実行するように設定します。値の一覧については、OLECMDEXECOPT を参照してください。pguidCmdGroup
コマンド グループの一意の識別子。既定では、null、標準のグループを指定する。nCmdID で渡されたコマンドは、グループに属している必要があります。
戻り値
正常終了した場合はを返します S_OK ; それ以外の場合、次のエラー コードは 1 を返します。
値 |
説明 |
---|---|
E_UNEXPECTED |
予期しないエラーが発生しました。 |
E_FAIL |
エラーが発生しました。 |
E_NOTIMPL |
MFC 自体はコマンドを変換し、ディスパッチする必要があることを示します。 |
OLECMDERR_E_UNKNOWNGROUP |
pguidCmdGroup は非null では、認識されたコマンド グループを指定しません。 |
OLECMDERR_E_NOTSUPPORTED |
nCmdID は、グループの pGroup の有効なコマンドを認識できません。 |
OLECMDERR_DISABLED |
nCmdID によって識別されるコマンドが無効になり、実行することはできません。 |
OLECMDERR_NOHELP |
nCmdID によって識別されるコマンドのヘルプが効果を求められる呼び出し元は使用できません。 |
OLECMDERR_CANCELLED |
ユーザーは実行を取り消した。 |
解説
pguidCmdGroup と nCmdID のパラメーターは、にを呼び出すコマンドを区別します。nCmdExecOpt のパラメーターを受け取る厳密なアクションを指定します。
必要条件
ヘッダー : afxole.h