Classe CDockingManager

Articolo
06/10/2015

Implementa la funzionalità principale che controlla che ancorano il layout in una finestra cornice principale.

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 di un riquadro della barra all'elenco dei riquadri nascosti della barra MDI a schede.
CDockingManager::AddMiniFrame	Aggiunge un frame all'elenco di mini frame.
CDockingManager::AddPane	Registra un riquadro con l'amministratore di ancoraggio.
CDockingManager::AdjustDockingLayout	Ricalcola e modificare il layout dei riquadri in una finestra cornice.
CDockingManager::AdjustPaneFrames	Nel messaggio WM_NCCALCSIZE venga inviato ai riquadri e finestre CPaneFrameWnd.
CDockingManager::AdjustRectToClientArea	Regola l'allineamento di un rettangolo.
CDockingManager::AlignAutoHidePane	Ridimensiona un riquadro ancorato in modalità nascondi automaticamente in modo che accetta la larghezza intera o l'altezza dell'area client del frame racchiusa da siti di ancoraggio.
CDockingManager::AutoHidePane	Crea una barra degli strumenti di nascondi automaticamente.
CDockingManager::BringBarsToTop	Porta barre ancorate con l'allineamento specificato all'inizio.
CDockingManager::BuildPanesMenu	Aggiunge i nomi dei riquadri ancorati le barre degli strumenti a un menu.
CDockingManager::CalcExpectedDockedRect	Calcola il rettangolo previsto di una finestra ancorata.
CDockingManager::Create	Crea un amministratore di ancoraggio.
CDockingManager::DeterminePaneAndStatus	Determina il riquadro contenente un punto specificato e lo stato di ancoraggio.
CDockingManager::DisableRestoreDockState	Abilita o disabilita il caricamento di layout di ancoraggio dal Registro di sistema.
CDockingManager::DockPane	Un riquadro a un altro riquadro o una finestra cornice.
CDockingManager::DockPaneLeftOf	Nuovamente il riquadro a sinistra di un altro riquadro.
CDockingManager::EnableAutoHidePanes	Consente l'ancoraggio del riquadro della cornice principale, crea un riquadro di ancoraggio e lo aggiunge all'elenco delle barre di controllo.
CDockingManager::EnableDocking	Crea un riquadro di ancoraggio e consente l'ancoraggio del riquadro della cornice principale.
CDockingManager::EnableDockSiteMenu	Visualizzare un pulsante aggiuntivo che apre un menu di scelta rapida sulle didascalie dei riquadri ancorati.
CDockingManager::EnablePaneContextMenu	Indica la raccolta di visualizzare un menu di scelta rapida speciale di un elenco delle barre degli strumenti e dei riquadri ancorati di applicazione quando l'utente sceglie il pulsante destro del mouse sulla raccolta viene elaborato il messaggio di WM_CONTEXTMENU.
CDockingManager::FindDockSite	Recupera il riquadro della barra che si trova nella posizione specificata e con l'allineamento specificato.
CDockingManager::FindDockSiteByPane	Restituisce il riquadro della barra con l'id del riquadro della barra.
CDockingManager::FindPaneByID	Cerca un riquadro dall'ID del controllo
CDockingManager::FixupVirtualRects	Esegue il commit di tutte le attuali posizioni delle barre degli strumenti ai rettangoli virtuali.
CDockingManager::FrameFromPoint	Restituisce il frame contenente il punto specificato.
CDockingManager::GetClientAreaBounds	Ottiene il rettangolo contenente i limiti dell'area client.
CDockingManager::GetDockingMode	Restituisce la modalità corrente di ancoraggio.
CDockingManager::GetDockSiteFrameWnd	Ottiene un puntatore a frame della finestra padre.
CDockingManager::GetEnabledAutoHideAlignment	Restituisce il valore di allineamento con i riquadri.
CDockingManager::GetMiniFrames	Ottiene un elenco di miniframes.
CDockingManager::GetOuterEdgeBounds	Ottiene un rettangolo contenente i bordi esterni del frame.
CDockingManager::GetPaneList	Restituisce un elenco dei riquadri che appartengono all'amministratore di ancoraggio. Include tutti i riquadri mobili.
CDockingManager::GetSmartDockingManager	Recupera un puntatore all'amministratore intelligente di ancoraggio.
CDockingManager::GetSmartDockingManagerPermanent	Recupera un puntatore all'amministratore intelligente di ancoraggio.
CDockingManager::GetSmartDockingParams	Restituisce i parametri intelligenti di ancoraggio per l'amministratore di ancoraggio.
CDockingManager::GetSmartDockingTheme	Un metodo statico che restituisce un tema utilizzato per visualizzare marcatori intelligenti di ancoraggio.
CDockingManager::HideAutoHidePanes	Nasconde il riquadro in modalità di nascondi automaticamente.
CDockingManager::InsertDockSite	Crea un riquadro di ancoraggio e lo inserisce nell'elenco delle barre di controllo.
CDockingManager::InsertPane	Inserisce un riquadro controllo nell'elenco delle barre di controllo.
CDockingManager::IsDockSiteMenu	Specifica se un menu di scelta rapida visualizza le didascalie dei riquadri.
CDockingManager::IsInAdjustLayout	Determina se i layout dei riquadri vengono modificati.
CDockingManager::IsOLEContainerMode	Specifica se l'amministratore di ancoraggio è in modalità del contenitore OLE.
CDockingManager::IsPointNearDockSite	Determina se un punto specificato è vicino al sito di ancoraggio.
CDockingManager::IsPrintPreviewValid	Determina se la modalità anteprima di stampa è impostata su.
CDockingManager::LoadState	Carica lo stato dell'amministratore di ancoraggio dal Registro di sistema.
CDockingManager::LockUpdate	Blocca la finestra specificata.
CDockingManager::OnActivateFrame	Chiamato dal framework quando la finestra cornice viene impostata su attivo o è disattivata.
CDockingManager::OnClosePopupMenu	Chiamato dal framework quando un menu di scelta rapida attivo elabora un messaggio di WM_DESTROY.
CDockingManager::OnMoveMiniFrame	Chiamato dal framework per spostare una finestra cornice piccola.
CDockingManager::OnPaneContextMenu	Chiamato dal framework quando si compila un menu con un elenco dei riquadri.
CDockingManager::PaneFromPoint	Restituisce il riquadro contenente il punto specificato.
CDockingManager::ProcessPaneContextMenuCommand	Chiamato dal framework per selezionare o deselezionare una casella di controllo per il comando specificato e per ricalcolare il layout di riquadro indicato.
CDockingManager::RecalcLayout	Ricalcola il layout interno dei controlli presenti nell'elenco dei controlli.
CDockingManager::ReleaseEmptyPaneContainers	Rilascia i contenitori vuoti il riquadro.
CDockingManager::RemoveHiddenMDITabbedBar	Rimuove il riquadro nascosto specificato della barra.
CDockingManager::RemoveMiniFrame	Consente di rimuovere un frame specificato dall'elenco di mini frame.
CDockingManager::RemovePaneFromDockManager	Annulla la registrazione di un riquadro e lo rimuove dall'amministratore di ancoraggio.
CDockingManager::ReplacePane	Sostituisce un riquadro con un altro.
CDockingManager::ResortMiniFramesForZOrder	Ricorre i frame nell'elenco di mini frame.
CDockingManager::SaveState	Salvare lo stato dell'amministratore di ancoraggio al Registro di sistema.
CDockingManager::SendMessageToMiniFrames	Invia il messaggio specificato a tutti i mini frame.
CDockingManager::Serialize	Scrive l'amministratore di ancoraggio a un archivio. (Override CObject::Serialize).
CDockingManager::SetAutohideZOrder	Imposta la dimensione, la larghezza e l'altezza delle barre di controllo e riquadro specificato.
CDockingManager::SetDockingMode	Imposta la modalità di ancoraggio.
CDockingManager::SetDockState	Imposta lo stato di ancoraggio delle barre di controllo, in mini frame e le barre di nascondi automaticamente.
CDockingManager::SetPrintPreviewMode	Imposta la modalità anteprima di stampa delle barre di visualizzare in anteprima di stampa.
CDockingManager::SetSmartDockingParams	Imposta i parametri che definiscono il comportamento di ancoraggio intelligente.
CDockingManager::ShowDelayShowMiniFrames	Mostra o nasconde le finestre di mini frame.
CDockingManager::ShowPanes	Consente di visualizzare o nascondere i riquadri delle barre di nascondi automaticamente e del controllo.
CDockingManager::StartSDocking	Avvia l'ancoraggio smart della finestra specificata come l'allineamento di amministratore intelligente di ancoraggio.
CDockingManager::StopSDocking	Interrompe l'ancoraggio intelligente.

Membri di dati

Nome	Descrizione
CDockingManager::m_bHideDockingBarsInContainerMode	Specifica se l'amministratore di ancoraggio nascondere i riquadri in modalità contenitore OLE.
CDockingManager::m_dockModeGlobal	Specifica la modalità globale di ancoraggio.
CDockingManager::m_nDockSensitivity	Specifica la sensibilità di ancoraggio.
CDockingManager::m_nTimeOutBeforeDockingBarDock	Specifica il tempo, in millisecondi, prima che un riquadro ancorato sia ancorato in modalità immediata di ancoraggio.
CDockingManager::m_nTimeOutBeforeToolBarDock	Specifica il tempo, in millisecondi, prima di una barra degli strumenti è ancorata alla finestra cornice principale.

Note

La finestra cornice principale crea e inizializza la classe automaticamente.

L'oggetto di gestione di ancoraggio utilizza un elenco di tutti i riquadri di layout di ancoraggio e un elenco di tutte le finestre CPaneFrameWnd appartenenti alla finestra cornice principale.

La classe CDockingManager implementa alcuni servizi che è possibile utilizzare per individuare un riquadro o una finestra CPaneFrameWnd. In genere non chiama direttamente questi servizi in quanto viene eseguito il wrapping nell'oggetto finestra cornice principale. Per ulteriori informazioni, vedere Classe CPaneFrameWnd.

Suggerimenti di personalizzazione

I seguenti suggerimenti relativi a CDockingManager oggetti:

Classe CDockingManager supporta queste modalità di ancoraggio:
- AFX_DOCK_TYPE::DT_IMMEDIATE
- AFX_DOCK_TYPE::DT_STANDARD
- AFX_DOCK_TYPE::DT_SMART
Queste modalità di ancoraggio sono definite da CDockingManager::m_dockModeGlobal e sono impostate chiamando CDockingManager::SetDockingMode.
Se si desidera creare un riquadro non mobile e non può essere ridimensionato, chiamare il metodo CDockingManager::AddPane. Questo metodo registra il riquadro con l'amministratore di ancoraggio, responsabile del layout di riquadro.

Esempio

Nell'esempio seguente viene illustrato come utilizzare i vari metodi della classe CDockingManager per configurare un oggetto CDockingManager. L'esempio mostra come visualizzare un pulsante aggiuntivo che apre un menu di scelta rapida sulle didascalie dei riquadri ancorati e come impostare la modalità di ancoraggio dell'oggetto. Questo frammento di codice fa parte Esempio demo di Visual Studio.

   CDockingManager* pDockManager = GetDockingManager();
    ASSERT_VALID(pDockManager);
    pDockManager->AdjustPaneFrames();
    pDockManager->EnableDockSiteMenu();
    pDockManager->SetDockingMode(DT_STANDARD);