Method IdentifyLayersAsync
IdentifyLayersAsync(Point, Double, Boolean)
Identifies the topmost geoelements at the given screen point, in each identifiable layer or sublayer in the
Geo
Declaration
public Task<IReadOnlyList<IdentifyLayerResult>> IdentifyLayersAsync(Point screenPoint, double tolerance, bool returnPopupsOnly)
Parameters
Type | Name | Description |
---|---|---|
System. |
screenPoint | The screen coordinates to identify the geoelements. |
System. |
tolerance | A radius in device-independent pixels (DIP) that specifies how precise the identify operation should be. |
System. |
returnPopupsOnly |
|
Returns
Type | Description |
---|---|
System. |
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 Identify |
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 IdentifyreturnPopupsOnly
parameter is true
only Popups is populated. If the returnPopupsOnly
parameter is false
, both Geo
Applies to
Platforms and versions
Target | Versions |
---|---|
.NET Windows | 100.13 - 200.6 |
.NET Framework | 100.0 - 200.6 |
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 |
---|---|---|
System. |
screenPoint | The location on which to run identify in screen coordinates. |
System. |
tolerance | The width and height in screen coordinates of the square centered on screen coordinate that will be used in the identify. |
System. |
returnPopupsOnly |
|
System. |
cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Returns
Type | Description |
---|---|
System. |
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 Identify |
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 IdentifyreturnPopupsOnly
parameter is true
only Popups is populated. If the returnPopupsOnly
parameter is false
, both Geo
Applies to
Platforms and versions
Target | Versions |
---|---|
.NET Windows | 100.13 - 200.6 |
.NET Framework | 100.0 - 200.6 |
IdentifyLayersAsync(Point, Double, Boolean, Int64)
Identifies a limited number of geoelements at the given screen point, in each identifiable layer or sublayer in the
Geo
Declaration
public Task<IReadOnlyList<IdentifyLayerResult>> IdentifyLayersAsync(Point screenPoint, double tolerance, bool returnPopupsOnly, long maximumResultsPerLayer)
Parameters
Type | Name | Description |
---|---|---|
System. |
screenPoint | The screen coordinates to identify the geoelements. |
System. |
tolerance | A radius in device-independent pixels (DIP) that specifies how precise the identify operation should be. |
System. |
returnPopupsOnly |
|
System. |
maximumResultsPerLayer | The maximum number of geoelements and/or popups returned in the Identify |
Returns
Type | Description |
---|---|
System. |
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 Identify |
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 IdentifyreturnPopupsOnly
parameter is true
only Popups is populated. If the returnPopupsOnly
parameter is false
, both Geo
Applies to
Platforms and versions
Target | Versions |
---|---|
.NET Windows | 100.13 - 200.6 |
.NET Framework | 100.0 - 200.6 |
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 |
---|---|---|
System. |
screenPoint | The location on which to run identify in screen coordinates. |
System. |
tolerance | The width and height in screen coordinates of the square centered on screen coordinate that will be used in the identify. |
System. |
returnPopupsOnly |
|
System. |
maximumResultsPerLayer | The maximum number of GeoElements to return per layer. |
System. |
cancellationToken | A cancellation token that can be used by other objects or threads to receive notice of cancellation. |
Returns
Type | Description |
---|---|
System. |
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 Identify |
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 IdentifyreturnPopupsOnly
parameter is true
only Popups is populated. If the returnPopupsOnly
parameter is false
, both Geo
Applies to
Platforms and versions
Target | Versions |
---|---|
.NET Windows | 100.13 - 200.6 |
.NET Framework | 100.0 - 200.6 |