Export (0) Print
Expand All
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

LVHITTESTINFO

Windows Mobile 6.5
A version of this page is also available for
4/8/2010

This structure has been extended to accommodate subitem hit-testing. The LVHITTESTINFO structure contains information about a hit test. It is used in association with the LVM_HITTEST and LVM_SUBITEMHITTEST messages and their related macros.


typedef struct _LVHITTESTINFO { 
  POINT pt; 
  UINT flags; 
  int iItem; 
  int iSubItem;
} LVHITTESTINFO;

pt

Position to hit test, in client coordinates.

flags

Receives information about the results of a hit test. It can be one or more of the following values.

Value Description

LVHT_ABOVE

The position is above the control's client area.

LVHT_BELOW

The position is below the control's client area.

LVHT_NOWHERE

The position is inside the list-view control's client window, but it is not over a list item.

LVHT_ONITEMICON

The position is over a list-view item's icon.

LVHT_ONITEMLABEL

The position is over a list-view item's text.

LVHT_ONITEMSTATEICON

The position is over the state image of a list-view item.

LVHT_TOLEFT

The position is to the left of the list-view control's client area.

LVHT_TORIGHT

The position is to the right of the list-view control's client area.

You can use LVHT_ABOVE, LVHT_BELOW, LVHT_TOLEFT, and LVHT_TORIGHT to determine whether to scroll the contents of a list-view control. Two of these values may be combined. For example, if the position is above and to the left of the client area, you could use both LVHT_ABOVE and LVHT_TO LEFT.

You can test for LVHT_ONITEM to determine whether a specified position is over a list-view item. This value is a bitwise-OR operation on LVHT_ONITEMICON, LVHT_ONITEMLABEL, and LVHT_ONITEMSTATEICON.

iItem

Receives the index of the matching item. Or if hit-testing a subitem, this value represents the subitem's parent item.

iSubItem

Receives the index of the matching subitem. When hit-testing an item, this member will be zero.

This structure supersedes the LV_HITTESTINFO structure.

Headercommctrl.h
Windows Embedded CEWindows CE 2.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions

Show:
© 2015 Microsoft