Condividi tramite


Classe CPaneFrameWnd

Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.

Implementa una finestra con mini-cornice contenente un riquadro. Il riquadro riempie l'area client della finestra.

Sintassi

class CPaneFrameWnd : public CWnd

Membri

Metodi pubblici

Nome Descrizione
CPaneFrameWnd::AddPane Aggiunge un riquadro.
CPaneFrameWnd::AddRemovePaneFromGlobalList Aggiunge o rimuove un riquadro dall'elenco globale.
CPaneFrameWnd::AdjustLayout Regola il layout della finestra con mini-cornice.
CPaneFrameWnd::AdjustPaneFrames
CPaneFrameWnd::CalcBorderSize Calcola le dimensioni dei bordi per una finestra con mini-cornice.
CPaneFrameWnd::CalcExpectedDockedRect Calcolare il rettangolo previsto di una finestra ancorata.
CPaneFrameWnd::CanBeAttached Determina se il riquadro corrente può essere ancorato a un altro riquadro o a un'altra finestra cornice.
CPaneFrameWnd::CanBeDockedToPane Determina se la finestra con mini-cornice può essere ancorata a un riquadro.
CPaneFrameWnd::CheckGripperVisibility
CPaneFrameWnd::ConvertToTabbedDocument Converte un riquadro in un documento a schede.
CPaneFrameWnd::Create Crea una finestra con mini-cornice e la associa all'oggetto CPaneFrameWnd.
CPaneFrameWnd::CreateEx Crea una finestra con mini-cornice e la associa all'oggetto CPaneFrameWnd.
CPaneFrameWnd::D ockPane Ancora il riquadro.
CPaneFrameWnd::FindFloatingPaneByID Trova un riquadro con l'ID di controllo specificato nell'elenco globale dei riquadri mobili.
CPaneFrameWnd::FrameFromPoint Trova la finestra con mini-cornice contenente un punto fornito dall'utente.
CPaneFrameWnd::GetCaptionHeight Restituisce l'altezza del titolo della finestra con mini-cornice.
CPaneFrameWnd::GetCaptionRect Calcola il rettangolo delimitatore di un titolo di finestra con mini-cornice.
CPaneFrameWnd::GetCaptionText Restituisce il testo del titolo.
CPaneFrameWnd::GetDockingManager
CPaneFrameWnd::GetDockingMode Restituisce la modalità di ancoraggio.
CPaneFrameWnd::GetFirstVisiblePane Restituisce il primo riquadro visibile contenuto in una finestra con mini-cornice.
CPaneFrameWnd::GetHotPoint
CPaneFrameWnd::GetPane Restituisce un riquadro contenuto nella finestra con mini-cornice.
CPaneFrameWnd::GetPaneCount Restituisce il numero di riquadri contenuti in una finestra con mini-cornice.
CPaneFrameWnd::GetParent
CPaneFrameWnd::GetPinState
CPaneFrameWnd::GetRecentFloatingRect
CPaneFrameWnd::GetVisiblePaneCount Restituisce il numero di riquadri visibili contenuti in una finestra con mini-cornice.
CPaneFrameWnd::HitTest Determina quale parte di una finestra con mini-cornice si trova in un punto specifico.
CPaneFrameWnd::IsCaptured
CPaneFrameWnd::IsDelayShow
CPaneFrameWnd::IsRollDown Determina se eseguire il rolldown di una finestra con mini-cornice.
CPaneFrameWnd::IsRollUp Determina se eseguire il rollup di una finestra con mini-cornice.
CPaneFrameWnd::KillDockingTimer Arresta il timer di ancoraggio.
CPaneFrameWnd::LoadState Carica lo stato del riquadro dal Registro di sistema.
CPaneFrameWnd::OnBeforeDock Determina se l'ancoraggio è possibile.
CPaneFrameWnd::OnDockToRecentPos Ancora la finestra con mini-cornice alla posizione più recente.
CPaneFrameWnd::OnKillRollUpTimer Arresta il timer di rollup.
CPaneFrameWnd::OnMovePane Sposta la finestra con mini-cornice in base a un offset specificato.
CPaneFrameWnd::OnPaneRecalcLayout Regola il layout di un riquadro contenuto.
CPaneFrameWnd::OnSetRollUpTimer Imposta il timer di rollup.
CPaneFrameWnd::OnShowPane Chiamata eseguita dal framework quando un riquadro nella finestra con mini-cornice è nascosto o visualizzato.
CPaneFrameWnd::P aneFromPoint Restituisce un riquadro contenente un punto fornito dall'utente all'interno di una finestra con mini-cornice.
CPaneFrameWnd::P in
CPaneFrameWnd::PreTranslateMessage Usato dalla classe CWinApp per convertire i messaggi della finestra prima che vengano inviati alle funzioni Windows TranslateMessage e DispatchMessage .
CPaneFrameWnd::RedrawAll Ridisegna tutte le finestre con mini-cornice.
CPaneFrameWnd::RemoveNonValidPanes Chiamata eseguita dal framework per rimuovere i riquadri non validi.
CPaneFrameWnd::RemovePane Rimuove un riquadro dalla finestra con mini-cornice.
CPaneFrameWnd::ReplacePane Sostituisce un riquadro con un altro.
CPaneFrameWnd::SaveState Salva lo stato del riquadro nel Registro di sistema.
CPaneFrameWnd::Serialize Legge o scrive l'oggetto corrente da o in un archivio.
CPaneFrameWnd::SetCaptionButtons Imposta i pulsanti della barra del titolo.
CPaneFrameWnd::SetDelayShow
CPaneFrameWnd::SetDockingManager
CPaneFrameWnd::SetDockingTimer Imposta il timer di ancoraggio.
CPaneFrameWnd::SetDockState Imposta lo stato di ancoraggio.
CPaneFrameWnd::SetHotPoint
CPaneFrameWnd::SetPreDockState Chiamata eseguita dal framework per impostare lo stato di pre-ancoraggio.
CPaneFrameWnd::SizeToContent Regola le dimensioni di una finestra con mini-cornice in modo che siano uguali a quelle di un riquadro contenuto.
CPaneFrameWnd::StartTearOff Separa un menu.
CPaneFrameWnd::StoreRecentDockSiteInfo
CPaneFrameWnd::StoreRecentTabRelatedInfo

Metodi protetti

Nome Descrizione
CPaneFrameWnd::OnCheckRollState Determina se eseguire il rollup o il rolldown di una finestra con mini-cornice.
CPaneFrameWnd::OnDrawBorder Disegna i bordi di una finestra con mini-cornice.

Membri dei dati

Nome Descrizione
CPaneFrameWnd::m_bUseSaveBits Specifica se registrare la classe window con lo stile della classe CS_SAVEBITS.

Osservazioni:

Il framework crea automaticamente un oggetto CPaneFrameWnd quando un riquadro passa dallo stato ancorato allo stato mobile.

È possibile spostare una finestra con mini-cornice trascinando il relativo contenuto visibile (ancoraggio immediato) oppure usando un rettangolo di trascinamento (ancoraggio standard). La modalità di ancoraggio del riquadro contenitore della finestra con mini-cornice determina il comportamento del trascinamento della finestra con mini-cornice. Per altre informazioni, vedere CBasePane::GetDockingMode.

I pulsanti sulla barra del titolo di una finestra con mini-cornice sono visualizzati in modo conforme allo stile del riquadro contenuto. Se il riquadro può essere chiuso ( CBasePane::CanBeClosed), viene visualizzato un pulsante Chiudi. Se il riquadro ha lo stile AFX_CBRS_AUTO_ROLLUP, viene visualizzato un segnaposto.

Se si deriva una classe da CPaneFrameWnd, è necessario indicare al framework come crearla. Creare la classe eseguendo l'override di CPane::CreateDefaultMiniframe o impostando il CPane::m_pMiniFrameRTC membro in modo che punti alle informazioni sulla classe di runtime per la classe.

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CPaneFrameWnd

Requisiti

Intestazione: afxPaneFrameWnd.h

CPaneFrameWnd::AddPane

Aggiunge un riquadro.

virtual void AddPane(CBasePane* pWnd);

Parametri

pWnd
[in] Riquadro da aggiungere.

CPaneFrameWnd::AddRemovePaneFromGlobalList

Aggiunge o rimuove un riquadro dall'elenco globale.

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

Parametri

pWnd
[in] Riquadro da aggiungere o rimuovere.

bAdd
[in] Se diverso da zero, aggiungere il riquadro. Se 0, rimuovere il riquadro.

Valore restituito

Diverso da zero se il metodo ha avuto esito positivo; in caso contrario, 0.

CPaneFrameWnd::AdjustLayout

Regola il layout della finestra con mini-cornice.

virtual void AdjustLayout();

CPaneFrameWnd::AdjustPaneFrames

virtual void AdjustPaneFrames();

Osservazioni:

CPaneFrameWnd::CalcBorderSize

Calcola le dimensioni dei bordi per una finestra miniframe.

virtual void CalcBorderSize(CRect& rectBorderSize) const;

Parametri

rectBorderSize
[out] Contiene le dimensioni, in pixel, del bordo della finestra miniframe.

Osservazioni:

Questo metodo viene chiamato dal framework per calcolare le dimensioni del bordo di una finestra miniframe. Le dimensioni restituite dipendono dal fatto che una finestra miniframe contenga una barra degli strumenti o un CDockablePane.

CPaneFrameWnd::CalcExpectedDockedRect

Calcolare il rettangolo previsto di una finestra ancorata.

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

Parametri

pWndToDock
[in] Puntatore alla finestra da ancorare.

ptMouse
[in] Posizione del mouse.

rectResult
[out] Rettangolo calcolato.

bDrawTab
[out] Se TRUE, disegnare una scheda. Se FALSE, non disegnare una scheda.

ppTargetBar
[out] Puntatore al riquadro di destinazione.

Osservazioni:

Questo metodo calcola il rettangolo occupato da una finestra se un utente trascina la finestra al punto specificato da ptMouse e la ancora.

CPaneFrameWnd::CanBeAttached

Determina se il riquadro corrente può essere ancorato a un altro riquadro o a un'altra finestra cornice.

virtual BOOL CanBeAttached() const;

Valore restituito

TRUE se il riquadro può essere ancorato a un altro riquadro o a un'altra finestra cornice; in caso contrario FALSE.

CPaneFrameWnd::CanBeDockedToPane

Determina se la finestra con mini-cornice può essere ancorata a un riquadro.

virtual BOOL CanBeDockedToPane(const CDockablePane* pDockingBar) const;

Parametri

pDockingBar
[in] Un riquadro.

Valore restituito

Diverso da zero se il mini-frame può essere ancorato a pDockingBar; in caso contrario, 0.

CPaneFrameWnd::CheckGripperVisibility

virtual void CheckGripperVisibility();

Osservazioni:

CPaneFrameWnd::ConvertToTabbedDocument

Converte un riquadro in un documento a schede.

virtual void ConvertToTabbedDocument();

CPaneFrameWnd::Create

Crea una finestra miniframe e la collega all'oggetto CPaneFrameWnd .

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

Parametri

lpszWindowName
[in] Specifica il testo da visualizzare nella finestra del miniframe.

dwStyle
[in] Specifica lo stile della finestra. Per altre informazioni, vedere Stili finestra.

rect
[in] Specifica le dimensioni iniziali e la posizione della finestra del miniframe.

pParentWnd
[in, out] Specifica il frame padre della finestra miniframe. Questo valore non deve essere NULL.

pContext
[in, out] Specifica il contesto definito dall'utente.

Valore restituito

TRUE se la finestra è stata creata correttamente; in caso contrario, FALSE.

Osservazioni:

Una finestra miniframe viene creata in due passaggi. Prima di tutto, il framework crea un CPaneFrameWnd oggetto . In secondo luogo, chiama Create per creare la finestra miniframe di Windows e collegarla all'oggetto CPaneFrameWnd .

CPaneFrameWnd::CreateEx

Crea una finestra miniframe e la collega all'oggetto CPaneFrameWnd .

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

Parametri

dwStyleEx
[in] Specifica lo stile della finestra estesa. Per altre informazioni, vedere Stili di finestra estesa

lpszWindowName
[in] Specifica il testo da visualizzare nella finestra del miniframe.

dwStyle
[in] Specifica lo stile della finestra. Per altre informazioni, vedere Stili finestra.

rect
[in] Specifica le dimensioni iniziali e la posizione della finestra del miniframe.

pParentWnd
[in, out] Specifica il frame padre della finestra miniframe. Questo valore non deve essere NULL.

pContext
[in, out] Specifica il contesto definito dall'utente.

Valore restituito

TRUE se la finestra è stata creata correttamente; in caso contrario, FALSE.

Osservazioni:

Una finestra miniframe viene creata in due passaggi. Prima di tutto, il framework crea un CPaneFrameWnd oggetto . In secondo luogo, chiama Create per creare la finestra miniframe di Windows e collegarla all'oggetto CPaneFrameWnd .

CPaneFrameWnd::D ockPane

Ancora il riquadro.

virtual CDockablePane* DockPane(BOOL& bWasDocked);

Parametri

bWasDocked
[out] TRUE se il riquadro era già ancorato; in caso contrario FALSE.

Valore restituito

Se l'operazione ha esito positivo, l'oggetto CDockablePane a cui è stato ancorato il riquadro; in caso contrario, NULL.

CPaneFrameWnd::FindFloatingPaneByID

Trova un riquadro con l'ID di controllo specificato nell'elenco globale dei riquadri mobili.

static CBasePane* FindFloatingPaneByID(UINT nID);

Parametri

nID
[in] Rappresenta l'ID del controllo del riquadro da trovare.

Valore restituito

Riquadro con l'ID di controllo specificato; in caso contrario, NULL, se nessun riquadro ha l'ID di controllo specificato.

CPaneFrameWnd::FrameFromPoint

Trova la finestra mini-frame che contiene il punto specificato.

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

Parametri

pt
[in] Punto, nelle coordinate dello schermo.

nSensitivity
[in] Aumentare l'area di ricerca della finestra mini-frame di questa dimensione. Una finestra mini-frame soddisfa i criteri di ricerca se il punto specificato rientra nell'area aumentata.

pFrameToExclude
[in] Specifica una finestra mini-frame da escludere dalla ricerca.

bFloatMultiOnly
[in] Se TRUE, cercare solo le finestre con mini frame con lo stile CBRS_FLOAT_MULTI. Se FALSE, cercare tutte le finestre con mini-frame.

Valore restituito

Puntatore alla finestra mini-frame che contiene pt; in caso contrario, NULL.

CPaneFrameWnd::GetCaptionHeight

Restituisce l'altezza del titolo della finestra con mini-cornice.

virtual int GetCaptionHeight() const;

Valore restituito

Altezza, in pixel, della finestra mini-frame.

Osservazioni:

Chiamare questo metodo per determinare l'altezza di una finestra con mini frame. Per impostazione predefinita, l'altezza è impostata su SM_CYSMCAPTION. Per altre informazioni, vedere Funzione GetSystemMetrics.

CPaneFrameWnd::GetCaptionRect

Calcola il rettangolo delimitatore di un titolo di finestra con mini-cornice.

virtual void GetCaptionRect(CRect& rectCaption) const;

Parametri

rectCaption
[out] Contiene le dimensioni e la posizione della didascalia della finestra con mini frame, nelle coordinate dello schermo.

Osservazioni:

Questo metodo viene chiamato dal framework per calcolare il rettangolo di delimitazione di una didascalia della finestra con mini frame.

CPaneFrameWnd::GetCaptionText

Restituisce il testo del titolo.

virtual CString GetCaptionText();

Valore restituito

Testo della didascalia della finestra con mini frame.

Osservazioni:

Questo metodo viene chiamato dal framework quando visualizza il testo della didascalia.

CPaneFrameWnd::GetDockingManager

CDockingManager* GetDockingManager() const;

Valore restituito

Osservazioni:

CPaneFrameWnd::GetDockingMode

Restituisce la modalità di ancoraggio.

virtual AFX_DOCK_TYPE GetDockingMode() const;

Valore restituito

Modalità di ancoraggio. Uno dei valori seguenti:

  • DT_STANDARD

  • DT_IMMEDIATE

  • DT_SMART

CPaneFrameWnd::GetFirstVisiblePane

Restituisce il primo riquadro visibile contenuto in una finestra con mini-cornice.

virtual CWnd* GetFirstVisiblePane() const;

Valore restituito

Il primo riquadro nella finestra mini-frame o NULL se la finestra mini-frame non contiene riquadri.

CPaneFrameWnd::GetHotPoint

CPoint GetHotPoint() const;

Valore restituito

Osservazioni:

CPaneFrameWnd::GetPane

Restituisce un riquadro contenuto nella finestra con mini-cornice.

virtual CWnd* GetPane() const;

Valore restituito

Riquadro contenuto nel mini-frame o NULL se la finestra mini-frame non contiene riquadri.

Osservazioni:

CPaneFrameWnd::GetPaneCount

Restituisce il numero di riquadri contenuti in una finestra con mini-cornice.

virtual int GetPaneCount() const;

Valore restituito

Numero di riquadri nella finestra mini-frame. Questo valore può essere zero.

Osservazioni:

CPaneFrameWnd::GetParent

CWnd* GetParent();

Valore restituito

Osservazioni:

CPaneFrameWnd::GetPinState

BOOL GetPinState() const;

Valore restituito

Osservazioni:

CPaneFrameWnd::GetRecentFloatingRect

CRect GetRecentFloatingRect() const;

Valore restituito

Osservazioni:

CPaneFrameWnd::GetVisiblePaneCount

Restituisce il numero di riquadri visibili contenuti in una finestra con mini-cornice.

virtual int GetVisiblePaneCount() const;

Valore restituito

Numero di riquadri visibili.

Osservazioni:

CPaneFrameWnd::HitTest

Determina quale parte di una finestra con mini-cornice si trova in un punto specifico.

virtual LRESULT HitTest(
    CPoint point,
    BOOL bDetectCaption);

Parametri

point
[in] Punto da testare.

bDetectCaption
[in] Se TRUE, controllare il punto rispetto alla didascalia. Se FALSE, ignorare la didascalia.

Valore restituito

Uno dei valori seguenti:

Valore Significato
HTNOWHERE Il punto si trova all'esterno della finestra mini-frame.
HTCLIENT Il punto si trova nell'area client.
HTCAPTION Il punto è sulla didascalia.
HTTOP Il punto si trova nella parte superiore.
HTTOPLEFT Il punto si trova in alto a sinistra.
HTTOPRIGHT Il punto si trova in alto a destra.
HTLEFT Il punto è a sinistra.
HTRIGHT Il punto è a destra.
HTBOTTOM Il punto si trova nella parte inferiore.
HTBOTTOMLEFT Il punto si trova in basso a sinistra.
HTBOTTOMRIGHT Il punto si trova in basso a destra.

CPaneFrameWnd::IsCaptured

BOOL IsCaptured() const;

Valore restituito

Osservazioni:

CPaneFrameWnd::IsDelayShow

BOOL IsDelayShow() const;

Valore restituito

Osservazioni:

CPaneFrameWnd::IsRollDown

Determina se eseguire il rolldown di una finestra con mini-cornice.

virtual BOOL IsRollDown() const;

Valore restituito

TRUE se è necessario eseguire il roll down della finestra mini-frame; in caso contrario, FALSE.

Osservazioni:

Questo metodo viene chiamato dal framework per determinare se è necessario eseguire il roll down di una finestra mini-frame. La funzionalità di rollup/rolldown è abilitata per una finestra con mini frame se contiene almeno un riquadro con il flag AFX_CBRS_AUTO_ROLLUP. Questo flag viene impostato quando viene creato un riquadro. Per altre informazioni, vedere CBasePane::CreateEx.

Per impostazione predefinita, il framework controlla se il puntatore del mouse si trova all'interno del rettangolo di delimitazione della finestra mini-frame per determinare se è necessario eseguire il roll down della finestra. È possibile eseguire l'override di questo comportamento in una classe derivata.

CPaneFrameWnd::IsRollUp

Determina se eseguire il rollup di una finestra con mini-cornice.

virtual BOOL IsRollUp() const;

Valore restituito

TRUE se è necessario eseguire il rollup della finestra mini-frame; in caso contrario, FALSE.

Osservazioni:

Questo metodo viene chiamato dal framework per determinare se deve essere eseguito il rollup di una finestra mini-frame. La funzionalità di rollup/rolldown è abilitata per una finestra con mini frame se contiene almeno un riquadro con il flag AFX_CBRS_AUTO_ROLLUP. Questo flag viene impostato quando viene creato un riquadro. Per altre informazioni, vedere CBasePane::CreateEx.

Per impostazione predefinita, il framework controlla se il puntatore del mouse si trova all'interno del rettangolo di delimitazione della finestra mini-frame per determinare se è necessario eseguire il rollup della finestra. È possibile eseguire l'override di questo comportamento in una classe derivata.

CPaneFrameWnd::KillDockingTimer

Arresta il timer di ancoraggio.

void KillDockingTimer();

CPaneFrameWnd::LoadState

Carica lo stato del riquadro dal Registro di sistema.

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

Parametri

lpszProfileName
[in] Nome del profilo.

uiID
[in] ID del riquadro.

Valore restituito

TRUE se lo stato del riquadro è stato caricato correttamente; in caso contrario FALSE.

CPaneFrameWnd::m_bUseSaveBits

Specifica se registrare la classe della finestra con lo stile della classe CS_SAVEBITS.

AFX_IMPORT_DATA static BOOL m_bUseSaveBits;

Osservazioni:

Impostare questo membro statico su TRUE per registrare la classe finestra mini-frame con lo stile CS_SAVEBITS. Ciò può contribuire a ridurre lo sfarfallio quando un utente trascina la finestra mini-frame.

CPaneFrameWnd::OnBeforeDock

Determina se l'ancoraggio è possibile.

virtual BOOL OnBeforeDock();

Valore restituito

TRUE se l'ancoraggio è possibile; in caso contrario, FALSE.

CPaneFrameWnd::OnCheckRollState

Determina se eseguire il rollup o il rolldown di una finestra con mini-cornice.

virtual void OnCheckRollState();

Osservazioni:

Questo metodo viene chiamato dal framework per determinare se è necessario eseguire il rollup o il down di una finestra mini-frame.

Per impostazione predefinita, il framework chiama CPaneFrameWnd::IsRollUp e CPaneFrameWnd::IsRollDown e si estende o ripristina la finestra mini-frame. È possibile eseguire l'override di questo metodo in una classe derivata per usare un effetto visivo diverso.

CPaneFrameWnd::OnDockToRecentPos

Ancora la finestra con mini-cornice alla posizione più recente.

virtual void OnDockToRecentPos();

CPaneFrameWnd::OnDrawBorder

Disegna i bordi di una finestra con mini-cornice.

virtual void OnDrawBorder(CDC* pDC);

Parametri

pDC
[in] Contesto del dispositivo utilizzato per disegnare il bordo.

Osservazioni:

Questo metodo viene chiamato dal framework per disegnare i bordi della finestra mini-frame.

CPaneFrameWnd::OnKillRollUpTimer

Arresta il timer di rollup.

virtual void OnKillRollUpTimer();

CPaneFrameWnd::OnMovePane

Sposta la finestra con mini-cornice in base a un offset specificato.

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

Parametri

pBar
[in] Puntatore a un riquadro (ignorato).

ptOffset
[in] Offset in base al quale spostare il riquadro.

CPaneFrameWnd::OnPaneRecalcLayout

Regola il layout di un riquadro all'interno di una finestra con mini frame.

virtual void OnPaneRecalcLayout();

Osservazioni:

Il framework chiama questo metodo quando deve regolare il layout di un riquadro all'interno della finestra mini-frame.

Per impostazione predefinita, il riquadro è posizionato per coprire l'area client completa della finestra mini-frame.

CPaneFrameWnd::OnSetRollUpTimer

Imposta il timer di rollup.

virtual void OnSetRollUpTimer();

CPaneFrameWnd::OnShowPane

Chiamata eseguita dal framework quando un riquadro nella finestra con mini-cornice è nascosto o visualizzato.

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

Parametri

pBar
[in] Riquadro visualizzato o nascosto.

bShow
[in] TRUE se viene visualizzato il riquadro; FALSE se il riquadro è nascosto.

Osservazioni:

Chiamato dal framework quando viene visualizzato o nascosto un riquadro nella finestra mini-frame. L'implementazione predefinita non esegue alcuna operazione.

CPaneFrameWnd::P in

void Pin(BOOL bPin = TRUE);

Parametri

[in] bPin

Osservazioni:

CPaneFrameWnd::P aneFromPoint

Restituisce un riquadro contenente un punto fornito dall'utente all'interno di una finestra con mini-cornice.

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

Parametri

point
[in] Punto su cui l'utente ha fatto clic, nelle coordinate dello schermo.

nSensitivity
[in] Questo parametro non viene usato.

bCheckVisibility
[in] TRUE per specificare che devono essere restituiti solo i riquadri visibili; in caso contrario, FALSE.

Valore restituito

Riquadro su cui l'utente ha fatto clic oppure NULL se non esiste alcun riquadro in tale posizione.

Osservazioni:

Chiamare questo metodo per ottenere un riquadro contenente il punto specificato.

CPaneFrameWnd::RedrawAll

Ridisegna tutte le finestre con mini-cornice.

static void RedrawAll();

Osservazioni:

Questo metodo aggiorna tutte le finestre mini-frame chiamando CWnd::RedrawWindow per ogni finestra.

CPaneFrameWnd::RemoveNonValidPanes

Chiamata eseguita dal framework per rimuovere i riquadri non validi.

virtual void RemoveNonValidPanes();

CPaneFrameWnd::RemovePane

Rimuove un riquadro dalla finestra con mini-cornice.

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

Parametri

pWnd
[in] Puntatore al riquadro da rimuovere.

bDestroy
[in] Specifica cosa accade alla finestra mini-frame. Se bDestroy è TRUE, questo metodo elimina immediatamente la finestra mini-frame. Se è FALSE, questo metodo elimina definitivamente la finestra mini-frame dopo un determinato ritardo.

bNoDelayedDestroy
[in] Se TRUE, la distruzione ritardata è disabilitata. Se FALSE, la distruzione ritardata è abilitata.

Osservazioni:

Il framework può distruggere le finestre mini-frame immediatamente o dopo un determinato ritardo. Se si desidera ritardare la distruzione di finestre mini-frame, passare FALSE nel parametro bNoDelayedDestroy . La distruzione ritardata si verifica quando il framework elabora il messaggio di AFX_WM_CHECKEMPTYMINIFRAME.

CPaneFrameWnd::ReplacePane

Sostituisce un riquadro con un altro.

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

Parametri

pBarOrg
[in] Puntatore al riquadro originale.

pBarReplaceWith
[in] Puntatore al riquadro che sostituisce il riquadro originale.

CPaneFrameWnd::SaveState

Salva lo stato del riquadro nel Registro di sistema.

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

Parametri

lpszProfileName
[in] Nome del profilo.

uiID
[in] ID del riquadro.

Valore restituito

TRUE se lo stato del riquadro è stato salvato correttamente; in caso contrario FALSE.

CPaneFrameWnd::SetCaptionButtons

Imposta i pulsanti della barra del titolo.

virtual void SetCaptionButtons(DWORD dwButtons);

Parametri

dwButtons
[in] Combinazione OR bit per bit dei valori seguenti:

  • AFX_CAPTION_BTN_CLOSE

  • AFX_CAPTION_BTN_PIN

  • AFX_CAPTION_BTN_MENU

  • AFX_CAPTION_BTN_CUSTOMIZE

CPaneFrameWnd::SetDelayShow

void SetDelayShow(BOOL bDelayShow);

Parametri

[in] bDelayShow

Osservazioni:

CPaneFrameWnd::SetDockingManager

void SetDockingManager(CDockingManager* pManager);

Parametri

[in] pManager

Osservazioni:

CPaneFrameWnd::SetDockingTimer

Imposta il timer di ancoraggio.

void SetDockingTimer(UINT nTimeOut);

Parametri

nTimeOut
[in] Valore di timeout in millisecondi.

CPaneFrameWnd::SetDockState

Imposta lo stato di ancoraggio.

virtual void SetDockState(CDockingManager* pDockManager);

Parametri

pDockManager
[in] Puntatore a un gestore di ancoraggio.

CPaneFrameWnd::SetHotPoint

void SetHotPoint(CPoint& ptNew);

Parametri

[in] ptNew

Osservazioni:

CPaneFrameWnd::SetPreDockState

Chiamata eseguita dal framework per impostare lo stato di pre-ancoraggio.

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

Parametri

preDockState
[in] Valori possibili:

  • PDS_NOTHING,

  • PDS_DOCK_REGULAR,

  • PDS_DOCK_TO_TAB

pBarToDock
[in] Puntatore al riquadro da ancorare.

dockMethod
[in] Metodo di ancoraggio. Questo parametro viene ignorato.

Valore restituito

TRUE se la finestra con mini-cornice è scollegata; FALSE se è ancorato.

CPaneFrameWnd::SizeToContent

Regola le dimensioni di una finestra mini-frame in modo che sia equivalente a un riquadro contenuto.

virtual void SizeToContent();

Osservazioni:

Chiamare questo metodo per regolare le dimensioni di una finestra mini-frame in base alle dimensioni di un riquadro contenuto.

CPaneFrameWnd::StartTearOff

Separa un menu.

BOOL StartTearOff(CMFCPopu* pMenu);

Parametri

pMenu
[in] Puntatore a un menu.

Valore restituito

TRUE se il metodo ha avuto esito positivo; in caso contrario, FALSE.

CPaneFrameWnd::StoreRecentDockSiteInfo

virtual void StoreRecentDockSiteInfo(CPane* pBar);

Parametri

[in] pBar

Osservazioni:

CPaneFrameWnd::StoreRecentTabRelatedInfo

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

Parametri

[in] pDockingBar
[in] pTabbedBar

Osservazioni:

Vedi anche

Grafico della gerarchia
Classi
Classe CWnd