COleClientItem::OnGetWindowContext

項目がアクティブになるときに、フレームワークによって呼び出されます。

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::GetWindowContextOLEINPLACEFRAMEINFO の構造体を参照してください。

必要条件

ヘッダー : afxole.h

参照

関連項目

COleClientItem クラス

階層図