CMDIFrameWnd クラス

[アーティクル]
02/21/2013

Windows のマルチドキュメントインターフェイス (MDI: Multiple Document Interface) のフレームウィンドウの機能が用意されています。さらに、ウィンドウを管理するメンバーも用意されています。

class CMDIFrameWnd : public CFrameWnd

メンバー

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

名前	説明
CMDIFrameWnd::CMDIFrameWnd	CMDIFrameWnd を構築します。

パブリックメソッド

名前	説明
CMDIFrameWnd::CreateClient	この CMDIFrameWndの Windows MDICLIENT ペインを作成します。CWndの OnCreate のメンバー関数によって呼び出されます。
CMDIFrameWnd::CreateNewChild	新しい子ウィンドウを作成します。
CMDIFrameWnd::GetWindowMenuPopup	ウィンドウのポップアップメニューを返します。
CMDIFrameWnd::MDIActivate	別の MDI 子ウィンドウをアクティブにします。
CMDIFrameWnd::MDICascade	カスケード形式のすべての子ウィンドウを並べ替えます。
CMDIFrameWnd::MDIGetActive	子を最大化するかどうかを示すフラグとともに現在アクティブな MDI 子ウィンドウを取得します。
CMDIFrameWnd::MDIIconArrange	最小化されたすべてのドキュメントの子ウィンドウを並べ替えます。
CMDIFrameWnd::MDIMaximize	MDI 子ウィンドウが最大化されます。
CMDIFrameWnd::MDINext	現在アクティブな子ウィンドウの後ろの子ウィンドウは直ちにアクティブにし、他のすべての子ウィンドウの後ろに現在アクティブな子ウィンドウを設定します。
CMDIFrameWnd::MDIPrev	前の子ウィンドウをアクティブにし、その後ろに現在アクティブな子ウィンドウを直ちに設定します。
CMDIFrameWnd::MDIRestore	最大化または最小化されたサイズの MDI 子ウィンドウを復元します。
CMDIFrameWnd::MDISetMenu	MDI フレームウィンドウ、ウィンドウのポップアップメニュー、または両方のメニューを置き換えます。
CMDIFrameWnd::MDITile	並べて表示された形式のすべての子ウィンドウを並べ替えます。

解説

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

CFrameWndの [作成] または LoadFrame のメンバー関数を呼び出して、MDI フレームウィンドウを作成できます。

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

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

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

MDIFrameWnd が CFrameWndから派生したが、フレームウィンドウクラスは CMDIFrameWnd から DECLARE_DYNCREATEで宣言する必要がありません書き込みます。

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

MDI フレームウィンドウは、コントロールバーとともにそれを再配置 MDICLIENT のウィンドウを管理します。MDI クライアントウィンドウが MDI 子フレームウィンドウの直接の親です。CMDIFrameWnd で指定された WS_HSCROLL と WS_VSCROLL のウィンドウスタイルはメインフレームウィンドウではなく、MDI クライアントウィンドウに適用します。これによって、ユーザーは、MDI クライアント領域をスクロールできます (Windows プログラムマネージャーと同様に、たとえば)。
MDI フレームウィンドウは、アクティブな MDI 子ウィンドウがない場合、メニューバーとして使用される既定のメニューを所有します。アクティブな MDI 子がの場合、MDI フレームウィンドウのメニューバーは、MDI 子ウィンドウのメニューに自動的に置き換えられます。
MDI フレームウィンドウには、現在の MDI 子ウィンドウと同様に 1 の場合、動作します。たとえば、コマンドメッセージは、MDI フレームウィンドウの前の現在アクティブな MDI 子に転送されます。
MDI フレームウィンドウは、次の標準的な[ウィンドウ]メニューのコマンドの既定のハンドラーがあります:
- ID_WINDOW_TILE_VERT
- ID_WINDOW_TILE_HORZ
- ID_WINDOW_CASCADE
- ID_WINDOW_ARRANGE
MDI フレームウィンドウに、現在のドキュメントの新しいフレームとビューを作成する ID_WINDOW_NEWの実装があります。アプリケーションは、MDI ウィンドウの処理をカスタマイズする場合、既定のコマンドの実装をオーバーライドできます。

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

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