通过

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

请参见

参考

CTabCtrl选件类

层次结构图

CTabCtrl::GetItem

CTabCtrl::SetItem