Method ScreenToLocationAsync
ScreenToLocationAsync(Windows.Foundation.Point)
Async method to convert a screen point relative to the upper left of the SceneView into a location accounting for 3D features within the Scene.
Declaration
public async Task<MapPoint> ScreenToLocationAsync(Windows.Foundation.Point screenPoint)
Parameters
Type | Name | Description |
---|---|---|
Windows.Foundation.Point | screenPoint | Screen point relative to the upper left. |
Returns
Type | Description |
---|---|
System.Threading.Tasks.Task<MapPoint> | A MapPoint on the base surface of the Scene, if this view is initialized
and has a loaded scene; otherwise |
Remarks
This method checks for intersection between the input screen point and visible 3D features on the Scene.
It returns a point with X, Y and Z values matching the intersection point. If the input point does not
intersect a visible 3D feature, the Scene surface
is used to retrieve the point values. If the input point does not intersect the Scene surface or
any visible 3D features a null
value is returned.
This method differs from ScreenToBaseSurface(Windows.Foundation.Point) in that the latter only uses the Scene Surface and ignores visible 3D features. The algorithm is inherently slower than ScreenToBaseSurface and is therefore an async operation.
See Also
Applies to
Platforms and versions
Target | Versions |
---|---|
.NET 6.0 Windows | 100.13 - 100.15 |