TabCtrl_GetItem

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This macro retrieves information about a tab in a tab control. You can use this macro or send the TCM_GETITEM message explicitly.

Syntax

BOOL TabCtrl_GetItem( 
  HWND hwnd, 
  int iItem, 
  TCITEM FAR* pitem 
);

Parameters

  • hwnd
    Handle to the tab control.
  • iItem
    Index of the tab.
  • pitem
    Pointer to a TCITEM structure that specifies the information to retrieve and receives information about the tab. When the message is sent, the mask member specifies which attributes to return.

    If the mask member specifies the TCIF_TEXT value, the pszText member must contain the address of the buffer that receives the item text, and the cchTextMax member must specify the size of the buffer.

Return Value

TRUE indicates success. FALSE 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_GETITEM
TCITEM