CDockingManager-Klasse

  • Artikel

Implementiert die Kernfunktionen, die das Andocklayout in einem Hauptrahmenfenster steuern.

Syntax

class CDockingManager : public CObject

Member

Öffentliche Methoden

Name Beschreibung
CDockingManager::AddDockSite Erstellt einen Dockbereich und fügt ihn der Liste der Steuerelementleisten hinzu.
CDockingManager::AddHiddenMDITabbedBar Fügt der Liste der ausgeblendeten MDI-Registerkartenleistenbereiche einen Ziehpunkt zu einem Balkenbereich hinzu.
CDockingManager::AddMiniFrame Fügt der Liste der Miniframes einen Frame hinzu.
CDockingManager::AddPane Registriert einen Bereich mit dem Andock-Manager.
CDockingManager::AdjustDockingLayout Berechnet das Layout aller Bereiche in einem Rahmenfenster neu und passt es an.
CDockingManager::AdjustPaneFrames Bewirkt, dass die WM_NCCALCSIZE Nachricht an alle Bereiche und CPaneFrameWnd Fenster gesendet wird.
CDockingManager::AdjustRectToClientArea Passt die Ausrichtung eines Rechtecks an.
CDockingManager::AlignAutoHidePane Ändert die Größe eines Andockbereichs im Autohide-Modus, sodass er die volle Breite oder Höhe des Clientbereichs des Frames verwendet, der von Dockstandorten umgeben ist.
CDockingManager::AutoHidePane Erstellt eine Automatische Einblendensymbolleiste.
CDockingManager::BringBarsToTop Bringt die angedockten Balken mit der angegebenen Ausrichtung an den oberen Rand.
CDockingManager::BuildPanesMenu Fügt einem Menü Namen von Andockbereichen und Symbolleisten hinzu.
CDockingManager::CalcExpectedDockedRect Berechnet das erwartete Rechteck eines angedockten Fensters.
CDockingManager::Create Erstellt einen Docking-Manager.
CDockingManager::D eterminePaneAndStatus Bestimmt den Bereich, der einen bestimmten Punkt und seinen Andockstatus enthält.
CDockingManager::D isableRestoreDockState Aktiviert oder deaktiviert das Laden des Docking-Layouts aus der Registrierung.
CDockingManager::D ockPane Verankert einen Bereich an einen anderen Bereich oder an ein Rahmenfenster.
CDockingManager::D ockPaneLeftOf Dockt einen Bereich auf der linken Seite eines anderen Bereichs an.
CDockingManager::EnableAutoHidePanes Aktiviert das Andocken des Bereichs an den Hauptrahmen, erstellt einen Dockbereich und fügt ihn der Liste der Steuerleisten hinzu.
CDockingManager::EnableDocking Erstellt einen Dockbereich und ermöglicht das Andocken des Bereichs an den Hauptrahmen.
CDockingManager::EnableDockSiteMenu Zeigt eine zusätzliche Schaltfläche an, mit der ein Popupmenü in den Beschriftungen aller Andockbereiche geöffnet wird.
CDockingManager::EnablePaneContextMenu Weist die Bibliothek an, ein spezielles Kontextmenü mit einer Liste von Anwendungssymbolleisten und Andockbereichen anzuzeigen, wenn der Benutzer auf die rechte Maustaste klickt und die Bibliothek die WM_CONTEXTMENU Nachricht verarbeitet.
CDockingManager::FindDockSite Ruft den Balkenbereich ab, der sich an der angegebenen Position befindet und über die angegebene Ausrichtung verfügt.
CDockingManager::FindDockSiteByPane Gibt den Balkenbereich zurück, der die ID des Zielleistenbereichs enthält.
CDockingManager::FindPaneByID Sucht einen Bereich nach der angegebenen Steuerelement-ID.
CDockingManager::FixupVirtualRects Führt einen Commit für alle aktuellen Symbolleistenpositionen auf virtuelle Rechtecke durch.
CDockingManager::FrameFromPoint Gibt den Frame zurück, der den angegebenen Punkt enthält.
CDockingManager::GetClientAreaBounds Ruft das Rechteck ab, das die Grenzen des Clientbereichs enthält.
CDockingManager::GetDockingMode Gibt den aktuellen Andockmodus zurück.
CDockingManager::GetDockSiteFrameWnd Ruft einen Zeiger auf den übergeordneten Fensterrahmen ab.
CDockingManager::GetEnabledAutoHideAlignment Gibt die aktivierte Ausrichtung der Bereiche zurück.
CDockingManager::GetMiniFrames Ruft eine Liste von Miniframes ab.
CDockingManager::GetOuterEdgeBounds Ruft ein Rechteck ab, das die äußeren Kanten des Frames enthält.
CDockingManager::GetPaneList Gibt eine Liste von Bereichen zurück, die zum Docking-Manager gehören. Dazu gehören alle unverankerten Bereiche.
CDockingManager::GetSmartDockingManager Ruft einen Zeiger auf den intelligenten Docking-Manager ab.
CDockingManager::GetSmartDockingManagerPermanent Ruft einen Zeiger auf den intelligenten Docking-Manager ab.
CDockingManager::GetSmartDockingParams Gibt die intelligenten Docking-Parameter für den Docking-Manager zurück.
CDockingManager::GetSmartDockingTheme Eine statische Methode, die ein Design zurückgibt, das zum Anzeigen intelligenter Docking-Marker verwendet wird.
CDockingManager::HideAutoHidePanes Blendet einen Bereich aus, der sich im Autohide-Modus befindet.
CDockingManager::InsertDockSite Erstellt einen Dockbereich und fügt ihn in die Liste der Steuerelementleisten ein.
CDockingManager::InsertPane Fügt einen Steuerelementbereich in die Liste der Steuerelementleisten ein.
CDockingManager::IsDockSiteMenu Gibt an, ob ein Popupmenü in den Beschriftungen aller Bereiche angezeigt wird.
CDockingManager::IsInAdjustLayout Bestimmt, ob die Layouts aller Bereiche angepasst werden.
CDockingManager::IsOLEContainerMode Gibt an, ob sich der Docking-Manager im OLE-Containermodus befindet.
CDockingManager::IsPointNearDockSite Bestimmt, ob sich ein angegebener Punkt in der Nähe des Dockstandorts befindet.
CDockingManager::IsPrintPreviewValid Bestimmt, ob der Druckvorschaumodus festgelegt ist.
CDockingManager::LoadState Lädt den Zustand des Docking-Managers aus der Registrierung.
CDockingManager::LockUpdate Sperrt das angegebene Fenster.
CDockingManager::OnActivateFrame Wird vom Framework aufgerufen, wenn das Rahmenfenster aktiviert oder deaktiviert wird.
CDockingManager::OnClosePopupMenu Wird vom Framework aufgerufen, wenn ein aktives Popupmenü eine WM_DESTROY-Meldung verarbeitet.
CDockingManager::OnMoveMiniFrame Vom Framework aufgerufen, um ein Miniframefenster zu verschieben.
CDockingManager::OnPaneContextMenu Wird vom Framework aufgerufen, wenn es ein Menü erstellt, das eine Liste von Bereichen enthält.
CDockingManager::P aneFromPoint Gibt den Bereich zurück, der den angegebenen Punkt enthält.
CDockingManager::P rocessPaneContextMenuCommand Wird vom Framework aufgerufen, um ein Kontrollkästchen für den angegebenen Befehl zu aktivieren oder zu deaktivieren und das Layout eines angezeigten Bereichs neu zu berechnen.
CDockingManager::RecalcLayout Berechnet das interne Layout der Steuerelemente neu, die in der Liste der Steuerelemente vorhanden sind.
CDockingManager::ReleaseEmptyPaneContainers Gibt die leeren Bereichscontainer frei.
CDockingManager::RemoveHiddenMDITabbedBar Entfernt den angegebenen ausgeblendeten Balkenbereich.
CDockingManager::RemoveMiniFrame Entfernt einen angegebenen Frame aus der Liste der Miniframes.
CDockingManager::RemovePaneFromDockManager Hebt die Registrierung eines Bereichs auf und entfernt ihn aus der Liste im Andock-Manager.
CDockingManager::ReplacePane Ersetzt einen Bereich durch einen anderen.
CDockingManager::ResortMiniFramesForZOrder Resorts die Frames in der Liste der Miniframes.
CDockingManager::SaveState Speichert den Zustand des Docking-Managers in der Registrierung.
CDockingManager::SendMessageToMiniFrames Sendet die angegebene Nachricht an alle Miniframes.
CDockingManager::Serialize Schreibt den Docking-Manager in ein Archiv. (Überschreibt CObject::Serialize.)
CDockingManager::SetAutohideZOrder Legt die Größe, Breite und Höhe der Steuerleisten und des angegebenen Bereichs fest.
CDockingManager::SetDockingMode Legt den Dockingmodus fest.
CDockingManager::SetDockState Legt den Andockzustand der Steuerleisten, der Minirahmen und die Autohide-Leisten fest.
CDockingManager::SetPrintPreviewMode Legt den Druckvorschaumodus der Balken fest, die in der Druckvorschau angezeigt werden.
CDockingManager::SetSmartDockingParams Legt die Parameter fest, die das Verhalten des intelligenten Andockens definieren.
CDockingManager::ShowDelayShowMiniFrames Blendet die Fenster der Miniframes ein oder aus.
CDockingManager::ShowPanes Blendet die Bereiche des Steuerelements und der Automatischen Einblendeleisten ein oder aus.
CDockingManager::StartSDocking Startet das intelligente Andocken des angegebenen Fensters entsprechend der Ausrichtung des intelligenten Docking-Managers.
CDockingManager::StopSDocking Stoppt intelligentes Andocken.

Datenelemente

Name Beschreibung
CDockingManager::m_bHideDockingBarsInContainerMode Gibt an, ob der Docking-Manager Bereiche im OLE-Containermodus ausblendet.
CDockingManager::m_dockModeGlobal Gibt den globalen Andockmodus an.
CDockingManager::m_nDockSensitivity Gibt die Andockempfindlichkeit an.
CDockingManager::m_nTimeOutBeforeDockingBarDock Gibt die Zeit in Millisekunden an, bevor ein Andockbereich im unmittelbaren Andockmodus angedockt wird.
CDockingManager::m_nTimeOutBeforeToolBarDock Gibt die Zeit in Millisekunden an, bevor eine Symbolleiste an das Hauptrahmenfenster angedockt wird.

Hinweise

Das Hauptrahmenfenster erstellt und initialisiert diese Klasse automatisch.

Das Docking-Manager-Objekt enthält eine Liste aller Bereiche, die sich im Docking-Layout befinden, und eine Liste aller CPaneFrameWnd-Fenster , die zum Hauptrahmenfenster gehören.

Die CDockingManager Klasse implementiert einige Dienste, die Sie verwenden können, um einen Bereich oder ein CPaneFrameWnd Fenster zu finden. In der Regel rufen Sie diese Dienste nicht direkt auf, da sie im Hauptframefensterobjekt eingeschlossen sind. Weitere Informationen finden Sie unter CPaneFrameWnd Class.

Anpassungstipps

Die folgenden Tipps gelten für CDockingManager Objekte:

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie verschiedene Methoden in der CDockingManager Klasse zum Konfigurieren eines CDockingManager Objekts verwendet werden. Das Beispiel zeigt, wie eine zusätzliche Schaltfläche angezeigt wird, die ein Popupmenü in den Beschriftungen aller Andockbereiche öffnet und wie der Andockmodus des Objekts festgelegt wird. Dieser Codeausschnitt ist Teil des Visual Studio Demo-Beispiels.

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

Vererbungshierarchie

CObject

CDockingManager

Anforderungen

Header: afxDockingManager.h

CDockingManager::AddDockSite

Erstellt einen Dockbereich und fügt ihn der Liste der Steuerelementleisten hinzu.

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

Parameter

info
[in] Ein Verweis auf eine Infostruktur, die die Ausrichtung des Dockbereichs enthält.

ppDockBar
[out] Ein Zeiger auf einen Zeiger auf den neuen Dockbereich.

Rückgabewert

TRUE, wenn der Dockbereich erfolgreich erstellt wurde; Andernfalls FALSE.

CDockingManager::AddHiddenMDITabbedBar

Fügt der Liste der ausgeblendeten MDI-Registerkartenleistenbereiche einen Ziehpunkt zu einem Balkenbereich hinzu.

void AddHiddenMDITabbedBar(CDockablePane* pBar);

Parameter

pBar
[in] Ein Zeiger auf einen Balkenbereich

CDockingManager::AddPane

Registriert einen Bereich mit dem Andock-Manager.

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

Parameter

pWnd
[in, out] Gibt den Bereich an, der dem Docking-Manager hinzugefügt werden soll.

bTail
[in] TRUE, um den Bereich am Ende der Liste der Bereiche für den Docking-Manager hinzuzufügen; andernfalls FALSE.

bAutoHide
[in] Nur für die interne Verwendung. Verwenden Sie immer den Standardwert FALSE.

bInsertForOuterEdge
[in] Nur für die interne Verwendung. Verwenden Sie immer den Standardwert FALSE.

Rückgabewert

TRUE, wenn der Bereich erfolgreich beim Docking-Manager registriert wurde; andernfalls FALSE.

Hinweise

Rufen Sie diese Methode auf, um nicht unverankerte, nicht verkleinerbare Bereiche mit dem Docking-Manager zu registrieren. Wenn Sie die Bereiche nicht registrieren, werden sie beim Layout des Docking-Managers nicht ordnungsgemäß angezeigt.

CDockingManager::AdjustDockingLayout

Berechnet das Layout aller Bereiche in einem Rahmenfenster neu und passt es an.

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

Parameter

hdwp
[in] Gibt die Struktur der verzögerten Fensterposition an. Weitere Informationen finden Sie unter Windows-Datentypen.

Hinweise

CDockingManager::AddMiniFrame

Fügt der Liste der Miniframes einen Frame hinzu.

virtual BOOL AddMiniFrame(CPaneFrameWnd* pWnd);

Parameter

pWnd
[in] Ein Zeiger auf einen Frame.

Rückgabewert

TRUE, wenn sich der Frame nicht in der Liste der Miniframes befindet und erfolgreich hinzugefügt wurde; Andernfalls FALSE.

CDockingManager::AdjustPaneFrames

Bewirkt, dass die WM_NCCALCSIZE Nachricht an alle Bereiche und CPaneFrameWnd Fenster gesendet wird.

virtual void AdjustPaneFrames();

Hinweise

CDockingManager::AdjustRectToClientArea

Passt die Ausrichtung eines Rechtecks an.

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

Parameter

rectResult
[in] Ein Verweis auf ein CRect Objekt

dwAlignment
[in] Die Ausrichtung des CRect Objekts

Rückgabewert

TRUE, wenn die Ausrichtung des CRect Objekts angepasst wurde; Andernfalls FALSE.

Hinweise

Der dwAlignment-Parameter kann einen der folgenden Werte aufweisen:

  • CBRS_ALIGN_TOP

  • CBRS_ALIGN_BOTTOM

  • CBRS_ALIGN_LEFT

  • CBRS_ALIGN_RIGHT

CDockingManager::AlignAutoHidePane

Ändert die Größe eines Andockbereichs im Autohide-Modus, sodass er die volle Breite oder Höhe des Clientbereichs des Frames verwendet, der von Dockstandorten umgeben ist.

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

Parameter

pDefaultSlider
[in] Der Andockschiebereglerbereich.

bIsVisible
[in] TRUE, wenn der Andockbereich sichtbar ist; Andernfalls FALSE.

CDockingManager::AutoHidePane

Erstellt eine Automatische Einblendensymbolleiste.

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

Parameter

pBar
[in] Ein Zeiger auf den Balkenbereich.

pCurrAutoHideToolBar
[in] Ein Zeiger auf eine Symbolleiste zum automatischen Ausblenden.

Rückgabewert

NULL, wenn die Symbolleiste zum automatischen Ausblenden nicht erstellt wurde; andernfalls ein Zeiger auf die neue Symbolleiste.

CDockingManager::BringBarsToTop

Bringt die angedockten Balken mit der angegebenen Ausrichtung an den oberen Rand.

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

Parameter

dwAlignment
[in] Die Ausrichtung der Dockleisten, die an die Spitze anderer Fenster gebracht werden.

bExcludeDockedBars
[in] TRUE, um die angedockten Balken von oben auszuschließen; andernfalls FALSE.

CDockingManager::BuildPanesMenu

Fügt einem Menü Namen von Andockbereichen und Symbolleisten hinzu.

void BuildPanesMenu(
    CMenu& menu,
    BOOL bToolbarsOnly);

Parameter

Menü
[in] Ein Menü zum Hinzufügen der Namen von Andockbereichen und Symbolleisten

bToolbarsOnly
[in] TRUE, um dem Menü nur Symbolleistennamen hinzuzufügen; Andernfalls FALSE.

CDockingManager::CalcExpectedDockedRect

Berechnet das erwartete Rechteck eines angedockten Fensters.

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

Parameter

pWnd
[in] Ein Zeiger auf das Fenster, das angedockt werden soll.

ptMouse
[in] Die Mausposition.

rectResult
[out] Das berechnete Rechteck.

bDrawTab
[in] TRUE, um eine Registerkarte zu zeichnen; andernfalls FALSE.

ppTargetBar
[out] Ein Zeiger auf einen Zeiger auf den Zielbereich.

Hinweise

Mit dieser Methode wird das Rechteck berechnet, das ein Fenster belegen würde, wenn ein Benutzer das Fenster an den von ptMouse angegebenen Punkt gezogen und dort angedockt hat.

CDockingManager::Create

Erstellt einen Docking-Manager.

BOOL Create(CFrameWnd* pParentWnd);

Parameter

pParentWnd
[in] Ein Zeiger auf den übergeordneten Frame des Docking-Managers. Dieser Wert darf nicht NULL sein.

Rückgabewert

WAHR immer.

CDockingManager::D eterminePaneAndStatus

Bestimmt den Bereich, der einen bestimmten Punkt und seinen Andockstatus enthält.

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

Parameter

pt
[in] Die Position des zu überprüfenden Bereichs.

nSensitivität
[in] Der Wert zum Vergrößern des Fensterrechtecks jedes eingecheckten Bereichs. Ein Bereich erfüllt die Suchkriterien, wenn sich der angegebene Punkt in diesem erhöhten Bereich befindet.

dwEnabledAlignment
[in] Die Ausrichtung des Andockbereichs.

ppTargetBar
[out] Ein Zeiger auf einen Zeiger auf den Zielbereich.

pBarToIgnore
[in] Der Bereich, den die Methode ignoriert.

pBarToDock
[in] Der bereich, der angedockt ist.

Rückgabewert

Der Andockstatus.

Hinweise

Der Andockstatus kann einer der folgenden Werte sein:

wert AFX_CS_STATUS Bedeutung
CS_NOTHING Der Zeiger liegt nicht über einem Dockstandort. Lassen Sie daher den Bereich unverankert.
CS_DOCK_IMMEDIATELY Der Zeiger befindet sich über dem Dockstandort im unmittelbaren Modus (DT_IMMEDIATE Format ist aktiviert), sodass der Bereich sofort angedockt werden muss.
CS_DELAY_DOCK Der Zeiger befindet sich über einem Dockstandort, bei dem es sich um einen anderen Dockingbereich oder einen Rand des Hauptrahmens handelt.
CS_DELAY_DOCK_TO_TAB Der Zeiger befindet sich über einer Dockwebsite, die bewirkt, dass der Bereich in einem Registerkartenfenster angedockt wird. Dies tritt auf, wenn sich die Maus über einer Beschriftung eines anderen Andockbereichs oder über einem Registerkartenbereich eines Registerkartenbereichs befindet.

CDockingManager::D isableRestoreDockState

Aktiviert oder deaktiviert das Laden des Docking-Layouts aus der Registrierung.

void DisableRestoreDockState(BOOL bDisable = TRUE);

Parameter

bDisable
[in] TRUE, um das Laden des Docking-Layouts aus der Registrierung zu deaktivieren; andernfalls FALSE.

Hinweise

Rufen Sie diese Methode auf, wenn Sie das aktuelle Layout von Andockbereichen und Symbolleisten beim Laden des Anwendungszustands beibehalten müssen.

CDockingManager::D ockPane

Verankert einen Bereich an einen anderen Bereich oder an ein Rahmenfenster.

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

Parameter

pBar
[in] Ein Zeiger auf einen Balkenbereich, an den angedockt werden soll.

nDockBarID
[in] Die ID der zu andockende Leiste.

lpRect
[in] Das Zielrechteck.

CDockingManager::D ockPaneLeftOf

Dockt einen Bereich auf der linken Seite eines anderen Bereichs an.

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

Parameter

pBarToDock
[in] Ein Zeiger auf den Bereich, der links von pTargetBar angedockt werden soll.

pTargetBar
[in] Ein Zeiger auf den Zielbereich.

Rückgabewert

TRUE, wenn der Bereich erfolgreich angedockt wurde; andernfalls FALSE.

CDockingManager::EnableAutoHidePanes

Aktiviert das Andocken des Bereichs an den Hauptrahmen, erstellt einen Dockbereich und fügt ihn der Liste der Steuerleisten hinzu.

BOOL EnableAutoHidePanes(DWORD dwStyle);

Parameter

dwStyle
[in] Die Andockausrichtung.

Rückgabewert

TRUE, wenn der Dockbereich erfolgreich erstellt wurde; Andernfalls FALSE.

CDockingManager::EnableDocking

Erstellt einen Dockbereich und ermöglicht das Andocken des Bereichs an den Hauptrahmen.

BOOL EnableDocking(DWORD dwStyle);

Parameter

dwStyle
[in] Die Andockausrichtung.

Rückgabewert

TRUE, wenn der Dockbereich erfolgreich erstellt wurde; Andernfalls FALSE.

CDockingManager::EnableDockSiteMenu

Zeigt eine zusätzliche Schaltfläche an, mit der ein Popupmenü in den Beschriftungen aller Andockbereiche geöffnet wird.

static void EnableDockSiteMenu(BOOL bEnable = TRUE);

Parameter

bEnable
[in] TRUE, um das Menü "Dockwebsite" zu aktivieren; andernfalls FALSE.

Hinweise

Im Menü "Dockwebsite" werden die folgenden Optionen zum Ändern des Andockzustands des Bereichs angezeigt:

  • Floating - Floats a pane

  • Docking – Verankert einen Bereich am Hauptrahmen an der Position, an der der Bereich zuletzt angedockt wurde

  • AutoHide – Schaltet den Bereich in den Automatischen Modus um.

  • Hide - Blendet einen Bereich aus

Standardmäßig wird dieses Menü nicht angezeigt.

CDockingManager::EnablePaneContextMenu

Weist die Bibliothek an, ein spezielles Kontextmenü mit einer Liste von Anwendungssymbolleisten und Andockbereichen anzuzeigen, wenn der Benutzer auf die rechte Maustaste klickt und die Bibliothek die WM_CONTEXTMENU Nachricht verarbeitet.

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

Parameter

bEnable
[in] Wenn WAHR, aktiviert die Bibliothek die Unterstützung für das automatische Kontextmenü; Wenn FALSE deaktiviert die Bibliothek die Unterstützung für das automatische Kontextmenü.

uiCustomizeCmd
[in] Eine Befehls-ID für das Element anpassen im Menü.

strCustomizeText
[in] Der Text des Elements anpassen .

bToolbarsOnly
[in] Wenn WAHR, zeigt das Menü nur eine Liste der Anwendungssymbolleisten an. Wenn FALSE, fügt die Bibliothek dieser Liste Anwendungsdockbereiche hinzu.

CDockingManager::FindDockSite

Ruft den Balkenbereich ab, der sich an der angegebenen Position befindet und über die angegebene Ausrichtung verfügt.

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

Parameter

dwAlignment
[in] Die Ausrichtung des Balkenbereichs.

bOuter
[in] Wenn WAHR, rufen Sie den Balken in der Kopfposition in der Liste der Steuerleisten ab. Rufen Sie andernfalls den Balken in der Liste der Steuerleisten in der Schwanzposition ab.

Rückgabewert

Der Andockbereich mit der angegebenen Ausrichtung; Andernfalls NULL.

CDockingManager::FindPaneByID

Sucht einen Bereich nach der angegebenen Steuerelement-ID.

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

Parameter

uBarID
[in] Gibt die Steuerelement-ID des zu suchenden Bereichs an.

bSearchMiniFrames
[in] TRUE, um alle unverankerten Bereiche in die Suche einzuschließen. FALSE, um nur die angedockten Bereiche einzuschließen.

Rückgabewert

Das CBasePane-Objekt mit der angegebenen Steuerelement-ID oder NULL, wenn der angegebene Bereich nicht gefunden werden kann.

Hinweise

CDockingManager::FindDockSiteByPane

Gibt den Balkenbereich zurück, der die ID des Zielleistenbereichs enthält.

virtual CDockSite* FindDockSiteByPane(CPane* pTargetBar);

Parameter

pTargetBar
[in] Ein Zeiger auf den Zielleistenbereich.

Rückgabewert

Der Balkenbereich mit der ID des Zielleistenbereichs; NULL, wenn kein solcher Balkenbereich vorhanden ist.

CDockingManager::FixupVirtualRects

Führt einen Commit für alle aktuellen Symbolleistenpositionen auf virtuelle Rechtecke durch.

virtual void FixupVirtualRects();

Hinweise

Wenn der Benutzer mit dem Ziehen einer Symbolleiste beginnt, merkt sich die Anwendung ihre ursprüngliche Position im virtuellen Rechteck. Wenn der Benutzer eine Symbolleiste über seine Dockwebsite verschiebt, kann die Symbolleiste andere Symbolleisten verschieben. Die ursprünglichen Positionen der anderen Symbolleisten werden in den entsprechenden virtuellen Rechtecks gespeichert.

CDockingManager::FrameFromPoint

Gibt den Frame zurück, der den angegebenen Punkt enthält.

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

Parameter

pt
[in] Gibt den zu überprüfenden Punkt in Bildschirmkoordinaten an.

pFrameToExclude
[in] Ein Zeiger auf einen auszuschließenden Frame.

bFloatMultiOnly
[in] TRUE, um Frames auszuschließen, die keine Instanzen von CMultiPaneFrameWnd; Andernfalls FALSE.

Rückgabewert

Der Rahmen, der den angegebenen Punkt enthält; Andernfalls NULL.

CDockingManager::GetClientAreaBounds

Ruft das Rechteck ab, das die Grenzen des Clientbereichs enthält.

CRect GetClientAreaBounds() const;

void GetClientAreaBounds(CRect& rcClient);

Parameter

rcClient
[out] Ein Verweis auf das Rechteck, das die Grenzen des Clientbereichs enthält.

Rückgabewert

Das Rechteck, das die Grenzen des Clientbereichs enthält.

CDockingManager::GetDockingMode

Gibt den aktuellen Andockmodus zurück.

static AFX_DOCK_TYPE GetDockingMode();

Rückgabewert

Ein Enumerationswert, der den aktuellen Andockmodus darstellt. Es kann sich um einen der folgenden Werte handeln:

  • DT_STANDARD

  • DT_IMMEDIATE

  • DT_SMART

Hinweise

Rufen Sie zum Festlegen des Dockingmodus CDockingManager::SetDockingMode auf.

CDockingManager::GetDockSiteFrameWnd

Ruft einen Zeiger auf den übergeordneten Fensterrahmen ab.

CFrameWnd* GetDockSiteFrameWnd() const;

Rückgabewert

Ein Zeiger auf den übergeordneten Fensterrahmen.

CDockingManager::GetEnabledAutoHideAlignment

Gibt die aktivierte Ausrichtung der Bereiche zurück.

DWORD GetEnabledAutoHideAlignment() const;

Rückgabewert

Eine bitweise Kombination aus CBRS_ALIGN_ Flags oder 0, wenn autohide-Bereiche nicht aktiviert sind. Weitere Informationen finden Sie unter CFrameWnd::EnableDocking.

Hinweise

Die Methode gibt die aktivierte Ausrichtung für Autohide-Steuerleisten zurück. Rufen Sie zum Aktivieren von autohide Bars CFrameWndEx::EnableAutoHidePanes auf.

CDockingManager::GetMiniFrames

Ruft eine Liste von Miniframes ab.

const CObList& GetMiniFrames() const;

Rückgabewert

Eine Liste von Miniframes, die die Steuerleisten enthalten, die zum Docking-Manager gehören.

CDockingManager::GetOuterEdgeBounds

Ruft ein Rechteck ab, das die äußeren Kanten des Frames enthält.

CRect GetOuterEdgeBounds() const;

Rückgabewert

Ein Rechteck, das die äußeren Ränder des Rahmens enthält.

CDockingManager::GetPaneList

Gibt eine Liste von Bereichen zurück, die zum Docking-Manager gehören. Dazu gehören alle unverankerten Bereiche.

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

Parameter

lstBars
[in, out] Enthält alle Bereiche des aktuellen Docking-Managers.

bIncludeAutohide
[in] TRUE, um die Bereiche einzuschließen, die sich im Autohide-Modus befinden; andernfalls FALSE.

pRTCFilter
[in] Wenn nicht NULL, enthält die zurückgegebene Liste nur Bereiche der angegebenen Laufzeitklasse.

bIncludeTabs
[in] TRUE, um Registerkarten einzuschließen; andernfalls FALSE.

Hinweise

Wenn im Docking-Manager Registerkartenbereiche vorhanden sind, gibt die Methode Zeiger auf CBaseTabbedPane-Klassenobjekte zurück, und Sie müssen die Registerkarten explizit aufzählen.

Verwenden Sie pRTCFilter , um eine bestimmte Klasse von Bereichen abzurufen. Sie können beispielsweise nur Symbolleisten abrufen, indem Sie diesen Wert entsprechend festlegen.

CDockingManager::GetSmartDockingManager

Ruft einen Zeiger auf den intelligenten Docking-Manager ab.

CSmartDockingManager* GetSmartDockingManager();

Rückgabewert

Ein Zeiger auf den intelligenten Docking-Manager.

CDockingManager::GetSmartDockingManagerPermanent

Ruft einen Zeiger auf den intelligenten Docking-Manager ab.

CSmartDockingManager* GetSmartDockingManagerPermanent() const;

Rückgabewert

Ein Zeiger auf den intelligenten Docking-Manager.

CDockingManager::GetSmartDockingParams

Gibt die intelligenten Docking-Parameter für den Docking-Manager zurück.

static CSmartDockingInfo& GetSmartDockingParams();

Rückgabewert

Die Klasse, die die intelligenten Dockingparameter für den aktuellen Docking-Manager enthält. Weitere Informationen finden Sie unter CSmartDockingInfo Class.

Hinweise

CDockingManager::HideAutoHidePanes

Blendet einen Bereich aus, der sich im Autohide-Modus befindet.

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

Parameter

pBarToExclude
[in] Ein Zeiger auf einen Balken, der vom Ausblenden ausgeschlossen werden soll.

bImmediately
[in] TRUE, um den Bereich sofort auszublenden; FALSE, um den Bereich mit dem Autohide-Effekt auszublenden.

CDockingManager::InsertDockSite

Erstellt einen Dockbereich und fügt ihn in die Liste der Steuerelementleisten ein.

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

Parameter

info
[in] Eine Struktur, die die Ausrichtungsinformationen zum Dockbereich enthält.

dwAlignToInsertAfter
[in] Ausrichtung des Dockbereichs.

ppDockBar
[out] Ein Zeiger auf einen Zeiger auf einen Dockbereich.

Rückgabewert

TRUE, wenn der Dockbereich erfolgreich erstellt wurde; Andernfalls FALSE.

CDockingManager::InsertPane

Fügt einen Steuerelementbereich in die Liste der Steuerelementleisten ein.

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

Parameter

pControlBar
[in] Ein Zeiger auf einen Steuerelementbereich.

pTarget
[in] Ein Zeiger auf einen Zielbereich.

bAfter
[in] TRUE, um den Bereich nach der Position des Zielbereichs einzufügen; Andernfalls FALSE.

Rückgabewert

TRUE, wenn der Steuerelementbereich der Liste der Steuerleisten erfolgreich hinzugefügt wird; Andernfalls FALSE.

Hinweise

Diese Methode gibt "false" zurück, wenn sich der Steuerelementbereich bereits in der Liste der Steuerelementleisten befindet oder der Zielbereich nicht in der Liste der Steuerelementleisten vorhanden ist.

CDockingManager::IsDockSiteMenu

Gibt an, ob ein Popupmenü in den Beschriftungen aller Bereiche angezeigt wird.

static BOOL IsDockSiteMenu();

Rückgabewert

TRUE, wenn ein Dockwebsitemenü auf den Beschriftungen aller Andockbereiche angezeigt wird; andernfalls FALSE.

Hinweise

Sie können das Dockwebsitemenü aktivieren, indem Sie CDockingManager::EnableDockSiteMenu aufrufen.

CDockingManager::IsInAdjustLayout

Bestimmt, ob die Layouts aller Bereiche angepasst werden.

BOOL IsInAdjustLayout() const;

Rückgabewert

TRUE, wenn die Layouts aller Bereiche angepasst werden; Andernfalls FALSE.

CDockingManager::IsOLEContainerMode

Gibt an, ob sich der Docking-Manager im OLE-Containermodus befindet.

BOOL IsOLEContainerMode() const;

Rückgabewert

TRUE, wenn sich der Docking-Manager im OLE-Containermodus befindet; andernfalls FALSE.

Hinweise

Im OLE-Containermodus werden alle Andockbereiche und Anwendungssymbolleisten ausgeblendet. Die Bereiche werden auch in diesem Modus ausgeblendet, wenn Sie CDockingManager::m_bHideDockingBarsInContainerMode auf TRUE festgelegt haben.

CDockingManager::IsPointNearDockSite

Bestimmt, ob sich ein angegebener Punkt in der Nähe des Dockstandorts befindet.

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

Parameter

Punkt
[in] Der angegebene Punkt.

dwBarAlignment
[out] Gibt an, welcher Rand sich der Punkt in der Nähe befindet. Mögliche Werte sind CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP und CBRS_ALIGN_BOTTOM.

bOuterEdge
[out] TRUE, wenn sich der Punkt in der Nähe des äußeren Rands des Dockstandorts befindet; Andernfalls FALSE.

Rückgabewert

TRUE, wenn sich der Punkt in der Nähe des Dockstandorts befindet; andernfalls FALSE.

CDockingManager::IsPrintPreviewValid

Bestimmt, ob der Druckvorschaumodus festgelegt ist.

BOOL IsPrintPreviewValid() const;

Rückgabewert

TRUE, wenn der Druckvorschaumodus festgelegt ist; Andernfalls FALSE.

CDockingManager::LoadState

Lädt den Zustand des Docking-Managers aus der Registrierung.

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

Parameter

lpszProfileName
[in] Profilname.

uiID
[in] Die ID des Docking-Managers.

Rückgabewert

TRUE, wenn der Docking-Manager-Zustand erfolgreich geladen wurde; andernfalls FALSE.

CDockingManager::LockUpdate

Sperrt das angegebene Fenster.

void LockUpdate(BOOL bLock);

Parameter

Block
[in] TRUE, wenn das Fenster gesperrt ist; Andernfalls FALSE.

Hinweise

Wenn ein Fenster gesperrt ist, kann es nicht verschoben werden und kann nicht neu gezeichnet werden.

CDockingManager::m_bHideDockingBarsInContainerMode

Gibt an, ob der Docking-Manager Bereiche im OLE-Containermodus ausblendet.

AFX_IMPORT_DATA static BOOL m_bHideDockingBarsInContainerMode;

Hinweise

Legen Sie diesen Wert auf FALSE fest, wenn Sie alle Bereiche an den Hauptrahmen angedockt lassen möchten, wenn sich die Anwendung im OLE-Containermodus befindet. Dieser Wert ist standardmäßig TRUE.

CDockingManager::m_dockModeGlobal

Gibt den globalen Andockmodus an.

AFX_IMPORT_DATA static AFX_DOCK_TYPE m_dockModeGlobal;

Hinweise

Standardmäßig verwendet jeder Andockbereich diesen Andockmodus. Weitere Informationen zu den Werten, auf die dieses Feld festgelegt werden kann, finden Sie unter "CBasePane::GetDockingMode".

CDockingManager::m_nDockSensitivity

Gibt die Andockempfindlichkeit an.

AFX_IMPORT_DATA static int m_nDockSensitivity;

Hinweise

Die Andockempfindlichkeit definiert, wie nah ein unverankerter Bereich sich einem Andockbereich, einem Andockstandort oder einem anderen Bereich nähern kann, bevor das Framework seinen Zustand so ändert, dass er angedockt wird.

CDockingManager::m_nTimeOutBeforeDockingBarDock

Gibt die Zeit in Millisekunden an, bevor ein Andockbereich im unmittelbaren Andockmodus angedockt wird.

static UINT m_nTimeOutBeforeDockingBarDock;

Hinweise

Bevor ein Bereich angedockt wird, wartet das Framework die angegebene Zeitdauer. Dadurch wird verhindert, dass der Bereich versehentlich an eine Position angedockt wird, während der Benutzer ihn noch zieht.

CDockingManager::m_nTimeOutBeforeToolBarDock

Gibt die Zeit in Millisekunden an, bevor eine Symbolleiste an das Hauptrahmenfenster angedockt wird.

static UINT m_nTimeOutBeforeToolBarDock;

Hinweise

Bevor eine Symbolleiste angedockt wird, wartet das Framework die angegebene Zeitdauer. Dadurch wird verhindert, dass die Symbolleiste versehentlich an eine Position angedockt wird, während der Benutzer sie noch zieht.

CDockingManager::OnActivateFrame

Wird vom Framework aufgerufen, wenn das Rahmenfenster aktiviert oder deaktiviert wird.

virtual void OnActivateFrame(BOOL bActivate);

Parameter

bActivate
[in] Wenn TRUE, wird das Rahmenfenster aktiviert; wenn FALSE, wird das Rahmenfenster deaktiviert.

CDockingManager::OnClosePopupMenu

Wird vom Framework aufgerufen, wenn ein aktives Popupmenü eine WM_DESTROY-Meldung verarbeitet.

void OnClosePopupMenu();

Hinweise

Das Framework sendet eine WM_DESTROY Nachricht, wenn es darum geht, das aktuelle Hauptfenster zu schließen. Überschreiben Sie diese Methode, um Benachrichtigungen von CMFCPopupMenu Objekten zu behandeln, die zum Framefenster gehören, wenn ein CMFCPopupMenu Objekt eine WM_DESTROY Nachricht verarbeitet.

CDockingManager::OnMoveMiniFrame

Vom Framework aufgerufen, um ein Miniframefenster zu verschieben.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parameter

pFrame
[in] Ein Zeiger auf ein Miniframefenster.

Rückgabewert

TRUE, wenn die Methode erfolgreich ist; andernfalls FALSE.

CDockingManager::OnPaneContextMenu

Wird vom Framework aufgerufen, wenn es ein Menü erstellt, das eine Liste von Bereichen enthält.

void OnPaneContextMenu(CPoint point);

Parameter

Punkt
[in] Gibt die Position des Menüs an.

CDockingManager::P aneFromPoint

Gibt den Bereich zurück, der den angegebenen Punkt enthält.

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;

Parameter

Punkt
[in] Gibt den zu überprüfenden Punkt in Bildschirmkoordinaten an.

nSensitivität
[in] Der Wert zum Aufblasen des Fensterrechtecks jedes eingecheckten Bereichs. Ein Bereich erfüllt die Suchkriterien, wenn sich der angegebene Punkt in diesem aufgeblasenen Bereich befindet.

bExactBar
[in] TRUE, um den nSensitivity-Parameter zu ignorieren; andernfalls FALSE.

pRTCBarType
[in] Wenn nicht NULL, durchsucht die Methode nur die Bereiche des angegebenen Typs.

bCheckVisibility
[in] TRUE, um nur sichtbare Bereiche zu überprüfen; andernfalls FALSE.

dwAlignment
[out] Wenn an dem angegebenen Punkt ein Bereich gefunden wird, enthält dieser Parameter die Seite des Bereichs, der dem angegebenen Punkt am nächsten liegt. Weitere Informationen finden Sie im Abschnitt Hinweise.

pBarToIgnore
[in] Wenn nicht NULL, ignoriert die Methode Bereiche, die durch diesen Parameter angegeben werden.

Rückgabewert

Das von CBasePane abgeleitete Objekt, das den angegebenen Punkt enthält, oder NULL, wenn kein Bereich gefunden wurde.

Hinweise

Wenn die Funktion zurückgegeben und ein Bereich gefunden wurde, enthält dwAlignment die Ausrichtung des angegebenen Punkts. Wenn der Punkt beispielsweise am oberen Rand des Bereichs am nächsten ist, wird dwAlignment auf CBRS_ALIGN_TOP festgelegt.

CDockingManager::P rocessPaneContextMenuCommand

Wird vom Framework aufgerufen, um ein Kontrollkästchen für den angegebenen Befehl zu aktivieren oder zu deaktivieren und das Layout eines angezeigten Bereichs neu zu berechnen.

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

Parameter

Nid
[in] Die ID einer Steuerelementleiste im Menü.

nCode
[in] Der Befehlsbenachrichtigungscode.

pExtra
[in] Ein Zeiger auf "void", der in einen Zeiger umgewandelt wird, wenn CCmdUI nCode CN_UPDATE_COMMAND_UI ist.

pHandlerInfo
[in] Ein Zeiger auf eine Informationsstruktur. Dieser Parameter wird nicht verwendet.

Rückgabewert

TRUE, wenn pEXtra nicht NULL ist und nCode gleich CN_UPDATE_COMMAND_UI ist, oder wenn eine Steuerelementleiste mit der angegebenen nID vorhanden ist.

CDockingManager::RecalcLayout

Berechnet das interne Layout der Steuerelemente neu, die in der Liste der Steuerelemente vorhanden sind.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parameter

bNotify
[in] Dieser Parameter wird nicht verwendet.

CDockingManager::ReleaseEmptyPaneContainers

Gibt die leeren Bereichscontainer frei.

void ReleaseEmptyPaneContainers();

CDockingManager::RemoveHiddenMDITabbedBar

Entfernt den angegebenen ausgeblendeten Balkenbereich.

void RemoveHiddenMDITabbedBar(CDockablePane* pBar);

Parameter

pBar
[in] Ein Zeiger auf einen zu entfernenden Balkenbereich.

CDockingManager::RemoveMiniFrame

Entfernt einen angegebenen Frame aus der Liste der Miniframes.

virtual BOOL RemoveMiniFrame(CPaneFrameWnd* pWnd);

Parameter

pWnd
[in] Ein Zeiger auf einen zu entfernenden Frame.

Rückgabewert

TRUE, wenn der angegebene Frame entfernt wird; Andernfalls FALSE.

CDockingManager::RemovePaneFromDockManager

Hebt die Registrierung eines Bereichs auf und entfernt ihn aus der Liste im Andock-Manager.

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

Parameter

pWnd
[in] Ein Zeiger auf einen zu entfernenden Bereich.

bDestroy
[in] Wenn TRUE, wird der entfernte Bereich zerstört.

bAdjustLayout
[in] Wenn TRUE, passen Sie das Andocklayout sofort an.

bAutoHide
[in] Wenn TRUE, wird der Bereich aus der Liste der Automatischen Balken entfernt. Wenn FALSE, wird der Bereich aus der Liste der regulären Bereiche entfernt.

pBarReplacement
[in] Ein Zeiger auf einen Bereich, der den entfernten Bereich ersetzt.

CDockingManager::ReplacePane

Ersetzt einen Bereich durch einen anderen.

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

Parameter

pOriginalBar
[in] Ein Zeiger auf den ursprünglichen Bereich.

pNewBar
[in] Ein Zeiger auf den Bereich, der den ursprünglichen Bereich ersetzt.

Rückgabewert

TRUE, wenn der Bereich erfolgreich ersetzt wird; Andernfalls FALSE.

CDockingManager::ResortMiniFramesForZOrder

Resorts die Frames in der Liste der Miniframes.

void ResortMiniFramesForZOrder();

CDockingManager::SaveState

Speichert den Zustand des Docking-Managers in der Registrierung.

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

Parameter

lpszProfileName
[in] Ein Pfad zu einem Registrierungsschlüssel.

uiID
[in] Die Docking-Manager-ID.

Rückgabewert

TRUE, wenn der Zustand erfolgreich gespeichert wurde; andernfalls FALSE.

Hinweise

Das Speichern des Zustands des Docking-Managers in die Registrierung umfasst das Speichern der Zustände der Steuerleisten, die Zustände der Autohide-Balken und die Zustände der Miniframes, die im Docking-Manager vorhanden sind.

CDockingManager::SendMessageToMiniFrames

Sendet die angegebene Nachricht an alle Miniframes.

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

Parameter

uMessage
[in] Die zu sendende Nachricht.

wParam
[in] Zusätzliche nachrichtenabhängige Informationen.

lParam
[in] Zusätzliche nachrichtenabhängige Informationen.

Rückgabewert

WAHR immer.

CDockingManager::Serialize

Schreibt den Docking-Manager in ein Archiv.

void Serialize(CArchive& ar);

Parameter

Ar
[in] Ein Verweis auf ein Archivobjekt.

Hinweise

Das Schreiben des Docking-Managers in ein Archiv umfasst die Ermittlung der Anzahl der Docking-Steuerleisten und Schieberegler sowie das Schreiben der Steuerleisten, der Minirahmen, der Autohide-Leisten und der MDI-Tabbettleisten in das Archiv.

CDockingManager::SetAutohideZOrder

Legt die Größe, Breite und Höhe der Steuerleisten und des angegebenen Bereichs fest.

void SetAutohideZOrder(CDockablePane* pAHDockingBar);

Parameter

pAHDockingBar
[in] Ein Zeiger auf einen andockbaren Bereich.

CDockingManager::SetDockingMode

Legt den Dockingmodus fest.

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

Parameter

dockMode
Gibt den neuen Andockmodus an. Weitere Informationen finden Sie im Abschnitt Hinweise.

Thema
Gibt das Design an, das für intelligente Andockmarkierungen verwendet werden soll. Dabei kann es sich um einen der folgenden Aufzählungswerte handeln: AFX_SDT_DEFAULT, AFX_SDT_VS2005, AFX_SDT_VS2008.

Hinweise

Rufen Sie diese statische Methode auf, um den Dockingmodus festzulegen.

dockMode kann einen der folgenden Werte aufweisen:

  • DT_STANDARD – Standard-Andockmodus wie in Visual Studio .NET 2003 implementiert. Bereiche werden ohne ziehenden Kontext gezogen.

  • DT_IMMEDIATE – Sofortiger Andockmodus wie in Microsoft Visio implementiert. Bereiche werden mit einem Ziehkontext gezogen, es werden jedoch keine Markierungen angezeigt.

  • DT_SMART – Intelligenter Andockmodus wie in Visual Studio 2005 implementiert. Bereiche werden mit einem Ziehkontext gezogen, und intelligente Markierungen werden angezeigt, die zeigen, wo der Bereich angedockt werden kann.

CDockingManager::SetDockState

Legt den Andockzustand der Steuerleisten, der Minirahmen und die Autohide-Leisten fest.

virtual void SetDockState();

CDockingManager::SetPrintPreviewMode

Legt den Druckvorschaumodus der Balken fest, die in der Druckvorschau angezeigt werden.

void SetPrintPreviewMode(
    BOOL bPreview,
    CPrintPreviewState* pState);

Parameter

bPreview
[in] TRUE, wenn der Druckvorschaumodus festgelegt ist; Andernfalls FALSE.

pState
[in] Ein Zeiger auf einen Vorschauzustand. Dieser Parameter wird nicht verwendet.

CDockingManager::SetSmartDockingParams

Legt die Parameter fest, die das Verhalten des intelligenten Andockens definieren.

static void SetSmartDockingParams(CSmartDockingInfo& params);

Parameter

params
[in, out] Definiert die Parameter für intelligentes Andocken.

Hinweise

Rufen Sie diese Methode auf, wenn Sie die Darstellung, Farbe oder Form der intelligenten Andockmarkierungen anpassen möchten.

Übergeben Sie eine nicht initialisierte Instanz der CSmartDockingInfo-Klasse an Params, um die Standardmäßige Suche nach intelligenten Docking-Markern zu verwenden.

CDockingManager::ShowDelayShowMiniFrames

Blendet die Fenster der Miniframes ein oder aus.

void ShowDelayShowMiniFrames(BOOL bshow);

Parameter

bShow
[in] TRUE, um das Fenster des angezeigten Frames aktiv zu machen; FALSE, um das Fenster des Frames auszublenden.

CDockingManager::ShowPanes

Blendet die Bereiche des Steuerelements und der Automatischen Einblendeleisten ein oder aus.

virtual BOOL ShowPanes(BOOL bShow);

Parameter

bShow
[in] TRUE, um die Bereiche anzuzeigen; FALSE, um die Bereiche auszublenden.

Rückgabewert

Immer FALSE

CDockingManager::StartSDocking

Startet das intelligente Andocken des angegebenen Fensters entsprechend der Ausrichtung des intelligenten Docking-Managers.

void StartSDocking(CWnd* pDockingWnd);

Parameter

pDockingWnd
[in] Ein Zeiger auf ein Fenster, das angedockt werden soll.

CDockingManager::StopSDocking

Stoppt intelligentes Andocken.

void StopSDocking();

CDockingManager::GetSmartDockingTheme

Eine statische Methode, die ein Design zurückgibt, das zum Anzeigen intelligenter Docking-Marker verwendet wird.

static AFX_SMARTDOCK_THEME __stdcall GetSmartDockingTheme();

Rückgabewert

Gibt einen der folgenden Aufzählungswerte zurück: AFX_SDT_DEFAULT, AFX_SDT_VS2005, AFX_SDT_VS2008.

Hinweise

Weitere Informationen

Hierarchiediagramm
Klassen
CObject-Klasse
CFrameWndEx-Klasse
CDockablePane-Klasse
CPaneFrameWnd-Klasse