CMDIChildWnd クラス

[アーティクル]
06/10/2015

ウィンドウ管理用のメンバーも含めて、Windows のマルチドキュメントインターフェイス (MDI: multiple document interface) の子ウィンドウの機能が用意されています。

class CMDIChildWnd : public CFrameWnd

メンバー

パブリックコンストラクター

名前	説明
CMDIChildWnd::CMDIChildWnd	CMDIChildWnd オブジェクトを構築します。

パブリックメソッド

名前	説明
CMDIChildWnd::Create	CMDIChildWnd のオブジェクトに関連付けられた Windows の MDI 子ウィンドウを作成します。
CMDIChildWnd::GetMDIFrame	MDI クライアントウィンドウの親 MDI フレームを返します。
CMDIChildWnd::MDIActivate	この MDI 子ウィンドウをアクティブにします。
CMDIChildWnd::MDIDestroy	この MDI 子ウィンドウを破棄します。
CMDIChildWnd::MDIMaximize	この MDI 子ウィンドウを最大化します。
CMDIChildWnd::MDIRestore	最大化または最小化されたサイズからこの MDI 子ウィンドウを復元します。
CMDIChildWnd::SetHandle	メニュー、アクセラレータのリソースのハンドルを設定します。

解説

MDI 子ウィンドウは一般的なフレームウィンドウによく似ていますが、MDI 子ウィンドウはデスクトップのではなく、MDI フレームウィンドウ内に表示されます。 MDI 子ウィンドウには独自のメニューバーがありませんが、代わりに MDI フレームウィンドウのメニューを共有します。フレームワークは、自動的に現在アクティブな MDI 子ウィンドウを表すために、MDI フレームメニューを変更します。

アプリケーションのための便利な MDI 子ウィンドウを作成するには、CMDIChildWndからクラスを派生します。アプリケーションに固有のデータを格納する、派生クラスにメンバー変数を追加します。ウィンドウにメッセージが送られたときに行われる処理を指定するには、派生クラスにメッセージ処理メンバー関数とメッセージマップを実装します。

MDI 子ウィンドウを構築する方法の 3 つがあります:

直接 **[作成]**を使用してそれを構築します。
直接 LoadFrameを使用してそれを構築します。
間接的にドキュメントテンプレートを通じてそのオブジェクトを構築します。

[作成] か LoadFrameを呼び出す前に、new C++ の演算子を使用してヒープのフレームウィンドウオブジェクトを構築する必要があります。 [作成] を呼び出す前に、AfxRegisterWndClass のグローバル関数のクラスをフレームウィンドウのアイコンおよびクラスのスタイルを設定するには、登録できます。

イミディエイト引数としてフレームの作成のパラメーターを渡すために [作成] のメンバー関数を使用します。

LoadFrame は **[作成]**ほどの引数を必要とし、フレームのキャプション、アイコン、アクセラレータテーブルとメニューを含むリソースからなく、既定のほとんどを取得します。 LoadFrameにアクセスできるため、これらのリソースはすべて同じリソース id (たとえば、IDR_MAINFRAME) が必要です。

CMDIChildWnd のオブジェクトがビュー、ドキュメントが含まれる場合、これらはプログラマの代わりに、フレームワークによって直接間接的に作成されます。 CDocTemplate のオブジェクトは、フレームの作成、含むビューの作成、適切なドキュメントビューへの接続を統合します。 CDocTemplate のコンストラクターのパラメーターに含める 3 個のクラスの CRuntimeClass を指定します (ドキュメント、ビュー、およびフレーム)。ユーザーによって指定されたときに、フレームワークによって CRuntimeClass のオブジェクトが動的に新しいフレームの作成に使用されます (たとえば、ファイルの新しいコマンドまたは MDI ウィンドウの新しいコマンドを使用)。

CMDIChildWnd から派生したフレームウィンドウクラスは DECLARE_DYNCREATE として宣言されて RUNTIME_CLASS の上記の機構が正しく動作するにする必要があります。

CMDIChildWnd のクラスは CFrameWndの既定の実装の大部分を継承します。これらの機能の詳細については、CFrameWnd のクラスの説明を参照してください。 CMDIChildWnd のクラスに次の機能があります:

CMultiDocTemplate のクラスとともに、同じドキュメントテンプレートから CMDIChildWnd の複数のオブジェクトは、Windows のシステムリソースを保存する同じメニューを共有します。
現在アクティブな MDI 子ウィンドウのメニューは完全に MDI フレームウィンドウのメニューを置き換え、現在アクティブな MDI 子ウィンドウのキャプションは、MDI フレームウィンドウのキャプションに追加されます。 MDI フレームウィンドウと同様に実行される MDI 子ウィンドウの関数のそのほかの例については、CMDIFrameWnd のクラスの説明を参照してください。

フレームウィンドウを破棄するときに [削除] C++ の演算子を使用しないでください。代わりに、CWnd::DestroyWindow を使用してください。 PostNcDestroy の CFrameWnd の実装では、ウィンドウが破棄されると、C++ のオブジェクトを削除します。ユーザーがフレームウィンドウを閉じると、既定の OnClose のハンドラーを呼び出します DestroyWindow。

CMDIChildWndの詳細については、フレームウィンドウを参照してください。