FindElementsInHostCoordinates Method (Rect, UIElement)
Collapse the table of content
Expand the table of content

VisualTreeHelper.FindElementsInHostCoordinates Method (Rect, UIElement)

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Retrieves a set of objects that are located within a specified Rect of an object's coordinate space.

Namespace:  System.Windows.Media
Assembly:  System.Windows (in System.Windows.dll)

public static IEnumerable<UIElement> FindElementsInHostCoordinates(
	Rect intersectingRect,
	UIElement subtree


Type: System.Windows.Rect
The Rect to use as the determination area.
Type: System.Windows.UIElement
The object to search within.

Return Value

Type: System.Collections.Generic.IEnumerable<UIElement>
An enumerable set of UIElement objects that are determined to be located in the visual tree composition at the specified point and within the specified subtee.

You must specify some object for the subtree value to specify a frame of reference. If you want to use the most general frame of reference available (the entire content area of Windows Phone), use Application.RootVisual as the subtree input.

For this signature, because the determination is done by an area, multiple elements might be returned, and no meaning can be assigned to the order of returned elements in the set.

The input Rect might be the result of a selection, where a start point and end point were captured and could be used to compose a Rect.

FindElementsInHostCoordinates is fundamentally similar to the HitTest methods in other frameworks.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

© 2017 Microsoft