Share via


LVHITTESTINFO (Windows Embedded CE 6.0)

1/6/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.

Syntax

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

Members

  • 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.

Remarks

This structure supersedes the LV_HITTESTINFO structure.

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 2.0 and later

See Also

Reference

List-View Controls Structures