GeometryEditorReticle class final
A visual aid displayed on the map view to allow precise editing of a geometry on a touch device, using a GeometryEditor.
A GeometryEditorReticle is a visual aid displayed on the map view to help precise targeting on a map, separate to the interaction position. It is ideal for use on touch devices, as it can provide an alternative to a mouse hover, allowing you to see a precise position before you tap the screen. This can be especially useful for snapping (see SnapSettings) to allow you to see visual snapping feedback during vertex addition and moves, without fingers hiding the screen and the snapping feedback.
The GeometryEditorReticle is displayed on a map view when:
- a GeometryEditor is set onto the map view (ArcGISMapViewController.geometryEditor), and
- the GeometryEditor is started (GeometryEditor.isStarted is true), and
- a ReticleVertexTool is set as the active tool (GeometryEditor.tool)
The reticle is displayed centered in the map view accounting for the current Insets and attribution bar (GeoViewController.isAttributionTextVisible). The default GeometryEditorReticle.image shows a crosshair with a rounded square border, with black and white lines to help the reticle be distinguished clearly over a variety of different basemaps and operational layers. To customize the appearance of the reticle in order to suit your specific app style, accessibility requirements, or to suit a specific basemap, call GeometryEditorReticle.setImage, or GeometryEditorReticle.setImageWithSize.
To avoid potential confusion, when the GeometryEditorReticle is visible the magnifier will not appear, regardless of the value of ArcGISMapViewController.magnifierEnabled. If a magnifier is already visible then it will be hidden when the reticle is displayed.
- Implemented types
Constructors
- GeometryEditorReticle()
-
Creates a reticle that can be assigned to ReticleVertexTool.reticle.
factory
Properties
- hashCode → int
-
The hash code for this object.
no setterinherited
- height → double
-
The height of the GeometryEditorReticle.image displayed on the
ArcGISMapViewController in device-independent pixels (DIPs). The default
value is 135 DIPs.
no setter
- image → ArcGISImage
-
The image representing the reticle to display on the
ArcGISMapViewController.
no setter
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- width → double
-
The width of the GeometryEditorReticle.image displayed on the
ArcGISMapViewController in device-independent pixels (DIPs). The default
value is 135 DIPs.
no setter
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
setImage(
ArcGISImage image) → void - Sets the image that should be used to display the reticle at the design size on the ArcGISMapViewController.
-
setImageWithSize(
{required ArcGISImage image, required double width, required double height}) → void - Sets the image that should be used to display the reticle at a desired size on the ArcGISMapViewController.
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited