Snap
Controls interactive snapping functionality for the GeometryEditor. Snapping allows you to create geometries that connect to each other and are coincident, so that interactive edits are more accurate, with fewer errors.
If SnapSettings.isEnabled is true and a user edits a geometry interactively, then when the pointer is close to an existing snappable feature, the position of the interactive edit is adjusted to coincide with ("snap to") that feature. When the edit position has been adjusted, visual cues show the user the adjusted edit position, and which aspect of the feature geometry was used as the best candidate for that adjustment.
To use snapping in the GeometryEditor:
Connect a GeometryEditor to a map view using MapView.geometryEditor, and ensure the MapView.map and any layers in it are loaded.
Only layers that provide full resolution geometries can be used for snapping.
Get the GeometryEditor.snapSettings, set SnapSettings.isEnabled to true, and call SnapSettings.syncSourceSettings().
Set SnapSourceSettings.isEnabled to true for each SnapSource that you want users to be able to snap to.
You may wish to enable all the SnapSourceSettings, use only select sources, or delegate the choice to your users.
Call SnapSettings.syncSourceSettings() to populate the collection of sources. You can also call this method to refresh the collection as required, preserving the state of any existing SnapSourceSettings.
Call one of the start methods on GeometryEditor to allow the end user to create or edit a new geometry by choosing to snap to the specified snapping sources.
You can snap to SnapSource objects that are contained in the MapView associated with the GeometryEditor, and are visible. As snapping is used to maintain data integrity between different sources of data, only SnapSource objects that provide full resolution geometries can be used for snapping. See SnapSource for more information.
The visual cues that indicate to a user when snapping has occurred can be customized using GeometryEditorStyle.snappedToVertexSymbol, GeometryEditorStyle.snappedToLineSymbol. If there are multiple potential candidates that could be snapped to for a given pointer position, then GeometryEditorStyle.multipleSnapCandidatesSymbol is used to indicate this.
Since
200.4.0
See also
Constructors
Creates a default SnapSettings.
Properties
True if interactive geometry edits made using the GeometryEditor should happen using the current SnapSettings, false otherwise. Default is false. If SnapSettings.isEnabled is true and a user edits a geometry interactively, then when the pointer is close to an existing snappable feature, the position of the interactive edit is adjusted to coincide with ("snap to") that feature. The content of SnapSettings.sourceSettings determines which sources of geometries can be used to snap to.
Defines the collection of snapping sources and whether or not each is enabled for snapping. Call SnapSettings.syncSourceSettings() to populate this collection with a SnapSourceSettings for each valid SnapSource present in the connected ArcGISMap. SnapSettings is connected to an ArcGISMap via GeometryEditor.snapSettings, MapView.geometryEditor, and MapView.map. If there is no connected map, or the map contains no valid SnapSource objects, then the collection will be empty after SnapSettings.syncSourceSettings() returns.
Functions
Synchronizes the SnapSettings.sourceSettings collection based on SnapSource objects in the currently connected ArcGISMap. Call this method to populate SnapSettings.sourceSettings with a SnapSourceSettings for each valid SnapSource present in the ArcGISMap currently connected to this SnapSettings via GeometryEditor.snapSettings, MapView.geometryEditor, and MapView.map. If there is no connected ArcGISMap, or the map contains no SnapSource objects valid for snapping, then the collection will be empty after this method returns.