Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This macro 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 
hwnd, 
  LV_HITTESTINFO FAR* 
pinfo 
);

Parameters

hwnd

Handle to the list-view control.

pinfo

Pointer to an LVHITTESTINFOstructure that contains the position to hit test and receives information about the results of the hit test.

Return Value

The index of the item at the specified position, if any, indicates success. –1 indicates failure.

Remarks

Related message:  LVM_HITTEST

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also