Configures a valid source of geometries that the GeometryEditor can snap interactive edits to. More...
Header: | #include <SnapSourceSettings.h> |
Since: | Esri::ArcGISRuntime 200.4 |
Inherits: | Esri::ArcGISRuntime::Object |
Public Functions
virtual | ~SnapSourceSettings() override |
bool | isEnabled() const |
void | setEnabled(bool enabled) |
Esri::ArcGISRuntime::SnapSource * | source() const |
Detailed Description
Following a call to SnapSettings::syncSourceSettings, the SnapSettings::sourceSettings collection is populated with SnapSourceSettings objects that are valid for snapping. Each represents a SnapSource that is in the currently connected map and provides full resolution geometries suitable for snapping.
Set isEnabled to true
for each item that you want allow your users to snap to. You may wish to delegate the choice of snapping sources to users by binding the collection of snapping sources to controls which allow them to change isEnabled for each snapping source individually.
Snapping works for visible objects within a visible SnapSource - for example if a feature layer or graphics overlay is not visible due to the current scale range, definition expression, or other reason, it will not participate in snapping at that time. Visibility does not affect whether a SnapSourceSettings object is present in the SnapSettings::sourceSettings collection or not.
See SnapSource for more information about which data sources are valid for snapping.
Relevant samples:
- Snap geometry edits: Use the Geometry Editor to edit a geometry and align it to existing geometries on a map.
See also SnapSettings and SnapSource.
Member Function Documentation
[override virtual]
SnapSourceSettings::~SnapSourceSettings ()
Destructor.
bool SnapSourceSettings::isEnabled () const
Returns true
to enable snapping to the geometries in the SnapSource, false
otherwise. Default is false
.
Snapping sources can be enabled or disabled individually. If SnapSettings::isEnabled is false
, this value is ignored and snapping is not enabled.
See also SnapSettings.
void SnapSourceSettings::setEnabled (bool enabled)
Sets the enabled to enabled.
See also isEnabled.
Esri::ArcGISRuntime::SnapSource *SnapSourceSettings::source() const
Returns underlying source of geometries to snap to, for example a FeatureLayer or GraphicsOverlay.
See also SnapSettings.