通过

NMTVASYNCDRAW 结构 (commctrl.h)

  • 项目

包含对图标或覆盖树项绘制失败的原因的说明。 此结构在 TVN_ASYNCDRAW 通知上发送。 设置 dwRetFlags 成员以指示控件应执行的操作。 请注意，如果没有图像，绘制可能会失败;换句话说，当图标图像尚未提取时。

语法

typedef struct tagNMTVASYNCDRAW {
  NMHDR               hdr;
  IMAGELISTDRAWPARAMS *pimldp;
  HRESULT             hr;
  HTREEITEM           hItem;
  LPARAM              lParam;
  DWORD               dwRetFlags;
  int                 iRetImageIndex;
} NMTVASYNCDRAW;

成员

hdr

类型： NMHDR

NMHDR 结构。

pimldp

类型： IMAGELISTDRAWPARAMS*

描述无法绘制的图像的 IMAGELISTDRAWPARAMS 结构。

hr

类型： HRESULT

指示绘图失败原因的结果代码，ILDRF_IMAGELOWQUALITY、ILDRF_OVERLAYLOWQUALITY、E_PENDING或S_OK。 S_OK代码指示图像存在，但未满足所需的图像质量。

hItem

类型： HTREEITEM

未能绘制的树项的句柄。

lParam

类型： LPARAM

hItem 的数据。 这与使用 TVITEM 结构中的相应掩码的消息TVM_GETITEM检索的项的数据相同。 此数据特定于父级;父级可以存储有助于标识树项或其他信息的信息。 为方便起见， lParam 中提供了数据，因此父级无需 TVM_GETITEM发送消息。

dwRetFlags

类型： DWORD

发送方 (树视图控件) 应在返回时执行的操作。 值必须是以下标志之一：

Value 含义
ADRF_DRAWIMAGE
 绘制 由 iRetImageIndex 指定的图像。
ADRF_DRAWSYNC
 继续绘制图像，即同步提取图像并绘制。 假设控件位于 UI 线程上，则使用此标志意味着 UI 性能优先级较低，因为提取时间可能会有所不同，并且 UI 可能在提取期间长时间无响应。
ADRF_DRAWNOTHING
 不要绘制图像。

iRetImageIndex

类型： int

在图像列表中绘制的图像的索引。 在 dwRetFlags 中返回ADRF_DRAWIMAGE时使用。

要求

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