CFrameWndEx选件类

项目
03/01/2013

实现的Windows函数单文档界面(SDI)利用率、线程或弹出框架窗口，并为管理窗口提供成员。它扩展 CFrameWnd 选件类。

class CFrameWndEx : public CFrameWnd

成员

公共方法

名称	说明
CFrameWndEx::ActiveItemRecalcLayout	调整OLE客户端项目和框架的工作区的格式。
CFrameWndEx::AddDockSite	未使用此方法。
CFrameWndEx::AddPane	注册停靠管理器的控件条。
CFrameWndEx::AdjustDockingLayout	重新停靠到框架窗口所有窗格的格式。
CFrameWndEx::DelayUpdateFrameMenu	在命令处理空闲时，将框架菜单上的并进行更新。
CFrameWndEx::DockPane	停靠指定的窗格到框架窗口。
CFrameWndEx::DockPaneLeftOf	停靠在另一个窗格左侧的一个窗格。
CFrameWndEx::EnableAutoHidePanes	当它们停靠在主框架窗口时，的指定端启动窗格"自动隐藏"模式。
CFrameWndEx::EnableDocking	启用属于框架窗口窗格的停靠。
CFrameWndEx::EnableFullScreenMainMenu	显示或隐藏主菜单在一个全屏模式。
CFrameWndEx::EnableFullScreenMode	启动框架窗口的"全屏"模式。
CFrameWndEx::EnableLoadDockState	启用或禁用停靠状态的加载。
CFrameWndEx::EnablePaneMenu	启用或禁用自动处理窗格菜单。
CFrameWndEx::GetActivePopup	返回指向当前显示的弹出菜单。
CFrameWndEx::GetDefaultResId	返回您指定的资源ID框架时加载了框架窗口。
CFrameWndEx::GetDockingManager	检索框架窗口的 CDockingManager选件类对象。
CFrameWndEx::GetMenuBar	返回指向附加的菜单栏对象到框架窗口。
CFrameWndEx::GetPane	返回指向具有指定的ID.的窗格
CFrameWndEx::GetRibbonBar	检索框架的功能区栏控件。
CFrameWndEx::GetTearOffBars	返回的窗格对象列表。拖曳状态。
CFrameWndEx::GetToolbarButtonToolTipText	调用由结构，当应用程序显示工具栏按钮的工具提示。
CFrameWndEx::InsertPane	注册了停靠管理器的一个窗格。
CFrameWndEx::IsFullScreen	确定框架窗口是否在"全屏"模式。
CFrameWndEx::IsMenuBarAvailable	确定与菜单栏对象的指针是否有效。
CFrameWndEx::IsPointNearDockSite	指示点是否位于对齐区域。
CFrameWndEx::IsPrintPreview	指示框架窗口是否在打印预览模式。
CFrameWndEx::LoadFrame	此方法在构造后调用创建框架窗口和填充其资源。
CFrameWndEx::NegotiateBorderSpace	实现OLE客户端协商边框。
CFrameWndEx::OnActivate	当用户输入被切换到或其他帧时，框架调用此方法。
CFrameWndEx::OnActivateApp	调用由结构，当应用程序选择或取消选择。
CFrameWndEx::OnChangeVisualManager	调用由结构，当对框架的更改要求对视觉管理器的更改。
CFrameWndEx::OnClose	框架调用此方法关闭帧。
CFrameWndEx::OnCloseDockingPane	调用由结构，当用户在停靠窗格关闭单击按钮。
CFrameWndEx::OnCloseMiniFrame	调用由结构，当用户在浮动mini框架窗口关闭单击按钮。
CFrameWndEx::OnClosePopupMenu	调用由结构，当一个有效的弹出菜单操作WM_DESTROY消息。
CFrameWndEx::OnCmdMsg	计划命令消息。
CFrameWndEx::OnContextHelp	调用由框架显示上下文相关帮助。
CFrameWndEx::OnCreate	调用由框架在框架的后面创建。
CFrameWndEx::OnDestroy	调用由结构，当销毁框架。
CFrameWndEx::OnDrawMenuImage	调用由结构，当应用程序绘制图像与菜单项。
CFrameWndEx::OnDrawMenuLogo	调用由结构，当 CMFCPopupMenu 对象处理 WM_PAINT 消息。
CFrameWndEx::OnDWMCompositionChanged	调用由结构，在桌面窗口管理器(DWM)配置已启用或禁用了。
CFrameWndEx::OnExitSizeMove	调用由框架，这些帧停止移动或调整。
CFrameWndEx::OnGetMinMaxInfo	调用由框架，这些帧调整大小设置窗口的尺寸限制。
CFrameWndEx::OnIdleUpdateCmdUI	调用由框架更新帧示，当命令处理idle。
CFrameWndEx::OnLButtonDown	当用户按下鼠标左键时，框架调用此方法。
CFrameWndEx::OnLButtonUp	当用户松开鼠标左键时，框架调用此方法。
CFrameWndEx::OnMenuButtonToolHitTest	调用由结构，当 CMFCToolBarButton 对象处理 WM_NCHITTEST 消息。
CFrameWndEx::OnMenuChar	调用由框架，在菜单上显示时和用户按下不对应命令的一个键。
CFrameWndEx::OnMouseMove	当指针移动时，框架调用此方法。
CFrameWndEx::OnMoveMiniFrame	调用由结构，当窗口窗格移动。
CFrameWndEx::OnNcActivate	调用由框架，则必须重绘帧的非工作区指示在活动状态的更改。
CFrameWndEx::OnNcCalcSize	调用由框架，则必须计算工作区的大小和位置。
CFrameWndEx::OnNcHitTest	调用由结构，当指针移动或，按下鼠标按钮或释放。
CFrameWndEx::OnNcMouseMove	调用由结构，当指针在非工作区移动。
CFrameWndEx::OnNcPaint	调用由框架，则必须绘制非工作区。
CFrameWndEx::OnPaneCheck	调用由结构窗格控件的可见性。
CFrameWndEx::OnPostPreviewFrame	调用由结构，当用户更改了打印预览模式。
CFrameWndEx::OnPowerBroadcast	调用由结构，当电源管理事件发生。
CFrameWndEx::OnSetMenu	调用由框架替换框架窗口菜单。
CFrameWndEx::OnSetPreviewMode	调用由框架将框架的打印预览模式。
CFrameWndEx::OnSetText	调用由框架设置窗口的文本。
CFrameWndEx::OnShowCustomizePane	调用由框架，快速自定义时窗格启用。
CFrameWndEx::OnShowPanes	调用由结构显示或隐藏窗格。
CFrameWndEx::OnShowPopupMenu	调用由结构，当弹出菜单启用。
CFrameWndEx::OnSize	在帧大小更改后，框架调用此方法。
CFrameWndEx::OnSizing	当用户调整帧时，框架调用此方法。
CFrameWndEx::OnSysColorChange	调用由结构，当系统颜色更改。
CFrameWndEx::OnTearOffMenu	调用由结构，当有一个拖曳栏的菜单上启用。
CFrameWndEx::OnToolbarContextMenu	调用由框架生成工具栏上下文菜单。
CFrameWndEx::OnToolbarCreateNew	框架调用此方法来创建新工具栏。
CFrameWndEx::OnToolbarDelete	调用由结构，在工具栏中删除。
CFrameWndEx::OnUpdateFrameMenu	调用由框架设置框架菜单。
CFrameWndEx::OnUpdateFrameTitle	框架调用此方法将更新框架窗口的标题栏。
CFrameWndEx::OnUpdatePaneMenu	调用由框架更新窗格菜单。
CFrameWndEx::OnWindowPosChanged	调用由结构，当帧大小、位置或z顺序更改为由于调用windows管理方法。
CFrameWndEx::PaneFromPoint	返回包含指定的点停靠窗格。
CFrameWndEx::PreTranslateMessage	处理特定窗口消息，在计划之前它们。
CFrameWndEx::RecalcLayout	调整帧及其子窗口的格式。
CFrameWndEx::RemovePaneFromDockManager	注销窗格和从内部在停靠管理器移除该列表。
CFrameWndEx::SetDockState	还原停靠布局将存储在注册表中的停靠状态。
CFrameWndEx::SetPrintPreviewFrame	设置打印预览框架窗口。
CFrameWndEx::SetupToolbarMenu	插入用户定义的命令到工具栏菜单中。
CFrameWndEx::ShowFullScreen	切换到全屏和普通模式之间的主框架。
CFrameWndEx::ShowPane	显示或隐藏指定的窗格。
CFrameWndEx::UpdateCaption	调用由框架更新窗架说明。
CFrameWndEx::WinHelp	调用 WinHelp 应用程序或上下文相关的帮助。

示例

下面的示例演示如何继承 CFrameWndEx 选件类的选件类。示例阐释了子类的方法签名，以及如何重写 OnShowPopupMenu 方法。此代码段是 Word填充示例的一部分。

class CMainFrame : public CFrameWndEx
{
protected: // create from serialization only
    CMainFrame();
    DECLARE_DYNCREATE(CMainFrame)

// Attributes
public:
    HICON m_hIconDoc;
    HICON m_hIconText;
    HICON m_hIconWrite;
    HICON GetIcon(int nDocType);

// Operations
public:
    void UpdateMRUFilesList ()
    {
        m_wndTaskPane.UpdateMRUFilesList ();
    }

    void OnChangeLook ();

// Overrides
    // ClassWizard generated virtual function overrides
    //{{AFX_VIRTUAL(CMainFrame)
    public:
    virtual void ActivateFrame(int nCmdShow = -1);
    virtual BOOL LoadFrame(UINT nIDResource, DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE, CWnd* pParentWnd = NULL, CCreateContext* pContext = NULL);
    protected:
    virtual BOOL PreCreateWindow(CREATESTRUCT& cs);
    virtual BOOL OnCommand(WPARAM wParam, LPARAM lParam);
    //}}AFX_VIRTUAL

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

protected:
    void AdjustObjectSubmenu (CMFCPopupMenu* pMenuPopup);
    void AdjustColorsMenu (CMFCPopupMenu* pMenuPopup, UINT uiId);

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

public:
    CMFCMenuBar m_wndMenuBar;
    CMFCToolBar m_wndToolBar;
    CMFCStatusBar   m_wndStatusBar;
    CFormatBar      m_wndFormatBar;
    CRulerBar       m_wndRulerBar;
    CTaskPane       m_wndTaskPane;

protected:  // control bar embedded members
    BOOL CreateMenuBar();
    BOOL CreateToolBar();
    BOOL CreateFormatBar();
    BOOL CreateStatusBar();
    BOOL CreateRulerBar();
    BOOL CreateTaskPane ();

// Generated message map functions
protected:
    //{{AFX_MSG(CMainFrame)
    afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
    afx_msg void OnSysColorChange();
    afx_msg void OnSize(UINT nType, int cx, int cy);
    afx_msg void OnMove(int x, int y);
    afx_msg void OnHelpFinder();
    afx_msg void OnDropFiles(HDROP hDropInfo);
    afx_msg void OnFontChange();
    afx_msg BOOL OnQueryNewPalette();
    afx_msg void OnPaletteChanged(CWnd* pFocusWnd);
    afx_msg void OnDevModeChange(LPTSTR lpDeviceName);
    afx_msg void OnViewCustomize();
    afx_msg void OnViewFullScreen();
    //}}AFX_MSG
    afx_msg LRESULT OnBarState(WPARAM wParam, LPARAM lParam);
    afx_msg LRESULT OnOpenMsg(WPARAM wParam, LPARAM lParam);
    afx_msg LRESULT OnHelpCustomizeToolbars(WPARAM wp, LPARAM lp);
    afx_msg LRESULT OnStartCustomize(WPARAM wp, LPARAM lp);
    afx_msg LRESULT OnToolbarCreateNew(WPARAM,LPARAM);
    afx_msg LRESULT OnGetDocumentColors(WPARAM,LPARAM);
    afx_msg void OnDummy();
    afx_msg void OnAskQuestion();
    DECLARE_MESSAGE_MAP()
};


...


BOOL CMainFrame::OnShowPopupMenu (CMFCPopupMenu* pMenuPopup)
{
    BOOL bRes = CFrameWndEx::OnShowPopupMenu (pMenuPopup);

    if (pMenuPopup != NULL && !pMenuPopup->IsCustomizePane())
    {
        AdjustObjectSubmenu (pMenuPopup);
        AdjustColorsMenu (pMenuPopup, ID_CHAR_COLOR);
    }

    return bRes;
}