Auf Englisch lesen

Freigeben über


CPaneFrameWnd-Klasse

Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

Implementiert ein Minirahmenfenster, das einen Bereich enthält. Der Bereich füllt den Clientbereich des Fensters aus.

Syntax

class CPaneFrameWnd : public CWnd

Member

Öffentliche Methoden

Name Beschreibung
CPaneFrameWnd::AddPane Fügt einen Bereich hinzu.
CPaneFrameWnd::AddRemovePaneFromGlobalList Fügt einen Bereich zur globalen Liste hinzu oder entfernt ihn daraus.
CPaneFrameWnd::AdjustLayout Passt das Layout des Minirahmenfensters an.
CPaneFrameWnd::AdjustPaneFrames
CPaneFrameWnd::CalcBorderSize Berechnet die Größe der Rahmen für ein Minirahmenfenster.
CPaneFrameWnd::CalcExpectedDockedRect Berechnet das erwartete Rechteck eines angedockten Fensters.
CPaneFrameWnd::CanBeAttached Bestimmt, ob der aktuelle Bereich an einen anderen Bereich oder an ein Framefenster angedockt werden kann.
CPaneFrameWnd::CanBeDockedToPane Bestimmt, ob das Minirahmenfenster an einen Bereich angedockt werden kann.
CPaneFrameWnd::CheckGripperVisibility
CPaneFrameWnd::ConvertToTabbedDocument Konvertiert den Bereich in ein Dokument mit Registerkarten.
CPaneFrameWnd::Create Erstellt ein Minirahmenfenster und fügt es dem CPaneFrameWnd-Objekt an.
CPaneFrameWnd::CreateEx Erstellt ein Minirahmenfenster und fügt es dem CPaneFrameWnd-Objekt an.
CPaneFrameWnd::D ockPane Dockt den Bereich an.
CPaneFrameWnd::FindFloatingPaneByID Sucht einen Bereich mit der angegebenen Steuerelement-ID in der globalen Liste unverankerter Bereiche.
CPaneFrameWnd::FrameFromPoint Sucht das Minirahmenfenster mit einem vom Benutzer angegebenen Punkt.
CPaneFrameWnd::GetCaptionHeight Gibt die Höhe der Beschriftung des Minirahmenfensters zurück.
CPaneFrameWnd::GetCaptionRect Berechnet das umschließende Rechteck der Beschriftung eines Minirahmenfensters.
CPaneFrameWnd::GetCaptionText Gibt den Beschriftungstext zurück.
CPaneFrameWnd::GetDockingManager
CPaneFrameWnd::GetDockingMode Gibt den Andockmodus zurück.
CPaneFrameWnd::GetFirstVisiblePane Gibt den ersten sichtbaren Bereich zurück, der in einem Minirahmenfenster enthalten ist.
CPaneFrameWnd::GetHotPoint
CPaneFrameWnd::GetPane Gibt einen Bereich zurück, der im Minirahmenfenster enthalten ist.
CPaneFrameWnd::GetPaneCount Gibt die Anzahl der Bereiche zurück, die im Minirahmenfenster enthalten sind.
CPaneFrameWnd::GetParent
CPaneFrameWnd::GetPinState
CPaneFrameWnd::GetRecentFloatingRect
CPaneFrameWnd::GetVisiblePaneCount Gibt die Anzahl der sichtbaren Bereiche zurück, die im Minirahmenfenster enthalten sind.
CPaneFrameWnd::HitTest Bestimmt, welcher Teil eines Minirahmenfensters sich an einem bestimmten Punkt befindet.
CPaneFrameWnd::IsCaptured
CPaneFrameWnd::IsDelayShow
CPaneFrameWnd::IsRollDown Bestimmt, ob ein Minirahmenfenster abwärts zugeordnet werden soll.
CPaneFrameWnd::IsRollUp Bestimmt, ob ein Minirahmenfenster aufwärts zugeordnet werden soll.
CPaneFrameWnd::KillDockingTimer Hält den Andocktimer an.
CPaneFrameWnd::LoadState Lädt den Zustand des Bereichs aus der Registrierung.
CPaneFrameWnd::OnBeforeDock Bestimmt, ob Andocken möglich ist.
CPaneFrameWnd::OnDockToRecentPos Dockt das Minirahmenfenster an der letzten Position an.
CPaneFrameWnd::OnKillRollUpTimer Hält den Rolluptimer an.
CPaneFrameWnd::OnMovePane Verschiebt das Minirahmenfenster anhand eines angegebenen Offsets.
CPaneFrameWnd::OnPaneRecalcLayout Passt das Layout eines enthaltenen Bereichs an.
CPaneFrameWnd::OnSetRollUpTimer Richtet den Rolluptimer ein.
CPaneFrameWnd::OnShowPane Wird vom Framework aufgerufen, wenn ein Bereich im Minirahmenfenster angezeigt oder ausgeblendet wird.
CPaneFrameWnd::P aneFromPoint Gibt einen Bereich zurück, wenn er einen vom Benutzer angegebenen Punkt innerhalb einer Minirahmenfensters enthält.
CPaneFrameWnd::P in
CPaneFrameWnd::PreTranslateMessage Wird von der CWinApp -Klasse verwendet, um Fenstermeldungen zu übersetzen, bevor diese an die Windows-Funktionen TranslateMessage und DispatchMessage gesendet werden.
CPaneFrameWnd::RedrawAll Zeichnet alle Minirahmenfenster neu.
CPaneFrameWnd::RemoveNonValidPanes Wird vom Framework aufgerufen, um ungültige Bereiche zu entfernen.
CPaneFrameWnd::RemovePane Entfernt einen Bereich aus dem Minirahmenfenster.
CPaneFrameWnd::ReplacePane Ersetzt einen Bereich durch einen anderen.
CPaneFrameWnd::SaveState Speichert den Zustand des Bereichs in der Registrierung.
CPaneFrameWnd::Serialize Liest oder schreibt dieses Objekt aus einem oder in ein Archiv.
CPaneFrameWnd::SetCaptionButtons Legt Beschriftungsschaltflächen fest.
CPaneFrameWnd::SetDelayShow
CPaneFrameWnd::SetDockingManager
CPaneFrameWnd::SetDockingTimer Legt den Andocktimer fest.
CPaneFrameWnd::SetDockState Legt den Andockzustand fest.
CPaneFrameWnd::SetHotPoint
CPaneFrameWnd::SetPreDockState Wird vom Framework aufgerufen, um den Zustand vor dem Andocken festzulegen.
CPaneFrameWnd::SizeToContent Passt die Größe eines Minirahmenfensters an, damit es in der Größe einem enthaltenen Bereich entspricht.
CPaneFrameWnd::StartTearOff Schneidet ein Menü ab.
CPaneFrameWnd::StoreRecentDockSiteInfo
CPaneFrameWnd::StoreRecentTabRelatedInfo

Geschützte Methoden

Name Beschreibung
CPaneFrameWnd::OnCheckRollState Bestimmt, ob ein Minirahmenfenster aufwärts oder abwärts zugeordnet werden soll.
CPaneFrameWnd::OnDrawBorder Zeichnet die Rahmen eines Minirahmenfensters.

Datenelemente

Name Beschreibung
CPaneFrameWnd::m_bUseSaveBits Gibt an, ob die Fensterklasse mit dem CS_SAVEBITS Klassenstil registriert werden soll.

Hinweise

Das Framework erstellt automatisch ein CPaneFrameWnd-Objekt, wenn ein Bereich aus einem angedockten Zustand in einen unverankerten Zustand wechselt.

Ein Minirahmenfenster kann mit sichtbarem Inhalt (sofortiges Andocken) oder mit einem Rechteck (standardmäßiges Andocken) gezogen werden. Der Andockmodus des Containerbereichs des Minirahmenfensters bestimmt das Ziehverhalten des Minirahmens. Weitere Informationen finden Sie unter CBasePane::GetDockingMode.

Ein Minirahmenfenster zeigt Schaltflächen auf der Beschriftung in Übereinstimmung mit den enthaltenen Bereichsformat an. Wenn der Bereich geschlossen werden kann ( CBasePane::CanBeClosed), wird eine Schaltfläche "Schließen" angezeigt. Wenn der Bereich die AFX_CBRS_AUTO_ROLLUP Formatvorlage aufweist, wird ein Pin angezeigt.

Wenn Sie eine Klasse von CPaneFrameWnd ableiten, müssen Sie dem Framework die Erstellung erläutern. Erstellen Sie entweder die Klasse, indem Sie CPane::CreateDefaultMiniframe überschreiben, oder legen Sie das CPane::m_pMiniFrameRTC Element so fest, dass sie auf die Laufzeitklasseninformationen für Ihre Klasse verweist.

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CPaneFrameWnd

Anforderungen

Header: afxPaneFrameWnd.h

CPaneFrameWnd::AddPane

Fügt einen Bereich hinzu.

virtual void AddPane(CBasePane* pWnd);

Parameter

pWnd
[in] Der hinzuzufügende Bereich.

CPaneFrameWnd::AddRemovePaneFromGlobalList

Fügt einen Bereich zur globalen Liste hinzu oder entfernt ihn daraus.

static BOOL __stdcall AddRemovePaneFromGlobalList(
    CBasePane* pWnd,
    BOOL bAdd);

Parameter

pWnd
[in] Der Bereich, der hinzugefügt oder entfernt werden soll.

bAdd
[in] Wenn keine Null ist, fügen Sie den Bereich hinzu. Wenn 0, entfernen Sie den Bereich.

Rückgabewert

Nicht 0, wenn die Methode erfolgreich ausgeführt wurde, andernfalls 0

CPaneFrameWnd::AdjustLayout

Passt das Layout des Minirahmenfensters an.

virtual void AdjustLayout();

CPaneFrameWnd::AdjustPaneFrames

virtual void AdjustPaneFrames();

Hinweise

CPaneFrameWnd::CalcBorderSize

Berechnet die Größe der Rahmen für ein Miniframefenster.

virtual void CalcBorderSize(CRect& rectBorderSize) const;

Parameter

rectBorderSize
[out] Enthält die Größe des Rahmens des Miniframefensters in Pixeln.

Hinweise

Diese Methode wird vom Framework aufgerufen, um die Größe des Rahmens eines Miniframefensters zu berechnen. Die zurückgegebene Größe hängt davon ab, ob ein Miniframefenster eine Symbolleiste oder einen CDockablePane enthält.

CPaneFrameWnd::CalcExpectedDockedRect

Berechnet das erwartete Rechteck eines angedockten Fensters.

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

Parameter

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

ptMouse
[in] Die Mausposition.

rectResult
[out] Das berechnete Rechteck.

bDrawTab
[out] Wenn WAHR, zeichnen Sie eine Registerkarte. Wenn FALSCH, zeichnen Sie keine Registerkarte.

ppTargetBar
[out] Ein 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.

CPaneFrameWnd::CanBeAttached

Bestimmt, ob der aktuelle Bereich an einen anderen Bereich oder an ein Framefenster angedockt werden kann.

virtual BOOL CanBeAttached() const;

Rückgabewert

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

CPaneFrameWnd::CanBeDockedToPane

Bestimmt, ob das Minirahmenfenster an einen Bereich angedockt werden kann.

virtual BOOL CanBeDockedToPane(const CDockablePane* pDockingBar) const;

Parameter

pDockingBar
[in] Ein Bereich.

Rückgabewert

Nonzero, wenn der Miniframe an pDockingBar angedockt werden kann; andernfalls 0.

CPaneFrameWnd::CheckGripperVisibility

virtual void CheckGripperVisibility();

Hinweise

CPaneFrameWnd::ConvertToTabbedDocument

Konvertiert den Bereich in ein Dokument mit Registerkarten.

virtual void ConvertToTabbedDocument();

CPaneFrameWnd::Create

Erstellt ein Miniframefenster und fügt es an das CPaneFrameWnd -Objekt an.

virtual BOOL Create(
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    CCreateContext* pContext = NULL);

Parameter

lpszWindowName
[in] Gibt den Text an, der im Miniframefenster angezeigt werden soll.

dwStyle
[in] Gibt die Fensterformatvorlage an. Weitere Informationen finden Sie unter "Fensterformatvorlagen".

rect
[in] Gibt die anfängliche Größe und Position des Miniframefensters an.

pParentWnd
[in, out] Gibt den übergeordneten Frame des Miniframefensters an. Dieser Wert darf nicht NULL sein.

pContext
[in, out] Gibt den benutzerdefinierten Kontext an.

Rückgabewert

TRUE, wenn das Fenster erfolgreich erstellt wurde; andernfalls FALSE.

Hinweise

Ein Miniframefenster wird in zwei Schritten erstellt. Zunächst erstellt das Framework ein CPaneFrameWnd Objekt. Zweitens wird Create aufgerufen, um das Windows-Miniframefenster zu erstellen und an das CPaneFrameWnd Objekt anzufügen.

CPaneFrameWnd::CreateEx

Erstellt ein Miniframefenster und fügt es an das CPaneFrameWnd -Objekt an.

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

Parameter

dwStyleEx
[in] Gibt die Formatvorlage für das erweiterte Fenster an. Weitere Informationen finden Sie unter "Erweiterte Fensterarten"

lpszWindowName
[in] Gibt den Text an, der im Miniframefenster angezeigt werden soll.

dwStyle
[in] Gibt die Fensterformatvorlage an. Weitere Informationen finden Sie unter "Fensterformatvorlagen".

rect
[in] Gibt die anfängliche Größe und Position des Miniframefensters an.

pParentWnd
[in, out] Gibt den übergeordneten Frame des Miniframefensters an. Dieser Wert darf nicht NULL sein.

pContext
[in, out] Gibt den benutzerdefinierten Kontext an.

Rückgabewert

TRUE, wenn das Fenster erfolgreich erstellt wurde; andernfalls FALSE.

Hinweise

Ein Miniframefenster wird in zwei Schritten erstellt. Zunächst erstellt das Framework ein CPaneFrameWnd Objekt. Zweitens wird Create aufgerufen, um das Windows-Miniframefenster zu erstellen und an das CPaneFrameWnd Objekt anzufügen.

CPaneFrameWnd::D ockPane

Dockt den Bereich an.

virtual CDockablePane* DockPane(BOOL& bWasDocked);

Parameter

bWasDocked
[out] TRUE, wenn der Bereich bereits angedockt wurde; andernfalls FALSE.

Rückgabewert

Wenn der Vorgang erfolgreich war, wurde der CDockablePane Bereich angedockt, andernfalls NULL.

CPaneFrameWnd::FindFloatingPaneByID

Sucht einen Bereich mit der angegebenen Steuerelement-ID in der globalen Liste unverankerter Bereiche.

static CBasePane* FindFloatingPaneByID(UINT nID);

Parameter

Nid
[in] Stellt die Steuerelement-ID des zu suchenden Bereichs dar.

Rückgabewert

Der Bereich mit der angegebenen Steuerelement-ID; andernfalls NULL, wenn kein Bereich die angegebene Steuerelement-ID aufweist.

CPaneFrameWnd::FrameFromPoint

Sucht das Miniframefenster, das den angegebenen Punkt enthält.

static CPaneFrameWnd* __stdcall FrameFromPoint(
    CPoint pt,
    int nSensitivity,
    CPaneFrameWnd* pFrameToExclude = NULL,
    BOOL bFloatMultiOnly = FALSE);

Parameter

pt
[in] Der Punkt in Bildschirmkoordinaten.

nSensitivität
[in] Vergrößern Sie den Suchbereich des Miniframefensters um diese Größe. Ein Miniframefenster erfüllt die Suchkriterien, wenn der angegebene Punkt in den vergrößerten Bereich fällt.

pFrameToExclude
[in] Gibt ein Miniframefenster an, das von der Suche ausgeschlossen werden soll.

bFloatMultiOnly
[in] Wenn WAHR, suchen Sie nur Minirahmenfenster mit CBRS_FLOAT_MULTI Formatvorlage. Wenn FALSE, durchsuchen Sie alle Miniframefenster.

Rückgabewert

Ein Zeiger auf das Miniframefenster, das Pt. enthält, andernfalls NULL.

CPaneFrameWnd::GetCaptionHeight

Gibt die Höhe der Beschriftung des Minirahmenfensters zurück.

virtual int GetCaptionHeight() const;

Rückgabewert

Die Höhe des Minirahmenfensters in Pixel.

Hinweise

Rufen Sie diese Methode auf, um die Höhe eines Miniframefensters zu bestimmen. Standardmäßig ist die Höhe auf SM_CYSMCAPTION festgelegt. Weitere Informationen finden Sie unter GetSystemMetrics Function.

CPaneFrameWnd::GetCaptionRect

Berechnet das umschließende Rechteck der Beschriftung eines Minirahmenfensters.

virtual void GetCaptionRect(CRect& rectCaption) const;

Parameter

rectCaption
[out] Enthält die Größe und Position der Beschriftung des Miniframefensters in Bildschirmkoordinaten.

Hinweise

Diese Methode wird vom Framework aufgerufen, um das umgebende Rechteck einer Miniframefensterbeschriftung zu berechnen.

CPaneFrameWnd::GetCaptionText

Gibt den Beschriftungstext zurück.

virtual CString GetCaptionText();

Rückgabewert

Der Beschriftungstext des Minirahmenfensters.

Hinweise

Diese Methode wird vom Framework aufgerufen, wenn der Beschriftungstext angezeigt wird.

CPaneFrameWnd::GetDockingManager

CDockingManager* GetDockingManager() const;

Rückgabewert

Bemerkungen

CPaneFrameWnd::GetDockingMode

Gibt den Andockmodus zurück.

virtual AFX_DOCK_TYPE GetDockingMode() const;

Rückgabewert

Der Andockmodus. Einer der folgenden Werte:

  • DT_STANDARD

  • DT_IMMEDIATE

  • DT_SMART

CPaneFrameWnd::GetFirstVisiblePane

Gibt den ersten sichtbaren Bereich zurück, der in einem Minirahmenfenster enthalten ist.

virtual CWnd* GetFirstVisiblePane() const;

Rückgabewert

Der erste Bereich im Miniframefenster oder NULL, wenn das Miniframefenster keine Bereiche enthält.

CPaneFrameWnd::GetHotPoint

CPoint GetHotPoint() const;

Rückgabewert

Bemerkungen

CPaneFrameWnd::GetPane

Gibt einen Bereich zurück, der im Minirahmenfenster enthalten ist.

virtual CWnd* GetPane() const;

Rückgabewert

Der Bereich, der im Miniframe enthalten ist, oder NULL, wenn das Miniframefenster keine Bereiche enthält.

Hinweise

CPaneFrameWnd::GetPaneCount

Gibt die Anzahl der Bereiche zurück, die im Minirahmenfenster enthalten sind.

virtual int GetPaneCount() const;

Rückgabewert

Die Anzahl der Bereiche im Minirahmenfenster. Dieser Wert kann null sein.

Hinweise

CPaneFrameWnd::GetParent

CWnd* GetParent();

Rückgabewert

Bemerkungen

CPaneFrameWnd::GetPinState

BOOL GetPinState() const;

Rückgabewert

Bemerkungen

CPaneFrameWnd::GetRecentFloatingRect

CRect GetRecentFloatingRect() const;

Rückgabewert

Bemerkungen

CPaneFrameWnd::GetVisiblePaneCount

Gibt die Anzahl der sichtbaren Bereiche zurück, die im Minirahmenfenster enthalten sind.

virtual int GetVisiblePaneCount() const;

Rückgabewert

Die Anzahl der sichtbaren Bereiche.

Hinweise

CPaneFrameWnd::HitTest

Bestimmt, welcher Teil eines Minirahmenfensters sich an einem bestimmten Punkt befindet.

virtual LRESULT HitTest(
    CPoint point,
    BOOL bDetectCaption);

Parameter

Punkt
[in] Der zu testende Punkt.

bDetectCaption
[in] Wenn WAHR, überprüfen Sie den Punkt gegen die Beschriftung. Wenn FALSCH, ignorieren Sie die Beschriftung.

Rückgabewert

Einer der folgenden Werte:

Wert Bedeutung
HTNOWHERE Der Punkt befindet sich außerhalb des Minirahmenfensters.
HTCLIENT Der Punkt befindet sich im Clientbereich.
HTCAPTION Der Punkt befindet sich auf der Beschriftung.
HTTOP Der Punkt befindet sich oben.
HTTOPLEFT Der Punkt befindet sich oben links.
HTTOPRIGHT Der Punkt befindet sich oben rechts.
HTLEFT Der Punkt befindet sich links.
HTRIGHT Der Punkt ist rechts.
HTBOTTOM Der Punkt befindet sich unten.
HTBOTTOMLEFT Der Punkt befindet sich unten links.
HTBOTTOMRIGHT Der Punkt befindet sich unten rechts.

CPaneFrameWnd::IsCaptured

BOOL IsCaptured() const;

Rückgabewert

Bemerkungen

CPaneFrameWnd::IsDelayShow

BOOL IsDelayShow() const;

Rückgabewert

Bemerkungen

CPaneFrameWnd::IsRollDown

Bestimmt, ob ein Minirahmenfenster abwärts zugeordnet werden soll.

virtual BOOL IsRollDown() const;

Rückgabewert

TRUE, wenn das Minirahmenfenster heruntergefahren werden muss; andernfalls FALSE.

Hinweise

Diese Methode wird vom Framework aufgerufen, um zu bestimmen, ob ein Miniframefenster heruntergesetzt werden soll. Das Rollup-/Rolldown-Feature ist für ein Miniframefenster aktiviert, wenn es mindestens einen Bereich mit dem AFX_CBRS_AUTO_ROLLUP Flag enthält. Dieses Kennzeichen wird festgelegt, wenn ein Bereich erstellt wird. Weitere Informationen finden Sie unter CBasePane::CreateEx.

Standardmäßig überprüft das Framework, ob sich der Mauszeiger im Umgebenden Rechteck des Miniframefensters befindet, um zu bestimmen, ob das Fenster heruntergefahren werden muss. Sie können dieses Verhalten in einer abgeleiteten Klasse außer Kraft setzen.

CPaneFrameWnd::IsRollUp

Bestimmt, ob ein Minirahmenfenster aufwärts zugeordnet werden soll.

virtual BOOL IsRollUp() const;

Rückgabewert

TRUE, wenn das Miniframefenster eingerollt werden muss; andernfalls FALSE.

Hinweise

Diese Methode wird vom Framework aufgerufen, um zu bestimmen, ob ein Miniframefenster rollup gestellt werden soll. Das Rollup-/Rolldown-Feature ist für ein Miniframefenster aktiviert, wenn es mindestens einen Bereich mit dem AFX_CBRS_AUTO_ROLLUP Flag enthält. Dieses Kennzeichen wird festgelegt, wenn ein Bereich erstellt wird. Weitere Informationen finden Sie unter CBasePane::CreateEx.

Standardmäßig überprüft das Framework, ob sich der Mauszeiger im Umgebenden Rechteck des Miniframefensters befindet, um zu bestimmen, ob das Fenster rollup ausgeführt werden muss. Sie können dieses Verhalten in einer abgeleiteten Klasse außer Kraft setzen.

CPaneFrameWnd::KillDockingTimer

Hält den Andocktimer an.

void KillDockingTimer();

CPaneFrameWnd::LoadState

Lädt den Zustand des Bereichs aus der Registrierung.

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

Parameter

lpszProfileName
[in] Der Profilname.

uiID
[in] Die Bereichs-ID.

Rückgabewert

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

CPaneFrameWnd::m_bUseSaveBits

Gibt an, ob die Fensterklasse mit dem CS_SAVEBITS Klassenstil registriert werden soll.

AFX_IMPORT_DATA static BOOL m_bUseSaveBits;

Hinweise

Legen Sie dieses statische Element auf TRUE fest, um die Miniframefensterklasse mit dem CS_SAVEBITS-Format zu registrieren. Dies kann dazu beitragen, das Flackern zu reduzieren, wenn ein Benutzer das Miniframefenster zieht.

CPaneFrameWnd::OnBeforeDock

Bestimmt, ob Andocken möglich ist.

virtual BOOL OnBeforeDock();

Rückgabewert

TRUE, wenn das Andocken möglich ist; andernfalls FALSE.

CPaneFrameWnd::OnCheckRollState

Bestimmt, ob ein Minirahmenfenster aufwärts oder abwärts zugeordnet werden soll.

virtual void OnCheckRollState();

Hinweise

Diese Methode wird vom Framework aufgerufen, um zu bestimmen, ob ein Miniframefenster nach oben oder unten verschoben werden soll.

Standardmäßig ruft das Framework CPaneFrameWnd::IsRollUp und CPaneFrameWnd::IsRollDown auf und streckt oder stellt das Miniframefenster wieder her. Sie können diese Methode in einer abgeleiteten Klasse überschreiben, um einen anderen visuellen Effekt zu verwenden.

CPaneFrameWnd::OnDockToRecentPos

Dockt das Minirahmenfenster an der letzten Position an.

virtual void OnDockToRecentPos();

CPaneFrameWnd::OnDrawBorder

Zeichnet die Rahmen eines Minirahmenfensters.

virtual void OnDrawBorder(CDC* pDC);

Parameter

pDC
[in] Der Gerätekontext, der zum Zeichnen des Rahmens verwendet wird.

Hinweise

Diese Methode wird vom Framework aufgerufen, um die Rahmen des Miniframefensters zu zeichnen.

CPaneFrameWnd::OnKillRollUpTimer

Hält den Rolluptimer an.

virtual void OnKillRollUpTimer();

CPaneFrameWnd::OnMovePane

Verschiebt das Minirahmenfenster anhand eines angegebenen Offsets.

virtual void OnMovePane(
    CPane* pBar,
    CPoint ptOffset);

Parameter

pBar
[in] Ein Zeiger auf einen Bereich (ignoriert).

ptOffset
[in] Der Offset, um den der Bereich verschoben werden soll.

CPaneFrameWnd::OnPaneRecalcLayout

Passt das Layout eines Bereichs in einem Minirahmenfenster an.

virtual void OnPaneRecalcLayout();

Hinweise

Das Framework ruft diese Methode auf, wenn das Layout eines Bereichs innerhalb des Miniframefensters angepasst werden muss.

Standardmäßig wird der Bereich positioniert, um den vollständigen Clientbereich des Miniframefensters abzudecken.

CPaneFrameWnd::OnSetRollUpTimer

Richtet den Rolluptimer ein.

virtual void OnSetRollUpTimer();

CPaneFrameWnd::OnShowPane

Wird vom Framework aufgerufen, wenn ein Bereich im Minirahmenfenster angezeigt oder ausgeblendet wird.

virtual void OnShowPane(
    CDockablePane* pBar,
    BOOL bShow);

Parameter

pBar
[in] Der Bereich, der angezeigt oder ausgeblendet wird.

bShow
[in] TRUE, wenn der Bereich angezeigt wird; FALSE, wenn der Bereich ausgeblendet wird.

Hinweise

Wird vom Framework aufgerufen, wenn ein Bereich im Miniframefenster angezeigt oder ausgeblendet wird. Bei der Standardimplementierung wird keine Aktion ausgeführt.

CPaneFrameWnd::P in

void Pin(BOOL bPin = TRUE);

Parameter

[in] bPin

Hinweise

CPaneFrameWnd::P aneFromPoint

Gibt einen Bereich zurück, wenn er einen vom Benutzer angegebenen Punkt innerhalb einer Minirahmenfensters enthält.

virtual CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    BOOL bCheckVisibility);

Parameter

Punkt
[in] Der Punkt, auf den der Benutzer in Bildschirmkoordinaten geklickt hat.

nSensitivität
[in] Dieser Parameter wird nicht verwendet.

bCheckVisibility
[in] TRUE, um anzugeben, dass nur sichtbare Bereiche zurückgegeben werden sollen; andernfalls FALSE.

Rückgabewert

Der Bereich, auf den der Benutzer geklickt hat, oder NULL, wenn an diesem Speicherort kein Bereich vorhanden ist.

Hinweise

Rufen Sie diese Methode auf, um einen Bereich abzurufen, der den angegebenen Punkt enthält.

CPaneFrameWnd::RedrawAll

Zeichnet alle Minirahmenfenster neu.

static void RedrawAll();

Hinweise

Diese Methode aktualisiert alle Miniframefenster durch Aufrufen von CWnd::RedrawWindow für jedes Fenster.

CPaneFrameWnd::RemoveNonValidPanes

Wird vom Framework aufgerufen, um ungültige Bereiche zu entfernen.

virtual void RemoveNonValidPanes();

CPaneFrameWnd::RemovePane

Entfernt einen Bereich aus dem Minirahmenfenster.

virtual void RemovePane(
    CBasePane* pWnd,
    BOOL bDestroy = FALSE,
    BOOL bNoDelayedDestroy = FALSE);

Parameter

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

bDestroy
[in] Gibt an, was mit dem Miniframefenster passiert. Wenn bDestroy TRUE ist, zerstört diese Methode das Miniframefenster sofort. Wenn es FALSCH ist, zerstört diese Methode das Miniframefenster nach einer bestimmten Verzögerung.

bNoDelayedDestroy
[in] Wenn WAHR, wird die verzögerte Zerstörung deaktiviert. Wenn FALSE, wird die verzögerte Zerstörung aktiviert.

Hinweise

Das Framework kann Miniframefenster sofort oder nach einer bestimmten Verzögerung zerstören. Wenn Sie die Zerstörung von Miniframefenstern verzögern möchten, übergeben Sie FALSE im Parameter "bNoDelayedDestroy ". Verzögerte Zerstörung tritt auf, wenn das Framework die AFX_WM_CHECKEMPTYMINIFRAME Nachricht verarbeitet.

CPaneFrameWnd::ReplacePane

Ersetzt einen Bereich durch einen anderen.

virtual void ReplacePane(
    CBasePane* pBarOrg,
    CBasePane* pBarReplaceWith);

Parameter

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

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

CPaneFrameWnd::SaveState

Speichert den Zustand des Bereichs in der Registrierung.

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

Parameter

lpszProfileName
[in] Der Profilname.

uiID
[in] Die Bereichs-ID.

Rückgabewert

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

CPaneFrameWnd::SetCaptionButtons

Legt Beschriftungsschaltflächen fest.

virtual void SetCaptionButtons(DWORD dwButtons);

Parameter

dwButtons
[in] Bitweise-OR-Kombination der folgenden Werte:

  • AFX_CAPTION_BTN_CLOSE

  • AFX_CAPTION_BTN_PIN

  • AFX_CAPTION_BTN_MENU

  • AFX_CAPTION_BTN_CUSTOMIZE

CPaneFrameWnd::SetDelayShow

void SetDelayShow(BOOL bDelayShow);

Parameter

[in] bDelayShow

Hinweise

CPaneFrameWnd::SetDockingManager

void SetDockingManager(CDockingManager* pManager);

Parameter

[in] pManager

Hinweise

CPaneFrameWnd::SetDockingTimer

Legt den Andocktimer fest.

void SetDockingTimer(UINT nTimeOut);

Parameter

nTimeOut
[in] Timeoutwert in Millisekunden.

CPaneFrameWnd::SetDockState

Legt den Andockzustand fest.

virtual void SetDockState(CDockingManager* pDockManager);

Parameter

pDockManager
[in] Ein Zeiger auf einen Docking-Manager.

CPaneFrameWnd::SetHotPoint

void SetHotPoint(CPoint& ptNew);

Parameter

[in] ptNew

Hinweise

CPaneFrameWnd::SetPreDockState

Wird vom Framework aufgerufen, um den Zustand vor dem Andocken festzulegen.

virtual BOOL SetPreDockState(
    AFX_PREDOCK_STATE preDockState,
    CBasePane* pBarToDock = NULL,
    AFX_DOCK_METHOD dockMethod = DM_MOUSE);

Parameter

preDockState
[in] Mögliche Werte:

  • PDS_NOTHING,

  • PDS_DOCK_REGULAR,

  • PDS_DOCK_TO_TAB

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

dockMethod
[in] Die Andockmethode. (Dieser Parameter wird ignoriert.)

Rückgabewert

TRUE, wenn das Minirahmenfenster abgedockt ist; FALSE, wenn sie angedockt ist.

CPaneFrameWnd::SizeToContent

Passt die Größe eines Minirahmenfensters so an, dass es einem enthaltenen Bereich entspricht.

virtual void SizeToContent();

Hinweise

Rufen Sie diese Methode auf, um die Größe eines Miniframefensters an die Größe eines enthaltenen Bereichs anzupassen.

CPaneFrameWnd::StartTearOff

Schneidet ein Menü ab.

BOOL StartTearOff(CMFCPopu* pMenu);

Parameter

pMenu
[in] Ein Zeiger auf ein Menü.

Rückgabewert

TRUE, wenn die Methode erfolgreich war; andernfalls FALSE.

CPaneFrameWnd::StoreRecentDockSiteInfo

virtual void StoreRecentDockSiteInfo(CPane* pBar);

Parameter

[in] pBar

Hinweise

CPaneFrameWnd::StoreRecentTabRelatedInfo

virtual void StoreRecentTabRelatedInfo(
    CDockablePane* pDockingBar,
    CDockablePane* pTabbedBar);

Parameter

[in] pDockingBar
[in] pTabbedBar

Hinweise

Weitere Informationen

Hierarchiediagramm
Klassen
CWnd-Klasse