IOleObjectImpl::DoVerbInPlaceActivate

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

コントロールを実行して、そのウィンドウを表示します。ただし、コントロールのユーザーインターフェイスは表示しません。

HRESULT DoVerbInPlaceActivate(
   LPCRECT prcPosRect,
   HWND /* hwndParent */
);

パラメータ

prcPosRec
[入力] コンテナがコントロールを描画する四角形領域へのポインタ。
hwndParent
[入力] コントロールを含むウィンドウのハンドル。ATL の実装では使われていません。

戻り値

標準の HRESULT 値のいずれかを返します。

解説

CComControlBase::InPlaceActivate を呼び出して、埋め込まれているコントロールをアクティブにします。コントロールクラスのデータメンバ m_bWindowOnly が TRUE でない場合、DoVerbInPlaceActivate は、まずコントロールをウィンドウなしのコントロールとしてアクティブにしようと試みます。ただし、これが可能なのは、コンテナが IOleInPlaceSiteWindowless をサポートしている場合だけです。この処理に失敗した場合、この関数は機能拡張を適用した状態でコントロールをアクティブにしようとします。この処理が成功するのは、コンテナが IOleInPlaceSiteEx をサポートしている場合だけです。この処理にも失敗した場合、この関数は機能拡張を適用せずにコントロールをアクティブにしようとします。この場合は、コンテナが IOleInPlaceSite をサポートしている場合にだけ処理が成功します。アクティブ化に成功すると、この関数はコントロールがアクティブになったことをコンテナに通知します。