TreeView_CreateDragImage makro (commctrl.h)

Artikel
10/24/2024

Membuat bitmap seret untuk item yang ditentukan dalam kontrol tampilan pohon. Makro juga membuat daftar gambar untuk bitmap dan menambahkan bitmap ke daftar gambar. Aplikasi dapat menampilkan gambar saat menyeret item dengan menggunakan fungsi daftar gambar. Anda dapat menggunakan makro ini atau mengirim pesan TVM_CREATEDRAGIMAGE secara eksplisit.

Sintaksis

HIMAGELIST TreeView_CreateDragImage(
   HWND      hwnd,
   HTREEITEM hitem
);

Parameter

hwnd

Jenis: HWND

Tangani ke kontrol tampilan pohon.

hitem

Jenis: HTREEITEM

Tangani ke item yang menerima bitmap seret baru.

Mengembalikan nilai

Jenis: HIMAGELIST

Mengembalikan handel ke daftar gambar tempat bitmap yang diseret ditambahkan jika berhasil, atau NULL sebaliknya.

Komentar

Jika Anda membuat kontrol tampilan pohon tanpa daftar gambar terkait, Anda tidak dapat menggunakan makro TreeView_CreateDragImage untuk membuat gambar yang akan ditampilkan selama operasi seret. Anda harus menerapkan metode Anda sendiri untuk membuat kursor seret.

Aplikasi Anda bertanggung jawab untuk menghancurkan daftar gambar ketika tidak lagi diperlukan.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	commctrl.h

Bagikan melalui