LBItemFromPt 函式 (commctrl.h)

擷取清單框中指定點的專案索引。

語法

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

參數

hLB

類型： HWND

要核取的清單框句柄。

pt

類型： POINT

POINT 結構，其中包含要檢查的螢幕座標。

bAutoScroll

類型： BOOL

捲動旗標。 如果此參數為 TRUE ，且點直接在清單框上方或下方，函式會將清單框捲動一行並傳回 -1。 否則，函式不會捲動清單框。

傳回值

類型： int

如果點位於清單專案上方，則傳回專案標識符，否則傳回 -1。

備註

LBItemFromPt 函式只會捲動清單框，前提是自上次執行此動作后經過的時間下限。 如果函式連續重複呼叫，計時可防止清單框捲動太快，例如，處理 DL_DRAGGING 通知代碼或 WM_MOUSEMOVE 訊息時。

如果指定的點位於清單框的工作區之外， 且 bAutoScroll 為 TRUE，則函式會捲動清單方塊，而不是傳回專案標識符。

規格需求