com.supermap.mapping
类 ThemeGraduatedSymbol
- 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
-
-
-
-
构造器详细资料
-
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()
返回等级符号专题图分级模式。- 分级主要是为了减少制作等级符号专题图中数据大小之间的差异。如果数据之间差距较大,则可以采用对数或者平方根的分级方式来进行,这样就减少了数据之间的绝对大小的差异,使得等级符号的视觉效果比较好,同时不同类别之间的比较也还是有意义的;
- 有三种分级模式:常数、对数和平方根,对于有值为负数的字段,不可以采用对数和平方根的分级方式;
- 不同的分级模式用于确定符号大小的数值是不相同的,常数按照字段的原始数据进行,对数则是对每条记录对应的专题值取自然对数、平方根则是对其取平方根,用最终得到的结果来确定其等级符号的大小。
- 返回:
- 等级符号专题图分级模式。
- 默认值:
- 默认值为
GraduatedMode.CONSTANT
。
-
setGraduatedMode
public void setGraduatedMode(GraduatedMode value)
设置等级符号专题图分级模式。- 分级主要是为了减少制作等级符号专题图中数据大小之间的差异。如果数据之间差距较大,则可以采用对数或者平方根的分级方式来进行,这样就减少了数据之间的绝对大小的差异,使得等级符号的视觉效果比较好,同时不同类别之间的比较也还是有意义的;
- 有三种分级模式:常数、对数和平方根,对于有值为负数的字段,不可以采用对数和平方根的分级方式;
- 不同的分级模式用于确定符号大小的数值是不相同的,常数按照字段的原始数据进行,对数则是对每条记录对应的专题值取自然对数、平方根则是对其取平方根,用最终得到的结果来确定其等级符号的大小。
- 参数:
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
- 一个布尔值指定等级符号的偏移量是否固定。
-
dispose
public void dispose()
释放对象所占用的资源。调用该方法之后,此对象不再可用。
-
makeDefault
public static ThemeGraduatedSymbol makeDefault(DatasetVector dataset, String expression, GraduatedMode graduatedMode)
生成默认的等级符号专题图。- 参数:
dataset
- 矢量数据集。expression
- 字段表达式。graduatedMode
- 专题图分级模式类型。- 返回:
- 生成默认的等级符号专题图。
-
-
Copyright © 2021–2024 SuperMap. All rights reserved.