nf-commctrl-lbitemfrompt.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:commctrl.LBItemFromPt	LBItemFromPt function (commctrl.h)	Retrieves the index of the item at the specified point in a list box.	LBItemFromPt LBItemFromPt function [Windows Controls] _win32_LBItemFromPt _win32_LBItemFromPt_cpp commctrl/LBItemFromPt controls.LBItemFromPt controls._win32_LBItemFromPt	controls\LBItemFromPt.htm	Controls	VS|Controls|~\controls\draglb\functions\lbitemfrompt.htm	12/05/2018	LBItemFromPt, LBItemFromPt function [Windows Controls], _win32_LBItemFromPt, _win32_LBItemFromPt_cpp, commctrl/LBItemFromPt, controls.LBItemFromPt, controls._win32_LBItemFromPt	commctrl.h		Windows	Windows Vista [desktop apps only]	Windows Server 2003 [desktop apps only]										Comctl32.lib	Comctl32.dll		Windows			19H1	LBItemFromPt commctrl/LBItemFromPt	c++	APIRef kbSyntax	DllExport	Comctl32.dll	LBItemFromPt

LBItemFromPt function

-description

Retrieves the index of the item at the specified point in a list box.

-parameters

-param hLB

Type: HWND

A handle to the list box to check.

-param pt

Type: POINT

A POINT structure that contains the screen coordinates to check.

-param bAutoScroll

Type: BOOL

A scroll flag. If this parameter is TRUE and the point is directly above or below the list box, the function scrolls the list box by one line and returns -1. Otherwise, the function does not scroll the list box.

-returns

Type: int

Returns the item identifier if the point is over a list item, or -1 otherwise.

-remarks

The LBItemFromPt function only scrolls the list box if a minimum amount of time has passed since it last did so. Timing prevents the list box from scrolling too quickly if the function is called repeatedly in rapid succession—for example, when DL_DRAGGING notification codes or WM_MOUSEMOVE messages are processed.

If the specified point is outside the client area of the list box and bAutoScroll is TRUE, the function scrolls the list box instead of returning an item identifier.