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

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

Value 含义
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