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
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:
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 |