ThemeGraduatedSymbol (iObjects Java Help)

java.lang.Object
- com.supermap.data.InternalHandle
- - com.supermap.data.InternalHandleDisposable
  - - com.supermap.mapping.Theme
    - - com.supermap.mapping.ThemeGraduatedSymbol

所有已实现的接口:

IDisposable
```
public class ThemeGraduatedSymbol
extends Theme
```
等级符号专题图类。

SuperMap iObjects Java 的等级符号专题图是采用不同的形状、颜色和大小的符号，表示各自独立的、以整体概念显示的各个物体的数量与质量特征。通常以符号的形状、颜色和大小反映物体的特定属性；符号的形状与颜色表示质量特征，符号的大小表示数量特征。

构造器概要

构造器
构造器和说明
`ThemeGraduatedSymbol()` 默认构造函数，构造一个新的 `ThemeGraduatedSymbol` 对象。
`ThemeGraduatedSymbol(ThemeGraduatedSymbol themeGraduatedSymbol)` 拷贝构造函数，根据给定的 `ThemeGraduatedSymbol` 对象构造一个与其完全相同的新对象。

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`void`	`dispose()` 释放对象所占用的资源。
`boolean`	`fromXML(String xml)` 从 XML 字符串中导入专题图信息。
`double`	`getBaseValue()` 返回等级符号专题图的基准值，单位同专题变量的单位。
`String`	`getExpression()` 返回用于创建等级符号专题图的字段或字段表达式。
`GraduatedMode`	`getGraduatedMode()` 返回等级符号专题图分级模式。
`GeoStyle`	`getLeaderLineStyle()` 返回等级符号及其相应对象之间的牵引线的风格。
`GeoStyle`	`getNegativeStyle()` 返回负值的等级符号风格。
`String`	`getOffsetX()` 返回等级符号 X 坐标方向（横向）偏移量。
`String`	`getOffsetY()` 返回等级符号 Y 坐标方向（纵向）的偏移量。
`GeoStyle`	`getPositiveStyle()` 返回正值的等级符号风格。
`GeoStyle`	`getZeroStyle()` 返回 0 值的等级符号风格。
`boolean`	`isFlowEnabled()` 返回等级符号是否流动显示。
`boolean`	`isLeaderLineDisplayed()` 返回是否显示等级符号及其相应对象之间的牵引线。
`boolean`	`isNegativeDisplayed()` 返回是否显示负值的等级符号风格，true 表示显示。
`boolean`	`isOffsetFixed()` 返回等级符号的偏移量是否固定。
`boolean`	`isZeroDisplayed()` 返回是否显示0值的等级符号风格，true 表示显示。
`static ThemeGraduatedSymbol`	`makeDefault(DatasetVector dataset, String expression, GraduatedMode graduatedMode)` 生成默认的等级符号专题图。
`void`	`setBaseValue(double value)` 设置等级符号专题图的基准值，单位同专题变量的单位。
`void`	`setExpression(String value)` 设置用于创建等级符号专题图的字段或字段表达式。
`void`	`setFlowEnabled(boolean value)` 设置等级符号是否流动显示。
`void`	`setGraduatedMode(GraduatedMode value)` 设置等级符号专题图分级模式。
`void`	`setLeaderLineDisplayed(boolean value)` 设置是否显示等级符号及其相应对象之间的牵引线。
`void`	`setLeaderLineStyle(GeoStyle style)` 设置等级符号及其相应对象之间的牵引线的风格。
`void`	`setNegativeDisplayed(boolean value)` 设置是否显示负值的等级符号风格，true 表示显示。
`void`	`setNegativeStyle(GeoStyle style)` 设置负值的等级符号风格。
`void`	`setOffsetFixed(boolean value)` 设置等级符号的偏移量是否固定。
`void`	`setOffsetX(String value)` 设置等级符号 X 坐标方向（横向）偏移量。
`void`	`setOffsetY(String value)` 设置等级符号 Y 坐标方向（纵向）的偏移量。
`void`	`setPositiveStyle(GeoStyle style)` 设置正值的等级符号风格。
`void`	`setZeroDisplayed(boolean value)` 设置是否显示0值的等级符号风格，true 表示显示。
`void`	`setZeroStyle(GeoStyle style)` 设置 0 值的等级符号风格。
`String`	`toString()` 序列化对象为字符串

从类继承的方法 com.supermap.mapping.Theme
getMemoryData, getThemeWeight, getType, setMemoryData, setThemeWeight, toXML

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

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

- 构造器详细资料
  - ThemeGraduatedSymbol
```
public ThemeGraduatedSymbol()
```
    默认构造函数，构造一个新的 ThemeGraduatedSymbol 对象。
  - ThemeGraduatedSymbol
```
public ThemeGraduatedSymbol(ThemeGraduatedSymbol themeGraduatedSymbol)
```
    拷贝构造函数，根据给定的 ThemeGraduatedSymbol 对象构造一个与其完全相同的新对象。
    
    参数:
    
    themeGraduatedSymbol - 指定的 ThemeGraduatedSymbol 对象。
- 方法详细资料
  - getExpression
```
public String getExpression()
```
    返回用于创建等级符号专题图的字段或字段表达式。
    用于制作等级符号专题图的字段或者字段表达式应为数值型字段。
    
    返回:
    
    用于创建等级符号专题图的字段或字段表达式。
    
    默认值:
    
    默认值为一个空的字符串。
  - setExpression
```
public void setExpression(String value)
```
    设置用于创建等级符号专题图的字段或字段表达式。
    用于制作等级符号专题图的字段或者字段表达式应为数值型字段。
    
    参数:
    
    value - 用于创建等级符号专题图的字段或字段表达式。
  - getGraduatedMode
```
public GraduatedMode getGraduatedMode()
```
    返回等级符号专题图分级模式。
    1. 分级主要是为了减少制作等级符号专题图中数据大小之间的差异。如果数据之间差距较大，则可以采用对数或者平方根的分级方式来进行，这样就减少了数据之间的绝对大小的差异，使得等级符号的视觉效果比较好，同时不同类别之间的比较也还是有意义的；
    2. 有三种分级模式：常数、对数和平方根，对于有值为负数的字段，不可以采用对数和平方根的分级方式；
    3. 不同的分级模式用于确定符号大小的数值是不相同的，常数按照字段的原始数据进行，对数则是对每条记录对应的专题值取自然对数、平方根则是对其取平方根，用最终得到的结果来确定其等级符号的大小。
    返回:
    
    等级符号专题图分级模式。
    
    默认值:
    
    默认值为 GraduatedMode.CONSTANT。
  - setGraduatedMode
```
public void setGraduatedMode(GraduatedMode value)
```
    设置等级符号专题图分级模式。
    1. 分级主要是为了减少制作等级符号专题图中数据大小之间的差异。如果数据之间差距较大，则可以采用对数或者平方根的分级方式来进行，这样就减少了数据之间的绝对大小的差异，使得等级符号的视觉效果比较好，同时不同类别之间的比较也还是有意义的；
    2. 有三种分级模式：常数、对数和平方根，对于有值为负数的字段，不可以采用对数和平方根的分级方式；
    3. 不同的分级模式用于确定符号大小的数值是不相同的，常数按照字段的原始数据进行，对数则是对每条记录对应的专题值取自然对数、平方根则是对其取平方根，用最终得到的结果来确定其等级符号的大小。
    参数:
    
    value - 等级符号专题图分级模式。
  - getOffsetX
```
public String getOffsetX()
```
    返回等级符号 X 坐标方向（横向）偏移量。使用地图单位。
    
    返回:
    
    等级符号 X 坐标方向（横向）偏移量。
    
    默认值:
    
    默认值为一个空的字符串。
  - setOffsetX
```
public void setOffsetX(String value)
```
    设置等级符号 X 坐标方向（横向）偏移量。使用地图单位。
    
    参数:
    
    value - 等级符号 X 坐标方向（横向）偏移量。
  - getOffsetY
```
public String getOffsetY()
```
    返回等级符号 Y 坐标方向（纵向）的偏移量。使用地图单位。
    
    返回:
    
    等级符号 Y 坐标方向（纵向）的偏移量。
    
    默认值:
    
    默认值为一个空的字符串。
  - setOffsetY
```
public void setOffsetY(String value)
```
    设置等级符号 Y 坐标方向（纵向）的偏移量。使用地图单位。
    
    参数:
    
    value - 等级符号 Y 坐标方向（纵向）的偏移量。
  - getLeaderLineStyle
```
public GeoStyle getLeaderLineStyle()
```
    返回等级符号及其相应对象之间的牵引线的风格。
    
    返回:
    
    等级符号及其相应对象之间的牵引线的风格。
    
    默认值:
    
    默认值为 {FillBackColor=Color [A=255, R=255, G=255, B=255],FillForeColor=Color [A=255, R=189, G=235, B=255],FillGradientAngle=0,FillGradientMode=None,FillGradientOffsetRatioX=0,FillGradientOffsetRatioY=0,FillOpaqueRate=100,FillSymbolID=0,LineColor=Color [A=255, R=0, G=0, B=0],LineSymbolID=39,LineWidth=0.1,MarkerAngle=0,MarkerSize={Width=2.4,Height=-1},MarkerSymbolID=0}
  - setLeaderLineStyle
```
public void setLeaderLineStyle(GeoStyle style)
```
    设置等级符号及其相应对象之间的牵引线的风格。
    
    参数:
    
    style - 等级符号及其相应对象之间的牵引线的风格。
  - isLeaderLineDisplayed
```
public boolean isLeaderLineDisplayed()
```
    返回是否显示等级符号及其相应对象之间的牵引线。
    
    返回:
    
    一个布尔值指定是否显示牵引线。
    
    默认值:
    
    默认值为 false。
  - setLeaderLineDisplayed
```
public void setLeaderLineDisplayed(boolean value)
```
    设置是否显示等级符号及其相应对象之间的牵引线。
    
    参数:
    
    value - 一个布尔值指定是否显示牵引线。
  - isFlowEnabled
```
public boolean isFlowEnabled()
```
    返回等级符号是否流动显示。
    
    返回:
    
    一个布尔值指定等级符号是否流动显示。
    
    默认值:
    
    默认值为 true，即等级符号流动显示。
  - setFlowEnabled
```
public void setFlowEnabled(boolean value)
```
    设置等级符号是否流动显示。
    
    参数:
    
    value - 一个布尔值指定等级符号是否流动显示。
  - getNegativeStyle
```
public GeoStyle getNegativeStyle()
```
    返回负值的等级符号风格。
    
    返回:
    
    负值的等级符号风格。
    
    默认值:
    
    默认值为 {FillBackColor=Color [A=255, R=255, G=255, B=255],FillForeColor=Color [A=255, R=189, G=235, B=255],FillGradientAngle=0,FillGradientMode=None,FillGradientOffsetRatioX=0,FillGradientOffsetRatioY=0,FillOpaqueRate=100,FillSymbolID=0,LineColor=Color [A=255, R=0, G=0, B=0],LineSymbolID=0,LineWidth=0.1,MarkerAngle=0,MarkerSize={Width=2.4,Height=-1},MarkerSymbolID=0}
  - setNegativeStyle
```
public void setNegativeStyle(GeoStyle style)
```
    设置负值的等级符号风格。
    
    参数:
    
    style - 负值的等级符号风格。
  - isNegativeDisplayed
```
public boolean isNegativeDisplayed()
```
    返回是否显示负值的等级符号风格，true 表示显示。
    
    返回:
    
    一个布尔值指定是否显示负值的等级符号风格。
    
    默认值:
    
    默认值为 false。
  - setNegativeDisplayed
```
public void setNegativeDisplayed(boolean value)
```
    设置是否显示负值的等级符号风格，true 表示显示。
    
    参数:
    
    value - 一个布尔值指定是否显示负值的等级符号风格。
  - getZeroStyle
```
public GeoStyle getZeroStyle()
```
    返回 0 值的等级符号风格。
    
    返回:
    
    0 值的等级符号风格。
    
    默认值:
    
    默认值为 {FillBackColor=Color [A=255, R=255, G=255, B=255],FillForeColor=Color [A=255, R=189, G=235, B=255],FillGradientAngle=0,FillGradientMode=None,FillGradientOffsetRatioX=0,FillGradientOffsetRatioY=0,FillOpaqueRate=100,FillSymbolID=0,LineColor=Color [A=255, R=0, G=0, B=0],LineSymbolID=0,LineWidth=0.1,MarkerAngle=0,MarkerSize={Width=2.4,Height=-1},MarkerSymbolID=0}
  - setZeroStyle
```
public void setZeroStyle(GeoStyle style)
```
    设置 0 值的等级符号风格。
    
    参数:
    
    style - 0 值的等级符号风格。
  - isZeroDisplayed
```
public boolean isZeroDisplayed()
```
    返回是否显示0值的等级符号风格，true 表示显示。
    
    返回:
    
    一个布尔值指定是否显示 0 值的等级符号风格。
    
    默认值:
    
    默认值为 false。
  - setZeroDisplayed
```
public void setZeroDisplayed(boolean value)
```
    设置是否显示0值的等级符号风格，true 表示显示。
    
    参数:
    
    value - 一个布尔值指定是否显示 0 值的等级符号风格。
  - getPositiveStyle
```
public GeoStyle getPositiveStyle()
```
    返回正值的等级符号风格。
    
    返回:
    
    正值的等级符号风格。
    
    默认值:
    
    默认值为 {FillBackColor=Color [A=255, R=255, G=255, B=255],FillForeColor=Color [A=255, R=255, G=0, B=0],FillGradientAngle=0,FillGradientMode=None,FillGradientOffsetRatioX=0,FillGradientOffsetRatioY=0,FillOpaqueRate=100,FillSymbolID=0,LineColor=Color [A=255, R=255, G=0, B=0],LineSymbolID=0,LineWidth=0.1,MarkerAngle=0,MarkerSize={Width=30,Height=-1},MarkerSymbolID=0}
  - setPositiveStyle
```
public void setPositiveStyle(GeoStyle style)
```
    设置正值的等级符号风格。
    
    参数:
    
    style - 正值的等级符号风格。
  - getBaseValue
```
public double getBaseValue()
```
    返回等级符号专题图的基准值，单位同专题变量的单位。每个符号的显示大小 = getPositiveStyle()(getZeroStyle() 或 getNegativeStyle()).getMarkerSize() * value / getBasevalue()，其中，value 指的是经过分级计算后的专题值，即按照用户选择的分级模式（对应 setGraduatedMode() 方法设置的模式）对专题值进行计算后得到的值。
    
    返回:
    
    等级符号专题图的基准值。
    
    默认值:
    
    默认值为 0。
  - setBaseValue
```
public void setBaseValue(double value)
```
    设置等级符号专题图的基准值，单位同专题变量的单位。每个符号的显示大小 = getPositiveStyle()(getZeroStyle() 或 getNegativeStyle()).getMarkerSize() * value / getBasevalue()，其中，value 指的是经过分级计算后的专题值，即按照用户选择的分级模式（对应 setGraduatedMode() 方法设置的模式）对专题值进行计算后得到的值。
    
    参数:
    
    value - 等级符号专题图的基准值。
  - fromXML
```
public boolean fromXML(String xml)
```
    从 XML 字符串中导入专题图信息。
    在 SuperMap 中，各种专题图的风格的设置都可以导出成 XML 格式的字符串，此 XML 格式的字符串中记录了关于这种专题图的所有设置，如对于标签专题图的 XML 格式字符串会记录专题图类型，可见比例尺，标签风格的设置，是否流动显示，是否自动避让等等对该标签专题图的所有风格的设置以及用来制作标签专题图的字段或表达式。这种 XML 格式字符串可以用来导入，对专题图进行设置。
    
    覆盖:
    
    fromXML 在类中 Theme
    
    参数:
    
    xml - 包含专题图信息的 XML 字符串。
    
    返回:
    
    一个布尔值，导入成功返回 true，否则返回 false。
    
    抛出:
    
    IllegalArgumentException - 参数非法
  - isOffsetFixed
```
public boolean isOffsetFixed()
```
    返回等级符号的偏移量是否固定。
    
    返回:
    
    一个布尔值，等级符号的偏移量固定返回 true，否则返回 false。
    
    默认值:
    
    默认值为 false。
  - setOffsetFixed
```
public void setOffsetFixed(boolean value)
```
    设置等级符号的偏移量是否固定。
    
    参数:
    
    value - 一个布尔值指定等级符号的偏移量是否固定。
  - toString
```
public String toString()
```
    序列化对象为字符串
    
    指定者:
    
    toString 在类中 Theme
    
    返回:
    
    专题图的格式化字符串。
  - dispose
```
public void dispose()
```
    释放对象所占用的资源。调用该方法之后，此对象不再可用。
  - makeDefault
```
public static ThemeGraduatedSymbol makeDefault(DatasetVector dataset,
                                               String expression,
                                               GraduatedMode graduatedMode)
```
    生成默认的等级符号专题图。
    
    参数:
    
    dataset - 矢量数据集。
    
    expression - 字段表达式。
    
    graduatedMode - 专题图分级模式类型。
    
    返回:
    
    生成默认的等级符号专题图。

类 ThemeGraduatedSymbol

构造器概要

方法概要

从类继承的方法 com.supermap.mapping.Theme

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

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

构造器详细资料

ThemeGraduatedSymbol

ThemeGraduatedSymbol

方法详细资料

getExpression

setExpression

getGraduatedMode

setGraduatedMode

getOffsetX

setOffsetX

getOffsetY

setOffsetY

getLeaderLineStyle

setLeaderLineStyle

isLeaderLineDisplayed

setLeaderLineDisplayed

isFlowEnabled

setFlowEnabled

getNegativeStyle

setNegativeStyle

isNegativeDisplayed

setNegativeDisplayed

getZeroStyle

setZeroStyle

isZeroDisplayed

setZeroDisplayed

getPositiveStyle

setPositiveStyle

getBaseValue

setBaseValue

fromXML

isOffsetFixed

setOffsetFixed

toString

dispose

makeDefault