Condividi tramite

Classe CTabCtrl

  • Articolo

Fornisce la funzionalità del controllo scheda comune di Windows.

Sintassi

class CTabCtrl : public CWnd

Membri

Costruttori pubblici

Nome Descrizione
CTabCtrl::CTabCtrl Costruisce un oggetto CTabCtrl.

Metodi pubblici

Nome Descrizione
CTabCtrl::AdjustRect Calcola l'area di visualizzazione di un controllo struttura a schede in base a un rettangolo di finestra o calcola il rettangolo della finestra corrispondente a una determinata area di visualizzazione.
CTabCtrl::Create Crea un controllo struttura a schede e lo collega a un'istanza di un TabCtrl oggetto
CTabCtrl::CreateEx Crea un controllo struttura a schede con gli stili estesi di Windows specificati e lo associa a un'istanza di un CTabCtrl oggetto .
CTabCtrl::DeleteAllItems Rimuove tutti gli elementi da un controllo struttura a schede.
CTabCtrl::DeleteItem Rimuove un elemento da un controllo struttura a schede.
CTabCtrl::DeselectAll Reimposta gli elementi in un controllo struttura a schede, cancellando qualsiasi elemento premuto.
CTabCtrl::DrawItem Disegna un elemento specificato di un controllo struttura a schede.
CTabCtrl::GetCurFocus Recupera la scheda con lo stato attivo corrente di un controllo struttura a schede.
CTabCtrl::GetCurSel Determina la scheda attualmente selezionata in un controllo struttura a schede.
CTabCtrl::GetExtendedStyle Recupera gli stili estesi attualmente in uso per il controllo struttura a schede.
CTabCtrl::GetImageList Recupera l'elenco di immagini associato a un controllo struttura a schede.
CTabCtrl::GetItem Recupera informazioni su una scheda in un controllo struttura a schede.
CTabCtrl::GetItemCount Recupera il numero di schede nel controllo Struttura a schede.
CTabCtrl::GetItemRect Recupera il rettangolo di delimitazione per una scheda in un controllo struttura a schede.
CTabCtrl::GetItemState Recupera lo stato dell'elemento del controllo struttura a schede indicato.
CTabCtrl::GetRowCount Recupera il numero corrente di righe di schede in un controllo struttura a schede.
CTabCtrl::GetToolTips Recupera l'handle del controllo della descrizione comando associato a un controllo struttura a schede.
CTabCtrl::HighlightItem Imposta lo stato di evidenziazione di un elemento di tabulazione.
CTabCtrl::HitTest Determina quale scheda, se disponibile, si trova in una posizione dello schermo specificata.
CTabCtrl::InsertItem Inserisce una nuova scheda in un controllo struttura a schede.
CTabCtrl::RemoveImage Rimuove un'immagine dall'elenco di immagini di un controllo struttura a schede.
CTabCtrl::SetCurFocus Imposta lo stato attivo su una scheda specificata in un controllo struttura a schede.
CTabCtrl::SetCurSel Seleziona una scheda in un controllo struttura a schede.
CTabCtrl::SetExtendedStyle Imposta gli stili estesi per un controllo struttura a schede.
CTabCtrl::SetImageList Assegna un elenco di immagini a un controllo struttura a schede.
CTabCtrl::SetItem Imposta alcuni o tutti gli attributi di una scheda.
CTabCtrl::SetItemExtra Imposta il numero di byte per scheda riservati ai dati definiti dall'applicazione in un controllo struttura a schede.
CTabCtrl::SetItemSize Imposta la larghezza e l'altezza di un elemento.
CTabCtrl::SetItemState Imposta lo stato dell'elemento del controllo struttura a schede indicato.
CTabCtrl::SetMinTabWidth Imposta la larghezza minima degli elementi in un controllo struttura a schede.
CTabCtrl::SetPadding Imposta la quantità di spazio (spaziatura interna) intorno a ogni icona delle schede e etichetta in un controllo struttura a schede.
CTabCtrl::SetToolTips Assegna un controllo descrizione comando a un controllo struttura a schede.

Osservazioni:

Un "controllo struttura a schede" è analogo ai divisori in un notebook o alle etichette in un file cab. L'uso del controllo Struttura a schede consente a un'applicazione di definire più pagine per la stessa area di una finestra o una finestra di dialogo. Ogni pagina è costituita da un set di informazioni o da un gruppo di controlli visualizzati dall'applicazione quando l'utente seleziona la scheda corrispondente. Un tipo speciale di controllo struttura a schede visualizza schede simili ai pulsanti. Fare clic su un pulsante per eseguire immediatamente un comando anziché visualizzare una pagina.

Questo controllo (e quindi la CTabCtrl classe ) è disponibile solo per i programmi in esecuzione in Windows 95/98 e Windows NT versione 3.51 e successive.

Per altre informazioni su CTabCtrl, vedere Controlli e uso di CTabCtrl.

Gerarchia di ereditarietà

CObject
CCmdTarget
CWnd

CTabCtrl

Requisiti

Intestazione: afxcmn.h

CTabCtrl::AdjustRect

Calcola l'area di visualizzazione di un controllo struttura a schede in base a un rettangolo di finestra o calcola il rettangolo della finestra corrispondente a una determinata area di visualizzazione.

void AdjustRect(BOOL bLarger,   LPRECT lpRect);

Parametri

bLarger
Indica l'operazione da eseguire. Se questo parametro è TRUE, lpRect specifica un rettangolo di visualizzazione e riceve il rettangolo della finestra corrispondente. Se questo parametro è FALSE, lpRect specifica un rettangolo di finestra e riceve il rettangolo di visualizzazione corrispondente.

lpRect
Puntatore a una RECT struttura che specifica il rettangolo specificato e riceve il rettangolo calcolato.

Esempio

void CTabDlg::OnSize(UINT nType, int cx, int cy)
{
   CDialog::OnSize(nType, cx, cy);

   if (m_TabCtrl.m_hWnd == NULL)
      return; // Return if window is not created yet.

   RECT rect;

   // Get size of dialog window.
   GetClientRect(&rect);

   // Adjust the rectangle to fit the tab control into the
   // dialog's client rectangle.
   m_TabCtrl.AdjustRect(FALSE, &rect);

   // Move the tab control to the new position and size.
   m_TabCtrl.MoveWindow(&rect, TRUE);
}

CTabCtrl::Create

Crea un controllo struttura a schede e lo collega a un'istanza di un CTabCtrl oggetto .

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parametri

dwStyle
Specifica lo stile del controllo struttura a schede. Applicare qualsiasi combinazione di stili di controllo struttura a schede, descritti in Windows SDK. Per un elenco di stili di finestra che è possibile applicare al controllo, vedere La sezione Osservazioni.

rect
Specifica le dimensioni e la posizione del controllo struttura a schede. Può essere un CRect oggetto o una RECT struttura.

pParentWnd
Specifica la finestra padre del controllo struttura a schede, in genere un oggetto CDialog. Non deve essere NULL.

nID
Specifica l'ID del controllo struttura a schede.

Valore restituito

TRUE se l'inizializzazione dell'oggetto ha avuto esito positivo; in caso contrario FALSE, .

Osservazioni:

Si costruisce un CTabCtrl oggetto in due passaggi. Prima di tutto, chiamare il costruttore e quindi chiamare Create, che crea il controllo struttura a schede e lo collega all'oggetto CTabCtrl .

Oltre agli stili dei controlli struttura a schede, è possibile applicare gli stili di finestra seguenti a un controllo struttura a schede:

  • WS_CHILD: crea una finestra figlio che rappresenta il controllo struttura a schede. Non può essere utilizzato con lo stile WS_POPUP.
  • WS_VISIBLE: crea un controllo struttura a schede inizialmente visibile.
  • WS_DISABLED: crea una finestra inizialmente disabilitata.
  • WS_GROUP: specifica il primo controllo di un gruppo di controlli in cui l'utente può passare da un controllo all'altro con i tasti di direzione. Tutti i controlli definiti con lo WS_GROUPstile : dopo il primo controllo appartengono allo stesso gruppo. Il controllo successivo con lo WS_GROUPstile : termina il gruppo di stili e avvia il gruppo successivo, ovvero un gruppo termina dove inizia la successiva.
  • WS_TABSTOP: specifica un numero qualsiasi di controlli tramite cui l'utente può spostarsi usando il tasto TAB. Il tasto TAB sposta l'utente al controllo successivo specificato dallo WS_TABSTOPstile : .

Per creare un controllo struttura a schede con stili di finestra estesi, chiamare CTabCtrl::CreateEx invece di Create.

Esempio

// Assuming you have a member variable m_TabCtrl, that is a CTabCtrl
// object, you can use the following to create a tab control.

m_TabCtrl.Create(TCS_TABS | TCS_FIXEDWIDTH | WS_CHILD | WS_VISIBLE,
                 rect, this, IDC_MYTAB);

// This creates a tab control with the given styles, and with
// an ID of IDC_MYTAB.

CTabCtrl::CreateEx

Crea un controllo (una finestra figlio) e lo associa all'oggetto CTabCtrl .

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parametri

dwExStyle
Specifica lo stile esteso del controllo da creare. Per un elenco degli stili di Windows estesi, vedi il dwExStyle parametro per CreateWindowEx in Windows SDK.

dwStyle
Specifica lo stile del controllo struttura a schede. Applicare qualsiasi combinazione di stili di controllo struttura a schede, descritti in Windows SDK. Per un elenco di stili di finestra che è possibile applicare al controllo, vedere La sezione Osservazioni in Create .

rect
Riferimento a una RECT struttura che descrive le dimensioni e la posizione della finestra da creare, nelle coordinate client di pParentWnd.

pParentWnd
Puntatore alla finestra padre del controllo.

nID
ID finestra figlio del controllo.

Valore restituito

Diverso da zero se ha esito positivo altrimenti 0.

Osservazioni:

Usare CreateEx invece di Create applicare stili di Windows estesi, specificati dalla prefazione WS_EX_dello stile esteso di Windows.

CreateEx crea il controllo con gli stili di Windows estesi specificati da dwExStyle. Impostare stili estesi specifici di un controllo usando SetExtendedStyle. Ad esempio, usare CreateEx per impostare stili come WS_EX_CONTEXTHELP, ma usare SetExtendedStyle per impostare tali stili, ad TCS_EX_FLATSEPARATORSesempio . Per altre informazioni, vedere gli stili descritti in Stili estesi del controllo struttura a schede in Windows SDK.

CTabCtrl::CTabCtrl

Costruisce un oggetto CTabCtrl.

CTabCtrl();

CTabCtrl::DeleteAllItems

Rimuove tutti gli elementi da un controllo struttura a schede.

BOOL DeleteAllItems();

Valore restituito

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

CTabCtrl::DeleteItem

Rimuove l'elemento specificato da un controllo struttura a schede.

BOOL DeleteItem(int nItem);

Parametri

nItem
Valore in base zero dell'elemento da eliminare.

Valore restituito

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

Esempio

// This example assumes that there is a CTabCtrl member of the
// CTabDlg class named m_TabCtrl.  On a button handler
// called OnDeleteItem of the dialog box the tab control will
// delete the 0 indexed item.

void CTabDlg::OnDeleteItem()
{
   // Delete the first item in the tab control.
   m_TabCtrl.DeleteItem(0);
}

CTabCtrl::DeselectAll

Reimposta gli elementi in un controllo struttura a schede, cancellando qualsiasi elemento premuto.

void DeselectAll(BOOL fExcludeFocus);

Parametri

fExcludeFocus
Flag che specifica l'ambito della selezione dell'elemento. Se questo parametro è impostato su FALSE, tutti i pulsanti di tabulazione verranno reimpostati. Se è impostato su TRUE, verranno reimpostati tutti gli elementi della scheda ad eccezione di quello attualmente selezionato.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio Win32, TCM_DESELECTALL, come descritto in Windows SDK.

CTabCtrl::DrawItem

Chiamato dal framework quando cambia un aspetto visivo di un controllo struttura a schede di disegno proprietario.

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

Parametri

lpDrawItemStruct
Puntatore a una DRAWITEMSTRUCT struttura che descrive l'elemento da disegnare.

Osservazioni:

Il itemAction membro della DRAWITEMSTRUCT struttura definisce l'azione di disegno da eseguire.

Per impostazione predefinita, questa funzione membro non esegue alcuna operazione. Eseguire l'override di questa funzione membro per implementare il disegno per un oggetto di disegno CTabCtrl proprietario.

L'applicazione deve ripristinare tutti gli oggetti GDI (Graphics Device Interface) selezionati per il contesto di visualizzazione fornito in lpDrawItemStruct prima che questa funzione membro termini.

CTabCtrl::GetCurFocus

Recupera l'indice della scheda con lo stato attivo corrente.

int GetCurFocus() const;

Valore restituito

Indice in base zero della scheda con lo stato attivo corrente.

CTabCtrl::GetCurSel

Recupera la scheda attualmente selezionata in un controllo struttura a schede.

int GetCurSel() const;

Valore restituito

Indice in base zero della scheda selezionata se ha esito positivo o -1 se non è selezionata alcuna scheda.

CTabCtrl::GetExtendedStyle

Recupera gli stili estesi attualmente in uso per il controllo struttura a schede.

DWORD GetExtendedStyle();

Valore restituito

Rappresenta gli stili estesi attualmente in uso per il controllo struttura a schede. Questo valore è una combinazione di stili estesi del controllo struttura a schede, come descritto in Windows SDK.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TCM_GETEXTENDEDSTYLEWin32 , come descritto in Windows SDK.

CTabCtrl::GetImageList

Recupera l'elenco di immagini associato a una struttura a schede.

CImageList* GetImageList() const;

Valore restituito

In caso di esito positivo, un puntatore all'elenco di immagini del controllo struttura a schede; in caso contrario, NULL.

CTabCtrl::GetItem

Recupera informazioni su una scheda in un controllo struttura a schede.

BOOL GetItem(int nItem,   TCITEM* pTabCtrlItem) const;

Parametri

nItem
Indice in base zero della scheda.

pTabCtrlItem
Puntatore a una TCITEM struttura utilizzata per specificare le informazioni da recuperare. Usato anche per ricevere informazioni sulla scheda. Questa struttura viene usata con le InsertItemfunzioni membro , GetIteme SetItem .

Valore restituito

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

Osservazioni:

Quando il messaggio viene inviato, il mask membro specifica gli attributi da restituire. Se il mask membro specifica il TCIF_TEXT valore, il pszText membro deve contenere l'indirizzo del buffer che riceve il testo dell'elemento e il cchTextMax membro deve specificare le dimensioni del buffer.

  • mask

    Valore che specifica i TCITEM membri della struttura da recuperare o impostare. Questo membro può essere zero o una combinazione dei valori seguenti:

    • TCIF_TEXTpszText: il membro è valido.
    • TCIF_IMAGEiImage: il membro è valido.
    • TCIF_PARAMlParam: il membro è valido.
    • TCIF_RTLREADING: il testo di viene visualizzato usando l'ordine di pszText lettura da destra a sinistra nei sistemi ebrei o arabi.
    • TCIF_STATEdwState: il membro è valido.

  • pszText

    Puntatore a una stringa con terminazione Null contenente il testo della scheda se la struttura contiene informazioni su una scheda. Se la struttura riceve informazioni, questo membro specifica l'indirizzo del buffer che riceve il testo della scheda.

  • cchTextMax

    Dimensione del buffer a pszTextcui punta . Questo membro viene ignorato se la struttura non riceve informazioni.

  • iImage Indicizzare nell'elenco di immagini del controllo struttura a schede oppure -1 se non è presente alcuna immagine per la scheda.

  • lParam

    Dati definiti dall'applicazione associati alla scheda. Se sono presenti più di 4 byte di dati definiti dall'applicazione per scheda, un'applicazione deve definire una struttura e usarla invece della TCITEM struttura. Il primo membro della struttura definita dall'applicazione deve essere una TCITEMHEADERstruttura. La TCITEMHEADER struttura è identica alla TCITEM struttura, ma senza il lParam membro . La differenza tra le dimensioni della struttura e le TCITEMHEADER dimensioni della struttura deve essere uguale al numero di byte aggiuntivi per scheda.

Esempio

// In this example a CTabCtrl data member, m_TabCtrl, changes the
// text of the tabs in the tab control.  A call to GetItem is used
// to get the current text, and then the text is changed.  A call
// to SetItem is used to update the tab with the new text.

void CTabDlg::OnChangeItem()
{
   TCITEM tcItem;
   CString pszString;

   //  Get text for the tab item.
   GetDlgItemText(IDC_ITEM_TEXT, pszString);

   //  Get the current tab item text.
   TCHAR buffer[256] = {0};
   tcItem.pszText = buffer;
   tcItem.cchTextMax = 256;
   tcItem.mask = TCIF_TEXT;
   m_TabCtrl.GetItem(0, &tcItem);
   TRACE(_T("Changing item text from %s to %s..."), tcItem.pszText, pszString);

   //  Set the new text for the item.
   tcItem.pszText = pszString.LockBuffer();

   //  Set the item in the tab control.
   m_TabCtrl.SetItem(0, &tcItem);

   pszString.UnlockBuffer();
}

CTabCtrl::GetItemCount

Recupera il numero di schede nel controllo Struttura a schede.

int GetItemCount() const;

Valore restituito

Numero di elementi nel controllo struttura a schede.

Esempio

Vedere l'esempio per CPropertySheet::GetTabControl.

CTabCtrl::GetItemRect

Recupera il rettangolo di delimitazione per la scheda specificata in un controllo struttura a schede.

BOOL GetItemRect(int nItem,   LPRECT lpRect) const;

Parametri

nItem
Indice in base zero dell'elemento della scheda.

lpRect
Puntatore a una RECT struttura che riceve il rettangolo di delimitazione della scheda. Queste coordinate usano la modalità di mapping corrente del viewport.

Valore restituito

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

Esempio

Vedere l'esempio per CPropertySheet::GetTabControl.

CTabCtrl::GetItemState

Recupera lo stato dell'elemento del controllo struttura a schede identificato da nItem.

DWORD GetItemState(
    int nItem,
    DWORD dwMask) const;

Parametri

nItem
Numero di indice in base zero dell'elemento per il quale recuperare le informazioni sullo stato.

dwMask
Maschera che specifica i flag di stato dell'elemento da restituire. Per un elenco di valori, vedi il membro mask della TCITEM struttura, come descritto in Windows SDK.

Valore restituito

Riferimento a un valore DWORD che riceve le informazioni sullo stato. I possibili valori sono i seguenti:

valore Descrizione
TCIS_BUTTONPRESSED L'elemento del controllo struttura a schede è selezionato.
TCIS_HIGHLIGHTED L'elemento del controllo struttura a schede è evidenziato e la scheda e il testo vengono disegnati utilizzando il colore di evidenziazione corrente. Quando si usa il colore di evidenziazione, si tratta di un'interpolazione reale, non di un colore dithering.

Osservazioni:

Lo stato di un elemento viene specificato dal dwState membro della TCITEM struttura.

CTabCtrl::GetRowCount

Recupera il numero corrente di righe in un controllo struttura a schede.

int GetRowCount() const;

Valore restituito

Numero di righe di schede nel controllo Struttura a schede.

Osservazioni:

Solo i controlli struttura a schede con lo TCS_MULTILINE stile possono avere più righe di schede.

CTabCtrl::GetToolTips

Recupera l'handle del controllo della descrizione comando associato a un controllo struttura a schede.

CToolTipCtrl* GetToolTips() const;

Valore restituito

Handle del controllo della descrizione comando se ha esito positivo; in caso contrario NULL, .

Osservazioni:

Un controllo Struttura a schede crea un controllo descrizione comando se ha lo TCS_TOOLTIPS stile. È anche possibile assegnare un controllo descrizione comando a un controllo struttura a schede usando la SetToolTips funzione membro.

CTabCtrl::HighlightItem

Imposta lo stato di evidenziazione di un elemento di tabulazione.

BOOL HighlightItem(int idItem,  BOOL fHighlight = TRUE);

Parametri

idItem
Indice in base zero di un elemento del controllo struttura a schede.

fHighlight
Valore che specifica lo stato di evidenziazione da impostare. Se questo valore è TRUE, la scheda è evidenziata; se FALSE, la scheda è impostata sullo stato predefinito.

Valore restituito

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

Osservazioni:

Questa funzione membro implementa il messaggio TCM_HIGHLIGHTITEMWin32 , come descritto in Windows SDK.

CTabCtrl::HitTest

Determina quale scheda, se presente, si trova nella posizione dello schermo specificata.

int HitTest(TCHITTESTINFO* pHitTestInfo) const;

Parametri

pHitTestInfo
Puntatore a una TCHITTESTINFO struttura, come descritto in Windows SDK, che specifica la posizione dello schermo da testare.

Valore restituito

Restituisce l'indice in base zero della scheda o -1 se nessuna scheda si trova nella posizione specificata.

CTabCtrl::InsertItem

Inserisce una nuova scheda in un controllo struttura a schede esistente.

LONG InsertItem(
    int nItem,
    TCITEM* pTabCtrlItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem,
    int nImage);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam,
    DWORD dwState,
    DWORD dwStateMask);

Parametri

nItem
Indice in base zero della nuova scheda.

pTabCtrlItem
Puntatore a una TCITEM struttura che specifica gli attributi della scheda.

lpszItem
Indirizzo di una stringa con terminazione Null contenente il testo della scheda.

nImage
Indice in base zero di un'immagine da inserire da un elenco di immagini.

nMask
Specifica gli TCITEM attributi della struttura da impostare. Può essere zero o una combinazione dei valori seguenti:

  • TCIF_TEXTpszText: il membro è valido.
  • TCIF_IMAGEiImage: il membro è valido.
  • TCIF_PARAMlParam: il membro è valido.
  • TCIF_RTLREADING: il testo di viene visualizzato usando l'ordine di pszText lettura da destra a sinistra nei sistemi ebrei o arabi.
  • TCIF_STATEdwState: il membro è valido.

lParam
Dati definiti dall'applicazione associati alla scheda.

dwState
Specifica i valori per gli stati dell'elemento. Per altre informazioni, vedere TCITEM in Windows SDK.

dwStateMask
Specifica gli stati da impostare. Per altre informazioni, vedere TCITEM in Windows SDK.

Valore restituito

Indice in base zero della nuova scheda in caso di esito positivo; in caso contrario -1.

Esempio

TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");

m_TabCtrl.InsertItem(0, &tcItem);

CTabCtrl::RemoveImage

Rimuove l'immagine specificata dall'elenco di immagini di un controllo struttura a schede.

void RemoveImage(int nImage);

Parametri

nImage
Indice in base zero dell'immagine da rimuovere.

Osservazioni:

Il controllo struttura a schede aggiorna l'indice dell'immagine di ogni scheda in modo che ogni scheda rimanga associata alla stessa immagine.

CTabCtrl::SetCurFocus

Imposta lo stato attivo su una scheda specificata in un controllo struttura a schede.

void SetCurFocus(int nItem);

Parametri

nItem
Specifica l'indice della scheda che ottiene lo stato attivo.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TCM_SETCURFOCUSWin32 , come descritto in Windows SDK.

CTabCtrl::SetCurSel

Seleziona una scheda in un controllo struttura a schede.

int SetCurSel(int nItem);

Parametri

nItem
Indice in base zero dell'elemento da selezionare.

Valore restituito

Indice in base zero della scheda selezionata in precedenza, in caso contrario -1.

Osservazioni:

Un controllo struttura a schede non invia un TCN_SELCHANGING messaggio di notifica o TCN_SELCHANGE quando viene selezionata una scheda tramite questa funzione. Queste notifiche vengono inviate, usando WM_NOTIFY, quando l'utente fa clic o usa la tastiera per modificare le schede.

CTabCtrl::SetExtendedStyle

Imposta gli stili estesi per un controllo struttura a schede.

DWORD SetExtendedStyle(DWORD dwNewStyle, DWORD dwExMask = 0);

Parametri

dwNewStyle
Valore che specifica una combinazione di stili estesi del controllo struttura a schede.

dwExMask
Valore DWORD che indica quali stili in dwNewStyle devono essere interessati. Verranno modificati solo gli stili estesi in dwExMask . Tutti gli altri stili verranno mantenuti così come sono. Se questo parametro è zero, verranno interessati tutti gli stili in dwNewStyle .

Valore restituito

Valore DWORD che contiene gli stili estesi del controllo struttura a schede precedente, come descritto in Windows SDK.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TCM_SETEXTENDEDSTYLEWin32 , come descritto in Windows SDK.

CTabCtrl::SetImageList

Assegna un elenco di immagini a un controllo struttura a schede.

CImageList* SetImageList(CImageList* pImageList);

Parametri

pImageList
Puntatore all'elenco di immagini da assegnare al controllo struttura a schede.

Valore restituito

Restituisce un puntatore all'elenco di immagini precedente o NULL se non è presente alcun elenco di immagini precedente.

CTabCtrl::SetItem

Imposta alcuni o tutti gli attributi di una scheda.

BOOL SetItem(int nItem,   TCITEM* pTabCtrlItem);

Parametri

nItem
Indice in base zero dell'elemento.

pTabCtrlItem
Puntatore a una TCITEM struttura che contiene gli attributi del nuovo elemento. Il mask membro specifica gli attributi da impostare. Se il mask membro specifica il TCIF_TEXT valore, il pszText membro è l'indirizzo di una stringa con terminazione Null e il cchTextMax membro viene ignorato.

Valore restituito

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

Esempio

Vedere l'esempio per GetItem.

CTabCtrl::SetItemExtra

Imposta il numero di byte per scheda riservati ai dati definiti dall'applicazione in un controllo struttura a schede.

BOOL SetItemExtra(int nBytes);

Parametri

nBytes
Numero di byte aggiuntivi da impostare.

Valore restituito

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

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TCM_SETITEMEXTRAWin32 , come descritto in Windows SDK.

CTabCtrl::SetItemSize

Imposta la larghezza e l'altezza degli elementi di controllo della scheda.

CSize SetItemSize(CSize size);

Parametri

size
La nuova larghezza e altezza, in pixel, degli elementi di controllo della scheda.

Valore restituito

Restituisce la larghezza e l'altezza precedenti degli elementi di controllo della scheda.

CTabCtrl::SetItemState

Imposta lo stato dell'elemento del controllo struttura a schede identificato da nItem.

BOOL SetItemState(
    int nItem,
    DWORD dwMask,
    DWORD dwState);

Parametri

nItem
Numero di indice in base zero dell'elemento per il quale impostare le informazioni sullo stato.

dwMask
Maschera che specifica i flag di stato dell'elemento da impostare. Per un elenco di valori, vedi il membro mask della TCITEM struttura, come descritto in Windows SDK.

dwState
Riferimento a un valore DWORD contenente le informazioni sullo stato. I possibili valori sono i seguenti:

valore Descrizione
TCIS_BUTTONPRESSED L'elemento del controllo struttura a schede è selezionato.
TCIS_HIGHLIGHTED L'elemento del controllo struttura a schede è evidenziato e la scheda e il testo vengono disegnati utilizzando il colore di evidenziazione corrente. Quando si usa il colore di evidenziazione, si tratta di un'interpolazione reale, non di un colore dithering.

Valore restituito

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

CTabCtrl::SetMinTabWidth

Imposta la larghezza minima degli elementi in un controllo struttura a schede.

int SetMinTabWidth(int cx);

Parametri

cx
Larghezza minima da impostare per un elemento del controllo struttura a schede. Se questo parametro è impostato su -1, il controllo userà la larghezza della scheda predefinita.

Valore restituito

Larghezza minima della scheda precedente.

Osservazioni:

Questa funzione membro implementa il comportamento del messaggio TCM_SETMINTABWIDTHWin32 , come descritto in Windows SDK.

CTabCtrl::SetPadding

Imposta la quantità di spazio (spaziatura interna) intorno all'icona e all'etichetta di ogni scheda in un controllo struttura a schede.

void SetPadding(CSize size);

Parametri

size
Imposta la quantità di spazio (spaziatura interna) intorno all'icona e all'etichetta di ogni scheda in un controllo struttura a schede.

CTabCtrl::SetToolTips

Assegna un controllo descrizione comando a un controllo struttura a schede.

void SetToolTips(CToolTipCtrl* pWndTip);

Parametri

pWndTip
Handle del controllo della descrizione comando.

Osservazioni:

È possibile ottenere il controllo della descrizione comando associato a un controllo struttura a schede effettuando una chiamata a GetToolTips.

Esempio

Vedere l'esempio per CPropertySheet::GetTabControl.

Vedi anche

CWnd Classe
CHeaderCtrl Classe
CListCtrl Classe
Grafico della gerarchia