CMDIFrameWnd クラス

[アーティクル]
06/16/2023

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からクラスを派生させます。派生クラスにメンバー変数を追加して、アプリケーションに固有のデータを格納します。ウィンドウにメッセージが送られたときに行われる処理を指定するには、派生クラスにメッセージ処理メンバー関数とメッセージマップを実装します。

MDI フレームウィンドウを構築するには、CFrameWndの Create または LoadFrame メンバー関数を呼び出します。

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

Create メンバー関数を使用して、フレームの作成パラメーターを即時引数として渡します。

LoadFrame は、 Createよりも少ない引数を必要とします。代わりに、フレームのキャプション、アイコン、アクセラレータテーブル、メニューなど、リソースから既定値の大部分を取得します。 LoadFrameによってアクセスするには、これらすべてのリソースに同じリソース ID (たとえば、IDR_MAINFRAME) が必要です。

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

CMDIFrameWnd クラスは、既定の実装の多くを CFrameWnd から継承します。これらの機能の詳細な一覧については、 CFrameWnd クラスの説明を参照してください。 CMDIFrameWnd クラスには、次の追加機能があります。

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

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

CMDIFrameWndの詳細については、「Frame Windows」を参照してください。

継承階層

CMDIFrameWnd

要件

ヘッダー: afxwin.h

CMDIFrameWnd::CMDIFrameWnd

CMDIFrameWnd オブジェクトを構築します。

CMDIFrameWnd();

解説

CreateまたはLoadFrameメンバー関数を呼び出して、表示される MDI フレームウィンドウを作成します。

例

// Create main MDI Frame window. CMainFrame is a CMDIFrameWnd-derived
// class. The default CFrameWnd::PostNcDestroy() handler will delete this
// object when destroyed.
CMainFrame *pMainFrame = new CMainFrame;

CMDIFrameWnd::CreateClient

CMDIChildWnd オブジェクトを管理する MDI クライアントウィンドウを作成します。

virtual BOOL CreateClient(
    LPCREATESTRUCT lpCreateStruct,
    CMenu* pWindowMenu);

パラメーター

lpCreateStruct
CREATESTRUCT 構造体への長いポインター。

pWindowMenu
ウィンドウポップアップメニューへのポインター。

戻り値

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

解説

このメンバー関数は、 OnCreate メンバー関数を直接オーバーライドする場合に呼び出す必要があります。

例

// The code below is from winmdi.cpp. It shows how to
// call CMDIFrameWnd::CreateClient(). CMainFrame is a
// CMDIFrameWnd-derived class.
BOOL CMainFrame::OnCreateClient(LPCREATESTRUCT lpcs, CCreateContext * /*pContext*/)
{
   CMenu *pMenu = NULL;
   if (m_hMenuDefault == NULL)
   {
      // default implementation for MFC V1 backward compatibility
      pMenu = GetMenu();
      ASSERT(pMenu != NULL);
      // This is attempting to guess which sub-menu is the Window menu.
      // The Windows user interface guidelines say that the right-most
      // menu on the menu bar should be Help and Window should be one
      // to the left of that.
      int iMenu = pMenu->GetMenuItemCount() - 2;

      // If this assertion fails, your menu bar does not follow the guidelines
      // so you will have to override this function and call CreateClient
      // appropriately or use the MFC V2 MDI functionality.
      ASSERT(iMenu >= 0);
      pMenu = pMenu->GetSubMenu(iMenu);
      ASSERT(pMenu != NULL);
   }

   return CreateClient(lpcs, pMenu);
}

CMDIFrameWnd::CreateNewChild

新しい子ウィンドウを作成します。

CMDIChildWnd* CreateNewChild(
    CRuntimeClass* pClass,
    UINT nResource,
    HMENU hMenu = NULL,
    HACCEL hAccel = NULL);

パラメーター

pClass
作成する子ウィンドウのランタイムクラス。

nResource
子ウィンドウに関連付けられている共有リソースの ID。

hMenu
子ウィンドウのメニュー。

hAccel
子ウィンドウのアクセラレータ。

解説

MDI フレームウィンドウの子ウィンドウを作成するには、この関数を使用します。

例

// CMainFrame is a CMDIFrameWnd-derived class,
// OnNewDraw is a menu command handler,
// CDrawFrame is a CMDIChildWnd-derived class.
void CMainFrame::OnNewDraw()
{
   CreateNewChild(RUNTIME_CLASS(CDrawFrame), IDR_DRAW, m_hDrawMenu,
                  m_hDrawAccel);
}

CMDIFrameWnd::GetWindowMenuPopup

このメンバー関数を呼び出して、"Window" という名前の現在のポップアップメニュー (MDI ウィンドウ管理のメニュー項目を含むポップアップメニュー) へのハンドルを取得します。

virtual HMENU GetWindowMenuPopup(HMENU hMenuBar);

パラメーター

hMenuBar
現在のメニューバー。

戻り値

存在する場合は、ウィンドウのポップアップメニュー。それ以外の場合は NULL。

解説

既定の実装では、ID_WINDOW_NEWやID_WINDOW_TILE_HORZなどの標準のウィンドウメニューコマンドを含むポップアップメニューが検索されます。

標準メニューコマンド ID を使用しないウィンドウメニューがある場合は、このメンバー関数をオーバーライドします。

例

// CMainFrame::OnActivateFirstMDIChild() is a menu command handler for
// CMainFrame class, which in turn is a CMDIFrameWnd-derived class.
// It looks for the caption of the first created MDI child window from
// the Window popup menu, and then activate the child window.
void CMainFrame::OnActivateFirstMDIChild()
{
   // Get handle to the Window pop-up menu.
   CMenu *menubar = GetMenu();
   CMenu *wmenu = CMenu::FromHandle(GetWindowMenuPopup(menubar->GetSafeHmenu()));
   if (wmenu == NULL)
      return;

   // Get the caption of the first created MDI child window.
   CString caption;
   if (!wmenu->GetMenuString(AFX_IDM_FIRST_MDICHILD, caption, MF_BYCOMMAND))
      return;

   // Get the actual name of the first created MDI child window by
   // getting rid of the number and space, e.g. "&1 MDI 1".
   int pos = caption.FindOneOf(_T(" "));
   if (pos == -1)
      return;

   caption = caption.Right(caption.GetLength() - (pos + 1));

   // Get the CWnd* of the first created MDI child window by comparing
   // the caption of each MDI child window in the MDI application.
   // Activate the first created MDI child window if found.
   CMDIChildWnd *child = MDIGetActive();
   do
   {
      CString str;
      child->GetWindowText(str);
      if (str == caption)
      {
         child->MDIActivate(); // or MDIActivate(child);
         break;
      }

      child = (CMDIChildWnd*)child->GetWindow(GW_HWNDNEXT);
   } while (child);
}

CMDIFrameWnd::MDIActivate

別の MDI 子ウィンドウをアクティブにします。

void MDIActivate(CWnd* pWndActivate);

パラメーター

pWndActivate
アクティブ化する MDI 子ウィンドウをポイントします。

解説

このメンバー関数は、アクティブ化されている子ウィンドウと非アクティブ化されている子ウィンドウの両方に WM_MDIACTIVATE メッセージを送信します。

これは、ユーザーがマウスまたはキーボードを使用して MDI 子ウィンドウにフォーカスを変更した場合に送信されるメッセージと同じです。

Note

MDI 子ウィンドウは、MDI フレームウィンドウとは別にアクティブ化されます。フレームがアクティブになると、最後にアクティブ化された子ウィンドウに、アクティブなウィンドウフレームとキャプションバーを描画する WM_NCACTIVATE メッセージが送信されますが、別のWM_MDIACTIVATE メッセージは受信されません。

例

CMDIFrameWnd::GetWindowMenuPopup の例を参照してください。

CMDIFrameWnd::MDICascade

すべての MDI 子ウィンドウをカスケード形式で配置します。

void MDICascade();
void MDICascade(int nType);

パラメーター

nType
カスケードフラグを指定します。指定できるのは、無効な MDI 子ウィンドウがカスケードされないようにするMDITILE_SKIPDISABLEDフラグのみです。

解説

パラメーターのない MDICascadeの最初のバージョンでは、無効になっているものも含め、すべての MDI 子ウィンドウがカスケードされます。 nType パラメーターにMDITILE_SKIPDISABLEDを指定した場合、2 番目のバージョンでは、必要に応じて無効な MDI 子ウィンドウはカスケードされません。

例

// CMainFrame::OnWindowCommand() is a menu command handler for
// CMainFrame class, which is a CMDIFrameWnd-derived
// class. It handles menu commands for the Windows pop-up menu.
// Its entries in the message map are of the following form:
//    ON_COMMAND_EX(ID_WINDOW_ARRANGE, &CMainFrame::OnWindowCommand)
BOOL CMainFrame::OnWindowCommand(UINT nID)
{
   switch (nID)
   {
   case ID_WINDOW_ARRANGE: // For Window\Arrange Icons menu item, arrange
      MDIIconArrange();    // all minimized document child windows.
      break;

   case ID_WINDOW_CASCADE: // For Window\Cascade menu item, arrange
      MDICascade();        // all the MDI child windows in a cascade format.
      break;

   case ID_WINDOW_TILE_HORZ:       // For Window\Tile Horizontal menu item,
      MDITile(MDITILE_HORIZONTAL); // tile MDI child windows so that
      break;                       // one window appears above another.

   case ID_WINDOW_TILE_VERT:     // For Window\Tile Vertical menu item,
      MDITile(MDITILE_VERTICAL); // tile MDI child windows so that
      break;                     // one window appears beside another.
   }

   return TRUE;
}

CMDIFrameWnd::MDIGetActive

現在アクティブな MDI 子ウィンドウと、子ウィンドウが最大化されているかどうかを示すフラグを取得します。

CMDIChildWnd* MDIGetActive(BOOL* pbMaximized = NULL) const;

パラメーター

pbMaximized
BOOL 戻り値へのポインター。ウィンドウが最大化されている場合は、戻り値が TRUE に設定されます。それ以外の場合は FALSE。

戻り値

アクティブな MDI 子ウィンドウへのポインター。

例

CMDIChildWnd::MDIMaximize の例を参照してください。

CMDIFrameWnd::MDIIconArrange

最小化されたすべてのドキュメントの子ウィンドウを配置します。

void MDIIconArrange();

解説

最小化されていない子ウィンドウには影響しません。

例

CMDIFrameWnd::MDICascade の例を参照してください。

CMDIFrameWnd::MDIMaximize

指定した MDI 子ウィンドウを最大化します。

void MDIMaximize(CWnd* pWnd);

パラメーター

pWnd
最大化するウィンドウをポイントします。

解説

子ウィンドウが最大化されると、Windows によってサイズが変更され、クライアントウィンドウがクライアントウィンドウ全体に表示されます。 Windows では、ユーザーが子ウィンドウを復元または閉じることができるように、子ウィンドウのコントロールメニューがフレームのメニューバーに配置されます。また、子ウィンドウのタイトルをフレームウィンドウのタイトルに追加します。

現在アクティブな MDI 子ウィンドウが最大化されたときに別の MDI 子ウィンドウがアクティブになった場合、Windows は現在アクティブな子ウィンドウを復元し、新しくアクティブ化された子ウィンドウを最大化します。

例

CMDIChildWnd::MDIMaximize の例を参照してください。

CMDIFrameWnd::MDINext

現在アクティブな子ウィンドウのすぐ後ろにある子ウィンドウをアクティブにし、現在アクティブな子ウィンドウを他のすべての子ウィンドウの背後に配置します。

void MDINext();

解説

現在アクティブな MDI 子ウィンドウが最大化されている場合、メンバー関数は現在アクティブな子を復元し、新しくアクティブ化された子を最大化します。

例

// CMainFrame::OnActivateNextWindow() is a menu command handler for
// CMainFrame class, which in turn is a CMDIFrameWnd-derived class.
// It activates the child window immediately behind the currently
// active child window and places the currently active child window
// behind all other child windows.
void CMainFrame::OnActivateNextWindow()
{
   MDINext();
}

CMDIFrameWnd::MDIPrev

前の子ウィンドウをアクティブにし、現在アクティブな子ウィンドウをそのすぐ後ろに配置します。

void MDIPrev();

解説

CMDIFrameWnd::MDIRestore

MDI 子ウィンドウを最大化または最小化されたサイズから復元します。

void MDIRestore(CWnd* pWnd);

パラメーター

pWnd
復元するウィンドウをポイントします。

例

CMDIChildWnd::MDIRestore の例を参照してください。

CMDIFrameWnd::MDISetMenu

MDI フレームウィンドウ、ウィンドウポップアップメニュー、またはその両方のメニューを置き換えます。

CMenu* MDISetMenu(
    CMenu* pFrameMenu,
    CMenu* pWindowMenu);

パラメーター

pFrameMenu
新しいフレームウィンドウメニューのメニューを指定します。 NULL の場合、メニューは変更されません。

pWindowMenu
新しいウィンドウポップアップメニューのメニューを指定します。 NULL の場合、メニューは変更されません。

戻り値

このメッセージに置き換えられたフレームウィンドウメニューへのポインター。ポインターは一時的である可能性があり、後で使用するために格納しないでください。

解説

MDISetMenuを呼び出した後、アプリケーションはメニューバーを更新するために、CWndの DrawMenuBar メンバー関数を呼び出す必要があります。

この呼び出しは、ウィンドウのポップアップメニューを置き換える場合、MDI 子ウィンドウメニュー項目は、前のウィンドウメニューから削除され、新しいウィンドウのポップアップメニューに追加されます。

MDI 子ウィンドウが最大化され、この呼び出しによって MDI フレームウィンドウメニューが置き換えられる場合、コントロールメニューと復元コントロールは前のフレームウィンドウメニューから削除され、新しいメニューに追加されます。

フレームワークを使用して MDI 子ウィンドウを管理する場合は、このメンバー関数を呼び出さないでください。

例

// CMdiView::OnReplaceMenu() is a menu command handler for CMdiView
// class, which in turn is a CView-derived class. It loads a new
// menu resource and replaces the main application window's menu
// bar with this new menu.
void CMdiView::OnReplaceMenu()
{
   // Load a new menu resource named IDR_SHORT_MENU. m_hDefaultMenu is
   // a member variable of CMdiDoc class (a CDocument-derived class).
   // Its type is HMENU.
   CMdiDoc *pdoc = (CMdiDoc*)GetDocument();
   pdoc->m_hDefaultMenu =
       ::LoadMenu(AfxGetResourceHandle(), MAKEINTRESOURCE(IDR_SHORT_MENU));
   if (pdoc->m_hDefaultMenu == NULL)
      return;

   // Get the parent window of this view window. The parent window is
   // a CMDIChildWnd-derived class. We can then obtain the MDI parent
   // frame window using the CMDIChildWnd*. Then, replace the current
   // menu bar with the new loaded menu resource.
   CMDIFrameWnd *frame = ((CMDIChildWnd*)GetParent())->GetMDIFrame();
   frame->MDISetMenu(CMenu::FromHandle(pdoc->m_hDefaultMenu), NULL);
   frame->DrawMenuBar();
}

// GetDefaultMenu() is an undocumented virtual function for
// CDocument class. It allows the document to determine which
// menu to display. m_hDefaultMenu is of type HMENU. Its value
// is initialized to NULL either in the constructor or
// CDocument::OnNewDocument(). And the menu resource is destroyed
// in the destructor to avoid having too many menus loaded at once.
HMENU CMdiDoc::GetDefaultMenu()
{
   if (m_hDefaultMenu)
      return m_hDefaultMenu;

   return COleServerDoc::GetDefaultMenu();
}

// Initialize member variable(s) in the constructor. CMdiDoc is
// a CDocument-derived class.
CMdiDoc::CMdiDoc()
{
   // Use OLE compound files
   EnableCompoundFile();

   m_hDefaultMenu = NULL; // initialize to NULL
}

// Destroy menu resource in CMdiDoc's destructor. CMdiDoc is
// a CDocument-derived class.
CMdiDoc::~CMdiDoc()
{
   if (m_hDefaultMenu)
      ::DestroyMenu(m_hDefaultMenu);
}

CMDIFrameWnd::MDITile

すべての子ウィンドウをタイル形式で配置します。

void MDITile();
void MDITile(int nType);

パラメーター

nType
タイリングフラグを指定します。このパラメーターには、次のいずれかのフラグを指定できます。

MDITILE_HORIZONTAL 1 つのウィンドウが別のウィンドウの上に表示されるように MDI 子ウィンドウをタイルします。
MDITILE_SKIPDISABLED 無効な MDI 子ウィンドウがタイル化されないようにします。
MDITILE_VERTICAL 1 つのウィンドウが別のウィンドウの横に表示されるように、MDI 子ウィンドウをタイルします。

解説

パラメーターのない最初のバージョンの MDITileは、Windows バージョン 3.1 以降でウィンドウを垂直方向にタイル表示します。 2 番目のバージョンでは、 nType パラメーターの値に応じて、ウィンドウが垂直方向または水平方向にタイル表示されます。

例

CMDIFrameWnd::MDICascade の例を参照してください。

次の方法で共有

CMDIFrameWnd クラス

構文

メンバー

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

パブリック メソッド

解説

継承階層

要件

CMDIFrameWnd::CMDIFrameWnd

解説

例

CMDIFrameWnd::CreateClient

パラメーター

戻り値

解説

例

CMDIFrameWnd::CreateNewChild

パラメーター

解説

例

CMDIFrameWnd::GetWindowMenuPopup

パラメーター

戻り値

解説

例

CMDIFrameWnd::MDIActivate

パラメーター

解説

例

CMDIFrameWnd::MDICascade

パラメーター

解説

例

CMDIFrameWnd::MDIGetActive

パラメーター

戻り値

例

CMDIFrameWnd::MDIIconArrange

解説

例

CMDIFrameWnd::MDIMaximize

パラメーター

解説

例

CMDIFrameWnd::MDINext

解説

例

CMDIFrameWnd::MDIPrev

解説

CMDIFrameWnd::MDIRestore

パラメーター

例

CMDIFrameWnd::MDISetMenu

パラメーター

戻り値

解説

例

CMDIFrameWnd::MDITile

パラメーター

解説

例

関連項目

フィードバック

その他のリソース

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

パブリックメソッド