Share via


TabCtrl_InsertItem

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This macro inserts a new tab in a tab control. You can use this macro or send the TCM_INSERTITEM message explicitly.

Syntax

int TabCtrl_InsertItem( 
  HWND hwnd, 
  int iItem, 
  const TCITEM FAR* pitem 
);

Parameters

  • hwnd
    Handle to the tab control.
  • 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 Value

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

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

TCM_INSERTITEM
TCITEM