HRESULT OnExecOleCmd ( const GUID ※ pGroup、 DWORD nCmdID、 DWORD nCmdExecOut VARIANTARG ※ pvaIn VARIANTARG ※ pvaOut );
戻り値
戻り値S_OK成功した;それ以外の場合、1 つの次のエラー コード:
| 値 | 説明 |
| E_UNEXPECTED | 予期しないエラーが発生しました |
| E_FAIL | エラーが発生しました |
| E_NOTIMPL | MFC を示します自体の変換およびコマンドをディスパッチする必要があります |
| OLECMDERR_E_UNKNOWNGROUP | pGroup非 -NULLですがない認識されるコマンドのグループを指定します。 |
| OLECMDERR_E_NOTSUPPORTED | nCmdIDグループpGroupで有効なコマンドとして認識されていません |
| OLECMDERR_DISABLED | NCmdIDでされたコマンドは無効になり、実行することはできません。 |
| OLECMDERR_NOHELP | NCmdIDで識別される、コマンドの呼び出し元に助けを求めたが、ヘルプがありません。 |
| OLECMDERR_CANCELED | ユーザーが実行をキャンセル |
パラメーター
pGroup
コマンドのセットを識別する GUID へのポインター。既定のコマンド グループを示すためにNULLを指定できます。
nCmdID
コマンドを実行します。PGroupによって識別されたグループである必要があります。
nCmdExecOut
方法、オブジェクトは、 OLECMDEXECOPT列挙体からコマンドは、1 つまたは複数、次の値を実行する必要があります。:
OLECMDEXECOPT_DODEFAULT
OLECMDEXECOPT_PROMPTUSER
OLECMDEXECOPT_DONTPROMPTUSER
OLECMDEXECOPT_SHOWHELP
pvaIn
コマンドの入力引数を含む、 VARIANTARGへのポインター。NULLにすることができます。
pvaOut
出力を受信するには、 VARIANTARGへのポインター、コマンドから値を返します。NULLにすることができます。
解説
指定したコマンドを実行またはコマンドのヘルプを表示するには、この関数は、フレームワークを呼び出します。
COleCmdUIを有効にするには、更新、および DocObject ユーザー インターフェイス コマンドの他のプロパティを設定する使用できます。コマンドを初期化したら、 OnExecOleCmdを実行することができます。
フレームワークは、変換および、OLE ドキュメント コマンドをディスパッチする前に、関数を呼び出します。標準の OLE ドキュメント コマンドを処理するには、この関数をオーバーライドする必要はありませんが、独自のカスタム コマンドを処理するか、またはパラメーターを受け入れるや結果を返すコマンドを処理する場合はこの関数をオーバーライドを指定する必要があります。
ほとんどのコマンド引数または戻り値しないでください。コマンドの大半は、呼び出し元NULLs pvaInとpvaOutを渡すことができます。入力値を期待するコマンドについては、呼び出し元を宣言し、 VARIANTARG変数を初期化やpvaInで変数へのポインターを渡します。1 つの値を必要とするコマンドについては、引数直接、 VARIANTARGに格納されていることができ、関数に渡されます。複数の引数に ( IDispatch SAFEARRAYなど) のサポートされている型のいずれかを使用してVARIANTARGをパッケージ化する必要があります。
同様に、コマンドの引数が返された場合、呼び出し元がVT_EMPTYに、初期化をVARIANTARGを宣言し、そのアドレスをpvaOutに渡す予定です。 コマンドを 1 つの値が返される場合は、オブジェクトをその値でpvaOut直接格納できます。複数の出力値にVARIANTARGを適切な方法でパッケージ化する必要があります。
この関数の基本クラス実装されます、コマンド ターゲットに関連付けられているOLE_COMMAND_MAP構造体し、適切なハンドラーにコマンドをディスパッチします。基本クラスの実装を引数または戻り値しないコマンドでのみ動作します。引数を受け入れるか、値を返すコマンドを処理する必要がある場合は、この関数をオーバーライドし、 pvaInおよびpvaOutパラメーターをする必要があります。
COleServerDoc 概要|nbsp;クラス メンバー |階層図(&N)
参照特価;COleCmdUI(&N)