Share via

CDockablePane-klasse

  • Artikel

Implementeert een deelvenster dat kan worden gedokt op een docksite of in een deelvenster met tabbladen.

Syntaxis

class CDockablePane : public CPane

Leden

Openbare constructors

Naam Beschrijving
CDockablePane::CDockablePane Een CDockablePane-object samenstellen en initialiseren.

Openbare methoden

Naam Beschrijving
CDockablePane::AttachToTabWnd Een deelvenster koppelen aan een ander deelvenster. Hiermee maakt u een deelvenster met tabbladen.
CDockablePane::CalcFixedLayout Retourneert de grootte van de rechthoek van het deelvenster.
CDockablePane::CanAcceptMiniFrame Bepaalt of het opgegeven miniframe kan worden gekoppeld aan het deelvenster.
CDockablePane::CanAcceptPane Bepaalt of een ander deelvenster kan worden gekoppeld aan het huidige deelvenster.
CDockablePane::CanAutoHide Bepaalt of het deelvenster ondersteuning biedt voor de modus voor automatisch verbergen. (Overschrijft CBasePane::CanAutoHide.)
CDockablePane::CanBeAttached Bepaalt of het huidige deelvenster kan worden gekoppeld aan een ander deelvenster.
CDockablePane::ConvertToTabbedDocument Converteert een of meer dockable deelvensters naar documenten met tabbladen met MDI.
CDockablePane::CopyState Hiermee kopieert u de status van een dockable-deelvenster.
CDockablePane::Create Hiermee maakt u het Windows-besturingselement en koppelt u dit aan het CDockablePane-object.
CDockablePane::CreateDefaultPaneDivider Hiermee maakt u een standaardscheidingslijn voor het deelvenster terwijl het wordt gekoppeld aan een framevenster.
CDockablePane::CreateEx Hiermee maakt u het Windows-besturingselement en koppelt u dit aan het CDockablePane-object.
CDockablePane::CreateTabbedPane Hiermee maakt u een deelvenster met tabbladen van het huidige deelvenster.
CDockablePane::DockPaneContainer Hiermee wordt een container aan het deelvenster gekoppeld.
CDockablePane::DockPaneStandard Dockt een deelvenster met behulp van overzicht (standaard) docking.
CDockablePane::DockToFrameWindow Intern gebruikt. Als u een deelvenster wilt docken, gebruikt u CPane::DockPane of CDockablePane::DockToWindow.
CDockablePane::DockToRecentPos Dockt een deelvenster op de opgeslagen recente dockingpositie.
CDockablePane::DockToWindow Docks één dockingvenster naar een ander dockingvenster.
CDockablePane::EnableAutohideAll Hiermee schakelt u de modus voor automatisch verbergen voor dit deelvenster in of uit, samen met andere deelvensters in de container.
CDockablePane::EnableGripper Hiermee wordt het bijschrift (grijper) weergegeven of verborgen.
CDockablePane::GetAHRestoredRect Hiermee geeft u de positie van het deelvenster op wanneer dit zichtbaar is in de modus voor automatisch verbergen.
CDockablePane::GetAHSlideMode Hiermee wordt de diamodus voor het deelvenster automatisch verborgen.
CDockablePane::GetAutoHideButton Intern gebruikt.
CDockablePane::GetAutoHideToolBar Intern gebruikt.
CDockablePane::GetCaptionHeight Retourneert de hoogte van het huidige bijschrift.
CDockablePane::GetDefaultPaneDivider Retourneert de standaarddeelvensterscheiding voor de container van het deelvenster.
CDockablePane::GetDockingStatus Bepaalt de mogelijkheid van een deelvenster dat moet worden gedokt op basis van de opgegeven aanwijzerlocatie.
CDockablePane::GetDragSensitivity Retourneert de gevoeligheid voor slepen van een dockingvenster.
CDockablePane::GetLastPercentInPaneContainer Hiermee wordt het percentage ruimte opgehaald dat een deelvenster in de container inneemt.
CDockablePane::GetTabArea Hiermee haalt u het tabbladgebied voor het deelvenster op.
CDockablePane::GetTabbedPaneRTC Retourneert de runtimeklasse-informatie over een venster met tabbladen dat wordt gemaakt wanneer een ander deelvenster aan het huidige deelvenster wordt gekoppeld.
CDockablePane::HasAutoHideMode Hiermee geeft u op of een dockingvenster kan worden overgeschakeld naar de modus voor automatisch verbergen.
CDockablePane::HitTest Hiermee geeft u de specifieke locatie in een deelvenster waarin de gebruiker op een muis klikt.
CDockablePane::IsAccessibilityCompatible Intern gebruikt.
CDockablePane::IsAutohideAllEnabled Hiermee wordt aangegeven of het dockingvenster en alle andere deelvensters in de container in de modus automatisch verbergen kunnen worden geplaatst.
CDockablePane::IsAutoHideMode Bepaalt of een deelvenster zich in de modus automatisch verbergen bevindt.
CDockablePane::IsChangeState Intern gebruikt.
CDockablePane::IsDocked Bepaalt of het huidige deelvenster is gekoppeld.
CDockablePane::IsHideInAutoHideMode Bepaalt het gedrag van een deelvenster dat zich in de modus automatisch verbergen bevindt als het wordt weergegeven (of verborgen) door ShowPaneaan te roepen.
CDockablePane::IsInFloatingMultiPaneFrameWnd Hiermee geeft u op of het deelvenster zich in een framevenster met meerdere deelvensters bevindt.
CDockablePane::IsResizable Hiermee geeft u op of het deelvenster kan worden aangepast.
CDockablePane::IsTabLocationBottom Hiermee geeft u op of tabbladen zich boven of onder aan het deelvenster bevinden.
CDockablePane::IsTracked Hiermee geeft u op of een deelvenster wordt gesleept door de gebruiker.
CDockablePane::IsVisible Bepaalt of het huidige deelvenster zichtbaar is.
CDockablePane::LoadState Intern gebruikt.
CDockablePane::OnAfterChangeParent Aangeroepen door het framework wanneer het bovenliggende element van een deelvenster is gewijzigd. (Overschrijft CPane::OnAfterChangeParent.)
CDockablePane::OnAfterDockFromMiniFrame Aangeroepen door het framework wanneer een zwevende dockingbalk dokken in een framevenster.
CDockablePane::OnBeforeChangeParent Aangeroepen door het framework wanneer het bovenliggende deelvenster op het punt staat te veranderen. (Overschrijft CPane::OnBeforeChangeParent.)
CDockablePane::OnBeforeFloat Aangeroepen door het framework wanneer een deelvenster op het punt staat te zweven. (Overschrijft CPane::OnBeforeFloat.)
CDockablePane::RemoveFromDefaultPaneDividier In het framework wordt deze methode aangeroepen wanneer een deelvenster wordt losgekoppeld.
CDockablePane::ReplacePane Vervangt het deelvenster door een opgegeven deelvenster.
CDockablePane::RestoreDefaultPaneDivider In het framework wordt deze methode aangeroepen als een deelvenster wordt gedeserialiseerd om de standaarddeelvensterscheiding te herstellen.
CDockablePane::SaveState Intern gebruikt.
CDockablePane::Serialize Serialiseert het deelvenster. (Overschrijft CBasePane::Serialize.)
CDockablePane::SetAutoHideMode Hiermee schakelt u het dockingvenster tussen de zichtbare en automatische verbergmodus in.
CDockablePane::SetAutoHideParents Hiermee stelt u de knop Automatisch verbergen in en verbergt u de werkbalk automatisch voor het deelvenster.
CDockablePane::SetDefaultPaneDivider Intern gebruikt.
CDockablePane::SetLastPercentInPaneContainer Hiermee stelt u het percentage ruimte in dat een deelvenster in de container in beslag neemt.
CDockablePane::SetResizeMode Intern gebruikt.
CDockablePane::SetRestoredDefaultPaneDivider Hiermee stelt u de herstelde standaarddeelvensterscheiding in.
CDockablePane::SetTabbedPaneRTC Hiermee stelt u de runtimeklasse-informatie in voor een venster met tabbladen dat wordt gemaakt wanneer twee deelvensters samen worden vastgezet.
CDockablePane::ShowPane Een deelvenster weergeven of verbergen.
CDockablePane::Slide Hiermee wordt een deelvenster met een schuifanimatie weergegeven of verborgen die alleen wordt weergegeven wanneer het deelvenster zich in de modus automatisch verbergen bevindt.
CDockablePane::ToggleAutoHide Hiermee schakelt u de modus voor automatisch verbergen in. (Onderdrukkingen CPane::ToggleAutoHide .)
CDockablePane::UndockPane Ontkoppelt een deelvenster vanuit het hoofdframevenster of een miniframevenstercontainer.
CDockablePane::UnSetAutoHideMode Intern gebruikt. Als u de modus automatisch verbergen wilt instellen, gebruikt u CDockablePane::SetAutoHideMode

Beveiligde methoden

Naam Beschrijving
CDockablePane::CheckAutoHideCondition Bepaalt of het dockingvenster verborgen is (in de modus voor automatisch verbergen).
CDockablePane::CheckStopSlideCondition Bepaalt wanneer een dockingvenster automatisch verbergen moet stoppen met verschuiven.
CDockablePane::DrawCaption Hiermee tekent u het bijschrift van het dockingvenster (gripper).
CDockablePane::OnPressButtons Wordt aangeroepen wanneer de gebruiker op een andere bijschriftknop drukt dan de knoppen AFX_HTCLOSE en AFX_HTMAXBUTTON.
CDockablePane::OnSlide Aangeroepen door het framework om het dia-effect automatisch verbergen weer te geven wanneer het deelvenster wordt weergegeven of verborgen.

Gegevensleden

Naam Beschrijving
CDockablePane::m_bDisableAnimation Hiermee geeft u op of animatie van het dockable-deelvenster automatisch wordt uitgeschakeld.
CDockablePane::m_bHideInAutoHideMode Bepaalt het gedrag van het deelvenster wanneer het deelvenster zich in de modus automatisch verbergen bevindt.
CDockablePane::m_nSlideSteps Hiermee geeft u de animatiesnelheid van het deelvenster op wanneer het wordt weergegeven of verborgen in de modus voor automatisch verbergen.

Opmerkingen

CDockablePane implementeert de volgende functionaliteit:

  • Een deelvenster aan een hoofdframevenster koppelen.

  • Een deelvenster overschakelen naar de modus voor automatisch verbergen.

  • Een deelvenster koppelen aan een venster met tabbladen.

  • Zwevend een deelvenster in een miniframevenster.

  • Een deelvenster koppelen aan een ander deelvenster dat in een miniframevenster zweeft.

  • Het formaat van een deelvenster wijzigen.

  • Laad- en opslagstatus voor een dockingvenster.

    Notitie

    Statusgegevens worden opgeslagen in het Windows-register.

  • Een deelvenster maken met of zonder bijschrift. Het bijschrift kan een tekstlabel hebben en kan worden gevuld met een kleurovergang.

  • Een deelvenster slepen terwijl de inhoud van het deelvenster wordt weergegeven

  • Een deelvenster slepen tijdens het weergeven van een rechthoek voor slepen.

Als u een dockingvenster in uw toepassing wilt gebruiken, moet u de deelvensterklasse afleiden uit de CDockablePane-klasse. Sluit het afgeleide object in het hoofdframevensterobject in of in een vensterobject waarmee het exemplaar van het deelvenster wordt beheerd. Roep vervolgens de methode CDockablePane::Create of de CDockablePane::CreateEx methode aan wanneer u het WM_CREATE bericht in het hoofdframevenster verwerkt. Stel ten slotte het deelvensterobject in door CBasePane::EnableDocking, CBasePane::DockPaneof CDockablePane::AttachToTabWndaan te roepen.

Tips voor aanpassing

De volgende tips zijn van toepassing op CDockablePane objecten:

  • Als u CDockablePane::AttachToTabWnd aanroept voor twee niet-tabs, vast te leggen deelvensters, wordt een aanwijzer naar een venster met tabbladen geretourneerd in de parameter ppTabbedControlBar. U kunt tabbladen blijven toevoegen aan het venster met tabbladen met behulp van deze parameter.

  • Het type deelvenster met tabbladen dat door CDockablePane::AttachToTabWnd wordt gemaakt, wordt bepaald door het CDockablePane-object in de parameter pTabControlBarAttachTo. U kunt CDockablePane::SetTabbedPaneRTC aanroepen om het type deelvenster met tabbladen in te stellen dat door de CDockablePane wordt gemaakt. Het standaardtype wordt bepaald door de dwTabbedStyle van CDockablePane::Create wanneer u de CDockablePanevoor het eerst maakt. Als dwTabbedStyle is AFX_CBRS_OUTLOOK_TABS is het standaardtype CMFCOutlookBar Klasse; als dwTabbedStyle is AFX_CBRS_REGULAR_TABS is het standaardtype CTabbedPane Klasse.

  • Als u het ene dockable-deelvenster naar het andere wilt koppelen, roept u de methode CDockablePane::DockToWindow aan. Het oorspronkelijke deelvenster moet ergens worden vastgezet voordat u deze methode aanroept.

  • De lidvariabele CDockablePane::m_bHideInAutoHideMode bepaalt hoe dockable deelvensters zich gedragen in de modus automatisch verbergen wanneer u CDockablePane::ShowPaneaanroept. Als deze lidvariabele is ingesteld op TRUE, worden gekoppelde deelvensters en de knoppen voor automatisch verbergen verborgen. Anders schuiven ze in en uit.

  • U kunt animatie automatisch verbergen uitschakelen door de CDockablePane::m_bDisableAnimation lidvariabele in te stellen op TRUE.

Voorbeeld

In het volgende voorbeeld ziet u hoe u een CDockablePane-object configureert met behulp van verschillende methoden in de CDockablePane-klasse. In het voorbeeld ziet u hoe u de functie voor automatisch verbergen inschakelt voor het dockable-deelvenster, het bijschrift of de greep inschakelt, de modus automatisch verbergen inschakelt, het deelvenster weergeeft en een deelvenster animeren dat zich in de modus Automatisch verbergen bevindt. Dit codefragment maakt deel uit van het Visual Studio Demo-voorbeeld.

// GetOwner is an inherited method.
CDockablePane *pParentBar = DYNAMIC_DOWNCAST(CDockablePane, GetOwner());

pParentBar->EnableAutohideAll();
pParentBar->EnableGripper(true);
pParentBar->SetAutoHideMode(true, CBRS_ALIGN_LEFT);
pParentBar->ShowPane(true, false, true);
pParentBar->Slide(true);

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CBasePane

CPane

CDockablePane

Eisen

koptekst:afxDockablePane.h

CDockablePane::AttachToTabWnd

Hiermee koppelt u het huidige deelvenster aan een doelvenster en maakt u een deelvenster met tabbladen.

virtual CDockablePane* AttachToTabWnd(
    CDockablePane* pTabControlBarAttachTo,
    AFX_DOCK_METHOD dockMethod,
    BOOL bSetActive= TRUE,
    CDockablePane** ppTabbedControlBar = NULL);

Parameters

pTabControlBarAttachTo
[in, uit] Hiermee geeft u het doelvenster waaraan het huidige deelvenster wordt gekoppeld. Het doelvenster moet een dockable deelvenster zijn.

dockMethod
[in] Hiermee geeft u de dockingmethode.

bSetActive
[in] TRUE om het deelvenster met tabbladen te activeren na de bijlagebewerking; anders, FALSE.

ppTabbedControlBar
[uit] Bevat het deelvenster met tabbladen dat het resultaat is van de bijlagebewerking.

Retourwaarde

Een aanwijzer naar het huidige deelvenster als het geen deelvenster met tabbladen is; anders een aanwijzer naar het deelvenster met tabbladen dat het resultaat is van de bijlagebewerking. De retourwaarde wordt NULL als het huidige deelvenster niet kan worden gekoppeld of als er een fout optreedt.

Opmerkingen

Wanneer het ene dockable-deelvenster aan een ander deelvenster wordt gekoppeld met deze methode, gebeurt het volgende:

  1. Het framework controleert of het doelvenster pTabControlBarAttachTo een normaal dockingvenster is of dat het is afgeleid van CBaseTabbedPane.

  2. Als het doelvenster een deelvenster met tabbladen is, wordt het huidige deelvenster toegevoegd als een tabblad.

  3. Als het doelvenster een normaal dockingvenster is, maakt het framework een deelvenster met tabbladen.

    • Het framework roept pTabControlBarAttachTo->CreateTabbedPaneaan. De stijl van het nieuwe deelvenster met tabbladen is afhankelijk van het m_pTabbedControlBarRTC lid. Dit lid is standaard ingesteld op de runtimeklasse van CTabbedPane. Als u de AFX_CBRS_OUTLOOK_TABS-stijl doorgeeft als de parameter dwTabbedStyle aan de methode CDockablePane::Create, wordt het runtimeklasseobject ingesteld op de runtimeklasse van CMFCOutlookBar. U kunt dit lid op elk gewenst moment wijzigen om de stijl van het nieuwe deelvenster te wijzigen.

    • Wanneer deze methode een deelvenster met tabbladen maakt, vervangt het framework de aanwijzer naar pTabControlBarAttachTo (als het deelvenster is gedokt of zwevend in een venster met meerdere miniframes) door een aanwijzer naar het nieuwe deelvenster met tabbladen.

    • Het framework voegt het pTabControlBarAttachTo deelvenster toe aan het deelvenster met tabbladen als het eerste tabblad. Het framework voegt vervolgens het huidige deelvenster toe als een tweede tabblad.

  4. Als het huidige deelvenster is afgeleid van CBaseTabbedPane, worden alle tabbladen verplaatst naar pTabControlBarAttachTo en wordt het huidige deelvenster vernietigd. Wees daarom voorzichtig wanneer u deze methode aanroept, omdat een aanwijzer naar het huidige deelvenster mogelijk ongeldig is wanneer de methode wordt geretourneerd.

Als u het ene deelvenster aan een ander deelvenster koppelt bij het bouwen van een dockingindeling, stelt u dockMethod in op DM_SHOW.

U moet het eerste deelvenster docken voordat u er een ander deelvenster aan koppelt.

CDockablePane::CalcFixedLayout

Retourneert de grootte van de rechthoek van het deelvenster.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parameters

bStretch
[in] Niet gebruikt.

bHorz
[in] Niet gebruikt.

Retourwaarde

Een CSize-object dat de grootte van de rechthoek van het deelvenster bevat.

CDockablePane::CanAcceptMiniFrame

Bepaalt of het opgegeven miniframe kan worden gekoppeld aan het deelvenster.

virtual BOOL CanAcceptMiniFrame(CPaneFrameWnd* pMiniFrame) const;

Parameters

pMiniFrame
[in] Aanwijzer naar een CPaneFrameWnd-object.

Retourwaarde

TRUE als pMiniFrame in het deelvenster kan worden gedokt; anders, FALSE.

CDockablePane::CanAcceptPane

Bepaalt of een ander deelvenster kan worden gekoppeld aan het huidige deelvenster.

virtual BOOL CanAcceptPane(const CBasePane* pBar) const;

Parameters

pBar
[in] Hiermee geeft u het deelvenster dat moet worden gekoppeld aan het huidige deelvenster.

Retourwaarde

TRUE als het opgegeven deelvenster kan worden gekoppeld aan dit deelvenster; anders, FALSE.

Opmerkingen

Dit framework roept deze methode aan voordat een deelvenster wordt gekoppeld aan het huidige deelvenster.

Overschrijf deze functie in een afgeleide klasse om docking naar een specifiek deelvenster in of uit te schakelen.

Deze methode retourneert standaard TRUE als pBar of het bovenliggende element van het type CDockablePaneis.

CDockablePane::CanAutoHide

Bepaalt of het deelvenster automatisch kan worden verborgen.

virtual BOOL CanAutoHide() const;

Retourwaarde

TRUE als het deelvenster automatisch kan worden verborgen; anders, FALSE.

Opmerkingen

CDockablePane::CanAutoHide retourneert FALSE in een van de volgende situaties:

  • Het deelvenster heeft geen bovenliggend element.

  • Het dockingbeheer staat niet toe dat deelvensters automatisch worden verborgen.

  • Het deelvenster is niet vastgezet.

CDockablePane::CanBeAttached

Bepaalt of het huidige deelvenster kan worden gekoppeld aan een ander deelvenster.

virtual BOOL CanBeAttached() const;

Retourwaarde

TRUE als het bekbare deelvenster kan worden gedokt naar een ander deelvenster of naar het hoofdframevenster; anders, FALSE.

Opmerkingen

Deze methode retourneert standaard altijd TRUE. Overschrijf deze methode in een afgeleide klasse om docking in of uit te schakelen zonder CBasePane::EnableDockingaan te roepen.

CDockablePane::CDockablePane

Een CDockablePane-object samenstellen en initialiseren.

CDockablePane();

Opmerkingen

Nadat u een dockable deelvensterobject hebt gemaakt, roept u CDockablePane::Create of CDockablePane::CreateEx aan om het te maken.

CDockablePane::ConvertToTabbedDocument

Converteert een of meer dockable deelvensters naar documenten met tabbladen met MDI.

virtual void ConvertToTabbedDocument(BOOL bActiveTabOnly = TRUE);

Parameters

bActiveTabOnly
[in] Wanneer u een CTabbedPaneconverteert, geeft u TRUE op om alleen het actieve tabblad te converteren. Geef FALSE op om alle tabbladen in het deelvenster te converteren.

CDockablePane::CheckAutoHideCondition

Bepaalt of het dockingvenster verborgen is (ook wel autohidemodus genoemd).

virtual BOOL CheckAutoHideCondition();

Retourwaarde

TRUE als aan de verbergvoorwaarde wordt voldaan; anders, FALSE.

Opmerkingen

Het framework gebruikt een timer om periodiek te controleren of een deelvenster voor automatisch zichtbaar maken moet worden verborgen. De methode retourneert TRUE wanneer het deelvenster niet actief is, het deelvenster wordt niet gewijzigd en de muisaanwijzer zich niet boven het deelvenster bevindt.

Als aan alle eerdere voorwaarden wordt voldaan, roept het framework CDockablePane::Slide aan om het deelvenster te verbergen.

CDockablePane::CheckStopSlideCondition

Bepaalt wanneer een automatisch zichtbaar dockingvenster moet stoppen met verschuiven.

virtual BOOL CheckStopSlideCondition(BOOL bDirection);

Parameters

bDirection
[in] TRUE als het deelvenster zichtbaar is; FALSE als het deelvenster is verborgen.

Retourwaarde

TRUE als aan de stopvoorwaarde wordt voldaan; anders, FALSE.

Opmerkingen

Wanneer een beveiligbaar deelvenster is ingesteld op de modus Automatisch zichtbaar maken, gebruikt het framework schuifeffecten om het deelvenster weer te geven of te verbergen. Dit framework roept deze functie aan wanneer het deelvenster schuift. CheckStopSlideCondition retourneert TRUE wanneer het deelvenster volledig zichtbaar is of wanneer het volledig verborgen is.

Overschrijf deze methode in een afgeleide klasse om aangepaste effecten voor automatisch zichtbaar maken te implementeren.

CDockablePane::CopyState

Hiermee kopieert u de status van een dockable-deelvenster.

virtual void CopyState(CDockablePane* pOrgBar);

Parameters

pOrgBar
[in] Een aanwijzer naar een bekeerbaar deelvenster.

Opmerkingen

CDockablePane::CopyState kopieert de status van pOrgBar naar het huidige deelvenster door de volgende methoden aan te roepen:

CDockablePane::Create

Hiermee maakt u het Windows-besturingselement en koppelt u dit aan het CDockablePane-object.

virtual BOOL Create(
    LPCTSTR lpszCaption,
    CWnd* pParentWnd,
    const RECT& rect,
    BOOL bHasGripper,
    UINT nID,
    DWORD dwStyle,
    DWORD dwTabbedStyle = AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE,
    CCreateContext* pContext = NULL);

virtual BOOL Create(
    LPCTSTR lpszWindowName,
    CWnd* pParentWnd,
    CSize sizeDefault,
    BOOL bHasGripper,
    UINT nID,
    DWORD dwStyle = WS_CHILD|WS_VISIBLE|CBRS_TOP|CBRS_HIDE_INPLACE,
    DWORD dwTabbedStyle = AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE);

Parameters

lpszCaption
[in] Hiermee geeft u de naam van het venster.

pParentWnd
[in, uit] Hiermee geeft u het bovenliggende venster.

rect
[in] Hiermee geeft u de grootte en positie van het venster, in clientcoördinaten van pParentWnd.

bHasGripper
[in] TRUE om het deelvenster te maken met een bijschrift; anders, FALSE.

nID
[in] Hiermee geeft u de id van het onderliggende venster. Deze waarde moet uniek zijn als u de dockingstatus voor dit dockingvenster wilt opslaan.

dwStyle
[in] Hiermee geeft u de stijlkenmerken van het venster.

dwTabbedStyle
[in] Hiermee geeft u de stijl voor tabbladen op van een venster met tabbladen dat wordt gemaakt wanneer de gebruiker een deelvenster sleept op het bijschrift van dit deelvenster.

dwControlBarStyle
[in] Hiermee geeft u aanvullende stijlkenmerken.

pContext
[in, uit] Hiermee geeft u de context van het venster maken.

lpszWindowName
[in] Hiermee geeft u de naam van het venster.

sizeDefault
[in] Hiermee geeft u de grootte van het venster.

Retourwaarde

TRUE als het dockable-deelvenster is gemaakt; anders, FALSE.

Opmerkingen

Hiermee maakt u een Windows-deelvenster en koppelt u het aan het CDockablePane-object.

Als de dwStyle vensterstijl de vlag CBRS_FLOAT_MULTI heeft, kan het miniframevenster met andere deelvensters in het miniframevenster zweven. Standaard kunnen dockingvensters alleen afzonderlijk zweven.

Als voor de parameter dwTabbedStyle de AFX_CBRS_OUTLOOK_TABS vlag is opgegeven, maakt het deelvenster deelvensters met tabbladen in Outlook-stijl wanneer een ander deelvenster aan dit deelvenster is gekoppeld met behulp van de methode CDockablePane::AttachToTabWnd. Standaard maken dockable-deelvensters normale deelvensters met tabbladen van het type CTabbedPane.

CDockablePane::CreateDefaultPaneDivider

Hiermee maakt u een standaardscheidingslijn voor het deelvenster terwijl het wordt gekoppeld aan een framevenster.

static CPaneDivider* __stdcall CreateDefaultPaneDivider(
    DWORD dwAlignment,
    CWnd* pParent,
    CRuntimeClass* pSliderRTC = NULL);

Parameters

dwAlignment
[in] Hiermee geeft u de zijkant van het hoofdframe waarop het deelvenster wordt vastgezet. Als dwAlignment de vlag CBRS_ALIGN_LEFT of CBRS_ALIGN_RIGHT bevat, wordt met deze methode een verticale scheidingslijn (CPaneDivider::SS_VERT) gemaakt; anders wordt met deze methode een horizontale (CPaneDivider::SS_HORZ) scheidingslijn gemaakt.

pParent
[in] Aanwijzer naar het bovenliggende frame.

pSliderRTC
[in] Niet gebruikt.

Retourwaarde

Deze methode retourneert een aanwijzer naar de zojuist gemaakte scheidingslijn of NULL als het maken van de scheidingslijn mislukt.

Opmerkingen

dwAlignment kan een van de volgende waarden zijn:

Waarde Beschrijving
CBRS_ALIGN_TOP Het deelvenster wordt aan de bovenkant van het clientgebied van een framevenster gedokt.
CBRS_ALIGN_BOTTOM Het deelvenster wordt onder aan het clientgebied van een framevenster gedokt.
CBRS_ALIGN_LEFT Het deelvenster wordt aan de linkerkant van het clientgebied van een framevenster gedokt.
CBRS_ALIGN_RIGHT Het deelvenster wordt aan de rechterkant van het clientgebied van een framevenster gedokt.

CDockablePane::CreateEx

Hiermee maakt u het Windows-besturingselement en koppelt u dit aan het CDockablePane-object.

virtual BOOL CreateEx(
    DWORD dwStyleEx,
    LPCTSTR lpszCaption,
    CWnd* pParentWnd,
    const RECT& rect,
    BOOL bHasGripper,
    UINT nID,
    DWORD dwStyle,
    DWORD dwTabbedStyle = AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE,
    CCreateContext* pContext = NULL);

Parameters

dwStyleEx
[in] Hiermee geeft u de uitgebreide stijlkenmerken voor het nieuwe venster.

lpszCaption
[in] Hiermee geeft u de naam van het venster.

pParentWnd
[in, uit] Hiermee geeft u het bovenliggende venster.

rect
[in] Hiermee geeft u de grootte en positie van het venster, in clientcoördinaten van pParentWnd.

bHasGripper
[in] TRUE om het deelvenster te maken met een bijschrift; anders, FALSE.

nID
[in] Hiermee geeft u de id van het onderliggende venster. Deze waarde moet uniek zijn als u de dockingstatus voor dit dockingvenster wilt opslaan.

dwStyle
[in] Hiermee geeft u de stijlkenmerken van het venster.

dwTabbedStyle
[in] Hiermee geeft u de stijl voor tabbladen op van een venster met tabbladen dat wordt gemaakt wanneer de gebruiker een deelvenster sleept op het bijschrift van dit deelvenster.

dwControlBarStyle
[in] Hiermee geeft u de aanvullende stijlkenmerken.

pContext
[in, uit] Hiermee geeft u de context van het venster maken.

Retourwaarde

TRUE als het dockable-deelvenster is gemaakt; anders, FALSE.

Opmerkingen

Hiermee maakt u een Windows-deelvenster en koppelt u het aan het CDockablePane-object.

Als de dwStyle vensterstijl de vlag CBRS_FLOAT_MULTI heeft, kan het miniframevenster met andere deelvensters in het miniframevenster zweven. Standaard kunnen dockingvensters alleen afzonderlijk zweven.

Als voor de parameter dwTabbedStyle de AFX_CBRS_OUTLOOK_TABS vlag is opgegeven, maakt het deelvenster deelvensters met tabbladen in Outlook-stijl wanneer een ander deelvenster aan dit deelvenster is gekoppeld met behulp van de methode CDockablePane::AttachToTabWnd. Standaard maken dockable-deelvensters normale deelvensters met tabbladen van het type CTabbedPane.

CDockablePane::CreateTabbedPane

Hiermee maakt u een deelvenster met tabbladen van het huidige deelvenster.

virtual CTabbedPane* CreateTabbedPane();

Retourwaarde

Het nieuwe deelvenster met tabbladen of NULL als de maakbewerking is mislukt.

Opmerkingen

In het framework wordt deze methode aangeroepen wanneer er een deelvenster met tabbladen wordt gemaakt om dit deelvenster te vervangen. Zie CDockablePane::AttachToTabWndvoor meer informatie.

Overschrijf deze methode in een afgeleide klasse om aan te passen hoe deelvensters met tabbladen worden gemaakt en geïnitialiseerd.

Het deelvenster met tabbladen wordt gemaakt op basis van de runtimeklassegegevens die zijn opgeslagen in het m_pTabbedControlBarRTC lid. Dit wordt geïnitialiseerd door de CDockablePane::CreateEx methode.

CDockablePane::DockPaneContainer

Hiermee wordt een container aan het deelvenster gekoppeld.

virtual BOOL DockPaneContainer(
    CPaneContainerManager& barContainerManager,
    DWORD dwAlignment,
    AFX_DOCK_METHOD dockMethod);

Parameters

barContainerManager
[in] Een verwijzing naar containerbeheer van de container die wordt gedokt.

dwAlignment
[in] DWORD die de zijkant van het deelvenster aangeeft waarnaar de container wordt gedokt.

dockMethod
[in] Niet gebruikt.

Retourwaarde

TRUE als de container is vastgezet in het deelvenster; anders, FALSE.

Opmerkingen

dwAlignment kan een van de volgende waarden zijn:

Waarde Beschrijving
CBRS_ALIGN_TOP De container wordt boven aan het deelvenster gedokt.
CBRS_ALIGN_BOTTOM De container wordt onder aan het deelvenster gedokt.
CBRS_ALIGN_LEFT De container wordt aan de linkerkant van het deelvenster gedokt.
CBRS_ALIGN_RIGHT De container wordt aan de rechterkant van het deelvenster gedokt.

CDockablePane::DockPaneStandard

Dockt een deelvenster met behulp van overzicht (standaard) docking.

virtual CPane* DockPaneStandard(BOOL& bWasDocked);

Parameters

bWasDocked
[in] Wanneer de methode wordt geretourneerd, bevat deze waarde TRUE als het deelvenster is gedokt; anders bevat het FALSE.

Retourwaarde

Als het deelvenster is gedokt in een venster met tabbladen of als er een venster met tabbladen is gemaakt als gevolg van docking, retourneert deze methode een aanwijzer naar het venster met tabbladen. Als het deelvenster anders is vastgezet, retourneert deze methode de this aanwijzer. Als docking is mislukt, retourneert deze methode NULL.

CDockablePane::DockToRecentPos

Koppelt een deelvenster aan de opgeslagen dockingpositie.

BOOL CDockablePane::DockToRecentPos();

Retourwaarde

TRUE als het deelvenster is gedokt; anders, FALSE.

Opmerkingen

Dockable-deelvensters slaan recente dockinggegevens op in een CRecentDockSiteInfo-object.

CDockablePane::DockToWindow

Docks één dockingvenster naar een ander dockingvenster.

virtual BOOL DockToWindow(
    CDockablePane* pTargetWindow,
    DWORD dwAlignment,
    LPCRECT lpRect = NULL);

Parameters

pTargetWindow
[in, uit] Hiermee geeft u het deelvenster dockable om dit deelvenster aan te koppelen.

dwAlignment
[in] Hiermee geeft u de dockinguitlijning voor het deelvenster. Kan een van CBRS_ALIGN_LEFT, CBRS_ALIGN_TOP, CBRS_ALIGN_RIGHT, CBRS_ALIGN_BOTTOM of CBRS_ALIGN_ANYzijn. (Gedefinieerd in afxres.h.)

lpRect
[in] Hiermee geeft u de dockingrechthoek voor het deelvenster.

Retourwaarde

TRUE als het deelvenster is vastgezet; anders, FALSE.

Opmerkingen

Roep deze methode aan om het ene deelvenster aan een ander deelvenster te koppelen met de uitlijning die is opgegeven door dwAlignment.

CDockablePane::DrawCaption

Hiermee tekent u het bijschrift (ook wel de greep genoemd) van een dockingvenster.

virtual void DrawCaption(
    CDC* pDC,
    CRect rectCaption);

Parameters

pDC
[in] Vertegenwoordigt de apparaatcontext die wordt gebruikt voor tekenen.

rectCaption
[in] Hiermee geeft u de begrenzingsrechthoek van het bijschrift van het deelvenster op.

Opmerkingen

In het framework wordt deze methode aangeroepen om het bijschrift van een dockable-deelvenster te tekenen.

Overschrijf deze methode in een afgeleide klasse om het uiterlijk van het bijschrift aan te passen.

CDockablePane::EnableAutohideAll

Hiermee schakelt u de modus Automatisch zichtbaar maken in of uit voor dit deelvenster en voor andere deelvensters in de container.

void EnableAutohideAll(BOOL bEnable = TRUE);

Parameters

bEnable
[in] TRUE om de functie automatisch zichtbaar te maken voor het dockable-deelvenster; anders, FALSE.

Opmerkingen

Wanneer een gebruiker de Ctrl--toets ingedrukt houdt en op de knop Vastmaken klikt om een deelvenster om de modus Automatisch zichtbaar te maken, worden alle andere deelvensters in dezelfde container ook overgeschakeld naar de modus Automatisch zichtbaar maken.

Roep deze methode aan met bEnable ingesteld op FALSE om deze functie voor een bepaald deelvenster uit te schakelen.

CDockablePane::EnableGripper

Hiermee wordt het bijschrift (ook wel de grijper genoemd) weergegeven of verborgen.

virtual void EnableGripper(BOOL bEnable);

Parameters

bEnable
[in] TRUE om het bijschrift in te schakelen; anders, FALSE.

Opmerkingen

Wanneer het framework dockable deelvensters maakt, hebben ze niet de WS_STYLE vensterstijl, zelfs niet indien opgegeven. Dit betekent dat het bijschrift van het deelvenster een niet-clientgebied is dat wordt beheerd door het framework, maar dit gebied verschilt van het standaardvensterbijschrift.

U kunt het bijschrift op elk gewenst moment weergeven of verbergen. Het framework verbergt het bijschrift wanneer een deelvenster wordt toegevoegd als een tabblad aan een venster met tabbladen of wanneer een deelvenster wordt zweven in een miniframevenster.

CDockablePane::GetAHRestoredRect

Hiermee geeft u de positie van het deelvenster op in de modus Automatisch verbergen.

CRect GetAHRestoredRect() const;

Retourwaarde

Een CRect-object dat de positie van het deelvenster bevat wanneer het zich in de modus automatisch verbergen bevindt.

Opmerkingen

CDockablePane::GetAHSlideMode

Hiermee wordt de diamodus voor het deelvenster automatisch verborgen.

virtual UINT GetAHSlideMode() const;

Retourwaarde

Een UINT die de diamodus automatisch verbergen voor het deelvenster aangeeft. De retourwaarde kan AFX_AHSM_MOVE of AFX_AHSM_STRETCHzijn, maar de implementatie maakt alleen gebruik van AFX_AHSM_MOVE.

Opmerkingen

CDockablePane::GetCaptionHeight

Retourneert de hoogte, in pixels, van het huidige bijschrift.

virtual int GetCaptionHeight() const;

Retourwaarde

De hoogte van het bijschrift, in pixels.

Opmerkingen

De hoogte van het bijschrift is 0 als het bijschrift is verborgen door de methode CDockablePane::EnableGripper of als het deelvenster geen bijschrift heeft.

CDockablePane::GetDefaultPaneDivider

Retourneert de standaarddeelvensterscheiding voor de container van het deelvenster.

CPaneDivider* GetDefaultPaneDivider() const;

Retourwaarde

Een geldig CPaneDivider-object als het dockable-deelvenster is gekoppeld aan het hoofdframevenster of NULL als het dockable-deelvenster niet is gedokt of als het zwevend is.

Opmerkingen

Zie CPaneDivider Klassevoor meer informatie over deelvensterscheidingslijnen.

CDockablePane::GetDockingStatus

Bepaalt de mogelijkheid van een deelvenster dat moet worden gedokt op basis van de opgegeven aanwijzerlocatie.

virtual AFX_CS_STATUS GetDockingStatus(
    CPoint pt,
    int nSensitivity);

Parameters

pt
[in] De locatie van de aanwijzer in schermcoördinaten.

nSensitivity
[in] De afstand, in pixels, weg van de rand van een rechthoek, moet de aanwijzer zijn om docking in te schakelen.

Retourwaarde

Een van de volgende statuswaarden:

AFX_CS_STATUS waarde Betekenis
CS_NOTHING De aanwijzer bevindt zich niet boven een docksite. Het framework dockt het deelvenster niet.
CS_DOCK_IMMEDIATELY De aanwijzer bevindt zich op de docksite in de directe modus (in het deelvenster wordt de DT_IMMEDIATE dockingmodus gebruikt). Het framework dockt het deelvenster onmiddellijk.
CS_DELAY_DOCK De aanwijzer bevindt zich boven een docksite die een ander dockingvenster is of een rand van het hoofdframe is. Het framework dockt het deelvenster na een vertraging. Zie de sectie Opmerkingen voor meer informatie over deze vertraging.
CS_DELAY_DOCK_TO_TAB De aanwijzer bevindt zich op een docksite die ervoor zorgt dat het deelvenster in een venster met tabbladen wordt gedokt. Dit gebeurt wanneer de aanwijzer zich boven het bijschrift van een ander dockingvenster of op het tabbladgebied van een deelvenster met tabbladen bevindt.

Opmerkingen

In het framework wordt deze methode aangeroepen voor het afhandelen van docking van een zwevend deelvenster.

Voor zwevende werkbalken of dockingvensters die gebruikmaken van de DT_IMMEDIATE dockingmodus, vertraagt het framework de dockopdracht om de gebruiker in staat te stellen het venster uit het clientgebied van het bovenliggende frame te verplaatsen voordat het dokken plaatsvindt. De lengte van de vertraging wordt gemeten in milliseconden en wordt bepaald door het CDockingManager::m_nTimeOutBeforeToolBarDock gegevenslid. De standaardwaarde van CDockingManager::m_nTimeOutBeforeToolBarDock is 200. Dit gedrag emuleert het dockinggedrag van Microsoft Word 2007.

Voor vertraagde dockingstatussen (CS_DELAY_DOCK en CS_DELAY_DOCK_TO_TAB), wordt het framework pas uitgevoerd als de gebruiker de muisknop loslaat. Als in een deelvenster de DT_STANDARD dockingmodus wordt gebruikt, wordt in het framework een rechthoek weergegeven op de geprojecteerde dockinglocatie. Als in een deelvenster de DT_SMART dockingmodus wordt gebruikt, worden in het framework slimme dockingmarkeringen en semitransparante rechthoeken weergegeven op de geprojecteerde dockinglocatie. Als u de dockingmodus voor het deelvenster wilt opgeven, roept u de methode CBasePane::SetDockingMode aan. Zie CDockingManager::GetSmartDockingParamsvoor meer informatie over slim dokken.

CDockablePane::GetDragSensitivity

Retourneert de gevoeligheid voor slepen van een dockingvenster.

static const CSize& GetDragSensitivity();

Retourwaarde

Een CSize-object met de breedte en hoogte, in pixels, van een rechthoek die is gecentreerd op een sleeppunt. De sleepbewerking begint pas wanneer de muis aanwijzer buiten deze rechthoek wordt verplaatst.

CDockablePane::GetLastPercentInPaneContainer

Hiermee wordt het percentage ruimte opgehaald dat een deelvenster in de container inneemt (CPaneContainer Klasse).

int GetLastPercentInPaneContainer() const;

Retourwaarde

Een int die het percentage ruimte aangeeft dat het deelvenster in de container inneemt.

Opmerkingen

Deze methode wordt gebruikt wanneer de container de indeling aanpast.

CDockablePane::GetTabArea

Hiermee haalt u het tabbladgebied voor het deelvenster op.

virtual void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const;

Parameters

rectTabAreaTop
[in] GetTabArea deze variabele vult met het tabbladgebied als de tabbladen zich boven aan het deelvenster bevinden. Als tabbladen zich onder aan het deelvenster bevinden, wordt deze variabele gevuld met een lege rechthoek.

rectTabAreaBottom
[in] GetTabArea deze variabele vult met het tabbladgebied als de tabbladen zich onder aan het deelvenster bevinden. Als tabbladen zich boven aan het deelvenster bevinden, wordt deze variabele gevuld met een lege rechthoek.

Opmerkingen

Deze methode wordt alleen gebruikt in klassen die zijn afgeleid van CDockablePane en tabbladen hebben. Zie CTabbedPane::GetTabArea en CMFCOutlookBar::GetTabAreavoor meer informatie.

CDockablePane::GetTabbedPaneRTC

Retourneert de runtimeklasse-informatie over een venster met tabbladen dat wordt gemaakt wanneer een ander deelvenster aan het huidige deelvenster wordt gekoppeld.

CRuntimeClass* GetTabbedPaneRTC() const;

Retourwaarde

De runtimeklasse-informatie voor het dockable-deelvenster.

Opmerkingen

Roep deze methode aan om de runtimeklasse-informatie op te halen voor deelvensters met tabbladen die dynamisch worden gemaakt. Dit kan gebeuren wanneer een gebruiker het ene deelvenster naar het bijschrift van een ander deelvenster sleept of als u de methode CDockablePane::AttachToTabWnd aanroept om programmatisch een deelvenster met tabbladen te maken vanuit twee dockable deelvensters.

U kunt de runtimeklassegegevens instellen door de CDockablePane::SetTabbedPaneRTC-methode aan te roepen.

CDockablePane::HasAutoHideMode

Hiermee geeft u op of een dockingvenster kan worden overgeschakeld naar de modus Automatisch zichtbaar maken.

virtual BOOL HasAutoHideMode() const;

Retourwaarde

TRUE als het beveiligbare deelvenster kan worden overgeschakeld naar de modus Voor automatisch zichtbaar maken; anders, FALSE.

Opmerkingen

Overschrijf deze methode in een afgeleide klasse om de modus automatisch zichtbaar te maken voor een specifiek dockable deelvenster.

CDockablePane::HitTest

Hiermee geeft u de locatie in een deelvenster waarin de gebruiker op een muis klikt.

virtual int HitTest(
    CPoint point,
    BOOL bDetectCaption = FALSE);

Parameters

point
[in] Hiermee geeft u het punt om te testen.

bDetectCaption
[in] TRUE als HTCAPTION moet worden geretourneerd als het punt op het bijschrift van het deelvenster staat; anders, FALSE.

Retourwaarde

Een van de volgende waarden:

  • HTNOWHERE als point zich niet in het beveiligbare deelvenster bevindt.

  • HTCLIENT als point zich in het clientgebied van het dockable-deelvenster bevindt.

  • HTCAPTION als point zich in het bijschriftgebied van het dockable-deelvenster bevindt.

  • AFX_HTCLOSE als point op de knop Sluiten staat.

  • HTMAXBUTTON als point op de knop Vastmaken staat.

CDockablePane::IsAutohideAllEnabled

Hiermee wordt aangegeven of het dockingvenster en alle andere deelvensters in de container kunnen worden overgeschakeld naar de modus Automatisch zichtbaar maken.

virtual BOOL IsAutohideAllEnabled() const;

Retourwaarde

TRUE als het beveiligbare deelvenster en alle andere deelvensters in de container kunnen worden overgeschakeld naar de modus automatisch zichtbaar maken; anders, FALSE.

Opmerkingen

Een gebruiker schakelt de modus Automatisch zichtbaar maken in door op de dokpinknop te klikken terwijl u de Ctrl--toets ingedrukt houdt

Als u dit gedrag wilt in- of uitschakelen, roept u de methode CDockablePane::EnableAutohideAll aan.

CDockablePane::IsAutoHideMode

Bepaalt of een deelvenster zich in de modus Automatisch weergeven bevindt.

virtual BOOL IsAutoHideMode() const;

Retourwaarde

TRUE als het beveiligbare deelvenster zich in de modus Voor automatisch zichtbaar maken bevindt; anders, FALSE.

CDockablePane::IsDocked

Bepaalt of het huidige deelvenster is gekoppeld.

virtual BOOL IsDocked() const;

Retourwaarde

TRUE als het dockable-deelvenster geen deel uitmaakt van een miniframevenster of als het in een miniframevenster met een ander deelvenster zweeft. FALSE als het deelvenster een onderliggend element is van een miniframevenster en er geen andere deelvensters zijn die deel uitmaken van het miniframevenster.

Opmerkingen

Als u wilt bepalen of het deelvenster is gekoppeld aan het hoofdframevenster, roept u CDockablePane::GetDefaultPaneDivideraan. Als de methode een niet-NULL aanwijzer retourneert, wordt het deelvenster vastgezet in het hoofdframevenster.

CDockablePane::IsHideInAutoHideMode

Bepaalt het gedrag van een deelvenster dat zich in de modus Automatisch weergeven bevindt als het wordt weergegeven (of verborgen) door CDockablePane::ShowPaneaan te roepen.

virtual BOOL IsHideInAutoHideMode() const;

Retourwaarde

TRUE als het beveiligbare deelvenster moet worden verborgen in de modus Voor automatisch zichtbaar maken; anders, FALSE.

Opmerkingen

Wanneer een beveiligbaar deelvenster zich in de modus Automatisch zichtbaar bevindt, gedraagt het zich anders wanneer u ShowPane aanroept om het deelvenster te verbergen of weer te geven. Dit gedrag wordt bepaald door het statische lid CDockablePane::m_bHideInAutoHideMode. Als dit lid is TRUE, wordt het beveiligbare deelvenster en de bijbehorende knop voor automatisch zichtbaar maken of weergegeven wanneer u ShowPaneaanroept. Anders wordt het beveiligbare deelvenster geactiveerd of gedeactiveerd en is de bijbehorende werkbalk of knop Automatisch zichtbaar.

Overschrijf deze methode in een afgeleide klasse om het standaardgedrag voor afzonderlijke deelvensters te wijzigen.

De standaardwaarde voor m_bHideInAutoHideMode is FALSE.

CDockablePane::IsInFloatingMultiPaneFrameWnd

Hiermee geeft u op of het deelvenster zich in een framevenster met meerdere deelvensters bevindt (CMultiPaneFrameWnd Class).

virtual BOOL IsInFloatingMultiPaneFrameWnd() const;

Retourwaarde

TRUE als het deelvenster zich in een framevenster met meerdere deelvensters bevindt; anders, FALSE.

Opmerkingen

CDockablePane::IsResizable

Hiermee geeft u op of het deelvenster kan worden aangepast.

virtual BOOL IsResizable() const;

Retourwaarde

TRUE als het deelvenster kan worden aangepast; anders, FALSE.

Opmerkingen

Dockable-deelvensters kunnen standaard worden aangepast. Als u het formaat wilt voorkomen, overschrijft u deze methode in een afgeleide klasse en retourneert u FALSE. Houd er rekening mee dat een FALSE waarde leidt tot een mislukte ASSERT in CPane::DockPane. Gebruik CDockingManager::AddPane in plaats daarvan om een deelvenster in een bovenliggend frame vast te leggen.

Deelvensters waarvan het formaat niet kan worden gewijzigd, kunnen niet zweven of de modus voor automatisch verbergen activeren en bevinden zich altijd aan de buitenrand van het bovenliggende frame.

CDockablePane::IsTabLocationBottom

Hiermee geeft u op of tabbladen zich boven of onder aan het deelvenster bevinden.

virtual BOOL IsTabLocationBottom() const;

Retourwaarde

TRUE als tabbladen zich onder aan het deelvenster bevinden; FALSE als de tabbladen zich boven aan het deelvenster bevinden.

Opmerkingen

Zie CTabbedPane::IsTabLocationBottomvoor meer informatie.

CDockablePane::IsTracked

Hiermee geeft u op of een deelvenster wordt verplaatst door de gebruiker.

BOOL IsTracked() const;

Retourwaarde

TRUE als het deelvenster wordt verplaatst; anders, FALSE.

CDockablePane::IsVisible

Bepaalt of het huidige deelvenster zichtbaar is.

virtual BOOL IsVisible() const;

Retourwaarde

TRUE als het bekbare deelvenster zichtbaar is; anders, FALSE.

Opmerkingen

Roep deze methode aan om te bepalen of een dockable deelvenster zichtbaar is. U kunt deze methode gebruiken in plaats van CWnd::IsWindowVisible aan te roepen of te testen op de stijl WS_VISIBLE. De geretourneerde zichtbaarheidsstatus is afhankelijk van of de autohidemodus is ingeschakeld of uitgeschakeld en van de waarde van de eigenschap CDockablePane::IsHideInAutoHideMode.

Als het beveiligbare deelvenster zich in de modus Automatisch zichtbaar bevindt en IsHideInAutoHideMode retourneert FALSE de zichtbaarheidsstatus altijd FALSEis.

Als het beveiligbare deelvenster zich in de modus Automatisch weergeven bevindt en IsHideInAutoHideModeTRUE de zichtbaarheidsstatus afhankelijk is van de zichtbaarheidsstatus van de gerelateerde werkbalk voor automatisch zichtbaar maken.

Als het deelvenster dockable zich niet in de modus Automatisch zichtbaar bevindt, wordt de zichtbaarheidsstatus bepaald door de CBasePane::IsVisible methode.

## CDockablePane::LoadState

Alleen voor intern gebruik. Zie de broncode in de mfc map van uw Visual Studio-installatie voor meer informatie. Bijvoorbeeld %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual BOOL LoadState(
   LPCTSTR lpszProfileName = NULL,
   int nIndex = -1,
   UINT uiID = (UINT) -1
);

CDockablePane::m_bDisableAnimation

Hiermee geeft u op of automatisch zichtbaar maken van het beveiligbare deelvenster is uitgeschakeld.

AFX_IMPORT_DATA static BOOL m_bDisableAnimation;

CDockablePane::m_bHideInAutoHideMode

Bepaalt het gedrag van het deelvenster wanneer het deelvenster zich in de modus Automatisch weergeven bevindt.

AFX_IMPORT_DATA static BOOL m_bHideInAutoHideMode;

Opmerkingen

Deze waarde is van invloed op alle dockingvensters in de toepassing.

Als u dit lid instelt op TRUE, worden dockable-deelvensters verborgen of weergegeven met de bijbehorende werkbalken en knoppen voor automatisch zichtbaar maken wanneer u CDockablePane::ShowPaneaanroept.

Als u dit lid instelt op FALSE, worden dockable-deelvensters geactiveerd of gedeactiveerd wanneer u CDockablePane::ShowPaneaanroept.

CDockablePane::m_nSlideSteps

Hiermee geeft u de animatiesnelheid van het deelvenster op wanneer het zich in de modus Automatisch weergeven bevindt.

AFX_IMPORT_DATA static int m_nSlideSteps;

Opmerkingen

Verlaag deze waarde voor een sneller animatie-effect. Verhoog deze waarde voor een langzamer animatie-effect.

CDockablePane::OnAfterChangeParent

Zie de broncode in de mfc map van uw Visual Studio-installatie voor meer informatie. Bijvoorbeeld %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual void OnAfterChangeParent(CWnd* pWndOldParent);

Parameters

[in] pWndOldParent

Opmerkingen

CDockablePane::OnAfterDockFromMiniFrame

Aangeroepen door het framework wanneer een zwevende dockingbalk dokken in een framevenster.

virtual void OnAfterDockFromMiniFrame();

Opmerkingen

Deze methode doet standaard niets.

CDockablePane::OnBeforeChangeParent

In het framework wordt deze methode aangeroepen voordat het bovenliggende deelvenster wordt gewijzigd.

virtual void OnBeforeChangeParent(
    CWnd* pWndNewParent,
    BOOL bDelay = FALSE);

Parameters

pWndNewParent
[in] Een aanwijzer naar het nieuwe bovenliggende venster.

bDelay
[in] BOOL waarmee wordt aangegeven of de herberekening van de dockingindeling moet worden vertraagd als het deelvenster is losgekoppeld. Zie CDockablePane::UndockPanevoor meer informatie.

Opmerkingen

Als het deelvenster is gedokt en het nieuwe bovenliggende item geen docking toestaat, wordt het deelvenster door deze methode losgekoppeld.

Als het deelvenster wordt geconverteerd naar een document met tabbladen, wordt met deze methode de recente dockingpositie opgeslagen. Het framework gebruikt de recente dockingpositie om de positie van het deelvenster te herstellen wanneer het weer wordt geconverteerd naar een gedokte status.

CDockablePane::OnBeforeFloat

In het framework wordt deze methode aangeroepen voordat een deelvenster overgaat naar een zwevende status.

virtual BOOL OnBeforeFloat(
    CRect& rectFloat,
    AFX_DOCK_METHOD dockMethod);

Parameters

rectFloat
[in] Hiermee geeft u de positie en grootte van het deelvenster op wanneer het zich in een zwevende toestand bevindt.

dockMethod
[in] Hiermee geeft u de dockingmethode. Zie CPane::DockPane voor een lijst met mogelijke waarden.

Retourwaarde

TRUE als het deelvenster kan worden zweven; anders, FALSE.

Opmerkingen

Deze methode wordt aangeroepen door het framework wanneer een deelvenster op het punt staat te zweven. U kunt deze methode in een afgeleide klasse overschrijven als u bewerkingen wilt uitvoeren voordat het deelvenster drijft.

CDockablePane::OnPressButtons

Wordt aangeroepen wanneer de gebruiker op een andere bijschriftknop drukt dan de knoppen AFX_HTCLOSE en AFX_HTMAXBUTTON.

virtual void OnPressButtons(UINT nHit);

Parameters

nHit
[in] Deze parameter wordt niet gebruikt.

Opmerkingen

Als u een aangepaste knop toevoegt aan het bijschrift van een dockable-deelvenster, overschrijft u deze methode om meldingen te ontvangen wanneer een gebruiker op de knop drukt.

CDockablePane::OnSlide

Aangeroepen door het framework om het deelvenster te animeren wanneer het zich in de modus Automatisch weergeven bevindt.

virtual void OnSlide(BOOL bSlideOut);

Parameters

bSlideOut
[in] TRUE om het deelvenster weer te geven; FALSE om het deelvenster te verbergen.

Opmerkingen

Overschrijf deze methode in een afgeleide klasse om aangepaste effecten voor automatisch zichtbaar maken te implementeren.

CDockablePane::RemoveFromDefaultPaneDividier

In het framework wordt deze methode aangeroepen wanneer een deelvenster wordt losgekoppeld.

void RemoveFromDefaultPaneDividier();

Opmerkingen

Met deze methode wordt de standaarddeelvensterscheiding ingesteld op NULL en wordt het deelvenster uit de container verwijderd.

CDockablePane::ReplacePane

Vervangt het deelvenster door een opgegeven deelvenster.

BOOL ReplacePane(
    CDockablePane* pBarToReplaceWith,
    AFX_DOCK_METHOD dockMethod,
    BOOL bRegisterWithFrame = FALSE);

Parameters

pBarToReplaceWith
[in] Een aanwijzer naar een bekeerbaar deelvenster.

dockMethod
[in] Niet gebruikt.

bRegisterWithFrame
[in] Als TRUE, wordt het nieuwe deelvenster geregistreerd bij het dockingbeheer van het bovenliggende deelvenster van het oude deelvenster. Het nieuwe deelvenster wordt ingevoegd in de index van het oude deelvenster in de lijst met deelvensters die worden onderhouden door dockingbeheer.

Retourwaarde

TRUE als de vervanging is geslaagd; anders, FALSE.

CDockablePane::RestoreDefaultPaneDivider

Wanneer een deelvenster wordt gedeserialiseerd, roept het framework deze methode aan om de standaarddeelvensterscheiding te herstellen.

void RestoreDefaultPaneDivider();

Opmerkingen

De herstelde standaarddeelvensterscheiding vervangt de huidige standaarddeelvensterscheiding als deze bestaat.

CDockablePane::SetAutoHideMode

Hiermee schakelt u het dockingvenster tussen de zichtbare en automatische weergavemodus in.

virtual CMFCAutoHideBar* SetAutoHideMode(
    BOOL bMode,
    DWORD dwAlignment,
    CMFCAutoHideBar* pCurrAutoHideBar = NULL,
    BOOL bUseTimer = TRUE);

Parameters

bMode
[in] TRUE om de autohidemodus in te schakelen; FALSE om de normale dockingmodus in te schakelen.

dwAlignment
[in] Hiermee geeft u de uitlijning van het deelvenster automatisch zichtbaar maken.

pCurrAutoHideBar
[in, uit] Een aanwijzer naar de huidige werkbalk voor automatisch zichtbaar maken. Kan worden NULL.

bUseTimer
[in] Hiermee geeft u op of het automatisch zichtbaar maken moet worden gebruikt wanneer de gebruiker het deelvenster overschakelt naar de modus Automatisch weergeven of het deelvenster onmiddellijk wilt verbergen.

Retourwaarde

De werkbalk voor automatisch zichtbaar maken die is gemaakt als gevolg van het overschakelen naar de autohidemodus of NULL.

Opmerkingen

In het framework wordt deze methode aangeroepen wanneer een gebruiker op de knop Vastmaken klikt om het dockable-deelvenster over te schakelen naar de modus Automatisch zichtbaar maken of naar de normale dockingmodus.

Roep deze methode aan om via een programma een dockable-deelvenster om de modus automatisch weer te geven. Het deelvenster moet worden vastgezet in het hoofdframevenster (CDockablePane::GetDefaultPaneDivider moet een geldige aanwijzer naar de CPaneDividerretourneren).

CDockablePane::SetAutoHideParents

Hiermee stelt u de knop Automatisch verbergen in en verbergt u de werkbalk automatisch voor het deelvenster.

void SetAutoHideParents(
    CMFCAutoHideBar* pToolBar,
    CMFCAutoHideButton* pBtn);

Parameters

pToolBar
[in] Aanwijzer naar een werkbalk voor automatisch verbergen.

pBtn
[in] Aanwijzer naar een knop voor automatisch verbergen.

CDockablePane::SetLastPercentInPaneContainer

Hiermee stelt u het percentage ruimte in dat een deelvenster in de container in beslag neemt.

void SetLastPercentInPaneContainer(int n);

Parameters

n
[in] Een int die het percentage ruimte aangeeft dat het deelvenster in de container inneemt.

Opmerkingen

Het framework past het deelvenster aan om de nieuwe waarde te gebruiken wanneer de indeling opnieuw wordt berekend.

CDockablePane::SetRestoredDefaultPaneDivider

Hiermee stelt u de herstelde standaarddeelvensterscheiding in.

void SetRestoredDefaultPaneDivider(HWND hRestoredSlider);

Parameters

hRestoredSlider
[in] Een greep naar een deelvensterscheiding (schuifregelaar).

Opmerkingen

Er wordt een herstelde standaarddeelvensterscheiding verkregen wanneer een deelvenster wordt gedeserialiseerd. Zie CDockablePane::RestoreDefaultPaneDividervoor meer informatie.

CDockablePane::SetTabbedPaneRTC

Hiermee stelt u de runtimeklasse-informatie in voor een venster met tabbladen dat wordt gemaakt wanneer twee deelvensters samen worden vastgezet.

void SetTabbedPaneRTC(CRuntimeClass* pRTC);

Parameters

pRTC
[in] De runtimeklasse-informatie voor het deelvenster met tabbladen.

Opmerkingen

Roep deze methode aan om de runtimeklasse-informatie in te stellen voor deelvensters met tabbladen die dynamisch worden gemaakt. Dit kan gebeuren wanneer een gebruiker het ene deelvenster naar het bijschrift van een ander deelvenster sleept of als u de methode CDockablePane::AttachToTabWnd aanroept om programmatisch een deelvenster met tabbladen te maken vanuit twee dockable deelvensters.

De standaardruntimeklasse wordt ingesteld op basis van de parameter dwTabbedStyle van CDockablePane::Create en CDockablePane::CreateEx. Als u de nieuwe deelvensters met tabbladen wilt aanpassen, leidt u uw klas af van een van de volgende klassen:

Roep deze methode vervolgens aan met de aanwijzer naar de runtimeklassegegevens.

CDockablePane::ShowPane

Een deelvenster weergeven of verbergen.

virtual void ShowPane(
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Parameters

bShow
[in] TRUE om het deelvenster weer te geven; FALSE om het deelvenster te verbergen.

bDelay
[in] TRUE om het aanpassen van de dockingindeling uit te stellen; FALSE om de dockingindeling onmiddellijk aan te passen.

bActivate
[in] TRUE om het deelvenster te activeren wanneer dit wordt weergegeven; anders, FALSE.

Opmerkingen

Roep deze methode aan in plaats van de CWnd::ShowWindow wanneer u dockable deelvensters weergeeft of verbergt.

CDockablePane::Slide

Hiermee wordt een deelvenster weergegeven dat zich in de modus Automatisch weergeven bevindt.

virtual void Slide(
    BOOL bSlideOut,
    BOOL bUseTimer = TRUE);

Parameters

bSlideOut
[in] TRUE om het deelvenster weer te geven; FALSE om het deelvenster te verbergen.

bUseTimer
[in] TRUE het deelvenster met het automatische zichtbaar maken weer te geven of te verbergen; FALSE om het deelvenster onmiddellijk weer te geven of te verbergen.

Opmerkingen

In het framework wordt deze methode aangeroepen om een deelvenster te animeren dat zich in de modus Automatisch weergeven bevindt.

Deze methode gebruikt de CDockablePane::m_nSlideDefaultTimeOut-waarde om de time-out voor het dia-effect te bepalen. De standaardwaarde voor de time-out is 1. Als u het algoritme voor automatisch zichtbaar maken aanpast, wijzigt u dit lid om de time-out te wijzigen.

CDockablePane::ToggleAutoHide

Hiermee schakelt u het deelvenster tussen de modus Altijd zichtbaar en Automatisch verbergen.

virtual void ToggleAutoHide();

Opmerkingen

Met deze methode schakelt u de modus voor automatisch verbergen voor het deelvenster in door CDockablePane::SetAutoHideModeaan te roepen.

CDockablePane::UndockPane

Ontkoppelt een deelvenster vanuit het hoofdframevenster of een miniframevenstercontainer.

virtual void UndockPane(BOOL bDelay = FALSE);

Parameters

bDelay
[in] TRUE om de berekening van de dockingindeling uit te stellen; FALSE de dockingindeling onmiddellijk opnieuw berekenen.

Opmerkingen

Roep deze methode aan om een deelvenster los te koppelen vanuit het hoofdframevenster of vanuit een container met meerdere miniframevensters (een deelvenster dat in één miniframevenster met andere deelvensters zweeft).

U moet een deelvenster loskoppelen voordat u een externe bewerking uitvoert die niet door de CDockingManagerwordt uitgevoerd. U moet bijvoorbeeld een deelvenster loskoppelen om het programmatisch van de ene locatie naar de andere te verplaatsen.

Het framework ontkoppelt deelvensters automatisch voordat ze worden vernietigd.

Zie ook

Hiërarchiegrafiek
klassen
CPane klasse