com.supermap.mapping
类 ThemeGraduatedSymbol

java.lang.Object
  com.supermap.mapping.Theme
      com.supermap.mapping.ThemeGraduatedSymbol

public class ThemeGraduatedSymbol
extends Theme

等级符号专题图类。

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

构造方法摘要

ThemeGraduatedSymbol()
默认构造函数，构造一个新的 ThemeGraduatedSymbol 对象。

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

方法摘要

void	dispose() 释放对象所占用的资源。
double	getBaseValue() 返回等级符号专题图的基准值，单位同专题变量的单位。
java.lang.String	getExpression() 返回用于创建等级符号专题图的字段或字段表达式。
GraduatedMode	getGraduatedMode() 返回等级符号专题图分级模式。
GeoStyle	getLeaderLineStyle() 返回等级符号及其相应对象之间的牵引线的风格。
GeoStyle	getNegativeStyle() 返回负值的等级符号风格。
java.lang.String	getOffsetX() 返回等级符号 X 坐标方向（横向）偏移量。
java.lang.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, java.lang.String expression, GraduatedMode graduatedMode) 生成默认的等级符号专题图。
void	setBaseValue(double value) 设置等级符号专题图的基准值，单位同专题变量的单位。
void	setExpression(java.lang.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(java.lang.String value) 设置等级符号 X 坐标方向（横向）偏移量。
void	setOffsetY(java.lang.String value) 设置等级符号 Y 坐标方向（纵向）的偏移量。
void	setPositiveStyle(GeoStyle style) 设置正值的等级符号风格。
void	setZeroDisplayed(boolean value) 设置是否显示0值的等级符号风格，true 表示显示。
void	setZeroStyle(GeoStyle style) 设置 0 值的等级符号风格。
java.lang.String	toString() 输出专题图格式化字符串。

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

fromXML, getMemoryData, getType, setMemoryData, toXML

从类 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 java.lang.String getExpression()

返回用于创建等级符号专题图的字段或字段表达式。

用于制作等级符号专题图的字段或者字段表达式应为数值型字段。

返回：

用于创建等级符号专题图的字段或字段表达式。

默认值:

默认值为一个空的字符串。

setExpression

public void setExpression(java.lang.String value)

设置用于创建等级符号专题图的字段或字段表达式。

用于制作等级符号专题图的字段或者字段表达式应为数值型字段。

参数：

value - 用于创建等级符号专题图的字段或字段表达式。

getGraduatedMode

public GraduatedMode getGraduatedMode()

返回等级符号专题图分级模式。

1. 分级主要是为了减少制作等级符号专题图中数据大小之间的差异。如果数据之间差距较大，则可以采用对数或者平方根的分级方式来进行，这样就减少了数据之间的绝对大小的差异，使得等级符号的视觉效果比较好，同时不同类别之间的比较也还是有意义的；
2. 有三种分级模式：常数、对数和平方根，对于有值为负数的字段，不可以采用对数和平方根的分级方式；
3. 不同的分级模式用于确定符号大小的数值是不相同的，常数按照字段的原始数据进行，对数则是对每条记录对应的专题值取自然对数、平方根则是对其取平方根，用最终得到的结果来确定其等级符号的大小。

返回：

等级符号专题图分级模式。

默认值:

默认值为 GraduatedMode.CONSTANT。

setGraduatedMode

public void setGraduatedMode(GraduatedMode value)

设置等级符号专题图分级模式。

1. 分级主要是为了减少制作等级符号专题图中数据大小之间的差异。如果数据之间差距较大，则可以采用对数或者平方根的分级方式来进行，这样就减少了数据之间的绝对大小的差异，使得等级符号的视觉效果比较好，同时不同类别之间的比较也还是有意义的；
2. 有三种分级模式：常数、对数和平方根，对于有值为负数的字段，不可以采用对数和平方根的分级方式；
3. 不同的分级模式用于确定符号大小的数值是不相同的，常数按照字段的原始数据进行，对数则是对每条记录对应的专题值取自然对数、平方根则是对其取平方根，用最终得到的结果来确定其等级符号的大小。

参数：

value - 等级符号专题图分级模式。

getOffsetX

public java.lang.String getOffsetX()

返回等级符号 X 坐标方向（横向）偏移量。使用地图单位。

返回：

等级符号 X 坐标方向（横向）偏移量。

默认值:

默认值为一个空的字符串。

setOffsetX

public void setOffsetX(java.lang.String value)

设置等级符号 X 坐标方向（横向）偏移量。使用地图单位。

参数：

value - 等级符号 X 坐标方向（横向）偏移量。

getOffsetY

public java.lang.String getOffsetY()

返回等级符号 Y 坐标方向（纵向）的偏移量。使用地图单位。

返回：

等级符号 Y 坐标方向（纵向）的偏移量。

默认值:

默认值为一个空的字符串。

setOffsetY

public void setOffsetY(java.lang.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 - 等级符号专题图的基准值。

isOffsetFixed

public boolean isOffsetFixed()

返回等级符号的偏移量是否固定。

返回：

一个布尔值，等级符号的偏移量固定返回 true，否则返回 false。

默认值:

默认值为 false。

setOffsetFixed

public void setOffsetFixed(boolean value)

设置等级符号的偏移量是否固定。

参数：

value - 一个布尔值指定等级符号的偏移量是否固定。

dispose

public void dispose()

释放对象所占用的资源。调用该方法之后，此对象不再可用。

toString

public java.lang.String toString()

从类 Theme 复制的描述

输出专题图格式化字符串。格式化字符串提供专题图的相关设置信息，与 XML 字符串不同的是，格式化字符串不可导入显示专题图，只用于提供专题图的相关信息。

1. 对于栅格分段专题图，其格式为{Caption=”china”, Start=10 End=20, Visible=true?false, Style={linestyle=,markerstyle=,fillstyle=} }；
2. 对于栅格单值专题图，其格式为{Caption=”china”, Unique =20, Visible=true?false, Style={linestyle=,markerstyle=,fillstyle=} }；
3. 对于标签专题图，其格式为{Caption=”China”, Start=10 End=20, Visible=true, Style={name=,width=,height=,color=()} }；
4. 对于分段专题图，其格式为{Caption=”china”, Start=10 End=20, Visible=true?false, Style={linestyle=,markerstyle=,fillstyle=}；
5. 对于单值专题图，其格式为{Caption=”china”, Unique =20, Visible=true?false, Style={linestyle=,markerstyle=,fillstyle=} }。

指定者：

类 Theme 中的 toString

返回：

专题图的格式化字符串。

makeDefault

public static ThemeGraduatedSymbol makeDefault(DatasetVector dataset,
                                               java.lang.String expression,
                                               GraduatedMode graduatedMode)

生成默认的等级符号专题图。

参数：

dataset - 矢量数据集。

expression - 字段表达式。

graduatedMode - 专题图分级模式类型。

返回：

生成默认的等级符号专题图。