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，则函数将滚动列表框，而不是返回项标识符。

要求

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