Classe CBasePane

Articolo
06/10/2015

Classe base per tutti i riquadri in MFC.

class CBasePane : public CWnd

Membri

Costruttori pubblici

Nome	Descrizione
CBasePane::CBasePane	Costruttore predefinito.
CBasePane::~CBasePane	Distruttore

Metodi pubblici

Nome	Descrizione
CBasePane::accHitTest	Chiamato dal framework per recuperare l'elemento figlio o l'oggetto figlio in un determinato punto dello schermo. (Override CWnd::accHitTest).
CBasePane::accLocation	Chiamato dal framework per recuperare la posizione corrente dello schermo per l'oggetto specificato. (Override CWnd::accLocation).
CBasePane::AccNotifyObjectFocusEvent	CBasePane non utilizza questo metodo.
CBasePane::accSelect	Chiamato dal framework per modificare la selezione o spostare lo stato attivo dell'oggetto specificato. (Override CWnd::accSelect).
CBasePane::AddPane	Aggiunge un riquadro all'amministratore di ancoraggio.
CBasePane::AdjustDockingLayout	Reindirizza una chiamata all'amministratore di ancoraggio per impostare il layout di ancoraggio.
CBasePane::AdjustLayout	Chiamato dal framework quando il riquadro deve modificare il layout interno.
CBasePane::CalcFixedLayout	Calcola la dimensione orizzontale di una barra di controllo.
CBasePane::CanAcceptPane	Determina se un altro riquadro può essere ancorato al riquadro.
CBasePane::CanAutoHide	Determina se il riquadro supporta la modalità nascondi automaticamente.
CBasePane::CanBeAttached	Determina se il riquadro può essere ancorata a un altro riquadro.
CBasePane::CanBeClosed	Determina se il riquadro può essere chiuso.
CBasePane::CanBeDocked	Determina se il riquadro può essere ancorata a un altro riquadro.
CBasePane::CanBeResized	Determina se il riquadro può essere ridimensionato.
CBasePane::CanBeTabbedDocument	Specifica se il riquadro può essere convertito in un documento a schede MDI.
CBasePane::CanFloat	Determina se il riquadro è mobile.
CBasePane::CanFocus	Specifica se il riquadro può ricevere lo stato attivo.
CBasePane::CopyState	Copiare lo stato di un riquadro specificato.
CBasePane::CreateDefaultMiniframe	Se il riquadro è mobile, crea una finestra cornice piccola.
CBasePane::CreateEx	Crea il controllo pane.
CBasePane::DockPane	Un riquadro a un altro riquadro o una finestra cornice.
CBasePane::DockPaneUsingRTTI	Nuovamente il riquadro utilizzando le informazioni.
CBasePane::DockToFrameWindow	Un riquadro ancorabile a un frame.
CBasePane::DoesAllowDynInsertBefore	Determina se un altro riquadro può essere inserito dinamicamente da questo riquadro e il frame padre.
CBasePane::EnableDocking	Consente l'ancoraggio del riquadro della cornice principale.
CBasePane::EnableGripper	Abilita o disabilita la pinza di controllo. Se la pinza di controllo è selezionata, è possibile trascinarlo per riposizionare il riquadro.
CBasePane::FillWindowRect	Per uso interno.
CBasePane::FloatPane	Fa float il riquadro.
CBasePane::get_accChild	Chiamato dal framework per recuperare l'indirizzo di un'interfaccia IDispatch per il figlio specificato. (Override CWnd::get_accChild).
CBasePane::get_accChildCount	Chiamato dal framework per recuperare il numero di elementi figlio che appartengono a questo oggetto. (Override CWnd::get_accChildCount).
CBasePane::get_accDefaultAction	Chiamato dal framework per recuperare una stringa che descrive l'azione predefinita per l'oggetto. (Override CWnd::get_accDefaultAction).
CBasePane::get_accDescription	Chiamato dal framework per recuperare una stringa che descrive l'aspetto visivo dell'oggetto specificato. (Override CWnd::get_accDescription).
CBasePane::get_accFocus	Chiamato dal framework per recuperare l'oggetto che ha lo stato attivo. (Override CWnd::get_accFocus).
CBasePane::get_accHelp	Chiamato dal framework per recuperare una stringa della proprietà della guida per l'oggetto. (Override CWnd::get_accHelp).
CBasePane::get_accHelpTopic	Chiamato dal framework per recuperare il percorso completo del WinHelpfileassociato all'oggetto specificato e l'identificatore dell'argomento appropriato nel file. (Override CWnd::get_accHelpTopic).
CBasePane::get_accKeyboardShortcut	Chiamato dal framework per recuperare il tasto di scelta rapida specificato per l'oggetto. (Override CWnd::get_accKeyboardShortcut).
CBasePane::get_accName	Chiamato dal framework per recuperare il nome dell'oggetto specificato. (Override CWnd::get_accName).
CBasePane::get_accParent	Chiamato dal framework per recuperare l'interfaccia IDispatch per il padre dell'oggetto. (Override CWnd::get_accParent).
CBasePane::get_accRole	Chiamato dal framework per recuperare informazioni che descrivono il ruolo dell'oggetto specificato. (Override CWnd::get_accRole).
CBasePane::get_accSelection	Chiamato dal framework per recupero di elementi selezionati di questo oggetto. (Override CWnd::get_accSelection).
CBasePane::get_accState	Chiamato dal framework per recuperare lo stato corrente dell'oggetto specificato. (Override CWnd::get_accState).
CBasePane::get_accValue	Chiamato dal framework per recuperare il valore dell'oggetto specificato. (Override CWnd::get_accValue).
CBasePane::GetCaptionHeight	Restituisce l'altezza della barra del titolo.
CBasePane::GetControlBarStyle	Restituisce lo stile della barra di controllo.
CBasePane::GetCurrentAlignment	Restituisce l'allineamento corrente del riquadro.
CBasePane::GetDockingMode	Restituisce la modalità corrente di ancoraggio per il riquadro.
CBasePane::GetDockSiteFrameWnd	Restituisce un puntatore alla finestra dal sito di ancoraggio per il riquadro.
CBasePane::GetEnabledAlignment	Restituisce gli stili di CBRS_ALIGN_ che si applicano al riquadro.
CBasePane::GetMFCStyle	Restituisce gli stili del riquadro specifici di MFC.
CBasePane::GetPaneIcon	Restituisce l'handle l'icona del riquadro.
CBasePane::GetPaneRect	Per uso interno.
CBasePane::GetPaneRow	Restituisce un puntatore a un oggetto CDockingPanesRowin cui il riquadro è ancorato.
CBasePane::GetPaneStyle	Restituisce lo stile del riquadro.
CBasePane::GetParentDockSite	Restituisce un puntatore al sito di ancoraggio padre.
CBasePane::GetParentMiniFrame	Restituisce un puntatore alla finestra cornice piccola padre.
CBasePane::GetParentTabbedPane	Restituisce un puntatore al riquadro a schede padre.
CBasePane::GetParentTabWnd	Restituisce un puntatore alla finestra padre presente in una scheda.
CBasePane::GetRecentVisibleState	Il framework chiama questo metodo quando un riquadro viene ripristinato da un archivio.
CBasePane::HideInPrintPreviewMode	Specifica se il riquadro è nascosto in anteprima di stampa.
CBasePane::InsertPane	Registra il riquadro specificato con l'amministratore di ancoraggio.
CBasePane::IsAccessibilityCompatible	Specifica se il riquadro supporta l'accessibilità attiva.
CBasePane::IsAutoHideMode	Determina se un riquadro è in modalità nascondi automaticamente.
CBasePane::IsDialogControl	Specifica se il riquadro è un controllo finestra di dialogo.
CBasePane::IsDocked	Determina se il riquadro è ancorato.
CBasePane::IsFloating	Determina se il riquadro è mobile.
CBasePane::IsHorizontal	Determina se il riquadro è ancorato orizzontalmente.
CBasePane::IsInFloatingMultiPaneFrameWnd	Specifica se il riquadro è in una finestra cornice a più riquadri.
CBasePane::IsMDITabbed	Determina se il riquadro viene aggiunto a una finestra figlio MDI come documento a schede.
CBasePane::IsPaneVisible	Specifica se il flag WS_VISIBLE è impostato per il riquadro.
CBasePane::IsPointNearDockSite	Determina se un punto specificato è vicino al sito di ancoraggio.
CBasePane::IsResizable	Determina se il riquadro può essere ridimensionato.
CBasePane::IsRestoredFromRegistry	Determina se il riquadro viene ripristinato dal Registro di sistema.
CBasePane::IsTabbed	Determina se il riquadro è stato immesso nel controllo Struttura a schede di una finestra a schede.
CBasePane::IsTooltipTopmost	Per uso interno.
CBasePane::IsVisible	Determina se il riquadro è visibile.
CBasePane::LoadState	Carica lo stato del riquadro dal Registro di sistema.
CBasePane::MoveWindow	Consente di spostare il riquadro.
CBasePane::OnAfterChangeParent	Chiamato dal framework quando il padre del riquadro è stato modificato.
CBasePane::OnBeforeChangeParent	Chiamato dal framework appena prima del riquadro della finestra padre.
CBasePane::OnDrawCaption	Il framework chiama questo metodo quando la didascalia viene disegnata.
CBasePane::OnMovePaneDivider	Questo metodo non è attualmente utilizzato.
CBasePane::OnPaneContextMenu	Chiamato dal framework quando si compila un menu con un elenco dei riquadri.
CBasePane::OnRemoveFromMiniFrame	Chiamato dal framework quando un riquadro viene rimosso dalla propria mini finestra cornice padre.
CBasePane::OnSetAccData	CBasePane non utilizza questo metodo.
CBasePane::OnUpdateCmdUI	Per uso interno.
CBasePane::PaneFromPoint	Restituisce il riquadro contenente il punto specificato.
CBasePane::PreTranslateMessage	Utilizzato da CWinApp classe per convertire i messaggi della finestra prima che vengano inviati alle funzioni Windows DispatchMessage e TranslateMessage. (Override CWnd::PreTranslateMessage).
CBasePane::RecalcLayout	CBasePane non utilizza questo metodo.
CBasePane::RemovePaneFromDockManager	Annulla la registrazione di un riquadro e lo rimuove dall'amministratore di ancoraggio.
CBasePane::SaveState	Salvare lo stato del riquadro al Registro di sistema.
CBasePane::SelectDefaultFont	Selezionare il tipo di carattere predefinito per un contesto di dispositivo specificato.
CBasePane::Serialize	Lettura o scrittura questo oggetto da o in un archivio. (Override CObject::Serialize).
CBasePane::SetControlBarStyle	Consente di impostare lo stile della barra di controllo.
CBasePane::SetDockingMode	Imposta la modalità di ancoraggio per il riquadro.
CBasePane::SetMDITabbed	Per uso interno.
CBasePane::SetPaneAlignment	Impostato l'allineamento per il riquadro.
CBasePane::SetPaneRect	Per uso interno.
CBasePane::SetPaneStyle	Imposta lo stile del riquadro.
CBasePane::SetRestoredFromRegistry	Per uso interno.
CBasePane::SetWindowPos	Modificare le dimensioni, la posizione e l'ordine Z di un riquadro.
CBasePane::ShowPane	Mostra o nasconde il riquadro.
CBasePane::StretchPane	Adatta un riquadro verticale o orizzontale.
CBasePane::UndockPane	Rimuove il riquadro dal sito di ancoraggio, dal dispositivo di scorrimento predefinito, o dalla finestra cornice piccola in cui è attualmente ancorato.

Metodi protetti

Nome	Descrizione
CBasePane::DoPaint	Riempie lo sfondo del riquadro.

Note

Se si desidera creare una classe del riquadro che supporta le funzionalità estese di ancoraggio disponibili in MFC, è necessario derivarlo da CBasePane o da Classe CPane.

Suggerimenti di personalizzazione

I suggerimenti riportati di personalizzazione relative a Classe CBasePane e le classi che ereditano da:

Quando si crea un riquadro, è possibile applicare diversi nuovi stili:
- AFX_CBRS_FLOAT esegue il riquadro mobile.
- AFX_CBRS_AUTOHIDE attiva la modalità nascondi automaticamente.
- AFX_CBRS_CLOSE consente il riquadro chiudere (nascosto).
Questi sono flag che è possibile combinare con un'operazione OR bit per bit.

CBasePane implementa i metodi seguenti booleani virtuali per riflettere tali flag: CBasePane::CanBeClosed, CBasePane::CanAutoHide, CBasePane::CanFloat. È possibile eseguirne l'override nelle classi derivate per personalizzare il comportamento.
È possibile personalizzare il comportamento di ancoraggio eseguendo l'override CBasePane::CanAcceptPane. Sia il ritorno FALSE il riquadro da questo metodo per impedire un altro pannello di ancoraggio su.
Se si desidera creare un riquadro statico che non è mobile e che impedisce qualsiasi altro pannello di ancoraggio prima di (simile alla barra di Outlook nell'esempio OutlookDemo), è necessario crearlo come non mobile ed eseguire l'override CBasePane::DoesAllowDynInsertBefore per restituire FALSE. L'implementazione predefinita restituisce FALSE se il riquadro viene creato senza lo stile AFX_CBRS_FLOAT.
Creare i riquadri con gli ID diverso da -1.
Per determinare la visibilità del riquadro, utilizzare CBasePane::IsVisible. Gestisce correttamente lo stato di visibilità in modalità nascondi automaticamente e a schede.
Se si desidera creare una finestra ridimensionabile non mobile, è necessario crearlo senza lo stile AFX_CBRS_FLOAT e chiamare CFrameWnd::DockControlBar.
Per escludere un riquadro da un layout di ancoraggio o rimuovere una barra degli strumenti con la relativa barra di ancoraggio, chiamare CBasePane::UndockPane. Non chiamare questo metodo per i riquadri in modalità nascondi automaticamente o per i riquadri che risiedono in schede delle finestre a schede.
Se si desidera eseguire mobile o dimensioni come disancorarle un riquadro in modalità nascondi automaticamente, è necessario chiamare CDockablePane::SetAutoHideMode con FALSE come primo argomento prima di chiamare CBasePane::FloatPane o CBasePane::UndockPane.

Esempio

Nell'esempio seguente viene illustrato come utilizzare i vari metodi della classe CBasePane. Nell'esempio seguente viene illustrato come recuperare un riquadro dalla classe CFrameWndEx e come impostare la modalità di ancoraggio, l'allineamento del riquadro e lo stile del riquadro. Il codice proveniente da Esempio di cuscinetto di Word.

            // This CMainFrame class extends the CFrameWndEx class. 
            // GetPane is a method in the CFrameWndEx class which  
            // Returns a pointer to the pane that has the specified ID.
            CBasePane* pBar = GetPane(ID_VIEW_FORMATBAR);
            if (pBar != NULL)
            {
                // Set the docking mode, the pane alignment, and the pane style.
                pBar->SetDockingMode(DT_STANDARD);
                pBar->SetPaneAlignment(CBRS_ALIGN_LEFT);
                pBar->SetPaneStyle(pBar->GetCurrentAlignment() | CBRS_TOOLTIPS);
                pBar->ShowPane(TRUE, FALSE, FALSE);
            }