通过

TCITEMHEADERA 结构 （commctrl.h）

  • 项目

指定或接收选项卡的属性。它与 TCM_INSERTITEM、TCM_GETITEM和 TCM_SETITEM 消息一起使用。 此结构取代 TC_ITEMHEADER 结构。

语法

typedef struct tagTCITEMHEADERA {
  UINT  mask;
  UINT  lpReserved1;
  UINT  lpReserved2;
  LPSTR pszText;
  int   cchTextMax;
  int   iImage;
} TCITEMHEADERA, *LPTCITEMHEADERA;

成员

mask

类型：UINT

指定要检索或设置的成员的值。 此成员可以是以下值的组合：

价值 意义
TCIF_IMAGE
 iImage 成员有效。
TCIF_RTLREADING
 pszText 指向的字符串将显示在父窗口中文本的方向相反。
TCIF_TEXT
 pszText 成员有效。

lpReserved1

类型：UINT

保留成员。 请勿使用。

lpReserved2

类型：UINT

保留成员。 请勿使用。

pszText

类型：LPTSTR

如果设置了项信息，则包含选项卡文本的 null 终止字符串的地址。 如果正在检索项信息，则此成员指定接收选项卡文本的缓冲区的地址。

cchTextMax

类型：int

pszText 成员指向的缓冲区的大小。 如果结构未接收信息，则忽略此成员。

iImage

类型：int

在选项卡控件的图像列表中编制索引，或者如果没有选项卡的图像，则 -1。

言论

通常，窗口显示从左到右的文本（LTR）。 Windows 可以 镜像 来显示从右到左（RTL）的希伯来语或阿拉伯语等语言。 通常，pszText 将以与其父窗口中的文本相同的方向显示。 如果设置了TCIF_RTLREADING，pszText 将从父窗口中的文本相反方向读取。

注意

commctrl.h 标头将 TCITEMHEADER 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
标头 commctrl.h