Bagikan melalui

Struktur LVHITTESTINFO (commctrl.h)

  • Artikel

Berisi informasi tentang tes hit. Struktur ini telah diperluas untuk mengakomodasi pengujian hit subitem. Ini digunakan dalam hubungannya dengan pesan LVM_HITTEST dan LVM_SUBITEMHITTEST dan makro terkait. Struktur ini menggantikan struktur LVHITTESTINFO .

Sintaks

typedef struct tagLVHITTESTINFO {
  POINT pt;
  UINT  flags;
  int   iItem;
  int   iSubItem;
  int   iGroup;
} LVHITTESTINFO, *LPLVHITTESTINFO;

Anggota

pt

Jenis: TITIK

Posisi untuk mencapai pengujian, dalam koordinat klien.

flags

Jenis: UINT

Variabel yang menerima informasi tentang hasil tes temuan. Anggota ini bisa menjadi satu atau beberapa nilai berikut:

Anda dapat menggunakan LVHT_ABOVE, LVHT_BELOW, LVHT_TOLEFT, dan LVHT_TORIGHT untuk menentukan apakah akan menggulir konten kontrol tampilan daftar. Dua nilai ini dapat digabungkan. Misalnya, jika posisi di atas dan di sebelah kiri area klien, Anda dapat menggunakan LVHT_ABOVE dan LVHT_TOLEFT. 

Anda dapat menguji LVHT_ONITEM untuk menentukan apakah posisi yang ditentukan melebihi item tampilan daftar. Nilai ini adalah operasi bitwise-OR pada LVHT_ONITEMICON, LVHT_ONITEMLABEL, dan LVHT_ONITEMSTATEICON.

Nilai Makna
LVHT_ABOVE
 Posisi berada di atas area klien kontrol.
LVHT_BELOW
 Posisi berada di bawah area klien kontrol.
LVHT_NOWHERE
 Posisi berada di dalam jendela klien kontrol tampilan daftar, tetapi tidak melebihi item daftar.
LVHT_ONITEMICON
 Posisi berada di atas ikon item tampilan daftar.
LVHT_ONITEMLABEL
 Posisi berada di atas teks item tampilan daftar.
LVHT_ONITEMSTATEICON
 Posisi berada di atas gambar status item tampilan daftar.
LVHT_TOLEFT
 Posisinya ada di sebelah kiri area klien kontrol tampilan daftar.
LVHT_TORIGHT
 Posisinya berada di sebelah kanan area klien kontrol tampilan daftar.
LVHT_EX_GROUP_HEADER
 Windows Vista. Titik berada di dalam header grup.
LVHT_EX_GROUP_FOOTER
 Windows Vista. Titik berada dalam footer grup.
LVHT_EX_GROUP_COLLAPSE
 Windows Vista. Titik berada dalam tombol ciutkan/perluas grup.
LVHT_EX_GROUP_BACKGROUND
 Windows Vista. Titik berada dalam area grup tempat item ditampilkan.
LVHT_EX_GROUP_STATEICON
 Windows Vista. Titik berada dalam ikon status grup.
LVHT_EX_GROUP_SUBSETLINK
 Windows Vista. Titik berada dalam tautan subset grup.
LVHT_EX_GROUP
 Windows Vista. LVHT_EX_GROUP_BACKGROUND | LVHT_EX_GROUP_COLLAPSE | LVHT_EX_GROUP_FOOTER | LVHT_EX_GROUP_HEADER | LVHT_EX_GROUP_STATEICON | LVHT_EX_GROUP_SUBSETLINK.
LVHT_EX_ONCONTENTS
 Windows Vista. Titik berada di dalam ikon atau konten teks item dan bukan di latar belakang.
LVHT_EX_FOOTER
 Windows Vista. Titik berada di dalam footer kontrol tampilan daftar.

iItem

Jenis: int

Menerima indeks item yang cocok. Atau jika pengujian hit subitem, nilai ini mewakili item induk subitem.

iSubItem

Jenis: int

Versi 4.70. Menerima indeks subitem yang cocok. Saat menguji item, anggota ini akan menjadi nol.

iGroup

Jenis: int

Windows Vista. Indeks grup item terbentur (baca saja). Hanya berlaku untuk data pemilik. Jika titik berada dalam item yang ditampilkan dalam beberapa grup, maka iGroup akan menentukan indeks grup item.

Persyaratan

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