Condividi tramite


Classe CMFCBaseTabCtrl

Implementa la funzionalità di base per le finestre a schede. Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.

Sintassi

class CMFCBaseTabCtrl : public CWnd

Membri

Metodi pubblici

Nome Descrizione
CMFCBaseTabCtrl::AddIcon
CMFCBaseTabCtrl::AddTab Aggiunge una nuova scheda alla finestra a schede.
CMFCBaseTabCtrl::ApplyRestoredTabInfo
CMFCBaseTabCtrl::AutoDestroyWindow
CMFCBaseTabCtrl::CalcRectEdit
CMFCBaseTabCtrl::CleanUp
CMFCBaseTabCtrl::ClearImageList
CMFCBaseTabCtrl::DetachTab Scollega una scheda da una finestra a schede.
CMFCBaseTabCtrl::EnableActivateLastActive
CMFCBaseTabCtrl::EnableAutoColor Abilita o disabilita la colorazione automatica della scheda.
CMFCBaseTabCtrl::EnableCustomToolTips Abilita o disabilita le descrizioni comandi personalizzate per le schede.
CMFCBaseTabCtrl::EnableInPlaceEdit Abilita o disabilita la modifica diretta delle etichette delle schede.
CMFCBaseTabCtrl::EnableTabDetach Abilita le schede rimovibili.
CMFCBaseTabCtrl::EnableTabSwap Abilita o disabilita la modifica dell'ordine delle schede con l'uso di un mouse da parte dell'utente.
CMFCBaseTabCtrl::EnsureVisible Scorre schede fino a quando la scheda specificata è visibile. Questo metodo non ha alcun effetto se la scheda specificata è già visibile.
CMFCBaseTabCtrl::EnterDragMode
CMFCBaseTabCtrl::FindTargetWnd Restituisce un riquadro contenente un punto specificato.
CMFCBaseTabCtrl::FireChangeActiveTab
CMFCBaseTabCtrl::FireChangingActiveTab
CMFCBaseTabCtrl::GetActiveTab Restituisce l'indice della scheda attiva.
CMFCBaseTabCtrl::GetActiveTabColor Restituisce il colore di sfondo della scheda attiva.
CMFCBaseTabCtrl::GetActiveTabTextColor Restituisce il colore del testo della scheda attiva.
CMFCBaseTabCtrl::GetActiveWnd Restituisce un puntatore della pagina attiva del controllo scheda.
CMFCBaseTabCtrl::GetAutoColors Restituisce un riferimento alla matrice di colori usati per la colorazione automatica.
CMFCBaseTabCtrl::GetFirstVisibleTab Restituisce un puntatore alla prima scheda visibile.
CMFCBaseTabCtrl::GetFirstVisibleTabNum
CMFCBaseTabCtrl::GetHighlightedTab Restituisce l'indice della scheda attualmente evidenziata.
CMFCBaseTabCtrl::GetImageList
CMFCBaseTabCtrl::GetImageSize
CMFCBaseTabCtrl::GetLastVisibleTab
CMFCBaseTabCtrl::GetLocation Restituisce una variabile del tipo di dati LOCATION che indica dove è posizionata l'area della scheda relativa al controllo scheda. Ad esempio, nella parte superiore o inferiore.
CMFCBaseTabCtrl::GetMaxWindowSize
CMFCBaseTabCtrl::GetTabArea Restituisce le dimensioni e la posizione dell'area della scheda nella finestra a schede. La posizione dell'area della scheda viene definita usando le coordinate.
CMFCBaseTabCtrl::GetTabBkColor Restituisce il colore di sfondo della scheda specificata.
CMFCBaseTabCtrl::GetTabBorderSize Restituisce le dimensioni dei bordi della scheda del controllo scheda.
CMFCBaseTabCtrl::GetTabByID Restituisce l'indice della scheda identificato dall'ID specificato.
CMFCBaseTabCtrl::GetTabCloseButton
CMFCBaseTabCtrl::GetTabFromHwnd Restituisce l'indice di una scheda che contiene un oggetto HWND specificato.
CMFCBaseTabCtrl::GetTabFromPoint Restituisce la scheda contenente un punto specificato.
CMFCBaseTabCtrl::GetTabFullWidth
CMFCBaseTabCtrl::GetTabHicon Restituisce l'icona associata alla chiave specificata.
CMFCBaseTabCtrl::GetTabID Restituisce l'ID di una scheda usando l'indice della scheda.
CMFCBaseTabCtrl::GetTabIcon Restituisce l'ID icona per una scheda specificata.
CMFCBaseTabCtrl::GetTabLabel Restituisce il testo per una scheda specificata.
CMFCBaseTabCtrl::GetTabRect Recupera le dimensioni e la posizione di una scheda specificata.
CMFCBaseTabCtrl::GetTabsHeight
CMFCBaseTabCtrl::GetTabsRect
CMFCBaseTabCtrl::GetTabTextColor Restituisce il colore del testo per una scheda specificata.
CMFCBaseTabCtrl::GetTabWnd Restituisce il puntatore a un riquadro che si trova su una scheda specificata.
CMFCBaseTabCtrl::GetTabWndNoWrapper Restituisce il puntatore diretto a un controllo che si trova su una scheda specificata, anche se il controllo dispone di un wrapper.
CMFCBaseTabCtrl::GetTabsNum Restituisce il numero di schede contenute nel controllo Struttura a schede.
CMFCBaseTabCtrl::GetToolTipCtrl Restituisce un riferimento al controllo ToolTip associato all'oggetto CMFCBaseTabCtrl .
CMFCBaseTabCtrl::GetVisibleTabsNum Restituisce il numero delle schede visibili.
CMFCBaseTabCtrl::HasImage
CMFCBaseTabCtrl::HideSingleTab Imposta un'opzione che consente di nascondere una scheda della finestra, ma solo se la finestra a schede visualizza una sola scheda visibile.
CMFCBaseTabCtrl::InsertTab Inserisce una nuova scheda.
CMFCBaseTabCtrl::InvalidateTab
CMFCBaseTabCtrl::IsActiveTabCloseButton
CMFCBaseTabCtrl::IsAutoColor Restituisce un valore che indica se una finestra a schede è in modalità colore automatica.
CMFCBaseTabCtrl::IsAutoDestroyWindow
CMFCBaseTabCtrl::IsColored
CMFCBaseTabCtrl::IsDialogControl
CMFCBaseTabCtrl::IsDrawNoPrefix
CMFCBaseTabCtrl::IsFlatFrame Restituisce un valore che indica se il frame per l'area della scheda è piatta o 3D.
CMFCBaseTabCtrl::IsFlatTab
CMFCBaseTabCtrl::IsHideSingleTab Restituisce un valore che indica se il controllo scheda è configurato per nascondere una scheda, ma solo se una finestra a schede dispone di una sola scheda visibile.
CMFCBaseTabCtrl::IsIconAdded
CMFCBaseTabCtrl::IsInPlaceEdit Indica se gli utenti possono modificare l'etichetta di una scheda.
CMFCBaseTabCtrl::IsLeftRightRounded
CMFCBaseTabCtrl::IsMDITab
CMFCBaseTabCtrl::IsOneNoteStyle Indica se una finestra a schede visualizza le schede in stile Microsoft OneNote.
CMFCBaseTabCtrl::IsPtInTabArea Verifica l'esistenza di un punto specificato nell'area delle schede.
CMFCBaseTabCtrl::IsTabCloseButtonHighlighted
CMFCBaseTabCtrl::IsTabCloseButtonPressed
CMFCBaseTabCtrl::IsTabDetachable Indica se una scheda è rimovibile.
CMFCBaseTabCtrl::IsTabIconOnly Indica se le schede visualizzano le icone, ma non le etichette.
CMFCBaseTabCtrl::IsTabSwapEnabled Indica se l'utente può modificare le posizioni delle schede trascinando le schede.
CMFCBaseTabCtrl::IsTabVisible Indica se una scheda specificata è visibile.
CMFCBaseTabCtrl::IsVS2005Style
CMFCBaseTabCtrl::MoveTab
CMFCBaseTabCtrl::OnChangeTabs Chiamato dal framework quando viene modificato il numero di schede.
CMFCBaseTabCtrl::OnDragEnter
CMFCBaseTabCtrl::OnDragLeave
CMFCBaseTabCtrl::OnDragOver
CMFCBaseTabCtrl::OnDrop
CMFCBaseTabCtrl::OnRenameTab
CMFCBaseTabCtrl::PreTranslateMessage Usato dalla classe CWinApp per convertire i messaggi della finestra prima che vengano inviati alle funzioni Windows TranslateMessage e DispatchMessage . Esegue l'override di CWnd::PreTranslateMessage.
CMFCBaseTabCtrl::RecalcLayout Ricalcola il layout interno di una finestra a schede.
CMFCBaseTabCtrl::RemoveAllTabs Rimuove tutte le schede dalla finestra a schede.
CMFCBaseTabCtrl::RemoveTab Rimuove una scheda dalla finestra a schede.
CMFCBaseTabCtrl::RenameTab
CMFCBaseTabCtrl::ResetImageList Reimposta l'elenco di immagini che è collegato a una finestra a schede.
CMFCBaseTabCtrl::Serialize Legge o scrive l'oggetto corrente da o in un archivio. Esegue l'override di CObject::Serialize.
CMFCBaseTabCtrl::SetActiveTab Attiva una scheda.
CMFCBaseTabCtrl::SetActiveTabColor Imposta il colore di sfondo per la scheda attualmente attiva.
CMFCBaseTabCtrl::SetActiveTabTextColor Imposta il colore del testo per le schede attive.
CMFCBaseTabCtrl::SetAutoColors Imposta i colori di controllo della scheda che vengono applicati in modalità colore automatica.
CMFCBaseTabCtrl::SetDockingBarWrapperRTC Imposta la classe wrapper che viene usata per tutti gli oggetti che non sono derivati da CDockablePane Class.
CMFCBaseTabCtrl::SetDrawNoPrefix Abilita e disabilita l'elaborazione dei caratteri del prefisso quando vengono create le etichette delle schede.
CMFCBaseTabCtrl::SetImageList Imposta l'elenco di immagini icona.
CMFCBaseTabCtrl::SetLocation
CMFCBaseTabCtrl::SetTabBkColor Imposta il colore di sfondo di una scheda specificata.
CMFCBaseTabCtrl::SetTabBorderSize Imposta una nuova dimensione bordo scheda.
CMFCBaseTabCtrl::SetTabHicon Imposta l'icona di una scheda.
CMFCBaseTabCtrl::SetTabIcon Imposta l'ID icona di una scheda.
CMFCBaseTabCtrl::SetTabIconOnly Abilita e disabilita la modalità "solo icona" per una scheda specificata.
CMFCBaseTabCtrl::SetTabLabel Imposta l'etichetta di una scheda in modo che sia uguale a un valore stringa specificato.
CMFCBaseTabCtrl::SetTabsHeight
CMFCBaseTabCtrl::SetTabTextColor Restituisce il colore del testo per una scheda specificata.
CMFCBaseTabCtrl::SetTabsOrder Dispone le schede nell'ordine specificato.
CMFCBaseTabCtrl::ShowTab Mostra o nasconde la scheda specificata.
CMFCBaseTabCtrl::StartRenameTab
CMFCBaseTabCtrl::SwapTabs

Metodi protetti

Nome Descrizione
CMFCBaseTabCtrl::CreateWrapper Crea un wrapper per un oggetto derivato da CWnd che non deriva da CDockablePane. Per ancorare un oggetto CMFCBaseTabCtrl , ogni controllo incorporato deve includere un wrapper di ancoraggio o essere derivato da CDockablePane.

È possibile impostare la classe del wrapper usando SetDockingBayWrapperRTC.

Membri dei dati

Nome Descrizione
CMFCBaseTabCtrl::m_bActivateTabOnRightClick Specifica se le schede vengono selezionate facendo clic con il pulsante sinistro o destro del mouse.
CMFCBaseTabCtrl::m_bAutoDestroyWindow Specifica se i riquadri contenuti nelle schede vengono eliminati automaticamente.

Osservazioni:

La classe CMFCBaseTabCtrl è astratta. Di conseguenza, non è possibile crearne un'istanza. Per creare una finestra a schede, è necessario derivare una classe da CMFCBaseTabCtrl. La libreria MFC contiene alcuni esempi di classi derivate, due dei quali sono CMFCTabCtrl Class e CMFCOutlookBarTabCtrl Class.

A partire da Visual Studio 2015 questa classe supporta Microsoft Active Accessibility.

Suggerimenti per la personalizzazione

I suggerimenti seguenti riguardano CMFCBaseTabCtrl Class e tutte le classi che ereditano da essa:

  • Se si abilitano schede rimovibili, non mantenere i puntatori sulle finestre a schede. Queste schede rimovibili possono essere create ed eliminate in modo dinamico. Di conseguenza, i puntatori possono diventare non validi.

  • È possibile configurare il controllo Struttura a schede in modo che gli utenti possano spostare le schede in modo dinamico in un controllo Struttura a schede usando il mouse. Questa funzionalità è incorporata nella classe CMFCBaseTabCtrl . Per abilitarla, chiamare CMFCBaseTabCtrl::EnableTabSwap.

  • Per impostazione predefinita, le schede sono rimovibili quando vengono aggiunte a un controllo Struttura a schede. È anche possibile aggiungere schede non rimovibili usando CMFCBaseTabCtrl::AddTab. Se si imposta il parametro bDetachable su FALSE, la scheda non sarà rimovibile. È anche possibile attivare o disattivare la rimozione delle schede chiamando il metodo CMFCBaseTabCtrl::EnableTabDetach.

  • Gli oggetti derivati dalla classe CWnd possono essere inseriti in una barra di controllo ancorabile o in una scheda ancorabile. Affinché l'intero controllo sia ancorato, è necessario rendere ancorabile l'oggetto CWnd . A tale scopo, MFC usa una classe wrapper. Questa classe wrapper è CDockablePaneAdapter Class. Qualsiasi oggetto CWnd aggiunto a una barra di controllo o scheda ancorabile verrà incapsulato in un oggetto CDockablePaneAdapter . È possibile disabilitare il ritorno a capo automatico impostando il parametro m_bEnableWrapping dell'oggetto CMFCBaseTablCtrl su FALSE. È anche possibile modificare la classe che verrà usata come wrapper usando il metodo CMFCBaseTabCtrl::SetDockingBarWrapperRTC.

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

Requisiti

Intestazione: afxbasetabctrl.h

CMFCBaseTabCtrl::AddIcon

Aggiunge un'icona all'elenco di icone nel membro protetto CMap m_mapAddedIcons.

void AddIcon(
    HICON hIcon,
    int iIcon);

Parametri

hIcon
[in] Handle all'icona da aggiungere.

iIcon
[in] Indice in base zero dell'icona nel membro protetto CImageList m_Images.

Osservazioni:

CMFCBaseTabCtrl::AddTab

Aggiunge una nuova scheda al controllo Struttura a schede.

virtual void AddTab(
    CWnd* pTabWnd,
    LPCTSTR lpszTabLabel,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

virtual void AddTab(
    CWnd* pTabWnd,
    UINT uiResTabLabel,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

Parametri

pTabWnd
[in] Puntatore alla finestra rappresentata dal metodo come nuova scheda.

lpszTabLabel
[in] Stringa contenente l'etichetta per la nuova scheda.

uiImageId
[in] ID immagine nell'elenco di immagini. Il controllo Struttura a schede usa questa immagine come icona della nuova scheda.

uiResTabLabel
[in] ID risorsa dell'etichetta.

bDetachable
[in] Parametro booleano che determina se la nuova scheda è rimovibile.

Osservazioni:

Se pTabWnd punta a un oggetto non derivato dalla classe CDockablePane e se bDetachable è TRUE, il framework crea automaticamente un wrapper per l'oggetto pTabWnd. Il wrapper rende l'oggetto pTabWnd rimovibile. Per impostazione predefinita, il wrapper è un'istanza della classe CDockablePaneAdapter. Se la funzionalità offerta dal wrapper predefinito non è accettabile, usare il metodo CMFCBaseTabCtrl::SetDockingBarWrapperRTC per specificare un wrapper diverso.

CMFCBaseTabCtrl::ApplyRestoredTabInfo

virtual void ApplyRestoredTabInfo(BOOL bUseTabIndexes = FALSE);

Parametri

[in] bUseTabIndexes

Osservazioni:

CMFCBaseTabCtrl::AutoDestroyWindow

void AutoDestroyWindow(BOOL bAutoDestroy = TRUE);

Parametri

[in] bAutoDestroy

Osservazioni:

CMFCBaseTabCtrl::CalcRectEdit

virtual void CalcRectEdit(CRect& rectEdit);

Parametri

[in] rectEdit

Osservazioni:

CMFCBaseTabCtrl::CleanUp

virtual void CleanUp();

Osservazioni:

CMFCBaseTabCtrl::ClearImageList

virtual void ClearImageList();

Osservazioni:

CMFCBaseTabCtrl::CreateWrapper

Crea un wrapper per una finestra cornice derivato dalla classe CWnd ma non dalla classe CDockablePane.

virtual CWnd* CreateWrapper(
    CWnd* pWndToWrap,
    LPCTSTR lpszTabLabel,
    BOOL bDetachable);

Parametri

pWndToWrap
[in] Puntatore alla finestra cornice di cui viene eseguito il wrapping.

lpszTabLabel
[in] Stringa contenente l'etichetta per la finestra.

bDetachable
[in] Parametro booleano che indica se la finestra è rimovibile.

Valore restituito

Puntatore al wrapper derivato dalla classe CDockablePane se CreateWrapper crea correttamente una classe wrapper per pWndToWrap. Se il metodo ha esito negativo, restituisce pWndToWrap.

Osservazioni:

Una finestra a schede può ancorare qualsiasi oggetto derivato da CWnd. Tuttavia, affinché un oggetto CMFCBaseTabCtrl Class sia ancorabile, ogni oggetto in CMFCBaseTabCtrl deve essere rimovibile. Di conseguenza, CMFCBaseTabCtrl esegue automaticamente il wrapping di qualsiasi oggetto non derivato da CDockablePane.

Per impostazione predefinita, CMFCBaseTabCtrl crea un'istanza della classe CDockablePaneAdapter. Per cambiare la classe predefinita del wrapper, chiamare CMFCBaseTabCtrl::SetDockingBarWrapperRTC.

Se pWndToWrap è derivato da CDockablePane, questo metodo non crea un wrapper. Ha invece esito negativo e restituisce pWndToWrap.

CMFCBaseTabCtrl::DetachTab

Il framework chiama questo metodo per rimuovere una scheda dal controllo Struttura a schede.

virtual BOOL DetachTab(
    AFX_DOCK_METHOD dockMethod,
    int nTabNum = -1,
    BOOL bHide = FALSE);

Parametri

dockMethod
[in] Tipo di dati enumerato fornito dalla classe CBasePane. Questo tipo di dati specifica il metodo usato per rimuovere la scheda.

nTabNum
[in] Indice in base zero della scheda da rimuovere.

bHide
[in] Parametro booleano che indica se il framework deve nascondere la scheda rimossa.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Se la scheda specificata da nTabNum non è rimovibile, questa funzione non riesce e restituisce FALSE.

CMFCBaseTabCtrl::EnableActivateLastActive

void EnableActivateLastActive(BOOL bLastActive = TRUE);

Parametri

[in] bLastActive

Osservazioni:

CMFCBaseTabCtrl::EnableAutoColor

Controlla se il framework usa i colori di sfondo automatici per disegnare una scheda.

void EnableAutoColor(BOOL bEnable = TRUE);

Parametri

bEnable
[in] Parametro booleano che determina se il framework usa i colori automatici.

Osservazioni:

Un controllo Struttura a schede dispone di una matrice di diversi colori predefiniti. Quando il framework usa i colori automatici, a ogni scheda in una serie di schede viene assegnato il colore successivo di questa matrice.

Per impostazione predefinita, i colori automatici sono determinati dai colori definiti dalla libreria. È possibile specificare una matrice personalizzata di colori chiamando CMFCBaseTabCtrl::SetAutoColors.

CMFCBaseTabCtrl::EnableCustomToolTips

Abilita le descrizioni comandi personalizzate per il controllo Struttura a schede.

BOOL EnableCustomToolTips(BOOL bEnable = TRUE);

Parametri

bEnable
[in] Valore booleano che determina se usare le descrizioni comandi personalizzate.

Valore restituito

TRUE se l'operazione riesce; in caso contrario, FALSE.

Osservazioni:

Se le descrizioni comandi personalizzate sono abilitate, il controllo Struttura a schede invia il messaggio AFX_WM_ON_GET_TAB_TOOLTIP alla cornice principale. Per supportare le descrizioni comandi personalizzate nell'applicazione, la finestra cornice principale deve gestire questo metodo e fornire il testo della descrizione comando personalizzata. Per altre informazioni su come fornire questo testo, vedere Struttura CMFCTabToolTipInfo.

CMFCBaseTabCtrl::EnableInPlaceEdit

Abilita la modifica diretta delle etichette delle schede da parte dell'utente.

virtual void EnableInPlaceEdit(BOOL bEnable) = 0;

Parametri

bEnable
[in] Parametro booleano che specifica se abilitare la modifica diretta delle etichette delle schede.

Osservazioni:

Per impostazione predefinita, la modifica diretta delle etichette delle schede è disabilitata per i controlli Struttura a schede.

È possibile abilitare la modifica diretta per un subset delle schede nel controllo Struttura a schede. A questo scopo, eseguire l'override del metodo CMFCBaseTabCtrl::StartRenameTab. StartRenameTab dovrebbe restituire un valore diverso da zero per tutte le schede che supportano la modifica diretta delle etichette delle schede.

Nella CMFCBaseTabCtrl Class questo metodo è una funzione virtuale pura e non ha alcuna implementazione. Se si deriva una classe da CMFCBaseTabCtrl, è necessario implementare questa funzione.

CMFCBaseTabCtrl::EnableTabDetach

Abilita le schede rimovibili.

virtual BOOL EnableTabDetach(
    int iTab,
    BOOL bEnable);

Parametri

iTab
[in] Indice in base zero di una scheda.

bEnable
[in] Valore booleano che indica se rendere la scheda rimovibile.

Valore restituito

TRUE se l'operazione riesce; in caso contrario, FALSE.

CMFCBaseTabCtrl::EnableTabSwap

Consente all'utente di cambiare l'ordine delle schede con il mouse.

void EnableTabSwap(BOOL bEnable);

Parametri

bEnable
[in] Valore booleano che indica se abilitare lo scambio delle schede.

Osservazioni:

Quando lo scambio delle schede è abilitato, l'utente può trascinare una scheda e cambiarne la posizione relativa nel Controllo Struttura a schede.

CMFCBaseTabCtrl::EnsureVisible

Scorre schede fino a quando la scheda specificata è visibile.

virtual BOOL EnsureVisible(int iTab);

Parametri

iTab
[in] Indice in base zero di una scheda.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Questo metodo non ha alcun effetto se la scheda specificata da iTab è già visibile.

Per impostazione predefinita, questo metodo non è supportato dalla CMFCBaseTabCtrl Class. Occorre implementare questa funzione in una classe personalizzata derivata da CMFCBaseTabCtrl se il controllo Struttura a schede personalizzato supporta lo scorrimento delle schede. Questo metodo è supportato dalla classe CMFCTabCtrl.

CMFCBaseTabCtrl::EnterDragMode

void EnterDragMode();

Osservazioni:

CMFCBaseTabCtrl::FindTargetWnd

Identifica il riquadro contenente un punto specificato.

virtual CWnd* FindTargetWnd(const CPoint& pt) = 0;

Parametri

pt
[in] Punto che viene definito usando le coordinate client-area dell'oggetto CMFCBaseTabCtrl.

Valore restituito

Puntatore a un oggetto CWnd in caso di esito positivo, NULL in caso contrario.

Osservazioni:

Nella classe CMFCBaseTabCtrl questo metodo è una funzione virtuale pura: è necessario implementarlo se si deriva una classe da CMFCBaseTabCtrl.

CMFCBaseTabCtrl::FireChangeActiveTab

virtual void FireChangeActiveTab(int nNewTab);

Parametri

[in] nNewTab

Osservazioni:

CMFCBaseTabCtrl::FireChangingActiveTab

virtual BOOL FireChangingActiveTab(int nNewTab);

Parametri

[in] nNewTab

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::GetActiveTab

Recupera l'indice della scheda attualmente attiva.

virtual int GetActiveTab() const;

Valore restituito

Indice in base zero della scheda attiva, -1 in assenza di una scheda attiva.

CMFCBaseTabCtrl::GetActiveTabColor

Recupera il colore di sfondo della scheda attualmente attiva.

virtual COLORREF GetActiveTabColor() const;

Valore restituito

Valore COLORREF che specifica il colore di sfondo della scheda attiva.

Osservazioni:

Per impostazione predefinita, il colore di sfondo della scheda attiva è COLOR_WINDOW. È possibile cambiare il colore di sfondo della scheda attiva usando il metodo CMFCBaseTabCtrl::SetActiveTabColor.

CMFCBaseTabCtrl::GetActiveTabTextColor

Recupera il colore del testo della scheda attiva.

virtual COLORREF GetActiveTabTextColor() const;

Valore restituito

Valore COLORREF che specifica il colore del testo della scheda attiva.

Osservazioni:

Per impostazione predefinita, il colore del testo della scheda attiva è COLOR_WINDOWTEXT. È possibile cambiare il colore del testo con il metodo CMFCBaseTabCtrl::SetActiveTabTextColor.

CMFCBaseTabCtrl::GetActiveWnd

Recupera un puntatore alla finestra della scheda attualmente attiva.

virtual CWnd* GetActiveWnd() const;

Valore restituito

Puntatore a una finestra.

CMFCBaseTabCtrl::GetAutoColors

Recupera la matrice dei colori usati per la colorazione automatica.

const CArray<COLORREF,COLORREF>& GetAutoColors() const;

Valore restituito

Riferimento a una matrice di valori COLORREF usati dall'oggetto CMFCBaseTabCtrl per la colorazione automatica delle schede.

Osservazioni:

Per impostazione predefinita, il framework inizializza la matrice di colori su colori definiti dalla libreria. È possibile specificare una matrice personalizzata di colori chiamando il metodo CMFCBaseTabCtrl::SetAutoColors.

CMFCBaseTabCtrl::GetFirstVisibleTab

Recupera un puntatore alla prima scheda visibile.

virtual CWnd* GetFirstVisibleTab(int& iTabNum);

virtual CWnd* GetFirstVisibleTab(
    int iStartFrom,
    int& iTabNum);

Parametri

iTabNum
[out] Riferimento a un intero. Il metodo scrive l'indice in base zero della prima scheda visibile in questo parametro.

iStartFrom
[in] Indice in base zero della prima scheda da controllare.

Valore restituito

Puntatore alla prima scheda visibile in caso di esito positivo, NULL in caso contrario.

Osservazioni:

Se il metodo non riesce, scrive il valore -1 in iStartFrom.

Se iStartFrom è maggiore o uguale al numero di schede nel controllo Struttura a schede, GetFirstVisibleTab non riesce automaticamente.

CMFCBaseTabCtrl::GetFirstVisibleTabNum

virtual int GetFirstVisibleTabNum() const;

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::GetHighlightedTab

Recupera l'indice della scheda attualmente evidenziata.

int GetHighlightedTab() const;

Valore restituito

Indice in base zero della scheda evidenziata.

CMFCBaseTabCtrl::GetImageList

virtual const CImageList* GetImageList() const;

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::GetImageSize

virtual CSize GetImageSize() const;

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::GetLastVisibleTab

virtual CWnd* GetLastVisibleTab(int& iTabNum);

Parametri

[in] iTabNum

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::GetLocation

Recupera la posizione della parte dell'area delle schede del controllo Struttura a schede.

Location GetLocation() const;

Valore restituito

Posizione dell'area delle schede.

Osservazioni:

I valori possibili per la posizione dell'area delle schede sono LOCATION_BOTTOM e LOCATION_TOP.

CMFCBaseTabCtrl::GetMaxWindowSize

virtual CSize GetMaxWindowSize() const;

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::GetTabArea

Recupera le dimensioni e la posizione dell'area delle schede del controllo Struttura a schede.

virtual void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const = 0;

Parametri

rectTabAreaTop
[in] Riferimento a un oggetto CRect. GetTabArea usa questo oggetto per memorizzare le dimensioni e la posizione dell'area delle schede superiore.

rectTabAreaBottom
[in] Riferimento a un oggetto CRect. GetTabArea usa questo oggetto per memorizzare le dimensioni e la posizione dell'area delle schede inferiore.

Osservazioni:

Dopo la restituzione del risultato di GetTabArea, i parametri CRect contengono le dimensioni e la posizione dell'area delle schede nelle coordinate client del controllo Struttura a schede. Se nella parte superiore o inferiore del controllo Struttura a schede non è presente un'area delle schede, rectTabAreaTop o rectTabAreaBottom è vuoto.

Nella CMFCBaseTabCtrl Class questo metodo è una funzione virtuale pura e non ha alcuna implementazione. Se si deriva una classe da CMFCBaseTabCtrl, occorre implementare questa funzione.

CMFCBaseTabCtrl::GetTabBkColor

Recupera il colore di sfondo della scheda specificata.

virtual COLORREF GetTabBkColor(int iTab) const;

Parametri

iTab
[in] Indice in base zero della scheda.

Valore restituito

Valore COLORREF che indica il colore di sfondo della scheda specificata; -1 se iTab non è compreso nell'intervallo.

CMFCBaseTabCtrl::GetTabBorderSize

Recupera le dimensioni dei bordi della scheda nel controllo Struttura a schede.

virtual int GetTabBorderSize() const;

Valore restituito

Dimensioni del bordo della scheda, in pixel.

Osservazioni:

Le dimensioni predefinite del bordo della scheda son pari a 3 pixel. È possibile cambiarle con il metodo CMFCBaseTabCtrl::SetTabBorderSize.

CMFCBaseTabCtrl::GetTabByID

Recupera l'indice di una scheda in base a un ID scheda.

virtual int GetTabByID(int id) const;

Parametri

id
[in] ID di una scheda.

Valore restituito

Indice in base zero di una scheda se l'ID della scheda viene trovato, -1 in caso contrario.

Osservazioni:

Gli ID scheda vengono assegnati automaticamente quando le schede vengono aggiunte al controllo Struttura a schede.

CMFCBaseTabCtrl::GetTabCloseButton

CRect GetTabCloseButton() const;

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::GetTabFromHwnd

Recupera l'indice della scheda che contiene l'oggetto HWND specificato.

virtual int GetTabFromHwnd(HWND hwnd) const;

Parametri

hwnd
[in] Handle a una finestra.

Valore restituito

Indice in base zero della scheda in caso di esito positivo, -1 se nessuna scheda contiene hwnd.

CMFCBaseTabCtrl::GetTabFromPoint

Recupera la scheda contenente un punto specificato.

virtual int GetTabFromPoint(CPoint& pt) const;

Parametri

pt
[in] Punto nelle coordinate client del controllo Struttura a schede.

Valore restituito

Indice della scheda che contiene pt, -1 se nessuna scheda contiene pt.

CMFCBaseTabCtrl::GetTabFullWidth

virtual int GetTabFullWidth(int iTab) const;

Parametri

[in] iTab

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::GetTabHicon

Restituisce l'oggetto HICON associato alla scheda specificata.

virtual HICON GetTabHicon(int iTab) const;

Parametri

iTab
[in] Indice in base zero della scheda.

Valore restituito

Oggetto HICON associato a un'etichetta di scheda in caso di esito positivo, NULL in assenza di un HICON o se il metodo non riesce.

CMFCBaseTabCtrl::GetTabIcon

Recupera l'icona associata alla scheda specificata.

virtual UINT GetTabIcon(int iTab) const;

Parametri

iTab
[in] Indice in base zero della scheda.

Valore restituito

ID icona della scheda specificata in caso di esito positivo, -1 se l'indice non è valido.

Osservazioni:

L'oggetto CMFCBaseTabCtrl archivia le icone nell'oggetto interno CImageList.

CMFCBaseTabCtrl::GetTabID

Recupera l'ID di una scheda specificato dall'indice della scheda.

int GetTabID(int iTab) const;

Parametri

iTab
[in] Indice in base zero della scheda.

Valore restituito

ID della scheda o -1 se iTab non è compreso nell'intervallo.

CMFCBaseTabCtrl::GetTabLabel

Recupera il testo dell'etichetta di una scheda.

virtual BOOL GetTabLabel(
    int iTab,
    CString& strLabel) const;

Parametri

iTab
[in] Indice in base zero della scheda.

strLabel
[out] Riferimento a un oggetto CString. Questo metodo archivia l'etichetta della scheda in questo parametro.

Valore restituito

TRUE in caso di esito positivo, FALSE in caso contrario.

Osservazioni:

Il metodo non riesce se l'indice iTab non è valido.

L'etichetta di una scheda si imposta quando si crea la scheda mediante CMFCBaseTabCtrl::AddTab. Dopo la creazione è possibile modificare l'etichetta con il metodo CMFCBaseTabCtrl::SetTabLabel.

CMFCBaseTabCtrl::GetTabRect

Recupera le dimensioni e la posizione della scheda specificata.

virtual BOOL GetTabRect(
    int iTab,
    CRect& rect) const;

Parametri

iTab
[in] Indice in base zero della scheda.

rect
[out] Riferimento a un oggetto CRect. Questo metodo archivia le dimensioni e la posizione della scheda in questo parametro.

Valore restituito

TRUE in caso di esito positivo, FALSE se l'indice della scheda non è valido.

CMFCBaseTabCtrl::GetTabsHeight

virtual int GetTabsHeight() const;

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::GetTabsNum

Recupera il numero di schede nel controllo Struttura a schede.

virtual int GetTabsNum() const;

Valore restituito

Numero di schede nel controllo Struttura a schede.

CMFCBaseTabCtrl::GetTabsRect

virtual void GetTabsRect(CRect& rect) const;

Parametri

[in] rect

Osservazioni:

CMFCBaseTabCtrl::GetTabTextColor

Recupera il colore del testo della scheda specificata.

virtual COLORREF GetTabTextColor(int iTab) const;

Parametri

iTab
[in] Indice in base zero della scheda.

Valore restituito

Parametro COLORREF che indica il colore del testo della scheda specificata; -1 se iTab non è compreso nell'intervallo.

CMFCBaseTabCtrl::GetTabWnd

Restituisce il puntatore al riquadro che si trova sulla scheda specificata.

virtual CWnd* GetTabWnd(int iTab) const;

Parametri

iTab
[in] Indice in base zero di una scheda.

Valore restituito

Puntatore all'oggetto CWnd che si trova sulla scheda specificata da iTab. NULL se il valore di iTab non è valido.

Osservazioni:

L'oggetto restituito è quello aggiunto dall'applicazione al momento della chiamata a CMFCBaseTabCtrl::AddTab o CMFCBaseTabCtrl::InsertTab.

Se l'oggetto in una scheda ha un wrapper, il metodo restituirà il wrapper dell'oggetto. Per altre informazioni sui wrapper, vedere CMFCBaseTabCtrl::CreateWrapper. Se si vuole accedere a un puntatore all'oggetto diretto senza il wrapper, usare il metodo CMFCBaseTabCtrl::GetTabWndNoWrapper.

CMFCBaseTabCtrl::GetTabWndNoWrapper

Restituisce un puntatore al controllo che si trova su una scheda, anche se il controllo dispone di un wrapper.

virtual CWnd* GetTabWndNoWrapper(int iTab) const;

Parametri

iTab
[in] Indice in base zero di una scheda.

Valore restituito

Puntatore all'oggetto CWnd che si trova sulla scheda specificata; NULL se iTab non è valido.

Osservazioni:

Questo metodo recupera un puntatore diretto all'oggetto CWnd aggiunto tramite il metodo CMFCBaseTabCtrl::AddTab o CMFCBaseTabCtrl::InsertTab. GetTabWndNoWrapper recupera un puntatore all'oggetto CWnd aggiunto, anche se il framework ha aggiunto un wrapper per l'oggetto. Per altre informazioni sui wrapper e sulla classe CMFCBaseTabCtrl, vedere CMFCBaseTabCtrl::CreateWrapper.

Usare il metodo CMFCBaseTabCtrl::GetTabWnd se non si vuole ignorare la classe wrapper.

CMFCBaseTabCtrl::GetToolTipCtrl

Recupera un riferimento al controllo descrizione comando.

CToolTipCtrl& GetToolTipCtrl() const;

Valore restituito

Riferimento al controllo descrizione comando.

CMFCBaseTabCtrl::GetVisibleTabsNum

Recupera il numero di schede attualmente visibili.

virtual int GetVisibleTabsNum() const;

Valore restituito

Numero delle schede visibili.

CMFCBaseTabCtrl::HasImage

virtual BOOL HasImage(int iTab) const;

Parametri

[in] iTab

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::HideSingleTab

Imposta l'opzione per nascondere le schede del controllo Struttura a schede quando è presente una scheda visibile.

virtual void HideSingleTab(BOOL bHide = TRUE);

Parametri

bHide
[in] Valore booleano che specifica se abilitare l'opzione per nascondere singole schede.

Osservazioni:

Quando l'applicazione è configurata per nascondere singole schede, il framework visualizza automaticamente le schede quando viene aggiunta una seconda scheda al controllo Struttura a schede.

CMFCBaseTabCtrl::InsertTab

Inserisce una scheda nel controllo Struttura a schede.

Virtual void InsertTab(
    CWnd* pNewWnd,
    LPCTSTR lpszTabLabel,
    int nInsertAt,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

virtual void InsertTab(
    CWnd* pNewWnd,
    UINT uiResTabLabel,
    int nInsertAt,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

Parametri

pNewWnd
[in] Puntatore alla finestra aggiunta dal metodo come nuova scheda.

lpszTabLabel
[in] Stringa contenente l'etichetta per la nuova scheda.

nInsertAt
[in] Indice in base zero della nuova scheda.

uiImageId
[in] ID immagine nell'elenco di immagini. Il controllo Struttura a schede usa questa immagine come icona della nuova scheda.

bDetachable
[in] Parametro booleano che determina se la nuova scheda è rimovibile.

uiResTabLabel
[in] ID risorsa dell'etichetta.

Osservazioni:

Se l'oggetto indicato da pNewWnd non è derivato dalla classe CDockablePane e se il parametro bDetachable è TRUE, il framework crea un wrapper speciale per la nuova scheda. Per impostazione predefinita, il wrapper è un'istanza della classe CDockablePaneAdapter. Usare il metodo CMFCBaseTabCtrl::SetDockingBarWrapperRTC per creare una classe wrapper diversa. Tutte le classi wrapper devono essere derivate da CDockablePaneAdapter.

CMFCBaseTabCtrl::InvalidateTab

void InvalidateTab(int iTab);

Parametri

[in] iTab

Osservazioni:

CMFCBaseTabCtrl::IsActiveTabCloseButton

virtual BOOL IsActiveTabCloseButton() const;

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::IsAutoColor

Determina se il controllo Struttura a schede è in modalità di colorazione automatica.

BOOL IsAutoColor() const;

Valore restituito

TRUE se il controllo Struttura a schede è in modalità di colorazione automatica, FALSE in caso contrario.

Osservazioni:

È possibile abilitare o disabilitare la modalità di colorazione automatica tramite il metodo CMFCBaseTabCtrl::EnableAutoColor.

CMFCBaseTabCtrl::IsAutoDestroyWindow

BOOL IsAutoDestroyWindow() const;

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::IsColored

virtual BOOL IsColored() const;

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::IsDialogControl

BOOL IsDialogControl() const;

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::IsDrawNoPrefix

BOOL IsDrawNoPrefix() const;

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::IsFlatFrame

Indica se il rendering della cornice del controllo Struttura a schede viene eseguito in stile bidimensionale o 3D.

virtual BOOL IsFlatFrame() const;

Valore restituito

TRUE se il rendering della cornice del controllo Struttura a schede viene eseguito in stile bidimensionale, FALSE se viene eseguito in stile 3D.

Osservazioni:

Usare CMFCTabCtrl::SetFlatFrame per cambiare lo stile della cornice del controllo Struttura a schede.

Non è possibile eseguire il rendering con cornici bidimensionali di controlli Struttura a schede che usano lo stile di Outlook. Sono incluse la classe CMFCOutlookBarTabCtrl e tutte le classi derivate da tale classe.

CMFCBaseTabCtrl::IsFlatTab

virtual BOOL IsFlatTab() const;

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::IsHideSingleTab

Determina se il controllo Struttura a schede nasconde l'etichetta della scheda, se è presente una sola scheda.

virtual BOOL IsHideSingleTab() const;

Valore restituito

TRUE se il controllo Struttura a schede nasconde l'etichetta della scheda quando è presente una sola scheda, FALSE in caso contrario.

Osservazioni:

Usare il metodo CMFCBaseTabCtrl::HideSingleTab per consentire di nascondere l'etichetta della scheda quando è presente una sola scheda.

CMFCBaseTabCtrl::IsIconAdded

BOOL IsIconAdded(
    HICON hIcon,
    int& iIcon);

Parametri

[in] hIcon

[in] iIcon

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::IsInPlaceEdit

Indica se il controllo Struttura a schede è configurato in modo da consentire all'utente di modificare dinamicamente le etichette delle schede.

virtual BOOL IsInPlaceEdit() const;

Valore restituito

Valore diverso da zero se la modifica sul posto è abilitata, 0 in caso contrario.

Osservazioni:

È possibile abilitare o disabilitare la modifica sul posto chiamando il metodo CMFCBaseTabCtrl::EnableInPlaceEdit.

CMFCBaseTabCtrl::IsLeftRightRounded

virtual BOOL IsLeftRightRounded() const;

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::IsMDITab

BOOL IsMDITab() const;

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::IsOneNoteStyle

Determina se le schede vengono visualizzate nello stile di Microsoft OneNote.

virtual BOOL IsOneNoteStyle() const;

Valore restituito

TRUE se le schede vengono visualizzate nello stile di Microsoft OneNote, FALSE in caso contrario.

Osservazioni:

Chiamare il metodo CMDIFrameWndEx::EnableMDITabs per abilitare lo stile di Microsoft OneNote. È possibile abilitare questo stile anche quando si crea un'istanza della classe CMFCTabCtrl, semplicemente passando lo stile STYLE_3D_ONENOTE al metodo CMFCTabCtrl::Create.

Per impostazione predefinita, lo stile di Microsoft OneNote non è supportato in una classe personalizzata derivata dalla CMFCBaseTabCtrl Class. È invece supportato nella classe CMFCTabCtrl.

CMFCBaseTabCtrl::IsPtInTabArea

Determina se un punto è all'interno dell'area delle schede.

virtual BOOL IsPtInTabArea(CPoint point) const = 0;

Parametri

point
[in] Punto da testare.

Valore restituito

Valore diverso da zero se il punto è all'interno dell'area delle schede, 0 in caso contrario.

Osservazioni:

Nella CMFCBaseTabCtrl Class questo metodo è una funzione virtuale pura e non ha alcuna implementazione. Se si deriva una classe da CMFCBaseTabCtrl, occorre implementare questa funzione.

CMFCBaseTabCtrl::IsTabCloseButtonHighlighted

BOOL IsTabCloseButtonHighlighted() const;

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::IsTabCloseButtonPressed

BOOL IsTabCloseButtonPressed() const;

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::IsTabDetachable

Determina se una scheda è rimovibile.

virtual BOOL IsTabDetachable(int iTab) const;

Parametri

iTab
[in] Indice in base zero della scheda da controllare.

Valore restituito

TRUE se la scheda è rimovibile, FALSE in caso contrario.

Osservazioni:

Per rendere una scheda rimovibile, usare il metodo CMFCBaseTabCtrl::EnableTabDetach.

CMFCBaseTabCtrl::IsTabIconOnly

Determina se l'etichetta di una scheda contiene solo icone e nessun testo.

virtual BOOL IsTabIconOnly(int iTab) const;

Parametri

iTab
[in] Indice in base zero della scheda.

Valore restituito

TRUE se l'etichetta di una scheda contiene solo icone, FALSE in caso contrario.

Osservazioni:

Per impostare le schede dell'applicazione in modo che visualizzino solo icone, chiamare il metodo CMFCBaseTabCtrl::SetTabIconOnly.

CMFCBaseTabCtrl::IsTabSwapEnabled

Determina se il controllo Struttura a schede consente all'utente di cambiare la posizione delle schede usando il mouse.

BOOL IsTabSwapEnabled() const;

Valore restituito

Valore diverso da zero se la posizione delle schede può essere cambiata dall'utente, 0 in caso contrario.

Osservazioni:

Per impostazione predefinita, gli utenti non possono cambiare l'ordine delle schede in un controllo Struttura a schede. Usare il metodo CMFCBaseTabCtrl::EnableTabSwap per abilitare questa funzionalità.

CMFCBaseTabCtrl::IsTabVisible

Indica se la scheda specificata è visibile.

virtual BOOL IsTabVisible(int iTab) const;

Parametri

iTab
[in] Indice in base zero della scheda da controllare.

Valore restituito

Valore diverso da zero se la scheda specificata è visibile, 0 in caso contrario.

CMFCBaseTabCtrl::IsVS2005Style

virtual BOOL IsVS2005Style() const;

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::m_bActivateTabOnRightClick

m_bActivateTabOnRightClick determina se le schede sono nello stato attivo quando l'utente fa clic sull'etichetta di una scheda con il pulsante destro del mouse.

BOOL m_bActivateTabOnRightClick;

Osservazioni:

Il valore predefinito per questo membro dati è FALSE.

CMFCBaseTabCtrl::m_bAutoDestroyWindow

m_bAutoDestroyWindow determina se il framework elimina definitivamente e automaticamente gli oggetti nelle schede quando queste vengono rimosse.

BOOL m_bAutoDestroyWindow;

Osservazioni:

Per impostazione predefinita, questo membro è FALSE.

CMFCBaseTabCtrl::MoveTab

virtual void MoveTab(
    int nSource,
    int nDest);

Parametri

[in] nSource

[in] nDest

Osservazioni:

CMFCBaseTabCtrl::OnChangeTabs

Il framework chiama questo metodo quando cambia il numero di schede in un controllo Struttura a schede.

virtual void OnChangeTabs();

Osservazioni:

Per impostazione predefinita, questo metodo non effettua alcuna operazione. Eseguire l'override del metodo per eseguire codice personalizzato quando cambia il numero di schede in un controllo Struttura a schede.

CMFCBaseTabCtrl::OnDrop

virtual BOOL OnDrop(
    COleDataObject*,
    DROPEFFECT,
    CPoint);

Parametri

[in] COleDataObject*

[in] DROPEFFECT

[in] CPoint

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::OnDragOver

virtual DROPEFFECT OnDragOver(
    COleDataObject*,
    DWORD,
    CPoint);

Parametri

[in] COleDataObject*

[in] DWORD

[in] CPoint

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::OnDragLeave

virtual void OnDragLeave();

Osservazioni:

CMFCBaseTabCtrl::OnDragEnter

virtual DROPEFFECT OnDragEnter(
    COleDataObject*,
    DWORD,
    CPoint);

Parametri

[in] COleDataObject*

[in] DWORD

[in] CPoint

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::OnRenameTab

virtual BOOL OnRenameTab(int, CString&);

Parametri

[in] int

[in] CString&

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::PreTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parametri

[in] pMsg

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::RecalcLayout

Ricalcola il layout interno del controllo Struttura a schede.

virtual void RecalcLayout() = 0;

Osservazioni:

Nella CMFCBaseTabCtrl Class questo metodo è una funzione virtuale pura. Se si deriva una classe da CMFCBaseTabCtrl, occorre implementare questa funzione.

CMFCBaseTabCtrl::RemoveAllTabs

Rimuove tutte le schede dal controllo Struttura a schede.

virtual void RemoveAllTabs();

Osservazioni:

Se CMFCBaseTabCtrl::m_bAutoDestroyWindow è TRUE, il framework elimina tutti gli oggetti CWnd associati alle schede rimosse.

CMFCBaseTabCtrl::RemoveTab

Elimina una scheda dal controllo Struttura a schede.

virtual BOOL RemoveTab(
    int iTab,
    BOOL bRecalcLayout = TRUE);

Parametri

iTab
[in] Indice in base zero di una scheda.

bRecalcLayout
[in] Parametro booleano che specifica se ricalcolare il layout della scheda.

Valore restituito

TRUE se il metodo elimina la scheda correttamente, FALSE in caso contrario.

Osservazioni:

Se CMFCBaseTabCtrl::m_bAutoDestroyWindow è TRUE, RemoveTab elimina definitivamente l'oggetto CWnd associato alla scheda specificata.

CMFCBaseTabCtrl::RenameTab

virtual BOOL RenameTab();

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::ResetImageList

Reimposta l'elenco di immagini per un'istanza della classe CMFCBaseTabCtrl.

void ResetImageList();

CMFCBaseTabCtrl::Serialize

virtual void Serialize(CArchive& ar);

Parametri

[in] ar

Osservazioni:

CMFCBaseTabCtrl::SetActiveTab

Attiva la scheda specificata.

virtual BOOL SetActiveTab(int iTab) = 0;

Parametri

iTab
[in] Indice in base zero di una scheda. SetActiveTab imposta come attiva la scheda con questo indice.

Valore restituito

TRUE se l'operazione riesce; in caso contrario, FALSE.

Osservazioni:

Nella CMFCBaseTabCtrl Class questo metodo è una funzione virtuale pura. Se si deriva una classe da CMFCBaseTabCtrl, occorre implementare questa funzione.

CMFCBaseTabCtrl::SetActiveTabColor

Imposta il colore di sfondo della scheda attiva.

virtual void SetActiveTabColor(COLORREF clr);

Parametri

clr
[in] Specifica il nuovo colore di sfondo.

Osservazioni:

Il framework ottiene il colore di sfondo predefinito delle schede attive dal metodo GetSysColor.

CMFCBaseTabCtrl::SetActiveTabTextColor

Imposta il colore del testo per le schede attive.

virtual void SetActiveTabTextColor(COLORREF clr);

Parametri

clr
[in] Parametro COLORREF che specifica il nuovo colore del testo.

Osservazioni:

Per impostazione predefinita, il framework ottiene il colore del testo da GetSysColor. Eseguire l'override di questo colore predefinito usando il metodo SetActiveTabTextColor.

CMFCBaseTabCtrl::SetAutoColors

Imposta i colori del controllo Struttura a schede usati dal framework in modalità di colorazione automatica.

void SetAutoColors(const CArray<COLORREF,COLORREF>& arColors);

Parametri

arColors
[in] Matrice di colori RGB.

Osservazioni:

Se si specifica una matrice personalizzata di colori, la matrice di colori predefinita viene ignorata. Se il parametro arColors è vuoto, il framework ripristina la matrice di colori predefinita.

Per abilitare la modalità di colorazione automatica, usare il metodo CMFCBaseTabCtrl::EnableAutoColor.

CMFCBaseTabCtrl::SetDockingBarWrapperRTC

Imposta la classe wrapper che viene usata per tutti gli oggetti che non sono derivati da CDockablePane Class.

void SetDockingBarWrapperRTC(CRuntimeClass* pRTC);

Parametri

pRTC
[in] Informazioni sulla classe di runtime per la nuova classe wrapper.

Osservazioni:

Per aggiungere schede a un controllo Struttura a schede si usano i metodi CMFCBaseTabCtrl::AddTab e CMFCBaseTabCtrl::InsertTab. Quando si aggiunge una scheda, ogni controllo in tale scheda deve essere ancorabile. È necessario eseguire il wrapping di tutti gli oggetti non derivati da CDockablePane. AddTab e InsertTab creano un wrapper per questi oggetti. La classe wrapper predefinita è la classe CDockablePaneAdapter. Il metodo SetDockingBarWrapperRTC consente di cambiare la classe usata come classe wrapper. La classe wrapper specificata deve essere una classe derivata da CDockablePaneAdapter.

CMFCBaseTabCtrl::SetDrawNoPrefix

Abilita e disabilita l'elaborazione dei caratteri di prefisso nelle etichette delle schede.

void SetDrawNoPrefix(
    BOOL bNoPrefix,
    BOOL bRedraw = TRUE);

Parametri

bNoPrefix
[in] TRUE se si vuole elaborare i caratteri di prefisso, FALSE in caso contrario.

bRedraw
[in] TRUE se si vuole ridisegnare la finestra a schede, FALSE in caso contrario.

Osservazioni:

Un carattere di prefisso è un carattere mnemonico preceduto da una e commerciale (&).

CMFCBaseTabCtrl::SetImageList

Imposta l'elenco di immagini delle icone per il controllo Struttura a schede.

virtual BOOL SetImageList(
    UINT uiID,
    int cx = 15,
    COLORREF clrTransp = RGB(255, 0, 255));

virtual BOOL SetImageList(HIMAGELIST hImageList);

Parametri

uiID
[in] ID di risorsa bitmap. SetImageList carica l'elenco di immagini da questa risorsa.

cx
[in] Larghezza di ogni immagine in pixel.

clrTransp
[in] Parametro COLORREF che indica il colore trasparente dell'immagine.

hImageList
[in] Handle a un elenco di immagini precaricato.

Valore restituito

Valore diverso da zero se il metodo riesce, 0 in caso contrario.

Osservazioni:

Le immagini dell'elenco di immagini icona vengono visualizzate insieme alle etichette per la scheda. Per visualizzare un'icona, è necessario specificarne l'indice quando si chiama CMFCBaseTabCtrl::AddTab.

Se il controllo Struttura a schede è stato creato con uno stile bidimensionale, SetImageList non riesce. Non riesce nemmeno se il framework non è in grado di caricare l'immagine indicata da uiID.

Questo metodo ricalcola l'altezza della scheda in base alle dimensioni dell'immagine e del testo.

CMFCBaseTabCtrl::SetLocation

virtual void SetLocation(Location location);

Parametri

[in] location

Osservazioni:

CMFCBaseTabCtrl::SetTabBkColor

Imposta il colore di sfondo della scheda specificata.

virtual BOOL SetTabBkColor(
    int iTab,
    COLORREF color = (COLORREF)-1);

Parametri

iTab
[in] Indice in base zero della scheda.

color
[in] Colore da impostare.

Valore restituito

TRUE in caso di esito positivo, FALSE in caso contrario.

CMFCBaseTabCtrl::SetTabBorderSize

Imposta nuove dimensioni del bordo per il controllo Struttura a schede.

virtual void SetTabBorderSize(
    int nTabBorderSize,
    BOOL bRepaint = TRUE);

Parametri

nTabBorderSize
[in] Nuove dimensioni del bordo, in pixel.

bRepaint
[in] Parametro booleano che indica se il framework ridisegna il controllo.

CMFCBaseTabCtrl::SetTabHicon

Imposta l'icona per l'etichetta di una scheda.

virtual BOOL SetTabHicon(
    int iTab,
    HICON hIcon);

Parametri

iTab
[in] Indice in base zero di una scheda. Questo metodo modifica l'icona per questa scheda.

hIcon
[in] Handle a un'icona.

Valore restituito

TRUE se l'operazione riesce; in caso contrario, FALSE.

CMFCBaseTabCtrl::SetTabIcon

Imposta l'icona per una scheda.

virtual BOOL SetTabIcon(
    int iTab,
    UINT uiIcon);

Parametri

iTab
[in] Indice in base zero della scheda da aggiornare.

uiIcon
[in] ID della nuova icona. Questo ID fa riferimento all'oggetto interno CImageList.

Valore restituito

TRUE se l'operazione riesce; in caso contrario, FALSE.

CMFCBaseTabCtrl::SetTabIconOnly

Consente di visualizzare solo un'icona (senza etichetta di testo) su una scheda specifica.

virtual BOOL SetTabIconOnly(
    int iTab,
    BOOL bIconOnly = TRUE,
    BOOL bShowTooltipAlways = FALSE);

Parametri

iTab
[in] Indice in base zero della scheda da cambiare.

bIconOnly
[in] Parametro booleano che determina se visualizzare solo le icone.

bShowTooltipAlways
[in] Parametro booleano che determina se il framework mostra le descrizioni comandi per l'etichetta di una scheda che visualizza solo le icone.

Valore restituito

TRUE se l'operazione riesce; in caso contrario, FALSE.

Osservazioni:

Per impostazione predefinita, un controllo Struttura a schede visualizza l'icona e l'etichetta di testo di ogni scheda.

CMFCBaseTabCtrl::SetTabLabel

Imposta il testo per l'etichetta di una scheda.

virtual BOOL SetTabLabel(
    int iTab,
    const CString& strLabel);

Parametri

iTab
[in] Indice in base zero della scheda da aggiornare.

strLabel
[in] Riferimento a una stringa che contiene il nuovo testo dell'etichetta della scheda.

Valore restituito

Valore diverso da zero in caso di esito positivo, 0 in caso contrario.

CMFCBaseTabCtrl::SetTabsHeight

virtual void SetTabsHeight();

Osservazioni:

CMFCBaseTabCtrl::SetTabsOrder

Dispone le schede nell'ordine specificato.

BOOL SetTabsOrder(const CArray<int,int>& arOrder);

Parametri

arOrder
[in] Matrice di indici in base zero che definisce il nuovo ordine delle schede.

Valore restituito

TRUE in caso di esito positivo, FAIL in caso contrario.

Osservazioni:

Le dimensioni della matrice arOrder devono essere uguali al numero di schede nel controllo Struttura a schede.

CMFCBaseTabCtrl::SetTabTextColor

Imposta il colore del testo per una scheda specificata.

virtual BOOL SetTabTextColor(
    int iTab,
    COLORREF color = (COLORREF)-1);

Parametri

iTab
[in] Indice in base zero della scheda.

color
[in] Parametro COLORREF che indica il nuovo colore del testo.

Valore restituito

Valore diverso da zero in caso di esito positivo, 0 in caso contrario.

CMFCBaseTabCtrl::ShowTab

Mostra o nasconde la scheda specificata.

virtual BOOL ShowTab(
    int iTab,
    BOOL bShow = TRUE,
    BOOL bRecalcLayout = TRUE,
    BOOL bActivate = FALSE);

Parametri

iTab
[in] Indice della scheda che ShowTab mostrerà o nasconderà.

bShow
[in] Parametro booleano che indica se mostrare la scheda.

bRecalcLayout
[in] Parametro booleano che indica se ricalcolare immediatamente il layout della finestra.

bActivate
[in] Parametro booleano che indica se selezionare la scheda specificata da iTab.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Il parametro bActivate si applica solo se bShow è TRUE. Se bActivate è TRUE e ShowTab riesce, ShowTab invierà il messaggio AFX_WM_CHANGE_ACTIVE_TAB al padre della finestra della scheda.

CMFCBaseTabCtrl::StartRenameTab

virtual BOOL StartRenameTab(int iTab);

Parametri

[in] iTab

Valore restituito

Osservazioni:

CMFCBaseTabCtrl::SwapTabs

virtual void SwapTabs(
    int nFisrtTabID,
    int nSecondTabID);

Parametri

[in] nFisrtTabID

[in] nSecondTabID

Osservazioni:

Vedi anche

Grafico della gerarchia
Classi
Classe CMFCTabCtrl
Classe CMFCOutlookBarTabCtrl