Share via


CAutoHideDockSite-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

De CAutoHideDockSite uitbreiding van de CDockSite-klasse voor het implementeren van deelvensters voor automatisch verbergen van docks.

Syntaxis

class CAutoHideDockSite : public CDockSite

Leden

Openbare constructors

Naam Description
Naam Description
CAutoHideDockSite::CAutoHideDockSite Maakt een CAutoHideDockSite object.
CAutoHideDockSite::~CAutoHideDockSite Destructor.

Openbare methoden

Naam Description
Naam Description
CAutoHideDockSite::AllowShowOnPaneMenu Hiermee wordt aangegeven of het CAutoHideDockSite wordt weergegeven in het deelvenstermenu.
CAutoHideDockSite::CanAcceptPane Bepaalt of een basisdeelvensterobject is afgeleid van de klasse CMFCAutoHideBar.
CAutoHideDockSite::D ockPane Hiermee wordt een deelvenster aan dit CAuotHideDockSite object gekoppeld.
CAutoHideDockSite::GetAlignRect Hiermee haalt u de grootte van de docksite op in schermcoördinaten.
CAutoHideDockSite::RepositionPanes Hiermee tekent u het deelvenster opnieuw met CAutoHideDockSite de globale marges en de afstand tussen knoppen.
CAutoHideDockSite::SetOffsetLeft Hiermee stelt u de marge aan de linkerkant van de dockingbalk in.
CAutoHideDockSite::SetOffsetRight Hiermee stelt u de marge aan de rechterkant van de dockingbalk in.
CAutoHideDockSite::UnSetAutoHideMode Roept CMFCAutoHideBar::UnSetAutoHideMode aan voor objecten op de CAutoHideDockSite.

Gegevensleden

Naam Description
Naam Description
CAutoHideDockSite::m_nExtraSpace Definieert de grootte van de ruimte tussen de werkbalken en de rand van de dockingbalk. Deze ruimte wordt gemeten vanaf de linkerrand of de bovenrand, afhankelijk van de uitlijning voor de dockruimte.

Opmerkingen

Wanneer u CFrameWndEx::EnableAutoHidePanes aanroept, wordt in het framework automatisch een CAutoHideDockSite object gemaakt. In de meeste gevallen hoeft u deze klasse niet rechtstreeks te instantiëren of te gebruiken.

De dockingbalk is de tussenruimte tussen de linkerkant van het dockvenster en de linkerkant van de CMFCAutoHideButton-klasse.

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CBasePane

CDockSite

Example

In het volgende voorbeeld ziet u hoe u een CAutoHideDockSite object ophaalt uit een CMFCAutoHideBar object en hoe u de linker- en rechtermarges van de dockingbalk instelt.

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

Requirements

Koptekst: afxautohidedocksite.h

CAutoHideDockSite::CanAcceptPane

Bepaalt of een basisdeelvenster een CMFCAutoHideBar-object is of is afgeleid van CMFCAutoHideBar.

virtual BOOL CanAcceptPane(const CBasePane* pBar) const;

Parameterwaarden

pBar
[in] Het basisdeelvenster dat door het framework wordt getest.

Retourwaarde

WAAR indien pBar is afgeleid van CMFCAutoHideBar; ANDERS ONWAAR.

Opmerkingen

Als een basisvensterobject is afgeleid van CMFCAutoHideBar, kan het een CAutoHideDockSite.

CAutoHideDockSite::D ockPane

Hiermee wordt een deelvenster gekoppeld aan dit CAutoHideDockSite-object .

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

Parameterwaarden

pWnd
[in] Het deelvenster dat het framework dockt.

dockMethod
[in] Dockingopties voor het deelvenster.

lpRect
[in] Een rechthoek die de grenzen voor het gedokte deelvenster aangeeft.

Opmerkingen

De standaard implementatie maakt geen gebruik van de parameter dockMethod, die wordt verstrekt voor toekomstig gebruik.

Als lpRect NULL is, plaatst het framework het deelvenster op de standaardlocatie op de docksite. Als de docksite horizontaal is, bevindt de standaardlocatie zich uiterst links van de docksite. Anders bevindt de standaardlocatie zich boven aan de docksite.

CAutoHideDockSite::GetAlignRect

Hiermee haalt u de grootte van de docksite op in schermcoördinaten.

void GetAlignRect(CRect& rect) const;

Parameterwaarden

Rect
[in] Een verwijzing naar een rechthoek. Met de methode wordt de grootte van de docksite opgeslagen in deze rechthoek.

Opmerkingen

De rechthoek wordt aangepast voor de offsetmarges, zodat deze niet zijn opgenomen.

CAutoHideDockSite::m_nExtraSpace

De grootte van de ruimte tussen de randen van de CAutoHideDockSite-klasse en de CMFCAutoHideBar-klasseobjecten .

static int m_nExtraSpace;

Opmerkingen

Wanneer een CMFCAutoHideBar dock op een CAutoHideDockSiteis gedokt, mag deze niet de hele docksite bezetten. Deze globale variabele bepaalt de extra ruimte tussen de linker- of bovenrand van de CMFCAutoHideBar en de bijbehorende CAutoHideDockSite rand. Of de boven- of linkerrand wordt gebruikt, is afhankelijk van de huidige uitlijning.

CAutoHideDockSite::SetOffsetLeft

Hiermee stelt u de marge aan de linkerkant van de dockingbalk in.

void SetOffsetLeft(int nOffset);

Parameterwaarden

nOffset
[in] De nieuwe offset.

Opmerkingen

CMFCAutoHideBar-objecten worden statisch op het CAutoHideDockSite object geplaatst. Dit betekent dat de gebruiker de locatie van CMFCAutoHideBar objecten niet handmatig kan wijzigen. De SetOffsetLeft methode bepaalt de afstand tussen de linkerkant van de meest CMFCAutoHideBar linkse en de linkerkant van de CAutoHideDockSite.

CAutoHideDockSite::SetOffsetRight

Hiermee stelt u de marge aan de rechterkant van de dockingbalk in.

void SetOffsetRight(int nOffset);

Parameterwaarden

nOffset
[in] De nieuwe offset.

Opmerkingen

CMFCAutoHideBar-objecten worden statisch op het CAutoHideDockSite object geplaatst. Dit betekent dat de gebruiker de locatie van de CMFCAutoHideBar objecten niet handmatig kan wijzigen. De SetOffsetRight methode bepaalt de afstand tussen de rechterkant van de meest CMFCAutoHideBar rechtse en de rechterkant van de CAutoHideDockSite.

CAutoHideDockSite::RepositionPanes

De deelvensters op de CAutoHideDockSite opnieuw tekenen.

virtual void RepositionPanes(CRect& rectNewClientArea);

Parameterwaarden

rectNewClientArea
[in] Een gereserveerde waarde.

Opmerkingen

De standaard implementatie maakt geen gebruik van rectNewClientArea. Hiermee worden de deelvensters opnieuw getekend met de globale werkbalkmarges en knopafstand.

CAutoHideDockSite::UnSetAutoHideMode

Roept CMFCAutoHideBar::UnSetAutoHideMode aan voor objecten op de docksite.

void UnSetAutoHideMode(CMFCAutoHideBar* pAutoHideToolbar);

Parameterwaarden

pAutoHideToolbar
[in] Een aanwijzer naar een CMFCAutoHideBar-objectvenster dat zich op het CAutoHideDockSiteobject bevindt.

Opmerkingen

Met deze methode wordt gezocht naar de rij die pAutoHideToolbar bevat. Hiermee worden alle CMFCAutoHideBar objecten in die rij aanroepenCMFCAutoHideBar.UnSetAutoHideMode. Als pAutoHideToolbar niet wordt gevonden of null is, roept CMFCAutoHideBar.UnSetAutoHideMode deze methode alle CMFCAutoHideBar objecten op de CAutoHideDockSite.

Zie ook

Hiërarchiegrafiek
Klassen
CDockSite-klasse