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 框架属性。 可以为零或以下值的组合: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