Bagikan melalui

Struktur LVFINDINFOW (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.

Sintaksis

typedef struct tagLVFINDINFOW {
  UINT    flags;
  LPCWSTR psz;
  LPARAM  lParam;
  POINT   pt;
  UINT    vkDirection;
} LVFINDINFOW, *LPFINDINFOW;

Anggota

flags

Jenis: UINT

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

Nilai Arti
LVFI_PARAM
 Mencari kecocokan antara struktur ini anggota lParam dan lParam anggota 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
 Mencari berdasarkan teks item. Kecuali nilai tambahan ditentukan, teks item item item yang cocok harus sama persis dengan string yang ditujukkan 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, dalam arah yang ditentukan oleh anggota vkDirection. Bendera ini hanya didukung oleh ikon besar dan mode ikon kecil. Jika LVFI_NEARESTXY ditentukan, semua bendera lainnya 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 bendera anggota.

lParam

Jenis: LPARAM

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

pt

Jenis: POINT

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

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 bendera anggota.

Komentar

Nota

Header commctrl.h mendefinisikan LVFINDINFO sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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

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