次の方法で共有

CMDIFrameWndEx クラス

  • [アーティクル]

Windows マルチ ドキュメント インターフェイス (MDI) フレーム ウィンドウ CMDIFrameWndの機能を拡張します。

構文

class CMDIFrameWndEx : public CMDIFrameWnd

メンバー

パブリック メソッド

名前 説明
CMDIFrameWndEx::ActiveItemRecalcLayout アクティブなアイテムのレイアウトを再計算します。
CMDIFrameWndEx::AddDockSite このメソッドは使用されません。
CMDIFrameWndEx::AddPane ペインをドッキング マネージャーに登録します。
CMDIFrameWndEx::AdjustClientArea 罫線を許可するクライアント領域を減らします。
CMDIFrameWndEx::AdjustDockingLayout ドッキングされたすべてのペインのレイアウトを再計算します。
CMDIFrameWndEx::AreMDITabs MDI タブ機能と MDI タブ 付きグループ機能のどちらを有効にするかを指定します。
CMDIFrameWndEx::CanConvertControlBarToMDIChild フレーム ウィンドウがドッキング ウィンドウをタブ付きドキュメントに変換できるかどうかを判断するために、フレームワークによって呼び出されます。
CMDIFrameWndEx::ControlBarToTabbedDocument 指定したドッキング ウィンドウをタブ付きドキュメントに変換します。
CMDIFrameWndEx::CreateDocumentWindow 子ドキュメント ウィンドウを作成します。
CMDIFrameWndEx::CreateNewWindow 新しいウィンドウを作成するためにフレームワークによって呼び出されます。
CMDIFrameWndEx::CreateObject このクラス型の動的インスタンスを作成するために、フレームワークで使用されます。
CMDIFrameWndEx::DockPane 指定したペインがフレーム ウィンドウにドッキングされます。
CMDIFrameWndEx::DockPaneLeftOf ウィンドウを別のウィンドウの左側にドッキングします。
CMDIFrameWndEx::EnableAutoHidePanes メイン フレーム ウィンドウの指定した辺にドッキングされているペインの自動非表示モードを有効にします。
CMDIFrameWndEx::EnableDocking MDI フレーム ウィンドウに属するペインのドッキングを有効にします。
CMDIFrameWndEx::EnableFullScreenMainMenu 全画面表示モードでメイン メニューを表示または非表示にします。
CMDIFrameWndEx::EnableFullScreenMode フレーム ウィンドウの全画面表示モードを有効にします。
CMDIFrameWndEx::EnableLoadDockState ドッキング状態の読み込みを有効または無効にします。
CMDIFrameWndEx::EnableMDITabbedGroups MDI タブ付きグループ機能を有効または無効にします。
CMDIFrameWndEx::EnableMDITabs MDI タブ機能を有効または無効にします。 有効にすると、フレーム ウィンドウに各 MDI 子ウィンドウのタブが表示されます。
CMDIFrameWndEx::EnableMDITabsLastActiveActivation ユーザーが現在のタブを閉じるときに、最後にアクティブなタブをアクティブ化するかどうかを指定します。
CMDIFrameWndEx::EnablePaneMenu アプリケーション ウィンドウの一覧を表示するポップアップ ウィンドウ メニューの自動作成と管理を有効または無効にします。
CMDIFrameWndEx::EnableWindowsDialog コマンド ID が CMFCWindowsManagerDialog ダイアログ ボックスを呼び出すメニュー項目を挿入します。
CMDIFrameWndEx::GetActivePopup 現在表示されているポップアップ メニューへのポインターを返します。
CMDIFrameWndEx::GetPane 指定したコントロール ID を持つペインへのポインターを返します。
CMDIFrameWndEx::GetDefaultResId MDI フレーム ウィンドウの共有リソースの ID を返します。
CMDIFrameWndEx::GetMDITabGroups MDI タブ付きウィンドウの一覧を返します。
CMDIFrameWndEx::GetMDITabs 下線付きのタブ付きウィンドウへの参照を返します。
CMDIFrameWndEx::GetMDITabsContextMenuAllowedItems MDI タブ付きグループ機能が有効な場合に有効なコンテキスト メニュー項目を決定するフラグの組み合わせを返します。
CMDIFrameWndEx::GetMenuBar フレーム ウィンドウにアタッチされているメニュー バー オブジェクトへのポインターを返します。
CMDIFrameWndEx::GetRibbonBar フレームのリボン バー コントロールが取得されます。
CMDIFrameWndEx::GetTearOffBars 破棄状態にある CPane派生オブジェクトの一覧を返します。
CMDIFrameWndEx::GetThisClass このクラス型に関連付けられている CRuntimeClass オブジェクトへのポインターを取得するためにフレームワークによって呼び出されます。
CMDIFrameWndEx::GetToolbarButtonToolTipText アプリケーションでツール バーのボタンのツールヒントを表示するときに、フレームワークによって呼び出されます。
CMDIFrameWndEx::InsertPane 指定されたペインがドッキング マネージャーに登録されます。
CMDIFrameWndEx::IsFullScreen フレーム ウィンドウが全画面表示モードであるかどうかを判断します。
CMDIFrameWndEx::IsMDITabbedGroup MDI タブ付きグループ機能が有効かどうかを判断します。
CMDIFrameWndEx::IsMemberOfMDITabGroup 指定したタブ付きウィンドウが、MDI タブ付きグループ内のウィンドウの一覧に含まれているかどうかを判断します。
CMDIFrameWndEx::IsMenuBarAvailable フレーム ウィンドウにメニュー バーがあるかどうかを指定します。
CMDIFrameWndEx::IsPointNearDockSite 指定されたポイントがドッキング サイトに近いかどうかを決定します。
CMDIFrameWndEx::IsPrintPreview フレーム ウィンドウが印刷プレビュー モードかどうかを決定します。
CMDIFrameWndEx::LoadFrame リソース情報からフレーム ウィンドウを作成します。 ( CMDIFrameWnd::LoadFrameをオーバーライドします)。
CMDIFrameWndEx::LoadMDIState MDI タブ付きグループの指定されたレイアウトと、以前に開いたドキュメントの一覧を読み込みます。
CMDIFrameWndEx::MDITabMoveToNextGroup アクティブなタブを現在アクティブなタブ付きウィンドウから、次または前のタブ付きグループに移動します。
CMDIFrameWndEx::MDITabNewGroup 1 つのウィンドウを持つ新しいタブ付きグループを作成します。
CMDIFrameWndEx::NegotiateBorderSpace OLE のインプレース アクティブ化中に、フレーム ウィンドウ内の罫線スペースをネゴシエートします。
CMDIFrameWndEx::OnCloseDockingPane ユーザーがドッキング可能ウィンドウの Close ボタンをクリックすると、フレームワークによって呼び出されます。
CMDIFrameWndEx::OnCloseMiniFrame ユーザーがフローティング ミニ フレーム ウィンドウの [閉じる] ボタンをクリックしたときに、フレームワークによって呼び出されます。
CMDIFrameWndEx::OnClosePopupMenu アクティブなポップアップ メニューが WM_DESTROY メッセージを処理するときにフレームワークによって呼び出されます。
CMDIFrameWndEx::OnCmdMsg コマンド メッセージのルーティングとディスパッチ、およびコマンド ユーザー インターフェイス オブジェクトの更新を行うために、フレームワークによって呼び出されます。
CMDIFrameWndEx::OnDrawMenuImage メニュー項目に関連付けられているイメージが描画されるときに、フレームワークによって呼び出されます。
CMDIFrameWndEx::OnDrawMenuLogo CMFCPopupMenuがWM_PAINT メッセージを処理するときにフレームワークによって呼び出されます。
CMDIFrameWndEx::OnEraseMDIClientBackground MDI フレーム ウィンドウが WM_ERASEBKGND メッセージを処理するときにフレームワークによって呼び出されます。
CMDIFrameWndEx::OnMenuButtonToolHitTest CMFCToolBarButtonobject がWM_NCHITTEST メッセージを処理するときにフレームワークによって呼び出されます。
CMDIFrameWndEx::OnMoveMiniFrame ミニフレーム ウィンドウを移動するためにフレームワークによって呼び出されます。
CMDIFrameWndEx::OnSetPreviewMode アプリケーションのメイン フレーム ウィンドウの印刷プレビュー モードを設定します。 ( CFrameWnd::OnSetPreviewModeをオーバーライドします)。
CMDIFrameWndEx::OnShowCustomizePane クイック カスタマイズ ウィンドウがアクティブになったときにフレームワークによって呼び出されます。
CMDIFrameWndEx::OnShowMDITabContextMenu いずれかのタブにコンテキスト メニューを表示する必要がある場合に、フレームワークによって呼び出されます。 (MDI タブ付きグループに対してのみ有効です)。
CMDIFrameWndEx::OnShowPanes ペインを表示または非表示するために、フレームワークによって呼び出されます。
CMDIFrameWndEx::OnShowPopupMenu ポップアップ メニューがアクティブにされるときにフレームワークによって呼び出されます。
CMDIFrameWndEx::OnSizeMDIClient クライアント MDI ウィンドウのサイズが変更されたときにフレームワークによって呼び出されます。
CMDIFrameWndEx::OnTearOffMenu ティアオフ バーのあるメニューがアクティブ化されるときにフレームワークによって呼び出されます。
CMDIFrameWndEx::OnUpdateFrameMenu フレーム メニューを更新するためにフレームワークによって呼び出されます。 ( CMDIFrameWnd::OnUpdateFrameMenuをオーバーライドします)。
CMDIFrameWndEx::PaneFromPoint 指定したポイントが含まれるドッキング ウィンドウが返されます。
CMDIFrameWndEx::PreTranslateMessage クラス CWinApp によって使用され、ウィンドウ メッセージが TranslateMessage にディスパッチされる前に、Windows 関数 DispatchMessage 変換されます。 ( CMDIFrameWnd::PreTranslateMessageをオーバーライドします)。
CMDIFrameWndEx::RecalcLayout フレーム ウィンドウのレイアウトを再計算するためにフレームワークによって呼び出されます。 ( CFrameWnd::RecalcLayoutをオーバーライドします)。
CMDIFrameWndEx::RemovePaneFromDockManager ペインを登録解除してドッキング マネージャーから削除します。
CMDIFrameWndEx::SaveMDIState MDI タブ付きグループの現在のレイアウトと、以前に開いたドキュメントの一覧を保存します。
CMDIFrameWndEx::SetPrintPreviewFrame 印刷プレビュー フレーム ウィンドウが設定されます。
CMDIFrameWndEx::SetupToolbarMenu ダミーの項目を検索して、指定されたユーザー定義の項目で置き換えることで、ツールバーのオブジェクトを変更します。
CMDIFrameWndEx::ShowFullScreen メイン フレームを通常モードから全画面表示モードに切り替えます。
CMDIFrameWndEx::ShowPane 指定したペインが表示または非表示になります。
CMDIFrameWndEx::ShowWindowsDialog CMFCWindowsManagerDialog ボックスを作成して開きます。
CMDIFrameWndEx::TabbedDocumentToControlBar 指定したタブ付きドキュメントをドッキング ウィンドウに変換します。
CMDIFrameWndEx::UpdateCaption ウィンドウ フレーム キャプションを更新するために、フレームワークによって呼び出されます。
CMDIFrameWndEx::UpdateMDITabbedBarsIcons 各 MDI タブ 付きペインのアイコンを設定します。
CMDIFrameWndEx::WinHelp WinHelp アプリケーションまたはコンテキスト ヘルプを起動するために、フレームワークによって呼び出されます。 ( CWnd::WinHelpをオーバーライドします)。

データ メンバー

名前 説明
CMDIFrameWndEx::m_bCanConvertControlBarToMDIChild ドッキング ウィンドウを MDI 子ウィンドウに変換できるかどうかを決定します。
CMDIFrameWndEx::m_bDisableSetRedraw MDI 子ウィンドウの再描画の最適化を有効または無効にします。

解説

MDI アプリケーションで拡張カスタマイズ機能を利用するには、CMDIFrameWndではなく、CMDIFrameWndExからアプリケーションの MDI フレーム ウィンドウ クラスを派生させます。

例

次の例では、CMDIFrameWndEx からクラスを派生させます。 このコード スニペットは、 DrawClient サンプル: MFC リボン ベースの OLE オブジェクト描画アプリケーションに由来します。

class CMainFrame : public CMDIFrameWndEx
{
   DECLARE_DYNAMIC(CMainFrame)
public:
   struct XStyle
   {
      COLORREF clrFill;
      COLORREF clrLine;
   };

public:
   CMainFrame();

   // Attributes
public:
   CMFCRibbonBar *GetRibbonBar() { return &m_wndRibbonBar; }

   // Operations
public:
   void UpdateUI(CDrawView *pCurrView);
   void UpdateContextTab(CDrawView *pCurrView);
   void UpdateContextTabFromObject(CDrawObjList &list);

   COLORREF GetColorFromColorButton(int nButtonID);
   int GetWeightFromLineWeight(int nButtonID);
   BOOL GetStyleFromStyles(XStyle &style);

   void SetRibbonContextCategory(UINT uiCategoryID);
   void ActivateRibbonContextCategory(UINT uiCategoryID);

   // Implementation
public:
   virtual ~CMainFrame();
#ifdef _DEBUG
   virtual void AssertValid() const;
   virtual void Dump(CDumpContext &dc) const;
#endif

protected:
   // control bar embedded members
   CMFCRibbonStatusBar m_wndStatusBar;
   CMFCRibbonBar m_wndRibbonBar;

   CMFCRibbonApplicationButton m_MainButton;

   // panel images
   CMFCToolBarImages m_PanelImages;

   // Document colors for demo:
   CList<COLORREF, COLORREF> m_lstMainColors;
   CList<COLORREF, COLORREF> m_lstAdditionalColors;
   CList<COLORREF, COLORREF> m_lstStandardColors;

   // Generated message map functions
protected:
   //{{AFX_MSG(CMainFrame)
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
   afx_msg void OnAppLook(UINT id);
   afx_msg void OnUpdateAppLook(CCmdUI *pCmdUI);
   afx_msg void OnWindowManager();
   afx_msg void OnMdiMoveToNextGroup();
   afx_msg void OnMdiMoveToPrevGroup();
   afx_msg void OnMdiNewHorzTabGroup();
   afx_msg void OnMdiNewVertGroup();
   afx_msg void OnMdiCancel();
   afx_msg LRESULT OnRibbonCustomize(WPARAM wp, LPARAM lp);
   afx_msg LRESULT OnHighlightRibbonListItem(WPARAM wp, LPARAM lp);
   afx_msg void OnToolsOptions();
   afx_msg void OnDummy();
   afx_msg void OnSysColorChange();
   //}}AFX_MSG

   DECLARE_MESSAGE_MAP()

   virtual BOOL OnShowMDITabContextMenu(CPoint point, DWORD dwAllowedItems, BOOL bDrop);
   virtual BOOL OnShowPopupMenu(CMFCPopupMenu *pMenuPopup);

   void ShowOptions(int nPage);
   void CreateDocumentColors();

private:
   BOOL CreateRibbonBar();
   BOOL CreateStatusBar();

   void InitMainButton();
   void InitHomeCategory();
   void InitViewCategory();
   void InitTabButtons();

   void AddContextTab_Format();

   void AdjustObjectSubmenu(CMFCPopupMenu *pMenuPopup);
   void UpdateStatusBarCountPane(int nID, CString strText, int nCount);

   UINT m_nAppLook;
};

継承階層

CObject

CCmdTarget

CWnd

CFrameWnd

CMDIFrameWnd

CMDIFrameWndEx

要件

ヘッダー: afxMDIFrameWndEx.h

CMDIFrameWndEx::ActiveItemRecalcLayout

アクティブなアイテムのレイアウトを再計算します。

void ActiveItemRecalcLayout();

CMDIFrameWndEx::AddPane

ペインをドッキング マネージャーに登録します。

BOOL AddPane(
    CBasePane* pControlBar,
    BOOL bTail=TRUE);

パラメーター

pControlBar
[in]登録するペインへのポインター。

bTail
[in]このペインをリストの末尾に追加するかどうかを指定します。

戻り値

ペインが正常に登録された場合は、0 以外の値を返します。 ペインがドッキング マネージャーに既に登録されている場合は、0 を返します。

解説

ドッキング レイアウトに参加するには各ペインをCDockingManager クラスに登録する必要があります。 特定のウィンドウをドッキングすることをドッキング マネージャーに通知するには、このメソッドを使用します。 そのペインが登録されると、ドッキング マネージャーは、その配置設定と、ドッキング マネージャーによって管理されているペインの一覧内の位置に基づいて、ペインを配置します。

CMDIFrameWndEx::AdjustClientArea

罫線を許可するクライアント領域を減らします。

virtual void AdjustClientArea();

CMDIFrameWndEx::AdjustDockingLayout

ドッキングされたすべてのペインのレイアウトを再計算します。

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

パラメーター

hdwp
[in]複数ウィンドウ位置構造を識別します。 この値は、 BeginDeferWindowPosを呼び出すことによって取得できます。

解説

フレーム ウィンドウにドッキングされているすべてのペインのレイアウトを再計算するには、このメンバー関数を呼び出します。

CMDIFrameWndEx::AreMDITabs

MDI タブ機能と MDI タブ 付きグループ機能のどちらを有効にするかを指定します。

BOOL AreMDITabs(int* pnMDITabsType=NULL) const;

パラメーター

pnMDITabsType
[out]有効になっている機能を示す整数変数へのポインター:

  • 0: すべての機能が無効になっています。
  • 1: MDI タブが有効になっています。
  • 2: MDI タブ付きグループが有効になっています。

戻り値

MDI タブまたは MDI タブ付きグループが有効になっている場合に TRUE を返します。

上記の機能が有効になっていない場合は、 FALSE を返します。

解説

この関数を使用して、MDI タブまたは MDI タブ付きグループがフレーム ウィンドウに対して有効になっているかどうかを確認します。 CMDIFrameWndEx::EnableMDITabsを使用して、MDI タブ機能を有効または無効にします。

CMDIFrameWndEx::EnableMDITabbedGroupsを使用して、MDI タブ付きグループ機能を有効または無効にします。

CMDIFrameWndEx::CanConvertControlBarToMDIChild

フレーム ウィンドウがドッキング ウィンドウをタブ付きドキュメントに変換できるかどうかを判断するためにフレームワークによって呼び出されます

virtual BOOL CanConvertControlBarToMDIChild();

戻り値

フレーム ウィンドウがドッキング ウィンドウをタブ付きドキュメントに変換できる場合は TRUE を返します。それ以外の場合は、 FALSEを返します。

解説

派生クラスでこのメソッドをオーバーライドし、 TRUE を返して、ドッキング ウィンドウをタブ付きドキュメントに変換できるようにします。 または、 CMDIFrameWndEx::m_bCanConvertControlBarToMDIChild を TRUE に設定することもできます。

CMDIFrameWndEx::ControlBarToTabbedDocument

指定したドッキング ウィンドウをタブ付きドキュメントに変換します。

virtual CMDIChildWndEx* ControlBarToTabbedDocument(CDockablePane* pBar);

パラメーター

pBar
変換するドッキング ウィンドウへのポインター。

戻り値

ドッキング ウィンドウを含む新しい MDI 子ウィンドウへのポインターを返します。

解説

このメソッドは、ドッキング ウィンドウをタブ付きドキュメントに変換します。 このメソッドを呼び出すと、フレームワークによって CMDIChildWndEx クラス オブジェクトが作成され、ドッキング マネージャーからドッキング ウィンドウが削除され、ドッキング ウィンドウが新しい MDI 子ウィンドウに追加されます。 MDI 子ウィンドウは、クライアント領域全体をカバーするようにドッキング ウィンドウのサイズを変更します

CMDIFrameWndEx::CreateDocumentWindow

子ドキュメント ウィンドウを作成します。

virtual CMDIChildWndEx* CreateDocumentWindow(
    LPCTSTR lpcszDocName,
    CObject* pObj);

パラメーター

lpcszDocName
[in]ドキュメント識別子を含むテキスト文字列。 通常は、ドキュメント ファイルの完全なパスです。

pObj
[in]ユーザー定義オブジェクトへのポインター。 たとえば、開発者は、ドキュメントを記述し、起動時にドキュメントを初期化する方法を伝えるアプリケーション固有のデータ構造を作成できます。

戻り値

CMDIChildWndEx を指すポインターです。

解説

フレームワークは、レジストリに以前に保存されたドキュメントの一覧を読み込むときに、このメソッドを呼び出します。

レジストリからドキュメントが読み込まれるときにドキュメントを作成するには、このメソッドをオーバーライドします。

例

次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでCreateDocumentWindowを使用する方法を示しています。

この例では、 g_strStartViewName ディスク ファイルから読み込まれていない "仮想ドキュメント" ("スタート ページ" など) の名前を指定できます。 そのため、そのケースを処理するには特別な処理が必要です。

CMainFrame::CMainFrame()
{
   CMFCPopupMenu::SetForceShadow(TRUE);
   m_bCanConvertControlBarToMDIChild = TRUE;
}

CMDIFrameWndEx::CreateNewWindow

新しいウィンドウを作成するためにフレームワークによって呼び出されます。

virtual CMDIChildWndEx* CreateNewWindow(
    LPCTSTR lpcszDocName,
    CObject* pObj);

パラメーター

lpcszDocName
[in]ドキュメント名。

pObj
[入力] 将来の使用のために予約されています。

戻り値

新しいウィンドウへのポインター。

CMDIFrameWndEx::DockPane

指定したペインがフレーム ウィンドウにドッキングされます。

void DockPane(
    CBasePane* pBar,
    UINT nDockBarID=0,
    LPCRECT lpRect=NULL);

パラメーター

pBar
[in]ドッキングするペインへのポインター。

nDockBarID
[in]ドッキング先のフレーム ウィンドウの辺を指定します。

lpRect
[in] 使用されません。

解説

このメソッドは、指定したウィンドウを、 CBasePane::EnableDocking および CMDIFrameWndEx::EnableDocking が呼び出されたときに指定されたフレーム ウィンドウの側面のいずれかにドッキングします。

例

DockPane メソッドの使用例を次に示します。 このコード スニペットは、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションから取得したものです。

DockPane(&m_wndMenuBar);
DockPane(&m_wndToolBar);
DockPane(&m_wndPropertiesBar);

DockPane(&m_wndToolbarBuild);

CMDIFrameWndEx::DockPaneLeftOf

ウィンドウを別のウィンドウの左側にドッキングします。

BOOL DockPaneLeftOf(
    CPane* pBar,
    CPane* pLeftOf);

パラメーター

pBar
[in]ドッキング ウィンドウへのポインター。

pLeftOf
[in]ドッキング サイトとして機能するペインへのポインター。

戻り値

操作が成功した場合に TRUE を返します。 それ以外の場合は、FALSE を返します。

解説

このメソッドを呼び出して、複数のペイン オブジェクトをあらかじめ定義した順序でドッキングします。 このメソッドは、 pBar で指定されたペインを、 pLeftOfで指定されたペインの左側にドッキングします。

例

次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでDockPaneLeftOf メソッドを使用する方法を示しています。

DockPane(&m_wndToolbarBuild);
DockPaneLeftOf(&m_wndToolbarEdit, &m_wndToolbarBuild);

CMDIFrameWndEx::EnableAutoHidePanes

メイン フレーム ウィンドウの指定した辺にペインがドッキングされている場合に、ペインの自動非表示モードを有効にします。

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

パラメーター

dwDockStyle
[in]有効にするメイン フレーム ウィンドウの側面を指定します。 次のフラグの 1 つまたは複数を使用します。

  • CBRS_ALIGN_LEFT
  • CBRS_ALIGN_RIGHT
  • CBRS_ALIGN_TOP
  • CBRS_ALIGN_BOTTOM

戻り値

この関数を呼び出して、メイン フレーム ウィンドウの指定した辺にドッキングされているペインの自動非表示モードを有効にします。

例

次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでEnableAutoHidePanes メソッドを使用する方法を示しています。

EnableAutoHidePanes(CBRS_ALIGN_ANY);

解説

CMDIFrameWndEx::EnableDocking

MDI フレーム ウィンドウに属するペインのドッキングを有効にします。

BOOL EnableDocking(DWORD dwDockStyle);

パラメーター

dwDockStyle
[in]適用するドッキング スタイルを指定します。

戻り値

解説

この関数を呼び出して、 CMDIFrameWndEx オブジェクトに属するペインのドッキングを有効にします。

例

次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでEnableDocking メソッドを使用する方法を示しています。

EnableDocking(CBRS_ALIGN_ANY);

CMDIFrameWndEx::EnableFullScreenMainMenu

全画面表示モードでメイン メニューを表示または非表示にします。

void EnableFullScreenMainMenu(BOOL bEnableMenu);

パラメーター

bEnableMenu
[入力] TRUE をクリックして全画面表示モードでメイン メニューを表示するか、 FALSE して非表示にします。

解説

CMDIFrameWndEx::EnableFullScreenMode

フレーム ウィンドウの全画面表示モードを有効にします。

void EnableFullScreenMode(UINT uiFullScreenCmd);

パラメーター

uiFullScreenCmd
[in]全画面表示モードを有効または無効にするコマンドの ID。

解説

全画面表示モードでは、すべてのドッキング コントロール バー、ツールバー、メニューが非表示になり、アクティブなビューのサイズが全画面表示に変更されます。 全画面表示モードを有効にする場合は、有効または無効にするコマンドの ID を指定する必要があります。 メイン フレームの OnCreate 関数から EnableFullScreenMode を呼び出すことができます。 フレーム ウィンドウを全画面表示モードに切り替えると、フレームワークは、指定されたコマンド ID を持つ 1 つのボタンを含むフローティング ツール バーを作成します。 メイン メニューを画面に表示したままにする場合は、 CMDIFrameWndEx::EnableFullScreenMainMenuを呼び出します。

CMDIFrameWndEx::EnableLoadDockState

ドッキング状態の読み込みを有効または無効にします。

void EnableLoadDockState(BOOL bEnable = TRUE);

パラメーター

bEnable
[入力] TRUE ドッキング状態の読み込みを有効にするには、ドッキング状態の読み込みを無効にする FALSE 。

解説

CMDIFrameWndEx::EnableMDITabbedGroups

フレーム ウィンドウの MDI タブ付きグループ機能を有効または無効にします。

void EnableMDITabbedGroups(
    BOOL bEnable,
    const CMDITabInfo& params);

パラメーター

bEnable
[in] TRUE場合、MDI タブ付きグループ機能が有効になります。 FALSE場合、MDI タブ付きグループ機能は無効になります。

params
[in]MDI クライアント領域で作成される子ウィンドウにフレームワークが適用されるパラメーターを指定します。

解説

MDI タブ付きグループ機能を有効または無効にするには、このメソッドを使用します。 この機能により、MDI アプリケーションは、MDI クライアント領域内で垂直方向または水平方向に配置されたタブ付きウィンドウとして子ウィンドウを表示できます。 タブ付きウィンドウのグループは、スプリッターで分割されます。 ユーザーは、分割器を使用してタブ付きグループのサイズを変更できます。

ユーザーは次のことができます。

  • グループ間で個々のタブをドラッグします。
  • 個々のタブをウィンドウの端にドラッグして、新しいグループを作成します。
  • ショートカット メニューを使用して、タブを移動するか、新しいグループを作成します。
  • アプリケーションでは、タブ付きウィンドウの現在のレイアウトと、現在開いているドキュメントの一覧を保存できます。

bEnableを FALSE に設定してこのメソッドを呼び出した場合、paramsは無視されます。

MDI タブ付きグループが既に有効になっている場合でも、このメソッドをもう一度呼び出して、子ウィンドウの設定を変更できます。 bEnableをTRUEに設定してメソッドを呼び出し、params パラメーターで指定されたCMDITabInfo オブジェクトのメンバーを変更します。

MDI タブ付きグループの使用方法の詳細については、「 MDI タブ付きグループを参照してください。

例

次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでEnableMDITabbedGroupsを使用する方法を示しています。

CMDITabInfo mdiTabParams;
mdiTabParams.m_bTabCustomTooltips = TRUE;

if (bMDITabsVS2005Look)
{
   mdiTabParams.m_style = CMFCTabCtrl::STYLE_3D_VS2005;
   mdiTabParams.m_bDocumentMenu = TRUE;
}
else if (bOneNoteTabs)
{
   mdiTabParams.m_style = CMFCTabCtrl::STYLE_3D_ONENOTE;
   mdiTabParams.m_bAutoColor = bMDITabColors;
}

if (bActiveTabCloseButton)
{
   mdiTabParams.m_bTabCloseButton = FALSE;
   mdiTabParams.m_bActiveTabCloseButton = TRUE;
}

EnableMDITabbedGroups(TRUE, mdiTabParams);

CMDIFrameWndEx::EnableMDITabs

MDI フレーム ウィンドウの MDI タブ機能を有効または無効にします。 有効にすると、フレーム ウィンドウに各 MDI 子ウィンドウのタブが表示されます。

void EnableMDITabs(
    BOOL bEnable=TRUE,
    BOOL bIcons=TRUE,
    CMFCTabCtrl::Location tabLocation=CMFCTabCtrl::LOCATION_BOTTOM,
    BOOL bTabCloseButton=FALSE,
    CMFCTabCtrl::Style style=CMFCTabCtrl::STYLE_3D_SCROLLED,
    BOOL bTabCustomTooltips=FALSE,
    BOOL bActiveTabCloseButton=FALSE);

パラメーター

bEnable
タブを有効にするかどうかを指定します。

bIcons
タブにアイコンを表示するかどうかを指定します。

tabLocation
タブ ラベルの位置を指定します。

bTabCloseButton
タブ閉じるボタンを表示するかどうかを指定します。

style
タブのスタイルを指定します。 通常のタブには STYLE_3D_SCROLLED を使用し、Microsoft OneNote タブには STYLE_3D_ONENOTE を使用します。

bTabCustomTooltips
カスタム ヒントを有効にするかどうかを指定します。

bActiveTabCloseButton
TRUE場合、Close ボタンは、タブ領域の右上隅ではなく、アクティブなタブに表示されます。

解説

MDI フレーム ウィンドウの MDI タブ機能を有効または無効にするには、このメソッドを呼び出します。 有効にすると、すべての子ウィンドウがタブとして表示されます。

タブ ラベルは、パラメーター tabLocationの設定に応じて、フレームの上部または下部に配置できます。 CMFCTabCtrl::LOCATION_BOTTOM (既定の設定) またはCMFCTabCtrl::LOCATION_TOPを指定できます。

bTabCustomTooltipsがTRUEされている場合、AFX_WM_ON_GET_TAB_TOOLTIP メッセージがメイン フレーム ウィンドウに送信されます。 コードでこのメッセージを処理し、MDI タブのカスタム ヒントをフレームワークに提供できます。

例

次の例は、MDITabsDemo サンプル: MFC Tabbed MDI アプリケーションでEnableMDITabsを使用する方法を示しています。

void CMainFrame::UpdateMDITabs(BOOL bResetMDIChild)
{
   CMDITabInfo params;
   HWND hwndActive = NULL;

   switch (theApp.m_Options.m_nMDITabsType)
   {
   case CMDITabOptions::None:
   {
      BOOL bCascadeMDIChild = FALSE;

      if (IsMDITabbedGroup())
      {
         EnableMDITabbedGroups(FALSE, params);
         bCascadeMDIChild = TRUE;
      }
      else if (AreMDITabs())
      {
         EnableMDITabs(FALSE);
         bCascadeMDIChild = TRUE;
      }

      if (bCascadeMDIChild)
      {
         // CMDIClientAreaWnd m_wndClientArea
         hwndActive = (HWND)m_wndClientArea.SendMessage(WM_MDIGETACTIVE);
         m_wndClientArea.PostMessage(WM_MDICASCADE);
         m_wndClientArea.UpdateTabs(false);
         m_wndClientArea.SetActiveTab(hwndActive);
         ::BringWindowToTop(hwndActive);
      }
   }
   break;

   case CMDITabOptions::MDITabsStandard:
      hwndActive = (HWND)m_wndClientArea.SendMessage(WM_MDIGETACTIVE);
      m_wndClientArea.PostMessage(WM_MDIMAXIMIZE, LPARAM(hwndActive), 0L);
      ::BringWindowToTop(hwndActive);

      EnableMDITabs(TRUE, theApp.m_Options.m_bMDITabsIcons, theApp.m_Options.m_bTabsOnTop ? CMFCTabCtrl::LOCATION_TOP : CMFCTabCtrl::LOCATION_BOTTOM, theApp.m_Options.m_nTabsStyle);

      GetMDITabs().EnableAutoColor(theApp.m_Options.m_bTabsAutoColor);
      GetMDITabs().EnableTabDocumentsMenu(theApp.m_Options.m_bMDITabsDocMenu);
      GetMDITabs().EnableTabSwap(theApp.m_Options.m_bDragMDITabs);
      GetMDITabs().SetTabBorderSize(theApp.m_Options.m_nMDITabsBorderSize);
      GetMDITabs().SetFlatFrame(theApp.m_Options.m_bFlatFrame);
      GetMDITabs().EnableCustomToolTips(theApp.m_Options.m_bCustomTooltips);
      GetMDITabs().EnableCustomToolTips(theApp.m_Options.m_bCustomTooltips);
      GetMDITabs().EnableActiveTabCloseButton(theApp.m_Options.m_bActiveTabCloseButton);
      break;

CMDIFrameWndEx::EnableMDITabsLastActiveActivation

ユーザーが現在のタブを閉じるときに、最後にアクティブなタブを開くかどうかを指定します。

void EnableMDITabsLastActiveActivation(BOOL bLastActiveTab=TRUE);

パラメーター

bLastActiveTab
[in] TRUE場合は、最後にアクティブなタブのアクティブ化を有効にします。 FALSE場合は、最後にアクティブなタブのアクティブ化を無効にします。

解説

アクティブなタブを閉じるときにタブを開くには、次の 2 つの方法があります。

  • 次のタブをアクティブにします。
  • 以前にアクティブだったタブをアクティブにします。

既定の実装では、最初の方法が使用されます。

EnableMDITabsLastActiveActivationを使用して、タブのアクティブ化の 2 番目の方法を有効にします。 これは、Windows が MDI 子ウィンドウを開く方法をエミュレートします。

CMDIFrameWndEx::EnablePaneMenu

アプリケーション ウィンドウの一覧を表示するポップアップ ウィンドウ メニューの自動作成と管理を有効または無効にします。

void EnablePaneMenu(
    BOOL bEnable,
    UINT uiCustomizeCmd,
    const CString& strCustomizeLabel,
    UINT uiViewToolbarsMenuEntryID,
    BOOL bContextMenuShowsToolbarsOnly=FALSE,
    BOOL bViewMenuShowsToolbarsOnly=FALSE);

パラメーター

bEnable
[in] TRUE場合、ウィンドウ メニューの自動処理が有効になります。 FALSE場合、自動処理は無効になります。

uiCustomizeCmd
[in] Customize メニュー項目のコマンド ID。 通常、このメニュー項目はペインの一覧の末尾に追加されます。

strCustomizeLabel
[in] Customize メニュー項目に表示するテキスト (ローカライズ用)。

uiViewToolbarsMenuEntryID
[in]ウィンドウ メニューを開くツール バー メニュー項目の ID を指定します。 通常、これは View メニューの Toolbars サブメニューです。

bContextMenuShowsToolbarsOnly
[in] TRUE場合、ペイン メニューにはツール バーの一覧のみが表示されます。 FALSE場合、メニューにツールバーとドッキング バーの一覧が表示されます。

bViewMenuShowsToolbarsOnly
[in] TRUE場合、ペイン メニューにはツール バーの一覧のみが表示されます。 FALSE場合、メニューにツールバーとドッキング バーの一覧が表示されます。

解説

ポップアップ ウィンドウ メニューには、アプリケーションのペインの一覧が表示され、ユーザーは個々のペインを表示または非表示にすることができます。

例

次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでEnablePaneMenuを使用する方法を示しています。

// Enable pane context menu(list of bars + customize command):
EnablePaneMenu(TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."), ID_VIEW_TOOLBARS, FALSE, TRUE);

CMDIFrameWndEx::EnableWindowsDialog

コマンド ID が CMFCWindowsManagerDialog ダイアログ ボックスを呼び出すメニュー項目を挿入します。

void EnableWindowsDialog(
    UINT uiMenuId,
    LPCTSTR lpszMenuText,
    BOOL bShowAllways=FALSE,
    BOOL bShowHelpButton=FALSE);

void EnableWindowsDialog(
    UINT uiMenuId,
    UINT uiMenuTextResId,
    BOOL bShowAllways=FALSE,
    BOOL bShowHelpButton=FALSE);

パラメーター

uiMenuId
[in]メニューのリソース ID を指定します。

lpszMenuText
[in]アイテムのテキストを指定します。

bShowHelpButton
[in]ウィンドウ管理ダイアログ ボックスに Help ボタンを表示するかどうかを指定します。

uiMenuTextResId
[in]アイテムのテキスト文字列を含む文字列リソース識別子。

解説

このメソッドを使用して、コマンドが MDI 子ウィンドウ管理ダイアログ ボックス ( CMFCWindowsManagerDialog クラス) を呼び出すメニュー項目を挿入します。 新しい項目は、 uiMenuIdによって指定されたメニューに挿入されます。 WM_CREATE メッセージを処理するときにEnableWindowsDialogを呼び出します。

例

次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでEnableWindowsDialogを使用する方法を示しています。

// Enable windows manager:
EnableWindowsDialog(ID_WINDOW_MANAGER, _T("Windows..."), TRUE);

CMDIFrameWndEx::GetActivePopup

現在表示されているポップアップ メニューへのポインターを返します。

CMFCPopupMenu* GetActivePopup() const;

戻り値

アクティブなポップアップ メニューへのポインター。ポップアップ メニューがアクティブでない場合に NULL します。

解説

現在表示されている CMFCPopupMenu クラス オブジェクトへのポインターを取得するには、この関数を使用します。

CMDIFrameWndEx::GetDefaultResId

MDI フレーム ウィンドウの共有リソースの ID を返します。

UINT GetDefaultResId() const;

戻り値

リソース ID 値。 フレーム ウィンドウにメニュー バーがない場合は 0。

解説

このメソッドは、MDI フレーム ウィンドウが CFrameWnd::LoadFrameによって読み込まれたときに指定されたリソース ID を返します。

CMDIFrameWndEx::GetMDITabGroups

MDI タブ付きウィンドウの一覧を返します。

const CObList& GetMDITabGroups() const;

戻り値

タブ付きウィンドウの一覧を含む CObList クラス オブジェクトへの参照。 リストを保存または変更しないでください。

解説

タブ付きウィンドウの一覧にアクセスするには、このメソッドを使用します。 個々のタブ付きウィンドウのパラメーターを変更またはクエリする場合に役立ちます。

CMDIFrameWndEx::GetMDITabs

下線付きのタブ付きウィンドウへの参照を返します。

CMFCTabCtrl& GetMDITabs();

戻り値

下線付きのタブ付きウィンドウへの参照。

CMDIFrameWndEx::GetMDITabsContextMenuAllowedItems

MDI タブ付きグループ機能が有効な場合に有効な操作を決定するフラグの組み合わせを返します。

DWORD GetMDITabsContextMenuAllowedItems();

戻り値

次のフラグのビットごとの "or" (|) の組み合わせ。

  • AFX_MDI_CREATE_VERT_GROUP - 垂直タブ グループを作成できます。
  • AFX_MDI_CREATE_HORZ_GROUP - 水平タブ グループを作成できます。
  • AFX_MDI_CAN_MOVE_PREV - タブを前のタブ グループに移動できます。
  • AFX_MDI_CAN_MOVE_NEXT - タブを次のタブ グループに移動できます。

解説

MDI タブ付きグループ機能が有効になっている場合は、特定のウィンドウのタブで許可される操作を把握しておく必要があります。 このメソッドは、タブ付きウィンドウの現在のレイアウトを分析し、ショートカット メニューなどのビルドに使用できるフラグの組み合わせを返します。

すべてのタブ付きウィンドウが垂直方向に配置されている場合、またはタブ付きウィンドウが 1 つしかない場合は、新しい垂直タブ グループを作成できます。

すべてのタブ付きウィンドウが水平方向に配置されている場合、またはタブ付きウィンドウが 1 つしかない場合は、新しい水平タブ グループを作成できます。

タブ付きウィンドウに複数のタブがある場合にのみ、タブを前のグループに移動できます。

タブを次のグループに移動できるのは、タブ付きウィンドウに複数のタブがある場合のみです。

CMDIFrameWndEx::GetMenuBar

フレーム ウィンドウにアタッチされているメニュー バー オブジェクトへのポインターを返します。

const CMFCMenuBar* GetMenuBar() const;

戻り値

メニュー バー オブジェクトへのポインター。

CMDIFrameWndEx::GetPane

指定したコントロール ID を持つペインへのポインターを返します。

CBasePane* GetPane(UINT nID);

パラメーター

nID
[入力] コントロール ID。

戻り値

指定したコントロール ID を持つペインへのポインター (存在する場合)。 それ以外の場合は NULL。

CMDIFrameWndEx::GetRibbonBar

フレームのリボン バー コントロールが取得されます。

CMFCRibbonBar* GetRibbonBar();

戻り値

フレームの CMFCRibbonBar クラス へのポインター。

解説

CMDIFrameWndEx::GetTearOffBars

破棄メニューの一覧を返します。

const CObList& GetTearOffBars() const;

戻り値

破棄状態にあるCPane派生オブジェクトへのポインターのコレクションを含むCObList クラス オブジェクトへの参照。

解説

CMDIFrameWndEx は、ティアオフ メニューのコレクションを保持します。 このメソッドを使用して、この一覧への参照を取得します。

CMDIFrameWndEx::GetToolbarButtonToolTipText

アプリケーションでツール バーのボタンのツールヒントを表示するときに、フレームワークによって呼び出されます。

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton* pButton,
    CString& strTTText);

パラメーター

pButton
[入力] ツール バーのボタンへのポインター。

strTTText
[入力] ボタンに表示するツールヒントのテキスト。

戻り値

TRUE ヒントが表示されている場合は 。 それ以外の場合 FALSE。

解説

CMDIFrameWndEx::InsertPane

指定されたペインがドッキング マネージャーに登録されます。

BOOL InsertPane(
    CBasePane* pControlBar,
    CBasePane* pTarget,
    BOOL bAfter=TRUE);

パラメーター

pControlBar
[in]挿入するペインへのポインター。

pTarget
[in]ペインを挿入する前または後のペインへのポインター。

bAfter
[in] TRUE場合、 pControlBar は pTargetの後に挿入されます。 FALSE場合は、pTargetの前にpControlBarが挿入されます。

戻り値

TRUE メソッドがウィンドウを正常に登録した場合は、ペインがドッキング マネージャーに既に登録されているかどうかを FALSE します。

解説

このメソッドを使用して、 pControlBarで指定されたウィンドウについてドッキング マネージャーに通知します。 ドッキング マネージャーは、ペインの配置とドッキング マネージャーの内部リスト内の位置に従って、このペインを配置します。

CMDIFrameWndEx::IsFullScreen

フレーム ウィンドウが全画面表示モードであるかどうかを判断します。

BOOL IsFullScreen() const;

戻り値

TRUE フレームウィンドウが全画面表示モードの場合。それ以外の場合は FALSE。

解説

CMDIFrameWndEx::EnableFullScreenMode メソッドを呼び出すと、全画面表示モードを設定できます。

CMDIFrameWndEx::IsMDITabbedGroup

MDI タブ付きグループ機能を有効にするかどうかを指定します。

BOOL IsMDITabbedGroup() const;

戻り値

TRUE MDI タブ付きグループ機能が有効になっている場合。それ以外の場合は FALSE。

解説

通常の MDI タブまたは MDI タブ付きグループ機能が有効になっているかどうかを確認するには、 CMDIFrameWndEx::AreMDITabsを使用します。

CMDIFrameWndEx::IsMemberOfMDITabGroup

指定したタブ付きウィンドウが、MDI タブ付きグループ内のウィンドウの一覧に含まれているかどうかを判断します。

BOOL IsMemberOfMDITabGroup(CWnd* pWnd);

パラメーター

pWnd
[in]タブ付きウィンドウへのポインター。

戻り値

TRUE 指定されたタブ付きウィンドウが、MDI タブ付きグループを形成するタブ付きウィンドウの一覧にある場合。 それ以外の場合は FALSE。

CMDIFrameWndEx::IsMenuBarAvailable

フレーム ウィンドウにメニュー バーがあるかどうかを指定します。

BOOL IsMenuBarAvailable() const;

戻り値

TRUE メニュー バー オブジェクトへのポインターが NULLされていない場合は a0/& FALSE。それ以外の場合は。

CMDIFrameWndEx::IsPointNearDockSite

指定されたポイントがドッキング サイトに近いかどうかを決定します。

BOOL IsPointNearDockSite(
    CPoint point,
    DWORD& dwBarAlignment,
    BOOL& bOuterEdge) const;

パラメーター

point
[in]画面座標内の指定したポイント。

dwBarAlignment
[入力] ポイントが近くにある端が示されます。 使用可能な値は、 CBRS_ALIGN_LEFT、 CBRS_ALIGN_RIGHT、 CBRS_ALIGN_TOP、および CBRS_ALIGN_BOTTOM

bOuterEdge
[入力] TRUE 点がドックサイトの外側の境界線の近くにある場合。それ以外の場合 FALSE 。

戻り値

TRUE ポイントがドック サイトの近くにある場合。それ以外の場合は FALSE。

解説

ドッキング マネージャーで設定された感度内にある場合、ポイントはドッキング サイトの近くにあります。 既定の感度は 15 ピクセルです。

CMDIFrameWndEx::IsPrintPreview

フレーム ウィンドウが印刷プレビュー モードかどうかを決定します。

BOOL IsPrintPreview();

戻り値

TRUE フレーム ウィンドウが印刷プレビュー モードの場合。それ以外の場合は FALSE。

解説

CMDIFrameWndEx::LoadFrame

リソース情報からフレーム ウィンドウを作成します。

virtual BOOL LoadFrame(
    UINT nIDResource,
    DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,
    CWnd* pParentWnd = NULL,
    CCreateContext* pContext = NULL);

パラメーター

nIDResource
[in]フレーム ウィンドウに関連付けられている共有リソースの ID。

dwDefaultStyle
[in]フレーム ウィンドウのスタイル。

pParentWnd
[in]フレームの親へのポインター。

pContext
[in] CCreateContext 構造体へのポインター。 このパラメーターは、NULL に設定できます。

戻り値

TRUE メソッドが成功した場合は a0/& FALSE。

CMDIFrameWndEx::LoadMDIState

MDI タブ付きグループの指定されたレイアウトと、以前に開いたドキュメントの一覧を読み込みます。

virtual BOOL LoadMDIState(LPCTSTR lpszProfileName);

パラメーター

lpszProfileName
[in]プロファイル名を指定します。

戻り値

TRUE 読み込みが成功した場合。読み込みに失敗した場合、または読み込むデータがない場合に FALSE します。

解説

MDI タブとグループの状態と、開いているドキュメントの一覧を読み込むか保存するには、次の操作を行います。

  • メイン フレームが閉じているときに CMDIFrameWndEx::SaveMDIState を呼び出す
  • メイン フレームの作成時に CMDIFrameWndEx::LoadMDIState を呼び出します。 この呼び出しの推奨される場所は、メイン フレームが初めて表示される前です。 LoadMDIStateの呼び出しの後にCWinAppEx::ReloadWindowPlacement (pMainFrame);を追加pMainFrame->LoadFrame (IDR_MAINFRAME);.前にCWinAppEx::EnableLoadWindowPlacement (FALSE);を追加して、レジストリに格納された位置にメイン フレームを表示します。
  • アプリケーションにファイルとして保存されていないドキュメントが表示される場合は、CMDIChildWndEx 派生クラスのGetDocumentNameをオーバーライドします。 返された文字列は、ドキュメント識別子としてレジストリに保存されます。 CMDIChildWndEx::GetDocumentNameの基本実装は、CDocument::GetPathNameから取得した値を返します。
  • CMDIFrameWndEx::CreateDocumentWindowをオーバーライドして、ドキュメントがレジストリから読み込まれるときにドキュメントを正しく作成します。 最初のパラメーターは、返 GetDocumentName 文字列です。

例

次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでLoadMDIStateを使用する方法を示しています。

// Parse command line for standard shell commands, DDE, file open
CCommandLineInfo cmdInfo;
ParseCommandLine(cmdInfo);

if (cmdInfo.m_nShellCommand == CCommandLineInfo::FileNew)
{
   if (!pMainFrame->LoadMDIState(GetRegSectionPath()))
   {
      m_pStartDocTemplate->OpenDocumentFile(NULL);
   }
}
else
{
   // Dispatch commands specified on the command line
   if (!ProcessShellCommand(cmdInfo))
   {
      return FALSE;
   }
}

CMDIFrameWndEx::MDITabMoveToNextGroup

アクティブなタブを現在アクティブなタブ付きウィンドウから、次または前のタブ付きグループに移動します。

void MDITabMoveToNextGroup(BOOL bNext=TRUE);

パラメーター

bNext
[in] TRUE場合は、タブを次のタブ付きグループに移動します。 FALSE場合は、前のタブ付きグループに移動します。

CMDIFrameWndEx::MDITabNewGroup

1 つのウィンドウを持つ新しいタブ付きグループを作成します。

void MDITabNewGroup(BOOL bVert=TRUE);

パラメーター

bVert
[in]新しいグループの配置を指定します。 TRUE場合、新しいグループは垂直方向に配置されます。 FALSE場合、新しいグループは水平方向に配置されます。

解説

この関数を使用して、新しいタブ付きウィンドウ (新しいタブ付きグループ) を作成し、最初のタブを追加します。

例

次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでMDITabNewGroupを使用する方法を示しています。

void CMainFrame::OnMdiNewHorzTabGroup()
{
   MDITabNewGroup(FALSE);
}

CMDIFrameWndEx::m_bCanConvertControlBarToMDIChild

ドッキング ウィンドウを MDI 子ウィンドウに変換できるかどうかを指定します。

BOOL m_bCanConvertControlBarToMDIChild;

解説

ドッキング コントロール バーを MDI 子ウィンドウに変換できるかどうかを示します。 このフラグが TRUEされている場合、ユーザーが Tabbed Document コマンドを選択すると、フレームワークによって変換が自動的に処理されます。 フラグは保護されているため、CMDIFrameWndEx派生クラスのコンストラクターでm_bCanConvertControlBarToMDIChildを設定するか、CanConvertControlBarToMDIChildをオーバーライドすることによって、このオプションを明示的に有効にする必要があります。

既定値は FALSE です。

例

次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでm_bCanConvertControlBarToMDIChildを使用する方法を示しています。

CMainFrame::CMainFrame()
{
   CMFCPopupMenu::SetForceShadow(TRUE);
   m_bCanConvertControlBarToMDIChild = TRUE;
}

CMDIFrameWndEx::m_bDisableSetRedraw

MDI 子ウィンドウの再描画の最適化を有効または無効にします。

AFX_IMPORT_DATA static BOOL m_bDisableSetRedraw;

解説

既定値は TRUE です。

MDI 子の再描画を最適化する場合は、このフラグを FALSE に設定します。 この場合、アプリケーションがアクティブなタブを変更するときに、フレームワークによってメイン フレームの SetRedraw (FALSE) が呼び出されます。

このフラグは、望ましくない影響 (表示されるバックグラウンド アプリケーションなど) を引き起こす可能性があります。 したがって、MDI タブのアクティブ化中に目立つちらつきが発生する場合にのみ、既定値を変更することをお勧めします。

CMDIFrameWndEx::NegotiateBorderSpace

OLE のインプレース アクティブ化中に、フレーム ウィンドウ内の罫線スペースをネゴシエートします。

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

パラメーター

nBorderCmd
[in]列挙型 CFrameWnd::BorderCmdから次のいずれかの値が含まれています。

  • borderGet = 1
  • borderRequest = 2
  • borderSet = 3

lpRectBorder
[入力、出力]境界線の座標を指定する RECT 構造体 または CRect クラス オブジェクトへのポインター。

戻り値

メソッドが成功した場合は 0 以外、それ以外の場合は 0。

解説

このメソッドは、OLE 罫線スペース ネゴシエーションの実装です。

CMDIFrameWndEx::OnCloseDockingPane

ユーザーがドッキング可能ウィンドウの Close ボタンをクリックすると、フレームワークによって呼び出されます。

virtual BOOL OnCloseDockingPane(CDockablePane* pWnd);

パラメーター

pWnd
[in]閉じているウィンドウへのポインター。

戻り値

TRUE ドッキング ウィンドウを閉じることができる場合は 。 それ以外の場合は FALSE。

解説

ドッキング ウィンドウの非表示を処理するには、このメソッドをオーバーライドします。 ドッキング ウィンドウが非表示にならないようにする場合は、 FALSE を返します。

既定の実装では何も行われないため、 TRUEが返されます。

CMDIFrameWndEx::OnCloseMiniFrame

ユーザーがフローティング ミニフレーム ウィンドウの Close ボタンをクリックしたときにフレームワークによって呼び出されます。

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd*);

パラメーター

pWnd
[in]閉じているミニフレーム ウィンドウへのポインター。

戻り値

TRUE 浮動ミニフレーム ウィンドウを閉じることができる場合は 〗。 それ以外の場合は FALSE。

解説

浮動ミニフレーム ウィンドウの非表示を処理するには、このメソッドをオーバーライドします。 フローティング ミニフレーム ウィンドウが非表示にならないようにする場合は、 FALSE を返します。

既定の実装では何も行われないため、 TRUEが返されます。

CMDIFrameWndEx::OnClosePopupMenu

アクティブなポップアップ メニューが WM_DESTROY メッセージを処理するときにフレームワークによって呼び出されます。

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

パラメーター

pMenuPopup
[in]ポップアップ メニューへのポインター。

解説

MDI フレーム ウィンドウに属オブジェクトがメッセージWM_DESTROY処理するときに、CMFCPopupMenu クラスからの通知を処理する場合は、このメソッドをオーバーライドします。

CMDIFrameWndEx::OnCmdMsg

コマンド メッセージのルーティングとディスパッチ、およびコマンド ユーザー インターフェイス オブジェクトの更新を行うために、フレームワークによって呼び出されます。

virtual BOOL OnCmdMsg(
    UINT nID,
    int nCode,
    void* pExtra,
    AFX_CMDHANDLERINFO* pHandlerInfo);

パラメーター

nID
[入力] コマンド ID。

nCode
[in]コマンド通知コードを識別します。 nCodeの値の詳細については、CCmdTarget::OnCmdMsgを参照してください。

pExtra
[in] nCodeの値に従って使用されます。 pExtra の詳細については、「CCmdTarget::OnCmdMsg」を参照してください。

pHandlerInfo
[入力、出力]通常、このパラメーターは NULLする必要があります。 NULLしない場合は、OnCmdMsgコマンドをディスパッチするのではなく、pHandlerInfo構造体のpTargetとpmfメンバーを入力します。

戻り値

メッセージが処理される場合は 0 以外。それ以外の場合は 0。

CMDIFrameWndEx::OnDrawMenuImage

メニュー項目に関連付けられているイメージが描画されるときに、フレームワークによって呼び出されます。

virtual BOOL OnDrawMenuImage(
    CDC* pDC,
    const CMFCToolBarMenuButton* pMenuButton,
    const CRect& rectImage);

パラメーター

pDC
[in]デバイス コンテキストへのポインター。

pMenuButton
[入力] メニュー ボタンへのポインター。

rectImage
[in]画像の外接する四角形。

戻り値

TRUE メソッドがイメージを描画する場合は 。 既定の実装では、FALSE が返されます。

解説

CMDIFrameWndEx派生オブジェクトが所有するメニュー バーに属するメニュー項目のイメージ レンダリングをカスタマイズする場合は、このメソッドをオーバーライドします。 既定の実装では、何も行われません。

CMFCPopupMenuがWM_PAINT メッセージを処理するときにフレームワークによって呼び出されます。

virtual void OnDrawMenuLogo(
    CDC*,
    CMFCPopupMenu*,
    const CRect&);

解説

この関数をオーバーライドして、 CMDIFrameWndEx派生オブジェクトが所有するメニュー バーに属するポップアップ メニューにロゴを表示します。 既定の実装では、何も行われません。

CMDIFrameWndEx::OnEraseMDIClientBackground

MDI フレーム ウィンドウが WM_ERASEBKGND メッセージを処理するときにフレームワークによって呼び出されます。

virtual BOOL OnEraseMDIClientBackground(CDC*);

戻り値

TRUE アプリケーションがメッセージを処理し、バックグラウンドを消去する場合は 。

解説

CMDIFrameWndEx派生クラスでWM_ERASEBKGND メッセージを処理する場合は、このメンバー関数をオーバーライドします。

CMDIFrameWndEx::OnMenuButtonToolHitTest

CMFCToolBarButtonobject がWM_NCHITTEST メッセージを処理するときにフレームワークによって呼び出されます。

virtual BOOL OnMenuButtonToolHitTest(
    CMFCToolBarButton* pButton,
    TOOLINFO* pTI);

パラメーター

pButton
[in]ツール バー ボタン。

pTI
[out] TOOLINFO 構造体へのポインター。

戻り値

TRUE アプリケーションが pTI パラメーターを入力する場合は。 既定の実装では、FALSE が返されます。

解説

特定のメニュー項目に関する情報をヒントに提供する場合は、このメソッドをオーバーライドします。 既定の実装では、何も行われません。

CMDIFrameWndEx::OnMoveMiniFrame

ミニフレーム ウィンドウを移動するためにフレームワークによって呼び出されます。

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

パラメーター

pFrame
[入力] ミニフレーム ウィンドウへのポインター。

戻り値

TRUE メソッドが成功した場合は a0/& FALSE。

CMDIFrameWndEx::OnSetPreviewMode

アプリケーションのメイン フレーム ウィンドウの印刷プレビュー モードを設定します。

virtual void OnSetPreviewMode(
    BOOL bPreview,
    CPrintPreviewState* pState);

パラメーター

bPreview
[in] TRUE場合は、印刷プレビュー モードを設定します。 FALSE場合は、プレビュー モードを取り消します。

pState
[in] CPrintPreviewState 構造体へのポインター。

解説

このメソッドは、CFrameWnd::OnSetPreviewMode をオーバーライドします。

CMDIFrameWndEx::OnShowCustomizePane

クイック カスタマイズ ウィンドウがアクティブになったときにフレームワークによって呼び出されます。

virtual BOOL OnShowCustomizePane(
    CMFCPopupMenu* pMenuPane,
    UINT uiToolbarID);

パラメーター

pMenuPane
[in][クイック カスタマイズ] ウィンドウへのポインター。

uiToolbarID
[in]カスタマイズするツール バーのコントロール ID。

戻り値

このメソッドは常に TRUE を返します。

解説

[クイック カスタマイズ] ウィンドウは、ユーザーがツール バーの [ Customize をクリックしたときに開くメニューです。

[クイック カスタマイズ] ウィンドウで変更を加えるために、派生クラスでこのメソッドをオーバーライドします。

CMDIFrameWndEx::OnShowMDITabContextMenu

いずれかのタブにショートカット メニューが表示される前に、フレームワークによって呼び出されます。 MDI タブ付きグループにのみ有効です。

virtual BOOL OnShowMDITabContextMenu(
    CPoint point,
    DWORD dwAllowedItems,
    BOOL bTabDrop);

パラメーター

point
[in]画面座標内のメニューの位置。

dwAllowedItems
[in]現在のタブで許可されているアクションを示すフラグのビットごとの "or" (|) の組み合わせ。

  • AFX_MDI_CREATE_VERT_GROUP - 垂直タブ グループを作成できます。
  • AFX_MDI_CREATE_HORZ_GROUP - 水平タブ グループを作成できます。
  • AFX_MDI_CAN_MOVE_PREV - タブを前のタブ グループに移動できます。
  • AFX_MDI_CAN_MOVE_NEXT - タブを次のタブ グループに移動できます。
  • AFX_MDI_CAN_BE_DOCKED - タブ付きドキュメントをドッキング状態に切り替えます (タブ付きドキュメントにのみ関連します)。

bTabDrop
[入力] TRUE をクリックすると、タブを別のタブ付きグループにドラッグした結果としてメニューが表示されます。 FALSE をクリックすると、現在アクティブなタブにショートカット メニューとしてメニューが表示されます。

戻り値

CMDIFrameWndEx派生クラスでこのメソッドをオーバーライドします。

解説

OnShowMDITabContextMenuを処理しない場合、ショートカット メニューは表示されません。 この関数は、MDI タブ付きグループ機能を有効にするとMFC アプリケーション ウィザードによって生成されます。

例

次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでOnShowMDITabContextMenuを使用する方法を示しています。

BOOL CMainFrame::OnShowMDITabContextMenu(CPoint point, DWORD dwAllowedItems, BOOL bDrop)
{
   CMenu menu;
   VERIFY(menu.LoadMenu(bDrop ? IDR_POPUP_DROP_MDITABS : IDR_POPUP_MDITABS));

   CMenu* pPopup = menu.GetSubMenu(0);
   ASSERT(pPopup != NULL);

   if ((dwAllowedItems & AFX_MDI_CREATE_HORZ_GROUP) == 0)
   {
      pPopup->DeleteMenu(ID_MDI_NEW_HORZ_TAB_GROUP, MF_BYCOMMAND);
   }

   if ((dwAllowedItems & AFX_MDI_CREATE_VERT_GROUP) == 0)
   {
      pPopup->DeleteMenu(ID_MDI_NEW_VERT_GROUP, MF_BYCOMMAND);
   }

   if ((dwAllowedItems & AFX_MDI_CAN_MOVE_NEXT) == 0)
   {
      pPopup->DeleteMenu(ID_MDI_MOVE_TO_NEXT_GROUP, MF_BYCOMMAND);
   }

   if ((dwAllowedItems & AFX_MDI_CAN_MOVE_PREV) == 0)
   {
      pPopup->DeleteMenu(ID_MDI_MOVE_TO_PREV_GROUP, MF_BYCOMMAND);
   }

   if ((dwAllowedItems & AFX_MDI_CAN_BE_DOCKED) == 0)
   {
      pPopup->DeleteMenu(ID_MDI_TABBED_DOCUMENT, MF_BYCOMMAND);
   }

   CMFCPopupMenu* pPopupMenu = new CMFCPopupMenu;
   pPopupMenu->SetAutoDestroy(FALSE);
   pPopupMenu->Create(this, point.x, point.y, pPopup->GetSafeHmenu());

   return TRUE;
}

CMDIFrameWndEx::OnShowPanes

ペインを表示または非表示するために、フレームワークによって呼び出されます。

virtual BOOL OnShowPanes(BOOL bShow);

パラメーター

bShow
[入力] TRUE ペインを表示するには、ペインを非表示にする FALSE します。

戻り値

TRUEこのメソッドの呼び出しの結果としてペインの状態が変化する場合は、ペインが既に bShow で指定された状態にある場合にFALSEします。 たとえば、ペインが非表示で、 bShow が FALSE場合、戻り値は FALSE。

解説

既定の実装では、最上位レベルのフレーム ウィンドウからツール バーが削除されます。

CDockingManager::m_bHideDockingBarsInContainerModeがTRUEされている場合 (既定値)、ドッキング ウィンドウはすべて非表示になります。

CMDIFrameWndEx::OnShowPopupMenu

ポップアップ メニューを開いたときにフレームワークによって呼び出されます。

virtual BOOL OnShowPopupMenu(CMFCPopupMenu*);

戻り値

TRUE ポップアップ メニューが表示される場合は〘。 それ以外の場合は FALSE。 既定の実装では、TRUE が返されます。

解説

ポップアップ メニューのアクティブ化時に特別な処理を実装する場合は、このメソッドをオーバーライドします。 たとえば、通常のメニュー項目をカラー メニュー ボタンに変更する場合は、ティアオフ バーなどを設定します。

既定の実装では、何も行われません。

CMDIFrameWndEx::OnSizeMDIClient

クライアント MDI ウィンドウのサイズが変更されたときにフレームワークによって呼び出されます。

virtual void OnSizeMDIClient(
    const CRect& rectOld,
    const CRect& rectNew);

パラメーター

rectOld
[in]MDI クライアント ウィンドウの現在のサイズ。

rectNew
[in]MDI クライアント ウィンドウの新しいサイズ。

解説

CMDIFrameWndEx::OnTearOffMenu

ティアオフ バーのあるメニューがアクティブ化されるときにフレームワークによって呼び出されます。

virtual BOOL OnTearOffMenu(
    CMFCPopupMenu* pMenuPopup,
    CPane* pBar);

パラメーター

pMenuPopup
[in]ポップアップ メニューへのポインター。

pBar
[in]ティアオフ バーへのポインター。

戻り値

TRUE ティアオフバー付きのポップアップメニューをアクティブ化できるようにする場合。それ以外の場合は FALSE。 既定値は、TRUE です。

解説

ティアオフ バーの特別なセットアップを実装する場合は、この関数をオーバーライドします。 既定の実装では、何も行われません。

CMDIFrameWndEx::OnUpdateFrameMenu

フレーム メニューを更新するためにフレームワークによって呼び出されます。

virtual void OnUpdateFrameMenu(HMENU hMenuAlt);

パラメーター

hMenuAlt
[in]メニューへのハンドル。

CMDIFrameWndEx::PaneFromPoint

指定したポイントが含まれるドッキング ウィンドウが返されます。

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    bool bExactBar,
    CRuntimeClass* pRTCBarType) const;

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    DWORD& dwAlignment,
    CRuntimeClass* pRTCBarType) const;

パラメーター

point
[in]ポイント (画面座標)。

nSensitivity
[in]チェックされた各ペインのウィンドウの四角形は、この値によってすべての方向に拡大されます。

bExactBar
[in] TRUE場合、 nSensitivity パラメーターは無視されます。

pRTCBarType
[in] NULL以外の場合、メソッドは指定した型のペインのみを反復処理します。

dwAlignment
[out]ペインが見つかった場合、このパラメーターは、指定したポイントに最も近いペインの側を指定します。

戻り値

ドッキング ウィンドウへのポインター。コントロールにpointで指定されたポイントが含まれている場合はNULL。

解説

呼び出しは、 CDockingManager クラスにリダイレクトされます。 詳細については、CDockingManager::ControlBarFromPointを参照してください。

CMDIFrameWndEx::RecalcLayout

フレーム ウィンドウのレイアウトを再計算するためにフレームワークによって呼び出されます。

virtual void RecalcLayout(BOOL bNotify = TRUE);

パラメーター

bNotify
[in]フレーム ウィンドウのアクティブなインプレース項目がレイアウト変更の通知を受け取るかどうかを決定します。 TRUE場合はアイテムに通知されます。それ以外の場合はFALSE。

解説

このメソッドは、 CFrameWnd::RecalcLayout をオーバーライドします。

CMDIFrameWndEx::RemovePaneFromDockManager

ペインを登録解除してドッキング マネージャーから削除します。

void RemovePaneFromDockManager(
    CBasePane* pControlBar,
    BOOL bDestroy,
    BOOL bAdjustLayout,
    BOOL bAutoHide,
    CBasePane* pBarReplacement);

パラメーター

pControlBar
[入力] 削除されるペインへのポインター。

bDestroy
[入力] TRUE 削除されたウィンドウを破棄します。 FALSE を使用して破棄しないようにします。

bAdjustLayout
[入力] TRUE をクリックすると、ドッキング レイアウトがすぐに調整されます。 FALSE場合、調整は、他の理由で再描画イベントが発生した場合にのみ発生します (ユーザーがウィンドウのサイズを変更したり、メイン フレームをドラッグしたりします)。

bAutoHide
[入力] TRUE をクリックして、自動非表示ペインの一覧からペインを削除します。 FALSE をクリックして、通常のペインの一覧からペインを削除します。

pBarReplacement
[入力] 削除されたペインを置き換えるペインへのポインター。

解説

ドッキング レイアウトに参加するには、各ペインをドッキング マネージャーに登録する必要があります。 CMDIFrameWndEx::AddPaneまたはCMDIFrameWndEx::InsertPaneを使用してペインを登録します。

ウィンドウがフレーム ウィンドウのドッキング レイアウトの一部ではなくなった場合は、このメソッドを使用します。

CMDIFrameWndEx::SaveMDIState

MDI タブ付きグループの現在のレイアウトと、以前に開いたドキュメントの一覧を保存します。

virtual BOOL SaveMDIState(LPCTSTR lpszProfileName);

パラメーター

lpszProfileName
[in]プロファイル名を指定します。

戻り値

TRUE 保存に成功した場合。保存に失敗した場合に FALSE します。

解説

MDI タブとグループの状態と、開いているドキュメントの一覧を読み込むか保存するには、次の操作を行います。

  • メイン フレームが閉じているときに SaveMDIState を呼び出す
  • メイン フレームの作成時に CMDIFrameWndEx::LoadMDIState を呼び出します。 この呼び出しで推奨される場所は、メイン フレームが初めて表示される前です。
  • 前に CWinAppEx::EnableLoadWindowPlacement(FALSE); を呼び出す pMainFrame->LoadFrame (IDR_MAINFRAME);
  • LoadMDIState後にCWinAppEx::ReloadWindowPlacement(pMainFrame)を呼び出して、レジストリに格納された位置にメイン フレームを表示します。
  • アプリケーションにファイルとして保存されていないドキュメントが表示される場合は、CMDIChildWndEx 派生クラスのGetDocumentNameをオーバーライドします。 返された文字列は、ドキュメント識別子としてレジストリに保存されます。 詳細については、CMDIChildWndEx::GetDocumentNameを参照してください。
  • レジストリからドキュメントが読み込まれるときにドキュメントを正しく作成するには、 CMDIFrameWndEx::CreateDocumentWindow をオーバーライドします。 CreateDocumentWindowするパラメーターは、前に返GetDocumentName文字列です。

例

次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでSaveMDIStateを使用する方法を示しています。

void CMainFrame::OnClose()
{
   SaveMDIState(theApp.GetRegSectionPath());
   CMDIFrameWndEx::OnClose();
}

CMDIFrameWndEx::SetPrintPreviewFrame

印刷プレビュー フレーム ウィンドウが設定されます。

void SetPrintPreviewFrame(CFrameWnd* pWnd);

パラメーター

pWnd
[入力] 印刷プレビュー フレーム ウィンドウへのポインター。

解説

CMDIFrameWndEx::SetupToolbarMenu

ダミー項目をユーザー定義項目に置き換えて、ツール バー オブジェクトを変更します。

void SetupToolbarMenu(
    CMenu& menu,
    const UINT uiViewUserToolbarCmdFirst,
    const UINT uiViewUserToolbarCmdLast);

パラメーター

menu
[in]変更する CMenu クラス オブジェクトへの参照。

uiViewUserToolbarCmdFirst
[入力] 最初のユーザー定義コマンドを指定します。

uiViewUserToolbarCmdLast
[入力] 最後のユーザー定義コマンドを指定します。

CMDIFrameWndEx::ShowFullScreen

メイン フレームを通常モードから全画面表示モードに切り替えます。

void ShowFullScreen();

解説

CMDIFrameWndEx::ShowPane

指定したペインが表示または非表示になります。

void ShowPane(
    CBasePane* pBar,
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

パラメーター

pBar
[in]表示または非表示にするペインへのポインター。

bShow
[入力] TRUE をクリックしてペインを表示します。 FALSE をクリックしてペインを非表示にします。

bDelay
[入力] TRUE ドッキング レイアウトの再計算を遅らせる場合は 。 FALSE をクリックすると、ドッキング レイアウトが直ちに再計算されます。

bActivate
[入力] TRUE をクリックすると、ペインがアクティブとして表示されます。 FALSE をクリックすると、ペインが非アクティブとして表示されます。

解説

ウィンドウを表示または非表示にするには、このメソッドを呼び出します。 ペインのドッキングには ShowWindow を使用しないでください。

例

次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでShowPaneを使用する方法を示しています。

void COutputList1::OnViewOutput()
{
   CBasePane* pParentBar = DYNAMIC_DOWNCAST(CBasePane, GetOwner());
   CFrameWndEx* pMainFrame = DYNAMIC_DOWNCAST(CFrameWndEx, GetTopLevelFrame());

   if (pMainFrame != NULL && pParentBar != NULL)
   {
      pMainFrame->SetFocus();
      pMainFrame->ShowPane(pParentBar, FALSE, FALSE, FALSE);
   }
}

CMDIFrameWndEx::ShowWindowsDialog

CMFCWindowsManagerDialog ボックスを作成して開きます。

void ShowWindowsDialog();

例

次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでShowWindowsDialogを使用する方法を示しています。

void CMainFrame::OnWindowManager()
{
   ShowWindowsDialog();
}

CMDIFrameWndEx::TabbedDocumentToControlBar

指定したタブ付きドキュメントをドッキング ウィンドウに変換します。

virtual BOOL TabbedDocumentToControlBar(CMDIChildWndEx* pMDIChildWnd);

パラメーター

pMDIChildWnd
ドッキング ウィンドウを含む MDI 子ウィンドウへのポインター。

戻り値

TRUE メソッドが成功した場合は、失敗時に FALSE 。

解説

タブ付きドキュメントをドッキング ウィンドウに変換するには、このメソッドを使用します。 タブ付きドキュメントは、 CMDIFrameWndEx::ControlBarToTabbedDocumentを使用して作成されている必要があります。

例

次の例は、VisualStudioDemo サンプル: MFC Visual Studio アプリケーションでTabbedDocumentToControlBarを使用する方法を示しています。

void CMainFrame::OnMdiTabbedDocument()
{
   CMDIChildWndEx* pMDIChild = DYNAMIC_DOWNCAST(CMDIChildWndEx, MDIGetActive());
   if (pMDIChild == NULL)
   {
      ASSERT(FALSE);
      return;
   }

   TabbedDocumentToControlBar(pMDIChild);
}

CMDIFrameWndEx::UpdateCaption

ウィンドウ フレーム キャプションを更新するために、フレームワークによって呼び出されます。

void UpdateCaption();

解説

CMDIFrameWndEx::UpdateMDITabbedBarsIcons

各 MDI タブ 付きペインのアイコンを設定します。

void UpdateMDITabbedBarsIcons();

CMDIFrameWndEx::WinHelp

WinHelp アプリケーションまたはコンテキスト ヘルプを起動するために、フレームワークによって呼び出されます。

virtual void WinHelp(
    DWORD dwData,
    UINT nCmd = HELP_CONTEXT);

パラメーター

dwData
[in] nCmdで指定されたヘルプの種類に必要なデータを指定します。

nCmd
[入力] 要求するヘルプの種類を指定します。 使用可能な値と、その値が dwData パラメーターに与える影響の詳細については、 WinHelpを参照してください。

解説

このメソッドは、CWnd::WinHelp をオーバーライドします。

関連項目

階層図
クラス
CMDIFrameWnd クラス
CMDIChildWndEx クラス