CFrameWndEx Class

Article
11/16/2012

Implements the functionality of a Windows single document interface (SDI) overlapped or popup frame window, and provides members for managing the window. It extends the CFrameWnd class.

class CFrameWndEx : public CFrameWnd

Members

Public Methods

Name	Description
CFrameWndEx::ActiveItemRecalcLayout	Adjusts the layout of the OLE client item and the frame's client area.
CFrameWndEx::AddDockSite	This method is not used.
CFrameWndEx::AddPane	Registers a control bar with the docking manager.
CFrameWndEx::AdjustDockingLayout	Recalculates the layout of all panes that are docked to the frame window.
CFrameWndEx::DelayUpdateFrameMenu	Sets the frame menu and then updates it when command processing is idle.
CFrameWndEx::DockPane	Docks the specified pane to the frame window.
CFrameWndEx::DockPaneLeftOf	Docks one pane to the left of another pane.
CFrameWndEx::EnableAutoHidePanes	Enables the auto-hide mode for the panes when they are docked to the specified sides of the main frame window.
CFrameWndEx::EnableDocking	Enables the docking of the panes that belong to the frame window.
CFrameWndEx::EnableFullScreenMainMenu	Shows or hides the main menu in a full screen mode.
CFrameWndEx::EnableFullScreenMode	Enables the full screen mode for the frame window.
CFrameWndEx::EnableLoadDockState	Enables or disables the loading of the docking state.
CFrameWndEx::EnablePaneMenu	Enables or disables the automatic handling of the pane menu.
CFrameWndEx::GetActivePopup	Returns a pointer to the currently displayed pop-up menu.
CFrameWndEx::GetDefaultResId	Returns the resource ID that you specified when the framework loaded the frame window.
CFrameWndEx::GetDockingManager	Retrieves the CDockingManager Class object for the frame window.
CFrameWndEx::GetMenuBar	Returns a pointer to the menu bar object attached to the frame window.
CFrameWndEx::GetPane	Returns a pointer to the pane that has the specified ID.
CFrameWndEx::GetRibbonBar	Retrieves the ribbon bar control for the frame.
CFrameWndEx::GetTearOffBars	Returns a list of pane objects that are in a tear-off state.
CFrameWndEx::GetToolbarButtonToolTipText	Called by the framework when the application displays the tooltip for a toolbar button.
CFrameWndEx::InsertPane	Registers a pane with the docking manager.
CFrameWndEx::IsFullScreen	Determines whether the frame window is in full screen mode.
CFrameWndEx::IsMenuBarAvailable	Determines whether the pointer to the menu bar object is valid.
CFrameWndEx::IsPointNearDockSite	Indicates whether the point is located in an alignment zone.
CFrameWndEx::IsPrintPreview	Indicates whether the frame window is in print preview mode.
CFrameWndEx::LoadFrame	This method is called after construction to create the frame window and load its resources.
CFrameWndEx::NegotiateBorderSpace	Implements OLE client border negotiation.
CFrameWndEx::OnActivate	The framework calls this method when user input is switched to or away from the frame.
CFrameWndEx::OnActivateApp	Called by the framework when the application is either selected or deselected.
CFrameWndEx::OnChangeVisualManager	Called by the framework when a change to the frame requires a change to the visual manager.
CFrameWndEx::OnClose	The framework calls this method to close the frame.
CFrameWndEx::OnCloseDockingPane	Called by the framework when the user clicks the Close button on a docking pane.
CFrameWndEx::OnCloseMiniFrame	Called by the framework when the user clicks the Close button on a floating mini frame window.
CFrameWndEx::OnClosePopupMenu	Called by the framework when an active pop-up menu processes a WM_DESTROY message.
CFrameWndEx::OnCmdMsg	Dispatches command messages.
CFrameWndEx::OnContextHelp	Called by the framework to display context related help.
CFrameWndEx::OnCreate	Called by the framework after the frame is created.
CFrameWndEx::OnDestroy	Called by the framework when the frame is destroyed.
CFrameWndEx::OnDrawMenuImage	Called by the framework when the application draws the image associated with a menu item.
CFrameWndEx::OnDrawMenuLogo	Called by the framework when a CMFCPopupMenu object processes a WM_PAINT message.
CFrameWndEx::OnDWMCompositionChanged	Called by the framework when Desktop Window Manager (DWM) composition has been enabled or disabled.
CFrameWndEx::OnExitSizeMove	Called by the framework when the frame stops moving or resizing.
CFrameWndEx::OnGetMinMaxInfo	Called by the framework when the frame is resized to set window dimension limits.
CFrameWndEx::OnIdleUpdateCmdUI	Called by the framework to update the frame display when command processing is idle.
CFrameWndEx::OnLButtonDown	The framework calls this method when the user presses the left mouse button.
CFrameWndEx::OnLButtonUp	The framework calls this method when the user releases the left mouse button.
CFrameWndEx::OnMenuButtonToolHitTest	Called by the framework when a CMFCToolBarButton object processes a WM_NCHITTEST message.
CFrameWndEx::OnMenuChar	Called by the framework when a menu is displayed and the user presses a key that does not correspond to a command.
CFrameWndEx::OnMouseMove	The framework calls this method when the pointer moves.
CFrameWndEx::OnMoveMiniFrame	Called by the framework when a pane window moves.
CFrameWndEx::OnNcActivate	Called by the framework when the non-client area of the frame must be redrawn to indicate a change in the active state.
CFrameWndEx::OnNcCalcSize	Called by the framework when the size and position of the client area must be calculated.
CFrameWndEx::OnNcHitTest	Called by the framework when the pointer moves or when a mouse button is pressed or released.
CFrameWndEx::OnNcMouseMove	Called by the framework when the pointer moves in a non-client area.
CFrameWndEx::OnNcPaint	Called by the framework when the non-client area must be painted.
CFrameWndEx::OnPaneCheck	Called by the framework to control the visibility of a pane.
CFrameWndEx::OnPostPreviewFrame	Called by the framework when the user has changed the print preview mode.
CFrameWndEx::OnPowerBroadcast	Called by the framework when a power management event occurs.
CFrameWndEx::OnSetMenu	Called by the framework to replace the frame window menu.
CFrameWndEx::OnSetPreviewMode	Called by the framework to set the print preview mode for the frame.
CFrameWndEx::OnSetText	Called by the framework to set the text of a window.
CFrameWndEx::OnShowCustomizePane	Called by the framework when a quick customize pane is enabled.
CFrameWndEx::OnShowPanes	Called by the framework to show or hide panes.
CFrameWndEx::OnShowPopupMenu	Called by the framework when a pop-up menu is enabled.
CFrameWndEx::OnSize	The framework calls this method after the frame's size changes.
CFrameWndEx::OnSizing	The framework calls this method when the user resizes the frame.
CFrameWndEx::OnSysColorChange	Called by the framework when the system colors change.
CFrameWndEx::OnTearOffMenu	Called by the framework when a menu that has a tear-off bar is enabled.
CFrameWndEx::OnToolbarContextMenu	Called by the framework to build a toolbar context menu.
CFrameWndEx::OnToolbarCreateNew	The framework calls this method to create a new toolbar.
CFrameWndEx::OnToolbarDelete	Called by the framework when a toolbar is deleted.
CFrameWndEx::OnUpdateFrameMenu	Called by the framework to set the frame menu.
CFrameWndEx::OnUpdateFrameTitle	The framework calls this method to update the title bar of the frame window.
CFrameWndEx::OnUpdatePaneMenu	Called by the framework to update the pane menu.
CFrameWndEx::OnWindowPosChanged	Called by the framework when the frame size, position, or z-order has changed because of a call to a window management method.
CFrameWndEx::PaneFromPoint	Returns the docking pane that contains the specified point.
CFrameWndEx::PreTranslateMessage	Handles specific window messages before they are dispatched.
CFrameWndEx::RecalcLayout	Adjusts the layout of the frame and its child windows.
CFrameWndEx::RemovePaneFromDockManager	Unregisters a pane and removes it from the internal list in the docking manager.
CFrameWndEx::SetDockState	Restores the docking layout to the docking state stored in the registry.
CFrameWndEx::SetPrintPreviewFrame	Sets the print preview frame window.
CFrameWndEx::SetupToolbarMenu	Inserts user-defined commands into a toolbar menu.
CFrameWndEx::ShowFullScreen	Switches the main frame between the full screen and the regular modes.
CFrameWndEx::ShowPane	Shows or hides the specified pane.
CFrameWndEx::UpdateCaption	Called by the framework to update the window frame caption.
CFrameWndEx::WinHelp	Invokes either the WinHelp application or context related help.

Example

The following example demonstrates how to inherit a class from the CFrameWndEx class. The example illustrates the method signatures in the subclass, and how to override the OnShowPopupMenu method. This code snippet is part of the WordPad Sample: MFC WordPad Application.

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;
}