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 :

iRetImageIndex

Type : int

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

Configuration requise