ListView_SetColumnWidth makro (commctrl.h)

Digunakan untuk mengubah lebar kolom dalam tampilan laporan atau lebar semua kolom dalam mode tampilan daftar. Anda dapat menggunakan makro ini atau mengirim pesan LVM_SETCOLUMNWIDTH secara eksplisit.

Sintaksis

BOOL ListView_SetColumnWidth(
   HWND hwnd,
   int  iCol,
   int  cx
);

Parameter

hwnd

Jenis: HWND

Handel ke kontrol tampilan daftar.

iCol

Jenis: int

Indeks berbasis nol dari kolom yang valid. Untuk mode tampilan daftar, parameter ini harus diatur ke nol.

cx

Jenis: int

Lebar baru kolom, dalam piksel. Untuk mode tampilan laporan, nilai khusus berikut ini didukung:

Nilai	Arti
LVSCW_AUTOSIZE	Secara otomatis mengukur kolom.
LVSCW_AUTOSIZE_USEHEADER	Secara otomatis mengukur kolom agar pas dengan teks header. Jika Anda menggunakan nilai ini dengan kolom terakhir, lebarnya diatur untuk mengisi lebar kontrol tampilan daftar yang tersisa.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.

Komentar

Misalnya Anda memiliki kontrol tampilan daftar 2 kolom dengan lebar 500 piksel. Jika lebar kolom nol diatur ke 200 piksel, dan Anda melakukan panggilan berikut.

ListView_SetColumnWidth(hwnd, 1, LVSCW_AUTOSIZE_USEHEADER)

Kolom kedua (dan terakhir) akan lebarnya 300 piksel.

Perhatikan bahwa ListView_SetColumnWidth mengonversi parameter cx menjadi nilai 16-bit.

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