NMTVASYNCDRAW-Struktur (commctrl.h)

Enthält eine Erklärung, warum das Zeichnen eines Symbols oder eines Überlagerungsstrukturelements fehlgeschlagen ist. Diese Struktur wird mit einer TVN_ASYNCDRAW Benachrichtigung gesendet. Legen Sie den dwRetFlags-Member fest, um anzugeben, welche Aktion das Steuerelement ausführen soll. Beachten Sie, dass ein Zeichnen fehlschlagen kann, wenn kein Bild vorhanden ist. mit anderen Worten, wenn das Symbolbild nicht extrahiert wurde.

Syntax

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

Member

hdr

Typ: NMHDR

NMHDR-Struktur .

pimldp

Typ: IMAGELISTDRAWPARAMS*

IMAGELISTDRAWPARAMS-Struktur , die das Bild beschreibt, das nicht gezeichnet werden konnte.

hr

Typ: HRESULT

Ergebniscode, der angibt, warum das Zeichnen fehlgeschlagen ist, entweder ILDRF_IMAGELOWQUALITY, ILDRF_OVERLAYLOWQUALITY, E_PENDING oder S_OK. Ein Code von S_OK gibt an, dass das Bild vorhanden ist, aber nicht in der erforderlichen Bildqualität.

hItem

Typ: HTREEITEM

Handle des Strukturelements, das nicht gezeichnet werden konnte.

lParam

Typ: LPARAM

Daten für hItem. Dies sind die gleichen Daten für das Element, das mit der Nachricht abgerufen wird, TVM_GETITEM die entsprechende Maske in der Struktur TVITEM verwendet. Diese Daten sind elternspezifisch; Das übergeordnete Element kann Informationen speichern, mit denen das Strukturelement oder andere Informationen identifiziert werden können. Daten werden in lParam zur Vereinfachung bereitgestellt, sodass das übergeordnete Element keine Nachricht TVM_GETITEM senden muss.

dwRetFlags

Typ: DWORD

Aktion, die der Absender (das Strukturansichtssteuerelement) bei der Rückgabe ausführen soll. Der Wert muss eines der folgenden Flags sein:

Wert	Bedeutung
ADRF_DRAWIMAGE	Zeichnen Sie das durch iRetImageIndex angegebene Bild.
ADRF_DRAWSYNC	Fahren Sie trotzdem mit dem Zeichnen des Bilds fort, d. h. synchrones Extrahieren des Bilds und der Farbe. Angenommen, das Steuerelement befindet sich im UI-Thread, bedeutet die Verwendung dieses Flags die Leistung der Benutzeroberfläche mit niedriger Priorität, da die Extraktionszeiten variieren können und die Benutzeroberfläche während eines längeren Zeitraums während der Extraktion nicht reagiert.
ADRF_DRAWNOTHING	Zeichnen Sie kein Bild.

iRetImageIndex

Typ: int

Index des Bilds, das in der Bildliste gezeichnet werden soll. Wird verwendet, wenn ADRF_DRAWIMAGE in dwRetFlags zurückgegeben wird.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	commctrl.h