JavaScript ArcGIS Sketch用法及代码示例

下表说明了用于创建具有不同几何形状的图形的指针和键盘手势。

创建点图形

创建折线和多边形图形

创建折线和多边形图形时适用以下键盘快捷键。

手势	行动	示例
Left-click	在指针位置添加一个顶点。
Left-drag	在 hybrid 或 freehand 模式下为每次指针移动添加一个顶点。
F	将顶点添加到 polyline 或 polygon 图形。在click模式下完成rectangle或circle多边形图形。
Enter	完成没有分段顶点的 polyline 或 polygon 图形。 double-click 将在当前鼠标光标的位置完成图形。
Z	逐步撤消堆栈中记录的操作。撤消/重做堆栈用于单个草图操作，这意味着您可以在创建或更新图形时重做/撤消操作。
R	增量重做堆栈中记录的操作。撤消/重做堆栈用于单个草图操作，这意味着您可以在创建或更新图形时重做/撤消操作。
Ctrl	根据 snappingOptions 中的配置切换捕捉。
空格键+Left-drag	在创建折线或多边形图形时平移视图。
左键单击第一个顶点	完成多边形图形草图。

创建具有预定义形状的多边形图形

以下键盘快捷键适用于创建具有预定义形状的多边形图形(rectangle 和 circle)。

手势	行动	示例
左键单击+拖动	创建一个 rectangle 图形，其尺寸基于初始单击和光标位置之间的边界框。根据初始单击和光标位置之间的距离创建半径为 circle 的图形。
Shift+左键单击+拖动	将形状从 rectangle 更改为 square 或从 circle 更改为 ellipse 。
Alt+左键单击+拖动	创建一个 rectangle 图形，在初始单击时具有中心，尺寸基于初始单击与光标位置之间的距离。创建一个 circle 图形，其半径基于初始单击和光标位置之间的边界框。
Shift+Alt+左键单击+拖动	结合上述行为。

更新图形

Sketch 小部件使用户能够在更新操作期间移动、旋转、缩放或重塑图形。要开始更新，请在图形上使用Left-click。使用 Shift+Left-click 将更多图形添加到选择中，或从选择中删除图形，以进行批量更新。选择图形后，可以执行以下操作。

手势	行动	示例
左键单击图形	选择要移动、旋转或缩放的图形。
Shift+左键单击图形	选择或取消选择多个图形以移动、旋转或缩放。
拖动图形	移动选定的图形。
拖动旋转手柄	旋转选定的图形。
拖动刻度手柄	缩放选定的图形。
Shift+左键单击+拖动缩放手柄	在中心缩放所选图形。
Z	逐步撤消堆栈中记录的操作。撤消/重做堆栈用于单个草图操作，这意味着您可以在创建或更新图形时重做/撤消操作。
R	增量重做堆栈中记录的操作。撤消/重做堆栈用于单个草图操作，这意味着您可以在创建或更新图形时重做/撤消操作。
左键单击视图(不是图形)	完成图形更新。
按Delete键	从图层中删除选定的图形。

可以对单个折线或多边形图形执行以下更新操作：

手势	行动	示例
左键单击图形	选择要移动或重塑的图形。
拖动图形	移动选定的图形。
左键单击幽灵顶点	添加一个新顶点。
左键单击一个顶点	选择一个顶点。
Shift+左键单击顶点	选择或取消选择多个顶点。
拖动顶点	移动选定的一个或多个顶点。
右键单击一个顶点	删除一个顶点。
选择多个顶点并按 Backspace 或 Delete 键	删除多个顶点。

如果图形使用 3D object symbol layer ，则可以对具有 SceneView 中的点几何图形的单个图形执行以下更新操作：

手势	行动	示例
左键单击图形	选择要移动、旋转或缩放的图形。
拖动内手柄	移动选定的图形。
拖动高度手柄	垂直移动所选图形(在 z 轴上)。
横向拖动外手柄	旋转选定的图形。
向内或向外拖动外部手柄	缩放选定的图形。

素描 3D

为了能够使用高度手柄操纵 z 轴上的特征，以下配置是相关的：

• GraphicsLayer 的 Elevation info mode 需要设置为 absolute-height 、 relative-to-scene 或 relative-to-ground 。
• 要使用 z-value 创建图形，defaultCreateOptions 和/或 createOptions 中的 hasZ 需要为 true。
• 要更新图形的 z-value，defaultUpdateOptions 和/或 updateOptions 中的 enableZ 需要为 true。

// define the GraphicsLayer
const gLayer = new GraphicsLayer({
  elevationInfo: {
    mode: "absolute-height" // default value
  }
});

// define the SketchViewModel
const sketchVM = new SketchViewModel({
  layer: gLayer,
  view: view,
  defaultCreateOptions: {
    hasZ: true  // default value
  },
  defaultUpdateOptions: {
    enableZ: true  // default value
  }
});

在absolute-height 模式下，草图顶点捕捉到场景元素(特征和地面)。在absolute-height 模式下绘制的polygon 是平面的，这意味着所有polygon 顶点都使用第一个顶点的高度。有关如何将z-values 与不同的高程模式一起使用的更多信息，请参阅elevation info。