Share via

CTabCtrl::InsertItem

  • Article

BOOLInsertItem(intnItem**,TCITEM*pTabCtrlItem);**

BOOL InsertItem( int nItem**, LPCTSTR** lpszItem );

BOOL InsertItem( int nItem**, LPCTSTR** lpszItem**, int** nImage );

BOOL InsertItem( UINT nMask**, int** nItem**, LPCTSTR** lpszItem**, int** nImage**, LPARAM** lParam );

Return Value

Zero-based index of the new tab if successful; otherwise  – 1.

Parameters

nItem

Zero-based index of the new tab.

pTabCtrlItem

Pointer to a structure that specifies the attributes of the tab.

lpszItem

Pointer to the item to insert.

nImage

The zero-based index of an image to insert from an image list.

nMask

Specifies which TCITEM structure attributes to set. Can be zero or a combination of the following values:

  • TCIF_TEXT   The pszText member is valid.

  • TCIF_IMAGE   The iImage member is valid.

  • TCIF_PARAM   The lParam member is valid.

  • TCIF_RTLREADING   The text of pszText is displayed using right-to-left reading order on Hebrew or Arabic systems.

  • TCIF_STATE   The dwState member is valid.

lParam

Application-defined data associated with the tab.

Remarks

Call this function to insert a new tab in an existing tab control.

Example

BOOL CDialogDlg::OnInitDialog()
{
   // Other initialization.

   TCITEM tcItem;
   tcItem.mask = TCIF_TEXT;
   tcItem.pszText = _T("Tab #1");

   m_tabCtrl.InsertItem(0, &tcItem);

   return TRUE;  // Return TRUE unless you set the focus to a control.
}

CTabCtrl Overview |  Class Members |  Hierarchy Chart

See Also   CTabCtrl::GetItem, CTabCtrl::SetItem