TCITEMHEADER structure

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

Syntax


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

Members

mask

Type: UINT

Value that specifies which members to retrieve or set. This member can be a combination of the following values:

ValueMeaning
TCIF_IMAGE

The iImage member is valid.

TCIF_RTLREADING

The string pointed to by pszText will be displayed in the direction opposite to the text in the parent window.

TCIF_TEXT

The pszText member is valid.

 

lpReserved1

Type: UINT

Reserved member. Do not use.

lpReserved2

Type: UINT

Reserved member. Do not use.

pszText

Type: LPTSTR

Address of 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

Type: int

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

iImage

Type: int

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

Remarks

Typically, windows display text left-to-right (LTR). Windows can be mirrored to display languages such as Hebrew or Arabic that read right-to-left (RTL). Ordinarily, pszText will be displayed in the same direction as the text in its parent window. If TCIF_RTLREADING is set, pszText will read in the opposite direction from the text in the parent window.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Commctrl.h

Unicode and ANSI names

TCITEMHEADERW (Unicode) and TCITEMHEADERA (ANSI)

 

 

Community Additions

ADD
Show:
© 2014 Microsoft