Struktur LVFINDINFOA (commctrl.h)

  • Artikel

Berisi informasi yang digunakan saat mencari item tampilan daftar. Struktur ini identik dengan LV_FINDINFO tetapi telah diganti namanya agar sesuai dengan konvensi penamaan standar.

Sintaks

typedef struct tagLVFINDINFOA {
  UINT   flags;
  LPCSTR psz;
  LPARAM lParam;
  POINT  pt;
  UINT   vkDirection;
} LVFINDINFOA, *LPFINDINFOA;

Anggota

flags

Jenis: UINT

Jenis pencarian yang akan dilakukan. Anggota ini dapat diatur ke satu atau beberapa nilai berikut:

Nilai Makna
LVFI_PARAM
 Mencari kecocokan antara anggota lParam struktur ini dan anggota lParam dari struktur LVITEM item.
LVFI_PARTIAL
 Memeriksa untuk melihat apakah teks item dimulai dengan string yang ditujukkan oleh anggota psz . Nilai ini menyiratkan penggunaan LVFI_STRING.
LVFI_STRING
 Pencarian berdasarkan teks item. Kecuali nilai tambahan ditentukan, teks item dari item yang cocok harus sama persis dengan string yang diacu oleh anggota psz . Namun, pencarian tidak peka huruf besar/kecil.
LVFI_SUBSTRING
 Windows Vista dan yang lebih baru. Setara dengan LVFI_PARTIAL.
LVFI_WRAP
 Melanjutkan pencarian di awal jika tidak ada kecocokan yang ditemukan. Jika bendera ini digunakan dengan sendirinya, diasumsikan bahwa pencarian string diinginkan.
LVFI_NEARESTXY
 Menemukan item terdekat dengan posisi yang ditentukan dalam anggota pt , ke arah yang ditentukan oleh anggota vkDirection . Bendera ini hanya didukung oleh ikon besar dan mode ikon kecil. Jika LVFI_NEARESTXY ditentukan, semua bendera lainnya akan diabaikan.

psz

Jenis: LPCTSTR

Alamat string yang dihentikan null untuk dibandingkan dengan teks item. Ini hanya valid jika LVFI_STRING atau LVFI_PARTIAL diatur dalam anggota bendera .

lParam

Jenis: LPARAM

Nilai untuk dibandingkan dengan anggota lParam dari struktur LVITEM item tampilan daftar. Ini hanya valid jika LVFI_PARAM diatur dalam anggota bendera .

pt

Jenis: TITIK

Struktur POINT dengan posisi pencarian awal. Ini hanya valid jika LVFI_NEARESTXY diatur dalam anggota bendera .

vkDirection

Jenis: UINT

Kode kunci virtual yang menentukan arah untuk mencari. Kode berikut didukung:

  • VK_LEFT
  • VK_RIGHT
  • VK_UP
  • VK_DOWN
  • VK_HOME
  • VK_END
  • VK_PRIOR
  • VK_NEXT
Anggota ini hanya valid jika LVFI_NEARESTXY diatur dalam anggota bendera .

Keterangan

Catatan

Header commctrl.h mendefinisikan LVFINDINFO sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

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