UIElement.FindSubElementsForTouchTargeting(Point, Rect) Method

Definition

Namespace:

Microsoft.UI.Xaml

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

IIterable<IIterable<Point>>

IEnumerable<IEnumerable<Point>>

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#, the return value type of this method is projected as an IEnumerable generic collection that contains UIElement items.

See also

• FindElementsInHostCoordinates(Point, UIElement)
• Handle pointer input