TC_ITEM

The TC_ITEM structure specifies or receives the attributes of a tab.

typedef struct _TC_ITEM {

UINT mask; // value specifying which members to retrieve or set

UINT lpReserved1; // reserved; do not use

UINT lpReserved2; // reserved; do not use

LPSTR pszText; // pointer to string containing tab text

int cchTextMax; // size of buffer pointed to by the pszText member

int iImage; // index to tab control's image

LPARAM lParam; // application-defined data associated with tab

} TC_ITEM;

Members

mask

Value specifying which members to retrieve or set. This member can be TCIF_ALL (meaning all members), or zero or more of the following values:

Value Meaning
TCIF_TEXT The pszText member is valid.
TCIF_IMAGE The iImage member is valid.
TCIF_PARAM The lParam member is valid.
TCIF_RTLREADING Displays the text of pszText using right-to-left reading order on Hebrew or Arabic systems.

lpReserved1

Reserved; do not use.

lpReserved2

Reserved; do not use.

pszText

Pointer to a null-terminated string that contains the tab text if the structure contains information about a tab. If the structure is receiving information, 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.

lParam

Application-defined data associated with the tab. If there are more or less than 4 bytes of application-defined data 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 TC_ITEMHEADER structure.

Remarks

This structure is used with the TCM_INSERTITEM, TCM_GETITEM, and TCM_SETITEM messages.

See Also

TCM_GETITEM, TCM_INSERTITEM, TC_ITEMHEADER, TCM_SETITEM