UIElement.FindSubElementsForTouchTargeting(Point, Rect) Method

Definition

Enables a UIElement subclass to expose child elements that assist with resolving touch targeting.

protected:
 virtual IIterable<IIterable<Point> ^> ^ FindSubElementsForTouchTargeting(Point point, Rect boundingRect) = FindSubElementsForTouchTargeting;
IIterable<IIterable<Point>> FindSubElementsForTouchTargeting(Point const& point, Rect const& boundingRect);
protected virtual IEnumerable<IEnumerable<Point>> FindSubElementsForTouchTargeting(Point point, Rect boundingRect);
function findSubElementsForTouchTargeting(point, boundingRect)
Protected Overridable Function FindSubElementsForTouchTargeting (point As Point, boundingRect As Rect) As IEnumerable(Of IEnumerable(Of Point))

Parameters

point
Point

The point being touched.

boundingRect
Rect

The bounds used for touch tolerance.

Returns

A set of point sets. These represent the vertices of sub elements that are intersected by the given touch point (plus tolerance).

Remarks

Points in the list are in descending z-order: topmost in the rendering stack appears first in the list.

FindElementsInHostCoordinates is a similar static-class helper method that is also used for hit testing and general object tree examination. However, FindSubElementsForTouchTargeting adds the refinement of a Rect input to use for touch tolerance.

If you are programming using C# or Microsoft Visual Basic, the return value type of this method is projected as an IEnumerable generic collection that contains UIElement items. If you are programming using Visual C++ component extensions (C++/CX), the return type of this method is IIterable<UIElement>.

Applies to

See also