CTabCtrl::InsertItem
Wstawia nową kartę istniejącego formantu karty.
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
Wyświetlanego nową kartę.pTabCtrlItem
Wskaźnik do TCITEM strukturę, która określa atrybuty karty.lpszItem
Adres ciąg zakończony znakiem null, który zawiera tekst na karcie.nImage
Wyświetlanego obrazu z listy obrazu.nMask
Określa, które TCITEM atrybuty ustawić strukturę.Może być zero lub kombinacją następujących wartości:TCIF_TEXTPszText Członkowskich jest prawidłowy.
TCIF_IMAGEiImage Członkowskich jest prawidłowy.
TCIF_PARAMLParam Członkowskich jest prawidłowy.
TCIF_RTLREADINGTekst pszText jest wyświetlany przy użyciu kolejność czytania od prawej do lewej w systemach języka hebrajskiego lub arabskiego.
TCIF_STATEDwState Członkowskich jest prawidłowy.
lParam
Definicja aplikacji dane skojarzone z karcie.dwState
Określa wartości elementu Państwa.Aby uzyskać więcej informacji, zobacz TCITEM w Windows SDK.dwStateMask
Określa, które Państwa powinny zostać przedstawione.Aby uzyskać więcej informacji, zobacz TCITEM w Windows SDK.
Wartość zwracana
Wyświetlanego w nowej karcie w przypadku powodzenia; w przeciwnym razie – 1.
Przykład
TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");
m_TabCtrl.InsertItem(0, &tcItem);
Wymagania
Nagłówek: afxcmn.h