Classe CDockablePane

Articolo
06/10/2015

Implementa un riquadro che può essere ancorato in un sito di ancoraggio o essere incluso nel riquadro a schede.

class CDockablePane : public CPane

Membri

Costruttori pubblici

Nome	Descrizione
CDockablePane::CDockablePane	Costrutti e inizializza un oggetto CDockablePane.

Metodi pubblici

Nome	Descrizione
CDockablePane::AttachToTabWnd	Associa un riquadro a un altro riquadro. Verrà creato un riquadro a schede.
CDockablePane::CalcFixedLayout	Restituisce le dimensioni del rettangolo del riquadro.
CDockablePane::CanAcceptMiniFrame	Determina se il frame specificato mini può essere ancorato al riquadro.
CDockablePane::CanAcceptPane	Determina se un altro riquadro può essere ancorato al riquadro corrente.
CDockablePane::CanAutoHide	Determina se il riquadro supporta la modalità nascondi automaticamente. (Override CBasePane::CanAutoHide).
CDockablePane::CanBeAttached	Determina se il riquadro corrente può essere ancorata a un altro riquadro.
CDockablePane::ConvertToTabbedDocument	Converte una o più riquadri ancorabili a documenti a schede MDI.
CDockablePane::CopyState	Copiare lo stato di un riquadro ancorabile.
CDockablePane::Create	Crea il controllo Windows e lo aggiunge all'oggetto CDockablePane.
CDockablePane::CreateDefaultPaneDivider	Crea un separatore predefinito del riquadro di un ancoraggio in una finestra cornice.
CDockablePane::CreateEx	Crea il controllo Windows e lo aggiunge all'oggetto CDockablePane.
CDockablePane::CreateTabbedPane	Crea un riquadro a schede nel riquadro corrente.
CDockablePane::DockPaneContainer	Un contenitore al riquadro.
CDockablePane::DockPaneStandard	Un riquadro utilizzando l'ancoraggio della struttura (standard).
CDockablePane::DockToFrameWindow	Per uso interno. Per ancorare un riquadro, utilizzare CPane::DockPane o CDockablePane::DockToWindow.
CDockablePane::DockToRecentPos	Un riquadro nella posizione memorizzata recente di ancoraggio.
CDockablePane::DockToWindow	Ancoraggio un riquadro ancorato a un altro riquadro ancorato.
CDockablePane::EnableAutohideAll	Abilita o disabilita la modalità nascondi automaticamente per questo riquadro con altri riquadri nel contenitore.
CDockablePane::EnableGripper	Consente di visualizzare o nascondere la barra del titolo (pinza di rimozione).
CDockablePane::GetAHRestoredRect	Specifica la posizione del riquadro una volta visibile in modalità nascondi automaticamente.
CDockablePane::GetAHSlideMode	Recupera la modalità automatica della diapositiva nascondi per il riquadro.
CDockablePane::GetAutoHideButton	Per uso interno.
CDockablePane::GetAutoHideToolBar	Per uso interno.
CDockablePane::GetCaptionHeight	Restituisce l'altezza della didascalia corrente.
CDockablePane::GetDefaultPaneDivider	Restituisce il separatore predefinito del riquadro per il contenitore del riquadro.
CDockablePane::GetDockingStatus	Determina la capacità di un riquadro di essere ancorata in base alla posizione specificata del puntatore.
CDockablePane::GetDragSensitivity	Restituisce la sensibilità del trascinamento di un riquadro ancorato.
CDockablePane::GetLastPercentInPaneContainer	Recupera la percentuale di spazio che un riquadro occupa nel relativo contenitore.
CDockablePane::GetTabArea	Recupera l'area della scheda del riquadro.
CDockablePane::GetTabbedPaneRTC	Restituisce informazioni di runtime su una finestra a schede creata a un altro riquadro è ancora nel riquadro corrente.
CDockablePane::HasAutoHideMode	Specifica se un riquadro ancorato può essere modificato in modalità nascondi automaticamente.
CDockablePane::HitTest	Specifica la posizione specifica nel riquadro in cui l'utente fa clic su un mouse.
CDockablePane::IsAccessibilityCompatible	Per uso interno.
CDockablePane::IsAutohideAllEnabled	Indica se il riquadro ancorato e tutti gli altri riquadri nel contenitore possono essere inseriti in modalità nascondi automaticamente.
CDockablePane::IsAutoHideMode	Determina se un riquadro è in modalità nascondi automaticamente.
CDockablePane::IsChangeState	Per uso interno.
CDockablePane::IsDocked	Determina se il riquadro corrente è ancorato.
CDockablePane::IsHideInAutoHideMode	Determina il comportamento di un riquadro in modalità nascondi automaticamente se viene visualizzato o nascosto) chiamando ShowPane.
CDockablePane::IsInFloatingMultiPaneFrameWnd	Specifica se il riquadro è in una finestra cornice a più riquadri.
CDockablePane::IsResizable	Specifica se il riquadro è ridimensionabile.
CDockablePane::IsTabLocationBottom	Specifica se le schede risiedono nella parte superiore o inferiore del riquadro.
CDockablePane::IsTracked	Specifica se un riquadro sta trascinando dall'utente.
CDockablePane::IsVisible	Determina se il riquadro corrente è visibile.
CDockablePane::LoadState	Per uso interno.
CDockablePane::OnAfterChangeParent	Chiamato dal framework quando il padre di un riquadro di modifica. (Override CPane::OnAfterChangeParent).
CDockablePane::OnAfterDockFromMiniFrame	Chiamato dal framework quando ancorato mobili di una barra di ancoraggio in una finestra cornice.
CDockablePane::OnBeforeChangeParent	Chiamato dal framework quando il padre del riquadro sta la modifica. (Override CPane::OnBeforeChangeParent).
CDockablePane::OnBeforeFloat	Chiamato dal framework quando un riquadro sta in float. (Override CPane::OnBeforeFloat).
CDockablePane::RemoveFromDefaultPaneDividier	Il framework chiama questo metodo quando un riquadro è disinserendo come espansione.
CDockablePane::ReplacePane	Sostituisce il riquadro con un riquadro specificato.
CDockablePane::RestoreDefaultPaneDivider	Il framework chiama questo metodo quando un riquadro viene deserializzato per ripristinare il separatore predefinito del riquadro.
CDockablePane::SaveState	Per uso interno.
CDockablePane::Serialize	Serializza il riquadro. (Override CBasePane::Serialize).
CDockablePane::SetAutoHideMode	Scorre il riquadro ancorato tra la modalità nascondi automaticamente e visibile.
CDockablePane::SetAutoHideParents	Imposta il pulsante Nascondi automaticamente e la barra degli strumenti nascondi automaticamente per il riquadro.
CDockablePane::SetDefaultPaneDivider	Per uso interno.
CDockablePane::SetLastPercentInPaneContainer	Imposta la percentuale di spazio che un riquadro occupa nel relativo contenitore.
CDockablePane::SetResizeMode	Per uso interno.
CDockablePane::SetRestoredDefaultPaneDivider	Imposta il separatore predefinito ripristinato il riquadro.
CDockablePane::SetTabbedPaneRTC	Imposta le informazioni sulla classe di runtime per una finestra a schede creata quando due riquadri si ancorano raccolta.
CDockablePane::ShowPane	Mostra o nasconde il riquadro.
CDockablePane::Slide	Mostra o nasconde un riquadro con un'animazione scorrere le visualizzazioni solo quando il riquadro è in modalità nascondi automaticamente.
CDockablePane::ToggleAutoHide	Modalità nascondi automaticamente di consente di passare. (Override CPane::ToggleAutoHide ).
CDockablePane::UndockPane	Disinserisce come espansione un riquadro della finestra cornice principale o da un contenitore della finestra cornice.
CDockablePane::UnSetAutoHideMode	Per uso interno. Per impostare la modalità nascondi automaticamente, utilizzare CDockablePane::SetAutoHideMode

Metodi protetti

Nome	Descrizione
CDockablePane::CheckAutoHideCondition	Determina se il riquadro ancorato viene nascosto (in modalità nascondi automaticamente).
CDockablePane::CheckStopSlideCondition	Determina se un riquadro ancorato nascondi automaticamente dovrebbe smettere di scorrimento.
CDockablePane::DrawCaption	Estrae la barra del titolo del riquadro ancorato (pinza di rimozione).
CDockablePane::OnPressButtons	Chiamato quando l'utente preme un pulsante della barra del titolo diversi dai pulsanti AFX_HTMAXBUTTON e AFX_HTCLOSE.
CDockablePane::OnSlide	Chiamato dal framework per eseguire il rendering dell'effetto della diapositiva nascondi automaticamente quando il riquadro è visualizzato o nascosto.

Membri di dati

Nome	Descrizione
CDockablePane::m_bDisableAnimation	Specifica se l'animazione nascondi automaticamente il riquadro ancorabile è disabilitata.
CDockablePane::m_bHideInAutoHideMode	Determina il comportamento del riquadro quando il riquadro è in modalità nascondi automaticamente.
CDockablePane::m_nSlideSteps	Specifica la velocità di animazione del riquadro quando viene indicanda o nascondere in modalità nascondi automaticamente.

Note

CDockablePane implementa la funzionalità seguenti:

Ancoraggio di un riquadro in una finestra cornice principale.
Passare una modalità nascondi automaticamente il riquadro.
Aggiungere un riquadro a una finestra a schede.
Fare e un riquadro in una finestra di cornice.
Ancoraggio di un riquadro a un altro riquadro che è mobile in una finestra di cornice.
Ridimensionare un riquadro.
Stato di salvataggio e caricamento di un riquadro ancorato.

Nota

Le informazioni sullo stato vengono salvate a Windows Registro di sistema.
Creare un riquadro con o senza una didascalia. La barra del titolo sia un'etichetta di testo e può essere soddisfatta di colore sfumato.
Trascinare un riquadro e visualizzare il contenuto del riquadro
Trascinare un riquadro e visualizzare un rettangolo di trascinamento.

Per utilizzare un riquadro ancorato nell'applicazione, derivare la classe del riquadro dalla classe CDockablePane. Importare l'oggetto derivato nell'oggetto finestra cornice principale o in un oggetto window controlli che l'istanza del riquadro. Chiamare il metodo CDockablePane::Create o il metodo CDockablePane::CreateEx quando si sviluppa il messaggio WM_CREATE la finestra cornice principale. Infine, impostare l'oggetto del riquadro chiamando CBasePane::EnableDocking, CBasePane::DockPane, o CDockablePane::AttachToTabWnd.

Suggerimenti di personalizzazione

I seguenti suggerimenti relativi a CDockablePane oggetti:

Se si chiama CDockablePane::AttachToTabWnd per due non a schede, i riquadri ancorabili, un puntatore a una finestra a schede vengono restituiti nel parametro ppTabbedControlBar. È possibile continuare ad aggiungere le schede nella finestra a schede mediante questo parametro.
Il tipo di riquadro a schede creato da CDockablePane::AttachToTabWnd è determinato dall'oggetto CDockablePane nel parametro pTabControlBarAttachTo. È possibile chiamare CDockablePane::SetTabbedPaneRTC per impostare il tipo di riquadro a schede che CDockablePane creerà. Il tipo predefinito è determinato da dwTabbedStyleCDockablePane::Create quando si crea CDockablePane. Se dwTabbedStyle è AFX_CBRS_OUTLOOK_TABS il tipo predefinito è Classe CMFCOutlookBar; se dwTabbedStyle è AFX_CBRS_REGULAR_TABS il tipo predefinito è Classe CTabbedPane.
Se si desidera ancorare un riquadro ancorabile a un altro, chiamare il metodo CDockablePane::DockToWindow. Il riquadro originale deve essere ancorato posizionato prima di chiamare questo metodo.
I controlli CDockablePane::m_bHideInAutoHideMode variabile membro come i riquadri ancorabili si comportano in modo automatico nascosto quando si chiama CDockablePane::ShowPane. Se questa variabile membro è impostato su TRUE, i riquadri ancorabili e i relativi pulsanti automatici nascondi verranno nascosti. In caso contrario, scorreranno in e out.
È possibile disabilitare l'animazione nascondi automaticamente impostando la variabile membro CDockablePane::m_bDisableAnimation a TRUE.

Esempio

Nell'esempio seguente viene illustrato come configurare un oggetto CDockablePane utilizzando i diversi metodi nella classe CDockablePane. Nell'esempio viene illustrato come abilitare il automatica nascondere tutte le funzionalità del riquadro ancorabile, attivare la barra del titolo o la pinza di controllo, attivare la modalità nascondi automaticamente, visualizzare il riquadro e animarsi un riquadro in modalità nascondi automaticamente. Questo frammento di codice fa parte Esempio demo di Visual Studio.

  // GetOwner is an inherited method.
    CDockablePane* pParentBar = DYNAMIC_DOWNCAST(CDockablePane, GetOwner());


...


        pParentBar->EnableAutohideAll();
        pParentBar->EnableGripper(true);
        pParentBar->SetAutoHideMode(true, CBRS_ALIGN_LEFT);
        pParentBar->ShowPane(true,false,true);
        pParentBar->Slide(true);