CMDIChildWndEx Class
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 |
---|---|
Called internally by the framework to activate top level frame when the application should be activated from a taskbar tab. |
|
CMDIChildWndEx::AddDockSite |
This method is not used or implemented. |
Adds a pane. |
|
Adds a tabbed pane. |
|
Adjusts the docking layout. |
|
|
|
Tells the framework whether this MDI child can be displayed on Windows 7 taskbar tabs. |
|
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. |
Docks a pane. |
|
Docks one pane to the left of another pane. |
|
Enables auto-hide mode for panes when they are docked at the specified sides of the window. |
|
Enables docking of the child window to the main frame. |
|
Enables or disables automatic selection of a portion of a window's client area to display as that window's thumbnail in the taskbar. |
|
|
|
Returns the name of the document that is displayed in the MDI child window. |
|
Called by the framework to retrieve the MDI child window icon. |
|
Called by the framework to retrieve the text for the MDI child window. |
|
Finds a pane by the specified control ID. |
|
|
|
Returns a pointer to an embedded docking pane that was converted to a tabbed document. |
|
Returns tab proxy window actually registered with Windows 7 taskbar tabs. |
|
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. |
|
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. |
Called by the framework to retrieve a tooltip for a toolbar button. |
|
Registers the specified pane with the docking manager. |
|
Invalidates iconic bitmap representation of MDI child. |
|
Determines whether a specified point is near the dock site. |
|
Returns TRUE if the document that is displayed in the child window is read-only. Otherwise returns FALSE. |
|
Returns TRUE if MDI child was successfully registered with Windows 7 taskbar tabs. |
|
Returns TRUE if the MDI child window contains a docking pane. Otherwise returns FALSE. |
|
Tells whether the MDI child can appear on Windows 7 taskbar tabs. |
|
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. |
|
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. |
|
Called by the framework when it needs to obtain a bitmap for live preview of MDI child. |
|
Called by the framework when it needs to obtain a bitmap for iconic thumbnail of MDI child. |
|
Called by the framework to move a mini-frame window. |
|
Called by the framework when the user presses close button on Taskbar tab thumbnail.. |
|
Called by the framework to enter or exit print preview mode. |
|
Called by the framework when the Taskbar tab thumbnail should process WM_ACTIVATE message. |
|
Called by the framework when the Taskbar tab thumbnail should process WM_MOUSEACTIVATE message. |
|
Called by the framework when it needs to stretch a bitmap for Windows 7 taskbar tab thumbnail preview of MDI child. |
|
Called by the framework to update the frame title. (Overrides CMDIChildWnd::OnUpdateFrameTitle.) |
|
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.) |
Recalculates the layout of the window. |
|
Registers MDI child with Windows 7 taskbar tabs. |
|
Removes a pane from the docking manager. |
|
|
|
Activates corresponding Windows 7 taskbar tab. |
|
Inserts MDI child before specified window on Windows 7 taskbar tabs. |
|
Sets properties for a Windows 7 taskbar tab. |
|
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. |
|
|
|
Removes MDI child from Windows 7 taskbar tabs. |
|
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()
};
Inheritance Hierarchy
Requirements
Header: afxMDIChildWndEx.h
See Also
Reference
CMFCWindowsManagerDialog Class