Classe CAutoHideDockSite
CAutoHideDockSite Estende la classe CDockSite per implementare riquadri di ancoraggio nascosti automaticamente.
Sintassi
class CAutoHideDockSite : public CDockSite
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| Name | Descrizione |
CAutoHideDockSite::CAutoHideDockSite |
Costruisce un oggetto CAutoHideDockSite. |
CAutoHideDockSite::~CAutoHideDockSite |
Distruttore. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| Name | Descrizione |
CAutoHideDockSite::AllowShowOnPaneMenu |
Indica se l'oggetto CAutoHideDockSite viene visualizzato nel menu del riquadro. |
| CAutoHideDockSite::CanAcceptPane | Determina se un oggetto riquadro di base è derivato dalla classe CMFCAutoHideBar. |
| CAutoHideDockSite::D ockPane | Ancora un riquadro a questo CAuotHideDockSite oggetto. |
| CAutoHideDockSite::GetAlignRect | Recupera le dimensioni del sito di ancoraggio nelle coordinate dello schermo. |
| CAutoHideDockSite::RepositionPanes | Ridisegna il riquadro su CAutoHideDockSite con i margini globali e la spaziatura dei pulsanti. |
| CAutoHideDockSite::SetOffsetLeft | Imposta il margine sul lato sinistro della barra di ancoraggio. |
| CAutoHideDockSite::SetOffsetRight | Imposta il margine sul lato destro della barra di ancoraggio. |
| CAutoHideDockSite::UnSetAutoHideMode | Chiama CMFCAutoHideBar::UnSetAutoHideMode per gli oggetti in CAutoHideDockSite. |
Membri dei dati
| Nome | Descrizione |
|---|---|
| Name | Descrizione |
| CAutoHideDockSite::m_nExtraSpace | Definisce le dimensioni dello spazio tra le barre degli strumenti e il bordo della barra di ancoraggio. Questo spazio viene misurato dal bordo sinistro o dal bordo superiore, a seconda dell'allineamento per lo spazio di ancoraggio. |
Osservazioni:
Quando si chiama CFrameWndEx::EnableAutoHidePanes, il framework crea automaticamente un CAutoHideDockSite oggetto . Nella maggior parte dei casi, non è necessario creare un'istanza o usare direttamente questa classe.
La barra di ancoraggio è il divario tra il lato sinistro del riquadro di ancoraggio e il lato sinistro della classe CMFCAutoHideButton.
Gerarchia di ereditarietà
Esempio
Nell'esempio seguente viene illustrato come recuperare un CAutoHideDockSite oggetto da un CMFCAutoHideBar oggetto e come impostare i margini sinistro e destro della barra di ancoraggio.
CAutoHideDockSite *pParentDockBar = DYNAMIC_DOWNCAST(CAutoHideDockSite, pParentBar->GetParentDockSite());
pParentDockBar->SetOffsetLeft(10);
pParentDockBar->SetOffsetRight(10);
Requisiti
Intestazione: afxautohidedocksite.h
CAutoHideDockSite::CanAcceptPane
Determina se un riquadro di base è un oggetto CMFCAutoHideBar o derivato da CMFCAutoHideBar.
virtual BOOL CanAcceptPane(const CBasePane* pBar) const;
Parametri
pBar
[in] Riquadro di base di cui viene verificato il framework.
Valore restituito
TRUE se pBar è derivato da CMFCAutoHideBar; FALSE in caso contrario.
Osservazioni:
Se un oggetto riquadro di base è derivato da CMFCAutoHideBar, può contenere un oggetto CAutoHideDockSite.
CAutoHideDockSite::D ockPane
Ancora un riquadro a questo oggetto CAutoHideDockSite .
virtual void DockPane(
CPane* pWnd,
AFX_DOCK_METHOD dockMethod,
LPRECT lpRect = NULL);
Parametri
pWnd
[in] Riquadro ancorato al framework.
dockMethod
[in] Opzioni di ancoraggio per il riquadro.
lpRect
[in] Rettangolo che specifica i limiti per il riquadro ancorato.
Osservazioni:
L'implementazione predefinita non usa il parametro dockMethod, fornito per un uso futuro.
Se lpRect è NULL, il framework inserisce il riquadro nella posizione predefinita nel sito dock. Se il sito di ancoraggio è orizzontale, la posizione predefinita si trova all'estrema sinistra del sito di ancoraggio. In caso contrario, la posizione predefinita si trova nella parte superiore del sito di ancoraggio.
CAutoHideDockSite::GetAlignRect
Recupera le dimensioni del sito di ancoraggio nelle coordinate dello schermo.
void GetAlignRect(CRect& rect) const;
Parametri
rect
[in] Riferimento a un rettangolo. Il metodo archivia le dimensioni del sito di ancoraggio in questo rettangolo.
Osservazioni:
Il rettangolo viene regolato per i margini di offset in modo che non siano inclusi.
CAutoHideDockSite::m_nExtraSpace
Dimensioni dello spazio tra i bordi della classe CAutoHideDockSite e gli oggetti classe CMFCAutoHideBar.
static int m_nExtraSpace;
Osservazioni:
Quando un oggetto CMFCAutoHideBar è ancorato a un CAutoHideDockSiteoggetto , non deve occupare l'intero sito di ancoraggio. Questa variabile globale controlla lo spazio aggiuntivo tra il bordo sinistro o superiore del CMFCAutoHideBar e il bordo corrispondente CAutoHideDockSite . L'uso del bordo superiore o sinistro dipende dall'allineamento corrente.
CAutoHideDockSite::SetOffsetLeft
Imposta il margine sul lato sinistro della barra di ancoraggio.
void SetOffsetLeft(int nOffset);
Parametri
nOffset
[in] Nuovo offset.
Osservazioni:
Gli oggetti CMFCAutoHideBar vengono posizionati in modo statico sull'oggetto CAutoHideDockSite . Ciò significa che l'utente non può modificare manualmente la posizione degli CMFCAutoHideBar oggetti. Il SetOffsetLeft metodo controlla la spaziatura tra il lato sinistro del lato sinistro CMFCAutoHideBar e il lato sinistro dell'oggetto CAutoHideDockSite.
CAutoHideDockSite::SetOffsetRight
Imposta il margine sul lato destro della barra di ancoraggio.
void SetOffsetRight(int nOffset);
Parametri
nOffset
[in] Nuovo offset.
Osservazioni:
Gli oggetti CMFCAutoHideBar vengono posizionati in modo statico sull'oggetto CAutoHideDockSite . Ciò significa che l'utente non può modificare manualmente la posizione degli CMFCAutoHideBar oggetti. Il SetOffsetRight metodo controlla la spaziatura tra il lato destro del lato destro CMFCAutoHideBar e il lato destro di CAutoHideDockSite.
CAutoHideDockSite::RepositionPanes
Ridisegna i riquadri in CAutoHideDockSite.
virtual void RepositionPanes(CRect& rectNewClientArea);
Parametri
rectNewClientArea
[in] Valore riservato.
Osservazioni:
L'implementazione predefinita non usa rectNewClientArea. Ridisegna i riquadri con i margini globali della barra degli strumenti e la spaziatura dei pulsanti.
CAutoHideDockSite::UnSetAutoHideMode
Chiama CMFCAutoHideBar::UnSetAutoHideMode per gli oggetti nel sito dock.
void UnSetAutoHideMode(CMFCAutoHideBar* pAutoHideToolbar);
Parametri
pAutoHideToolbar
[in] Puntatore a un riquadro oggetti CMFCAutoHideBar che si trova nell'oggetto CAutoHideDockSite.
Osservazioni:
Questo metodo cerca la riga contenente pAutoHideToolbar. CMFCAutoHideBar.UnSetAutoHideMode Chiama tutti gli CMFCAutoHideBar oggetti in tale riga. Se pAutoHideToolbar non viene trovato o è NULL, questo metodo chiama CMFCAutoHideBar.UnSetAutoHideMode tutti gli CMFCAutoHideBar oggetti in CAutoHideDockSite.