TCM_INSERTITEM

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

At a Glance

Header file: Commctrl.h
Windows CE versions: 1.0 and later
Related macro: TabCtrl_InsertItem

Syntax

  1. TCM_INSERTITEM wParam = (WPARAM)(int) iItem;
    lParam = (LPARAM)(const TC_ITEM FAR*) pitem;

Parameters

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 Values

The index of the new tab indicates success. –1 indicates otherwise.

See Also

TC_ITEM