Edit

Share via

TCM_INSERTITEM message

  • Article

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)