ListView_GetItem makro (commctrl.h)

2024-10-24

Mendapatkan beberapa atau semua atribut item tampilan daftar. Anda dapat menggunakan makro ini atau mengirim pesan LVM_GETITEM secara eksplisit.

Sintaksis

BOOL ListView_GetItem(
   HWND     hwnd,
   LPLVITEM pitem
);

Parameter

hwnd

Jenis: HWND

Handel ke kontrol tampilan daftar.

pitem

Jenis: LPLVITEM

Penunjuk ke struktur LVITEM yang menentukan informasi untuk mengambil dan menerima informasi tentang item tampilan daftar.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.

Komentar

Saat pesan LVM_GETITEM dikirim, iItem dan anggota iSubItem mengidentifikasi item atau subitem untuk mengambil informasi tentang dan anggota mask menentukan atribut mana yang akan diambil. Untuk daftar nilai yang mungkin, lihat deskripsi struktur LVITEM.

Jika bendera LVIF_TEXT diatur dalam masker anggota struktur LVITEM, anggota pszText harus menunjuk ke buffer yang valid dan anggota cchTextMax harus diatur ke jumlah karakter dalam buffer tersebut. Aplikasi tidak boleh berasumsi bahwa teks harus ditempatkan dalam buffer yang ditentukan. Kontrol dapat mengubah pszText anggota struktur untuk menunjuk ke teks baru daripada menempatkannya di buffer.

Jika anggota mask menentukan nilai LVIF_STATE, anggota stateMask harus menentukan bit status item yang akan diambil. Pada output, status anggota berisi nilai bit status yang ditentukan.

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