Share via


TabCtrl_InsertItem (Compact 2013)

3/28/2014

This macro inserts a new tab in a tab control. You can use this macro or send the TCM_INSERTITEM message explicitly.

Syntax

int TabCtrl_InsertItem( 
  HWND hwnd, 
  int iItem, 
  const TCITEM FAR* pitem 
);

Parameters

  • hwnd
    Handle to the tab control.
  • iItem
    Index of the new tab.
  • pitem
    Pointer to a TCITEM structure that specifies the attributes of the tab. The dwState and dwStateMask members of this structure are ignored by this message.

Return Value

The index of the new tab indicates success. -1 indicates failure.

Requirements

Header

commctrl.h

See Also

Reference

Tab Controls Macros
TCM_INSERTITEM
TCITEM