Struktur NMTVASYNCDRAW (commctrl.h)

Berisi penjelasan mengapa gambar ikon atau item pohon overlay gagal. Struktur ini dikirim pada pemberitahuan TVN_ASYNCDRAW . Atur anggota dwRetFlags untuk menunjukkan tindakan apa yang harus dilakukan kontrol. Perhatikan bahwa gambar dapat gagal jika tidak ada gambar; dengan kata lain, ketika gambar ikon belum diekstrak.

Sintaks

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

Anggota

hdr

Jenis: NMHDR

Struktur NMHDR .

pimldp

Jenis: IMAGELISTDRAWPARAMS*

Struktur IMAGELISTDRAWPARAMS yang menjelaskan gambar yang gagal digambar.

hr

Jenis: HRESULT

Kode hasil menunjukkan mengapa gambar gagal, baik ILDRF_IMAGELOWQUALITY, ILDRF_OVERLAYLOWQUALITY, E_PENDING, atau S_OK. Kode S_OK menunjukkan bahwa gambar ada tetapi tidak pada kualitas gambar yang diperlukan.

hItem

Jenis: HTREEITEM

Handel item pohon yang gagal digambar.

lParam

Jenis: LPARAM

Data untuk hItem. Ini adalah data yang sama untuk item yang diambil dengan pesan TVM_GETITEM menggunakan masker yang sesuai dalam struktur TVITEM. Data ini khusus untuk induk; induk dapat menyimpan informasi yang membantunya mengidentifikasi item pohon atau informasi lainnya. Data disediakan di lParam untuk kenyamanan, sehingga induk tidak perlu mengirim pesan TVM_GETITEM.

dwRetFlags

Jenis: DWORD

Tindakan yang harus dijalankan pengirim (kontrol tampilan pohon) saat dikembalikan. Nilai harus berupa salah satu bendera berikut:

Nilai	Makna
ADRF_DRAWIMAGE	Gambar gambar yang ditentukan oleh iRetImageIndex.
ADRF_DRAWSYNC	Lanjutkan untuk menggambar gambar, yaitu, secara sinkron mengekstrak gambar dan cat. Dengan asumsi kontrol berada pada utas UI, penggunaan bendera ini menyiratkan performa UI prioritas rendah, karena waktu ekstraksi dapat bervariasi dan UI bisa tidak responsif untuk jangka waktu yang lama selama ekstraksi.
ADRF_DRAWNOTHING	Jangan menggambar gambar.

iRetImageIndex

Jenis: int

Indeks gambar yang akan digambar dalam daftar gambar. Digunakan jika ADRF_DRAWIMAGE dikembalikan dalam dwRetFlags.

Persyaratan

Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	commctrl.h