CMDIFrameWndEx选件类

扩展 CMDIFrameWnd的功能，多文档界面 (MDI) 框架窗口的窗口。

class CMDIFrameWndEx : public CMDIFrameWnd

成员

公共方法

名称	描述
CMDIFrameWndEx::ActiveItemRecalcLayout	计算活动项的布局。
CMDIFrameWndEx::AddDockSite	未使用此方法。
CMDIFrameWndEx::AddPane	注册了停靠管理器的一个窗格。
CMDIFrameWndEx::AdjustClientArea	减少客户端区域允许边框。
CMDIFrameWndEx::AdjustDockingLayout	重新停靠的窗格布局。
CMDIFrameWndEx::AreMDITabs	确定 MDI 选项是否功能或 MDI 选项卡式组功能是否已启用。
CMDIFrameWndEx::CanCovertControlBarToMDIChild	调用由框架确定框架窗口是否可以转换停靠窗格为选项卡式文档。
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	创建一个窗口的新选项卡式组。
CMDIFrameWndEx::NegotiateBorderSpace	在 OLE 就地激活时协调在框架窗口的边框空间。
CMDIFrameWndEx::OnCloseDockingPane	调用由结构，当用户在一个停靠窗格中单击 关闭 按钮。
CMDIFrameWndEx::OnCloseMiniFrame	调用由结构，当用户在浮动 mini 框架窗口 关闭 单击按钮。
CMDIFrameWndEx::OnClosePopupMenu	调用由结构，当一个有效的弹出菜单操作 WM_DESTROY 消息。
CMDIFrameWndEx::OnCmdMsg	调用由框架路由和计划命令消息和更新命令用户界面对象。
CMDIFrameWndEx::OnDrawMenuImage	调用由结构，在与菜单项绘制图像。
CMDIFrameWndEx::OnDrawMenuLogo	调用由结构，当 CMFCPopupMenu处理 WM_PAINT 消息。
CMDIFrameWndEx::OnEraseMDIClientBackground	调用由结构，当 MDI 框架窗口处理 WM_ERASEBKGND 消息。
CMDIFrameWndEx::OnMenuButtonToolHitTest	调用由结构，当 CMFCToolBarButton对象处理 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 和 DispatchMessage windows 函数之前。 (重写 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_bCanCovertControlBarToMDIChild	确定停靠窗格是否可以转换到 MDI 子窗口。
CMDIFrameWndEx::m_bDisableSetRedraw	启用或禁用重绘 MDI 子窗口的优化。

备注

若要利用在 MDI 应用程序的扩展的自定义功能，从 CMDIFrameWndEx 派生应用程序的 MDI 框架窗口选件类而不是 CMDIFrameWnd。

示例

下面的示例从 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

请参见

参考

层次结构图

CMDIFrameWnd

CMDIChildWndEx选件类

其他资源

MFC 类