Struttura NMTVASYNCDRAW (commctrl.h)

Contiene una spiegazione del motivo per cui il disegno di un elemento dell'albero di sovrapposizione o icona non è riuscito. Questa struttura viene inviata in una notifica di TVN_ASYNCDRAW . Impostare il membro dwRetFlags per indicare quale azione deve eseguire il controllo. Si noti che un disegno può non riuscire se non è presente alcuna immagine; in altre parole, quando l'immagine dell'icona non è stata estratta.

Sintassi

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

Members

hdr

Tipo: NMHDR

Struttura NMHDR.

pimldp

Tipo: IMAGELISTDRAWPARAMS*

Struttura IMAGELISTDRAWPARAMS che descrive l'immagine che non è riuscita a disegnare.

hr

Tipo: HRESULT

Codice di risultato che indica il motivo per cui il disegno non è riuscito, ILDRF_IMAGELOWQUALITY, ILDRF_OVERLAYLOWQUALITY, E_PENDING o S_OK. Un codice di S_OK indica che l'immagine è presente ma non alla qualità dell'immagine richiesta.

hItem

Tipo: HTREEITEM

Handle dell'elemento della struttura ad albero che non è riuscito a disegnare.

lParam

Tipo: LPARAM

Dati per hItem. Si tratta degli stessi dati per l'elemento recuperato con il messaggio TVM_GETITEM utilizzando la maschera appropriata nella struttura TVITEM. Questi dati sono specifici dell'elemento padre; l'elemento padre può archiviare informazioni che consentono di identificare l'elemento della struttura ad albero o altre informazioni. I dati vengono forniti in lParam per praticità, in modo che l'elemento padre non debba inviare messaggi TVM_GETITEM.

dwRetFlags

Tipo: DWORD

Azione che il mittente (il controllo visualizzazione albero) deve essere eseguito al ritorno. Il valore deve essere uno dei flag seguenti:

Valore	Significato
ADRF_DRAWIMAGE	Disegnare l'immagine specificata da iRetImageIndex.
ADRF_DRAWSYNC	Continuare a disegnare comunque l'immagine, ovvero estrarre in modo sincrono l'immagine e disegnare. Supponendo che il controllo si trova nel thread dell'interfaccia utente, l'uso di questo flag implica prestazioni dell'interfaccia utente con priorità bassa, poiché i tempi di estrazione possono variare e l'interfaccia utente potrebbe non rispondere per un lungo periodo di tempo durante l'estrazione.
ADRF_DRAWNOTHING	Non disegnare un'immagine.

iRetImageIndex

Tipo: int

Indice dell'immagine da disegnare nell'elenco di immagini. Utilizzato se ADRF_DRAWIMAGE viene restituito in dwRetFlags.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	commctrl.h