Share via


CDockingManager-klasse

Opmerking

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

Implementeert de kernfunctionaliteit waarmee de dockingindeling in een hoofdframevenster wordt bestuurd.

Syntaxis

class CDockingManager : public CObject

Leden

Openbare methoden

Naam Description
CDockingManager::AddDockSite Hiermee maakt u een dockvenster en voegt u dit toe aan de lijst met besturingsbalken.
CDockingManager::AddHiddenMDITabbedBar Hiermee voegt u een greep toe aan een staafvenster aan de lijst met verborgen MDI-balkvensters met tabbladen.
CDockingManager::AddMiniFrame Voegt een frame toe aan de lijst met miniframes.
CDockingManager::AddPane Registreert een deelvenster met de dockingmanager.
CDockingManager::AdjustDockingLayout Berekent en past de indeling van alle deelvensters in een framevenster aan.
CDockingManager::AdjustPaneFrames Hiermee wordt het WM_NCCALCSIZE bericht verzonden naar alle deelvensters en CPaneFrameWnd vensters.
CDockingManager::AdjustRectToClientArea Hiermee past u de uitlijning van een rechthoek aan.
CDockingManager::AlignAutoHidePane Hiermee wijzigt u het formaat van een dockingvenster in de modus Automatisch zichtbaar, zodat het de volledige breedte of hoogte van het clientgebied van het frame tussen docksites neemt.
CDockingManager::AutoHidePane Hiermee maakt u een werkbalk voor automatisch zichtbaar maken.
CDockingManager::BringBarsToTop Hiermee worden de gedokte balken met de opgegeven uitlijning naar boven gebracht.
CDockingManager::BuildPanesMenu Voegt namen van koppelingsvensters en werkbalken toe aan een menu.
CDockingManager::CalcExpectedDockedRect Berekent de verwachte rechthoek van een gedokt venster.
CDockingManager::Maken Hiermee maakt u een dockingmanager.
CDockingManager::D eterminePaneAndStatus Bepaalt het deelvenster dat een bepaald punt en de dockingstatus bevat.
CDockingManager::D isableRestoreDockState Hiermee schakelt u het laden van de dockingindeling uit het register in of uit.
CDockingManager::D ockPane Een deelvenster aan een ander deelvenster of in een framevenster vastleggen.
CDockingManager::D ockPaneLeftOf Hiermee wordt een deelvenster aan de linkerkant van een ander deelvenster vastgesloten.
CDockingManager::EnableAutoHidePanes Hiermee kunt u het deelvenster aan het hoofdframe koppelen, een dockvenster maken en toevoegen aan de lijst met besturingsbalken.
CDockingManager::EnableDocking Hiermee maakt u een dockvenster en maakt u het mogelijk om het deelvenster aan het hoofdframe te koppelen.
CDockingManager::EnableDockSiteMenu Geeft een extra knop weer waarmee een snelmenu wordt geopend op de bijschriften van alle dockingvensters.
CDockingManager::EnablePaneContextMenu Geeft aan dat de bibliotheek een speciaal contextmenu met een lijst met toepassingswerkbalken en dockingvensters weergeeft wanneer de gebruiker op de rechtermuisknop klikt en de bibliotheek het WM_CONTEXTMENU bericht verwerkt.
CDockingManager::FindDockSite Hiermee wordt het balkvenster opgehaald dat zich op de opgegeven positie bevindt en die de opgegeven uitlijning heeft.
CDockingManager::FindDockSiteByPane Retourneert het balkvenster met de id van het doelbalkvenster.
CDockingManager::FindPaneByID Hiermee vindt u een deelvenster met de opgegeven besturingselement-id.
CDockingManager::FixupVirtualRects Hiermee worden alle huidige werkbalkposities doorgevoerd in virtuele rechthoeken.
CDockingManager::FrameFromPoint Retourneert het frame dat het opgegeven punt bevat.
CDockingManager::GetClientAreaBounds Hiermee haalt u de rechthoek op die de grenzen van het clientgebied bevat.
CDockingManager::GetDockingMode Retourneert de huidige dockingmodus.
CDockingManager::GetDockSiteFrameWnd Hiermee wordt een aanwijzer naar het bovenliggende vensterframe weergegeven.
CDockingManager::GetEnabledAutoHideAlignment Retourneert de ingeschakelde uitlijning van de deelvensters.
CDockingManager::GetMiniFrames Hiermee haalt u een lijst met miniframes op.
CDockingManager::GetOuterEdgeBounds Hiermee haalt u een rechthoek op die de buitenranden van het frame bevat.
CDockingManager::GetPaneList Retourneert een lijst met deelvensters die deel uitmaken van het dockingbeheer. Dit omvat alle zwevende deelvensters.
CDockingManager::GetSmartDockingManager Hiermee haalt u een aanwijzer op naar de slimme dockingmanager.
CDockingManager::GetSmartDockingManagerPermanent Hiermee haalt u een aanwijzer op naar de slimme dockingmanager.
CDockingManager::GetSmartDockingParams Retourneert de slimme dockingparameters voor de dockingmanager.
CDockingManager::GetSmartDockingTheme Een statische methode die een thema retourneert dat wordt gebruikt om slimme dockingmarkeringen weer te geven.
CDockingManager::HideAutoHidePanes Hiermee verbergt u een deelvenster dat zich in de modus Automatisch weergeven bevindt.
CDockingManager::InsertDockSite Hiermee maakt u een dockvenster en voegt u dit in de lijst met besturingsbalken in.
CDockingManager::InsertPane Hiermee voegt u een besturingselementvenster in de lijst met besturingsbalken in.
CDockingManager::IsDockSiteMenu Hiermee geeft u op of een snelmenu wordt weergegeven op de bijschriften van alle deelvensters.
CDockingManager::IsInAdjustLayout Bepaalt of de indelingen van alle deelvensters worden aangepast.
CDockingManager::IsOLEContainerMode Hiermee geeft u op of het dockingbeheer zich in de OLE-containermodus bevindt.
CDockingManager::IsPointNearDockSite Bepaalt of een opgegeven punt zich in de buurt van de docksite bevindt.
CDockingManager::IsPrintPreviewValid Bepaalt of de afdrukvoorbeeldmodus is ingesteld.
CDockingManager::LoadState Laadt de status van de dockingmanager uit het register.
CDockingManager::LockUpdate Hiermee wordt het opgegeven venster vergrendeld.
CDockingManager::OnActivateFrame Aangeroepen door het framework wanneer het framevenster actief wordt gemaakt of wordt gedeactiveerd.
CDockingManager::OnClosePopupMenu Aangeroepen door het framework wanneer een actief pop-upmenu een WM_DESTROY bericht verwerkt.
CDockingManager::OnMoveMiniFrame Aangeroepen door het framework om een miniframevenster te verplaatsen.
CDockingManager::OnPaneContextMenu Aangeroepen door het framework wanneer er een menu wordt gebouwd met een lijst met deelvensters.
CDockingManager::P aneFromPoint Retourneert het deelvenster dat het opgegeven punt bevat.
CDockingManager::P rocessPaneContextMenuCommand Aangeroepen door het framework om een selectievakje voor de opgegeven opdracht in of uit te schakelen en de indeling van een weergegeven deelvenster opnieuw te berekenen.
CDockingManager::RecalcLayout Berekent de interne indeling van de besturingselementen die aanwezig zijn in de lijst met besturingselementen.
CDockingManager::ReleaseEmptyPaneContainers Hiermee worden de lege deelvenstercontainers uitgebracht.
CDockingManager::RemoveHiddenMDITabbedBar Hiermee verwijdert u het opgegeven deelvenster verborgen balk.
CDockingManager::RemoveMiniFrame Hiermee verwijdert u een opgegeven frame uit de lijst met miniframes.
CDockingManager::RemovePaneFromDockManager Hiermee maakt u de registratie van een deelvenster ongedaan en verwijdert u het uit de lijst in dockingbeheer.
CDockingManager::ReplacePane Het ene deelvenster wordt vervangen door een ander deelvenster.
CDockingManager::ResortMiniFramesForZOrder Resorts de frames in de lijst met mini frames.
CDockingManager::SaveState Slaat de status van de dockingmanager op in het register.
CDockingManager::SendMessageToMiniFrames Hiermee wordt het opgegeven bericht verzonden naar alle miniframes.
CDockingManager::Serialiseren Hiermee schrijft u de dockingmanager naar een archief. (Overschrijft CObject::Serialize.)
CDockingManager::SetAutohideZOrder Hiermee stelt u de grootte, breedte en hoogte van de besturingsbalken en het opgegeven deelvenster in.
CDockingManager::SetDockingMode Hiermee stelt u de dockingmodus in.
CDockingManager::SetDockState Hiermee stelt u de dockingstatus van de besturingsbalken, de miniframes en de autohidebalken in.
CDockingManager::SetPrintPreviewMode Hiermee stelt u de afdrukvoorbeeldmodus in van de balken die worden weergegeven in het afdrukvoorbeeld.
CDockingManager::SetSmartDockingParams Hiermee stelt u de parameters in waarmee het gedrag van slim dokken wordt gedefinieerd.
CDockingManager::ShowDelayShowMiniFrames Hiermee worden de vensters van de miniframes weergegeven of verborgen.
CDockingManager::ShowPanes Hiermee worden de deelvensters van het besturingselement en de balken automatisch weergegeven of verborgen.
CDockingManager::StartSDocking Hiermee start u de slimme docking van het opgegeven venster op basis van de uitlijning van de slimme dockingmanager.
CDockingManager::StopSDocking Stopt met slim dokken.

Gegevensleden

Naam Description
CDockingManager::m_bHideDockingBarsInContainerMode Hiermee geeft u op of het dockingbeheer deelvensters in ole-containermodus verbergt.
CDockingManager::m_dockModeGlobal Hiermee geeft u de globale dockingmodus.
CDockingManager::m_nDockSensitivity Hiermee geeft u de dockinggevoeligheid op.
CDockingManager::m_nTimeOutBeforeDockingBarDock Hiermee geeft u de tijd, in milliseconden, voordat een dockingvenster wordt vastgezet in de directe dockingmodus.
CDockingManager::m_nTimeOutBeforeToolBarDock Hiermee geeft u de tijd, in milliseconden, voordat een werkbalk wordt gekoppeld aan het hoofdframevenster.

Opmerkingen

In het hoofdframevenster wordt deze klasse automatisch gemaakt en geïnitialiseerd.

Het dockingbeheerobject bevat een lijst met alle deelvensters die zich in de dockingindeling bevinden, en ook een lijst met alle CPaneFrameWnd-vensters die deel uitmaken van het hoofdframevenster.

De CDockingManager klasse implementeert enkele services die u kunt gebruiken om een deelvenster of venster CPaneFrameWnd te vinden. Deze services worden meestal niet rechtstreeks aangeroepen omdat ze zijn verpakt in het hoofdframevensterobject. Zie CPaneFrameWnd Class voor meer informatie.

Tips voor aanpassing

De volgende tips zijn van toepassing op CDockingManager objecten:

Example

In het volgende voorbeeld ziet u hoe u verschillende methoden in de CDockingManager klasse gebruikt om een CDockingManager object te configureren. In het voorbeeld ziet u hoe u een extra knop weergeeft waarmee een snelmenu wordt geopend in de bijschriften van alle dockingvensters en hoe u de dockingmodus van het object instelt. Dit codefragment maakt deel uit van het Visual Studio Demo-voorbeeld.

CDockingManager *pDockManager = GetDockingManager();
ASSERT_VALID(pDockManager);
pDockManager->AdjustPaneFrames();
pDockManager->EnableDockSiteMenu();
pDockManager->SetDockingMode(DT_STANDARD);

Overnamehiërarchie

CObject

CDockingManager

Requirements

Koptekst: afxDockingManager.h

CDockingManager::AddDockSite

Hiermee maakt u een dockvenster en voegt u dit toe aan de lijst met besturingsbalken.

BOOL AddDockSite(
    const AFX_DOCKSITE_INFO& info,
    CDockSite** ppDockBar = NULL);

Parameterwaarden

info
[in] Een verwijzing naar een informatiestructuur die uitlijning van het dockvenster bevat.

ppDockBar
[uit] Een aanwijzer naar een aanwijzer naar het nieuwe dockvenster.

Retourwaarde

WAAR als het dockvenster is gemaakt; ANDERS ONWAAR.

CDockingManager::AddHiddenMDITabbedBar

Hiermee voegt u een greep toe aan een staafvenster aan de lijst met verborgen MDI-balkvensters met tabbladen.

void AddHiddenMDITabbedBar(CDockablePane* pBar);

Parameterwaarden

pBar
[in] Een aanwijzer naar een balkvenster

CDockingManager::AddPane

Registreert een deelvenster met de dockingmanager.

BOOL AddPane(
    CBasePane* pWnd,
    BOOL bTail = TRUE,
    BOOL bAutoHide = FALSE,
    BOOL bInsertForOuterEdge = FALSE);

Parameterwaarden

pWnd
[in, uit] Hiermee geeft u het deelvenster op dat moet worden toegevoegd aan het dockingbeheer.

bTail
[in] TRUE om het deelvenster toe te voegen aan het einde van de lijst met deelvensters voor het dockingbeheer; anders, ONWAAR.

bAutoHide
[in] Alleen voor intern gebruik. Gebruik altijd de standaardwaarde FALSE.

bInsertForOuterEdge
[in] Alleen voor intern gebruik. Gebruik altijd de standaardwaarde FALSE.

Retourwaarde

WAAR als het deelvenster is geregistreerd bij de dockingmanager; anders, ONWAAR.

Opmerkingen

Roep deze methode aan om niet-zwevende, niet-resizeerbare deelvensters te registreren met de dockingmanager. Als u de deelvensters niet registreert, worden deze niet correct weergegeven wanneer de dockingmanager is ingedeeld.

CDockingManager::AdjustDockingLayout

Berekent en past de indeling van alle deelvensters in een framevenster aan.

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

Parameterwaarden

hdwp
[in] Hiermee geeft u de structuur van de uitgestelde vensterpositie. Zie Windows-gegevenstypen voor meer informatie.

Opmerkingen

CDockingManager::AddMiniFrame

Voegt een frame toe aan de lijst met miniframes.

virtual BOOL AddMiniFrame(CPaneFrameWnd* pWnd);

Parameterwaarden

pWnd
[in] Een aanwijzer naar een frame.

Retourwaarde

WAAR als het frame niet in de lijst met miniframes staat en met succes is toegevoegd; ANDERS ONWAAR.

CDockingManager::AdjustPaneFrames

Hiermee wordt het WM_NCCALCSIZE bericht verzonden naar alle deelvensters en CPaneFrameWnd vensters.

virtual void AdjustPaneFrames();

Opmerkingen

CDockingManager::AdjustRectToClientArea

Hiermee past u de uitlijning van een rechthoek aan.

virtual BOOL AdjustRectToClientArea(
    CRect& rectResult,
    DWORD dwAlignment);

Parameterwaarden

rectResult
[in] Een verwijzing naar een CRect object

dwAlignment
[in] De uitlijning van het CRect object

Retourwaarde

WAAR als de uitlijning van het CRect object is aangepast; ANDERS ONWAAR.

Opmerkingen

De parameter dwAlignment kan een van de volgende waarden hebben:

  • CBRS_ALIGN_TOP

  • CBRS_ALIGN_BOTTOM

  • CBRS_ALIGN_LEFT

  • CBRS_ALIGN_RIGHT

CDockingManager::AlignAutoHidePane

Hiermee wijzigt u het formaat van een dockingvenster in de modus Automatisch zichtbaar, zodat het de volledige breedte of hoogte van het clientgebied van het frame tussen docksites neemt.

void AlignAutoHidePane(
    CPaneDivider* pDefaultSlider,
    BOOL bIsVisible = TRUE);

Parameterwaarden

pDefaultSlider
[in] Het schuifvenster voor docking.

bIsVisible
[in] WAAR als het dockingvenster zichtbaar is; ANDERS ONWAAR.

CDockingManager::AutoHidePane

Hiermee maakt u een werkbalk voor automatisch zichtbaar maken.

CMFCAutoHideToolBar* AutoHidePane(
    CDockablePane* pBar,
    CMFCAutoHideToolBar* pCurrAutoHideToolBar = NULL);

Parameterwaarden

pBar
[in] Een aanwijzer naar het balkvenster.

pCurrAutoHideToolBar
[in] Een aanwijzer naar een werkbalk automatisch verbergen.

Retourwaarde

NULL als de werkbalk automatisch verbergen niet is gemaakt; anders een aanwijzer naar de nieuwe werkbalk.

CDockingManager::BringBarsToTop

Hiermee worden de gedokte balken met de opgegeven uitlijning naar boven gebracht.

void BringBarsToTop(
    DWORD dwAlignment = 0,
    BOOL bExcludeDockedBars = TRUE);

Parameterwaarden

dwAlignment
[in] De uitlijning van de dockbalken die boven aan andere vensters worden geplaatst.

bExcludeDockedBars
[in] WAAR om de gedokte balken uit te sluiten; anders ONWAAR.

CDockingManager::BuildPanesMenu

Voegt namen van koppelingsvensters en werkbalken toe aan een menu.

void BuildPanesMenu(
    CMenu& menu,
    BOOL bToolbarsOnly);

Parameterwaarden

Menu
[in] Een menu waaraan u de namen van dockingvensters en werkbalken kunt toevoegen.

bToolbarsOnly
[in] TRUE om alleen werkbalknamen toe te voegen aan het menu; ANDERS ONWAAR.

CDockingManager::CalcExpectedDockedRect

Berekent de verwachte rechthoek van een gedokt venster.

void CalcExpectedDockedRect(
    CWnd* pWnd,
    CPoint ptMouse,
    CRect& rectResult,
    BOOL& bDrawTab,
    CDockablePane** ppTargetBar);

Parameterwaarden

pWnd
[in] Een aanwijzer naar het venster om te dokken.

ptMouse
[in] De locatie van de muis.

rectResult
[uit] De berekende rechthoek.

bDrawTab
[in] WAAR om een tabblad te tekenen; anders ONWAAR.

ppTargetBar
[uit] Een aanwijzer naar een aanwijzer naar het doelvenster.

Opmerkingen

Met deze methode wordt de rechthoek berekend die een venster zou innemen als een gebruiker het venster naar het punt heeft gesleept dat is opgegeven door ptMouse en het daar vastzet.

CDockingManager::Maken

Hiermee maakt u een dockingmanager.

BOOL Create(CFrameWnd* pParentWnd);

Parameterwaarden

pParentWnd
[in] Een aanwijzer naar het bovenliggende frame van de dockingmanager. Deze waarde mag niet NULL zijn.

Retourwaarde

WAAR altijd.

CDockingManager::D eterminePaneAndStatus

Bepaalt het deelvenster dat een bepaald punt en de dockingstatus bevat.

virtual AFX_CS_STATUS DeterminePaneAndStatus(
    CPoint pt,
    int nSensitivity,
    DWORD dwEnabledAlignment,
    CBasePane** ppTargetBar,
    const CBasePane* pBarToIgnore,
    const CBasePane* pBarToDock);

Parameterwaarden

Pt
[in] De locatie van het deelvenster dat u wilt controleren.

nGevoeligheid
[in] De waarde om de rechthoek van het venster van elk ingeschakeld deelvenster te vergroten. Een deelvenster voldoet aan de zoekcriteria als het opgegeven punt zich in deze verhoogde regio bevindt.

dwEnabledAlignment
[in] De uitlijning van het dockingvenster.

ppTargetBar
[uit] Een aanwijzer naar een aanwijzer naar het doelvenster.

pBarToIgnore
[in] Het deelvenster dat de methode negeert.

pBarToDock
[in] Het deelvenster dat is gedokt.

Retourwaarde

De dockingstatus.

Opmerkingen

De dockingstatus kan een van de volgende waarden zijn:

AFX_CS_STATUS waarde Meaning
CS_NOTHING De aanwijzer bevindt zich niet boven een docksite. Houd daarom het deelvenster zwevend.
CS_DOCK_IMMEDIATELY De aanwijzer bevindt zich boven de docksite in de directe modus (DT_IMMEDIATE stijl is ingeschakeld), zodat het deelvenster onmiddellijk moet worden gedokt.
CS_DELAY_DOCK De aanwijzer bevindt zich boven een docksite die een ander dockingvenster is of een rand van het hoofdframe is.
CS_DELAY_DOCK_TO_TAB De aanwijzer bevindt zich boven een docksite die ervoor zorgt dat het deelvenster in een venster met tabbladen wordt gedokt. Dit gebeurt wanneer de muis boven een bijschrift van een ander dockingvenster of op een tabbladgebied van een deelvenster met tabbladen staat.

CDockingManager::D isableRestoreDockState

Hiermee schakelt u het laden van de dockingindeling uit het register in of uit.

void DisableRestoreDockState(BOOL bDisable = TRUE);

Parameterwaarden

bDisable
[in] TRUE om het laden van dockingindeling uit het register uit te schakelen; anders, ONWAAR.

Opmerkingen

Roep deze methode aan wanneer u de huidige indeling van dockingvensters en werkbalken moet behouden wanneer de toepassingsstatus wordt geladen.

CDockingManager::D ockPane

Een deelvenster aan een ander deelvenster of in een framevenster vastleggen.

void DockPane(
    CBasePane* pBar,
    UINT nDockBarID = 0,
    LPCRECT lpRect = NULL);

Parameterwaarden

pBar
[in] Een aanwijzer naar een staafvenster waaraan u wilt vastmaken.

nDockBarID
[in] De id van de balk die moet worden gedokt.

lpRect
[in] De doelrechthoek.

CDockingManager::D ockPaneLeftOf

Hiermee wordt een deelvenster aan de linkerkant van een ander deelvenster vastgesloten.

BOOL DockPaneLeftOf(
    CPane* pBarToDock,
    CPane* pTargetBar);

Parameterwaarden

pBarToDock
[in] Een aanwijzer naar het deelvenster dat links van pTargetBar moet worden vastgezet.

pTargetBar
[in] Een aanwijzer naar het doelvenster.

Retourwaarde

WAAR als het deelvenster is vastgezet; anders, ONWAAR.

CDockingManager::EnableAutoHidePanes

Hiermee kunt u het deelvenster aan het hoofdframe koppelen, een dockvenster maken en toevoegen aan de lijst met besturingsbalken.

BOOL EnableAutoHidePanes(DWORD dwStyle);

Parameterwaarden

dwStyle
[in] De dockinguitlijning.

Retourwaarde

WAAR als het dockvenster is gemaakt; ANDERS ONWAAR.

CDockingManager::EnableDocking

Hiermee maakt u een dockvenster en maakt u het mogelijk om het deelvenster aan het hoofdframe te koppelen.

BOOL EnableDocking(DWORD dwStyle);

Parameterwaarden

dwStyle
[in] De dockinguitlijning.

Retourwaarde

WAAR als het dockvenster is gemaakt; ANDERS ONWAAR.

CDockingManager::EnableDockSiteMenu

Geeft een extra knop weer waarmee een snelmenu wordt geopend op de bijschriften van alle dockingvensters.

static void EnableDockSiteMenu(BOOL bEnable = TRUE);

Parameterwaarden

bEnable
[in] TRUE om het docksitemenu in te schakelen; anders, ONWAAR.

Opmerkingen

In het menu van de docksite worden de volgende opties weergegeven voor het wijzigen van de dockingstatus van het deelvenster:

  • Floating - Een deelvenster laten zweven

  • Docking - Dockt een deelvenster in het hoofdframe op de locatie waar het deelvenster voor het laatst is gedokt

  • AutoHide - Hiermee schakelt u het deelvenster over naar de modus Automatisch zichtbaar maken

  • Hide - Een deelvenster verbergen

Dit menu wordt standaard niet weergegeven.

CDockingManager::EnablePaneContextMenu

Geeft aan dat de bibliotheek een speciaal contextmenu met een lijst met toepassingswerkbalken en dockingvensters weergeeft wanneer de gebruiker op de rechtermuisknop klikt en de bibliotheek het WM_CONTEXTMENU bericht verwerkt.

void EnablePaneContextMenu(
    BOOL bEnable,
    UINT uiCustomizeCmd,
    const CString& strCustomizeText,
    BOOL bToolbarsOnly = FALSE);

Parameterwaarden

bEnable
[in] Indien WAAR, schakelt de bibliotheek de ondersteuning voor het automatische contextmenu in; als ONWAAR is, wordt de ondersteuning voor het automatische contextmenu uitgeschakeld.

uiCustomizeCmd
[in] Een opdracht-id voor het item Aanpassen in het menu.

strCustomizeText
[in] De tekst van het item Aanpassen .

bToolbarsOnly
[in] Als WAAR is, wordt in het menu alleen een lijst met toepassingswerkbalken weergegeven; als ONWAAR is, voegt de bibliotheek toepassings dockingvensters toe aan deze lijst.

CDockingManager::FindDockSite

Hiermee wordt het balkvenster opgehaald dat zich op de opgegeven positie bevindt en die de opgegeven uitlijning heeft.

virtual CDockSite* FindDockSite(
    DWORD dwAlignment,
    BOOL bOuter);

Parameterwaarden

dwAlignment
[in] De uitlijning van het staafvenster.

Bouter
[in] Als WAAR is, haalt u de balk op de koppositie op in de lijst met besturingsbalken. Anders haalt u de balk op de staartpositie in de lijst met besturingsbalken op.

Retourwaarde

Het dockingvenster met de opgegeven uitlijning; ANDERS NULL.

CDockingManager::FindPaneByID

Hiermee vindt u een deelvenster met de opgegeven besturingselement-id.

virtual CBasePane* FindPaneByID(
    UINT uBarID,
    BOOL bSearchMiniFrames = FALSE);

Parameterwaarden

uBarID
[in] Hiermee geeft u de besturings-id van het deelvenster te zoeken.

bSearchMiniFrames
[in] WAAR om alle zwevende deelvensters in de zoekopdracht op te nemen. ONWAAR om alleen de gedokte deelvensters op te nemen.

Retourwaarde

Het CBasePane-object met de opgegeven besturings-id of NULL als het opgegeven deelvenster niet kan worden gevonden.

Opmerkingen

CDockingManager::FindDockSiteByPane

Retourneert het balkvenster met de id van het doelbalkvenster.

virtual CDockSite* FindDockSiteByPane(CPane* pTargetBar);

Parameterwaarden

pTargetBar
[in] Een aanwijzer naar het doelbalkvenster.

Retourwaarde

Het staafvenster met de id van het doelbalkvenster; NULL als er geen dergelijk staafvenster bestaat.

CDockingManager::FixupVirtualRects

Hiermee worden alle huidige werkbalkposities doorgevoerd in virtuele rechthoeken.

virtual void FixupVirtualRects();

Opmerkingen

Wanneer de gebruiker een werkbalk begint te slepen, onthoudt de toepassing de oorspronkelijke positie in de virtuele rechthoek. Wanneer de gebruiker een werkbalk verplaatst over de docksite, kan de werkbalk andere werkbalken verschuiven. De oorspronkelijke posities van de andere werkbalken worden opgeslagen in de bijbehorende virtuele rechthoeken.

CDockingManager::FrameFromPoint

Retourneert het frame dat het opgegeven punt bevat.

virtual CPaneFrameWnd* FrameFromPoint(
    CPoint pt,
    CPaneFrameWnd* pFrameToExclude,
    BOOL bFloatMultiOnly) const;

Parameterwaarden

Pt
[in] Hiermee geeft u het punt, in schermcoördinaten, om te controleren.

pFrameToExclude
[in] Een aanwijzer naar een frame dat moet worden uitgesloten.

bFloatMultiOnly
[in] TRUE om frames uit te sluiten die geen exemplaren zijn van CMultiPaneFrameWnd; ANDERS ONWAAR.

Retourwaarde

Het frame dat het opgegeven punt bevat; ANDERS NULL.

CDockingManager::GetClientAreaBounds

Hiermee haalt u de rechthoek op die de grenzen van het clientgebied bevat.

CRect GetClientAreaBounds() const;

void GetClientAreaBounds(CRect& rcClient);

Parameterwaarden

rcClient
[uit] Een verwijzing naar de rechthoek die de grenzen van het clientgebied bevat.

Retourwaarde

De rechthoek die de grenzen van het clientgebied bevat.

CDockingManager::GetDockingMode

Retourneert de huidige dockingmodus.

static AFX_DOCK_TYPE GetDockingMode();

Retourwaarde

Een enumerator-waarde die de huidige dockingmodus vertegenwoordigt. Dit kan een van de volgende waarden zijn:

  • DT_STANDARD

  • DT_IMMEDIATE

  • DT_SMART

Opmerkingen

Als u de dockingmodus wilt instellen, roept u CDockingManager::SetDockingMode aan.

CDockingManager::GetDockSiteFrameWnd

Hiermee wordt een aanwijzer naar het bovenliggende vensterframe weergegeven.

CFrameWnd* GetDockSiteFrameWnd() const;

Retourwaarde

Een aanwijzer naar het bovenliggende vensterframe.

CDockingManager::GetEnabledAutoHideAlignment

Retourneert de ingeschakelde uitlijning van de deelvensters.

DWORD GetEnabledAutoHideAlignment() const;

Retourwaarde

Een bitsgewijze combinatie van CBRS_ALIGN_ vlaggen of 0 als deelvensters voor automatisch zichtbaar maken niet zijn ingeschakeld. Zie CFrameWnd::EnableDocking voor meer informatie.

Opmerkingen

De methode retourneert de ingeschakelde uitlijning voor besturingsbalken voor automatisch zichtbaar maken. Als u autohidebalken wilt inschakelen, roept u CFrameWndEx::EnableAutoHidePanes aan.

CDockingManager::GetMiniFrames

Hiermee haalt u een lijst met miniframes op.

const CObList& GetMiniFrames() const;

Retourwaarde

Een lijst met miniframes die de besturingsbalken bevatten die deel uitmaken van de dockingmanager.

CDockingManager::GetOuterEdgeBounds

Hiermee haalt u een rechthoek op die de buitenranden van het frame bevat.

CRect GetOuterEdgeBounds() const;

Retourwaarde

Een rechthoek die de buitenranden van het frame bevat.

CDockingManager::GetPaneList

Retourneert een lijst met deelvensters die deel uitmaken van het dockingbeheer. Dit omvat alle zwevende deelvensters.

void GetPaneList(
    CObList& lstBars,
    BOOL bIncludeAutohide = FALSE,
    CRuntimeClass* pRTCFilter = NULL,
    BOOL bIncludeTabs = FALSE);

Parameterwaarden

lstBars
[in, uit] Bevat alle deelvensters van de huidige dockingmanager.

bIncludeAutohide
[in] WAAR om de deelvensters op te nemen die zich in de modus Automatisch zichtbaar maken bevinden; anders, ONWAAR.

pRTCFilter
[in] Als dat niet NULL is, bevat de geretourneerde lijst alleen deelvensters van de opgegeven runtimeklasse.

bIncludeTabs
[in] WAAR om tabbladen op te nemen; anders, ONWAAR.

Opmerkingen

Als er deelvensters met tabbladen in het dockingbeheer staan, retourneert de methode aanwijzers naar CBaseTabbedPane-klasseobjecten en moet u de tabbladen expliciet opsommen.

Gebruik pRTCFilter om een bepaalde klasse deelvensters te verkrijgen. U kunt bijvoorbeeld alleen werkbalken verkrijgen door deze waarde op de juiste manier in te stellen.

CDockingManager::GetSmartDockingManager

Hiermee haalt u een aanwijzer op naar de slimme dockingmanager.

CSmartDockingManager* GetSmartDockingManager();

Retourwaarde

Een aanwijzer naar de slimme dockingmanager.

CDockingManager::GetSmartDockingManagerPermanent

Hiermee haalt u een aanwijzer op naar de slimme dockingmanager.

CSmartDockingManager* GetSmartDockingManagerPermanent() const;

Retourwaarde

Een aanwijzer naar de slimme dockingmanager.

CDockingManager::GetSmartDockingParams

Retourneert de slimme dockingparameters voor de dockingmanager.

static CSmartDockingInfo& GetSmartDockingParams();

Retourwaarde

De klasse die de slimme dockingparameters voor de huidige dockingmanager bevat. Zie CSmartDockingInfo Class voor meer informatie.

Opmerkingen

CDockingManager::HideAutoHidePanes

Hiermee verbergt u een deelvenster dat zich in de modus Automatisch weergeven bevindt.

void HideAutoHidePanes(
    CDockablePane* pBarToExclude = NULL,
    BOOL bImmediately = FALSE);

Parameterwaarden

pBarToExclude
[in] Een aanwijzer naar een balk die moet worden uitgesloten van verbergen.

bImmediately
[in] WAAR om het deelvenster onmiddellijk te verbergen; ONWAAR om het deelvenster te verbergen met het effect automatisch zichtbaar maken.

CDockingManager::InsertDockSite

Hiermee maakt u een dockvenster en voegt u dit in de lijst met besturingsbalken in.

BOOL InsertDockSite(
    const AFX_DOCKSITE_INFO& info,
    DWORD dwAlignToInsertAfter,
    CDockSite** ppDockBar = NULL);

Parameterwaarden

info
[in] Een structuur met de uitlijningsinformatie over het deelvenster Dock.

dwAlignToInsertAfter
[in] Uitlijning van het deelvenster Dock.

ppDockBar
[uit] Een aanwijzer naar een aanwijzer naar een dockvenster.

Retourwaarde

WAAR als het dockvenster is gemaakt; ANDERS ONWAAR.

CDockingManager::InsertPane

Hiermee voegt u een besturingselementvenster in de lijst met besturingsbalken in.

BOOL InsertPane(
    CBasePane* pControlBar,
    CBasePane* pTarget,
    BOOL bAfter = TRUE);

Parameterwaarden

pControlBar
[in] Een aanwijzer naar een besturingselementvenster.

pTarget
[in] Een aanwijzer naar een doelvenster.

bAfter
[in] WAAR om het deelvenster in te voegen na de positie van het doelvenster; ANDERS ONWAAR.

Retourwaarde

WAAR als het besturingsvenster is toegevoegd aan de lijst met besturingsbalken; ANDERS ONWAAR.

Opmerkingen

Deze methode retourneert onwaar als het besturingsvenster zich al in de lijst met besturingsbalken bevindt of als het doelvenster niet bestaat in de lijst met besturingsbalken.

CDockingManager::IsDockSiteMenu

Hiermee geeft u op of een snelmenu wordt weergegeven op de bijschriften van alle deelvensters.

static BOOL IsDockSiteMenu();

Retourwaarde

WAAR als een docksitemenu wordt weergegeven op de bijschriften van alle dockingvensters; anders ONWAAR.

Opmerkingen

U kunt het menu van de docksite inschakelen door CDockingManager::EnableDockSiteMenu aan te roepen.

CDockingManager::IsInAdjustLayout

Bepaalt of de indelingen van alle deelvensters worden aangepast.

BOOL IsInAdjustLayout() const;

Retourwaarde

WAAR als de indelingen van alle deelvensters worden aangepast; ANDERS ONWAAR.

CDockingManager::IsOLEContainerMode

Hiermee geeft u op of het dockingbeheer zich in de OLE-containermodus bevindt.

BOOL IsOLEContainerMode() const;

Retourwaarde

WAAR als het dockingbeheer zich in de OLE-containermodus bevindt; anders, ONWAAR.

Opmerkingen

In de OLE-containermodus zijn alle dockingvensters en toepassingswerkbalken verborgen. De deelvensters zijn ook verborgen in deze modus als u CDockingManager::m_bHideDockingBarsInContainerMode hebt ingesteld op TRUE.

CDockingManager::IsPointNearDockSite

Bepaalt of een opgegeven punt zich in de buurt van de docksite bevindt.

BOOL IsPointNearDockSite(
    CPoint point,
    DWORD& dwBarAlignment,
    BOOL& bOuterEdge) const;

Parameterwaarden

Punt
[in] Het opgegeven punt.

dwBarAlignment
[uit] Hiermee geeft u op welke rand het punt zich in de buurt bevindt. Mogelijke waarden zijn CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP en CBRS_ALIGN_BOTTOM.

bOuterEdge
[uit] WAAR als het punt zich in de buurt van de buitenrand van de docksite bevindt; ANDERS ONWAAR.

Retourwaarde

WAAR als het punt zich in de buurt van de docksite bevindt; anders ONWAAR.

CDockingManager::IsPrintPreviewValid

Bepaalt of de afdrukvoorbeeldmodus is ingesteld.

BOOL IsPrintPreviewValid() const;

Retourwaarde

WAAR als de afdrukvoorbeeldmodus is ingesteld; ANDERS ONWAAR.

CDockingManager::LoadState

Laadt de status van de dockingmanager uit het register.

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

Parameterwaarden

lpszProfileName
[in] Profielnaam.

uiID
[in] De id van de dockingmanager.

Retourwaarde

WAAR als de status van de dockingmanager is geladen; anders ONWAAR.

CDockingManager::LockUpdate

Hiermee wordt het opgegeven venster vergrendeld.

void LockUpdate(BOOL bLock);

Parameterwaarden

Blok
[in] WAAR als het venster is vergrendeld; ANDERS ONWAAR.

Opmerkingen

Wanneer een venster is vergrendeld, kan het niet worden verplaatst en kan het niet opnieuw worden getekend.

CDockingManager::m_bHideDockingBarsInContainerMode

Hiermee geeft u op of het dockingbeheer deelvensters in ole-containermodus verbergt.

AFX_IMPORT_DATA static BOOL m_bHideDockingBarsInContainerMode;

Opmerkingen

Stel deze waarde in op FALSE als u alle deelvensters wilt vastzetten op het hoofdframe dat zichtbaar is wanneer de toepassing zich in de OLE-containermodus bevindt. Deze waarde is standaard TRUE.

CDockingManager::m_dockModeGlobal

Hiermee geeft u de globale dockingmodus.

AFX_IMPORT_DATA static AFX_DOCK_TYPE m_dockModeGlobal;

Opmerkingen

Standaard gebruikt elk dockingvenster deze dockingmodus. Zie CBasePane::GetDockingMode voor meer informatie over de waarden waarop dit veld kan worden ingesteld.

CDockingManager::m_nDockSensitivity

Hiermee geeft u de dockinggevoeligheid op.

AFX_IMPORT_DATA static int m_nDockSensitivity;

Opmerkingen

De dockinggevoeligheid definieert hoe dicht een zwevend deelvenster een dockingvenster, dockingsite of een ander deelvenster kan benaderen voordat het framework de status wijzigt in gedokt.

CDockingManager::m_nTimeOutBeforeDockingBarDock

Hiermee geeft u de tijd, in milliseconden, voordat een dockingvenster wordt vastgezet in de directe dockingmodus.

static UINT m_nTimeOutBeforeDockingBarDock;

Opmerkingen

Voordat een deelvenster wordt vastgezet, wacht het framework de opgegeven tijdsduur. Hiermee voorkomt u dat het deelvenster per ongeluk wordt vastgezet op een locatie terwijl de gebruiker het nog steeds sleept.

CDockingManager::m_nTimeOutBeforeToolBarDock

Hiermee geeft u de tijd, in milliseconden, voordat een werkbalk wordt gekoppeld aan het hoofdframevenster.

static UINT m_nTimeOutBeforeToolBarDock;

Opmerkingen

Voordat een werkbalk wordt vastgezet, wacht het framework de opgegeven tijdsduur. Hiermee voorkomt u dat de werkbalk per ongeluk wordt vastgezet op een locatie terwijl de gebruiker deze nog steeds sleept.

CDockingManager::OnActivateFrame

Aangeroepen door het framework wanneer het framevenster actief wordt gemaakt of wordt gedeactiveerd.

virtual void OnActivateFrame(BOOL bActivate);

Parameterwaarden

bActivate
[in] Indien WAAR, wordt het framevenster actief gemaakt; indien ONWAAR, wordt het framevenster gedeactiveerd.

CDockingManager::OnClosePopupMenu

Aangeroepen door het framework wanneer een actief pop-upmenu een WM_DESTROY bericht verwerkt.

void OnClosePopupMenu();

Opmerkingen

Het framework verzendt een WM_DESTROY bericht wanneer het op het punt staat om het huidige hoofdvenster te sluiten. Overschrijf deze methode om meldingen te verwerken van objecten die deel uitmaken van CMFCPopupMenu het framevenster wanneer een CMFCPopupMenu object een WM_DESTROY bericht verwerkt.

CDockingManager::OnMoveMiniFrame

Aangeroepen door het framework om een miniframevenster te verplaatsen.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parameterwaarden

pFrame
[in] Een aanwijzer naar een miniframevenster.

Retourwaarde

WAAR als de methode slaagt; anders ONWAAR.

CDockingManager::OnPaneContextMenu

Aangeroepen door het framework wanneer er een menu wordt gebouwd met een lijst met deelvensters.

void OnPaneContextMenu(CPoint point);

Parameterwaarden

Punt
[in] Hiermee geeft u de locatie van het menu.

CDockingManager::P aneFromPoint

Retourneert het deelvenster dat het opgegeven punt bevat.

virtual CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    bool bExactBar = false,
    CRuntimeClass* pRTCBarType = NULL,
    BOOL bCheckVisibility = FALSE,
    const CBasePane* pBarToIgnore = NULL) const;

virtual CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    DWORD& dwAlignment,
    CRuntimeClass* pRTCBarType = NULL,
    const CBasePane* pBarToIgnore = NULL) const;

Parameterwaarden

Punt
[in] Hiermee geeft u het punt, in schermcoördinaten, om te controleren.

nGevoeligheid
[in] De waarde voor het opblazen van de rechthoek van het venster van elk ingeschakeld deelvenster. Een deelvenster voldoet aan de zoekcriteria als het opgegeven punt zich in deze opgeblazen regio bevindt.

bExactBar
[in] TRUE om de parameter nSensitivity te negeren; anders, ONWAAR.

pRTCBarType
[in] Als dat niet NULL is, doorzoekt de methode alleen de deelvensters van het opgegeven type.

bCheckVisibility
[in] WAAR om alleen zichtbare deelvensters te controleren; anders, ONWAAR.

dwAlignment
[uit] Als een deelvenster op het opgegeven punt wordt gevonden, bevat deze parameter de zijkant van het deelvenster dat het dichtst bij het opgegeven punt lag. Zie de sectie Opmerkingen voor meer informatie.

pBarToIgnore
[in] Als dit niet NULL is, negeert de methode deelvensters die door deze parameter zijn opgegeven.

Retourwaarde

Het CBasePane-afgeleide object dat het opgegeven punt bevat of NULL als er geen deelvenster is gevonden.

Opmerkingen

Wanneer de functie wordt geretourneerd en er een deelvenster is gevonden, bevat dwAlignment de uitlijning van het opgegeven punt. Als het punt zich bijvoorbeeld het dichtst bij de bovenkant van het deelvenster bevindt, wordt dwAlignment ingesteld op CBRS_ALIGN_TOP.

CDockingManager::P rocessPaneContextMenuCommand

Aangeroepen door het framework om een selectievakje voor de opgegeven opdracht in of uit te schakelen en de indeling van een weergegeven deelvenster opnieuw te berekenen.

BOOL ProcessPaneContextMenuCommand(
    UINT nID,
    int nCode,
    void* pExtra,
    AFX_CMDHANDLERINFO* pHandlerInfo);

Parameterwaarden

nID
[in] De id van een besturingsbalk in het menu.

nCode
[in] De meldingscode voor de opdracht.

pExtra
[in] Een aanwijzer die wordt omgezet naar een aanwijzer CCmdUI als nCode is CN_UPDATE_COMMAND_UI.

pHandlerInfo
[in] Een aanwijzer naar een informatiestructuur. Deze parameter wordt niet gebruikt.

Retourwaarde

TRUE als pEXtra niet NULL is en nCode gelijk is aan CN_UPDATE_COMMAND_UI, of als er een besturingsbalk is met de opgegeven nID.

CDockingManager::RecalcLayout

Berekent de interne indeling van de besturingselementen die aanwezig zijn in de lijst met besturingselementen.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parameterwaarden

bNotify
[in] Deze parameter wordt niet gebruikt.

CDockingManager::ReleaseEmptyPaneContainers

Hiermee worden de lege deelvenstercontainers uitgebracht.

void ReleaseEmptyPaneContainers();

CDockingManager::RemoveHiddenMDITabbedBar

Hiermee verwijdert u het opgegeven deelvenster verborgen balk.

void RemoveHiddenMDITabbedBar(CDockablePane* pBar);

Parameterwaarden

pBar
[in] Een aanwijzer naar een staafvenster dat u wilt verwijderen.

CDockingManager::RemoveMiniFrame

Hiermee verwijdert u een opgegeven frame uit de lijst met miniframes.

virtual BOOL RemoveMiniFrame(CPaneFrameWnd* pWnd);

Parameterwaarden

pWnd
[in] Een aanwijzer naar een frame dat u wilt verwijderen.

Retourwaarde

WAAR als het opgegeven frame wordt verwijderd; ANDERS ONWAAR.

CDockingManager::RemovePaneFromDockManager

Hiermee maakt u de registratie van een deelvenster ongedaan en verwijdert u het uit de lijst in dockingbeheer.

void RemovePaneFromDockManager(
    CBasePane* pWnd,
    BOOL bDestroy,
    BOOL bAdjustLayout,
    BOOL bAutoHide = FALSE,
    CBasePane* pBarReplacement = NULL);

Parameterwaarden

pWnd
[in] Een aanwijzer naar een deelvenster dat moet worden verwijderd.

bDestroy
[in] Als WAAR is, wordt het verwijderde deelvenster vernietigd.

bAdjustLayout
[in] Indien WAAR, past u de dockingindeling onmiddellijk aan.

bAutoHide
[in] Als WAAR is, wordt het deelvenster verwijderd uit de lijst met autohidebalken. Als ONWAAR is, wordt het deelvenster verwijderd uit de lijst met normale deelvensters.

pBarReplacement
[in] Een aanwijzer naar een deelvenster dat het verwijderde deelvenster vervangt.

CDockingManager::ReplacePane

Het ene deelvenster wordt vervangen door een ander deelvenster.

BOOL ReplacePane(
    CDockablePane* pOriginalBar,
    CDockablePane* pNewBar);

Parameterwaarden

pOriginalBar
[in] Een aanwijzer naar het oorspronkelijke deelvenster.

pNewBar
[in] Een aanwijzer naar het deelvenster dat het oorspronkelijke deelvenster vervangt.

Retourwaarde

WAAR als het deelvenster is vervangen; ANDERS ONWAAR.

CDockingManager::ResortMiniFramesForZOrder

Resorts de frames in de lijst met mini frames.

void ResortMiniFramesForZOrder();

CDockingManager::SaveState

Slaat de status van de dockingmanager op in het register.

virtual BOOL SaveState(
    LPCTSTR lpszProfileName = NULL,
    UINT uiID = (UINT) -1);

Parameterwaarden

lpszProfileName
[in] Een pad naar een registersleutel.

uiID
[in] De dockingmanager-id.

Retourwaarde

WAAR als de status is opgeslagen; anders ONWAAR.

Opmerkingen

Het opslaan van de status van de dockingmanager in het register omvat het opslaan van de statussen van de besturingsbalken, de statussen van de autohidebalken en de statussen van de miniframes die aanwezig zijn in de dockingmanager.

CDockingManager::SendMessageToMiniFrames

Hiermee wordt het opgegeven bericht verzonden naar alle miniframes.

BOOL SendMessageToMiniFrames(
    UINT uMessage,
    WPARAM wParam = 0,
    LPARAM lParam = 0);

Parameterwaarden

uMessage
[in] Het bericht dat moet worden verzonden.

wParam-
[in] Aanvullende berichtafhankelijke informatie.

lParam-
[in] Aanvullende berichtafhankelijke informatie.

Retourwaarde

WAAR altijd.

CDockingManager::Serialiseren

Hiermee schrijft u de dockingmanager naar een archief.

void Serialize(CArchive& ar);

Parameterwaarden

Ar
[in] Een verwijzing naar een archiefobject.

Opmerkingen

Het schrijven van de dockingmanager naar een archief omvat het bepalen van het aantal dockingbesturingselementbalken en schuifregelaars en het schrijven van de besturingsbalken, de miniframes, de autohidebalken en de MDI-tabbalken naar het archief.

CDockingManager::SetAutohideZOrder

Hiermee stelt u de grootte, breedte en hoogte van de besturingsbalken en het opgegeven deelvenster in.

void SetAutohideZOrder(CDockablePane* pAHDockingBar);

Parameterwaarden

pAHDockingBar
[in] Een aanwijzer naar een bekeerbaar deelvenster.

CDockingManager::SetDockingMode

Hiermee stelt u de dockingmodus in.

static void SetDockingMode(
    AFX_DOCK_TYPE dockMode,
    AFX_SMARTDOCK_THEME theme = AFX_SDT_DEFAULT);

Parameterwaarden

dockMode
Hiermee geeft u de nieuwe dockingmodus. Zie de sectie Opmerkingen voor meer informatie.

Thema
Hiermee geeft u het thema dat moet worden gebruikt voor slimme dockingmarkeringen. Dit kan een van de volgende opsommingswaarden zijn: AFX_SDT_DEFAULT, AFX_SDT_VS2005, AFX_SDT_VS2008.

Opmerkingen

Roep deze statische methode aan om de dockingmodus in te stellen.

dockMode kan een van de volgende waarden zijn:

  • DT_STANDARD - Standard-dockingmodus zoals geïmplementeerd in Visual Studio .NET 2003. Deelvensters worden gesleept zonder context te slepen.

  • DT_IMMEDIATE - Directe dockingmodus zoals geïmplementeerd in Microsoft Visio. Deelvensters worden gesleept met een sleepcontext, maar er worden geen markeringen weergegeven.

  • DT_SMART - Slimme dockingmodus zoals geïmplementeerd in Visual Studio 2005. Deelvensters worden gesleept met een sleepcontext en slimme markeringen worden weergegeven die aangeven waar het deelvenster kan worden gedokt.

CDockingManager::SetDockState

Hiermee stelt u de dockingstatus van de besturingsbalken, de miniframes en de autohidebalken in.

virtual void SetDockState();

CDockingManager::SetPrintPreviewMode

Hiermee stelt u de afdrukvoorbeeldmodus in van de balken die worden weergegeven in het afdrukvoorbeeld.

void SetPrintPreviewMode(
    BOOL bPreview,
    CPrintPreviewState* pState);

Parameterwaarden

bPreview
[in] WAAR als de afdrukvoorbeeldmodus is ingesteld; ANDERS ONWAAR.

pState
[in] Een aanwijzer naar een preview-status. Deze parameter wordt niet gebruikt.

CDockingManager::SetSmartDockingParams

Hiermee stelt u de parameters in waarmee het gedrag van slim dokken wordt gedefinieerd.

static void SetSmartDockingParams(CSmartDockingInfo& params);

Parameterwaarden

params
[in, uit] Definieert de parameters voor slim dockingen.

Opmerkingen

Roep deze methode aan als u het uiterlijk, de kleur of de vorm van de slimme dockingmarkeringen wilt aanpassen.

Als u de standaardweergave voor slimme dockingmarkeringen wilt gebruiken, geeft u een niet-geïnitialiseerd exemplaar van CSmartDockingInfo-klasse door aan params.

CDockingManager::ShowDelayShowMiniFrames

Hiermee worden de vensters van de miniframes weergegeven of verborgen.

void ShowDelayShowMiniFrames(BOOL bshow);

Parameterwaarden

bShow
[in] WAAR om het venster van het weergegeven frame actief te maken; FALSE om het venster van het frame te verbergen.

CDockingManager::ShowPanes

Hiermee worden de deelvensters van het besturingselement en de balken automatisch weergegeven of verborgen.

virtual BOOL ShowPanes(BOOL bShow);

Parameterwaarden

bShow
[in] WAAR om de deelvensters weer te geven; ONWAAR om de deelvensters te verbergen.

Retourwaarde

Altijd ONWAAR.

CDockingManager::StartSDocking

Hiermee start u de slimme docking van het opgegeven venster op basis van de uitlijning van de slimme dockingmanager.

void StartSDocking(CWnd* pDockingWnd);

Parameterwaarden

pDockingWnd
[in] Een aanwijzer naar een venster om te dokken.

CDockingManager::StopSDocking

Stopt met slim dokken.

void StopSDocking();

CDockingManager::GetSmartDockingTheme

Een statische methode die een thema retourneert dat wordt gebruikt om slimme dockingmarkeringen weer te geven.

static AFX_SMARTDOCK_THEME __stdcall GetSmartDockingTheme();

Retourwaarde

Retourneert een van de volgende opgesomde waarden: AFX_SDT_DEFAULT, AFX_SDT_VS2005, AFX_SDT_VS2008.

Opmerkingen

Zie ook

Hiërarchiegrafiek
Klassen
CObject-klasse
CFrameWndEx-klasse
CDockablePane-klasse
CPaneFrameWnd-klasse