Share via

TabCtrl_InsertItem

  • Article

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

int TabCtrl_InsertItem( 
HWND hwnd, 
int iItem, 
const TC_ITEM 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 Values

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

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Commctrl.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

TCM_INSERTITEM, TCITEM

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.