Method IdentifyGeometryEditorAsync

| Edit this page View Source

IdentifyGeometryEditorAsync(Point, double)

Identifies all the elements in the GeometryEditor, at the given screen point.

Declaration
public virtual Task<IdentifyGeometryEditorResult?> IdentifyGeometryEditorAsync(Point screenPoint, double tolerance)
Parameters
Type Name Description
Point screenPoint

The screen coordinates to identify the geometry editor elements.
double tolerance

A radius in device-independent pixels (DIP) that specifies how precise the identify operation should be.
Returns
Type Description
Task<IdentifyGeometryEditorResult>

A Task of IdentifyGeometryEditorResult containing an array of GeometryEditorElement.
Remarks

Results are returned in the same order as the draw order of GeometryEditorElement on the GeometryEditor display; that is top-first order, with GeometryEditorVertex appearing drawn on-top of other elements.

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 completely within the circle. The maximum allowed value is 100 DIPs.

The default tolerance values used by the geometry editor for each input type are:

  • Mouse device - 5 DIPs.
  • Stylus device - 10 DIPs.
  • Touch - 15 DIPs.
  • Reticle tool - 5 DIPs.

This operation will fail if: