TC_ITEM

This structure specifies or receives the attributes of a tab, and is superseded by the TCITEM structure.

At a Glance

Header file: Commctrl.h
Windows CE versions: 1.0 and later

Syntax

typedef struct _TC_ITEM {
UINT
mask;
UINT
lpReserved1;
UINT
lpReserved2;
LPSTR
pszText;
int
cchTextMax;
int
iImage;
LPARAM
lParam;
} TC_ITEM;

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_PARAM The lParam member is valid.
TCIF_RTLREADING The text of pszText is displayed using right-to-left reading order on Hebrew or Arabic systems.
TCIF_STATE Version 4.70. The dwState member is valid.
TCIF_TEXT The pszText member is valid.

lpReserved1

Not used.

lpReserved2

Not used.

pszText

Pointer to a null-terminated string that contains the tab text when 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 in the tab control’s image list, or –1 if there is no image for the tab.

lParam

Application-defined data associated with the tab control item. If more or less than 4 bytes of application-defined data exist per tab, an application must define a structure and use it instead of the TC_ITEM structure. The first member of the application-defined structure must be a TCITEMHEADER structure.

See Also

TCM_GETITEM,TCM_INSERTITEM, TCM_SETITEM