CTabCtrl::InsertItem
Inserisce una nuova scheda in un controllo scheda 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 a base zero della nuova scheda.pTabCtrlItem
Puntatore a una struttura TCITEM specificando gli attributi della scheda.lpszItem
Indirizzo di una stringa con terminazione null che contiene il testo della scheda.nImage
L'indice in base zero di un'immagine da inserire da un elenco.nMask
Specifica la struttura TCITEM attributi per impostare. Può essere zero o una combinazione dei valori seguenti:TCIF_TEXT il membro pszText è valido.
TCIF_IMAGE il membro iImage è valido.
TCIF_PARAM il membro lParam è valido.
TCIF_RTLREADING il testo pszText visualizzati utilizzando l'ordine di lettura da destra a sinistra nei sistemi l'arabo o l'ebraico.
TCIF_STATE il membro dwState è valido.
lParam
Dati definiti dall'applicazione associati alla scheda.dwState
Specifica i valori degli stati degli elementi. Per ulteriori informazioni, vedere TCITEM in Windows SDK.dwStateMask
Specifica che gli stati devono essere impostati. Per ulteriori informazioni, vedere TCITEM in Windows SDK.
Valore restituito
Indice a 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);
Requisiti
Header: afxcmn.h