UIElement.FindSubElementsForTouchTargeting(Point, Rect) UIElement.FindSubElementsForTouchTargeting(Point, Rect) UIElement.FindSubElementsForTouchTargeting(Point, Rect) UIElement.FindSubElementsForTouchTargeting(Point, Rect) Method

Definition

Namespace:
Windows.UI.Xaml Windows.UI.Xaml Windows.UI.Xaml Windows.UI.Xaml
Assemblies:
Windows.UI.Xaml.dll, Windows.dll
Edit

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

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

Parameters

point
Point Point

The point being touched.

boundingRect
Rect Rect

The bounds used for touch tolerance.

Returns

IEnumerable<IEnumerable<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# 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;.

See also