PrjCoordSys

java.lang.Object
- com.supermap.data.PrjCoordSys

```
public class PrjCoordSys
extends java.lang.Object
```
投影坐标系类。

投影坐标系统由地图投影方式、投影参数、坐标单位和地理坐标系组成。SuperMap iMobile for Android 中提供了很多预定义的投影系统，用户可以直接使用，此外，用户还可以定制自己投影系统。

投影坐标系是定义在二维平面上的，不同于地理坐标系用经纬度定位地面点，投影坐标系是用 X、Y 坐标来定位的。每一个投影坐标系都基于一个地理坐标系。

构造器概要

构造器
构造器和说明
`PrjCoordSys()` 构造一个新的 PrjCoordSys 对象。
`PrjCoordSys(GeoCoordSys geoCoordSys, Projection projection, PrjParameter prjParameter, java.lang.String name)` 根据指定的参数来构造一个 PrjCoordSys 的新对象。
`PrjCoordSys(PrjCoordSys prjCoordSys)` 根据给定的 PrjCoordSys 对象构造一个与其完全相同的新对象。
`PrjCoordSys(PrjCoordSysType type)` 根据指定的参数来构造一个 PrjCoordSys 的新对象。

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`PrjCoordSys`	`clone()` 对PrjCoordSys进行clone
`void`	`dispose()` 释放该对象所占用的资源。
`boolean`	`fromFile(java.lang.String filePath, PrjFileType type)` 根据 XML 文件与投影文件类型构建 `PrjCoordSys` 对象。
`boolean`	`fromXML(java.lang.String xml)` 据 XML 字符串构建 `PrjCoordSys` 对象，成功返回 true。
`Unit`	`getCoordUnit()` 返回投影系统坐标单位。
`Unit`	`getDistanceUnit()` 返回距离（长度）单位。
`GeoCoordSys`	`getGeoCoordSys()` 返回投影坐标系的地理坐标系统对象。
`java.lang.String`	`getName()` 返回投影坐标系对象的名称。
`PrjParameter`	`getPrjParameter()` 返回投影坐标系统对象的投影参数。
`Projection`	`getProjection()` 返回投影坐标系统的投影方式。
`PrjCoordSysType`	`getType()` 返回投影坐标系类型。
`boolean`	`isSame(PrjCoordSys prjCoordSys)` 左边是否相同
`void`	`setCoordUnit(Unit value)` 设置投影系统坐标单位。
`void`	`setDistanceUnit(Unit value)` 设置距离（长度）单位。
`void`	`setGeoCoordSys(GeoCoordSys value)` 设置投影坐标系的地理坐标系统对象。
`void`	`setName(java.lang.String value)` 设置投影坐标系对象的名称。
`void`	`setPrjParameter(PrjParameter value)` 设置投影坐标系统对象的投影参数。
`void`	`setProjection(Projection value)` 设置投影坐标系统的投影方式。
`void`	`setType(PrjCoordSysType value)` 设置投影坐标系类型。
`boolean`	`toFile(java.lang.String filePath, PrjFileVersion version)` 根据指定版本将 `PrjCoordSys` 对象导出到投影文件。
`java.lang.String`	`toXML()` 将投影坐标系类的对象转换为 XML 格式的字符串。

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

- 构造器详细资料
  - PrjCoordSys
```
public PrjCoordSys()
```
    构造一个新的 PrjCoordSys 对象。
  - PrjCoordSys
```
public PrjCoordSys(PrjCoordSysType type)
```
    根据指定的参数来构造一个 PrjCoordSys 的新对象。
    
    参数:
    
    type - 投影坐标系类型。
  - PrjCoordSys
```
public PrjCoordSys(GeoCoordSys geoCoordSys,
                   Projection projection,
                   PrjParameter prjParameter,
                   java.lang.String name)
```
    根据指定的参数来构造一个 PrjCoordSys 的新对象。
    
    参数:
    
    geoCoordSys - 投影坐标系所基于的地理坐标系。
    
    projection - 投影方式。投影方式如等角圆锥投影、等距方位投影等等。
    
    prjParameter - 投影参数。
    
    name - 投影坐标系名称。
  - PrjCoordSys
```
public PrjCoordSys(PrjCoordSys prjCoordSys)
```
    根据给定的 PrjCoordSys 对象构造一个与其完全相同的新对象。
    
    参数:
    
    prjCoordSys - 指定的 PrjCoordSys 对象。
- 方法详细资料
  - isSame
```
public boolean isSame(PrjCoordSys prjCoordSys)
```
    左边是否相同
    
    参数:
    
    prjCoordSys - 投影坐标系
    
    返回:
    
    boolean
  - getName
```
public java.lang.String getName()
```
    返回投影坐标系对象的名称。
    
    返回:
    
    投影坐标系对象的名称。
    
    默认值:
    
    默认值为 "User Define"。
  - setName
```
public void setName(java.lang.String value)
```
    设置投影坐标系对象的名称。该方法仅在坐标系类型为投影坐标系和地理坐标系时有效。
    
    参数:
    
    value - 投影坐标系对象的名称。
  - getType
```
public PrjCoordSysType getType()
```
    返回投影坐标系类型。
    当投影坐标系类型为自定义时，用户需另外指定地理坐标系、投影方法、坐标单位以及投影参数；其余的值为 SuperMap Object Java 系统预定义，用户不必指定其他参数。
    
    返回:
    
    投影坐标系类型。
    
    默认值:
    
    默认值为 PrjCoordSysType.PCS_USER_DEFINED。
  - setType
```
public void setType(PrjCoordSysType value)
```
    设置投影坐标系类型。
    当投影坐标系类型为自定义时，用户需另外指定地理坐标系、投影方法、坐标单位以及投影参数；其余的值为 SuperMap Object Java 系统预定义，用户不必指定其他参数。
    
    参数:
    
    value - 投影坐标系类型。
  - getGeoCoordSys
```
public GeoCoordSys getGeoCoordSys()
```
    返回投影坐标系的地理坐标系统对象。每个投影系都要依赖于一个地理坐标系。
    
    返回:
    
    投影坐标系的地理坐标系统对象。
    
    默认值:
    
    默认值为空的 GeoCoordSys 对象。
  - setGeoCoordSys
```
public void setGeoCoordSys(GeoCoordSys value)
```
    设置投影坐标系的地理坐标系统对象。每个投影系都要依赖于一个地理坐标系。该方法仅在坐标系类型为投影坐标系和地理坐标系时有效。
    
    参数:
    
    value - 投影坐标系的地理坐标系统对象。
  - getProjection
```
public Projection getProjection()
```
    返回投影坐标系统的投影方式。投影方式如等角圆锥投影、等距方位投影等等。
    
    返回:
    
    投影坐标系统的投影方式。
    
    默认值:
    
    默认值为空的 Projection 对象。
  - setProjection
```
public void setProjection(Projection value)
```
    设置投影坐标系统的投影方式。投影方式如等角圆锥投影、等距方位投影等等。该方法仅在坐标系类型为投影坐标系时有效。
    
    参数:
    
    value - 投影坐标系统的投影方式。
  - getPrjParameter
```
public PrjParameter getPrjParameter()
```
    返回投影坐标系统对象的投影参数。
    
    返回:
    
    投影坐标系统对象的投影参数。
    
    默认值:
    
    默认值为空的 PrjParameter。
  - setPrjParameter
```
public void setPrjParameter(PrjParameter value)
```
    设置投影坐标系统对象的投影参数。该方法仅在坐标系类型为投影坐标系时有效。
    
    参数:
    
    value - 投影坐标系统对象的投影参数。
  - getCoordUnit
```
public Unit getCoordUnit()
```
    返回投影系统坐标单位。
    投影系统的坐标单位与距离单位（DistanceUnits）可以不同，例如经纬度坐标下的坐标单位是度，距离单位可以是米、公里等；即使是普通平面坐标或者投影坐标，这两个单位同样可不同。
    
    返回:
    
    投影系统坐标单位。
    
    默认值:
    
    默认值为 METER。
  - setCoordUnit
```
public void setCoordUnit(Unit value)
```
    设置投影系统坐标单位。
    投影系统的坐标单位与距离单位（DistanceUnits）可以不同，例如经纬度坐标下的坐标单位是度，距离单位可以是米、公里等；即使是普通平面坐标或者投影坐标，这两个单位同样可不同。
    
    参数:
    
    value - 投影系统坐标单位。
  - getDistanceUnit
```
public Unit getDistanceUnit()
```
    返回距离（长度）单位。
    
    返回:
    
    距离（长度）单位。
    
    默认值:
    
    默认值为 METER。
  - setDistanceUnit
```
public void setDistanceUnit(Unit value)
```
    设置距离（长度）单位。该方法仅在坐标系类型为投影坐标系和地理坐标系时有效。
    
    参数:
    
    value - 距离（长度）单位。
  - fromXML
```
public boolean fromXML(java.lang.String xml)
```
    据 XML 字符串构建 PrjCoordSys 对象，成功返回 true。
    
    参数:
    
    xml - 指定的 XML 字符串。
    
    返回:
    
    如果构建成功返回 true，否则返回 false。
  - toXML
```
public java.lang.String toXML()
```
    将投影坐标系类的对象转换为 XML 格式的字符串。
    
    返回:
    
    表示投影坐标系类的对象的 XML 字符串。
  - fromFile
```
public boolean fromFile(java.lang.String filePath,
                        PrjFileType type)
```
    根据 XML 文件与投影文件类型构建 PrjCoordSys 对象。
    
    参数:
    
    filePath - XML 文件的全路径。
    
    type - 投影文件的类型。
    
    返回:
    
    构建成功返回 true，否则返回 false。
  - toFile
```
public boolean toFile(java.lang.String filePath,
                      PrjFileVersion version)
```
    根据指定版本将 PrjCoordSys 对象导出到投影文件。
    
    参数:
    
    filePath - XML 文件的全路径。
    
    version - 导出投影文件的版本。
    
    返回:
    
    导出成功返回 true，否则返回 false。
  - dispose
```
public void dispose()
```
    释放该对象所占用的资源。当调用该方法之后，此对象不再可用。
  - clone
```
public PrjCoordSys clone()
```
    对PrjCoordSys进行clone
    
    覆盖:
    
    clone 在类中 java.lang.Object
    
    返回:
    
    PrjCoordSys的clone对象

类 PrjCoordSys

构造器概要

方法概要

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

构造器详细资料

PrjCoordSys

PrjCoordSys

PrjCoordSys

PrjCoordSys

方法详细资料

isSame

getName

setName

getType

setType

getGeoCoordSys

setGeoCoordSys

getProjection

setProjection

getPrjParameter

setPrjParameter

getCoordUnit

setCoordUnit

getDistanceUnit

setDistanceUnit

fromXML

toXML

fromFile

toFile

dispose

clone