IOleWindow::GetWindow メソッド (oleidl.h)

  • [アーティクル]

インプレース アクティブ化に参加しているいずれかのウィンドウ (フレーム、ドキュメント、親、またはインプレース オブジェクト ウィンドウ) へのハンドルを取得します。

構文

HRESULT GetWindow(
  [out] HWND *phwnd
);

パラメーター

[out] phwnd

ウィンドウ ハンドルを受け取る変数へのポインター。

戻り値

このメソッドは、成功したS_OKを返します。 その他の可能な戻り値は次のとおりです。

リターン コード 説明
E_FAIL
 オブジェクトはウィンドウなしです。
E_INVALIDARG
 指定した fEnterMode 値が無効です。
E_OUTOFMEMORY
 この操作に使用できるメモリが不足しています。
E_UNEXPECTED
 予期しないエラーが発生しました。

解説

ウィンドウ階層は、5 種類のウィンドウで構成されます。 オブジェクトがアクティブになっている場合、これらのウィンドウの一部またはすべてにアクセスできます。

ウィンドウ 説明
フレーム コンテナー アプリケーションのメイン メニューが存在する最も外側のメイン ウィンドウ。
ドキュメント 埋め込みオブジェクトを含む複合ドキュメントをユーザーに表示するウィンドウ。
ペイン オブジェクトのビューを含むドキュメント ウィンドウのサブウィンドウ。 分割ペイン ウィンドウを使用するアプリケーションにのみ適用されます。
Parent そのオブジェクトのビューを含むコンテナー ウィンドウ。 オブジェクト アプリケーションは、そのウィンドウをこのウィンドウの子としてインストールします。
インプレース アクティブなインプレース オブジェクトを含むウィンドウ。 オブジェクト アプリケーションは、このウィンドウを作成し、コンテナーの親ウィンドウの子であるハッチ ウィンドウの子としてインストールします。
 

ウィンドウの種類ごとに、インプレース アクティブ化アーキテクチャでは異なるロールがあります。 ただし、種類ごとに個別の物理ウィンドウを使用する必要はありません。 多くのコンテナー アプリケーションでは、フレーム、ドキュメント、ペイン、親ウィンドウに同じウィンドウが使用されます。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー oleidl.h

関連項目

IOleWindow