changeLocateState(enableLocate: boolean, enableSnap?: false | true, cursor?: string, coordLockOvr?: CoordinateLockOverrides): void
|enableLocate||boolean||Value to pass to AccuSnap.enableLocate. Tools that locate elements should always pass true to give the user feedback regarding the element at the current cursor location.|
|enableSnap||false | true||Optional value to pass to AccuSnap.enableSnap. Tools that don't care about the element pick location should not pass true. Default is false.|
|cursor||string||Optional tool specific cursor override. Default is either cross or dynamics cursor depending on whether dynamics are currently active.|
|coordLockOvr||CoordinateLockOverrides||Optional tool specific coordinate lock overrides. A tool that only identifies elements and does not use BeButtonEvent.point can set ToolState.coordLockOvr to CoordinateLockOverrides.ACS
or CoordinateLockOverrides.All, otherwise locate is affected by the input point being first projected to the ACS plane. A tool that will use BeButtonEvent.point, especially those that call AccuSnap.enableSnap
should honor all locks and leave ToolState.coordLockOvr set to CoordinateLockOverrides.None, the default for ViewTool and PrimitiveTool.
Last Updated: 13 October, 2019