ListView_SetIconSpacing makro (commctrl.h)

Mengatur penspasian antar ikon dalam kontrol tampilan daftar yang diatur ke gaya LVS_ICON. Anda dapat menggunakan makro ini atau mengirim pesan LVM_SETICONSPACING secara eksplisit.

Sintaksis

DWORD ListView_SetIconSpacing(
   HWND hwndLV,
   int  cx,
   int  cy
);

Parameter

hwndLV

Jenis: HWND

Handel ke kontrol tampilan daftar.

cx

Jenis: int

Jarak, dalam piksel, untuk mengatur antara ikon pada sumbu x.

cy

Jenis: int

Jarak, dalam piksel, untuk mengatur antara ikon pada sumbu y.

Mengembalikan nilai

Jenis: DWORD

Mengembalikan nilai DWORD yang berisi nilai sebelumnya

Komentar

Parameter cx dan cy relatif terhadap sudut kiri atas bitmap ikon. Oleh karena itu, untuk mengatur penspasian antara ikon yang tidak tumpang tindih, nilai cx atau cy harus menyertakan ukuran ikon, ditambah jumlah ruang kosong yang diinginkan di antara ikon. Nilai yang tidak menyertakan lebar ikon akan mengakibatkan tumpang tindih.

Saat menentukan penspasian ikon, cx dan cy harus diatur ke 4 atau lebih besar. Nilai yang lebih kecil tidak akan menghasilkan tata letak yang diinginkan. Anda dapat mengatur ulang cx dan cy ke penspasian default dengan mengatur kedua nilai ke -1. Pendekatan ini hanya memungkinkan Anda untuk mengatur ulang kedua pengaturan default. Anda tidak dapat mengatur ulang hanya cx atau cy ke pengaturan default dengan mengatur salah satunya ke -1.

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