Condividi tramite

Classe CMFCTabCtrl

  • Articolo

La CMFCTabCtrl classe fornisce funzionalità per un controllo struttura a schede. Il controllo scheda visualizza una finestra ancorabile con schede flat o tridimensionali nella parte superiore o inferiore. Le schede possono visualizzare testo e un'immagine e possono cambiare colore quando sono attive.

Sintassi

class CMFCTabCtrl : public CMFCBaseTabCtrl

Membri

Costruttori pubblici

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

Metodi pubblici

Nome Descrizione
CMFCTabCtrl::ActivateMDITab Visualizza la scheda specificata del controllo struttura a schede corrente e imposta lo stato attivo su tale scheda.
CMFCTabCtrl::AllowDestroyEmptyTabbedPane
CMFCTabCtrl::AutoSizeWindow Specifica se il framework deve ridimensionare l'area client di tutte le finestre di controllo struttura quando viene modificato un elemento dell'interfaccia utente del controllo struttura a schede.
CMFCTabCtrl::CalcRectEdit Sgonfia le dimensioni dell'area di tabulazioni specificata. Esegue l'override di CMFCBaseTabCtrl::CalcRectEdit.
CMFCTabCtrl::Create Crea il controllo struttura a schede e lo collega all'oggetto CMFCTabCtrl .
CMFCTabCtrl::CreateObject Usato dal framework per creare un'istanza dinamica di questo tipo di classe.
CMFCTabCtrl::EnableActiveTabCloseButton Visualizza o nasconde un pulsante Chiudi ( X) nella scheda attiva.
CMFCTabCtrl::EnableInPlaceEdit Abilita o disabilita le etichette delle schede modificabili. Esegue l'override di CMFCBaseTabCtrl::EnableInPlaceEdit.
CMFCTabCtrl::EnableTabDocumentsMenu Sostituisce due pulsanti che scorrono le schede della finestra con un pulsante che apre un menu di finestre a schede.
CMFCTabCtrl::EnsureVisible Assicura che una scheda sia visibile.
CMFCTabCtrl::GetDocumentIcon Recupera il simbolo associato a una scheda in un menu popup di finestre a schede.
CMFCTabCtrl::GetFirstVisibleTabNum Recupera l'indice della prima scheda visibile nel controllo struttura a schede corrente.
CMFCTabCtrl::GetResizeMode Recupera un valore che specifica la modalità di ridimensionamento del controllo struttura a schede corrente.
CMFCTabCtrl::GetScrollBar Recupera un puntatore all'oggetto barra di scorrimento associato al controllo Struttura a schede.
CMFCTabCtrl::GetTabArea Recupera il rettangolo di delimitazione dell'area dell'etichetta di tabulazione nella parte superiore o inferiore del controllo struttura a schede. Esegue l'override di CMFCBaseTabCtrl::GetTabArea.
CMFCTabCtrl::GetTabFromPoint Recupera la scheda contenente un punto specificato. Esegue l'override di CMFCBaseTabCtrl::GetTabFromPoint.
CMFCTabCtrl::GetTabMaxWidth Recupera la larghezza massima di una scheda.
CMFCTabCtrl::GetTabsHeight Recupera l'altezza dell'area della scheda del controllo struttura a schede corrente.
CMFCTabCtrl::GetTabsRect Recupera un rettangolo che delimita l'area della scheda del controllo struttura a schede corrente. Esegue l'override di CMFCBaseTabCtrl::GetTabsRect.
CMFCTabCtrl::GetThisClass Utilizzato dal framework per ottenere un puntatore all'oggetto CRuntimeClass associato a questo tipo di classe.
CMFCTabCtrl::GetWndArea Recupera il limite dell'area client del controllo struttura a schede corrente.
CMFCTabCtrl::HideActiveWindowHorzScrollBar Nasconde la barra di scorrimento orizzontale, se presente, della finestra attiva.
CMFCTabCtrl::HideInactiveWindow Specifica se il framework deve visualizzare le finestre dei controlli struttura a schede inattive.
CMFCTabCtrl::HideNoTabs Abilita o disabilita il disegno dell'area di tabulazione se non sono presenti schede visibili.
CMFCTabCtrl::HideSingleTab Abilita o disabilita il disegno di una scheda quando è presente una singola finestra a schede. Esegue l'override di CMFCBaseTabCtrl::HideSingleTab.
CMFCTabCtrl::IsActiveInMDITabGroup Indica se la scheda corrente di un controllo struttura a schede è la scheda attiva in un gruppo di schede a più interfacce documento.
CMFCTabCtrl::IsActiveTabBoldFont Indica se il testo della scheda attiva viene visualizzato utilizzando un carattere in grassetto.
CMFCTabCtrl::IsActiveTabCloseButton Indica se il pulsante Chiudi ( X) viene visualizzato in una scheda attiva o nell'angolo superiore destro dell'area della scheda.
CMFCTabCtrl::IsDrawFrame Indica se la finestra a schede disegna un rettangolo cornice intorno ai riquadri incorporati.
CMFCTabCtrl::IsFlatFrame Indica se il frame intorno all'area della scheda è piatto o 3D.
CMFCTabCtrl::IsFlatTab Indica se l'aspetto delle schede nel controllo struttura a schede corrente è flat o meno.
CMFCTabCtrl::IsLeftRightRounded Indica se l'aspetto del lato sinistro e destro di una scheda nel controllo struttura a schede corrente viene arrotondato.
CMFCTabCtrl::IsMDITabGroup Indica se il controllo struttura a schede corrente è contenuto nell'area client di una finestra dell'interfaccia a documenti multipli.
CMFCTabCtrl::IsOneNoteStyle Indica se il controllo struttura a schede corrente viene visualizzato nello stile di Microsoft OneNote.
CMFCTabCtrl::IsPtInTabArea Determina se un punto è all'interno dell'area delle schede. Esegue l'override di CMFCBaseTabCtrl::IsPtInTabArea.
CMFCTabCtrl::IsSharedScroll Indica se il controllo struttura a schede corrente dispone di una barra di scorrimento in grado di scorrere le schede come gruppo.
CMFCTabCtrl::IsTabDocumentsMenu Indica se il controllo Struttura a schede visualizza pulsanti di scorrimento o un pulsante che visualizza un menu di finestre a schede.
CMFCTabCtrl::IsVS2005Style Indica se le schede vengono visualizzate nello stile di Visual Studio .NET 2005.
CMFCTabCtrl::ModifyTabStyle Specifica l'aspetto delle schede nel controllo struttura a schede corrente.
CMFCTabCtrl::MoveTab Sposta una scheda in un'altra posizione della scheda. Esegue l'override di CMFCBaseTabCtrl::MoveTab.
CMFCTabCtrl::OnDragEnter Chiamato dal framework quando il cursore viene prima trascinato nella finestra del controllo struttura a schede.
CMFCTabCtrl::OnDragOver Chiamato dal framework durante un'operazione di trascinamento quando il mouse viene spostato sulla finestra di destinazione della selezione. Esegue l'override di CMFCBaseTabCtrl::OnDragOver.
CMFCTabCtrl::OnShowTabDocumentsMenu Visualizza un menu popup di finestre a schede, attende fino a quando l'utente seleziona una scheda e rende attiva la scheda selezionata.
CMFCTabCtrl::PreTranslateMessage Converte i messaggi della finestra prima che vengano inviati alle TranslateMessage funzioni di e DispatchMessage Windows. Esegue l'override di CMFCBaseTabCtrl::PreTranslateMessage.
CMFCTabCtrl::RecalcLayout Ricalcola il layout interno del controllo Struttura a schede. Esegue l'override di CMFCBaseTabCtrl::RecalcLayout.
CMFCTabCtrl::SetActiveInMDITabGroup Imposta la scheda corrente di un controllo struttura a schede come scheda attiva in un gruppo di schede a più interfacce documento.
CMFCTabCtrl::SetActiveTab Attiva una scheda. (Esegue l'override di CMFCBaseTabCtrl::SetActiveTab.)
CMFCTabCtrl::SetActiveTabBoldFont Abilita o disabilita l'uso di un carattere in grassetto nelle schede attive.
CMFCTabCtrl::SetDrawFrame Abilita o disabilita il disegno di un rettangolo cornice attorno a una barra incorporata.
CMFCTabCtrl::SetFlatFrame Specifica se disegnare un frame piatto o 3D intorno all'area della scheda.
CMFCTabCtrl::SetImageList Specifica un elenco di immagini. Esegue l'override di CMFCBaseTabCtrl::SetImageList.
CMFCTabCtrl::SetResizeMode Specifica la modalità di ridimensionamento del controllo struttura a schede corrente e quindi la riproduzione del controllo.
CMFCTabCtrl::SetTabMaxWidth Specifica la larghezza massima della scheda in una finestra a schede.
CMFCTabCtrl::StopResize Termina l'operazione di ridimensionamento corrente nel controllo struttura a schede.
CMFCTabCtrl::SwapTabs Scambia una coppia di schede. Esegue l'override di CMFCBaseTabCtrl::SwapTabs.
CMFCTabCtrl::SynchronizeScrollBar Disegna una barra di scorrimento orizzontale in un controllo struttura a schede che visualizza schede flat.

Membri dei dati

Nome Descrizione
CMFCTabCtrl::m_bEnableActivate Impedisce alla visualizzazione attiva di perdere lo stato attivo quando viene inserita e abilitata una nuova scheda.

Osservazioni:

La CMFCTabCtrl classe supporta:

  • Stili di controllo Tab che includono 3D, flat e flat con una barra di scorrimento orizzontale condivisa.

  • Schede posizionate nella parte superiore o inferiore della finestra.

  • Schede che visualizzano testo, immagini o testo e immagini.

  • Schede che cambiano colore quando la scheda è attiva.

  • Modifiche alle dimensioni del bordo per le schede regolabili.

  • Finestre a schede scollegabili.

La CMFCTabCtrl classe può essere utilizzata con una finestra di dialogo, ma è destinata alle applicazioni che usano barre di controllo di ancoraggio come Microsoft Excel e Visual Studio. Per altre informazioni, vedere CDockablePane Classe.

Seguire questa procedura per aggiungere un controllo tabulazioni ridimensionabile e ancorabile nell'applicazione:

  1. Creare un'istanza di CTabbedPane Class.

  2. Chiamare CDockablePane::Create.

  3. Usare CBaseTabbedPane::AddTab o CMFCBaseTabCtrl::InsertTab per aggiungere nuove schede.

  4. Chiamare CBasePane::EnableDocking in modo che il controllo scheda di ancoraggio corrente possa ancorare alla finestra cornice principale.

  5. Chiamare CFrameWndEx::DockPane per ancorare la finestra a schede nella cornice principale.

Per un esempio di come creare una finestra a schede come barra di controllo di ancoraggio, vedere CTabbedPane Classe. Per usare CMFCTabCtrl come controllo non ancoraggio, creare un CMFCTabCtrl oggetto e quindi chiamare CMFCTabCtrl::Create.

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCTabCtrl

Esempio

Nell'esempio seguente viene illustrato come utilizzare vari metodi nella CMFCTabCtrl classe per configurare un CMFCTabCtrl oggetto . Nell'esempio viene illustrato come aggiungere una scheda, visualizzare il pulsante Chiudi nella scheda attiva, abilitare le etichette delle schede modificabili e visualizzare un menu a comparsa delle etichette delle finestre a schede. Questo esempio fa parte dell'esempio della raccolta di stati.

CMFCTabCtrl m_wndTabs;

// Attach list windows to tab:
// CListCtrl m_wndList1
// CListCtrl m_wndList2
// CListCtrl m_wndList3
m_wndTabs.AddTab(&m_wndList1, _T("Output 1"), (UINT)-1);
m_wndTabs.AddTab(&m_wndList2, _T("Output 2"), (UINT)-1);
m_wndTabs.AddTab(&m_wndList3, _T("Output 3"), (UINT)-1);

m_wndTabs.EnableActiveTabCloseButton();
m_wndTabs.EnableInPlaceEdit(true);
m_wndTabs.EnableTabDocumentsMenu();
m_wndTabs.SetActiveTab(1);
m_wndTabs.SetDrawFrame();
m_wndTabs.SetFlatFrame();

Requisiti

Intestazione: afxtabctrl.h

CMFCTabCtrl::ActivateMDITab

Visualizza la scheda specificata del controllo struttura a schede corrente e imposta lo stato attivo su tale scheda.

void ActivateMDITab(int nTab = -1);

Parametri

nTab
[in] Indice in base zero di una scheda da visualizzare oppure -1 per specificare la scheda attualmente attiva.

CMFCTabCtrl::AllowDestroyEmptyTabbedPane

Per altri dettagli, vedere il codice sorgente che si trova nella mfc cartella dell'installazione di Visual Studio. Ad esempio: %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual BOOL AllowDestroyEmptyTabbedPane() const;

Valore restituito

Sempre TRUE.

Osservazioni:

CMFCTabCtrl::AutoSizeWindow

Specifica se il framework deve ridimensionare l'area client di tutte le finestre di controllo struttura quando viene modificato un elemento dell'interfaccia utente del controllo struttura a schede.

void AutoSizeWindow(BOOL bAutoSize = TRUE);

Parametri

bAutoSize
[in] TRUE per ridimensionare automaticamente le finestre di controllo tabulazioni; in caso contrario, FALSE. Il valore predefinito è TRUE.

Osservazioni:

CMFCTabCtrl::Create

Crea il controllo struttura a schede e lo collega all'oggetto CMFCTabCtrl .

BOOL Create(
    Style style,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    Location location=LOCATION_BOTTOM,
    BOOL bCloseBtn=FALSE);

Parametri

style
[in] Stile del controllo struttura a schede. Per altre informazioni, vedere la sezione Note.

rect
[in] Rettangolo che delimita il controllo struttura a schede.

pParentWnd
[in] Puntatore a una finestra padre. Non deve essere NULL.

nID
[in] ID del controllo struttura a schede.

location
[in] Posizione delle schede. Il valore predefinito è LOCATION_BOTTOM. Per altre informazioni, vedere Note.

bCloseBtn
[in] TRUE per visualizzare un pulsante di chiusura nella scheda; in caso contrario, FALSE. Il valore predefinito è FALSE.

Valore restituito

TRUE se ha esito positivo; in caso contrario, FALSE.

Osservazioni:

Nella tabella seguente vengono descritti i valori che è possibile specificare per il style parametro .

Style Descrizione
STYLE_3D Crea un controllo struttura a schede con un aspetto tridimensionale.
STYLE_FLAT Crea un controllo struttura a schede con schede flat.
STYLE_FLAT_SHARED_HORZ_SCROLL Crea un controllo struttura a schede con schede flat e una barra di scorrimento in grado di scorrere le schede se vengono ritagliate da una finestra padre.
STYLE_3D_ONENOTE Crea un controllo struttura a schede nello stile di Microsoft OneNote.
STYLE_3D_VS2005 Crea un controllo struttura a schede nello stile di Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED Crea un controllo struttura a schede con schede arrotondate nello stile di Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED_SCROLL Crea un controllo struttura a schede con schede arrotondate e pulsanti di scorrimento nello stile di Microsoft Visual Studio 2005.

Nella tabella seguente sono elencati i valori che è possibile specificare per il location parametro .

Ufficio Descrizione
LOCATION_BOTTOM Le schede si trovano nella parte inferiore del controllo struttura a schede.
LOCATION_TOP Le schede si trovano nella parte superiore del controllo struttura a schede.

Esempio

Nell'esempio seguente viene illustrato come usare il Create metodo nella CMFCTabCtrl classe . Questo esempio fa parte dell'esempio della raccolta di stati.

CMFCTabCtrl m_wndTabs;

// Create tabs window:
// CRect rectDummy
// this is a pointer to a parent window
// fourth parameter is the id of the tab control
if (!m_wndTabs.Create (CMFCTabCtrl::STYLE_FLAT, rectDummy, this, 1))
{
    TRACE0("Failed to create output tab window\n");
    return -1;      // fail to create
}

CMFCTabCtrl::CalcRectEdit

Sgonfia le dimensioni dell'area di tabulazioni specificata.

virtual void CalcRectEdit(CRect& rectEdit);

Parametri

rectEdit
[in] Rettangolo che specifica l'area di una scheda.

Osservazioni:

Questo metodo viene chiamato quando si modifica l'etichetta di una scheda. Questo metodo sgonfia i lati sinistro e destro del rettangolo specificato di una metà dell'altezza della scheda corrente e sgonfia la parte superiore e inferiore di un'unità.

CMFCTabCtrl::EnableActiveTabCloseButton

Visualizza o nasconde un pulsante Chiudi ( X) nella scheda attiva.

void EnableActiveTabCloseButton(BOOL bEnable=TRUE);

Parametri

bEnable
[in] TRUE per visualizzare il pulsante Chiudi nella scheda attiva; FALSE per visualizzare il pulsante Chiudi nell'angolo superiore destro dell'area della scheda. Il valore predefinito è TRUE.

CMFCTabCtrl::EnableInPlaceEdit

Abilita o disabilita le etichette delle schede modificabili.

virtual void EnableInPlaceEdit(BOOL bEnable);

Parametri

bEnable
[in] TRUE per abilitare le etichette di tabulazioni modificabili; FALSE per disabilitare le etichette delle schede modificabili.

Osservazioni:

CMFCTabCtrl::EnableTabDocumentsMenu

Attiva/disattiva un'interfaccia utente che usa due pulsanti per scorrere le schede della finestra e un'interfaccia che visualizza un menu a comparsa di finestre a schede.

void EnableTabDocumentsMenu(BOOL bEnable=TRUE);

Parametri

bEnable
[in] TRUE per visualizzare un menu a comparsa delle etichette delle finestre a schede; FALSE per visualizzare i pulsanti di scorrimento avanti e indietro. Il valore predefinito è TRUE.

Osservazioni:

Quando l'utente fa clic su un'etichetta di scheda, il framework visualizza la finestra a schede corrispondente. Se l'etichetta della scheda è visibile, la finestra a schede viene aperta senza modificarne la posizione. Se l'utente seleziona un documento dal menu a comparsa e la finestra a schede corrispondente è disattivata, la finestra a schede diventa la prima scheda.

CMFCTabCtrl::EnsureVisible

Assicura che una scheda sia visibile.

virtual BOOL EnsureVisible(int iTab);

Parametri

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

Valore restituito

TRUE se ha esito positivo; FALSE se l'indice del iTab parametro non è valido.

Osservazioni:

Utilizzare questo metodo per garantire che la scheda specificata sia visibile. Se necessario, il controllo struttura a schede scorrerà.

CMFCTabCtrl::GetDocumentIcon

Recupera l'immagine associata a una scheda in un menu a comparsa di finestre a schede.

static HICON __stdcall GetDocumentIcon(UINT nCmdID);

Parametri

nCmdID
[in] ID comando di una scheda in un menu a comparsa di finestre a schede.

Valore restituito

Handle di un'immagine bitmap.

CMFCTabCtrl::GetFirstVisibleTabNum

Recupera l'indice della prima scheda visibile nel controllo struttura a schede corrente.

virtual int GetFirstVisibleTabNum() const;

Valore restituito

Indice in base zero di una scheda nel controllo struttura a schede.

Osservazioni:

Utilizzare questo metodo solo quando il controllo Struttura a schede viene visualizzato nello stile di Microsoft OneNote. Utilizzare il CMFCTabCtrl::IsOneNoteStyle metodo per determinare lo stile.

CMFCTabCtrl::GetResizeMode

Recupera un valore che specifica la modalità di ridimensionamento del controllo struttura a schede corrente.

ResizeMode GetResizeMode() const;

Valore restituito

Uno dei valori di CMFCTabCtrl::ResizeMode enumerazione che specifica la modalità di ridimensionamento del controllo struttura a schede. Per un elenco dei valori possibili, vedere la sezione Osservazioni del CMFCTabCtrl::SetResizeMode metodo .

CMFCTabCtrl::GetScrollBar

Recupera un puntatore all'oggetto barra di scorrimento associato al controllo Struttura a schede.

CScrollBar* GetScrollBar();

Valore restituito

Puntatore a un oggetto barra di scorrimento o un NULL oggetto se il controllo struttura a schede non è stato creato utilizzando lo STYLE_FLAT_SHARED_HORZ_SCROLL stile .

Osservazioni:

Utilizzare questo metodo per accedere alla barra di scorrimento incorporata del controllo struttura a schede. Viene creato un oggetto barra di scorrimento solo quando il controllo Struttura a schede ha lo STYLE_FLAT_SHARED_HORZ_SCROLL stile.

CMFCTabCtrl::GetTabArea

Recupera il rettangolo di delimitazione dell'area dell'etichetta di tabulazione nella parte superiore o inferiore del controllo struttura a schede.

void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const;

Parametri

rectTabAreaTop
[out] Quando termina, questo riferimento contiene un rettangolo che delimita l'area dell'etichetta della scheda superiore. Il rettangolo si trova nelle coordinate client. Questo riferimento è vuoto se nella parte superiore del controllo struttura a schede non esiste alcuna area dell'etichetta di tabulazioni.

rectTabAreaBottom
[out] Quando termina, questo riferimento contiene un rettangolo che delimita l'area dell'etichetta della scheda inferiore. Il rettangolo si trova nelle coordinate client. Questo riferimento è vuoto se nella parte inferiore del controllo struttura a schede non esiste alcuna area dell'etichetta di tabulazioni.

Osservazioni:

Utilizzare questo metodo per determinare le dimensioni e la posizione dell'area di tabulazioni nella finestra a schede.

CMFCTabCtrl::GetTabMaxWidth

Recupera la larghezza massima di una scheda.

int GetTabMaxWidth() const;

Valore restituito

Larghezza massima di una scheda, in pixel. Se il valore restituito è 0, la larghezza della scheda è illimitata.

Osservazioni:

Utilizzare il metodo CMFCTabCtrl::SetTabMaxWidth per impostare la larghezza massima della scheda.

CMFCTabCtrl::GetTabsHeight

Recupera l'altezza dell'area della scheda del controllo struttura a schede corrente.

virtual int GetTabsHeight() const;

Valore restituito

Altezza dell'area di tabulazioni se una scheda è visibile o zero se non è visibile alcuna scheda.

CMFCTabCtrl::GetTabsRect

Recupera un rettangolo che delimita l'area della scheda del controllo struttura a schede corrente.

virtual void GetTabsRect(CRect& rect) const;

Parametri

rect
[out] Quando termina, questo rect metodo contiene un rettangolo che delimita l'area della scheda.

CMFCTabCtrl::GetWndArea

Recupera il limite dell'area client del controllo struttura a schede corrente.

void GetWndArea(CRect& rect) const;

Parametri

rect
[in, out] Quando termina, questo parametro contiene un rettangolo che delimita il controllo struttura a schede corrente.

Osservazioni:

CMFCTabCtrl::HideActiveWindowHorzScrollBar

Nasconde la barra di scorrimento orizzontale, se presente, nella finestra attiva.

void HideActiveWindowHorzScrollBar();

Osservazioni:

Utilizzare questo metodo per impedire il lampeggiamento del controllo struttura a schede quando l'utente passa da una pagina all'altra.

CMFCTabCtrl::HideInactiveWindow

Specifica se il framework visualizza le finestre dei controlli struttura a schede inattive.

void HideInactiveWindow(BOOL bHide = TRUE);

Parametri

bHide
[in] TRUE non visualizzare una finestra inattiva; FALSE per visualizzare una finestra inattiva. Il valore predefinito è TRUE.

Osservazioni:

CMFCTabCtrl::HideNoTabs

Abilita o disabilita il disegno dell'area di tabulazione se non sono presenti schede visibili.

void HideNoTabs(BOOL bHide=TRUE);

Parametri

bHide
[in] TRUE per abilitare il disegno dell'area di tabulazioni; FALSE per disabilitare il disegno. Il valore predefinito è TRUE.

Osservazioni:

CMFCTabCtrl::HideSingleTab

Abilita o disabilita il disegno a schede se è presente una singola finestra a schede.

virtual void HideSingleTab(BOOL bHide=TRUE);

Parametri

bHide
[in] TRUE per non disegnare una scheda per una singola finestra a schede; FALSE per disegnare una singola scheda. Il valore predefinito è TRUE.

Osservazioni:

CMFCTabCtrl::IsActiveInMDITabGroup

Indica se la scheda corrente di un controllo struttura a schede è la scheda attiva in un gruppo di schede a più interfacce documento.

BOOL IsActiveInMDITabGroup() const;

Valore restituito

TRUE se la scheda corrente di un controllo struttura a schede è la scheda attiva in un gruppo di schede MDI; in caso contrario, FALSE.

Osservazioni:

È possibile organizzare più finestre documento in gruppi di schede verticali o orizzontali e riorganizzare facilmente i documenti da un gruppo di schede a un altro.

CMFCTabCtrl::IsActiveTabBoldFont

Indica se il testo della scheda attiva viene visualizzato utilizzando un carattere in grassetto.

BOOL IsActiveTabBoldFont() const;

Valore restituito

TRUE se la scheda attiva viene visualizzata utilizzando il carattere grassetto; in caso contrario, FALSE.

Osservazioni:

Utilizzare il CMFCTabCtrl::SetActiveTabBoldFont metodo per modificare il tipo di carattere della scheda attiva.

CMFCTabCtrl::IsActiveTabCloseButton

Indica se il pulsante Chiudi ( X) viene visualizzato in una scheda attiva o nell'angolo superiore destro dell'area della scheda.

virtual BOOL IsActiveTabCloseButton() const;

Valore restituito

TRUE se il pulsante Chiudi viene visualizzato nella scheda attiva; FALSE se il pulsante Chiudi viene visualizzato nell'angolo superiore destro dell'area della scheda.

Osservazioni:

CMFCTabCtrl::IsDrawFrame

Indica se la finestra a schede disegna un rettangolo cornice intorno ai riquadri incorporati.

BOOL IsDrawFrame() const;

Valore restituito

TRUE se viene disegnato un rettangolo cornice; in caso contrario, FALSE.

Osservazioni:

Utilizzare il metodo per abilitare o disabilitare il CMFCTabCtrl::SetDrawFrame disegno di un rettangolo cornice.

CMFCTabCtrl::IsFlatFrame

Indica se il frame intorno all'area della scheda è piatto o 3D.

BOOL IsFlatFrame() const;

Valore restituito

TRUE se la cornice intorno all'area della scheda è piatta; FALSE se la cornice è tridimensionale.

Osservazioni:

Utilizzare il metodo per modificare la CMFCTabCtrl::SetFlatFrame modalità di disegno del fotogramma.

CMFCTabCtrl::IsFlatTab

Indica se l'aspetto delle schede nel controllo struttura a schede corrente è flat o meno.

virtual BOOL IsFlatTab() const;

Valore restituito

TRUE se l'aspetto delle schede nel controllo tabulazioni corrente è piatto; in caso contrario, FALSE.

CMFCTabCtrl::IsLeftRightRounded

Indica se l'aspetto del lato sinistro e destro di una scheda nel controllo struttura a schede corrente viene arrotondato.

virtual BOOL IsLeftRightRounded() const;

Valore restituito

TRUE se i lati di ogni scheda sono arrotondati; in caso contrario, FALSE.

CMFCTabCtrl::IsMDITabGroup

Indica se il controllo struttura a schede corrente è contenuto nell'area client di una finestra dell'interfaccia a documenti multipli.

virtual BOOL IsMDITabGroup() const;

Valore restituito

TRUE se il controllo tabulazione corrente si trova in una finestra dell'area client MDI; in caso contrario, FALSE.

CMFCTabCtrl::IsOneNoteStyle

Indica se il controllo struttura a schede corrente viene visualizzato nello stile di Microsoft OneNote.

virtual BOOL IsOneNoteStyle() const;

Valore restituito

TRUE se il controllo struttura a schede viene visualizzato nello stile di Microsoft OneNote; in caso contrario, FALSE.

CMFCTabCtrl::IsSharedScroll

Indica se il controllo struttura a schede corrente dispone di una barra di scorrimento in grado di scorrere le schede come gruppo.

BOOL IsSharedScroll() const;

Valore restituito

TRUE se il controllo struttura a schede dispone di una barra di scorrimento condivisa; in caso contrario, FALSE.

Osservazioni:

Questo metodo restituisce TRUE se il style parametro del CMFCTabCtrl::Create metodo è STYLE_FLAT_SHARED_HORZ_SCROLL.

CMFCTabCtrl::IsTabDocumentsMenu

Indica se il controllo Struttura a schede visualizza pulsanti di scorrimento o un pulsante che visualizza un menu di finestre a schede.

BOOL IsTabDocumentsMenu() const;

Valore restituito

TRUE se le finestre a schede vengono scorrete utilizzando un menu popup di etichette di finestre a schede; FALSE se le finestre a schede vengono scorrete utilizzando pulsanti di scorrimento avanti e indietro.

Osservazioni:

Utilizzare il CMFCTabCtrl::EnableTabDocumentsMenu metodo per specificare il metodo di scorrimento delle finestre a schede.

CMFCTabCtrl::IsVS2005Style

Indica se le schede vengono disegnate usando lo stile di Visual Studio 2005.

virtual BOOL IsVS2005Style() const;

Valore restituito

TRUE se le schede vengono disegnate usando lo stile di Visual Studio 2005; in caso contrario, FALSE.

Osservazioni:

Utilizzare il style parametro del CMFCTabCtrl::Create metodo per specificare la modalità di disegno delle schede.

CMFCTabCtrl::m_bEnableActivate

Impedisce alla visualizzazione attiva di perdere lo stato attivo quando viene inserita e abilitata una nuova scheda.

static BOOL m_bEnableActivate;

Osservazioni:

Lo stato attivo viene in genere preso da una nuova finestra a schede quando la scheda viene inserita e resa attiva. Impostare la CMFCTabCtrl::m_bEnableActivate variabile membro su FALSE per mantenere lo stato attivo originale. Il valore predefinito è TRUE.

CMFCTabCtrl::ModifyTabStyle

Specifica l'aspetto delle schede nel controllo struttura a schede corrente.

BOOL ModifyTabStyle(Style style);

Parametri

style
[in] Uno dei valori di enumerazione che specifica l'aspetto del controllo struttura a schede. Per altre informazioni, vedere la tabella in Osservazioni.

Valore restituito

Sempre TRUE.

Osservazioni:

Il valore del style parametro può essere rappresentato da una delle enumerazioni seguenti CMFCTabCtrl::Style .

Nome Descrizione
STYLE_3D Visualizza schede rettangolari tridimensionali con angoli arrotondati.
STYLE_3D_ONENOTE Visualizza schede tridimensionali con un lato verticale e un lato inclinato e con angoli arrotondati.
STYLE_3D_ROUNDED Visualizza schede tridimensionali con lati inclinati e angoli arrotondati.
STYLE_3D_ROUNDED_SCROLL Visualizza schede tridimensionali con lati inclinati e angoli arrotondati. Se sono presenti più schede di quelle che possono essere visualizzate contemporaneamente, il framework visualizza una freccia a discesa e un menu di schede da attivare.
STYLE_3D_SCROLLED Visualizza schede tridimensionali rettangolari. Se sono presenti più schede di quelle che possono essere visualizzate contemporaneamente, il framework visualizza una freccia a discesa e un menu di schede da attivare.
STYLE_3D_VS2005 Visualizza tabulazioni tridimensionali arrotondate con un lato inclinato e un lato verticale.
STYLE_FLAT Visualizza schede bidimensionali con lati inclinati a sinistra e destra.
STYLE_FLAT_SHARED_HORZ_SCROLL Visualizza schede bidimensionali. Se sono presenti più schede che possono essere visualizzate contemporaneamente, il framework visualizza le frecce di scorrimento alle estremità dell'area di tabulazione.

CMFCTabCtrl::OnDragEnter

Chiamato dal framework durante un'operazione di trascinamento della selezione quando il cursore entra per la prima volta nella finestra del controllo struttura a schede corrente.

virtual DROPEFFECT OnDragEnter(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Parametri

pDataObject
[in] Punta a un oggetto dati che contiene dati trascinati dall'utente.

dwKeyState
[in] Contiene lo stato dei tasti di modifica. Questo parametro è una combinazione bit per bit "or" (|) dei valori seguenti: MK_CONTROL, MK_SHIFTMK_ALT, MK_LBUTTON, MK_MBUTTON, e MK_RBUTTON. Per altre informazioni, vedere la sezione Parametri messaggio di Informazioni sull'input del mouse.

point
[in] Contiene la posizione corrente del cursore nelle coordinate client.

Valore restituito

Sempre DROPEFFECT_NONE, il che significa che la destinazione di rilascio non può accettare i dati.

Osservazioni:

Usare questo metodo per supportare un'operazione di trascinamento della selezione. Eseguire l'override di questo metodo per implementare il proprio comportamento personalizzato.

Per impostazione predefinita, questo metodo chiama CMFCTabCtrl::OnDragOversolo , che restituisce DROPEFFECT_NONEsempre .

CMFCTabCtrl::OnDragOver

Chiamato dal framework durante un'operazione di trascinamento quando il mouse viene spostato sulla finestra di destinazione della selezione.

virtual DROPEFFECT OnDragOver(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Parametri

pDataObject
[in] Puntatore a un COleDataObject oggetto trascinato sulla destinazione di rilascio.

dwKeyState
[in] Stato dei tasti di modifica, ovvero una combinazione bit per bit "o" (|) di MK_CONTROL, MK_SHIFT, MK_ALTMK_LBUTTON, MK_MBUTTON, e MK_RBUTTON. Per altre informazioni, vedere "Parametri messaggio" in Informazioni sull'input del mouse.

point
[in] Posizione corrente del mouse.

Valore restituito

Sempre DROPEFFECT_NONE.

Osservazioni:

Eseguire l'override di questo metodo con l'implementazione personalizzata. Per altre informazioni, vedere il metodo CView::OnDragOver.

CMFCTabCtrl::OnShowTabDocumentsMenu

Visualizza un menu a comparsa di finestre a schede, attende fino a quando l'utente seleziona una scheda e imposta la scheda selezionata sulla scheda attiva.

virtual void OnShowTabDocumentsMenu(CPoint point);

Parametri

point
[in] Coordinate della posizione in cui visualizzare il menu a comparsa.

Osservazioni:

CMFCTabCtrl::SetActiveInMDITabGroup

Imposta la scheda corrente di un controllo struttura a schede come scheda attiva in un gruppo di schede a più interfacce documento.

void SetActiveInMDITabGroup(BOOL bActive);

Parametri

bActive
[in] TRUE per rendere la scheda corrente la scheda attiva; FALSE per rendere la scheda corrente inattiva.

Osservazioni:

È possibile organizzare più finestre documento in gruppi di schede verticali o orizzontali e riorganizzare facilmente i documenti da un gruppo di schede a un altro.

CMFCTabCtrl::SetActiveTab

Attiva una scheda.

virtual BOOL SetActiveTab(int iTab);

Parametri

iTab
[in] Specifica l'indice in base zero della scheda da attivare.

Valore restituito

TRUE se la scheda specificata è stata resa attiva; FALSE se il valore del parametro specificato iTab non è valido.

Osservazioni:

In questo modo viene inviata la AFX_WM_CHANGE_ACTIVE_TAB notifica alla finestra padre e al frame padre del controllo struttura a schede.

Il SetActiveTab metodo chiama automaticamente il CMFCTabCtrl::HideActiveWindowHorzScrollBar metodo per impedire il lampeggiamento dello schermo.

CMFCTabCtrl::SetActiveTabBoldFont

Abilita o disabilita l'uso di un carattere in grassetto nelle schede attive.

void SetActiveTabBoldFont(BOOL bIsBold=TRUE);

Parametri

bIsBold
[in] TRUE per utilizzare un carattere in grassetto per visualizzare l'etichetta della scheda attiva; FALSE per utilizzare il tipo di carattere standard per visualizzare l'etichetta. Il valore predefinito è TRUE.

Osservazioni:

CMFCTabCtrl::SetDrawFrame

Specifica se un rettangolo cornice viene disegnato intorno a una barra incorporata.

void SetDrawFrame(BOOL bDraw=TRUE);

Parametri

bDraw
[in] TRUE per visualizzare un rettangolo cornice attorno a una barra incorporata; in caso contrario, FALSE. Il valore predefinito è TRUE.

Osservazioni:

CMFCTabCtrl::SetFlatFrame

Specifica se disegnare un frame piatto o 3D intorno all'area della scheda.

void SetFlatFrame(
    BOOL bFlat=TRUE,
    BOOL bRepaint=TRUE);

Parametri

bFlat
[in] TRUE per disegnare una cornice piatta (2D) intorno all'area della scheda; FALSE per disegnare una cornice tridimensionale (3D). Il valore predefinito è TRUE.

bRepaint
[in] TRUE per ridisegnare immediatamente la finestra; in caso contrario, FALSE. Il valore predefinito è TRUE.

Osservazioni:

CMFCTabCtrl::SetImageList

Specifica un elenco di immagini.

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

virtual BOOL SetImageList(HIMAGELIST hImageList);

Parametri

uiID
[in] ID di una risorsa bitmap che contiene l'elenco di immagini.

cx
[in] Larghezza di ogni immagine, in pixel. Il valore predefinito è 15.

clrTransp
[in] Colore dell'immagine trasparente. Le parti dell'immagine che sono questo colore saranno trasparenti. Il valore predefinito è il colore magenta, RGB(255,0,255).

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

Valore restituito

TRUE se questo metodo ha esito positivo. FALSE se il controllo struttura a schede viene creato utilizzando uno stile flat o se il primo overload del metodo non può caricare la bitmap specificata dal uiID parametro .

Osservazioni:

Utilizzare questo metodo per impostare un elenco di immagini per il controllo struttura a schede. Le immagini dell'elenco di immagini vengono visualizzate accanto all'etichetta della scheda. Questo metodo ricalcola l'altezza della scheda in modo che la scheda sia ridimensionata in modo da contenere sia l'immagine che il testo.

Utilizzare il CMFCBaseTabCtrl::AddTab metodo ereditato dal controllo struttura a schede per specificare l'indice dell'immagine da visualizzare.

CMFCTabCtrl::SetResizeMode

Specifica la modalità di ridimensionamento del controllo struttura a schede corrente e quindi la riproduzione del controllo.

void SetResizeMode(ResizeMode resizeMode);

Parametri

resizeMode
[in] Uno dei valori di CMFCTabCtrl::ResizeMode enumerazione che specifica la modalità di ridimensionamento del controllo struttura a schede. Per un elenco dei valori possibili, vedere la tabella in Osservazioni.

Osservazioni:

Il parametro resizeMode può essere uno dei valori di enumerazione seguenti ResizeMode .

Nome Descrizione
RESIZE_NO Il controllo struttura a schede non può essere ridimensionato.
RESIZE_VERT Il controllo struttura a schede può essere ridimensionato verticalmente, ma non orizzontalmente.
RESIZE_HORIZ Il controllo struttura a schede può essere ridimensionato orizzontalmente, ma non verticalmente.

CMFCTabCtrl::SetTabMaxWidth

Specifica la larghezza massima della scheda in una finestra a schede.

void SetTabMaxWidth(int nTabMaxWidth);

Parametri

nTabMaxWidth
[in] Larghezza massima della scheda, espressa in pixel.

Osservazioni:

Utilizzare questo metodo per limitare la larghezza di ogni scheda in una finestra a schede. Questo metodo è utile se le schede hanno etichette molto lunghe. Il CMFCTabCtrl costruttore della classe inizializza la larghezza massima della scheda su 0, il che significa che la larghezza non è limitata.

CMFCTabCtrl::StopResize

Termina l'operazione di ridimensionamento corrente nel controllo struttura a schede.

void StopResize(BOOL bCancel);

Parametri

bCancel
[in] TRUE per abbandonare l'operazione di ridimensionamento corrente; FALSE per completare l'operazione di ridimensionamento corrente. In entrambi i casi, il framework interrompe il disegno del rettangolo di ridimensionamento.

CMFCTabCtrl::SynchronizeScrollBar

Disegna una barra di scorrimento orizzontale in un controllo struttura a schede che visualizza schede flat.

BOOL SynchronizeScrollBar(SCROLLINFO* pScrollInfo = NULL);

Parametri

pScrollInfo
[out] Puntatore a una SCROLLINFO struttura o NULLa . Quando termina, e se questo parametro non NULLè , la struttura contiene tutti i parametri della barra di scorrimento. Il valore predefinito è NULL.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario, FALSE.

Osservazioni:

Questo metodo influisce solo su un controllo struttura a schede che visualizza schede flat. La barra di scorrimento influenza tutte le schede contemporaneamente.

Vedi anche

Grafico della gerarchia
Classi
CDockablePane Classe
CMFCBaseTabCtrl Classe