IInkDisp::HitTestWithRectangle method (msinkaut.h)
Retrieves the strokes that are contained within a specified rectangle.
HRESULT HitTestWithRectangle( [in] IInkRectangle *SelectionRectangle, [in] float IntersectPercent, [out, retval] IInkStrokes **Strokes );
The selection rectangle, of type InkRectangle, in ink space coordinates.
The float or single percentage value that determines which strokes are included in the collection. Strokes that intersect the rectangle are included in the collection if the percentage of points in those strokes contained within the rectangle is greater than or equal to the IntersectPercent percentage.
[out, retval] Strokes
When this method returns, contains a pointer to the collection of strokes that makes up the ink.
This method can return one of these values.
||A parameter contained an invalid pointer.|
||An exception occurred inside the method.|
||Invalid display handle.|
To determine which points of a known stroke intersect the test area, call the GetRectangleIntersections method of the IInkStrokeDisp object, which retrieves the points where a stroke intersects a known rectangle.
|Minimum supported client||Windows XP Tablet PC Edition [desktop apps only]|
|Minimum supported server||None supported|