TCITEMA 结构 (commctrl.h)

  • 项目

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

语法

typedef struct tagTCITEMA {
  UINT   mask;
  DWORD  dwState;
  DWORD  dwStateMask;
  LPSTR  pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} TCITEMA, *LPTCITEMA;

成员

mask

类型： UINT

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

值 含义
TCIF_IMAGE
 iImage 成员有效。
TCIF_PARAM
 lParam 成员有效。
TCIF_RTLREADING
 pszText 指向的字符串将以与父窗口中文本相反的方向显示。
TCIF_STATE

版本 4.70。 dwState 成员有效。
TCIF_TEXT
 pszText 成员有效。

dwState

类型： DWORD

版本 4.70。 指定项的当前状态（如果正在检索信息）。 如果正在设置项信息，则此成员包含要为项设置的状态值。 有关有效选项卡控件项状态的列表，请参阅 选项卡控件项状态。 在TCM_INSERTITEM消息中忽略此成员。

dwStateMask

类型： DWORD

版本 4.70。 指定 dwState 成员的哪些位包含有效信息。 在TCM_INSERTITEM消息中忽略此成员。

pszText

类型： LPTSTR

指向以 null 结尾的字符串的指针，该字符串在设置项信息时包含选项卡文本。 如果正在检索项信息，则此成员指定接收选项卡文本的缓冲区的地址。

cchTextMax

类型： int

pszText 成员指向的缓冲区的大小（以 TCHAR为单位）。 如果结构未接收信息，则忽略此成员。

iImage

类型： int

选项卡控件的图像列表中的索引;如果没有选项卡的图像，则为 -1。

lParam

类型： LPARAM

与选项卡控件项关联的应用程序定义数据。 如果每个选项卡存在超过或少于 4 个字节的应用程序定义数据，则应用程序必须定义一个结构并使用它，而不是 TCITEM 结构。 应用程序定义的结构的第一个成员必须是 TCITEMHEADER 结构。

注解

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

注意

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

要求

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