ImportSettingDGN (iObjects Java Help)

java.lang.Object
- com.supermap.data.InternalHandle
- - com.supermap.data.InternalHandleDisposable
  - - com.supermap.data.conversion.ImportSetting
    - - com.supermap.data.conversion.ImportSettingDGN

所有已实现的接口:: IDisposable

public class ImportSettingDGN
extends ImportSetting

DGN 文件导入的参数设置类。继承自 ImportSetting 类。

该类型在 Windows平台版本中支持，在 Linux版本中不提供。

DGN(Design) 是一种 CAD 文件格式，为美国 Bentley System 公司的 MicroStation 和 Intergraph 公司的 Interactive Graphics Design System(IGDS) CAD 程序所支持。

DGN 主要包括两个版本：V7 DGN 和 V8 DGN，SuperMap 组件产品支持这两个版本的导入。具体版本类型及说明可参见 DGNVersion。

注意：

传入的文件型的数据源和工作空间连接信息，在传入之前不能被打开，否则会导入失败；
DGN数据可导入为点、线、面、文本简单数据集和CAD数据集，相关接口setImportingAsCAD；
DGN数据导入为简单数据集和CAD数据集，非FME都支持按层导入，FME仅导入为CAD数据集时支持按层导入，相关接口setImportingByLayer；
DGN支持风格对照，其中风格对照中的符号对照仅针对单元和共享单元导入为点时起作用，即setImportingCellAsPoint为true，相关接口setImportingCellAsPoint；

说明：

DGN二维线、二维线串、二维曲线、二维B样曲线导入为二维线，三维线、三维线串、三维曲线、三维B样曲线导入为三维线，其中二维线首尾重合导入为二维点，三维线首尾重合导入为三维点；
DGN二维面、复杂面导入为二维面，三维面导入为三维面；
DGN二维圆、三维圆导入CAD数据集为二维圆，导入简单数据集为二维面；
DGN二维椭圆、三维椭圆导入CAD数据集为二维椭圆，导入简单数据集为二维面；
DGN二维弧、三维弧导入为二维对象：
- 导入CAD数据集
  - a.扫角为0时，导入为二维点；
  - b.扫角为360度，主轴与辅轴相等时，导入为二维圆；
  - c.扫角为其它值，主轴与辅轴相等时，导入为二维圆弧；
  - d.扫角小于等于1度，主轴与辅轴不相等时，导入为二维线；
  - e.其它情况，导入为二维椭圆弧。
- 导入简单数据集
  - a.扫角为0时，导入为二维点；
  - b.其它情况，导入为二维线。
DGN二维文本、三维文本、标签导入为二维文本，其中字体支持不全，没有的字体默认为Arial，DGN横向文本导入后为左基线对齐，垂直文本导入后为左上角对齐，不支持DGN文本风格颠倒、反向、字间距；
DGN多线导入CAD数据集时，轮廓个数大于1导入为复合对象，否则导入为二维线，导入简单数据集时全部为二维线；
DGN二维多行文本、三维多行文本、复杂线、标注、二维单元、三维单元、共享单元导入CAD数据集为复合对象；

DGN导入后有19个用户字段，如下：

字段名称	字段说明
ElementID	元素ID
MSLINK	DMRS链接,多个之间以','分隔
ENTITY	DMRS链接表ID,多个之间以','分隔
DgnLink	DGN链接,多个之间以'\|'分隔
OriginLevel	图层
OriginLineStyle	线型名称
CellName	单元或共享单元名称
CellRotateAngle	单元或共享单元旋转角度
FillColorIndex	填充颜色ID
LineColorIndex	线颜色ID
LineStyle	线型ID
LineWeight	线宽
FillColor	填充颜色
FillMode	填充模式
X	默认0
Y	默认0
Z	默认0
StringLink	String链接,多个之间以','分隔
StringLinkID	String链接ID,多个之间以','分隔

DGN共享单元有颜色、线型、线宽属性，当某种属性被设置时会覆盖所有子对象的相应属性（例如：共享单元的颜色设置为红色，那么所有子对象的颜色都是红色），导入时存在以下情况：

（表格中颜色、线型、线宽表示共享单元相应属性是否设置，风格对照表示导入时是否进行风格对照）

颜色	线型	线宽	风格对照	结果
是	是	是	否	所有子对象为共享单元颜色、线型、线宽
是	是	是	是	所有子对象为共享单元线型风格对照后的颜色、线型、线宽
是	是	否	否	所有子对象为共享单元颜色、线型，子对象本身线宽
是	是	否	是	所有子对象为共享单元线型风格对照后的颜色、线型，子对象本身风格对照后的线宽
是	否	是	否	所有子对象为共享单元颜色、线宽，子对象本身线型
是	否	是	是	所有子对象为共享单元颜色、线宽，子对象本身风格对照后的线型
否	是	是	否	所有子对象为共享单元线型、线宽，子对象本身颜色
否	是	是	是	所有子对象为共享单元线型风格对照后的线型、线宽，子对象本身风格对照后的颜色
是	否	否	否	所有子对象为共享单元颜色，子对象本身线型、线宽
是	否	否	是	所有子对象为共享单元颜色，子对象本身风格对照后的线型、线宽
否	是	否	否	所有子对象为共享单元线型，子对象本身颜色、线宽
否	是	否	是	所有子对象为共享单元线型风格对照后的线型，子对象本身风格对照后的颜色、线宽
否	否	是	否	所有子对象为共享单元线宽，子对象本身颜色、线型
否	否	是	是	所有子对象为共享单元线宽，子对象本身风格对照后的颜色、线型
否	否	否	否	所有子对象为子对象本身颜色、线型、线宽
否	否	否	是	所有子对象为子对象本身风格对照后的颜色、线型、线宽

构造器概要

构造器
构造器和说明
`ImportSettingDGN()` 默认构造函数，构造一个新的`ImportSettingDGN`对象。
`ImportSettingDGN(ImportSettingDGN importSettingDGN)` 拷贝构造函数，根据给定的 ImportSettingDGN 对象构造一个与其完全相同的新对象。
`ImportSettingDGN(String sourceFilePath, Datasource targetDatasource)` 根据指定的参数构造 ImportSettingDGN 类的新实例。
`ImportSettingDGN(String sourceFilePath, Datasource targetDatasource, boolean importingAsCAD)` 根据指定的参数构造 ImportSettingDGN 类的新实例。
`ImportSettingDGN(String sourceFilePath, DatasourceConnectionInfo targetConnectionInfo)` 根据指定的参数构造 ImportSettingDGN 类的新实例。
`ImportSettingDGN(String sourceFilePath, DatasourceConnectionInfo targetConnectionInfo, boolean importingAsCAD)` 根据指定的参数构造 ImportSettingDGN 类的新实例。

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`void`	`dispose()` 释放该对象所占用的资源。
`SpatialIndexInfo`	`getSpatialIndex()` 返回空间索引信息。
`String`	`getStyleMappingTableFile()` 返回风格对照表的存储路径。
`boolean`	`isImportEmptyDataset()` 获取是否导入空的数据集
`boolean`	`isImportingAsCAD()` 返回导入模式，即导入的目标数据集类型。
`boolean`	`isImportingByLayer()` 返回在导入后的数据中是否合并源数据中的 CAD 图层信息，CAD 是以图层信息来存储的，默认为 false，即所有的图层信息都合并到了一个 CAD 数据集，否则对应源数据中的每一个图层生成一个 CAD 数据集。
`boolean`	`isImportingCellAsPoint()` 返回将 cell（单元）对象导入为点对象(cell header)还是除 cell header 外的所有要素对象。
`void`	`setImportEmptyDataset(boolean bImportEmptyDT)` 设置是否导入空的数据集，默认是不导入的
`void`	`setImportingAsCAD(boolean value)` 设置导入模式，即导入目标数据集类型。
`void`	`setImportingByLayer(boolean value)` 设置在导入后的数据中是否合并源数据中的 CAD 图层信息，CAD 是以图层信息来存储的，默认为 false，即所有的图层信息都合并到了一个 CAD 数据集，否则对应源数据中的每一个图层生成一个 CAD 数据集。
`void`	`setImportingCellAsPoint(boolean value)` 设置将 cell（单元）对象导入为点对象(cell header)还是除 cell header 外的所有要素对象。
`void`	`setSpatialIndex(SpatialIndexInfo value)` 设置空间索引信息。
`void`	`setStyleMappingTableFile(String path)` 设置风格对照表的存储路径。

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

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

- 构造器详细资料
  - ImportSettingDGN
```
public ImportSettingDGN()
```
    默认构造函数，构造一个新的ImportSettingDGN对象。
  - ImportSettingDGN
```
public ImportSettingDGN(ImportSettingDGN importSettingDGN)
```
    拷贝构造函数，根据给定的 ImportSettingDGN 对象构造一个与其完全相同的新对象。
    
    参数:
    
    importSettingDGN - 用于初始化 ImportSettingDGN 新实例的对象。
  - ImportSettingDGN
```
public ImportSettingDGN(String sourceFilePath,
                        DatasourceConnectionInfo targetConnectionInfo)
```
    根据指定的参数构造 ImportSettingDGN 类的新实例。
    
    参数:
    
    sourceFilePath - 指定被导入的 DGN 格式数据的源文件的路径。
    
    targetConnectionInfo - 指定导入的目标数据源连接信息对象。
  - ImportSettingDGN
```
public ImportSettingDGN(String sourceFilePath,
                        Datasource targetDatasource)
```
    根据指定的参数构造 ImportSettingDGN 类的新实例。
    
    参数:
    
    sourceFilePath - 指定被导入的 DGN 格式数据的源文件的路径。
    
    targetDatasource - 指定导入的目标数据源对象。
  - ImportSettingDGN
```
public ImportSettingDGN(String sourceFilePath,
                        Datasource targetDatasource,
                        boolean importingAsCAD)
```
    根据指定的参数构造 ImportSettingDGN 类的新实例。
    
    参数:
    
    sourceFilePath - 指定被导入的 DGN 格式数据的源文件的路径。
    
    targetDatasource - 指定导入的目标数据源对象。
    
    importingAsCAD - 是否以 CAD 格式导入。
  - ImportSettingDGN
```
public ImportSettingDGN(String sourceFilePath,
                        DatasourceConnectionInfo targetConnectionInfo,
                        boolean importingAsCAD)
```
    根据指定的参数构造 ImportSettingDGN 类的新实例。
    
    参数:
    
    sourceFilePath - 指定被导入的 DGN 格式数据的源文件的路径。
    
    targetConnectionInfo - 指定导入的目标数据源连接信息对象。
    
    importingAsCAD - 是否以 CAD 格式导入。
- 方法详细资料
  - isImportingAsCAD
```
public boolean isImportingAsCAD()
```
    返回导入模式，即导入的目标数据集类型。
    
    返回:
    
    一个布尔值，表示是否以 CAD 模式导入。true 表示导入为 CAD 数据集，false 表示导入为数据对应类型的简单矢量数据集。
    
    默认值:
    
    默认值为 true，表示导入为 CAD 数据集。
  - setImportingAsCAD
```
public void setImportingAsCAD(boolean value)
```
    设置导入模式，即导入目标数据集类型。
    
    参数:
    
    value - 导入模式，即目标数据集类型，默认为 true，即导入为 CAD 数据集, 否则为数据对应类型的简单矢量数据集。
  - isImportingCellAsPoint
```
public boolean isImportingCellAsPoint()
```
    返回将 cell（单元）对象导入为点对象(cell header)还是除 cell header 外的所有要素对象。默认为 false，即将原有的单元对象以除 cell header 外的所有要素对象的形式导入，否则在单元对象的位置用点对象代替。
    注意：如果导入参数 setImportingAsCAD设置为 false，则此参数设置无效。
    
    返回:
    
    一个布尔值，true 表示单元对象导入为点对象，false 表示单元对象导入为除 cell header 外的所有要素对象。
    
    默认值:
    
    默认值为 false，表示将单元对象以除 cell header 外的所有要素对象的形式导入。
  - setImportingCellAsPoint
```
public void setImportingCellAsPoint(boolean value)
```
    设置将 cell（单元）对象导入为点对象(cell header)还是除 cell header 外的所有要素对象。默认导入为除 cell header 外的所有要素对象。
    注意：如果导入参数 setImportingAsCAD设置为 false，则此参数设置无效。
    
    参数:
    
    value - 一个布尔值，true 表示单元对象导入为点对象，false 表示单元对象导入为除 cell header 外的所有要素对象。
  - getSpatialIndex
```
public SpatialIndexInfo getSpatialIndex()
```
    返回空间索引信息。
    
    返回:
    
    空间索引信息。
  - setSpatialIndex
```
public void setSpatialIndex(SpatialIndexInfo value)
```
    设置空间索引信息。
    
    参数:
    
    spatialIndexInfo - 空间索引信息。
  - isImportingByLayer
```
public boolean isImportingByLayer()
```
    返回在导入后的数据中是否合并源数据中的 CAD 图层信息，CAD 是以图层信息来存储的，默认为 false，即所有的图层信息都合并到了一个 CAD 数据集，否则对应源数据中的每一个图层生成一个 CAD 数据集。
    注意：如果导入参数 setImportingAsCAD设置为 false，以FME方式导入时此参数设置无效。
    
    返回:
    
    一个布尔值，在导入后的数据中合并源数据中的 CAD 图层信息返回 true，否则返回 false。
    
    默认值:
    
    默认值为 false。
  - setImportingByLayer
```
public void setImportingByLayer(boolean value)
```
    设置在导入后的数据中是否合并源数据中的 CAD 图层信息，CAD 是以图层信息来存储的，默认为 false，即所有的图层信息都合并到了一个 CAD 数据集，否则对应源数据中的每一个图层生成一个 CAD 数据集。
    注意：如果导入参数 setImportingAsCAD设置为 false，以FME方式导入时此参数设置无效。
    
    参数:
    
    value - 在导入后的数据中是否合并源数据中的 CAD 图层信息。
  - getStyleMappingTableFile
```
public String getStyleMappingTableFile()
```
    返回风格对照表的存储路径。
    风格对照表是指 SuperMap 系统与其它系统风格（包括：符号、线型、填充等）的对照文件。
    
    风格对照表只对 CAD 类型的数据，如 DXF、DWG、DGN 起作用。在设置风格对照表之前，必须保证数据是以CAD方式导入，且不忽略风格。
    
    返回:
    
    风格对照表的存储路径。
    
    默认值:
    
    默认风格对照表的存储路径为：安装路径/Bin/resource/stmi.stt。
  - setStyleMappingTableFile
```
public void setStyleMappingTableFile(String path)
```
    设置风格对照表的存储路径。
    风格对照表是指 SuperMap 系统与其它系统风格（包括：符号、线型、填充等）的对照文件。
    
    风格对照表只对 CAD 类型的数据，如 DXF、DWG、DGN 起作用。在设置风格对照表之前，必须保证数据是以CAD方式导入，且不忽略风格。
    
    参数:
    
    path - 风格对照表的存储路径。
  - dispose
```
public void dispose()
```
    释放该对象所占用的资源。当调用该方法之后，此对象不再可用。
  - setImportEmptyDataset
```
public void setImportEmptyDataset(boolean bImportEmptyDT)
```
    设置是否导入空的数据集，默认是不导入的
    
    参数:
    
    bImportEmptyDT - 是否导入空的数据集，true表示导入，false表示不导入
  - isImportEmptyDataset
```
public boolean isImportEmptyDataset()
```
    获取是否导入空的数据集
    
    返回:
    
    是否导入空的数据集

类 ImportSettingDGN

构造器概要

方法概要

从类继承的方法 com.supermap.data.conversion.ImportSetting

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

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

构造器详细资料

ImportSettingDGN

ImportSettingDGN

ImportSettingDGN

ImportSettingDGN

ImportSettingDGN

ImportSettingDGN

方法详细资料

isImportingAsCAD

setImportingAsCAD

isImportingCellAsPoint

setImportingCellAsPoint

getSpatialIndex

setSpatialIndex

isImportingByLayer

setImportingByLayer

getStyleMappingTableFile

setStyleMappingTableFile

dispose

setImportEmptyDataset

isImportEmptyDataset