HDHITTESTINFO structure

Contains information about a hit test. This structure is used with the HDM_HITTEST message and it supersedes the HD_HITTESTINFO structure.

Syntax


typedef struct _HD_HITTESTINFO {
  POINT pt;
  UINT  flags;
  int   iItem;
} HDHITTESTINFO, *LPHDHITTESTINFO;

Members

pt

Type: POINT

A POINT structure that contains the point to be hit test, in client coordinates.

flags

Type: UINT

The variable that receives information about the results of a hit test. This member can be one or more of the values listed below. Two of these values can be combined, such as when the position is above and to the left of the client area.

ValueMeaning
HHT_ABOVE

The point is above the header control's bounding rectangle.

HHT_BELOW

The point is below the header control's bounding rectangle.

HHT_NOWHERE

The point is inside the header control's bounding rectangle but is not over a header item.

HHT_ONDIVIDER

The point is on the divider between two header items.

HHT_ONDIVOPEN

The point is on the divider of an item that has a width of zero. Dragging the divider reveals the item instead of resizing the item to the left of the divider.

HHT_ONHEADER

The point is inside the header control's bounding rectangle.

HHT_ONFILTER

Version 5.80 The point is over the filter area.

HHT_ONFILTERBUTTON

Version 5.80 The point is on the filter button.

HHT_TOLEFT

The point is to the left of the header control's bounding rectangle.

HHT_TORIGHT

The point is to the right of the header control's bounding rectangle.

HHT_ONITEMSTATEICON

Version 6.00 and Windows Vista. The point is within the state icon of the item. If style HDS_CHECKBOXES is specified, the point is within the checkbox of the item.

HHT_ONDROPDOWN

Version 6.00 and Windows Vista. The point is within the split button of the item. The style HDF_SPLITBUTTON must be set on the item.

HHT_ONOVERFLOW

Version 6.00 and Windows Vista. The point is within the overflow button of the header control. The style HDS_OVERFLOW must be set on the header control.

 

iItem

Type: int

If the hit test is successful, contains the index of the item at the hit test point.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Commctrl.h

 

 

Community Additions

ADD
Show:
© 2014 Microsoft