STM_SETIMAGE pesan
Aplikasi mengirim pesan STM_SETIMAGE untuk mengaitkan gambar baru dengan kontrol statis.
Parameter
-
wParam
-
Menentukan jenis gambar yang akan dikaitkan dengan kontrol statis. Parameter ini bisa menjadi salah satu nilai berikut:
Nilai Makna - IMAGE_BITMAP
Bitmap. - IMAGE_CURSOR
Kursor. - IMAGE_ENHMETAFILE
Metafile yang ditingkatkan. - IMAGE_ICON
Ikon. -
lParam
-
Tangani ke gambar untuk dikaitkan dengan kontrol statis.
Nilai kembali
Nilai yang dikembalikan adalah handel ke gambar yang sebelumnya terkait dengan kontrol statis, jika ada; jika tidak, itu NULL.
Keterangan
Untuk mengaitkan gambar dengan kontrol statis, kontrol harus memiliki gaya yang tepat. Tabel berikut ini memperlihatkan gaya yang diperlukan untuk setiap jenis gambar.
Jenis citra | Gaya kontrol statis |
---|---|
IMAGE_BITMAP | SS_BITMAP |
IMAGE_CURSOR | SS_ICON |
IMAGE_ENHMETAFILE | SS_ENHMETAFILE |
IMAGE_ICON | SS_ICON |
Penting
Di versi 6 kontrol Microsoft Win32, bitmap yang diteruskan ke kontrol statis menggunakan pesan STM_SETIMAGE adalah bitmap yang sama yang dikembalikan oleh pesan STM_SETIMAGE berikutnya. Klien bertanggung jawab untuk menghapus bitmap apa pun yang dikirim ke kontrol statis.
Dengan Windows XP, jika bitmap yang diteruskan dalam pesan STM_SETIMAGE berisi piksel dengan alfa bukan nol, kontrol statis mengambil salinan bitmap. Bitmap yang disalin ini dikembalikan oleh pesan STM_SETIMAGE berikutnya. Kode klien dapat secara independen melacak bitmap yang diteruskan ke kontrol statis, tetapi jika tidak memeriksa dan melepaskan bitmap yang dikembalikan dari pesan STM_SETIMAGE , bitmap bocor.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung |
Windows Server 2003 [hanya aplikasi desktop] |
Header |
|