TCITEMHEADER (Compact 2013)

3/28/2014

This structure specifies or receives the attributes of a tab. It is used with the TCM_INSERTITEM, TCM_GETITEM, and TCM_SETITEM messages.

Syntax

typedef struct tagTCITEMHEADER{
  UINT mask;
  UINT lpReserved1;
  UINT lpReserved2;
  LPTSTR pszText;
  int cchTextMax;
  int iImage;
} TCITEMHEADER, FAR* LPTCITEMHEADER;

Members

• mask
  Specifies which members to retrieve or set. It can be a combination of the following values.

  Value	Description
  TCIF_IMAGE	The iImage member is valid.
  TCIF_RTLREADING	The text of pszText is displayed using right-to-left reading order on Hebrew or Arabic systems.
  TCIF_TEXT	The pszText member is valid.

• lpReserved1
  Reserved.

• lpReserved2
  Reserved.

• pszText
  Pointer to a null-terminated string that contains the tab text if item information is being set. If item information is being retrieved, this member specifies the address of the buffer that receives the tab text.

• cchTextMax
  Size of the buffer pointed to by the pszText member. If the structure is not receiving information, this member is ignored.

• iImage
  Index into the tab control's image list, or -1 if there is no image for the tab.

Remarks

This structure supersedes the TC_ITEMHEADER structure.

Requirements

See Also

Reference

Tab Controls Structures
TCM_INSERTITEM
TCM_GETITEM
TCM_SETITEM