DimensionLayerView

// create new layer and add it to the scene view
const dimensionLayer = new DimensionLayer();
view.map.add(dimensionLayer);
// retrieve layer view for the layer
view.whenLayerView(dimensionLayer).then(dimensionLayerView => {
   // allow existing dimensions in the layer to be edited by selecting them
   dimensionLayerView.interactive = true;
   // start adding new dimensions interactively
   dimensionLayerView.createLengthDimensions();
});

// retrieve measured results from the layer view
view.whenLayerView(dimensionLayer).then(dimensionLayerView => {
   const results = dimensionLayerView.results;
});

属性概述

属性详细信息

declaredClass Stringreadonly inherited

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

interactive Boolean

设置为 true 以启用图层的交互。如果图层源包含任何尺寸，则它们将变为可选择和可编辑的。

默认值：false

layer DimensionLayerreadonly

正在查看的图层。

results Collection<LengthDimensionResult>readonly

图层源中每个尺寸的结果。

给定 dimension 对象，可搜索结果集合：

const result = dimensionLayerView.results.find((result) => result.dimension === dimensionObject);

selectedDimension LengthDimension

所选尺寸注记。如果交互性为 true，则可以通过在视图中单击该尺寸注记来选择图层中的任何尺寸。只要交互性保持为 true，即可通过与视图中的操纵器进行交互来编辑所选尺寸注记的属性。

suspended Booleanreadonly

如果图层被挂起 (即，当图层范围发生更改时，图层将不会重绘或更新)，则值为 true。

updating Booleanreadonly inherited

更新图层时，值为 true；例如，如果它正在获取数据。

默认值：false

visible Boolean inherited

当为 true 时，图层在视图中可见。此属性的值继承自 layer.visible，除非开发人员重写它。如果设置了两个属性，则 layerView.visible 将优先于 layer.visible。

默认值：true

方法概述

方法详细说明

addHandles(handleOrHandles, groupKey)inherited

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

// 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() 进行删除。如果未提供键，则句柄将被添加到默认组。

createLengthDimensions(options){Promise}

开始交互性创建新尺寸注记并将其添加到图层源中。

当用户双击鼠标或按下 escape 键时，创建过程将完成。要以其他方式停止创建过程，请在调用方法时传递一个中止信号作为参数。

let abortController;
view.whenLayerView(dimensionLayer).then(dimensionLayerView => {
   // create a new controller
   abortController = new AbortController();
   // pass the controller as an argument to the interactive creation method
   dimensionLayerView.createLengthDimensions(abortController);
   // abort the controller to stop the creation process
   abortController.abort();
});

调用此方法可将交互性设置为 true。

参数

options Object optional 指定附加选项的对象。 规范 signal AbortSignal optional 中止信号，可用于取消创建。

返回

类型	描述
Promise	在创建完成时进行解析的承诺，或在取消创建时拒绝的承诺。

hasHandles(groupKey){Boolean}inherited

如果存在指定的句柄组，则返回 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");
}

isFulfilled(){Boolean}inherited

isFulfilled() 可用于验证创建类的实例是否已完成 (已解决或已拒绝)。如果满足，则返回 true。

返回

类型	描述
Boolean	指示创建类的实例是否已完成 (已解决或已拒绝)。

isRejected(){Boolean}inherited

isRejected() 可用于验证创建类的实例是否被拒绝。如果被拒绝，则返回 true。

返回

类型	描述
Boolean	指示创建类的实例是否已被拒绝。

isResolved(){Boolean}inherited

isResolved() 可用于验证创建类的实例是否已解决。如果已解决，则返回 true。

返回

类型	描述
Boolean	指示创建类的实例是否已解决。

removeHandles(groupKey)inherited

移除对象拥有的句柄组。

参数

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

示例

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

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

when(callback, errback){Promise}inherited

一旦创建了类的实例，就可以使用when() 。此方法接受两个输入参数：callback 函数和 errback 函数。callback 在类的实例加载时执行。errback 在类的实例无法加载时执行。

参数

callback Function optional 当 promise 解决时调用的函数。

errback Function optional 当 promise 失败时执行的函数。

返回

类型	描述
Promise	返回 callback 结果的新承诺，可用于链接其他函数。

示例

// Although this example uses MapView, any class instance that is a promise may use when() in the same way
let view = new MapView();
view.when(function(){
  // This function will execute once the promise is resolved
}, function(error){
  // This function will execute if the promise is rejected due to an error
});