TCITEMHEADER

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

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; do not use.

  • lpReserved2
    Reserved; do not use.

  • 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 controls image list, or –1 if there is no image for the tab.

Remarks

This structure supersedes the TC_ITEMHEADER structure.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later Commctrl.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

TCM_INSERTITEM, TCM_GETITEM, TCM_SETITEM

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.