所有类

概要:
嵌套 |
字段 |
构造器 |
方法

详细资料:
字段 |
构造器 |
方法

java.lang.Object
- com.supermap.data.InternalHandle
- - com.supermap.data.InternalHandleDisposable
  - - com.supermap.ui.TopologicalEditingTool

所有已实现的接口:

IDisposable
```
public class TopologicalEditingTool
extends com.supermap.data.InternalHandleDisposable
```
地图拓扑编辑相关工具类。
启用拓扑编辑后，程序自动基于当前地图可视范围内的可见对象动态构建拓扑图并切换至拓扑编辑模式。

12.0.0版本中，地图拓扑编辑仅适用于二维面数据集，因此，地图中仅二维面数据集对象参与拓扑图构建和拓扑编辑。

拓扑图可实时显示对象间的空间关系（如共享边、节点），参与构建拓扑图的对象为当前地图可视范围内的可见对象（目前仅支持二维面数据集中的对象）。拓扑图将随地图可视范围变化自动更新。

拓扑图以临时图层形式叠加在地图最顶层，不保存为永久数据。

拓扑图中包含两类基础元素：
- 边：由两个节点定义，代表连续的线性边界，边上的折点与相关对象的节点相对应。
- 节点：定义两条或多条边的交点。
地图拓扑编辑相关工具类可以提供如下能力：
- 设置拓扑元素（拓扑边、拓扑节点）的显示风格
- 设置拓扑编辑操作过程中拓扑元素的动态显示风格
- 设置拓扑编辑容限
- 获取拓扑元素查询结果
从以下版本开始:

12.0.0

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`void`	`dispose()`
`GeoStyle`	`getAlignEdgeModifiedStyle()` 获取对齐边（`Action.TOPOLOGICAL_EDITING_ALIGN_EDGE`）操作下，待修改拓扑边显示风格，默认为：实线（线型符号ID为0 ），颜色：FFFFFF00，粗细：1.2。
`GeoStyle`	`getAlignEdgeRelatedStyle()` 获取对齐边（`Action.TOPOLOGICAL_EDITING_ALIGN_EDGE`）操作下，对齐到目标拓扑边显示风格，默认为：虚线（线型符号ID为 1），颜色：FFFFFF00，线粗细：1.2。
`boolean`	`getRelatedGeometryEditable(String topologyElementID, String datasetName, int geometryID)` 获取与指定拓扑元素共享边或节点的指定ID对象的可编辑状态，默认为可编辑。
`String[]`	`GetSelectedTopologyElementID()` 获取被选中拓扑元素（拓扑边或拓扑节点）的ID。
`double`	`getTolerance()` 获取对象节点之间的距离容限，在容限内的对象节点将被约束为重合并共享同一拓扑位置（如拓扑节点或拓扑边上的折点）。
`List<TopologyElementRelatedGeometryInfo>`	`getTopologyElementRelatedGeometries(String topologyElementID)` 获取与指定拓扑元素共享边或节点的对象信息，包括：对象所在的数据集名称和对象ID。
`GeoStyle`	`getTopologyElementSelectedStyle()` 获取拓扑元素（拓扑边、拓扑节点）被选中时的显示风格。
`GeoStyle`	`getTopologyElementStyle()` 获取拓扑元素（拓扑边、拓扑节点）的显示风格。
`void`	`setAlignEdgeModifiedStyle(GeoStyle style)` 设置对齐边（`Action.TOPOLOGICAL_EDITING_ALIGN_EDGE`）操作下，待修改拓扑边显示风格。
`void`	`setAlignEdgeRelatedStyle(GeoStyle style)` 设置对齐边（`Action.TOPOLOGICAL_EDITING_ALIGN_EDGE`）操作下，对齐到目标拓扑边显示风格。
`void`	`setRelatedGeometryEditable(String topologyElementID, String datasetName, int geometryID, boolean editable)` 设置与指定拓扑元素共享边或节点的指定ID对象的可编辑状态。
`void`	`setTolerance(double tolerance)` 设置对象节点之间的距离容限，在容限内的对象节点将被约束为重合并共享同一拓扑位置（如拓扑节点或拓扑边上的折点）。
`void`	`setTopologyElementSelectedStyle(GeoStyle style)` 设置拓扑元素（拓扑边、拓扑节点）被选中时的显示风格。
`void`	`setTopologyElementStyle(GeoStyle style)` 设置拓扑元素（拓扑边、拓扑节点）的显示风格。

从类继承的方法 com.supermap.data.InternalHandleDisposable
makeSureNativeObjectLive

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - dispose
```
public void dispose()
```
  - getTolerance
```
public double getTolerance()
```
    获取对象节点之间的距离容限，在容限内的对象节点将被约束为重合并共享同一拓扑位置（如拓扑节点或拓扑边上的折点）。容限默认值：0.001米（投影坐标系）或 0.0000000556度（地理坐标系）。
    
    返回:
    
    返回对象节点之间的距离容限。
    
    抛出:
    
    IllegalStateException - 当地图拓扑编辑相关工具类对象已释放。
    
    从以下版本开始:
    
    12.0.0
  - setTolerance
```
public void setTolerance(double tolerance)
```
    设置对象节点之间的距离容限，在容限内的对象节点将被约束为重合并共享同一拓扑位置（如拓扑节点或拓扑边上的折点）。
    
    参数:
    
    tolerance - 容限值，单位与地图坐标系一致，值域：(0, 1e+5]。
    
    抛出:
    
    IllegalStateException - 当地图拓扑编辑相关工具类对象已释放。
    
    IllegalArgumentException - 当容限值参数小于等于0或大于 1e+5。
    
    从以下版本开始:
    
    12.0.0
  - getTopologyElementStyle
```
public GeoStyle getTopologyElementStyle()
```
    获取拓扑元素（拓扑边、拓扑节点）的显示风格。拓扑边默认显示风格：颜色：#E86CB8，粗细：0.6；拓扑节点默认显示风格：颜色：#E86CB8，点大小：5。
    
    返回:
    
    返回拓扑元素（拓扑边、拓扑节点）的显示风格。
    
    抛出:
    
    IllegalStateException - 当地图拓扑编辑相关工具类对象已释放。
    
    从以下版本开始:
    
    12.0.0
  - setTopologyElementStyle
```
public void setTopologyElementStyle(GeoStyle style)
```
    设置拓扑元素（拓扑边、拓扑节点）的显示风格。
    
    参数:
    
    style - 拓扑元素显示风格。
    
    抛出:
    
    IllegalStateException - 当地图拓扑编辑相关工具类对象已释放。
    
    IllegalArgumentException - 当拓扑元素显示风格参数为空或者已释放。
    
    从以下版本开始:
    
    12.0.0
  - getTopologyElementSelectedStyle
```
public GeoStyle getTopologyElementSelectedStyle()
```
    获取拓扑元素（拓扑边、拓扑节点）被选中时的显示风格。拓扑边默认选中风格：颜色：FF0070C0，粗细：0.9；拓扑节点默认选中风格：颜色：FF0070C0，点大小：6。
    
    返回:
    
    拓扑元素选中风格。
    
    抛出:
    
    IllegalStateException - 当地图拓扑编辑相关工具类对象已释放。
    
    从以下版本开始:
    
    12.0.0
  - setTopologyElementSelectedStyle
```
public void setTopologyElementSelectedStyle(GeoStyle style)
```
    设置拓扑元素（拓扑边、拓扑节点）被选中时的显示风格。
    
    参数:
    
    style - 拓扑元素选中风格。
    
    抛出:
    
    IllegalStateException - 当地图拓扑编辑相关工具类对象已释放。
    
    IllegalArgumentException - 当拓扑元素选中风格参数为空或者已释放。
    
    从以下版本开始:
    
    12.0.0
  - getAlignEdgeModifiedStyle
```
public GeoStyle getAlignEdgeModifiedStyle()
```
    获取对齐边（Action.TOPOLOGICAL_EDITING_ALIGN_EDGE）操作下，待修改拓扑边显示风格，默认为：实线（线型符号ID为0 ），颜色：FFFFFF00，粗细：1.2。
    
    返回:
    
    返回对齐边操作下，待修改拓扑边显示风格。
    
    抛出:
    
    IllegalStateException - 当地图拓扑编辑相关工具类对象已释放。
    
    从以下版本开始:
    
    12.0.0
  - setAlignEdgeModifiedStyle
```
public void setAlignEdgeModifiedStyle(GeoStyle style)
```
    设置对齐边（Action.TOPOLOGICAL_EDITING_ALIGN_EDGE）操作下，待修改拓扑边显示风格。
    
    参数:
    
    style - 对齐边操作下，待修改拓扑边显示风格。
    
    抛出:
    
    IllegalStateException - 当地图拓扑编辑相关工具类对象已释放。
    
    IllegalArgumentException - 当待修改拓扑边显示风格参数为空或者已释放。
    
    从以下版本开始:
    
    12.0.0
  - getAlignEdgeRelatedStyle
```
public GeoStyle getAlignEdgeRelatedStyle()
```
    获取对齐边（Action.TOPOLOGICAL_EDITING_ALIGN_EDGE）操作下，对齐到目标拓扑边显示风格，默认为：虚线（线型符号ID为 1），颜色：FFFFFF00，线粗细：1.2。
    
    返回:
    
    返回对齐到目标拓扑边显示风格。
    
    抛出:
    
    IllegalStateException - 当地图拓扑编辑相关工具类对象已释放。
    
    从以下版本开始:
    
    12.0.0
  - setAlignEdgeRelatedStyle
```
public void setAlignEdgeRelatedStyle(GeoStyle style)
```
    设置对齐边（Action.TOPOLOGICAL_EDITING_ALIGN_EDGE）操作下，对齐到目标拓扑边显示风格。
    
    参数:
    
    style - 对齐到目标拓扑边显示风格。
    
    抛出:
    
    IllegalStateException - 当地图拓扑编辑相关工具类对象已释放。
    
    IllegalArgumentException - 当对齐到目标拓扑边显示风格参数为空或者已释放。
    
    从以下版本开始:
    
    12.0.0
  - GetSelectedTopologyElementID
```
public String[] GetSelectedTopologyElementID()
```
    获取被选中拓扑元素（拓扑边或拓扑节点）的ID。
    
    返回:
    
    返回被选中拓扑元素的ID。
    
    抛出:
    
    IllegalStateException - 当地图拓扑编辑相关工具类对象已释放。
    
    从以下版本开始:
    
    12.0.0
  - getTopologyElementRelatedGeometries
```
public List<TopologyElementRelatedGeometryInfo> getTopologyElementRelatedGeometries(String topologyElementID)
```
    获取与指定拓扑元素共享边或节点的对象信息，包括：对象所在的数据集名称和对象ID。
    
    参数:
    
    topologyElementID - 指定拓扑元素的ID。
    
    返回:
    
    返回与指定拓扑元素共享边或节点的对象信息，包括：对象所在的数据集名称和对象ID。
  - getRelatedGeometryEditable
```
public boolean getRelatedGeometryEditable(String topologyElementID,
                                          String datasetName,
                                          int geometryID)
```
    获取与指定拓扑元素共享边或节点的指定ID对象的可编辑状态，默认为可编辑。
    
    参数:
    
    topologyElementID - 指定拓扑元素的ID。
    
    datasetName - 与指定拓扑元素共享边或节点的指定ID对象所在的数据集名称。
    
    geometryID - 与指定拓扑元素共享边或节点的对象的ID。
    
    返回:
    
    如果对象可编辑，返回true，否则返回false。
    
    抛出:
    
    IllegalStateException - 当地图拓扑编辑相关工具类对象已释放。
    
    IllegalArgumentException - 当指定拓扑元素的ID参数为空，或者当对象所在数据集名称参数为空。
    
    从以下版本开始:
    
    12.0.0
  - setRelatedGeometryEditable
```
public void setRelatedGeometryEditable(String topologyElementID,
                                       String datasetName,
                                       int geometryID,
                                       boolean editable)
```
    设置与指定拓扑元素共享边或节点的指定ID对象的可编辑状态。
    
    参数:
    
    topologyElementID - 指定拓扑元素的ID。
    
    datasetName - 与指定拓扑元素共享边或节点的指定ID对象所在的数据集名称。
    
    geometryID - 与指定拓扑元素共享边或节点的对象的ID。
    
    editable - 如果为true，则对象可编辑，如果为false，则对象不可编辑。拓扑编辑操作完成后，仅当拓扑元素关联的对象处于可编辑状态时，系统才会同步修改对应对象，确保拓扑一致性。
    
    抛出:
    
    IllegalStateException - 当地图拓扑编辑相关工具类对象已释放。
    
    IllegalArgumentException - 参数非法。
    
    从以下版本开始:
    
    12.0.0

跳过导航链接

所有类

概要:
嵌套 |
字段 |
构造器 |
方法

详细资料:
字段 |
构造器 |
方法

类 TopologicalEditingTool

方法概要

从类继承的方法 com.supermap.data.InternalHandleDisposable

从类继承的方法 java.lang.Object

方法详细资料

dispose

getTolerance

setTolerance

getTopologyElementStyle

setTopologyElementStyle

getTopologyElementSelectedStyle

setTopologyElementSelectedStyle

getAlignEdgeModifiedStyle

setAlignEdgeModifiedStyle

getAlignEdgeRelatedStyle

setAlignEdgeRelatedStyle

GetSelectedTopologyElementID

getTopologyElementRelatedGeometries

getRelatedGeometryEditable

setRelatedGeometryEditable