CMDIChildWndEx Class

Article
07/22/2011

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

The CMDIChildWndEx class provides the functionality of a Windows multiple document interface (MDI) child window. It extends the functionality of CMDIChildWnd Class. The framework requires this class when an MDI application uses certain MFC classes.

class CMDIChildWndEx : public CMDIChildWnd

Members

Public Methods

Name	Description
CMDIChildWndEx::ActivateTopLevelFrame	Called internally by the framework to activate top level frame when the application should be activated from a taskbar tab.
CMDIChildWndEx::AddDockSite
CMDIChildWndEx::AddPane	Adds a pane.
CMDIChildWndEx::AddTabbedPane	Adds a tabbed pane.
CMDIChildWndEx::AdjustDockingLayout	Adjusts the docking layout.
CMDIChildWndEx::CanShowOnMDITabs
CMDIChildWndEx::CanShowOnTaskBarTabs	Tells the framework whether this MDI child can be displayed on Windows 7 taskbar tabs.
CMDIChildWndEx::CanShowOnWindowsList	Returns TRUE if the MDI child window name can be displayed in the CMFCWindowsManagerDialog Class dialog box. Otherwise returns FALSE.
CMDIChildWndEx::CreateObject	Called by the framework to create a dynamic instance of this class type.
CMDIChildWndEx::DockPane	Docks a pane.
CMDIChildWndEx::DockPaneLeftOf	Docks one pane to the left of another pane.
CMDIChildWndEx::EnableAutoHidePanes	Enables auto-hide mode for panes when they are docked at the specified sides of the window.
CMDIChildWndEx::EnableDocking	Enables docking of the child window to the main frame.
CMDIChildWndEx::EnableTaskbarThumbnailClipRect	Enables or disables automatic selection of a portion of a window's client area to display as that window's thumbnail in the taskbar.
CMDIChildWndEx::GetDockingManager
CMDIChildWndEx::GetDocumentName	Returns the name of the document that is displayed in the MDI child window.
CMDIChildWndEx::GetFrameIcon	Called by the framework to retrieve the MDI child window icon.
CMDIChildWndEx::GetFrameText	Called by the framework to retrieve the text for the MDI child window.
CMDIChildWndEx::GetPane	Finds a pane by the specified control ID.
CMDIChildWndEx::GetRelatedTabGroup
CMDIChildWndEx::GetTabbedPane	Returns a pointer to an embedded docking pane that was converted to a tabbed document.
CMDIChildWndEx::GetTabProxyWnd	Returns tab proxy window actually registered with Windows 7 taskbar tabs.
CMDIChildWndEx::GetTaskbarPreviewWnd	Called by the framework when it needs to obtain a child window (usually a view or splitter window) to be displayed on Windows 7 taskbar tab thumbnail.
CMDIChildWndEx::GetTaskbarThumbnailClipRect	Called by the framework when it needs to select a portion of a window's client area to display as that window's thumbnail in the taskbar.
CMDIChildWndEx::GetThisClass	Called by the framework to obtain a pointer to the CRuntimeClass object that is associated with this class type.
CMDIChildWndEx::GetToolbarButtonToolTipText	Called by the framework to retrieve a tooltip for a toolbar button.
CMDIChildWndEx::InsertPane	Registers the specified pane with the docking manager.
CMDIChildWndEx::InvalidateIconicBitmaps	Invalidates iconic bitmap representation of MDI child.
CMDIChildWndEx::IsPointNearDockSite	Determines whether a specified point is near the dock site.
CMDIChildWndEx::IsReadOnly	Returns TRUE if the document that is displayed in the child window is read-only. Otherwise returns FALSE.
CMDIChildWndEx::IsRegisteredWithTaskbarTabs	Returns TRUE if MDI child was successfully registered with Windows 7 taskbar tabs.
CMDIChildWndEx::IsTabbedPane	Returns TRUE if the MDI child window contains a docking pane. Otherwise returns FALSE.
CMDIChildWndEx::IsTaskbarTabsSupportEnabled	Tells whether the MDI child can appear on Windows 7 taskbar tabs.
CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled	Tells whether automatic selection of a portion of a window's client area to display as that window's thumbnail in the taskbar is enabled or disabled.
CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags	A combination of flags, which is passed by the framework to the SetTaskbarTabProperties method, when a tab (MDI child) is being registered with Windows 7 taskbar tabs. The default combination is STPF_USEAPPTHUMBNAILWHENACTIVE \| STPF_USEAPPPEEKWHENACTIVE.
CMDIChildWndEx::OnGetIconicLivePreviewBitmap	Called by the framework when it needs to obtain a bitmap for live preview of MDI child.
CMDIChildWndEx::OnGetIconicThumbnail	Called by the framework when it needs to obtain a bitmap for iconic thumbnail of MDI child.
CMDIChildWndEx::OnMoveMiniFrame	Called by the framework to move a mini-frame window.
CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton	Called by the framework when the user presses close button on Taskbar tab thumbnail..
CMDIChildWndEx::OnSetPreviewMode	Called by the framework to enter or exit print preview mode.
CMDIChildWndEx::OnTaskbarTabThumbnailActivate	Called by the framework when the Taskbar tab thumbnail should process WM_ACTIVATE message.
CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate	Called by the framework when the Taskbar tab thumbnail should process WM_MOUSEACTIVATE message.
CMDIChildWndEx::OnTaskbarTabThumbnailStretch	Called by the framework when it needs to stretch a bitmap for Windows 7 taskbar tab thumbnail preview of MDI child.
CMDIChildWndEx::OnUpdateFrameTitle	Called by the framework to update the frame title. (Overrides CMDIChildWnd::OnUpdateFrameTitle.)
CMDIChildWndEx::PaneFromPoint	Returns the pane that contains the given point.
CMDIChildWndEx::PreTranslateMessage	Used by class CWinApp to translate window messages before they are dispatched to the TranslateMessage and DispatchMessage Windows functions. (Overrides CWnd::PreTranslateMessage.)
CMDIChildWndEx::RecalcLayout	Recalculates the layout of the window.
CMDIChildWndEx::RegisterTaskbarTab	Registers MDI child with Windows 7 taskbar tabs.
CMDIChildWndEx::RemovePaneFromDockManager	Removes a pane from the docking manager.
CMDIChildWndEx::SetRelatedTabGroup
CMDIChildWndEx::SetTaskbarTabActive	Activates corresponding Windows 7 taskbar tab.
CMDIChildWndEx::SetTaskbarTabOrder	Inserts MDI child before specified window on Windows 7 taskbar tabs.
CMDIChildWndEx::SetTaskbarTabProperties	Sets properties for a Windows 7 taskbar tab.
CMDIChildWndEx::SetTaskbarThumbnailClipRect	Called internally by the framework to set clipping rectangle to select a portion of a window's client area to display as that window's thumbnail in the taskbar.
CMDIChildWndEx::ShowPane
CMDIChildWndEx::UnregisterTaskbarTab	Removes MDI child from Windows 7 taskbar tabs.
CMDIChildWndEx::UpdateTaskbarTabIcon	Updates Windows 7 taskbar tab icon.

Remarks

To take advantage of extended docking features in MDI applications, derive the MDI child window class of your application from CMDIChildWndEx instead of CMDIChildWnd.

Example

The following example derives a class from CMDIChildWndEx. This code snippet comes from the VisualStudioDemo Sample: MFC Visual Studio Application.

class CChildFrame : public CMDIChildWndEx
{
    DECLARE_DYNCREATE(CChildFrame)
public:
    CChildFrame();

// Overrides
public:
    virtual BOOL PreCreateWindow(CREATESTRUCT& cs);
    virtual void ActivateFrame(int nCmdShow = -1);

    virtual BOOL IsReadOnly();
    virtual LPCTSTR GetDocumentName(CObject** pObj);

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

protected:
    afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

    DECLARE_MESSAGE_MAP()
};