TCM_INSERTITEM message

Inserts a new tab in a tab control. You can send this message explicitly or by using the TabCtrl_InsertItem macro.

Parameters

wParam

Index of the new tab.

lParam

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

Returns the index of the new tab if successful, or -1 otherwise.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	Commctrl.h
Unicode and ANSI names	TCM_INSERTITEMW (Unicode) and TCM_INSERTITEMA (ANSI)