UIElement.FindSubElementsForTouchTargeting(Point, Rect) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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>.