COleClientItem::OnGetWindowContext

更新 : 2007 年 11 月

アイテムが埋め込み先編集が有効になったときに、フレームワークが呼び出します。

virtual BOOL OnGetWindowContext(
   CFrameWnd** ppMainFrame,
   CFrameWnd** ppDocFrame,
   LPOLEINPLACEFRAMEINFO lpFrameInfo 
);

パラメータ

  • ppMainFrame
    メイン フレーム ウィンドウへのポインタのポインタ。

  • ppDocFrame
    ドキュメント フレーム ウィンドウへのポインタのポインタ。

  • lpFrameInfo
    フレーム ウィンドウの情報を受け取る OLEINPLACEFRAMEINFO 構造体へのポインタ。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

この関数は、OLE アイテムの親ウィンドウに関する情報を取得するために使います。

コンテナが MDI アプリケーションのときは、既定の実装では、ppMainFrame に CMDIFrameWnd オブジェクトへのポインタを、ppDocFrame にアクティブな CMDIChildWnd オブジェクトへのポインタを返します。コンテナが SDI アプリケーションのときは、ppMainFrame に CFrameWnd オブジェクトへのポインタを、ppDocFrame に NULL を返します。既定の実装では、lpFrameInfo の各メンバにも値を格納します。

ユーザーのアプリケーションに既定の実装が適合しない場合にだけ、この関数をオーバーライドします。アプリケーションが SDI または MDI とは異なるユーザー インターフェイスのパラダイムを持っているような場合です。これは、オーバライド可能な高度な関数です。

詳細については、Windows SDK の「IOleInPlaceSite::GetWindowContext」と OLEINPLACEFRAMEINFO 構造体を参照してください。

必要条件

ヘッダー : afxole.h

参照

参照

COleClientItem クラス

階層図

その他の技術情報

COleClientItem のメンバ