Classe CBaseTabbedPane
Estende la funzionalità della CDockablePane Class per supportare la creazione di finestre a schede.
Sintassi
class CBaseTabbedPane : public CDockablePane
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
CBaseTabbedPane::CBaseTabbedPane |
Costruttore predefinito. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CBaseTabbedPane::AddTab | Aggiunge una nuova scheda a un riquadro a schede. |
| CBaseTabbedPane::AllowDestroyEmptyTabbedPane | Specifica se un riquadro a schede vuoto può essere eliminato definitivamente. |
| CBaseTabbedPane::ApplyRestoredTabInfo | Applica le impostazioni delle schede, caricate dal Registro di sistema, a un riquadro a schede. |
| CBaseTabbedPane::CanFloat | Determina se il riquadro può essere mobile. (sostituzioni )CBasePane::CanFloat. |
| CBaseTabbedPane::CanSetCaptionTextToTabName | Determina se il didascalia per il riquadro a schede deve visualizzare lo stesso testo della scheda attiva. |
| CBaseTabbedPane::ConvertToTabbedDocument | (sostituzioni )CDockablePane::ConvertToTabbedDocument. |
| CBaseTabbedPane::D etachPane | Converte uno o più riquadri ancorabili in documenti a schede MDI. |
| CBaseTabbedPane::EnableSetCaptionTextToTabName | Abilita o disabilita la possibilità del riquadro a schede di sincronizzare didascalia testo con il testo dell'etichetta nella scheda attiva. |
| CBaseTabbedPane::FillDefaultTabsOrderArray | Ripristina lo stato predefinito dell'ordine di tabulazioni interno. |
| CBaseTabbedPane::FindBarByTabNumber | Restituisce un riquadro che si trova in una scheda quando la scheda è identificata da un indice di tabulazioni in base zero. |
| CBaseTabbedPane::FindPaneByID | Restituisce un riquadro identificato dall'ID del riquadro. |
| CBaseTabbedPane::FloatTab | Separa un riquadro, ma solo se il riquadro si trova in una scheda rimovibile. |
| CBaseTabbedPane::GetDefaultTabsOrder | Restituisce l'ordine predefinito delle schede nel riquadro. |
| CBaseTabbedPane::GetFirstVisibleTab | Recupera un puntatore alla prima scheda visualizzata. |
| CBaseTabbedPane::GetMinSize | Recupera le dimensioni minime consentite per il riquadro. (sostituzioni )CPane::GetMinSize.) |
| CBaseTabbedPane::GetPaneIcon | Restituisce un handle per l'icona del riquadro. (sostituzioni )CBasePane::GetPaneIcon. |
| CBaseTabbedPane::GetPaneList | Restituisce un elenco di riquadri contenuti nel riquadro a schede. |
| CBaseTabbedPane::GetTabArea | Restituisce i rettangoli di delimitazione per le aree di tabulazione superiore e inferiore. |
| CBaseTabbedPane::GetTabsNum | Restituisce il numero di schede in una finestra di tabulazioni. |
| CBaseTabbedPane::GetUnderlyingWindow | Ottiene la finestra della scheda sottostante (di cui è stato eseguito il wrapping). |
| CBaseTabbedPane::GetVisibleTabsNum | Restituisce il conteggio delle schede visualizzate. |
| CBaseTabbedPane::HasAutoHideMode | Determina se il riquadro a schede può essere impostato sulla modalità nascondi automaticamente. |
| CBaseTabbedPane::IsHidesingleTab | Determina se il riquadro a schede è nascosto se viene visualizzata una sola scheda. |
CBaseTabbedPane::LoadSiblingPaneIDs |
Utilizzato internamente durante la serializzazione. |
| CBaseTabbedPane::RecalcLayout | Ricalcola le informazioni sul layout per il riquadro. (sostituzioni )CPane::RecalcLayout. |
| CBaseTabbedPane::RemovePane | Rimuove un riquadro dal riquadro a schede. |
CBaseTabbedPane::SaveSiblingBarIDs |
Utilizzato internamente durante la serializzazione. |
CBaseTabbedPane::Serialize |
(sostituzioni )CDockablePane::Serialize. |
CBaseTabbedPane::SerializeTabWindow |
Utilizzato internamente durante la serializzazione. |
| CBaseTabbedPane::SetAutoDestroy | Determina se la barra di controllo a schede verrà eliminata automaticamente. |
| CBaseTabbedPane::SetAutoHideMode | Attiva/disattiva il riquadro di ancoraggio tra la modalità di visualizzazione e nascondi automaticamente. (sostituzioni )CDockablePane::SetAutoHideMode. |
| CBaseTabbedPane::ShowTab | Visualizza o nasconde una scheda. |
Osservazioni:
Questa classe è una classe astratta e non può essere creata un'istanza. Implementa i servizi comuni a tutti i tipi di riquadri a schede.
Attualmente, la libreria include due classi di riquadri a schede derivate: classe CTabbedPane e classe CMFCOutlookBar.
Un CBaseTabbedPane oggetto esegue il wrapping di un puntatore a un oggetto Classe CMFCBaseTabCtrl. La classe CMFCBaseTabCtrl diventa quindi una finestra figlio del riquadro a schede.
Per altre informazioni su come creare riquadri a schede, vedere Classe CDockablePane, Classe CTabbedPane e classe CMFCOutlookBar.
Gerarchia di ereditarietà
CBaseTabbedPane
Requisiti
Intestazione: afxBaseTabbedPane.h
CBaseTabbedPane::AddTab
Aggiunge una nuova scheda a un riquadro a schede.
virtual BOOL AddTab(
CWnd* pNewBar,
BOOL bVisible = TRUE,
BOOL bSetActive = TRUE,
BOOL bDetachable = TRUE);
Parametri
pNewBar
[in, out] Puntatore al riquadro da aggiungere. Questo puntatore potrebbe non essere valido dopo aver chiamato questo metodo. Per altre informazioni, vedere la sezione Osservazioni.
bVisible
[in] TRUE per rendere visibile la scheda; in caso contrario, FAL edizione Standard.
bSetActive
[in] TRUE per rendere attiva la scheda; in caso contrario, FAL edizione Standard.
bDetachable
[in] TRUE per rendere la scheda scollegabile; in caso contrario, FAL edizione Standard.
Valore restituito
TRUE se il riquadro è stato aggiunto correttamente come scheda e non è stato eliminato definitivamente nel processo. FAL edizione Standard se il riquadro da aggiungere è un oggetto di tipo CBaseTabbedPane. Per altre informazioni, vedere la sezione Osservazioni.
Osservazioni:
Chiamare questo metodo per aggiungere un riquadro come nuova scheda in un riquadro a schede. Se pNewBar punta a un oggetto di tipo CBaseTabbedPane, tutte le relative schede vengono copiate nel riquadro a schede e quindi pNewBar viene eliminato definitivamente. Pertanto, pNewBar diventa un puntatore non valido e non deve essere usato.
CBaseTabbedPane::AllowDestroyEmptyTabbedPane
Specifica se un riquadro a schede vuoto può essere eliminato definitivamente.
virtual BOOL AllowDestroyEmptyTabbedPane() const;
Valore restituito
TRUE se un riquadro a schede vuoto può essere eliminato definitivamente; in caso contrario, FAL edizione Standard. L'implementazione predefinita restituisce sempre TRUE.
Osservazioni:
Se non è consentito eliminare definitivamente un riquadro a schede vuoto, il framework nasconde invece il riquadro.
CBaseTabbedPane::ApplyRestoredTabInfo
Carica le impostazioni delle schede dal Registro di sistema e le applica a un riquadro a schede.
virtual void ApplyRestoredTabInfo(BOOL bUseTabIndexes = FALSE);
Parametri
bUseTabIndexes
[in] Questo parametro viene usato internamente dal framework.
Osservazioni:
Questo metodo viene chiamato dal framework quando ricarica le informazioni sullo stato di ancoraggio dal Registro di sistema. Il metodo ottiene informazioni sull'ordine di tabulazioni e i nomi di tabulazioni per un riquadro a schede.
CBaseTabbedPane::CanFloat
Specifica se il riquadro a schede può essere mobile.
virtual BOOL CanFloat() const;
Valore restituito
TRUE se il riquadro può galleggiare; in caso contrario, FAL edizione Standard.
CBaseTabbedPane::CanSetCaptionTextToTabName
Determina se il didascalia per il riquadro a schede deve visualizzare lo stesso testo della scheda attiva.
virtual BOOL CanSetCaptionTextToTabName() const;
Valore restituito
TRUE se il testo didascalia del riquadro a schede è impostato sul testo della scheda attiva; in caso contrario, FAL edizione Standard.
Osservazioni:
Il metodo viene utilizzato per determinare se il testo visualizzato nel riquadro a schede didascalia duplica l'etichetta della scheda attiva. È possibile abilitare o disabilitare questa funzionalità chiamando CBaseTabbedPane::EnableSetCaptionTextToTabName.
CBaseTabbedPane::ConvertToTabbedDocument
Converte uno o più riquadri ancorabili in documenti a schede MDI.
virtual void ConvertToTabbedDocument(BOOL bActiveTabOnly = TRUE);
Parametri
bActiveTabOnly
[in] Quando si converte un riquadro a schede, specificare TRUE per convertire solo la scheda attiva. Specificare FAL edizione Standard per convertire tutte le schede nel riquadro.
CBaseTabbedPane::D etachPane
Scollega un riquadro dal riquadro a schede.
virtual BOOL DetachPane(
CWnd* pBar,
BOOL bHide = FALSE);
Parametri
pBar
[in] Puntatore al riquadro da scollegare.
bHide
[in] Parametro booleano che specifica se il framework nasconde il riquadro dopo che è stato scollegato.
Valore restituito
TRUE se il framework scollega correttamente il riquadro; FAL edizione Standard se pBar è NULL o fa riferimento a un riquadro che non si trova nel riquadro a schede.
Osservazioni:
Il framework floats the detached pane if possible. Per altre informazioni, vedere CBasePane::CanFloat.
CBaseTabbedPane::EnableSetCaptionTextToTabName
Abilita o disabilita la possibilità del riquadro a schede di sincronizzare didascalia testo con il testo dell'etichetta nella scheda attiva.
virtual void EnableSetCaptionTextToTabName(BOOL bEnable);
Parametri
bEnable
[in] TRUE per sincronizzare il riquadro a schede didascalia con la scheda attiva didascalia; in caso contrario, FAL edizione Standard.
CBaseTabbedPane::FillDefaultTabsOrderArray
Ripristina lo stato predefinito dell'ordine di tabulazioni interno.
void FillDefaultTabsOrderArray();
Osservazioni:
Questo metodo viene chiamato quando il framework ripristina uno stato iniziale di una barra di Outlook.
CBaseTabbedPane::FindPaneByID
Restituisce un riquadro identificato dall'ID del riquadro.
virtual CWnd* FindPaneByID(UINT uBarID);
Parametri
uBarID
[in] Specifica l'ID del riquadro da trovare.
Valore restituito
Puntatore al riquadro, se trovato; in caso contrario, NULL.
Osservazioni:
Questo metodo confronta tutte le schede nel riquadro e restituisce quella con l'ID specificato dal parametro uBarID .
CBaseTabbedPane::FindBarByTabNumber
Restituisce un riquadro che risiede in una scheda.
virtual CWnd* FindBarByTabNumber(
int nTabNum,
BOOL bGetWrappedBar = FALSE);
Parametri
nTabNum
[in] Specifica l'indice in base zero della scheda da recuperare.
bGetWrappedBar
[in] TRUE per restituire la finestra sottostante (incapsulata) del riquadro anziché il riquadro stesso; altrimenti FAL edizione Standard. Questo vale solo per i riquadri derivati da CDockablePaneAdapter.
Valore restituito
Se viene trovato il riquadro, viene restituito un puntatore valido al riquadro cercato; in caso contrario, NULL.
Osservazioni:
Chiamare questo metodo per recuperare il riquadro che si trova nella scheda specificata dal parametro nTabNum .
CBaseTabbedPane::FloatTab
Separa un riquadro, ma solo se il riquadro si trova in una scheda rimovibile.
virtual BOOL FloatTab(
CWnd* pBar,
int nTabID,
AFX_DOCK_METHOD dockMethod,
BOOL bHide = FALSE);
Parametri
pBar
[in, out] Puntatore al riquadro da spostare.
nTabID
[in] Specifica l'indice in base zero della scheda su float.
dockMethod
[in] Specifica il metodo da utilizzare per rendere il riquadro float. Per altre informazioni, vedere la sezione Osservazioni.
bHide
[in] TRUE per nascondere il riquadro prima di virgola mobile; in caso contrario, FAL edizione Standard.
Valore restituito
TRUE se il riquadro è mobile; in caso contrario, FAL edizione Standard.
Osservazioni:
Chiamare questo metodo per spostare un riquadro che attualmente si trova in una scheda scollegabile.
Se si vuole scollegare un riquadro a livello di codice, specificare DM_SHOW per il parametro dockMethod . Se si vuole spostare il riquadro nella stessa posizione in cui è stata spostata in precedenza, specificare DM_DBL_CLICK come parametro dockMethod .
CBaseTabbedPane::GetDefaultTabsOrder
Restituisce l'ordine predefinito delle schede nel riquadro.
const CArray<int,int>& GetDefaultTabsOrder();
Valore restituito
Oggetto CArray che specifica l'ordine predefinito delle schede nel riquadro.
Osservazioni:
Il framework chiama questo metodo quando una barra di Outlook viene reimpostata su uno stato iniziale.
CBaseTabbedPane::GetFirstVisibleTab
Recupera un puntatore alla prima scheda visualizzata.
virtual CWnd* GetFirstVisibleTab(int& iTabNum);
Parametri
iTabNum
[in] Riferimento a un numero intero. Questo metodo scrive l'indice in base zero della prima scheda visualizzata in questo parametro oppure -1 se non viene trovata alcuna scheda visualizzata.
Valore restituito
In caso di esito positivo, un puntatore alla prima scheda visualizzata; in caso contrario, NULL.
CBaseTabbedPane::GetMinSize
Recupera le dimensioni minime consentite per il riquadro.
virtual void GetMinSize(CSize& size) const;
Parametri
size
[out] Oggetto CSize riempito con la dimensione minima consentita.
Osservazioni:
Se la gestione coerente delle dimensioni minime dei riquadri è attiva ( CPane::m_bHandleMinSize), le dimensioni vengono riempite con le dimensioni minime consentite per la scheda attiva. In caso contrario, le dimensioni vengono riempite con il valore restituito CPane::GetMinSize.
CBaseTabbedPane::GetPaneIcon
Recupera le dimensioni minime consentite per il riquadro.
virtual void GetMinSize(CSize& size) const;
Parametri
size
[out] Oggetto CSize riempito con la dimensione minima consentita.
Osservazioni:
Se la gestione coerente delle dimensioni minime dei riquadri è attiva ( CPane::m_bHandleMinSize), le dimensioni vengono riempite con le dimensioni minime consentite per la scheda attiva. In caso contrario, le dimensioni vengono riempite con il valore restituito CPane::GetMinSize.
CBaseTabbedPane::GetPaneList
Restituisce un elenco di riquadri contenuti nel riquadro a schede.
virtual void GetPaneList(
CObList& lst,
CRuntimeClass* pRTCFilter = NULL);
Parametri
Lst
[out] Oggetto CObList riempito con i riquadri contenuti nel riquadro a schede.
pRTCFilter
[in] Se non è NULL, l'elenco restituito contiene solo riquadri della classe di runtime specificata.
CBaseTabbedPane::GetTabArea
Restituisce i rettangoli di delimitazione per le aree di tabulazione superiore e inferiore.
virtual void GetTabArea(
CRect& rectTabAreaTop,
CRect& rectTabAreaBottom) const = 0;
Parametri
rectTabAreaTop
[out] Riceve le coordinate dello schermo dell'area della scheda superiore.
rectTabAreaBottom
[out] Riceve le coordinate dello schermo dell'area della scheda inferiore.
Osservazioni:
Chiamare questo metodo per determinare i rettangoli di delimitazione, nelle coordinate dello schermo, per le aree di tabulazione superiore e inferiore.
CBaseTabbedPane::GetTabsNum
Restituisce il numero di schede in una finestra di tabulazioni.
virtual int GetTabsNum() const;
Valore restituito
Numero di schede nel riquadro a schede.
CBaseTabbedPane::GetUnderlyingWindow
Ottiene la finestra della scheda sottostante (di cui è stato eseguito il wrapping).
virtual CMFCBaseTabCtrl* GetUnderlyingWindow();
Valore restituito
Puntatore alla finestra della scheda sottostante.
CBaseTabbedPane::GetVisibleTabsNum
Restituisce il conteggio delle schede visibili.
virtual int GetVisibleTabsNum() const;
Valore restituito
Numero di schede visibili, che saranno maggiori o uguali a zero.
Osservazioni:
Chiamare questo metodo per determinare il numero di schede visibili nel riquadro a schede.
CBaseTabbedPane::HasAutoHideMode
Determina se il riquadro a schede può passare alla modalità Nascondi automaticamente.
virtual BOOL HasAutoHideMode() const;
Valore restituito
TRUE se il riquadro può essere impostato sulla modalità di individuazione automatica; in caso contrario, FAL edizione Standard.
Osservazioni:
Se la modalità autohide è disabilitata, nel riquadro a schede non viene visualizzato alcun pulsante di aggiunta didascalia.
CBaseTabbedPane::IsHidesingleTab
Determina se il riquadro a schede è nascosto se viene visualizzata una sola scheda.
virtual BOOL IsHideSingleTab() const;
Valore restituito
TRUE se la finestra della scheda non viene visualizzata quando è presente una sola scheda visibile; in caso contrario, FAL edizione Standard.
Osservazioni:
Se il riquadro non viene visualizzato perché è aperta una sola scheda, è possibile chiamare questo metodo per determinare se il riquadro a schede funziona correttamente.
CBaseTabbedPane::RemovePane
Rimuove un riquadro dal riquadro a schede.
virtual BOOL RemovePane(CWnd* pBar);
Parametri
pBar
[in, out] Puntatore al riquadro da rimuovere dal riquadro a schede.
Valore restituito
TRUE se il riquadro è stato rimosso correttamente dal riquadro a schede e se il riquadro a schede è ancora valido. FAL edizione Standard se l'ultimo riquadro è stato rimosso dal riquadro a schede e il riquadro a schede sta per essere eliminato definitivamente. Se il valore restituito è FAL edizione Standard, non usare più il riquadro a schede.
Osservazioni:
Chiamare questo metodo per rimuovere il riquadro specificato dal parametro pBar dal riquadro a schede.
CBaseTabbedPane::SetAutoDestroy
Determina se la barra di controllo a schede verrà eliminata automaticamente.
void SetAutoDestroy(BOOL bAutoDestroy = TRUE);
Parametri
bAutoDestroy
[in] TRUE se il riquadro a schede è stato creato in modo dinamico e non si controlla la durata; in caso contrario, FAL edizione Standard.
Osservazioni:
Impostare la modalità di eliminazione automatica su TRUE se si crea un riquadro a schede in modo dinamico e se non si controlla la durata. Se la modalità di eliminazione automatica è TRUE, il riquadro a schede verrà eliminato automaticamente dal framework.
CBaseTabbedPane::ShowTab
Visualizza o nasconde una scheda.
virtual BOOL ShowTab(
CWnd* pBar,
BOOL bShow,
BOOL bDelay,
BOOL bActivate);
Parametri
pBar
[in] Puntatore al riquadro da visualizzare o nascondere.
bShow
[in] TRUE per mostrare il riquadro; FAL edizione Standard per nascondere il riquadro.
bDelay
[in] TRUE per ritardare la regolazione del layout della scheda; in caso contrario, FAL edizione Standard.
bActivate
[in] TRUE per rendere attiva la scheda; in caso contrario, FAL edizione Standard.
Valore restituito
TRUE se la scheda è stata visualizzata o nascosta correttamente; in caso contrario, FAL edizione Standard.
Osservazioni:
Quando si chiama questo metodo, viene visualizzato o nascosto un riquadro, a seconda del valore del parametro bShow . Se si nasconde una scheda ed è l'ultima scheda visibile nella finestra della scheda sottostante, il riquadro a schede è nascosto. Se si visualizza una scheda quando in precedenza non erano visibili schede, viene visualizzato il riquadro a schede.
CBaseTabbedPane::RecalcLayout
Ricalcola le informazioni sul layout per il riquadro.
virtual void RecalcLayout();
Osservazioni:
Se il riquadro è mobile, questo metodo notifica al framework di ridimensionare il riquadro alle dimensioni correnti del mini-frame.
Se il riquadro è ancorato, questo metodo non esegue alcuna operazione.
CBaseTabbedPane::SetAutoHideMode
Imposta la modalità nascondi automaticamente per i riquadri scollegabili nel riquadro a schede.
virtual CMFCAutoHideToolBar* SetAutoHideMode(
BOOL bMode,
DWORD dwAlignment,
CMFCAutoHideToolBar* pCurrAutoHideBar = NULL,
BOOL bUseTimer = TRUE);
Parametri
bMode
[in] TRUE per abilitare la modalità nascondi automaticamente; FAL edizione Standard per abilitare la normale modalità di ancoraggio.
dwAlignment
[in] Specifica l'allineamento del riquadro nascondi automaticamente da creare. Per un elenco dei valori possibili, vedere CPane::MoveByAlignment.
pCurrAutoHideBar
[in, out] Puntatore alla barra degli strumenti nascondi automaticamente corrente. Può essere NULL.
bUseTimer
[in] Specifica se utilizzare l'effetto nascondi automaticamente quando l'utente passa il riquadro alla modalità nascondi automaticamente o se nascondere immediatamente il riquadro.
Valore restituito
Puntatore alla barra degli strumenti nascondi automaticamente creata quando si passa alla modalità nascondi automaticamente o NULL se non viene creata alcuna barra degli strumenti.
Osservazioni:
Il framework chiama questo metodo quando un utente sceglie il pulsante per aggiungere il riquadro a schede alla modalità nascondi automaticamente o alla normale modalità di ancoraggio.
La modalità nascondi automaticamente è impostata per ogni riquadro scollegabile nel riquadro a schede. I riquadri non scollegabili vengono ignorati. Per altre informazioni, vedere CMFCBaseTabCtrl::EnableTabDetach.
Chiamare questo metodo per impostare un riquadro a schede sulla modalità nascondi automaticamente a livello di codice. Il riquadro deve essere ancorato alla finestra cornice principale ( CDockablePane::GetDefaultPaneDivider deve restituire un puntatore valido a CPaneDivider).
Vedi anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per