共用方式為


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

請參閱

參考

CTabCtrl 類別

階層架構圖表

CTabCtrl::GetItem

CTabCtrl::SetItem