Fungsi LBItemFromPt (commctrl.h)

Artikel
02/24/2024

Mengambil indeks item pada titik yang ditentukan dalam kotak daftar.

Sintaks

int LBItemFromPt(
  HWND  hLB,
  POINT pt,
  BOOL  bAutoScroll
);

Parameter

hLB

Jenis: HWND

Handel ke kotak daftar untuk dicentang.

pt

Jenis: TITIK

Struktur POINT yang berisi koordinat layar untuk diperiksa.

bAutoScroll

Jenis: BOOL

Bendera gulir. Jika parameter ini TRUE dan titik tepat di atas atau di bawah kotak daftar, fungsi menggulir kotak daftar dengan satu baris dan mengembalikan -1. Jika tidak, fungsi tidak menggulir kotak daftar.

Nilai kembali

Jenis: int

Mengembalikan pengidentifikasi item jika titik tersebut melebihi item daftar, atau -1 jika tidak.

Keterangan

Fungsi LBItemFromPt hanya menggulir kotak daftar jika jumlah waktu minimum telah berlalu sejak terakhir kali melakukannya. Pengaturan waktu mencegah kotak daftar menggulir terlalu cepat jika fungsi dipanggil berulang kali berturut-turut dengan cepat—misalnya, saat DL_DRAGGING kode pemberitahuan atau pesan WM_MOUSEMOVE diproses.

Jika titik yang ditentukan berada di luar area klien dari kotak daftar dan bAutoScrolladalah TRUE, fungsi menggulir kotak daftar alih-alih mengembalikan pengidentifikasi item.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	commctrl.h
Pustaka	Comctl32.lib
DLL	Comctl32.dll

Bagikan melalui