Structure NMTVASYNCDRAW (commctrl.h)

Contient une explication de l’échec du dessin d’une icône ou d’un élément d’arborescence de superposition. Cette structure est envoyée sur une notification TVN_ASYNCDRAW . Définissez le membre dwRetFlags pour indiquer l’action que le contrôle doit effectuer. Notez qu’un dessin peut échouer s’il n’y a pas d’image ; en d’autres termes, lorsque l’image d’icône n’a pas été extraite.

Syntaxe

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

Membres

hdr

Type : NMHDR

Structure NMHDR .

pimldp

Type : IMAGELISTDRAWPARAMS*

STRUCTURE IMAGELISTDRAWPARAMS décrivant l’image qui n’a pas pu être dessinée.

hr

Type : HRESULT

Code de résultat indiquant la raison de l’échec du dessin, ILDRF_IMAGELOWQUALITY, ILDRF_OVERLAYLOWQUALITY, E_PENDING ou S_OK. Un code de S_OK indique que l’image est présente, mais pas à la qualité d’image requise.

hItem

Type : HTREEITEM

Handle de l’élément d’arborescence qui n’a pas pu dessiner.

lParam

Type : LPARAM

Données pour hItem. Il s’agit des mêmes données pour l’élément récupéré avec le message TVM_GETITEM à l’aide du masque approprié dans la structure TVITEM. Ces données sont spécifiques au parent ; le parent peut stocker des informations qui l’aident à identifier l’élément d’arborescence ou d’autres informations. Les données sont fournies dans lParam pour des raisons pratiques, de sorte que le parent n’a pas besoin d’envoyer de message TVM_GETITEM.

dwRetFlags

Type : DWORD

Action que l’expéditeur (le contrôle d’arborescence) doit exécuter au retour. La valeur doit être l’un des indicateurs suivants :

Valeur	Signification
ADRF_DRAWIMAGE	Dessinez l’image spécifiée par iRetImageIndex.
ADRF_DRAWSYNC	Continuez quand même à dessiner l’image, c’est-à-dire extraire de façon synchrone l’image et peindre. En supposant que le contrôle se trouve sur le thread d’interface utilisateur, l’utilisation de cet indicateur implique des performances d’interface utilisateur de faible priorité, car les temps d’extraction peuvent varier et l’interface utilisateur peut ne pas répondre pendant une période prolongée pendant l’extraction.
ADRF_DRAWNOTHING	Ne dessinez pas d’image.

iRetImageIndex

Type : int

Index de l’image à dessiner dans la liste d’images. Utilisé si ADRF_DRAWIMAGE est retourné dans dwRetFlags.

Configuration requise

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	commctrl.h