CTabCtrl::InsertItem
Vloží novou kartu existujícího ovládacího prvku karta.
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
);
Parametry
nItem
Z nuly vycházející index novou kartu.pTabCtrlItem
Ukazatel TCITEM struktury, která určuje atributy karty.lpszItem
Řetězec zakončený hodnotou null, který obsahuje text na kartě Adresa.nImage
Z nuly vycházející index obrázku vložit z seznam obrázků.nMask
Určuje, které TCITEM struktury nastavit atributy.Může být nula nebo kombinací následujících hodnot:TCIF_TEXTPszText je platný.
TCIF_IMAGE iImage Je platný.
TCIF_PARAMLParam je platný.
TCIF_RTLREADINGText pszText je zobrazena pomocí směr čtení zprava doleva v systémech pro hebrejštinu a arabštinu.
TCIF_STATEDwState je platný.
lParam
Definované aplikací data spojená s kartou.dwState
Určuje hodnoty pro položky státy.Další informace naleznete v TCITEM v .dwStateMask
Určuje, které státy mají být nastaveny.Další informace naleznete v TCITEM v .
Vrácená hodnota
Z nuly vycházející index nové kartě, pokud je úspěšná. jinak – 1.
Příklad
TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");
m_TabCtrl.InsertItem(0, &tcItem);
Požadavky
Záhlaví: afxcmn.h