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.

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.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Commctrl.h.

See Also

TabCtrl_InsertItem | TCITEM

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.