CTabCtrl::InsertItem

BOOL InsertItem( int nItem, 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 TCITEM 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.

CTabCtrl Overview |  Class Members |  Hierarchy Chart

See Also   CTabCtrl::GetItem, CTabCtrl::SetItem