CTabCtrl::InsertItem
Insère un nouvel onglet dans un contrôle onglet existant.
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
);
Paramètres
nItem
Index de base zéro de la nouvelle table.pTabCtrlItem
Pointeur vers une structure de TCITEM qui spécifie les attributs de la table.lpszItem
Adresse d'une chaîne terminée par le caractère NULL qui contient le texte de la table.nImage
L'index de base zéro d'une image à insérer dans une liste d'images.nMask
Spécifie que la structure d' TCITEM attributs au jeu. Peut être zéro ou une combinaison des valeurs suivantes :TCIF_TEXT le membre de pszText est valide.
TCIF_IMAGE le membre d' iImage est valide.
TCIF_PARAM le membre de LPARAM est valide.
TCIF_RTLREADING le texte de pszText est restitué à l'aide de l'ordre de lecture de droite à gauche sur les systèmes hébreux ou arabes.
TCIF_STATE le membre de dwState est valide.
lParam
Données définies par l'application associées à la table.dwState
Spécifie des valeurs pour les états de l'élément. Pour plus d'informations, consultez TCITEM dans Kit de développement logiciel Windows.dwStateMask
Spécifie les états doivent être définis. Pour plus d'informations, consultez TCITEM dans Kit de développement logiciel Windows.
Valeur de retour
Index de base zéro du nouvel onglet si l'opération a réussi ; sinon – 1.
Exemple
TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");
m_TabCtrl.InsertItem(0, &tcItem);
Configuration requise
Header: afxcmn.h