CAutoHideDockSite Class

The latest version of this topic can be found at CAutoHideDockSite Class.

The CAutoHideDockSite extends the CDockSite Class to implement auto-hide dock panes.

Syntax

class CAutoHideDockSite : public CDockSite  

Members

Public Constructors

Public Methods

Data Members

Remarks

When you call CFrameWndEx::EnableAutoHidePanes, the framework automatically creates a CAutoHideDockSite object. In most cases, you should not have to instantiate or use this class directly.

The docking bar is the gap between the left side of the dock pane and the left side of the CMFCAutoHideButton Class.

Inheritance Hierarchy

CObject

CCmdTarget

CWnd

CBasePane

CDockSite

Example

The following example demonstrates how to retrieve a CAutoHideDockSite object from a CMFCAutoHideBar object, and how to set the left and right margins of the docking bar.

 CAutoHideDockSite* pParentDockBar = DYNAMIC_DOWNCAST(CAutoHideDockSite, pParentBar->GetParentDockSite());
    pParentDockBar->SetOffsetLeft(10);
    pParentDockBar->SetOffsetRight(10);

Requirements

Header: afxautohidedocksite.h

CAutoHideDockSite::CanAcceptPane

Determines whether a base pane is a CMFCAutoHideBar object or derived from CMFCAutoHideBar.

virtual BOOL CanAcceptPane(const CBasePane* pBar) const;  

Parameters

Return Value

TRUE if pBar is derived from CMFCAutoHideBar; FALSE otherwise.

Remarks

If a base pane object is derived from CMFCAutoHideBar, it can contain a CAutoHideDockSite.

CAutoHideDockSite::DockPane

Docks a pane to this CAutoHideDockSite object.

virtual void DockPane(
    CPane* pWnd,  
    AFX_DOCK_METHOD dockMethod,  
    LPRECT lpRect = NULL);

Parameters

Remarks

The default implementation does not use the parameter dockMethod, which is provided for future use.

If lpRect is NULL, the framework puts the pane in the default location on the dock site. If the dock site is horizontal, the default location is at the far left of the dock site. Otherwise, the default location is at the top of the dock site.

CAutoHideDockSite::GetAlignRect

Retrieves the size of the dock site in screen coordinates.

void GetAlignRect(CRect& rect) const;  

Parameters

Remarks

The rectangle is adjusted for the offset margins so that they are not included.

CAutoHideDockSite::m_nExtraSpace

The size of the space between the edges of the CAutoHideDockSite Class and the CMFCAutoHideBar Class objects.

static int m_nExtraSpace;  

Remarks

When a CMFCAutoHideBar is docked at a CAutoHideDockSite, it should not occupy the whole dock site. This global variable controls the extra space between the left or top border of the CMFCAutoHideBar and the corresponding CAutoHideDockSite edge. Whether the top or left edge is used depends on the current alignment.

CAutoHideDockSite::SetOffsetLeft

Sets the margin on the left side of the docking bar.

void SetOffsetLeft(int nOffset);

Parameters

[in] nOffset
The new offset.

Remarks

CMFCAutoHideBar objects are positioned statically on the CAutoHideDockSite object. This means that the user cannot manually change the location of CMFCAutoHideBar objects. The SetOffsetLeft method controls the spacing between the left side of the left-most CMFCAutoHideBar and the left side of the CAutoHideDockSite.

CAutoHideDockSite::SetOffsetRight

Sets the margin on the right side of the docking bar.

void SetOffsetRight(int nOffset);

Parameters

[in] nOffset
The new offset.

Remarks

CMFCAutoHideBar objects are positioned statically on the CAutoHideDockSite object. This means that the user cannot manually change the location of the CMFCAutoHideBar objects. The SetOffsetRight method controls the spacing between the right side of the right-most CMFCAutoHideBar and the right side of the CAutoHideDockSite.

CAutoHideDockSite::RepositionPanes

Redraws the panes on the CAutoHideDockSite.

virtual void RepositionPanes(CRect& rectNewClientArea);

Parameters

Remarks

The default implementation does not use rectNewClientArea. It redraws the panes with the global toolbar margins and button spacing.

CAutoHideDockSite::UnSetAutoHideMode

Calls CMFCAutoHideBar::UnSetAutoHideMode for objects on the dock site.

void UnSetAutoHideMode(CMFCAutoHideBar* pAutoHideToolbar);

Parameters

Remarks

This method searches for the row that contains pAutoHideToolbar. It calls CMFCAutoHideBar.UnSetAutoHideMode for all the CMFCAutoHideBar objects on that row. If pAutoHideToolbar is not found or it is NULL, this method calls CMFCAutoHideBar.UnSetAutoHideMode for all the CMFCAutoHideBar objects on the CAutoHideDockSite.

See Also

Hierarchy Chart
Classes
CDockSite Class