NMLVGETINFOTIPA 结构 (commctrl.h)

  • 项目

包含并接收显示项的工具提示所需的列表视图项信息。 此结构与 LVN_GETINFOTIP 通知代码一起使用。

语法

typedef struct tagNMLVGETINFOTIPA {
  NMHDR  hdr;
  DWORD  dwFlags;
  LPSTR  pszText;
  int    cchTextMax;
  int    iItem;
  int    iSubItem;
  LPARAM lParam;
} NMLVGETINFOTIPA, *LPNMLVGETINFOTIPA;

成员

hdr

类型： NMHDR

包含有关此通知代码的信息的 NMHDR 结构。

dwFlags

类型： DWORD

零或LVGIT_UNFOLDED。 请参阅“备注”。

pszText

类型： LPTSTR

接收任何其他文本信息的字符串缓冲区的地址。 如果 dwFlags 为零，则此成员将包含现有项文本。 在这种情况下，应在此字符串的末尾追加任何其他文本。 此缓冲区的大小由 cchTextMax 结构指定。

cchTextMax

类型： int

pszText 指向的缓冲区的大小（以字符为单位）。 虽然绝不应假定此缓冲区具有任何特定大小，但 INFOTIPSIZE 值可用于设计目的。

iItem

类型： int

此结构引用的项的从零开始的索引。

iSubItem

类型： int

此结构引用的子项的从 1 开始的索引。 如果此成员为零，则结构引用的是项，而不是子项。 此成员当前未使用，并且始终为零。

lParam

类型： LPARAM

与项关联的应用程序定义值。 此成员当前未使用，并且始终为零。

注解

当当前显示的文本被截断时，项目被说为折叠。 如果在 dwFlags 中返回LVGIT_UNFOLDED，则已显示项的全文，因此无需在工具提示中显示它。

注意

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

要求

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