ListView_HitTest macro (commctrl.h)

Determines which list-view item, if any, is at a specified position. You can use this macro or send the LVM_HITTEST message explicitly.

Syntax

int ListView_HitTest(
   HWND            hwndLV,
   LPLVHITTESTINFO pinfo
);

Parameters

hwndLV

Type: HWND

A handle to the list-view control.

pinfo

Type: LPLVHITTESTINFO

A pointer to an LVHITTESTINFO structure that contains the position to hit test and receives information about the results of the hit test.

Return value

Type: int

Returns the index of the item at the specified position, if any, or -1 otherwise.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header commctrl.h