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.

Sintaks

void ListView_SetIconSpacing(
   hwndLV,
   cx,
   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

Tidak ada

Keterangan

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

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	commctrl.h