title

description

ms.assetid

keywords

topic_type

api_name

api_location

api_type

ms.topic

ms.date

TCM_INSERTITEM message (Commctrl.h)

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

e547c49a-699c-4137-8680-20391d138d54

TCM_INSERTITEM message Windows Controls

apiref

TCM_INSERTITEM

TCM_INSERTITEMA

TCM_INSERTITEMW

Commctrl.h

HeaderDef

reference

05/31/2018

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.

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

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)