Draw

// create a new instance of draw
let draw = new Draw({
  view: view
});

// create an instance of draw polyline action
// the polyline vertices will be only added when
// the pointer is clicked on the view
let action = draw.create("polyline", {mode: "click"});

// fires when a vertex is added
action.on("vertex-add", function (evt) {
  measureLine(evt.vertices);
});

// fires when the pointer moves
action.on("cursor-update", function (evt) {
  measureLine(evt.vertices);
});

// fires when the drawing is completed
action.on("draw-complete", function (evt) {
  measureLine(evt.vertices);
});

// fires when a vertex is removed
action.on("vertex-remove", function (evt) {
  measureLine(evt.vertices);
});

function measureLine(vertices) {
  view.graphics.removeAll();

  let line = createLine(vertices);
  let lineLength = geometryEngine.geodesicLength(line, "miles");
  let graphic = createGraphic(line);
  view.graphics.add(graphic);
}

function createLine(vertices) {
  let polyline = {
    type: "polyline", // autocasts as new Polyline()
    paths: vertices,
    spatialReference: view.spatialReference
  }
  return polyline;
}

属性概述

属性详细信息

activeAction DrawAction

对活动的绘制操作的引用。调用 create() 方法时会创建一个绘制操作实例。

declaredClass Stringreadonly inherited

起始版本：GeoScene Maps SDK for JavaScript 4.7

类的名称。声明的类名称格式化为 geoscene.folder.className。

view MapView

对 MapView 的引用。设置此选项可将绘图链接到特定视图。

方法概述

方法详细说明

addHandles(handleOrHandles, groupKey)inherited

起始版本：GeoScene Maps SDK for JavaScript 4.25

添加一个或多个与对象的生命周期相关联的句柄。当对象被销毁时，将移除句柄。

// Manually manage handles
const handle = reactiveUtils.when(
  () => !view.updating,
  () => {
    wkidSelect.disabled = false;
  },
  { once: true }
);

// Handle gets removed when the object is destroyed.
this.addHandles(handle);

参数

handleOrHandles WatchHandle|WatchHandle[] 对象销毁后，标记为要移除的句柄。

groupKey * optional 标识句柄应添加到的组的键。组中的所有句柄稍后都可使用 Accessor.removeHandles() 进行删除。如果未提供键，则句柄将被添加到默认组。

complete()

起始版本：GeoScene Maps SDK for JavaScript 4.7

完成当前活动的绘制。

create(drawAction, drawOptions){DrawAction}

创建请求的绘制操作的实例。

参数

drawAction String 要创建的绘制操作的名称。有关可能值列表和它创建的绘制操作类型，请参见下表。 可能值 几何类型 绘制操作实例 point PointDrawAction multipoint MultipointDrawAction (仅在 MapView 中受支持) polyline PolylineDrawAction polygon PolygonDrawAction rectangle, circle, ellipse SegmentDrawAction 可能值："point"|"multipoint"|"polyline"|"polygon"|"rectangle"|"circle"|"ellipse"

drawOptions Object optional 要创建的几何的绘制选项对象。 规范 mode String optional 绘图模式。绘图模式仅在创建 polygon、polyline、segment 绘制操作时适用。 可能值 值 描述 hybrid 在单击或拖动指针时添加折点。适用于 polygon 和 polyline 绘制操作，并且是默认设置。 freehand 在拖动指针时添加折点。适用于 polygon、polyline 和 segment 绘制操作。segment 绘制操作的默认值。 click 单击指针时会添加折点。 可能值："hybrid"|"freehand"|"click"

返回

类型	描述
DrawAction	返回请求的绘制操作的实例。

示例

let pointAction = draw.create("point");

hasHandles(groupKey){Boolean}inherited

起始版本：GeoScene Maps SDK for JavaScript 4.25

如果存在指定的句柄组，则返回 true。

参数

groupKey * optional 组键。

返回

类型	描述
Boolean	如果存在指定的句柄组，则返回 true。

示例

// Remove a named group of handles if they exist.
if (obj.hasHandles("watch-view-updates")) {
  obj.removeHandles("watch-view-updates");
}

removeHandles(groupKey)inherited

起始版本：GeoScene Maps SDK for JavaScript 4.25

移除对象拥有的句柄组。

参数

groupKey * optional 要移除的组键或组键的数组或集合。

示例

obj.removeHandles(); // removes handles from default group

obj.removeHandles("handle-group");
obj.removeHandles("other-handle-group");

reset()

起始版本：GeoScene Maps SDK for JavaScript 4.6

通过清除活动操作来重置绘制。