CTabCtrl::InsertItem
在現有的索引標籤控制項插入新的索引標籤。
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
);
參數
nItem
新的選取項目之以零起始的索引。pTabCtrlItem
為指定的 屬性的 TCITEM 結構的指標。lpszItem
包含 索引標籤上的文字之 null 結尾字串的位址。nImage
要插入的影像之以零起始的索引從影像清單中。nMask
指定 TCITEM 結構屬性 (Attribute) 設定為。 可以是下列零或多個值的組合:TCIF_TEXTpszText 成員有效。
TCIF_IMAGEiImage 成員有效。
TCIF_PARAMlParam 成員有效。
使用在希伯來文或阿拉伯文系統，以從右至左的讀取順序TCIF_RTLREADINGpszText 文字顯示。
TCIF_STATEdwState 成員有效。
lParam
應用程式定義的資料與索引標籤。dwState
為項目狀態指定值。 如需詳細資訊，請參閱 Windows SDK的 TCITEM 。dwStateMask
指定哪些狀態要設定屬性。 如需詳細資訊，請參閱 Windows SDK的 TCITEM 。
傳回值
新的選取項目之以零起始的索引，如果成功，則為– 1。
範例
TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");
m_TabCtrl.InsertItem(0, &tcItem);
需求
Header: afxcmn.h