TOUCH_HIT_TESTING_INPUT structure (winuser.h)

Contains information about the touch contact area reported by the touch digitizer.

Syntax

typedef struct tagTOUCH_HIT_TESTING_INPUT {
  UINT32 pointerId;
  POINT  point;
  RECT   boundingBox;
  RECT   nonOccludedBoundingBox;
  UINT32 orientation;
} TOUCH_HIT_TESTING_INPUT, *PTOUCH_HIT_TESTING_INPUT;

Members

pointerId

The ID of the pointer. You cannot pass this value to the input message process and retrieve additional pointer info through GetPointerInfo.

point

The screen coordinates of the touch point that the touch digitizer reports.

boundingBox

The bounding rectangle of the touch contact area. Valid touch targets are identified and scored based on this bounding box.

Note  This bounding box may differ from the contact area that the digitizer reports when:
  • The digitizer reports a touch contact area that's outside the maximum or minimum size threshold that's recognized by Touch Hit Testing.
  • A portion of the touch contact area is occluded by another object that's higher in the z-order.
 

nonOccludedBoundingBox

The touch contact area within a specific targeted window that's not occluded by other objects that are higher in the z-order. Any area that's occluded by another object is an invalid target.

orientation

The orientation of the touch contact area.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server None supported
Header winuser.h

See also

Structures