ListView_GetItemIndexRect makro (commctrl.h)

2024-10-24

Mendapatkan persegi panjang pembatas untuk semua atau sebagian subitem dalam tampilan kontrol tampilan daftar yang ditentukan saat ini. Gunakan makro ini atau kirim pesan LVM_GETITEMINDEXRECT secara eksplisit.

Sintaksis

BOOL ListView_GetItemIndexRect(
  [in]      HWND        hwnd,
  [in]      LVITEMINDEX *plvii,
  [in]      LONG        iSubItem,
  [in]      LONG        code,
  [in, out] LPRECT      prc
);

Parameter

[in] hwnd

Jenis: HWND

Handel ke kontrol tampilan daftar.

[in] plvii

Jenis: LVITEMINDEX

Penunjuk ke struktur LVITEMINDEX untuk item induk subitem. Pemanggil bertanggung jawab untuk mengalokasikan struktur ini dan mengatur anggotanya. plvii tidak boleh null.

[in] iSubItem

Jenis: LONG

Indeks subitem.

[in] code

Jenis: LONG

Bagian subitem tampilan daftar untuk mengambil persegi panjang pembatas. Parameter ini harus menjadi salah satu nilai berikut.

Nilai	Arti
LVIR_BOUNDS	Mengembalikan persegi panjang batas dari seluruh subitem, termasuk ikon dan label.
LVIR_ICON	Mengembalikan persegi panjang pembatas ikon atau ikon kecil subitem.
LVIR_LABEL	Mengembalikan persegi panjang pembatas teks subitem.

[in, out] prc

Jenis: LPRECT

Pointer ke struktur RECT untuk menerima koordinat. Pemanggil bertanggung jawab untuk mengalokasikan struktur ini. prc tidak boleh NULL.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.

Komentar

Jika iSubItem adalah nol, makro ini mengembalikan koordinat persegi panjang ke item yang ditunjukkan oleh plvii. Nilai LVIR_SELECTBOUNDS untuk parameter kode tidak didukung.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Platform Target	Windows
Header	commctrl.h

Bagikan melalui