CBasePane-Klasse

  • Artikel

Basisklasse für alle Bereiche in MFC.

Syntax

class CBasePane : public CWnd

Member

Öffentliche Konstruktoren

Name Beschreibung
CBasePane::CBasePane Der Standardkonstruktor.
CBasePane::~CBasePane Destruktor.

Öffentliche Methoden

Name Beschreibung
CBasePane::accHitTest Wird durch das Framework aufgerufen, um das untergeordnete Element oder untergeordnete Objekt an einem bestimmten Punkt auf dem Bildschirm abzurufen. (Außerkraftsetzungen CWnd::accHitTest.)
CBasePane::accLocation Vom Framework aufgerufen, um die aktuelle Bildschirmposition für das angegebene Objekt abzurufen. (Außerkraftsetzungen CWnd::accLocation.)
CBasePane::AccNotifyObjectFocusEvent CBasePane verwendet diese Methode nicht.
CBasePane::accSelect Wird durch das Framework aufgerufen, um die Auswahl zu ändern oder den Tastaturfokus des angegebenen Objekts zu verschieben. (Außerkraftsetzungen CWnd::accSelect.)
CBasePane::AddPane Fügt dem Andock-Manager einen Bereich hinzu.
CBasePane::AdjustDockingLayout Leitet einen Anruf an den Docking-Manager um, um das Dockinglayout anzupassen.
CBasePane::AdjustLayout Wird vom Framework aufgerufen, wenn der Bereich sein internes Layout anpassen soll.
CBasePane::CalcFixedLayout Berechnet die horizontale Größe einer Steuerelementleiste.
CBasePane::CanAcceptPane Bestimmt, ob ein anderer Bereich an den Bereich angedockt werden kann.
CBasePane::CanAutoHide Bestimmt, ob der Bereich den Modus für das automatische Ausblenden unterstützt.
CBasePane::CanBeAttached Bestimmt, ob der Bereich an einen anderen Bereich angedockt werden kann.
CBasePane::CanBeClosed Bestimmt, ob der Bereich geschlossen werden kann.
CBasePane::CanBeDocked Bestimmt, ob der Bereich an einen anderen Bereich angedockt werden kann.
CBasePane::CanBeResized Bestimmt, ob die Größe des Bereichs geändert werden kann.
CBasePane::CanBeTabbedDocument Gibt an, ob der Bereich in ein MDI-Registerkartendokument konvertiert werden kann.
CBasePane::CanFloat Bestimmt, ob der Bereich schweben kann.
CBasePane::CanFocus Gibt an, ob der Bereich den Fokus erhalten kann.
CBasePane::CopyState Kopiert den Status eines bestimmten Bereichs.
CBasePane::CreateDefaultMiniframe Wenn der Bereich schweben kann, wird ein Miniframefenster erstellt.
CBasePane::CreateEx Erstellt das Bereichssteuerelement.
CBasePane::D ockPane Verankert einen Bereich an einen anderen Bereich oder an ein Rahmenfenster.
CBasePane::D ockPaneUsingRTTI Dockt den Bereich mithilfe von Laufzeittypinformationen an.
CBasePane::D ockToFrameWindow Dockt einen andockbaren Bereich an einen Frame an.
CBasePane::D oesAllowDynInsertBefore Bestimmt, ob ein anderer Bereich dynamisch zwischen diesem Bereich und dem übergeordneten Frame eingefügt werden kann.
CBasePane::EnableDocking Aktiviert das Andocken des Bereichs an den Standard Frame.
CBasePane::EnableGripper Aktiviert oder deaktiviert den Ziehelement. Wenn das Ziehelement aktiviert ist, kann der Benutzer ihn ziehen, um den Bereich neu zu positionieren.
CBasePane::FillWindowRect Wird intern verwendet.
CBasePane::FloatPane Floats the pane.
CBasePane::get_accChild Wird durch das Framework aufgerufen, um die Adresse einer IDispatch-Schnittstelle für das angegebene, untergeordnete Element abzurufen. (Außerkraftsetzungen CWnd::get_accChild.)
CBasePane::get_accChildCount Vom Framework aufgerufen, um die Anzahl der untergeordneten Elemente abzurufen, die zu diesem Objekt gehören. (Außerkraftsetzungen CWnd::get_accChildCount.)
CBasePane::get_accDefaultAction Vom Framework aufgerufen, um eine Zeichenfolge abzurufen, die die Standardaktion für das Objekt beschreibt. (Außerkraftsetzungen CWnd::get_accDefaultAction.)
CBasePane::get_accDescription Wird durch das Framework aufgerufen, um eine Zeichenfolge abzurufen, die die visuelle Darstellung des angegebenen Objekts beschreibt. (Außerkraftsetzungen CWnd::get_accDescription.)
CBasePane::get_accFocus Wird durch das Framework aufgerufen, um das Objekt abzurufen, das den Tastaturfokus hat. (Außerkraftsetzungen CWnd::get_accFocus.)
CBasePane::get_accHelp Vom Framework aufgerufen, um eine Hilfeeigenschaftszeichenfolge für das Objekt abzurufen. (Außerkraftsetzungen CWnd::get_accHelp.)
CBasePane::get_accHelpTopic Wird vom Framework aufgerufen, um den vollständigen Pfad der WinHelp-Datei abzurufen, die dem angegebenen Objekt zugeordnet ist, und den Bezeichner des entsprechenden Themas in dieser Datei. (Außerkraftsetzungen CWnd::get_accHelpTopic.)
CBasePane::get_accKeyboardShortcut Vom Framework aufgerufen, um die angegebene Tastenkombination für das Objekt abzurufen. (Außerkraftsetzungen CWnd::get_accKeyboardShortcut.)
CBasePane::get_accName Wird durch das Framework aufgerufen, um den Namen des angegebenen Objekts abzurufen. (Außerkraftsetzungen CWnd::get_accName.)
CBasePane::get_accParent Vom Framework aufgerufen, um die IDispatch Schnittstelle für das übergeordnete Objekt des Objekts abzurufen. (Außerkraftsetzungen CWnd::get_accParent.)
CBasePane::get_accRole Wird durch das Framework aufgerufen, um Informationen abzurufen, die die Rolle des angegebenen Objekts beschreiben. (Außerkraftsetzungen CWnd::get_accRole.)
CBasePane::get_accSelection Wird durch das Framework aufgerufen, um die ausgewählten, untergeordneten Elemente dieses Objekts abzurufen. (Außerkraftsetzungen CWnd::get_accSelection.)
CBasePane::get_accState Wird durch das Framework aufgerufen, um den aktuellen Status des angegebenen Objekts abzurufen. (Außerkraftsetzungen CWnd::get_accState.)
CBasePane::get_accValue Wird durch das Framework aufgerufen, um den Wert des angegebenen Objekts abzurufen. (Außerkraftsetzungen CWnd::get_accValue.)
CBasePane::GetCaptionHeight Gibt die Beschriftungshöhe zurück.
CBasePane::GetControlBarStyle Gibt die Steuerelementleistenart zurück.
CBasePane::GetCurrentAlignment Gibt die aktuelle Bereichsausrichtung zurück.
CBasePane::GetDockingMode Gibt den aktuellen Andockmodus für den Bereich zurück.
CBasePane::GetDockSiteFrameWnd Gibt einen Zeiger auf das Fenster zurück, das die Dockwebsite für den Bereich ist.
CBasePane::GetEnabledAlignment Gibt die CBRS_ALIGN_ Formatvorlagen zurück, die auf den Bereich angewendet werden.
CBasePane::GetMFCStyle Gibt die bereichsspezifischen Formatvorlagen für MFC zurück.
CBasePane::GetPaneIcon Gibt ein Handle zum Bereichssymbol zurück.
CBasePane::GetPaneRect Wird intern verwendet.
CBasePane::GetPaneRow Gibt einen Zeiger auf das CDockingPanesRow-Objekt zurück, in dem der Bereich verankert ist.
CBasePane::GetPaneStyle Gibt das Bereichsformat zurück.
CBasePane::GetParentDockSite Gibt einen Zeiger auf die übergeordnete Dockwebsite zurück.
CBasePane::GetParentMiniFrame Gibt einen Zeiger auf das übergeordnete Minirahmenfenster zurück.
CBasePane::GetParentTabbedPane Gibt einen Zeiger auf den übergeordneten Registerkartenbereich zurück.
CBasePane::GetParentTabWnd Gibt einen Zeiger auf das übergeordnete Fenster zurück, das sich innerhalb einer Registerkarte befindet.
CBasePane::GetRecentVisibleState Das Framework ruft diese Methode auf, wenn ein Bereich aus einem Archiv wiederhergestellt wird.
CBasePane::HideInPrintPreviewMode Gibt an, ob der Bereich in der Seitenansicht ausgeblendet ist.
CBasePane::InsertPane Registriert den angegebenen Bereich mit dem Docking-Manager.
CBasePane::IsAccessibilityCompatible Gibt an, ob der Bereich die aktive Barrierefreiheit unterstützt.
CBasePane::IsAutoHideMode Bestimmt, ob sich ein Bereich im Modus "Automatisch ausblenden" befindet.
CBasePane::IsDialogControl Gibt an, ob es sich bei dem Bereich um ein Dialogfeldsteuerelement handelt.
CBasePane::IsDocked Bestimmt, ob der Bereich angedockt ist.
CBasePane::IsFloating Bestimmt, ob der Bereich unverankert ist.
CBasePane::IsHorizontal Bestimmt, ob der Bereich horizontal verankert ist.
CBasePane::IsInFloatingMultiPaneFrameWnd Gibt an, ob sich der Bereich in einem Fenster mit mehreren Fenstern befindet.
CBasePane::IsMDITabbed Bestimmt, ob der Bereich einem untergeordneten MDI-Fenster als Dokument mit Registerkarten hinzugefügt wurde.
CBasePane::IsPaneVisible Gibt an, ob das WS_VISIBLE Flag für den Bereich festgelegt ist.
CBasePane::IsPointNearDockSite Bestimmt, ob sich ein angegebener Punkt in der Nähe des Dockstandorts befindet.
CBasePane::IsResizable Bestimmt, ob die Größe des Bereichs geändert werden kann.
CBasePane::IsRestoredFromRegistry Bestimmt, ob der Bereich aus der Registrierung wiederhergestellt wird.
CBasePane::IsTabbed Bestimmt, ob der Bereich in das Registersteuerelement eines Registerkartenfensters eingefügt wurde.
CBasePane::IsTooltipTopmost Wird intern verwendet.
CBasePane::IsVisible Bestimmt, ob der Bereich sichtbar ist.
CBasePane::LoadState Lädt den Bereichsstatus aus der Registrierung.
CBasePane::MoveWindow Verschiebt den Bereich.
CBasePane::OnAfterChangeParent Wird vom Framework aufgerufen, wenn das übergeordnete Element des Bereichs geändert wurde.
CBasePane::OnBeforeChangeParent Das Framework wird direkt vor dem Ändern des übergeordneten Fensters durch das Framework aufgerufen.
CBasePane::OnDrawCaption Das Framework ruft diese Methode auf, wenn die Untertitel gezeichnet wird.
CBasePane::OnMovePaneDivider Diese Methode wird derzeit nicht verwendet.
CBasePane::OnPaneContextMenu Wird vom Framework aufgerufen, wenn es ein Menü erstellt, das eine Liste von Bereichen enthält.
CBasePane::OnRemoveFromMiniFrame Wird vom Framework aufgerufen, wenn ein Bereich aus dem übergeordneten Miniframefenster entfernt wird.
CBasePane::OnSetAccData CBasePane verwendet diese Methode nicht.
CBasePane::OnUpdateCmdUI Wird intern verwendet.
CBasePane::P aneFromPoint Gibt den Bereich zurück, der den angegebenen Punkt enthält.
CBasePane::PreTranslateMessage Wird von der CWinApp -Klasse verwendet, um Fenstermeldungen zu übersetzen, bevor diese an die Windows-Funktionen TranslateMessage und DispatchMessage gesendet werden. (Überschreibt CWnd::PreTranslateMessage.)
CBasePane::RecalcLayout CBasePane verwendet diese Methode nicht.
CBasePane::RemovePaneFromDockManager Hebt die Registrierung eines Bereichs auf und entfernt ihn aus der Liste im Andock-Manager.
CBasePane::SaveState Speichert den Zustand des Bereichs in der Registrierung.
CBasePane::SelectDefaultFont Wählt die Standardschriftart für einen bestimmten Gerätekontext aus.
CBasePane::Serialize Liest oder schreibt dieses Objekt aus einem oder in ein Archiv. (Überschreibt CObject::Serialize.)
CBasePane::SetControlBarStyle Legt die Steuerelementleistenart fest.
CBasePane::SetDockingMode Legt den Dockingmodus für den Bereich fest.
CBasePane::SetMDITabbed Wird intern verwendet.
CBasePane::SetPaneAlignment Legt die Ausrichtung für den Bereich fest.
CBasePane::SetPaneRect Wird intern verwendet.
CBasePane::SetPaneStyle Legt die Formatvorlage des Bereichs fest.
CBasePane::SetRestoredFromRegistry Wird intern verwendet.
CBasePane::SetWindowPos Ändert die Größe, Position und Z-Reihenfolge eines Bereichs.
CBasePane::ShowPane Blendet den Bereich ein oder aus.
CBasePane::StretchPane Streckt einen Bereich vertikal oder horizontal.
CBasePane::UndockPane Entfernt den Bereich von der Dockwebsite, dem Standardschieberegler oder dem Miniframefenster, in dem er derzeit verankert ist.

Geschützte Methoden

Name Beschreibung
CBasePane::D oPaint Füllt den Hintergrund des Bereichs aus.

Hinweise

Wenn Sie eine Bereichsklasse erstellen möchten, die die erweiterten Andockfunktionen unterstützt, die in MFC verfügbar sind, müssen Sie sie von CBasePane oder von der CPane-Klasse ableiten.

Anpassungstipps

Die folgenden Anpassungstipps beziehen sich auf die CBasePane Class klassen, die von ihr erben:

  • Wenn Sie einen Bereich erstellen, können Sie mehrere neue Formatvorlagen anwenden:

    • AFX_CBRS_FLOAT wird der Bereich gleiten lassen.

    • AFX_CBRS_AUTOHIDE aktiviert den Modus "Automatisches Ausblenden".

    • AFX_CBRS_CLOSE ermöglicht das Schließen des Bereichs (ausgeblendet).

    Dies sind Flags, die Sie mit einem bitweisen OR-Vorgang kombinieren können.

CBasePane implementiert die folgenden virtuellen booleschen Methoden, um diese Flags widerzuspiegeln: CBasePane::CanBeClosed, CBasePane::CanAutoHide, CBasePane::CanFloat. Sie können sie in abgeleiteten Klassen überschreiben, um ihr Verhalten anzupassen.

  • Sie können das Andockverhalten anpassen, indem Sie CBasePane::CanAcceptPane überschreiben. Lassen Sie ihren Bereich falsch von dieser Methode zurückgeben, um zu verhindern, dass ein anderer Bereich an sie andockt.

  • Wenn Sie einen statischen Bereich erstellen möchten, der nicht schwebbar ist und verhindert, dass ein anderer Bereich vor ihr andockt (ähnlich wie die Outlook-Leiste im OutlookDemo-Beispiel), erstellen Sie ihn als nicht unverankerte Und außer Kraft setzen CBasePane::D oesAllowDynInsertBefore false zurück. Die Standardimplementierung gibt FALSE zurück, wenn der Bereich ohne die AFX_CBRS_FLOAT Formatvorlage erstellt wird.

  • Erstellen Sie alle Bereiche mit anderen IDs als -1.

  • Verwenden Sie CBasePane::IsVisible, um die Sichtbarkeit des Bereichs zu ermitteln. Er behandelt den Sichtbarkeitszustand im Registerkartenformat und im Modus zum automatischen Ausblenden ordnungsgemäß.

  • Wenn Sie einen nicht unverankerten veränderbaren Bereich erstellen möchten, erstellen Sie ihn ohne die AFX_CBRS_FLOAT Formatvorlage, und rufen Sie CFrameWnd::D ockControlBar auf.

  • Um einen Bereich aus einem Andocklayout auszuschließen oder eine Symbolleiste aus der Dockleiste zu entfernen, rufen Sie CBasePane::UndockPane auf. Rufen Sie diese Methode nicht für Bereiche im Automatischen Ausblenden-Modus oder für Bereiche auf, die sich auf Registerkarten von Registerkarten mit Registerkarten befinden.

  • Wenn Sie einen Bereich im Modus "Automatisches Ausblenden" verschieben oder rückgängig machen möchten, müssen Sie CDockablePane::SetAutoHideMode mit FALSE als erstes Argument aufrufen, bevor Sie CBasePane::FloatPane oder CBasePane::UndockPane aufrufen.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung verschiedener Methoden in der CBasePane -Klasse. Das Beispiel veranschaulicht das Abrufen eines Bereichs aus der CFrameWndEx Klasse und das Festlegen des Andockmodus, der Bereichsausrichtung und des Bereichsstils. Der Code stammt aus dem Word Pad-Beispiel.

// This CMainFrame class extends the CFrameWndEx class.
// GetPane is a method in the CFrameWndEx class which
// Returns a pointer to the pane that has the specified ID.
CBasePane *pBar = GetPane(ID_VIEW_FORMATBAR);
if (pBar != NULL)
{
    // Set the docking mode, the pane alignment, and the pane style.
    pBar->SetDockingMode(DT_STANDARD);
    pBar->SetPaneAlignment(CBRS_ALIGN_LEFT);
    pBar->SetPaneStyle(pBar->GetCurrentAlignment() | CBRS_TOOLTIPS);
    pBar->ShowPane(TRUE, FALSE, FALSE);
}

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CBasePane

Anforderungen

Header: afxbasepane.h

CBasePane::AccNotifyObjectFocusEvent

CBasePane verwendet diese Methode nicht.

virtual void AccNotifyObjectFocusEvent(int);

Parameter

int
[in] Wird nicht verwendet.

CBasePane::AddPane

Fügt dem Andock-Manager einen Bereich hinzu.

void AddPane(CBasePane* pBar);

Parameter

Pbar
[in] Ein Zeiger auf einen hinzuzufügenden Bereich.

Hinweise

Dies ist eine Bequeme Methode, mit der einem Andock-Manager ein Bereich hinzugefügt wird. Mit dieser Methode müssen Sie keinen Code schreiben, der den Typ des übergeordneten Frames analysiert.

Weitere Informationen finden Sie unter "CDockingManager Class " und "CMDIFrameWndEx::AddPane".

CBasePane::AdjustDockingLayout

Leitet einen Anruf an den Docking-Manager um, um das Dockinglayout anzupassen.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Parameter

hdwp
[out] Ein Handle zu einer Struktur, die mehrere Fensterpositionen enthält.

Hinweise

Dies ist eine Bequeme Methode, mit der das Andocklayout angepasst wird. Mit dieser Methode müssen Sie keinen Code schreiben, der den Typ des übergeordneten Frames analysiert.

Weitere Informationen finden Sie unter CDockingManager::AdjustDockingLayout

CBasePane::AdjustLayout

Vom Framework aufgerufen, um das interne Layout eines Bereichs anzupassen.

virtual void AdjustLayout();

Hinweise

Das Framework ruft diese Methode auf, wenn ein Bereich sein internes Layout anpassen muss. Die Basisimplementierung führt nichts aus.

CBasePane::CalcFixedLayout

Berechnet die horizontale Größe einer Steuerelementleiste.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parameter

bStretch
[in] Gibt an, ob der Balken auf die Größe des Rahmens gestreckt werden soll. Der bStretch-Parameter ist nicht zero, wenn der Balken keine Andockleiste ist (nicht zum Andocken verfügbar) und 0 ist, wenn er angedockt oder unverankert ist (zum Andocken verfügbar).

bHorz
[in] Gibt an, dass der Balken horizontal oder vertikal ausgerichtet ist. Der bHorz-Parameter ist nonzero, wenn der Balken horizontal ausgerichtet ist und 0 ist, wenn er vertikal ausgerichtet ist.

Rückgabewert

Die Größe der Steuerelementleiste in Pixeln eines CSize Objekts.

Hinweise

Weitere Informationen finden Sie im Abschnitt "Hinweise" in CControlBar::CalcFixedLayout

CBasePane::CanAcceptPane

Bestimmt, ob ein anderer Bereich an den Bereich angedockt werden kann.

virtual BOOL CanAcceptPane(const CBasePane* pBar) const;

Parameter

Pbar
[in] Ein Zeiger auf den Bereich, der angedockt werden soll.

Rückgabewert

TRUE, wenn ein anderer Bereich akzeptiert werden kann; andernfalls FALSE.

Hinweise

Das Framework ruft diese Methode auf, bevor der von pBar angegebene Bereich an den aktuellen Bereich angedockt wird.

Verwenden Sie diese Methode und die CBasePane::CanBeDocked-Methode , um zu steuern, wie Bereiche in Ihrer Anwendung an andere Bereiche andocken.

Die Standardimplementierung gibt FALSE zurück.

CBasePane::CanAutoHide

Bestimmt, ob der Bereich den Modus für das automatische Ausblenden unterstützt.

virtual BOOL CanAutoHide() const;

Rückgabewert

TRUE, wenn dieser Bereich den Modus "Automatisches Ausblenden" unterstützt; andernfalls FALSE.

Hinweise

Das Framework ruft diese Funktion auf, um zu bestimmen, ob der Bereich den Modus für das automatische Ausblenden unterstützt.

Während der Konstruktion können Sie diese Möglichkeit festlegen, indem Sie das AFX_CBRS_AUTOHIDE-Flag an CBasePane::CreateEx übergeben.

Die Standardimplementierung überprüft das AFX_CBRS_AUTOHIDE-Flag. Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um dieses Verhalten anzupassen.

CBasePane::CanBeAttached

Bestimmt, ob der Bereich an einen anderen Bereich oder rahmenfenster angedockt werden kann.

virtual BOOL CanBeAttached() const;

Rückgabewert

TRUE, wenn der Bereich an einen anderen Bereich oder Rahmenfenster angedockt werden kann; andernfalls FALSE.

Hinweise

Die Standardimplementierung gibt FALSE zurück. Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um die Möglichkeit zum Andocken ohne Aufrufen von CBasePane::EnableDocking zu aktivieren oder zu deaktivieren.

CBasePane::CanBeClosed

Bestimmt, ob der Bereich geschlossen werden kann.

virtual BOOL CanBeClosed() const;

Rückgabewert

TRUE, wenn der Bereich geschlossen werden kann; andernfalls FALSE.

Hinweise

Das Framework ruft diese Methode auf, um zu bestimmen, ob der Bereich geschlossen werden kann. Wenn die Methode TRUE zurückgibt, wird der Titelleiste des Bereichs eine Schaltfläche "Schließen " hinzugefügt oder, wenn der Bereich unverankert ist, der Titelleiste des Miniframefensters des Bereichs hinzugefügt.

Während der Konstruktion können Sie diese Möglichkeit festlegen, indem Sie das AFX_CBRS_CLOSE-Flag an CBasePane::CreateEx übergeben.

Die Standardimplementierung überprüft das AFX_CBRS_CLOSE-Flag.

CBasePane::CanBeDocked

Bestimmt, ob der Bereich an einen anderen Bereich angedockt werden kann.

virtual BOOL CanBeDocked(CBasePane* pDockBar) const;

Parameter

pDockBar
[in] Ein Zeiger auf einen anderen Bereich.

Rückgabewert

TRUE, wenn dieser Bereich an einen anderen Bereich angedockt werden kann; andernfalls FALSE.

Hinweise

Das Framework ruft diese Methode auf, bevor der durch pDockBar angegebene Bereich an den aktuellen Bereich angedockt wird.

Verwenden Sie diese Methode und die CBasePane::CanAcceptPane-Methode , um zu steuern, wie Bereiche in Ihrer Anwendung an andere Bereiche andocken.

Die Standardimplementierung gibt FALSE zurück.

CBasePane::CanBeResized

Bestimmt, ob die Größe des Bereichs geändert werden kann.

virtual BOOL CanBeResized() const;

Rückgabewert

TRUE, wenn die Größe des Bereichs geändert werden kann; andernfalls FALSE.

Hinweise

Diese Methode sucht nach dem flag AFX_CBRS_RESIZE, das standardmäßig in CBasePane::OnCreate. Wenn diese Kennzeichnung nicht angegeben ist, kennzeichnet der Andockmanager den Bereich intern als unbeweglich, anstatt es anzudocken.

CBasePane::CanBeTabbedDocument

Gibt an, ob der Bereich in ein MDI-Registerkartendokument konvertiert werden kann.

virtual BOOL CanBeTabbedDocument() const;

Rückgabewert

TRUE, wenn der Bereich in ein Dokument mit Registerkarten konvertiert werden kann; andernfalls FALSE. CBasePane::CanBeTabbedDocument gibt immer FALSE zurück.

Hinweise

Nur Objekte bestimmter CBasePaneabgeleiteter Typen, z. B. der CDockablePane-Klasse, können in Dokumente mit Registerkartenformat konvertiert werden.

CBasePane::CanFloat

Bestimmt, ob der Bereich schweben kann.

virtual BOOL CanFloat() const;

Rückgabewert

TRUE, wenn der Bereich schweben kann; andernfalls FALSE.

Hinweise

Das Framework ruft diese Methode auf, um zu bestimmen, ob der Bereich floaten kann.

Während der Konstruktion können Sie diese Möglichkeit festlegen, indem Sie das AFX_CBRS_FLOAT-Flag an CBasePane::CreateEx übergeben.

Hinweis

Das Framework geht davon aus, dass nicht unverankerte Bereiche statisch sind und sich der Andockzustand nicht ändern kann. Daher speichert das Framework nicht den Andockzustand nicht unverankerte Bereiche.

Die Standardimplementierung überprüft die AFX_CBRS_FLOAT Formatvorlage.

CBasePane::CanFocus

Gibt an, ob der Bereich den Fokus erhalten kann.

virtual BOOL CanFocus() const;

Rückgabewert

TRUE, wenn der Bereich den Fokus erhalten kann; andernfalls FALSE.

Hinweise

Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um den Fokus zu steuern. Da z. B. Symbolleisten keinen Fokus erhalten können, gibt diese Methode FALSE zurück, wenn sie für Symbolleistenobjekte aufgerufen wird.

Das Framework versucht, den Eingabefokus festzulegen, wenn ein Bereich angedockt oder schwebt.

CBasePane::CopyState

Kopiert den Status eines bestimmten Bereichs.

virtual void CopyState(CBasePane* pOrgBar);

Parameter

pOrgBar
[in] Ein Zeiger auf einen anderen Bereich.

Hinweise

Diese Methode kopiert den Zustand von pOrgBar in diesen Bereich.

CBasePane::CreateDefaultMiniframe

Wenn der Bereich schweben kann, erstellt diese Methode dafür ein Miniframefenster.

virtual CPaneFrameWnd* CreateDefaultMiniframe(CRect rectInitial);

Parameter

rectInitial
[in] Gibt die Anfangskoordinaten des Miniframefensters an.

Rückgabewert

Ein Zeiger auf das neue Miniframefenster oder NULL, wenn die Erstellung fehlgeschlagen ist.

Hinweise

Das Framework ruft diese Methode auf, wenn ein Bereich in einen unverankerten Zustand wechselt. Die Methode erstellt ein Minirahmenfenster und fügt den Bereich an dieses Fenster an.

Die Standardimplementierung gibt NULL zurück.

CBasePane::CreateEx

Erstellt das Bereichssteuerelement.

virtual BOOL CreateEx(
    DWORD dwStyleEx,
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    DWORD dwControlBarStyle=0,
    CCreateContext* pContext=NULL);

Parameter

dwStyleEx
[in] Die erweiterten Formatvorlagen (weitere Informationen finden Sie unter CWnd::CreateEx ).

lpszClassName
[in] Der Name der Fensterklasse.

lpszWindowName
[in] Der Fenstername.

dwStyle
[in] Die Fensterformatvorlage (siehe CWnd::CreateEx).

Rect
[in] Das anfängliche Rechteck.

pParentWnd
[in] Ein Zeiger auf das übergeordnete Fenster.

Nid
[in] Gibt die Bereichs-ID an. Der Name muss eindeutig sein.

dwControlBarStyle
[in] Formatvorlagenkennzeichnungen für Bereiche.

pContext
[in] Ein Zeiger auf CcreateContext

Rückgabewert

TRUE, wenn der Bereich erfolgreich erstellt wird; andernfalls FALSE.

Hinweise

Erstellt ein Fenster der Klasse lpszClassName. Wenn Sie WS_CAPTION angeben, löscht diese Methode das WS_CAPTION Formatvorlagenbit und legt CBasePane::m_bHasCaption auf TRUE fest, da die Bibliothek Bereiche mit Untertitel nicht unterstützt.

Sie können eine beliebige Kombination von untergeordneten Fensterformatvorlagen und MFC-Steuerelementleistenarten (CBRS_) verwenden.

Die Bibliothek fügt mehrere neue Formatvorlagen für Bereiche hinzu. In der folgenden Tabelle werden die neuen Formatvorlagen beschrieben:

Style Beschreibung
AFX_CBRS_FLOAT Der Bereich kann schweben.
AFX_CBRS_AUTOHIDE Der Bereich unterstützt den Modus "Automatisches Ausblenden"
AFX_CBRS_RESIZE Die Größe des Bereichs kann geändert werden. Wichtig: Diese Formatvorlage ist nicht implementiert.
AFX_CBRS_CLOSE Der Bereich kann geschlossen werden.
AFX_CBRS_AUTO_ROLLUP Der Bereich kann beim Gleiten eingerollt werden.
AFX_CBRS_REGULAR_TABS Wenn ein Bereich an einen anderen Bereich andockt, der diese Formatvorlage aufweist, wird ein normales Fenster mit Registerkartenformat erstellt. (Weitere Informationen finden Sie unter CTabbedPane-Klasse.)
AFX_CBRS_OUTLOOK_TABS Wenn ein Bereich an einen anderen Bereich angedockt wird, der diese Formatvorlage aufweist, wird ein Fenster mit Registerkartenformat im Outlook-Stil erstellt. (Weitere Informationen finden Sie unter CMFCOutlookBar-Klasse.)

Um die neuen Formatvorlagen zu verwenden, geben Sie sie in dwControlBarStyle an.

CBasePane::D ockPane

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

virtual BOOL DockPane(
    CBasePane* pDockBar,
    LPCRECT lpRect,
    AFX_DOCK_METHOD dockMethod);

Parameter

pDockBar
[in] Ein Zeiger auf einen anderen Bereich.

lpRect
[in] Gibt das Zielrechteck an.

dockMethod
[in] Gibt die Docking-Methode an.

Rückgabewert

TRUE, wenn die Steuerleiste erfolgreich angedockt wurde; andernfalls FALSE.

Hinweise

Rufen Sie diese Funktion auf, um einen Bereich an einen anderen Bereich oder eine Dockleiste (CDockSite-Klasse) anzudocken, die von pDockBar angegeben wird, oder an einen Standard Frame, wenn pDockBar NULL ist.

dockMethod gibt an, wie der Bereich angedockt wird. Eine Liste möglicher Werte finden Sie unter "CPane::D ockPane ".

CBasePane::D ockPaneUsingRTTI

Dockt den Bereich mithilfe von Laufzeittypinformationen an.

void DockPaneUsingRTTI(BOOL bUseDockSite);

Parameter

bUseDockSite
[in] Wenn TRUE, andocken Sie an der Docking-Site. Wenn FALSE, andocken Sie an den übergeordneten Frame.

CBasePane::D ockToFrameWindow

Dockt einen andockbaren Bereich an einen Frame an.

virtual BOOL DockToFrameWindow(
    DWORD dwAlignment,
    LPCRECT lpRect = NULL,
    DWORD dwDockFlags = DT_DOCK_LAST,
    CBasePane* pRelativeBar = NULL,
    int nRelativeIndex = -1,
    BOOL bOuterEdge = FALSE);

Parameter

dwAlignment
[in] Die Seite des übergeordneten Frames, an dem Sie den Bereich andocken möchten.

lpRect
[in] Die gewünschte Größe.

dwDockFlags
[in] Ignoriert.

pRelativeBar
[in] Ignoriert.

nRelativeIndex
[in] Ignoriert.

bOuterEdge
[in] Wenn TRUE und andere andockbare Bereiche an der Seite vorhanden sind, die durch dwAlignment angegeben sind, wird der Bereich außerhalb der anderen Bereiche angedockt, näher am Rand des übergeordneten Frames. Wenn FALSE, wird der Bereich näher an der Mitte des Clientbereichs angedockt.

Rückgabewert

TRUE, wenn die Methode erfolgreich war; andernfalls FALSE.

Hinweise

Diese Methode schlägt fehl, wenn keine Bereichstrennlinie ( CPaneDivider-Klasse) erstellt werden kann. Andernfalls wird immer TRUE zurückgegeben.

CBasePane::D oesAllowDynInsertBefore

Bestimmt, ob ein anderer Bereich dynamisch zwischen diesem Bereich und dem übergeordneten Frame eingefügt werden kann.

virtual BOOL DoesAllowDynInsertBefore() const;

Rückgabewert

TRUE, wenn ein Benutzer einen anderen Bereich einfügen kann; andernfalls FALSE.

Hinweise

Das Framework ruft diese Methode auf, um zu bestimmen, ob ein Benutzer vor diesem Bereich dynamisch einen Bereich einfügen kann.

Angenommen, Ihre Anwendung erstellt einen Bereich, der an der linken Seite des Frames verankert ist (z. B. die Outlook-Leiste). Um zu verhindern, dass der Benutzer einen anderen Bereich links vom ersten Bereich andockt, überschreiben Sie diese Methode, und geben Sie FALSE zurück.

Es wird empfohlen, diese Methode außer Kraft zu setzen und FALSE für nicht unverankerte Bereiche zurückzugeben, die von der CDockablePane-Klasse abgeleitet sind.

Die Standardimplementierung gibt TRUE zurück.

CBasePane::D oPaint

Füllt den Hintergrund des Bereichs aus.

virtual void DoPaint(CDC* pDC);

Parameter

pDC
[in] Ein Zeiger auf einen Gerätekontext.

Hinweise

Die Standardimplementierung ruft den aktuellen visuellen Manager auf, um den Hintergrund auszufüllen ( CMFCVisualManager::OnFillBarBackground).

CBasePane::EnableDocking

Aktiviert das Andocken des Bereichs an den Standard Frame.

virtual void EnableDocking(DWORD dwAlignment);

Parameter

dwAlignment
[in] Gibt die zu aktivierende Andockausrichtung an.

Hinweise

Rufen Sie diese Methode auf, um die Andockausrichtung an den Standard Frame zu aktivieren. Sie können eine Kombination aus CBRS_ALIGN_ Flags übergeben (weitere Informationen finden Sie unter CControlBar::EnableDocking).

EnableDocking legt die interne Kennzeichnung CBasePane::m_dwEnabledAlignment fest, und das Framework überprüft dieses Kennzeichen, wenn ein Bereich angedockt wird.

Rufen Sie CBasePane::GetEnabledAlignment auf, um die Andockausrichtung für einen Bereich zu bestimmen.

CBasePane::EnableGripper

Aktiviert oder deaktiviert den Ziehelement. Wenn das Ziehelement aktiviert ist, kann der Benutzer ihn ziehen, um den Bereich neu zu positionieren.

virtual void EnableGripper(BOOL bEnable);

Parameter

bEnable
[in] TRUE, um das Ziehelement zu ermöglichen; FALSE, um es zu deaktivieren.

Hinweise

Das Framework verwendet diese Methode, um einen Ziehelement zu aktivieren, anstatt die WS_CAPTION Formatvorlage zu verwenden.

CBasePane::FloatPane

Floats the pane.

virtual BOOL FloatPane(
    CRect rectFloat,
    AFX_DOCK_METHOD dockMethod=DM_UNKNOWN,
    bool bShow=true);

Parameter

rectFloat
[in] Gibt die Bildschirmkoordinaten an, in denen der unverankerte Bereich angezeigt wird.

dockMethod
[in] Gibt die Dockmethode an, die zum Gleiten des Bereichs verwendet werden soll.

bShow
[in] Gibt an, ob der unverankerte Bereich sichtbar (TRUE) oder ausgeblendet (FALSE) ist.

Rückgabewert

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

Hinweise

Rufen Sie diese Methode auf, um einen Bereich an der durch rectFloat angegebenen Bildschirmposition zu schweben.

CBasePane::get_accHelpTopic

Das Framework ruft diese Methode auf, um den vollständigen Pfad der WinHelp-Datei abzurufen, die dem angegebenen Objekt zugeordnet ist, und den Bezeichner des entsprechenden Themas in dieser Datei.

virtual HRESULT get_accHelpTopic(
    BSTR* pszHelpFile,
    VARIANT varChild,
    long* pidTopic);

Parameter

pszHelpFile
[in] Adresse eines BSTR, der den vollständigen Pfad der WinHelp-Datei empfängt, die dem angegebenen Objekt zugeordnet ist, falls vorhanden.

Varchild
[in] Gibt an, ob das abzurufende Hilfethema das Objekt oder eines der untergeordneten Elemente des Objekts ist. Dieser Parameter kann entweder CHILDID_SELF (um ein Hilfethema für das Objekt abzurufen) oder eine untergeordnete ID (um ein Hilfethema für eines der untergeordneten Elemente des Objekts abzurufen) sein.

pidTopic
[in] Identifiziert das Hilfedateithema , das dem angegebenen Objekt zugeordnet ist.

Rückgabewert

CBasePane implementiert diese Methode nicht. CBasePane::get_accHelpTopic Gibt daher immer S_FALSE zurück.

Hinweise

Diese Funktion ist Teil der Unterstützung für die aktive Barrierefreiheit in MFC. Überschreiben Sie diese Funktion in einer abgeleiteten Klasse, um Hilfeinformationen zu Ihrem Objekt bereitzustellen.

CBasePane::get_accSelection

Das Framework ruft diese Methode auf, um die ausgewählten untergeordneten Elemente dieses Objekts abzurufen.

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Parameter

pvarChildren
[in] Empfängt Informationen, die die ausgewählten untergeordneten Elemente identifizieren.

Rückgabewert

CBasePane implementiert diese Methode nicht. Wenn pvarChildren NULL ist, gibt diese Methode E_INVALIDARG zurück. Andernfalls gibt diese Methode DISP_E_MEMBERNOTFOUND zurück.

Hinweise

Diese Funktion ist Teil der Unterstützung für die aktive Barrierefreiheit in MFC. Überschreiben Sie diese Funktion in einer abgeleiteten Klasse, wenn Sie nicht fensterlose Benutzeroberflächenelemente als fensterlose ActiveX-Steuerelemente haben.

CBasePane::GetCaptionHeight

Gibt die Beschriftungshöhe zurück.

virtual int GetCaptionHeight() const;

Rückgabewert

Die Überschriftenhöhe.

CBasePane::GetControlBarStyle

Gibt die Steuerelementleistenart zurück.

virtual DWORD GetControlBarStyle() const

Rückgabewert

Eine bitweise OR-Kombination aus AFX_CBRS_ Flags.

Hinweise

Der Rückgabewert ist eine Kombination der folgenden möglichen Werte.

Style Beschreibung
AFX_CBRS_FLOAT Legt fest, dass die Steuerleiste schwebt.
AFX_CBRS_AUTOHIDE Aktiviert den Modus zum automatischen Ausblenden.
AFX_CBRS_RESIZE Aktiviert die Größenänderung der Steuerelementleiste. Wenn diese Kennzeichnung festgelegt ist, kann die Steuerelementleiste in einem andockbaren Bereich platziert werden.
AFX_CBRS_CLOSE Aktiviert das Ausblenden der Steuerelementleiste.

CBasePane::GetCurrentAlignment

Gibt die aktuelle Bereichsausrichtung zurück.

virtual DWORD GetCurrentAlignment() const;

Rückgabewert

Die aktuelle Ausrichtung der Steuerelementleiste. In der folgenden Tabelle sind die möglichen Werte aufgeführt:

Wert Ausrichtung
CBRS_ALIGN_LEFT Linksbündig.
CBRS_ALIGN_RIGHT Rechtsausrichtung.
CBRS_ALIGN_TOP Obere Ausrichtung.
CBRS_ALIGN_BOTTOM Unten ausgerichtet.

CBasePane::GetDockingMode

Gibt den aktuellen Andockmodus für den Bereich zurück.

virtual AFX_DOCK_TYPE GetDockingMode() const;

Rückgabewert

DT_STANDARD, wenn das Ziehen des Bereichs auf dem Bildschirm durch ein Ziehrechteck angezeigt wird. DT_IMMEDIATE, wenn der Inhalt des Bereichs gezogen wird.

Hinweise

Das Framework ruft diese Methode auf, um den aktuellen Andockmodus des Bereichs zu ermitteln.

Wenn CBasePane::m_dockMode nicht definiert (DT_UNDEFINED) ist, wird der Andockmodus vom globalen Andockmodus (AFX_GLOBAL_DATA::m_dockModeGlobal) übernommen.

Durch Festlegen m_dockMode oder Außerkraftsetzen GetDockingMode können Sie den Andockmodus für jeden Bereich steuern.

CBasePane::GetDockSiteFrameWnd

Gibt einen Zeiger auf das CDockingPanesRow-Objekt zurück, in dem der Bereich verankert ist.

virtual CWnd* GetDockSiteFrameWnd() const;

Rückgabewert

Ein Zeiger auf die Dockwebsite des Bereichs.

Hinweise

Rufen Sie diese Methode auf, um einen Zeiger auf die Dockwebsite des Bereichs abzurufen. Die Dockwebsite kann entweder ein Standard Rahmenfenster sein, wenn der Bereich an den Standard Frame angedockt ist, oder ein Miniframefenster, wenn der Bereich unverankert ist.

CBasePane::GetEnabledAlignment

Gibt die CBRS_ALIGN_ Formatvorlagen zurück, die auf den Bereich angewendet werden.

virtual DWORD GetEnabledAlignment() const;

Rückgabewert

Eine Kombination aus CBRS_ALIGN_ Formatvorlagen. Die folgende Tabelle zeigt die möglichen Formatvorlagen:

Flag Aktivierte Ausrichtung
CBRS_ALIGN_LEFT Links.
CBRS_ALIGN_RIGHT Richting.
CBRS_ALIGN_TOP Top:
CBRS_ALIGN_BOTTOM Unteres.
CBRS_ALIGN_ANY Kombination aller Flags.

Hinweise

Rufen Sie diese Methode auf, um die aktivierte Ausrichtung für den Bereich zu bestimmen. Die aktivierte Ausrichtung bedeutet, dass die Seiten des Standard Rahmenfensters, an das ein Bereich angedockt werden kann.

Aktivieren Sie die Andockausrichtung mithilfe von CBasePane::EnableDocking.

CBasePane::GetMFCStyle

Gibt die bereichsspezifischen Formatvorlagen für MFC zurück.

virtual DWORD GetMFCStyle() const;

Rückgabewert

Eine Kombination aus bibliotheksspezifischen Formatvorlagen (AFX_CBRS_).

CBasePane::GetPaneIcon

Gibt ein Handle zum Bereichssymbol zurück.

virtual HICON GetPaneIcon(BOOL bBigIcon);

Parameter

bBigIcon
[in] Gibt ein 32 Pixel x 32 Pixel-Symbol an, wenn WAHR; Gibt ein Symbol von 16 Pixel mal 16 Pixel an, wenn FALSE.

Rückgabewert

Ein Ziehpunkt für das Bereichssymbol. Wenn dies nicht erfolgreich ist, wird NULL zurückgegeben.

Hinweise

Die Standardimplementierung ruft CWnd::GetIcon auf.

CBasePane::GetPaneRow

Gibt einen Zeiger auf das CDockingPanesRow-Objekt zurück, in dem der Bereich verankert ist.

CDockingPanesRow* GetPaneRow();

Rückgabewert

Ein Zeiger, auf CDockingPanesRow den der Bereich angedockt ist, oder NULL, wenn er unverankert ist.

Hinweise

Rufen Sie diese Methode auf, um auf die Zeile zuzugreifen, in der ein Bereich angedockt ist. Wenn Sie beispielsweise die Bereiche in einer bestimmten Zeile anordnen möchten, rufen Sie GetPaneRow CDockingPanesRow::ArrangePanes auf, und rufen Sie dann CDockingPanes auf.

CBasePane::GetPaneStyle

Gibt das Bereichsformat zurück.

virtual DWORD GetPaneStyle() const;

Rückgabewert

Eine Kombination aus Steuerelementleistenarten (einschließlich CBRS_ Formatvorlagen), die von der CBasePane::SetPaneStyle-Methode zur Erstellungszeit festgelegt wurde.

CBasePane::GetParentDockSite

Gibt einen Zeiger auf die übergeordnete Dockwebsite zurück.

virtual CDockSite* GetParentDockSite() const;

Rückgabewert

Die übergeordnete Dockwebsite.

CBasePane::GetParentMiniFrame

Gibt einen Zeiger auf das übergeordnete Minirahmenfenster zurück.

virtual CPaneFrameWnd* GetParentMiniFrame(BOOL bNoAssert=FALSE) const;

Parameter

bNoAssert
[in] Wenn WAHR, überprüft diese Methode nicht auf ungültige Zeiger. Wenn Sie diese Methode beim Beenden der Anwendung aufrufen, legen Sie diesen Parameter auf TRUE fest.

Rückgabewert

Ein gültiger Zeiger auf das übergeordnete Miniframefenster, wenn der Bereich unverankert ist; andernfalls NULL.

Hinweise

Rufen Sie diese Funktion auf, um einen Zeiger auf das übergeordnete Miniframefenster abzurufen. Diese Methode durchläuft alle übergeordneten Objekte und sucht nach einem Objekt, das von der CPaneFrameWnd-Klasse abgeleitet ist.

Hiermit bestimmen Sie GetParentMiniFrame , ob der Bereich unverankert ist.

CBasePane::GetParentTabbedPane

Gibt einen Zeiger auf den übergeordneten Registerkartenbereich zurück.

CBaseTabbedPane* GetParentTabbedPane() const;

Rückgabewert

Ein Zeiger auf den übergeordneten Registerkartenbereich, sofern vorhanden; andernfalls NULL.

CBasePane::GetParentTabWnd

Gibt einen Zeiger auf das übergeordnete Fenster zurück, das sich innerhalb einer Registerkarte befindet.

CMFCBaseTabCtrl* GetParentTabWnd(HWND& hWndTab) const;

Parameter

hWndTab
[out] Wenn der Rückgabewert nicht NULL ist, enthält dieser Parameter das Handle für das übergeordnete Registerkartenfenster.

Rückgabewert

Ein gültiger Zeiger auf das übergeordnete Registerkartenfenster oder NULL.A valid pointer to the parent tabbed window or NULL.

Hinweise

Verwenden Sie diese Funktion, um einen Zeiger auf das übergeordnete Registerkartenfenster abzurufen. Manchmal reicht es nicht aus, um aufzurufen GetParent, da sich ein Bereich möglicherweise innerhalb eines Dockingwrappers ( CDockablePaneAdapter-Klasse) oder innerhalb eines Bereichsadapters ( CDockablePaneAdapter-Klasse) befindet. Mithilfe der Verwendung GetParentTabWnd können Sie in diesen Fällen einen gültigen Zeiger abrufen (vorausgesetzt, das übergeordnete Fenster ist ein Fenster mit Registerkartenformat).

CBasePane::GetRecentVisibleState

Das Framework ruft diese Methode auf, wenn ein Bereich aus einem Archiv wiederhergestellt wird.

virtual BOOL GetRecentVisibleState() const;

Rückgabewert

Ein BOOL, das den aktuellen sichtbaren Zustand angibt. Wenn TRUE, wurde der Bereich beim Serialisieren angezeigt und sollte beim Wiederherstellen sichtbar sein. Wenn FALSE, wurde der Bereich beim Serialisieren ausgeblendet und sollte beim Wiederherstellen ausgeblendet werden.

CBasePane::HideInPrintPreviewMode

Gibt an, ob der Bereich in der Seitenansicht ausgeblendet ist.

virtual BOOL HideInPrintPreviewMode() const;

Rückgabewert

TRUE, wenn der Bereich nicht in der Seitenansicht angezeigt wird; andernfalls FALSE.

Hinweise

Basisbereiche werden in der Seitenansicht nicht angezeigt. Daher gibt diese Methode immer TRUE zurück.

CBasePane::InsertPane

Registriert den angegebenen Bereich mit dem Docking-Manager.

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

Parameter

pControlBar
[in] Ein Zeiger auf den einzufügenden Bereich.

pTarget
[in] Ein Zeiger auf den angrenzenden Bereich.

bAfter
[in] Wenn TRUE, wird pControlBar nach pTarget eingefügt. Wenn FALSE, wird pControlBar vor pTarget eingefügt.

Rückgabewert

TRUE, wenn die Methode erfolgreich ist, andernfalls FALSE.

CBasePane::IsAccessibilityCompatible

Gibt an, ob der Bereich die aktive Barrierefreiheit unterstützt.

virtual BOOL IsAccessibilityCompatible();

Rückgabewert

TRUE, wenn der Bereich die aktive Barrierefreiheit unterstützt; andernfalls FALSE.

CBasePane::IsAutoHideMode

Bestimmt, ob sich ein Bereich im Modus "Automatisch ausblenden" befindet.

virtual BOOL IsAutoHideMode() const;

Rückgabewert

TRUE, wenn sich der Bereich im Modus "Automatisches Ausblenden" befindet; andernfalls FALSE.

Hinweise

Basisbereiche können nicht automatisch ausgeblendet werden. Diese Methode gibt immer FALSE zurück.

CBasePane::IsDialogControl

Gibt an, ob es sich bei dem Bereich um ein Dialogfeld-Steuerelement handelt.

BOOL IsDialogControl() const;

Rückgabewert

TRUE, wenn der Bereich ein Dialogfeld-Steuerelement ist; andernfalls FALSE.

Hinweise

Das Framework verwendet diese Methode, um die Layoutkonsistenz für alle Bereiche sicherzustellen.

CBasePane::IsDocked

Bestimmt, ob der Bereich angedockt ist.

virtual BOOL IsDocked() const;

Rückgabewert

TRUE, wenn das übergeordnete Element des Bereichs kein Miniframe ist oder wenn der Bereich in einem Miniframe mit einem anderen Bereich unverankert ist; andernfalls FALSE.

CBasePane::IsFloating

Bestimmt, ob der Bereich unverankert ist.

virtual BOOL IsFloating() const;

Rückgabewert

TRUE, wenn der Bereich unverankert ist; andernfalls FALSE.

Hinweise

Diese Methode gibt den entgegengesetzten Wert von CBasePane::IsDocked zurück.

CBasePane::IsHorizontal

Bestimmt, ob der Bereich horizontal verankert ist.

virtual BOOL IsHorizontal() const;

Rückgabewert

TRUE, wenn der Bereich horizontal angedockt ist; andernfalls FALSE.

Hinweise

Die Standardimplementierung überprüft die aktuelle Andockausrichtung auf CBRS_ORIENT_HORZ.

CBasePane::IsInFloatingMultiPaneFrameWnd

Gibt an, ob sich der Bereich in einem Fenster mit mehreren Fensterausschnitten befindet ( CMultiPaneFrameWnd-Klasse).

virtual BOOL IsInFloatingMultiPaneFrameWnd() const;

Rückgabewert

TRUE, wenn sich der Bereich in einem Fenster mit mehreren Fenstern befindet; andernfalls FALSE.

Hinweise

Nur andockbare Bereiche können in einem Fenster mit mehreren Fensterausschnitten schweben. CBasePane::IsInFloatingMultiPaneFrameWnd Gibt daher immer FALSE zurück.

CBasePane::IsMDITabbed

Bestimmt, ob der Bereich einem untergeordneten MDI-Fenster als Dokument mit Registerkarten hinzugefügt wurde.

virtual BOOL IsMDITabbed() const;

Rückgabewert

TRUE, wenn der Bereich einem untergeordneten MDI-Fenster als Registerkartendokument hinzugefügt wurde; andernfalls FALSE.

CBasePane::IsPaneVisible

Gibt an, ob das WS_VISIBLE Flag für den Bereich festgelegt ist.

BOOL IsPaneVisible() const;

Rückgabewert

TRUE, wenn WS_VISIBLE festgelegt ist; andernfalls FALSE.

Hinweise

Verwenden Sie CBasePane::IsVisible , um die Sichtbarkeit des Bereichs zu bestimmen.

CBasePane::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.

Hinweise

Der Punkt befindet sich in der Nähe des Dockstandorts, wenn er sich in der Vertraulichkeit befindet, die im Docking-Manager festgelegt ist. Die Standardempfindlichkeit beträgt 15 Pixel.

CBasePane::IsResizable

Bestimmt, ob die Größe des Bereichs geändert werden kann.

virtual BOOL IsResizable() const;

Rückgabewert

TRUE, wenn die Größe des Bereichs vom Benutzer geändert werden kann; andernfalls FALSE.

Hinweise

Bereiche der CDockablePane-Klasse können die Größe ändern.

Die Statusleiste ( CMFCStatusBar-Klasse) und die Dockleiste ( CDockSite-Klasse) können nicht geändert werden.

CBasePane::IsRestoredFromRegistry

Bestimmt, ob der Bereich aus der Registrierung wiederhergestellt wird.

virtual BOOL IsRestoredFromRegistry() const;

Rückgabewert

TRUE, wenn der Bereich aus der Registrierung wiederhergestellt wird; andernfalls FALSE.

CBasePane::IsTabbed

Bestimmt, ob der Bereich in das Registersteuerelement eines Registerkartenfensters eingefügt wurde.

virtual BOOL IsTabbed() const;

Rückgabewert

TRUE, wenn die Steuerelementleiste auf einer Registerkarte eines Registerkartenfensters eingefügt wird; andernfalls FALSE.

Hinweise

Diese Methode ruft einen Zeiger auf das direkte übergeordnete Element ab und bestimmt, ob die Laufzeitklasse des übergeordneten Elements DIE CMFCBaseTabCtrl-Klasse ist.

CBasePane::IsVisible

Bestimmt, ob der Bereich sichtbar ist.

virtual BOOL IsVisible() const;

Rückgabewert

TRUE, wenn der Bereich sichtbar ist; andernfalls FALSE.

Hinweise

Verwenden Sie diese Methode, um die Sichtbarkeit eines Bereichs zu bestimmen. Verwenden Sie nicht ::IsWindowVisible.

Wenn der Bereich nicht tabstoppfähig ist (siehe CBasePane::IsTabbed), überprüft diese Methode die WS_VISIBLE Formatvorlage. Wenn der Bereich tabbed ist, überprüft diese Methode die Sichtbarkeit des übergeordneten Registerkartenfensters. Wenn das übergeordnete Fenster sichtbar ist, überprüft die Funktion die Sichtbarkeit der Bereichsregisterkarte mithilfe von CMFCBaseTabCtrl::IsTabVisible.

CBasePane::LoadState

Lädt den Zustand des Bereichs aus der Registrierung.

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

Parameter

lpszProfileName
[in] Profilname.

nIndex
[in] Profilindex.

uiID
[in] Bereichs-ID.

Rückgabewert

TRUE, wenn der Bereichsstatus erfolgreich geladen wurde; andernfalls FALSE.

Hinweise

Das Framework ruft diese Methode auf, um den Bereichsstatus aus der Registrierung zu laden. Überschreiben Sie sie in einer abgeleiteten Klasse, um zusätzliche Informationen zu laden, die von CBasePane::SaveState gespeichert wurden.

CBasePane::MoveWindow

Verschiebt den Bereich.

virtual HDWP MoveWindow(
    CRect& rect,
    BOOL bRepaint = TRUE,
    HDWP hdwp = NULL);

Parameter

Rect
[in] Ein Rechteck, das die neue Position und Größe des Bereichs angibt.

bRepaint
[in] Wenn TRUE, wird der Bereich aktualisiert. Wenn FALSE, wird der Bereich nicht aktualisiert.

hdwp
[in] Handle to a deferred window position structure.

Rückgabewert

Ein Handle zu einer Struktur der verzögerten Fensterposition oder NULL.

Hinweise

Wenn Sie NULL als HDWP-Parameter übergeben, verschiebt diese Methode das Fenster normal. Wenn Sie ein Handle übergeben, führt diese Methode eine verzögerte Fensterverschiebung durch. Sie können ein Handle abrufen, indem Sie BeginDeferWindowPos aufrufen oder den Rückgabewert eines vorherigen Aufrufs dieser Methode speichern.

CBasePane::OnAfterChangeParent

Wird vom Framework aufgerufen, nachdem sich das übergeordnete Element des Bereichs geändert hat.

virtual void OnAfterChangeParent(CWnd* pWndOldParent);

Parameter

pWndOldParent
[in] Ein Zeiger auf das vorherige übergeordnete Element.

Hinweise

Das Framework ruft diese Methode auf, nachdem sich das übergeordnete Element des Bereichs geändert hat, in der Regel aufgrund eines Andockvorgangs oder eines unverankerten Vorgangs.

Bei der Standardimplementierung wird keine Aktion ausgeführt.

CBasePane::OnBeforeChangeParent

Das Framework wird direkt vor dem Ändern des übergeordneten Fensters durch das Framework aufgerufen.

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

Parameter

pWndNewParent
[in] Ein Zeiger auf ein neues übergeordnetes Fenster.

bDelay
[in] Gibt an, ob Layoutanpassungen verzögert werden müssen.

Hinweise

Das Framework ruft diese Methode unmittelbar vor den übergeordneten Änderungen des Bereichs auf, in der Regel aufgrund eines Andockvorgangs, eines unverankerten oder automatischen Ausblendens.

Bei der Standardimplementierung wird keine Aktion ausgeführt.

CBasePane::OnDrawCaption

Das Framework ruft diese Methode auf, wenn die Untertitel gezeichnet wird.

virtual void OnDrawCaption();

Hinweise

Diese Methode hat keine Funktionalität für die CBasePane Klasse.

CBasePane::OnMovePaneDivider

Diese Methode wird derzeit nicht verwendet.

virtual void OnMovePaneDivider(CPaneDivider* /* unused */);

Parameter

Unbenutzte
[in] Wird nicht verwendet.

CBasePane::OnPaneContextMenu

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

virtual void OnPaneContextMenu(
    CWnd* pParentFrame,
    CPoint point);

Parameter

pParentFrame
[in] Ein Zeiger auf den übergeordneten Frame.

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

Hinweise

OnPaneContextMenuruft den Docking-Manager auf, der die Liste der Bereiche, die zum aktuellen Framefenster gehören, Standard enthält. Diese Methode fügt die Namen der Bereiche zu einem Kontextmenü hinzu und zeigt sie an. Die Befehle im Menü zeigen einzelne Bereiche an oder blenden sie aus.

Überschreiben Sie diese Methode, um dieses Verhalten anzupassen.

CBasePane::OnRemoveFromMiniFrame

Wird vom Framework aufgerufen, wenn ein Bereich aus dem übergeordneten Miniframefenster entfernt wird.

virtual void OnRemoveFromMiniFrame(CPaneFrameWnd* pMiniFrame);

Parameter

pMiniFrame
[in] Ein Zeiger auf ein Miniframefenster, aus dem der Bereich entfernt wird.

Hinweise

Das Framework ruft diese Methode auf, wenn ein Bereich aus dem übergeordneten Miniframefenster entfernt wird (z. B. aufgrund des Andockens).

Bei der Standardimplementierung wird keine Aktion ausgeführt.

CBasePane::OnSetAccData

CBasePane verwendet diese Methode nicht.

virtual BOOL OnSetAccData(long lVal);

Parameter

lVal
[in] Wird nicht verwendet.

Rückgabewert

Diese Methode gibt immer TRUE zurück.

Hinweise

CBasePane::P aneFromPoint

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

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    bool bExactBar = false,
    CRuntimeClass* pRTCBarType = NULL) const;

Parameter

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

nSensitivität
[in] Erhöhen Sie den Suchbereich um diesen Betrag. Ein Bereich erfüllt die Suchkriterien, wenn der angegebene Punkt in den erweiterten Bereich fällt.

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

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

Rückgabewert

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

CBasePane::RecalcLayout

CBasePane verwendet diese Methode nicht.

virtual void RecalcLayout();

CBasePane::RemovePaneFromDockManager

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

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

Parameter

Pbar
[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, ist das Andocklayout mit der Liste der Autohidebalken verknüpft. Wenn FALSE, ist das Andocklayout mit der Liste der regulären Bereiche verknüpft.

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

CBasePane::SaveState

Speichert den Zustand des Bereichs in der Registrierung.

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

Parameter

lpszProfileName
[in] Profilname.

nIndex
[in] Profilindex.

uiID
[in] Bereichs-ID.

Rückgabewert

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

Hinweise

Das Framework ruft diese Methode auf, wenn der Status des Bereichs in der Registrierung gespeichert wird. Überschreiben SaveState sie in einer abgeleiteten Klasse, um zusätzliche Informationen zu speichern.

CBasePane::SelectDefaultFont

Wählt die Standardschriftart für einen bestimmten Gerätekontext aus.

CFont* SelectDefaultFont(CDC* pDC);

Parameter

pDC
[in] Ein Gerätekontext.

Rückgabewert

Ein Zeiger auf das standardmäßige CFont Class-Objekt .

CBasePane::SetControlBarStyle

Legt die Steuerelementleistenart fest.

virtual void SetControlBarStyle(DWORD dwNewStyle);

Parameter

dwNewStyle
[in] Eine bitweise OR-Kombination der folgenden möglichen Werte.

Style Beschreibung
AFX_CBRS_FLOAT Legt fest, dass die Steuerleiste schwebt.
AFX_CBRS_AUTOHIDE Aktiviert den Modus zum automatischen Ausblenden.
AFX_CBRS_RESIZE Aktiviert die Größenänderung der Steuerelementleiste. Wenn diese Kennzeichnung festgelegt ist, kann die Steuerelementleiste in einem andockbaren Bereich platziert werden.
AFX_CBRS_CLOSE Aktiviert das Ausblenden der Steuerelementleiste.

CBasePane::SetDockingMode

Legt den Dockingmodus für den Bereich fest.

void SetDockingMode(AFX_DOCK_TYPE dockModeNew);

Parameter

dockModeNew
[in] Gibt den neuen Andockmodus für den Bereich an.

Hinweise

Das Framework unterstützt zwei Dockingmodi: Standard und direkt.

Im Standard-Docking-Modus werden Bereiche und Miniframefenster mithilfe eines Ziehen-Rechtecks verschoben. Im unmittelbaren Andockmodus werden Steuerleisten und Minirahmenfenster sofort mit ihrem Kontext verschoben.

Zunächst wird der Andockmodus global durch CDockingManager::m_dockModeGlobal definiert. Sie können den Andockmodus für jeden Bereich einzeln mithilfe der SetDockingMode Methode festlegen.

CBasePane::SetPaneAlignment

Legt die Ausrichtung für den Bereich fest.

virtual void SetPaneAlignment(DWORD dwAlignment);

Parameter

dwAlignment
[in] Gibt die neue Ausrichtung an.

Hinweise

In der Regel ruft das Framework diese Methode auf, wenn ein Bereich von einer Seite des Standard Frames an eine andere angedockt wird.

Die folgende Tabelle zeigt die möglichen Werte für dwAlignment:

Wert Ausrichtung
CBRS_ALIGN_LEFT Linksbündig.
CBRS_ALIGN_RIGHT Rechtsausrichtung.
CBRS_ALIGN_TOP Obere Ausrichtung.
CBRS_ALIGN_BOTTOM Unten ausgerichtet.

CBasePane::SetPaneStyle

Legt die Formatvorlage des Bereichs fest.

virtual void SetPaneStyle(DWORD dwNewStyle);

Parameter

dwNewStyle
[in] Gibt die neue festzulegende Formatvorlage an.

Hinweise

Diese Methode kann verwendet werden, um eine der CBRS_ Formatvorlagen festzulegen, die in afxres.h definiert sind. Da Bereichsformat und Bereichsausrichtung zusammen gespeichert werden, legen Sie die neue Formatvorlage fest, indem Sie sie mit der aktuellen Ausrichtung wie folgt kombinieren.

pPane->SetPaneStyle (pPane->GetCurrentAlignment() | CBRS_TOOLTIPS);

CBasePane::SetWindowPos

Ändert die Größe, Position und Z-Reihenfolge eines Bereichs.

virtual HDWP SetWindowPos(
    const CWnd* pWndInsertAfter,
    int x,
    int y,
    int cx,
    int cy,
    UINT nFlags,
    HDWP hdwp = NULL);

Parameter

pWndInsertAfter
[in] Identifiziert das CWnd Objekt, das vor diesem CWnd Objekt in der Z-Reihenfolge steht. Weitere Informationen finden Sie unter CWnd::SetWindowPos.

x
[in] Gibt die Position der linken Seite des Fensters an.

y
[in] Gibt die Position des oberen Fensters an.

Cx
[in] Gibt die Breite des Fensters an.

Cy
[in] Gibt die Höhe des Fensters an.

nFlags
[in] Gibt Größen- und Positionsoptionen an. Weitere Informationen finden Sie unter CWnd::SetWindowPos.

hdwp
[in] Behandeln Sie eine Struktur, die Größen- und Positionsinformationen für ein oder mehrere Fenster enthält.

Rückgabewert

Ein Handle zu einer aktualisierten verzögerten Fensterpositionsstruktur oder NULL.

Hinweise

Wenn pWndInsertAfter NULL ist, ruft diese Methode CWnd::SetWindowPos auf. Wenn pWndInsertAfter ungleich NULL ist, ruft diese Methode auf DeferWindowPos.

CBasePane::ShowPane

Blendet den Bereich ein oder aus.

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

Parameter

bShow
[in] Gibt an, ob ein Bereich angezeigt werden soll (TRUE) oder ausblenden (FALSE).

bDelay
[in] Bei TRUE wird die Neuberechnung des Dockinglayouts verzögert.

bActivate
[in] Wenn TRUE, ist der Bereich aktiv, wenn er angezeigt wird.

Hinweise

Diese Methode blendet einen Bereich ein oder aus. Verwenden Sie diese Methode statt ShowWindow , da diese Methode die relevanten Andockmanager über Änderungen an der Sichtbarkeit des Bereichs benachrichtigt.

Verwenden Sie CBasePane::IsVisible , um die aktuelle Sichtbarkeit eines Bereichs zu ermitteln.

CBasePane::StretchPane

Streckt einen Bereich vertikal oder horizontal.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Parameter

nLength
[in] Die Länge, um die der Bereich gestreckt werden soll.

bVert
[in] Wenn WAHR, dehnen Sie den Bereich vertikal. Wenn FALSCH, dehnen Sie den Bereich horizontal.

Rückgabewert

Die Größe des gestreckten Bereichs.

CBasePane::UndockPane

Entfernt den Bereich von der Dockwebsite, dem Standardschieberegler oder dem Miniframefenster, in dem er derzeit verankert ist.

virtual void UndockPane(BOOL bDelay=FALSE);

Parameter

bDelay
Wenn TRUE, wird das Dockinglayout nicht sofort neu berechnet.

Hinweise

Rufen Sie diese Methode auf, um den Bereichszustand zu bearbeiten oder den Bereich aus dem Andocklayout auszuschließen.

Wenn Sie diesen Bereich weiterhin verwenden möchten, rufen Sie entweder CBasePane::D ockPane oder CBasePane::FloatPane auf, bevor Sie diese Methode aufrufen.

Siehe auch

Hierarchiediagramm
Klassen
CPane
CWnd-Klasse