通过

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