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 消息时),计时可防止列表框滚动过快。

如果指定的点在列表框的工作区之外,并且 bAutoScrollTRUE,则函数将滚动列表框,而不是返回项标识符。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 commctrl.h
Library Comctl32.lib
DLL Comctl32.dll