Method IdentifyLayersAsync

IdentifyLayersAsync(Point, Double, Boolean)

Identifies the topmost geoelements at the given screen point, in each identifiable layer or sublayer in the GeoView's Map or Scene.

Declaration

public Task<IReadOnlyList<IdentifyLayerResult>> IdentifyLayersAsync(Point screenPoint, double tolerance, bool returnPopupsOnly)

Parameters

Type	Name	Description
Point	screenPoint	The screen coordinates to identify the geoelements.
Double	tolerance	A radius in device-independent pixels (DIP) that specifies how precise the identify operation should be.
Boolean	returnPopupsOnly	`true` includes only popups in the identify results. `false` includes both geoelements and popups in the identify results.

Returns

Type	Description
Task<IReadOnlyList<IdentifyLayerResult>>	A task that represents the asynchronous identify operation on all layers in the view The value of the TResult parameter contains a read-only collection of IdentifyLayerResult in top to bottom order.

Remarks

As locations from user gestures are not always accurate to the exact pixel, you can define a tolerance for the identify operation. The tolerance parameter sets the radius of a circle, centered at the specified coordinates, in device-independent pixels (DIP). If the tolerance value is 0, identify performs the test at the specified coordinates. If it is greater than 0, identify tests inside the circle. For touch displays a value of 22 is recommended to cover an average finger tap. The maximum allowed value is 100 DIPs.

The result is returned in a collection of IdentifyLayerResult to match the order of the GeoView's Map or Scene operationalLayers collection. If the returnPopupsOnly parameter is true only Popups is populated. If the returnPopupsOnly parameter is false, both GeoElements and Popups are populated, if the layer has popups.

Applies to

Platforms and versions

Target	Versions
.NET 6.0 Windows	100.13 - 200.2
.NET Framework	100.0 - 200.2
.NET 5	100.10 - 100.12
.NET Core 3.1	100.7 - 100.12

IdentifyLayersAsync(Point, Double, Boolean, CancellationToken)

Initiates an identify operation on all layers in the view which will return the single visible topmost GeoElement per layer only.

Declaration

public Task<IReadOnlyList<IdentifyLayerResult>> IdentifyLayersAsync(Point screenPoint, double tolerance, bool returnPopupsOnly, CancellationToken cancellationToken)

Parameters

Type	Name	Description
Point	screenPoint	The location on which to run identify in screen coordinates.
Double	tolerance	The width and height in screen coordinates of the square centered on screen coordinate that will be used in the identify.
Boolean	returnPopupsOnly	`true` includes only popups in the identify results. `false` includes both geoelements and popups in the identify results.
CancellationToken	cancellationToken	A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Type	Description
Task<IReadOnlyList<IdentifyLayerResult>>	A task that represents the asynchronous identify operation on all layers in the view The value of the TResult parameter contains a read-only collection of IdentifyLayerResult in top to bottom order.

Remarks

Applies to

Platforms and versions

Target	Versions
.NET 6.0 Windows	100.13 - 200.2
.NET Framework	100.0 - 200.2
.NET 5	100.10 - 100.12
.NET Core 3.1	100.7 - 100.12

IdentifyLayersAsync(Point, Double, Boolean, Int64)

Identifies a limited number of geoelements at the given screen point, in each identifiable layer or sublayer in the GeoView's Map or Scene.

Declaration

public Task<IReadOnlyList<IdentifyLayerResult>> IdentifyLayersAsync(Point screenPoint, double tolerance, bool returnPopupsOnly, long maximumResultsPerLayer)

Parameters

Type	Name	Description
Point	screenPoint	The screen coordinates to identify the geoelements.
Double	tolerance	A radius in device-independent pixels (DIP) that specifies how precise the identify operation should be.
Boolean	returnPopupsOnly	`true` includes only popups in the identify results. `false` includes both geoelements and popups in the identify results.
Int64	maximumResultsPerLayer	The maximum number of geoelements and/or popups returned in the IdentifyLayerResult per layer or sublayer. A value of -1 indicates unlimited results.

Returns

Type	Description
Task<IReadOnlyList<IdentifyLayerResult>>	A task that represents the asynchronous identify operation on all layers in the view The value of the TResult parameter contains a read-only collection of IdentifyLayerResult in top to bottom order.

Remarks

Applies to

Platforms and versions

Target	Versions
.NET 6.0 Windows	100.13 - 200.2
.NET Framework	100.0 - 200.2
.NET 5	100.10 - 100.12
.NET Core 3.1	100.7 - 100.12

IdentifyLayersAsync(Point, Double, Boolean, Int64, CancellationToken)

Initiates an identify operation on all layers in the view.

Declaration

public Task<IReadOnlyList<IdentifyLayerResult>> IdentifyLayersAsync(Point screenPoint, double tolerance, bool returnPopupsOnly, long maximumResultsPerLayer, CancellationToken cancellationToken)

Parameters

Type	Name	Description
Point	screenPoint	The location on which to run identify in screen coordinates.
Double	tolerance	The width and height in screen coordinates of the square centered on screen coordinate that will be used in the identify.
Boolean	returnPopupsOnly	`true` includes only popups in the identify results. `false` includes both geoelements and popups in the identify results.
Int64	maximumResultsPerLayer	The maximum number of GeoElements to return per layer.
CancellationToken	cancellationToken	A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns

Type	Description
Task<IReadOnlyList<IdentifyLayerResult>>	A task that represents the asynchronous identify operation on all layers in the view The value of the TResult parameter contains a read-only collection of IdentifyLayerResult in top to bottom order.

Remarks

Applies to

Platforms and versions

Target	Versions
.NET 6.0 Windows	100.13 - 200.2
.NET Framework	100.0 - 200.2
.NET 5	100.10 - 100.12
.NET Core 3.1	100.7 - 100.12