Classe CDockingManager
Implementa la funzionalità principale che controlla il layout di ancoraggio in una finestra cornice principale.
Sintassi
class CDockingManager : public CObject
Membri
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CDockingManager::AddDockSite | Crea un riquadro di ancoraggio e lo aggiunge all'elenco delle barre di controllo. |
| CDockingManager::AddHiddenMDITabbedBar | Aggiunge un handle a un riquadro della barra all'elenco di riquadri a schede MDI nascosti. |
| CDockingManager::AddMiniFrame | Aggiunge una cornice all'elenco di mini frame. |
| CDockingManager::AddPane | Registra un riquadro con il gestore di ancoraggio. |
| CDockingManager::AdjustDockingLayout | Ricalcola e regola il layout di tutti i riquadri in una finestra cornice. |
| CDockingManager::AdjustPaneFrames | Fa sì che il messaggio WM_NCCALCSIZE venga inviato a tutti i riquadri e CPaneFrameWnd le finestre. |
| CDockingManager::AdjustRectToClientArea | Regola l'allineamento di un rettangolo. |
| CDockingManager::AlignAutoHidePane | Ridimensiona un riquadro di ancoraggio in modalità autohide in modo da accettare la larghezza completa o l'altezza dell'area client del frame circondata da siti di ancoraggio. |
| CDockingManager::AutoHidePane | Crea una barra degli strumenti per l'individuazione automatica. |
| CDockingManager::BringBarsToTop | Porta le barre ancorate con l'allineamento specificato all'inizio. |
| CDockingManager::BuildPanesMenu | Aggiunge nomi di riquadri di ancoraggio e barre degli strumenti a un menu. |
| CDockingManager::CalcExpectedDockedRect | Calcola il rettangolo previsto di una finestra ancorata. |
| CDockingManager::Create | Crea un gestore di ancoraggio. |
| CDockingManager::D eterminePaneAndStatus | Determina il riquadro che contiene un punto specificato e il relativo stato di ancoraggio. |
| CDockingManager::D isableRestoreDockState | Abilita o disabilita il caricamento del layout di ancoraggio dal Registro di sistema. |
| CDockingManager::D ockPane | Ancora un riquadro a un altro riquadro o a una finestra cornice. |
| CDockingManager::D ockPaneLeftOf | Ancora un riquadro a sinistra di un altro riquadro. |
| CDockingManager::EnableAutoHidePanes | Abilita l'ancoraggio del riquadro al frame principale, crea un riquadro di ancoraggio e lo aggiunge all'elenco delle barre di controllo. |
| CDockingManager::EnableDocking | Crea un riquadro di ancoraggio e abilita l'ancoraggio del riquadro al frame principale. |
| CDockingManager::EnableDockSiteMenu | Visualizza un pulsante aggiuntivo che apre un menu a comparsa nelle didascalie di tutti i riquadri di ancoraggio. |
| CDockingManager::EnablePaneContextMenu | Indica alla libreria di visualizzare un menu di scelta rapida speciale con un elenco di barre degli strumenti dell'applicazione e riquadri di ancoraggio quando l'utente fa clic sul pulsante destro del mouse e la libreria sta elaborando il messaggio WM_CONTEXTMENU. |
| CDockingManager::FindDockSite | Recupera il riquadro della barra in corrispondenza della posizione specificata e con l'allineamento specificato. |
| CDockingManager::FindDockSiteByPane | Restituisce il riquadro della barra con l'ID del riquadro della barra di destinazione. |
| CDockingManager::FindPaneByID | Trova un riquadro in base all'ID di controllo specificato. |
| CDockingManager::FixupVirtualRects | Esegue il commit di tutte le posizioni correnti della barra degli strumenti in rettangoli virtuali. |
| CDockingManager::FrameFromPoint | Restituisce il frame che contiene il punto specificato. |
| CDockingManager::GetClientAreaBounds | Ottiene il rettangolo che contiene i limiti dell'area client. |
| CDockingManager::GetDockingMode | Restituisce la modalità di ancoraggio corrente. |
| CDockingManager::GetDockSiteFrameWnd | Ottiene un puntatore alla cornice della finestra padre. |
| CDockingManager::GetEnabledAutoHideAlignment | Restituisce l'allineamento abilitato dei riquadri. |
| CDockingManager::GetMiniFrames | Ottiene un elenco di miniframe. |
| CDockingManager::GetOuterEdgeBounds | Ottiene un rettangolo che contiene i bordi esterni della cornice. |
| CDockingManager::GetPaneList | Restituisce un elenco di riquadri che appartengono al gestore di ancoraggio. Sono inclusi tutti i riquadri mobili. |
| CDockingManager::GetSmartDockingManager | Recupera un puntatore al gestore di ancoraggio intelligente. |
| CDockingManager::GetSmartDockingManagerPermanent | Recupera un puntatore al gestore di ancoraggio intelligente. |
| CDockingManager::GetSmartDockingParams | Restituisce i parametri di ancoraggio intelligente per il gestore di ancoraggio. |
| CDockingManager::GetSmartDockingTheme | Metodo statico che restituisce un tema utilizzato per visualizzare indicatori di ancoraggio intelligente. |
| CDockingManager::HideAutoHidePanes | Nasconde un riquadro in modalità di individuazione automatica. |
| CDockingManager::InsertDockSite | Crea un riquadro dock e lo inserisce nell'elenco delle barre di controllo. |
| CDockingManager::InsertPane | Inserisce un riquadro di controllo nell'elenco delle barre di controllo. |
| CDockingManager::IsDockSiteMenu | Specifica se un menu a comparsa viene visualizzato nelle didascalie di tutti i riquadri. |
| CDockingManager::IsInAdjustLayout | Determina se i layout di tutti i riquadri vengono modificati. |
| CDockingManager::IsOLEContainerMode | Specifica se la gestione ancoraggio è in modalità contenitore OLE. |
| CDockingManager::IsPointNearDockSite | Determina se un punto specificato si trova vicino al sito di ancoraggio. |
| CDockingManager::IsPrintPreviewValid | Determina se è impostata la modalità di anteprima di stampa. |
| CDockingManager::LoadState | Carica lo stato del gestore di ancoraggio dal Registro di sistema. |
| CDockingManager::LockUpdate | Blocca la finestra specificata. |
| CDockingManager::OnActivateFrame | Chiamato dal framework quando la finestra cornice viene resa attiva o disattivata. |
| CDockingManager::OnClosePopupMenu | Chiamato dal framework quando un menu a comparsa attivo elabora un messaggio WM_DESTROY. |
| CDockingManager::OnMoveMiniFrame | Chiamato dal framework per spostare una finestra mini-frame. |
| CDockingManager::OnPaneContextMenu | Chiamato dal framework quando compila un menu con un elenco di riquadri. |
| CDockingManager::P aneFromPoint | Restituisce il riquadro che contiene il punto specificato. |
| CDockingManager::P rocessPaneContextMenuCommand | Chiamato dal framework per selezionare o deselezionare una casella di controllo per il comando specificato e ricalcolare il layout di un riquadro visualizzato. |
| CDockingManager::RecalcLayout | Ricalcola il layout interno dei controlli presenti nell'elenco dei controlli. |
| CDockingManager::ReleaseEmptyPaneContainers | Rilascia i contenitori di riquadri vuoti. |
| CDockingManager::RemoveHiddenMDITabbedBar | Rimuove il riquadro della barra nascosta specificato. |
| CDockingManager::RemoveMiniFrame | Rimuove un frame specificato dall'elenco di mini frame. |
| CDockingManager::RemovePaneFromDockManager | Annulla la registrazione di un riquadro e lo rimuove dall'elenco nel gestore di ancoraggio. |
| CDockingManager::ReplacePane | Sostituisce un riquadro con un altro. |
| CDockingManager::ResortMiniFramesForZOrder | Resorts the frame nell'elenco di mini frame. |
| CDockingManager::SaveState | Salva lo stato del gestore di ancoraggio nel Registro di sistema. |
| CDockingManager::SendMessageToMiniFrames | Invia il messaggio specificato a tutti i mini frame. |
| CDockingManager::Serialize | Scrive il gestore di ancoraggio in un archivio. Esegue l'override di CObject::Serialize. |
| CDockingManager::SetAutohideZOrder | Imposta le dimensioni, la larghezza e l'altezza delle barre di controllo e del riquadro specificato. |
| CDockingManager::SetDockingMode | Imposta la modalità di ancoraggio. |
| CDockingManager::SetDockState | Imposta lo stato di ancoraggio delle barre di controllo, dei mini frame e delle barre di espansione automatica. |
| CDockingManager::SetPrintPreviewMode | Imposta la modalità di anteprima di stampa delle barre visualizzate nell'anteprima di stampa. |
| CDockingManager::SetSmartDockingParams | Imposta i parametri che definiscono il comportamento di ancoraggio intelligente. |
| CDockingManager::ShowDelayShowMiniFrames | Mostra o nasconde le finestre dei mini frame. |
| CDockingManager::ShowPanes | Mostra o nasconde i riquadri del controllo e delle barre di visualizzazione automatica. |
| CDockingManager::StartSDocking | Avvia l'ancoraggio intelligente della finestra specificata in base all'allineamento del gestore di ancoraggio intelligente. |
| CDockingManager::StopSDocking | Arresta l'ancoraggio intelligente. |
Membri dei dati
| Nome | Descrizione |
|---|---|
| CDockingManager::m_bHideDockingBarsInContainerMode | Specifica se la gestione ancoraggio nasconde i riquadri in modalità contenitore OLE. |
| CDockingManager::m_dockModeGlobal | Specifica la modalità di ancoraggio globale. |
| CDockingManager::m_nDockSensitivity | Specifica la sensibilità di ancoraggio. |
| CDockingManager::m_nTimeOutBeforeDockingBarDock | Specifica il tempo, espresso in millisecondi, prima che un riquadro di ancoraggio sia ancorato in modalità di ancoraggio immediato. |
| CDockingManager::m_nTimeOutBeforeToolBarDock | Specifica l'ora, espressa in millisecondi, prima che una barra degli strumenti sia ancorata alla finestra cornice principale. |
Osservazioni:
La finestra cornice principale crea e inizializza automaticamente questa classe.
L'oggetto gestione ancoraggio contiene un elenco di tutti i riquadri presenti nel layout di ancoraggio e anche un elenco di tutte le finestre CPaneFrameWnd che appartengono alla finestra cornice principale.
La CDockingManager classe implementa alcuni servizi che è possibile usare per trovare un riquadro o una CPaneFrameWnd finestra. In genere non si chiamano questi servizi direttamente perché vengono sottoposti a wrapping nell'oggetto finestra cornice principale. Per altre informazioni, vedere Classe CPaneFrameWnd.
Suggerimenti per la personalizzazione
I suggerimenti seguenti si applicano agli CDockingManager oggetti:
La classe CDockingManager supporta queste modalità di ancoraggio:
AFX_DOCK_TYPE::DT_IMMEDIATEAFX_DOCK_TYPE::DT_STANDARDAFX_DOCK_TYPE::DT_SMART
Queste modalità di ancoraggio sono definite da CDockingManager::m_dockModeGlobal e vengono impostate chiamando CDockingManager::SetDockingMode.
Se si desidera creare un riquadro non mobile e non ridimensionabile, chiamare il metodo CDockingManager::AddPane . Questo metodo registra il riquadro con il gestore di ancoraggio, responsabile del layout del riquadro.
Esempio
Nell'esempio seguente viene illustrato come utilizzare vari metodi nella CDockingManager classe per configurare un CDockingManager oggetto . L'esempio mostra come visualizzare un pulsante aggiuntivo che apre un menu a comparsa nelle didascalie di tutti i riquadri di ancoraggio e come impostare la modalità di ancoraggio dell'oggetto. Questo frammento di codice fa parte dell'esempio demo di Visual Studio.
CDockingManager *pDockManager = GetDockingManager();
ASSERT_VALID(pDockManager);
pDockManager->AdjustPaneFrames();
pDockManager->EnableDockSiteMenu();
pDockManager->SetDockingMode(DT_STANDARD);
Gerarchia di ereditarietà
Requisiti
Intestazione: afxDockingManager.h
CDockingManager::AddDockSite
Crea un riquadro di ancoraggio e lo aggiunge all'elenco delle barre di controllo.
BOOL AddDockSite(
const AFX_DOCKSITE_INFO& info,
CDockSite** ppDockBar = NULL);
Parametri
info
[in] Riferimento a una struttura di informazioni che contiene l'allineamento del riquadro di ancoraggio.
ppDockBar
[out] Puntatore a un puntatore al nuovo riquadro di ancoraggio.
Valore restituito
TRUE se il riquadro dock è stato creato correttamente; FALSE in caso contrario.
CDockingManager::AddHiddenMDITabbedBar
Aggiunge un handle a un riquadro della barra all'elenco di riquadri a schede MDI nascosti.
void AddHiddenMDITabbedBar(CDockablePane* pBar);
Parametri
pBar
[in] Puntatore a un riquadro barra
CDockingManager::AddPane
Registra un riquadro con il gestore di ancoraggio.
BOOL AddPane(
CBasePane* pWnd,
BOOL bTail = TRUE,
BOOL bAutoHide = FALSE,
BOOL bInsertForOuterEdge = FALSE);
Parametri
pWnd
[in, out] Specifica il riquadro da aggiungere al gestore di ancoraggio.
bTail
[in] TRUE per aggiungere il riquadro alla fine dell'elenco di riquadri per il gestore di ancoraggio; in caso contrario, FALSE.
bAutoHide
[in] Solo per uso interno. Usare sempre il valore predefinito FALSE.
bInsertForOuterEdge
[in] Solo per uso interno. Usare sempre il valore predefinito FALSE.
Valore restituito
TRUE se il riquadro è stato registrato correttamente con il gestore di ancoraggio; in caso contrario, FALSE.
Osservazioni:
Chiamare questo metodo per registrare riquadri non mobili e non ridimensionabili con il gestore di ancoraggio. Se non si registrano i riquadri, questi non verranno visualizzati correttamente quando il gestore di ancoraggio è disposto.
CDockingManager::AdjustDockingLayout
Ricalcola e regola il layout di tutti i riquadri in una finestra cornice.
virtual void AdjustDockingLayout(HDWP hdwp = NULL);
Parametri
hdwp
[in] Specifica la struttura di posizione posticipata della finestra. Per altre informazioni, vedere Tipi di dati Windows.
Osservazioni:
CDockingManager::AddMiniFrame
Aggiunge una cornice all'elenco di mini frame.
virtual BOOL AddMiniFrame(CPaneFrameWnd* pWnd);
Parametri
pWnd
[in] Puntatore a un frame.
Valore restituito
TRUE se il fotogramma non è incluso nell'elenco di mini frame ed è stato aggiunto correttamente; FALSE in caso contrario.
CDockingManager::AdjustPaneFrames
Fa sì che il messaggio WM_NCCALCSIZE venga inviato a tutti i riquadri e CPaneFrameWnd le finestre.
virtual void AdjustPaneFrames();
Osservazioni:
CDockingManager::AdjustRectToClientArea
Regola l'allineamento di un rettangolo.
virtual BOOL AdjustRectToClientArea(
CRect& rectResult,
DWORD dwAlignment);
Parametri
rectResult
[in] Riferimento a un CRect oggetto
dwAlignment
[in] Allineamento dell'oggetto CRect
Valore restituito
TRUE se l'allineamento dell'oggetto CRect è stato regolato; FALSE in caso contrario.
Osservazioni:
Il parametro dwAlignment può avere uno dei valori seguenti:
CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM
CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT
CDockingManager::AlignAutoHidePane
Ridimensiona un riquadro di ancoraggio in modalità autohide in modo da accettare la larghezza completa o l'altezza dell'area client del frame circondata da siti di ancoraggio.
void AlignAutoHidePane(
CPaneDivider* pDefaultSlider,
BOOL bIsVisible = TRUE);
Parametri
pDefaultSlider
[in] Riquadro del dispositivo di scorrimento dell'ancoraggio.
bIsVisible
[in] TRUE se il riquadro di ancoraggio è visibile; FALSE in caso contrario.
CDockingManager::AutoHidePane
Crea una barra degli strumenti per l'individuazione automatica.
CMFCAutoHideToolBar* AutoHidePane(
CDockablePane* pBar,
CMFCAutoHideToolBar* pCurrAutoHideToolBar = NULL);
Parametri
pBar
[in] Puntatore al riquadro della barra.
pCurrAutoHideToolBar
[in] Puntatore a una barra degli strumenti nascondi automaticamente.
Valore restituito
NULL se la barra degli strumenti nascondi automaticamente non è stata creata; in caso contrario, un puntatore alla nuova barra degli strumenti.
CDockingManager::BringBarsToTop
Porta le barre ancorate con l'allineamento specificato all'inizio.
void BringBarsToTop(
DWORD dwAlignment = 0,
BOOL bExcludeDockedBars = TRUE);
Parametri
dwAlignment
[in] Allineamento delle barre di ancoraggio che vengono portate nella parte superiore di altre finestre.
bExcludeDockedBars
[in] TRUE per escludere le barre ancorate dall'essere in cima; in caso contrario FALSE.
CDockingManager::BuildPanesMenu
Aggiunge nomi di riquadri di ancoraggio e barre degli strumenti a un menu.
void BuildPanesMenu(
CMenu& menu,
BOOL bToolbarsOnly);
Parametri
menù
[in] Menu a cui aggiungere i nomi dei riquadri di ancoraggio e delle barre degli strumenti.
bToolbarsOnly
[in] TRUE per aggiungere solo i nomi delle barre degli strumenti al menu; FALSE in caso contrario.
CDockingManager::CalcExpectedDockedRect
Calcola il rettangolo previsto di una finestra ancorata.
void CalcExpectedDockedRect(
CWnd* pWnd,
CPoint ptMouse,
CRect& rectResult,
BOOL& bDrawTab,
CDockablePane** ppTargetBar);
Parametri
pWnd
[in] Puntatore alla finestra da ancorare.
ptMouse
[in] Posizione del mouse.
rectResult
[out] Rettangolo calcolato.
bDrawTab
[in] TRUE per disegnare una scheda; in caso contrario FALSE.
ppTargetBar
[out] Puntatore a un 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.
CDockingManager::Create
Crea un gestore di ancoraggio.
BOOL Create(CFrameWnd* pParentWnd);
Parametri
pParentWnd
[in] Puntatore al frame padre del gestore di ancoraggio. Questo valore non deve essere NULL.
Valore restituito
TRUE sempre.
CDockingManager::D eterminePaneAndStatus
Determina il riquadro che contiene un punto specificato e il relativo stato di ancoraggio.
virtual AFX_CS_STATUS DeterminePaneAndStatus(
CPoint pt,
int nSensitivity,
DWORD dwEnabledAlignment,
CBasePane** ppTargetBar,
const CBasePane* pBarToIgnore,
const CBasePane* pBarToDock);
Parametri
pt
[in] Posizione del riquadro da controllare.
nSensitivity
[in] Valore per aumentare il rettangolo della finestra di ogni riquadro selezionato. Un riquadro soddisfa i criteri di ricerca se il punto specificato si trova in questa area aumentata.
dwEnabledAlignment
[in] Allineamento del riquadro di ancoraggio.
ppTargetBar
[out] Puntatore a un puntatore al riquadro di destinazione.
pBarToIgnore
[in] Riquadro ignorato dal metodo.
pBarToDock
[in] Riquadro ancorato.
Valore restituito
Stato di ancoraggio.
Osservazioni:
Lo stato di ancoraggio può essere uno dei valori seguenti:
| valore AFX_CS_STATUS | significato |
|---|---|
| CS_NOTHING | Il puntatore non si trova su un sito di ancoraggio. Mantenere quindi mobile il riquadro. |
| CS_DOCK_IMMEDIATELY | Il puntatore si trova sul sito di ancoraggio nella modalità immediata (DT_IMMEDIATE stile è abilitato), quindi il riquadro deve essere ancorato immediatamente. |
| CS_DELAY_DOCK | Il puntatore si trova su un sito di ancoraggio che è un altro riquadro di ancoraggio o è un bordo della cornice principale. |
| CS_DELAY_DOCK_TO_TAB | Il puntatore si trova su un sito di ancoraggio che fa sì che il riquadro venga ancorato in una finestra a schede. Ciò si verifica quando il mouse si trova su una didascalia di un altro riquadro di ancoraggio o su un'area di tabulazioni di un riquadro a schede. |
CDockingManager::D isableRestoreDockState
Abilita o disabilita il caricamento del layout di ancoraggio dal Registro di sistema.
void DisableRestoreDockState(BOOL bDisable = TRUE);
Parametri
bDisable
[in] TRUE per disabilitare il caricamento del layout di ancoraggio dal Registro di sistema; in caso contrario, FALSE.
Osservazioni:
Chiamare questo metodo quando è necessario mantenere il layout corrente dei riquadri di ancoraggio e delle barre degli strumenti durante il caricamento dello stato dell'applicazione.
CDockingManager::D ockPane
Ancora un riquadro a un altro riquadro o a una finestra cornice.
void DockPane(
CBasePane* pBar,
UINT nDockBarID = 0,
LPCRECT lpRect = NULL);
Parametri
pBar
[in] Puntatore a un riquadro della barra a cui ancorare.
nDockBarID
[in] ID della barra da ancorare.
lpRect
[in] Rettangolo di destinazione.
CDockingManager::D ockPaneLeftOf
Ancora un riquadro a sinistra di un altro riquadro.
BOOL DockPaneLeftOf(
CPane* pBarToDock,
CPane* pTargetBar);
Parametri
pBarToDock
[in] Puntatore al riquadro da ancorare a sinistra di pTargetBar.
pTargetBar
[in] Puntatore al riquadro di destinazione.
Valore restituito
TRUE se il riquadro è stato ancorato correttamente; in caso contrario, FALSE.
CDockingManager::EnableAutoHidePanes
Abilita l'ancoraggio del riquadro al frame principale, crea un riquadro di ancoraggio e lo aggiunge all'elenco delle barre di controllo.
BOOL EnableAutoHidePanes(DWORD dwStyle);
Parametri
dwStyle
[in] Allineamento dell'ancoraggio.
Valore restituito
TRUE se il riquadro dock è stato creato correttamente; FALSE in caso contrario.
CDockingManager::EnableDocking
Crea un riquadro di ancoraggio e abilita l'ancoraggio del riquadro al frame principale.
BOOL EnableDocking(DWORD dwStyle);
Parametri
dwStyle
[in] Allineamento dell'ancoraggio.
Valore restituito
TRUE se il riquadro dock è stato creato correttamente; FALSE in caso contrario.
CDockingManager::EnableDockSiteMenu
Visualizza un pulsante aggiuntivo che apre un menu a comparsa nelle didascalie di tutti i riquadri di ancoraggio.
static void EnableDockSiteMenu(BOOL bEnable = TRUE);
Parametri
bEnable
[in] TRUE per abilitare il menu del sito di ancoraggio; in caso contrario, FALSE.
Osservazioni:
Il menu del sito di ancoraggio visualizza le opzioni seguenti per modificare lo stato di ancoraggio del riquadro:
Floating- Floats a paneDocking- Ancora un riquadro nel frame principale nella posizione in cui è stato ancorato l'ultimo riquadroAutoHide- Passa il riquadro alla modalità di visualizzazione automaticaHide- Nasconde un riquadro
Per impostazione predefinita, questo menu non viene visualizzato.
CDockingManager::EnablePaneContextMenu
Indica alla libreria di visualizzare un menu di scelta rapida speciale con un elenco di barre degli strumenti dell'applicazione e riquadri di ancoraggio quando l'utente fa clic sul pulsante destro del mouse e la libreria sta elaborando il messaggio WM_CONTEXTMENU.
void EnablePaneContextMenu(
BOOL bEnable,
UINT uiCustomizeCmd,
const CString& strCustomizeText,
BOOL bToolbarsOnly = FALSE);
Parametri
bEnable
[in] Se TRUE, la libreria attiva il supporto per il menu di scelta rapida automatico; se FALSE la libreria disattiva il supporto per il menu di scelta rapida automatico.
uiCustomizeCmd
[in] ID comando per la voce Personalizza nel menu.
strCustomizeText
[in] Testo dell'elemento Personalizza .
bToolbarsOnly
[in] Se TRUE, il menu visualizza solo un elenco di barre degli strumenti dell'applicazione; se FALSE, la libreria aggiunge riquadri di ancoraggio dell'applicazione a questo elenco.
CDockingManager::FindDockSite
Recupera il riquadro della barra in corrispondenza della posizione specificata e con l'allineamento specificato.
virtual CDockSite* FindDockSite(
DWORD dwAlignment,
BOOL bOuter);
Parametri
dwAlignment
[in] Allineamento del riquadro della barra.
bOuter
[in] Se TRUE, recuperare la barra nella posizione della testa nell'elenco delle barre di controllo. In caso contrario, recuperare la barra nella posizione finale nell'elenco delle barre di controllo.
Valore restituito
Riquadro di ancoraggio con l'allineamento specificato; NULL in caso contrario.
CDockingManager::FindPaneByID
Trova un riquadro in base all'ID di controllo specificato.
virtual CBasePane* FindPaneByID(
UINT uBarID,
BOOL bSearchMiniFrames = FALSE);
Parametri
uBarID
[in] Specifica l'ID del controllo del riquadro da trovare.
bSearchMiniFrames
[in] TRUE per includere tutti i riquadri mobili nella ricerca. FALSE per includere solo i riquadri ancorati.
Valore restituito
Oggetto CBasePane con l'ID di controllo specificato o NULL se non è possibile trovare il riquadro specificato.
Osservazioni:
CDockingManager::FindDockSiteByPane
Restituisce il riquadro della barra con l'ID del riquadro della barra di destinazione.
virtual CDockSite* FindDockSiteByPane(CPane* pTargetBar);
Parametri
pTargetBar
[in] Puntatore al riquadro della barra di destinazione.
Valore restituito
Riquadro della barra con ID del riquadro della barra di destinazione; NULL se non esiste un riquadro della barra di questo tipo.
CDockingManager::FixupVirtualRects
Esegue il commit di tutte le posizioni correnti della barra degli strumenti in rettangoli virtuali.
virtual void FixupVirtualRects();
Osservazioni:
Quando l'utente inizia a trascinare una barra degli strumenti, l'applicazione memorizza la posizione originale nel rettangolo virtuale. Quando l'utente sposta una barra degli strumenti attraverso il relativo sito di ancoraggio, la barra degli strumenti può spostare altre barre degli strumenti. Le posizioni originali delle altre barre degli strumenti vengono archiviate nei rettangoli virtuali corrispondenti.
CDockingManager::FrameFromPoint
Restituisce il frame che contiene il punto specificato.
virtual CPaneFrameWnd* FrameFromPoint(
CPoint pt,
CPaneFrameWnd* pFrameToExclude,
BOOL bFloatMultiOnly) const;
Parametri
pt
[in] Specifica il punto, nelle coordinate dello schermo, da controllare.
pFrameToExclude
[in] Puntatore a un frame da escludere.
bFloatMultiOnly
[in] TRUE per escludere fotogrammi che non sono istanze di CMultiPaneFrameWnd; FALSE in caso contrario.
Valore restituito
Frame che contiene il punto specificato; NULL in caso contrario.
CDockingManager::GetClientAreaBounds
Ottiene il rettangolo che contiene i limiti dell'area client.
CRect GetClientAreaBounds() const;
void GetClientAreaBounds(CRect& rcClient);
Parametri
rcClient
[out] Riferimento al rettangolo che contiene i limiti dell'area client.
Valore restituito
Rettangolo che contiene i limiti dell'area client.
CDockingManager::GetDockingMode
Restituisce la modalità di ancoraggio corrente.
static AFX_DOCK_TYPE GetDockingMode();
Valore restituito
Valore dell'enumeratore che rappresenta la modalità di ancoraggio corrente. Può essere uno dei valori seguenti:
DT_STANDARD
DT_IMMEDIATE
DT_SMART
Osservazioni:
Per impostare la modalità di ancoraggio, chiama CDockingManager::SetDockingMode.
CDockingManager::GetDockSiteFrameWnd
Ottiene un puntatore alla cornice della finestra padre.
CFrameWnd* GetDockSiteFrameWnd() const;
Valore restituito
Puntatore alla cornice della finestra padre.
CDockingManager::GetEnabledAutoHideAlignment
Restituisce l'allineamento abilitato dei riquadri.
DWORD GetEnabledAutoHideAlignment() const;
Valore restituito
Combinazione bit per bit di flag CBRS_ALIGN_ o 0 se i riquadri di ide automatico non sono abilitati. Per altre informazioni, vedere CFrameWnd::EnableDocking.
Osservazioni:
Il metodo restituisce l'allineamento abilitato per le barre di controllo dell'ambiente automatico. Per abilitare le barre dell'ambiente automatico, chiamare CFrameWndEx::EnableAutoHidePanes.
CDockingManager::GetMiniFrames
Ottiene un elenco di miniframe.
const CObList& GetMiniFrames() const;
Valore restituito
Elenco di miniframe che contengono le barre di controllo che appartengono al gestore di ancoraggio.
CDockingManager::GetOuterEdgeBounds
Ottiene un rettangolo che contiene i bordi esterni della cornice.
CRect GetOuterEdgeBounds() const;
Valore restituito
Rettangolo che contiene i bordi esterni della cornice.
CDockingManager::GetPaneList
Restituisce un elenco di riquadri che appartengono al gestore di ancoraggio. Sono inclusi tutti i riquadri mobili.
void GetPaneList(
CObList& lstBars,
BOOL bIncludeAutohide = FALSE,
CRuntimeClass* pRTCFilter = NULL,
BOOL bIncludeTabs = FALSE);
Parametri
lstBars
[in, out] Contiene tutti i riquadri del gestore di ancoraggio corrente.
bIncludeAutohide
[in] TRUE per includere i riquadri in modalità autohide; in caso contrario, FALSE.
pRTCFilter
[in] Se non NULL, l'elenco restituito contiene riquadri solo della classe di runtime specificata.
bIncludeTabs
[in] TRUE per includere le schede; in caso contrario, FALSE.
Osservazioni:
Se sono presenti riquadri a schede nella gestione ancoraggio, il metodo restituisce puntatori agli oggetti Classe CBaseTabbedPane ed è necessario enumerare le schede in modo esplicito.
Usare pRTCFilter per ottenere una determinata classe di riquadri. Ad esempio, è possibile ottenere solo le barre degli strumenti impostando questo valore in modo appropriato.
CDockingManager::GetSmartDockingManager
Recupera un puntatore al gestore di ancoraggio intelligente.
CSmartDockingManager* GetSmartDockingManager();
Valore restituito
Puntatore al gestore di ancoraggio intelligente.
CDockingManager::GetSmartDockingManagerPermanent
Recupera un puntatore al gestore di ancoraggio intelligente.
CSmartDockingManager* GetSmartDockingManagerPermanent() const;
Valore restituito
Puntatore al gestore di ancoraggio intelligente.
CDockingManager::GetSmartDockingParams
Restituisce i parametri di ancoraggio intelligente per il gestore di ancoraggio.
static CSmartDockingInfo& GetSmartDockingParams();
Valore restituito
Classe che contiene i parametri di ancoraggio intelligente per il gestore di ancoraggio corrente. Per altre informazioni, vedere Classe CSmartDockingInfo.
Osservazioni:
CDockingManager::HideAutoHidePanes
Nasconde un riquadro in modalità di individuazione automatica.
void HideAutoHidePanes(
CDockablePane* pBarToExclude = NULL,
BOOL bImmediately = FALSE);
Parametri
pBarToExclude
[in] Puntatore a una barra da escludere dall'nascondere.
bImmediately
[in] TRUE per nascondere immediatamente il riquadro; FALSE per nascondere il riquadro con l'effetto autohide.
CDockingManager::InsertDockSite
Crea un riquadro dock e lo inserisce nell'elenco delle barre di controllo.
BOOL InsertDockSite(
const AFX_DOCKSITE_INFO& info,
DWORD dwAlignToInsertAfter,
CDockSite** ppDockBar = NULL);
Parametri
info
[in] Struttura che contiene le informazioni di allineamento sul riquadro di ancoraggio.
dwAlignToInsertAfter
[in] Allineamento del riquadro di ancoraggio.
ppDockBar
[out] Puntatore a un puntatore a un riquadro di ancoraggio.
Valore restituito
TRUE se il riquadro dock è stato creato correttamente; FALSE in caso contrario.
CDockingManager::InsertPane
Inserisce un riquadro di controllo nell'elenco delle barre di controllo.
BOOL InsertPane(
CBasePane* pControlBar,
CBasePane* pTarget,
BOOL bAfter = TRUE);
Parametri
pControlBar
[in] Puntatore a un riquadro di controllo.
pTarget
[in] Puntatore a un riquadro di destinazione.
bAfter
[in] TRUE per inserire il riquadro dopo la posizione del riquadro di destinazione; FALSE in caso contrario.
Valore restituito
TRUE se il riquadro di controllo viene aggiunto correttamente all'elenco delle barre di controllo; FALSE in caso contrario.
Osservazioni:
Questo metodo restituisce false se il riquadro di controllo è già presente nell'elenco delle barre di controllo o se il riquadro di destinazione non esiste nell'elenco delle barre di controllo.
CDockingManager::IsDockSiteMenu
Specifica se un menu a comparsa viene visualizzato nelle didascalie di tutti i riquadri.
static BOOL IsDockSiteMenu();
Valore restituito
TRUE se un menu del sito dock viene visualizzato nelle didascalie di tutti i riquadri di ancoraggio; in caso contrario FALSE.
Osservazioni:
È possibile abilitare il menu del sito dock chiamando CDockingManager::EnableDockSiteMenu.
CDockingManager::IsInAdjustLayout
Determina se i layout di tutti i riquadri vengono modificati.
BOOL IsInAdjustLayout() const;
Valore restituito
TRUE se i layout di tutti i riquadri vengono modificati; FALSE in caso contrario.
CDockingManager::IsOLEContainerMode
Specifica se la gestione ancoraggio è in modalità contenitore OLE.
BOOL IsOLEContainerMode() const;
Valore restituito
TRUE se il gestore di ancoraggio è in modalità contenitore OLE; in caso contrario, FALSE.
Osservazioni:
In modalità contenitore OLE tutti i riquadri di ancoraggio e le barre degli strumenti dell'applicazione sono nascosti. I riquadri sono nascosti anche in questa modalità se è stato impostato CDockingManager::m_bHideDockingBarsInContainerMode su TRUE.
CDockingManager::IsPointNearDockSite
Determina se un punto specificato si trova vicino al sito di ancoraggio.
BOOL IsPointNearDockSite(
CPoint point,
DWORD& dwBarAlignment,
BOOL& bOuterEdge) const;
Parametri
point
[in] Punto specificato.
dwBarAlignment
[out] Specifica il bordo vicino al punto. I valori possibili sono CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP e CBRS_ALIGN_BOTTOM.
bOuterEdge
[out] TRUE se il punto si trova vicino al bordo esterno del sito di ancoraggio; FALSE in caso contrario.
Valore restituito
TRUE se il punto si trova vicino al sito di ancoraggio; in caso contrario FALSE.
CDockingManager::IsPrintPreviewValid
Determina se è impostata la modalità di anteprima di stampa.
BOOL IsPrintPreviewValid() const;
Valore restituito
TRUE se la modalità di anteprima di stampa è impostata; FALSE in caso contrario.
CDockingManager::LoadState
Carica lo stato del gestore di ancoraggio dal Registro di sistema.
virtual BOOL LoadState(
LPCTSTR lpszProfileName = NULL,
UINT uiID = (UINT) -1);
Parametri
lpszProfileName
[in] Nome profilo.
uiID
[in] ID del gestore di ancoraggio.
Valore restituito
TRUE se lo stato del gestore di ancoraggio è stato caricato correttamente; in caso contrario FALSE.
CDockingManager::LockUpdate
Blocca la finestra specificata.
void LockUpdate(BOOL bLock);
Parametri
blocco
[in] TRUE se la finestra è bloccata; FALSE in caso contrario.
Osservazioni:
Quando una finestra è bloccata, non può essere spostata e non può essere ridisegnata.
CDockingManager::m_bHideDockingBarsInContainerMode
Specifica se la gestione ancoraggio nasconde i riquadri in modalità contenitore OLE.
AFX_IMPORT_DATA static BOOL m_bHideDockingBarsInContainerMode;
Osservazioni:
Impostare questo valore su FALSE se si desidera mantenere tutti i riquadri ancorati al frame principale visibile quando l'applicazione è in modalità contenitore OLE. Per impostazione predefinita, questo valore è TRUE.
CDockingManager::m_dockModeGlobal
Specifica la modalità di ancoraggio globale.
AFX_IMPORT_DATA static AFX_DOCK_TYPE m_dockModeGlobal;
Osservazioni:
Per impostazione predefinita, ogni riquadro di ancoraggio usa questa modalità di ancoraggio. Per altre informazioni sui valori su cui questo campo può essere impostato, vedere CBasePane::GetDockingMode.
CDockingManager::m_nDockSensitivity
Specifica la sensibilità di ancoraggio.
AFX_IMPORT_DATA static int m_nDockSensitivity;
Osservazioni:
La sensibilità di ancoraggio definisce la modalità di avvicinamento di un riquadro mobile a un riquadro di ancoraggio, un sito di ancoraggio o un altro riquadro prima che il framework cambi lo stato in modo che sia ancorato.
CDockingManager::m_nTimeOutBeforeDockingBarDock
Specifica il tempo, espresso in millisecondi, prima che un riquadro di ancoraggio sia ancorato in modalità di ancoraggio immediato.
static UINT m_nTimeOutBeforeDockingBarDock;
Osservazioni:
Prima che un riquadro sia ancorato, il framework attende il periodo di tempo specificato. Ciò impedisce che il riquadro venga accidentalmente ancorato a una posizione mentre l'utente sta ancora trascinandolo.
CDockingManager::m_nTimeOutBeforeToolBarDock
Specifica l'ora, espressa in millisecondi, prima che una barra degli strumenti sia ancorata alla finestra cornice principale.
static UINT m_nTimeOutBeforeToolBarDock;
Osservazioni:
Prima che una barra degli strumenti sia ancorata, il framework attende il periodo di tempo specificato. Ciò impedisce che la barra degli strumenti venga accidentalmente ancorata a una posizione mentre l'utente sta ancora trascinandolo.
CDockingManager::OnActivateFrame
Chiamato dal framework quando la finestra cornice viene resa attiva o disattivata.
virtual void OnActivateFrame(BOOL bActivate);
Parametri
bActivate
[in] Se TRUE, la finestra cornice viene resa attiva; se FALSE, la finestra cornice viene disattivata.
CDockingManager::OnClosePopupMenu
Chiamato dal framework quando un menu a comparsa attivo elabora un messaggio WM_DESTROY.
void OnClosePopupMenu();
Osservazioni:
Il framework invia un messaggio di WM_DESTROY quando sta per chiudere la finestra principale corrente. Eseguire l'override di questo metodo per gestire le notifiche da CMFCPopupMenu oggetti appartenenti alla finestra cornice quando un CMFCPopupMenu oggetto elabora un messaggio di WM_DESTROY.
CDockingManager::OnMoveMiniFrame
Chiamato dal framework per spostare una finestra mini-frame.
virtual BOOL OnMoveMiniFrame(CWnd* pFrame);
Parametri
pFrame
[in] Puntatore a una finestra con mini frame.
Valore restituito
TRUE se il metodo ha esito positivo; in caso contrario FALSE.
CDockingManager::OnPaneContextMenu
Chiamato dal framework quando compila un menu con un elenco di riquadri.
void OnPaneContextMenu(CPoint point);
Parametri
point
[in] Specifica la posizione del menu.
CDockingManager::P aneFromPoint
Restituisce il riquadro che contiene il punto specificato.
virtual CBasePane* PaneFromPoint(
CPoint point,
int nSensitivity,
bool bExactBar = false,
CRuntimeClass* pRTCBarType = NULL,
BOOL bCheckVisibility = FALSE,
const CBasePane* pBarToIgnore = NULL) const;
virtual CBasePane* PaneFromPoint(
CPoint point,
int nSensitivity,
DWORD& dwAlignment,
CRuntimeClass* pRTCBarType = NULL,
const CBasePane* pBarToIgnore = NULL) const;
Parametri
point
[in] Specifica il punto, nelle coordinate dello schermo, da controllare.
nSensitivity
[in] Valore per gonfiare il rettangolo della finestra di ogni riquadro selezionato. Un riquadro soddisfa i criteri di ricerca se il punto specificato si trova in questa area gonfiata.
bExactBar
[in] TRUE per ignorare il parametro nSensitivity ; in caso contrario, FALSE.
pRTCBarType
[in] Se non è NULL, il metodo cerca solo i riquadri del tipo specificato.
bCheckVisibility
[in] TRUE per controllare solo i riquadri visibili; in caso contrario, FALSE.
dwAlignment
[out] Se viene trovato un riquadro nel punto specificato, questo parametro contiene il lato del riquadro più vicino al punto specificato. Per altre informazioni, vedere la sezione Osservazioni.
pBarToIgnore
[in] Se non è NULL, il metodo ignora i riquadri specificati da questo parametro.
Valore restituito
Oggetto derivato da CBasePane che contiene il punto specificato o NULL se non è stato trovato alcun riquadro.
Osservazioni:
Quando la funzione restituisce e viene trovato un riquadro, dwAlignment contiene l'allineamento del punto specificato. Ad esempio, se il punto è più vicino alla parte superiore del riquadro, dwAlignment è impostato su CBRS_ALIGN_TOP.
CDockingManager::P rocessPaneContextMenuCommand
Chiamato dal framework per selezionare o deselezionare una casella di controllo per il comando specificato e ricalcolare il layout di un riquadro visualizzato.
BOOL ProcessPaneContextMenuCommand(
UINT nID,
int nCode,
void* pExtra,
AFX_CMDHANDLERINFO* pHandlerInfo);
Parametri
nID
[in] ID di una barra di controllo nel menu.
nCode
[in] Codice di notifica del comando.
pExtra
[in] Puntatore a void di cui viene eseguito il cast a un puntatore a CCmdUI se nCode è CN_UPDATE_COMMAND_UI.
pHandlerInfo
[in] Puntatore a una struttura di informazioni. Questo parametro non viene usato.
Valore restituito
TRUE se pEXtra non è NULL e nCode è uguale a CN_UPDATE_COMMAND_UI o se è presente una barra di controllo con l'nID specificato.
CDockingManager::RecalcLayout
Ricalcola il layout interno dei controlli presenti nell'elenco dei controlli.
virtual void RecalcLayout(BOOL bNotify = TRUE);
Parametri
bNotify
[in] Questo parametro non viene usato.
CDockingManager::ReleaseEmptyPaneContainers
Rilascia i contenitori di riquadri vuoti.
void ReleaseEmptyPaneContainers();
CDockingManager::RemoveHiddenMDITabbedBar
Rimuove il riquadro della barra nascosta specificato.
void RemoveHiddenMDITabbedBar(CDockablePane* pBar);
Parametri
pBar
[in] Puntatore a un riquadro della barra da rimuovere.
CDockingManager::RemoveMiniFrame
Rimuove un frame specificato dall'elenco di mini frame.
virtual BOOL RemoveMiniFrame(CPaneFrameWnd* pWnd);
Parametri
pWnd
[in] Puntatore a un frame da rimuovere.
Valore restituito
TRUE se il frame specificato viene rimosso; FALSE in caso contrario.
CDockingManager::RemovePaneFromDockManager
Annulla la registrazione di un riquadro e lo rimuove dall'elenco nel gestore di ancoraggio.
void RemovePaneFromDockManager(
CBasePane* pWnd,
BOOL bDestroy,
BOOL bAdjustLayout,
BOOL bAutoHide = FALSE,
CBasePane* pBarReplacement = NULL);
Parametri
pWnd
[in] Puntatore a un riquadro da rimuovere.
bDestroy
[in] Se TRUE, il riquadro rimosso viene eliminato definitivamente.
bAdjustLayout
[in] Se TRUE, regolare immediatamente il layout di ancoraggio.
bAutoHide
[in] Se TRUE, il riquadro viene rimosso dall'elenco delle barre di individuazione automatica. Se FALSE, il riquadro viene rimosso dall'elenco dei riquadri normali.
pBarReplacement
[in] Puntatore a un riquadro che sostituisce il riquadro rimosso.
CDockingManager::ReplacePane
Sostituisce un riquadro con un altro.
BOOL ReplacePane(
CDockablePane* pOriginalBar,
CDockablePane* pNewBar);
Parametri
pOriginalBar
[in] Puntatore al riquadro originale.
pNewBar
[in] Puntatore al riquadro che sostituisce il riquadro originale.
Valore restituito
TRUE se il riquadro viene sostituito correttamente; FALSE in caso contrario.
CDockingManager::ResortMiniFramesForZOrder
Resorts the frame nell'elenco di mini frame.
void ResortMiniFramesForZOrder();
CDockingManager::SaveState
Salva lo stato del gestore di ancoraggio nel Registro di sistema.
virtual BOOL SaveState(
LPCTSTR lpszProfileName = NULL,
UINT uiID = (UINT) -1);
Parametri
lpszProfileName
[in] Percorso di una chiave del Registro di sistema.
uiID
[in] ID del gestore di ancoraggio.
Valore restituito
TRUE se lo stato è stato salvato correttamente; in caso contrario FALSE.
Osservazioni:
Il salvataggio dello stato del gestore di ancoraggio nel Registro di sistema comporta il salvataggio degli stati delle barre di controllo, gli stati delle barre di espansione automatica e gli stati dei mini frame presenti nel gestore di ancoraggio.
CDockingManager::SendMessageToMiniFrames
Invia il messaggio specificato a tutti i mini frame.
BOOL SendMessageToMiniFrames(
UINT uMessage,
WPARAM wParam = 0,
LPARAM lParam = 0);
Parametri
uMessage
[in] Messaggio da inviare.
wParam
[in] Informazioni aggiuntive dipendenti dal messaggio.
lParam
[in] Informazioni aggiuntive dipendenti dal messaggio.
Valore restituito
TRUE sempre.
CDockingManager::Serialize
Scrive il gestore di ancoraggio in un archivio.
void Serialize(CArchive& ar);
Parametri
Ar
[in] Riferimento a un oggetto archivio.
Osservazioni:
La scrittura del gestore di ancoraggio in un archivio comporta la determinazione del numero di barre di controllo di ancoraggio e dispositivi di scorrimento e la scrittura delle barre di controllo, dei mini frame, delle barre dell'ide automatico e delle barre a schede MDI nell'archivio.
CDockingManager::SetAutohideZOrder
Imposta le dimensioni, la larghezza e l'altezza delle barre di controllo e del riquadro specificato.
void SetAutohideZOrder(CDockablePane* pAHDockingBar);
Parametri
pAHDockingBar
[in] Puntatore a un riquadro ancorabile.
CDockingManager::SetDockingMode
Imposta la modalità di ancoraggio.
static void SetDockingMode(
AFX_DOCK_TYPE dockMode,
AFX_SMARTDOCK_THEME theme = AFX_SDT_DEFAULT);
Parametri
dockMode
Specifica la nuova modalità di ancoraggio. Per altre informazioni, vedere la sezione Osservazioni.
tema
Specifica il tema da utilizzare per i marcatori di ancoraggio intelligente. Può essere uno dei valori enumerati seguenti: AFX_SDT_DEFAULT, AFX_SDT_VS2005 AFX_SDT_VS2008.
Osservazioni:
Chiamare questo metodo statico per impostare la modalità di ancoraggio.
dockMode può essere uno dei valori seguenti:
DT_STANDARD : modalità di ancoraggio Standard implementata in Visual Studio .NET 2003. I riquadri vengono trascinati senza un contesto di trascinamento.
DT_IMMEDIATE : modalità di ancoraggio immediato implementata in Microsoft Visio. I riquadri vengono trascinati con un contesto di trascinamento, ma non vengono visualizzati marcatori.
DT_SMART : modalità di ancoraggio intelligente implementata in Visual Studio 2005. I riquadri vengono trascinati con un contesto di trascinamento e vengono visualizzati indicatori intelligenti che mostrano dove è possibile ancorare il riquadro.
CDockingManager::SetDockState
Imposta lo stato di ancoraggio delle barre di controllo, dei mini frame e delle barre di espansione automatica.
virtual void SetDockState();
CDockingManager::SetPrintPreviewMode
Imposta la modalità di anteprima di stampa delle barre visualizzate nell'anteprima di stampa.
void SetPrintPreviewMode(
BOOL bPreview,
CPrintPreviewState* pState);
Parametri
bPreview
[in] TRUE se è impostata la modalità anteprima di stampa; FALSE in caso contrario.
pState
[in] Puntatore a uno stato di anteprima. Questo parametro non viene usato.
CDockingManager::SetSmartDockingParams
Imposta i parametri che definiscono il comportamento di ancoraggio intelligente.
static void SetSmartDockingParams(CSmartDockingInfo& params);
Parametri
params
[in, out] Definisce i parametri per l'ancoraggio intelligente.
Osservazioni:
Chiama questo metodo se vuoi personalizzare l'aspetto, il colore o la forma dei marcatori di ancoraggio intelligente.
Per usare la ricerca predefinita dei marcatori di ancoraggio intelligente, passare un'istanza non inizializzata della classe CSmartDockingInfo ai parametri.
CDockingManager::ShowDelayShowMiniFrames
Mostra o nasconde le finestre dei mini frame.
void ShowDelayShowMiniFrames(BOOL bshow);
Parametri
bShow
[in] TRUE per rendere attiva la finestra del frame visualizzato; FALSE per nascondere la finestra del frame.
CDockingManager::ShowPanes
Mostra o nasconde i riquadri del controllo e delle barre di visualizzazione automatica.
virtual BOOL ShowPanes(BOOL bShow);
Parametri
bShow
[in] TRUE per mostrare i riquadri; FALSE per nascondere i riquadri.
Valore restituito
Sempre FALSE.
CDockingManager::StartSDocking
Avvia l'ancoraggio intelligente della finestra specificata in base all'allineamento del gestore di ancoraggio intelligente.
void StartSDocking(CWnd* pDockingWnd);
Parametri
pDockingWnd
[in] Puntatore a una finestra da ancorare.
CDockingManager::StopSDocking
Arresta l'ancoraggio intelligente.
void StopSDocking();
CDockingManager::GetSmartDockingTheme
Metodo statico che restituisce un tema utilizzato per visualizzare indicatori di ancoraggio intelligente.
static AFX_SMARTDOCK_THEME __stdcall GetSmartDockingTheme();
Valore restituito
Restituisce uno dei valori enumerati seguenti: AFX_SDT_DEFAULT, AFX_SDT_VS2005 AFX_SDT_VS2008.
Osservazioni:
Vedi anche
Grafico della gerarchia
Classi
Classe CObject
Classe CFrameWndEx
Classe CDockablePane
Classe CPaneFrameWnd