SetOptions Method—ArcGIS Pro

SetOptions Method

In This Topic

Sets the snapping options for the specified map. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

Visual Basic (Declaration)
C#

Public Shared Sub SetOptions( _
   ByVal map As Map, _
   ByVal options As SnappingOptions _
)

public static void SetOptions( 
   Map map,
   SnappingOptions options
)

Parameters

map
options: a SnappingOptions object that was obtained using GetOptions

Exceptions

Exception	Description
System.ArgumentNullException	if either of options or map is null
System.ArgumentOutOfRangeException	if the XYTolerance or ZTolerance is negative, NaN or infinite
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.

Example

Snap Options

var myMap = MapView.Active.Map;
// Set snapping options via get/set options
var snapOptions = Snapping.GetOptions(myMap);
snapOptions.IsSnapToSketchEnabled = true;
snapOptions.XYTolerance = 100;
snapOptions.IsZToleranceEnabled = true;
snapOptions.ZTolerance = 0.6;

// turn on snap tip display parts
snapOptions.SnapTipDisplayParts = (int)SnapTipDisplayPart.SnapTipDisplayLayer + (int)SnapTipDisplayPart.SnapTipDisplayType;

// turn off all snaptips
// snapOptions.SnapTipDisplayParts = (int)SnapTipDisplayPart.SnapTipDisplayNone;

// turn on layer display only
// snapOptions.SnapTipDisplayParts = (int)SnapTipDisplayPart.SnapTipDisplayLayer;

snapOptions.SnapTipColor = ColorFactory.Instance.RedRGB;

Snapping.SetOptions(myMap, snapOptions);

Requirements

Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.0 or higher.

Reference

Snapping Class
Snapping Members

Send feedback