TCM_INSERTITEM

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

TCM_INSERTITEM wParam = (WPARAM)(int) iItem; 
    lParam = (LPARAM)(const TCITEM 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 dwStateMaskmembers of this structure are ignored by this message.

Return Value

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

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

TabCtrl_InsertItem
TCITEM