Share via

CMDIFrameWndEx クラス

  • [アーティクル]

Windows Multiple Document Interface (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 ユーザーがドッキング可能ウィンドウの [閉じる] ボタンをクリックすると、フレームワークによって呼び出されます。
CMDIFrameWndEx::OnCloseMiniFrame ユーザーがフローティング ミニ フレーム ウィンドウの [閉じる] ボタンをクリックしたときに、フレームワークによって呼び出されます。
CMDIFrameWndEx::OnClosePopupMenu アクティブなポップアップ メニューがメッセージを処理 WM_DESTROY するときにフレームワークによって呼び出されます。
CMDIFrameWndEx::OnCmdMsg コマンド メッセージのルーティングとディスパッチ、およびコマンド ユーザー インターフェイス オブジェクトの更新を行うために、フレームワークによって呼び出されます。
CMDIFrameWndEx::OnDrawMenuImage メニュー項目に関連付けられているイメージが描画されるときに、フレームワークによって呼び出されます。
CMDIFrameWndEx::OnDrawMenuLogo メッセージを処理WM_PAINTするときにCMFCPopupMenuフレームワークによって呼び出されます。
CMDIFrameWndEx::OnEraseMDIClientBackground MDI フレーム ウィンドウがメッセージを処理 WM_ERASEBKGND するときにフレームワークによって呼び出されます。
CMDIFrameWndEx::OnMenuButtonToolHitTest オブジェクトがメッセージを処理WM_NCHITTESTするときにCMFCToolBarButtonフレームワークによって呼び出されます。
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がウィンドウ メッセージを Windows 関数と DispatchMessage Windows 関数にディスパッチする前に変換するためにTranslateMessage使用されます。 ( 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 アプリケーションで拡張カスタマイズ機能を利用するには、アプリケーションの MDI フレーム ウィンドウ クラスをCMDIFrameWndExCMDIFrameWnd派生させます。

例

次の例では、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 タブ付きグループが有効になっています。

戻り値

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

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

解説

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

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

CMDIFrameWndEx::CanConvertControlBarToMDIChild

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

virtual BOOL CanConvertControlBarToMDIChild();

戻り値

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

解説

派生クラスでこのメソッドをオーバーライドし、タブ付きドキュメントへのドッキング ウィンドウの変換を有効にするために戻ります TRUE 。 または、次にTRUE設定CMDIFrameWndEx::m_bCanConvertControlBarToMDIChildできます。

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::EnableDockingCMDIFrameWndEx::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
[in] 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
[in] TRUE ドッキング状態の読み込みを有効にするには、 FALSE ドッキング状態の読み込みを無効にします。

解説

CMDIFrameWndEx::EnableMDITabbedGroups

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

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

パラメーター

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

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

解説

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

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

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

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

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

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_ONENOTE Microsoft OneNote タブに使用STYLE_3D_SCROLLEDします。

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

bActiveTabCloseButton
この場合 TRUE、タブ領域の 右上隅ではなく、アクティブなタブに [閉じる ] ボタンが表示されます。

解説

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

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

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

例

次の例は、MDITabsDemo サンプル: MFC タブ付き 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 つの方法があります。

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

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

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

CMDIFrameWndEx::EnablePaneMenu

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

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

パラメーター

bEnable
[in]ペイン メニューの自動処理が有効になっている場合TRUEFALSEは 、自動処理が無効になります。

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

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

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

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]ウィンドウ管理ダイアログ ボックスに [ヘルプ] ボタンを表示するかどうかを指定します。

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

解説

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

例

次の例は、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]If TRUE、 pControlBar の後 pTargetに挿入されます。 if FALSE, pControlBar が前に pTarget挿入されます。

戻り値

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場合は 〗。それ以外の場合 FALSEは 〘

CMDIFrameWndEx::IsPointNearDockSite

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

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

パラメーター

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

dwBarAlignment
[入力] ポイントが近くにある端が示されます。 指定できる値はCBRS_ALIGN_LEFT、 CBRS_ALIGN_TOPCBRS_ALIGN_RIGHTCBRS_ALIGN_BOTTOM

bOuterEdge
[in] 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 メソッドが成功した場合は 〗。それ以外の場合 FALSEは 〗。

CMDIFrameWndEx::LoadMDIState

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

virtual BOOL LoadMDIState(LPCTSTR lpszProfileName);

パラメーター

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

戻り値

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

解説

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

  • メイン フレームが閉じているときに呼び出すCMDIFrameWndEx::SaveMDIState
  • メイン フレームの作成時に呼び出CMDIFrameWndEx::LoadMDIStateします。 この呼び出しの推奨される場所は、メイン フレームが初めて表示される前です。 レジストリに格納された位置にメイン フレームを表示するLoadMDIState呼び出しの後に追加する前pMainFrame->LoadFrame (IDR_MAINFRAME);.に追加CWinAppEx::EnableLoadWindowPlacement(FALSE);CWinAppEx::ReloadWindowPlacement(pMainFrame);します。
  • ファイルとして保存されていないドキュメントがアプリケーションに表示される場合は、-派生クラスで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 子ウィンドウに変換できるかどうかを示します。 このフラグの場合、ユーザーが TRUETabbed Document コマンドを選択すると、フレームワークによって変換が自動的に処理されます。 フラグは保護されており、-derived クラスの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
[入力、出力]境界線の座標をRECTCRect指定する構造体またはクラス オブジェクトへのポインター。

戻り値

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

解説

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

CMDIFrameWndEx::OnCloseDockingPane

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

virtual BOOL OnCloseDockingPane(CDockablePane* pWnd);

パラメーター

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

戻り値

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

解説

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

既定の実装では何も実行せず、返されます TRUE。

CMDIFrameWndEx::OnCloseMiniFrame

ユーザーがフローティング ミニフレーム ウィンドウの [閉じる] ボタンをクリックすると、フレームワークによって呼び出されます。

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd*);

パラメーター

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

戻り値

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

解説

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

既定の実装では何も実行せず、返されます TRUE。

CMDIFrameWndEx::OnClosePopupMenu

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

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

パラメーター

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

解説

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

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コマンドをディスパッチするのではなく、pTarget構造体のpHandlerInfoメンバーとpmfメンバーを入力します。

戻り値

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

CMDIFrameWndEx::OnDrawMenuImage

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

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

パラメーター

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

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

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

戻り値

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

解説

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

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

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

解説

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

CMDIFrameWndEx::OnEraseMDIClientBackground

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

virtual BOOL OnEraseMDIClientBackground(CDC*);

戻り値

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

解説

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

CMDIFrameWndEx::OnMenuButtonToolHitTest

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

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

パラメーター

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

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

戻り値

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

解説

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

CMDIFrameWndEx::OnMoveMiniFrame

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

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

パラメーター

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

戻り値

TRUE メソッドが成功した場合は 〗。それ以外の場合 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 を返します。

解説

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

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

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
[in] 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
[in] TRUE をクリックしてペインを表示し、 FALSE ペインを非表示にします。

戻り値

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

解説

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

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

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]ペインが見つかった場合、このパラメーターは、指定したポイントに最も近いペインの側を指定します。

戻り値

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

解説

呼び出しはクラスに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
[in] TRUE 削除されたウィンドウを破棄します。 FALSE を使用して破棄しないようにします。

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

bAutoHide
[in] 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
[in] TRUE をクリックしてペインを表示します。 FALSE をクリックしてペインを非表示にします。

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

bActivate
[in] 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 クラス