Estructura NMTVASYNCDRAW (commctrl.h)

Contiene una explicación de por qué se produjo un error en el dibujo de un icono o un elemento de árbol de superposición. Esta estructura se envía en una notificación de TVN_ASYNCDRAW . Establezca el miembro dwRetFlags para indicar qué acción debe realizar el control. Tenga en cuenta que un dibujo puede producir un error si no hay ninguna imagen; es decir, cuando no se ha extraído la imagen de icono.

Sintaxis

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

Miembros

hdr

Tipo: NMHDR

Estructura NMHDR .

pimldp

Tipo: IMAGELISTDRAWPARAMS*

ESTRUCTURA IMAGELISTDRAWPARAMS que describe la imagen que no se pudo dibujar.

hr

Tipo: HRESULT

Código de resultado que indica por qué se produjo un error en el dibujo, ya sea ILDRF_IMAGELOWQUALITY, ILDRF_OVERLAYLOWQUALITY, E_PENDING o S_OK. Un código de S_OK indica que la imagen está presente, pero no en la calidad de imagen necesaria.

hItem

Tipo: HTREEITEM

Identificador del elemento de árbol que no se pudo dibujar.

lParam

Tipo: LPARAM

Datos de hItem. Estos son los mismos datos para el elemento que se recupera con el mensaje TVM_GETITEM usando la máscara adecuada en la estructura TVITEM. Estos datos son específicos de los elementos primarios; el elemento primario puede almacenar información que le ayude a identificar el elemento de árbol u otra información. Los datos se proporcionan en lParam para mayor comodidad, de modo que el elemento primario no necesite enviar TVM_GETITEM de mensajes.

dwRetFlags

Tipo: DWORD

Acción que el remitente (el control de vista de árbol) debe ejecutarse al devolver. El valor debe ser una de las siguientes marcas:

Valor	Significado
ADRF_DRAWIMAGE	Dibuje la imagen especificada por iRetImageIndex.
ADRF_DRAWSYNC	Continúe para dibujar la imagen de todos modos, es decir, extraer sincrónicamente la imagen y la pintura. Suponiendo que el control está en el subproceso de la interfaz de usuario, el uso de esta marca implica un rendimiento de interfaz de usuario de prioridad baja, ya que los tiempos de extracción pueden variar y la interfaz de usuario podría no responder durante un período prolongado de tiempo durante la extracción.
ADRF_DRAWNOTHING	No dibuje una imagen.

iRetImageIndex

Tipo: int

Índice de la imagen que se va a dibujar en la lista de imágenes. Se usa si ADRF_DRAWIMAGE se devuelve en dwRetFlags.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	commctrl.h