通过

TVITEMEXA 结构 （commctrl.h）

  • 项目

指定或接收树视图项的属性。 此结构是对 tvITEM 结构的 增强。 新应用程序应适当地使用此结构。

语法

typedef struct tagTVITEMEXA {
  UINT      mask;
  HTREEITEM hItem;
  UINT      state;
  UINT      stateMask;
  LPSTR     pszText;
  int       cchTextMax;
  int       iImage;
  int       iSelectedImage;
  int       cChildren;
  LPARAM    lParam;
  int       iIntegral;
  UINT      uStateEx;
  HWND      hwnd;
  int       iExpandedImage;
  int       iReserved;
} TVITEMEXA, *LPTVITEMEXA;

成员

mask

类型：UINT

指示哪些其他结构成员包含有效数据的标志数组。 当此结构与 TVM_GETITEM 消息一起使用时，掩码 成员指示要检索的项属性。 如果与 TVM_SETITEM 消息一起使用，则 掩码 指示要设置的属性。 此成员可以是以下一个或多个值：

价值 意义
TVIF_CHILDREN
 cChildren 成员有效。
TVIF_DI_SETITEM
 树视图控件将保留所提供的信息，并且不会再次请求它。 此标志仅在处理 TVN_GETDISPINFO 通知时有效。
TVIF_EXPANDEDIMAGE

版本 6.00 和 Windows Vista。 iExpandedImage 成员 有效。
TVIF_HANDLE
 hItem 成员有效。
TVIF_IMAGE
 iImage 成员有效。
TVIF_INTEGRAL
 iIntegral 成员有效。
TVIF_PARAM
 lParam 成员有效。
TVIF_SELECTEDIMAGE
 iSelectedImage 成员有效。
TVIF_STATE
 状态 和 stateMask 成员有效。
TVIF_STATEEX

版本 6.00 和 Windows Vista。 uStateEx 成员 有效。
TVIF_TEXT
 pszText 和 cchTextMax 成员有效。

hItem

类型：HTREEITEM

项的句柄。

state

类型：UINT

指示项状态的位标志和图像列表索引集。 设置项的状态时，stateMask 成员指示此成员的有效位。 检索项的状态时，此成员返回 stateMask 成员中指示的位的当前状态。 有关此成员的详细信息，请参阅备注部分。

此成员的位 0 到 7 包含项状态标志。 有关可能的项状态标志的列表，请参阅 Tree-View 控制项状态。

此成员的位 8 到 11 指定基于一个的覆盖图像索引。 覆盖图像叠加在项的图标图像上。 如果这些位为零，则该项没有覆盖图像。 若要隔离这些位，请使用 TVIS_OVERLAYMASK 掩码。 若要在此成员中设置覆盖图像索引，请使用 INDEXTOOVERLAYMASK 宏。 使用 ImageList_SetOverlayImage 函数设置图像列表的覆盖图像。

状态图像显示在项的图标旁边，以指示应用程序定义的状态。 通过发送 TVM_SETIMAGELIST 消息来指定状态映像列表。 若要设置项的状态图像，请在 TVITEM 结构的 stateMask 成员中包含 TVIS_STATEIMAGEMASK 值。 结构 状态 成员的位 12 到 15 位指定要绘制的图像的状态图像列表中的索引。

若要设置状态图像索引，请使用 INDEXTOSTATEIMAGEMASK。 此宏采用索引并相应地设置位 12 到 15。 若要指示该项没有状态图像，请将索引设置为零。 此约定意味着状态映像列表中的图像零不能用作状态映像。 若要隔离 状态 成员的 12 到 15 位，请使用 TVIS_STATEIMAGEMASK 掩码。

stateMask

类型：UINT

状态的位 有效成员。 如果要检索项的状态，请将 stateMask 成员的位设置为指示 状态 成员返回的位。 如果要设置项的状态，请设置 stateMask 成员的位，以指示要设置 状态 成员的位。 若要设置或检索项的覆盖图像索引，请设置 TVIS_OVERLAYMASK 位。 若要设置或检索项的状态图像索引，请设置 TVIS_STATEIMAGEMASK 位。

pszText

类型：LPTSTR

指向包含项文本（如果结构指定项属性）的 null 终止字符串的指针。 如果此成员是LPSTR_TEXTCALLBACK值，则父窗口负责存储名称。 在这种情况下，树视图控件在需要项文本显示、排序或编辑时向父窗口发送一个 TVN_GETDISPINFO 通知代码，并在项文本更改时 TVN_SETDISPINFO 通知代码。 如果结构正在接收项属性，则此成员是接收项文本的缓冲区的地址。 请注意，尽管树视图控件允许将任何长度字符串存储为项文本，但仅显示前 260 个字符。

cchTextMax

类型：int

pszText 成员指向的缓冲区的大小（以字符为单位）。 如果此结构用于设置项属性，则忽略此成员。

iImage

类型：int

当项处于非选定状态时要使用的图标图像的树视图控件图像列表中的索引。 如果此成员是I_IMAGECALLBACK值，则父窗口负责存储索引。 在这种情况下，树视图控件会向父级发送一个 TVN_GETDISPINFO 通知代码，以在需要显示图像时检索索引。

iSelectedImage

类型：int

当项处于选定状态时要使用的图标图像的树视图控件图像列表中的索引。 如果此成员是I_IMAGECALLBACK值，则父窗口负责存储索引。 在这种情况下，树视图控件会向父级发送一个 TVN_GETDISPINFO 通知代码，以在需要显示图像时检索索引。

cChildren

类型：int

指示该项是否具有关联的子项的标志。 此成员可以是以下值之一：

价值 意义
零
 该项没有子项。
一个
 该项具有一个或多个子项。
I_CHILDRENCALLBACK
 父窗口会跟踪该项是否具有子项。 在这种情况下，当树视图控件需要显示项时，控件会向父方发送一个 TVN_GETDISPINFO 通知代码，以确定该项是否具有子项。 如果树视图控件具有 TVS_HASBUTTONS 样式，则它使用此成员来确定是否显示指示子项存在的按钮。 您可以使用此成员强制控件显示按钮，即使该项没有插入任何子项。 这样，只有在项可见或展开时，才能通过插入子项来最小化控件的内存使用量，从而显示按钮。
I_CHILDRENAUTO

版本 6.0供内部使用;不建议在应用程序中使用。 树视图控件会自动确定该项是否具有子项。

注意 此标志在 Comctl32.dll的未来版本中可能不受支持。 此外，未在 commctrl.h 中定义此标志。 将以下定义添加到应用程序的源文件以使用标志：
#define I_CHILDRENAUTO (-2)
 

lParam

类型：LPARAM

要与项关联的值。

iIntegral

类型：int

项目的高度，以标准项高度的倍数为单位（请参阅 TVM_SETITEMHEIGHT）。 例如，将此成员设置为 2 将为项目提供标准高度的两倍。 树视图控件不会在项目内容下方的额外区域中绘制，但当使用 自定义绘图时，应用程序可以使用此空间进行绘图。 不使用自定义绘图的应用程序应将此值设置为 1，否则行为是未定义的。

uStateEx

类型：UINT

Internet Explorer 6 及更高版本。 以下扩展状态的一个或多个（按位组合）。

价值 意义
TVIS_EX_DISABLED
 Windows Vista 及更高版本。 创建以灰色绘制的控件，用户无法与之交互。
TVIS_EX_FLAT
 创建平面项 - 该项是虚拟的，在树中不可见;相反，其子级在树层次结构中的位置。 仅当将项添加到树视图控件时，此状态才有效。
TVIS_EX_HWND
 为项创建单独的 HWND。 仅当将项添加到树视图控件时，此状态才有效。

hwnd

类型：HWND

Internet Explorer 6 及更高版本。 未使用;必须为 NULL。

iExpandedImage

类型：int

Internet Explorer 6 及更高版本。 控件图像列表中图像的索引，当项处于展开状态时显示。

iReserved

类型：int

保留成员。 请勿使用。

言论

注意

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

要求

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

另请参阅

添加 Tree-View 项