com.supermap.mapping

类 ThemeGraduatedSymbol

  • 所有已实现的接口:
    IDisposable


    public class ThemeGraduatedSymbol
    extends Theme

    等级符号专题图类。

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

    • 构造器详细资料

      • ThemeGraduatedSymbol

        public 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 - 专题图分级模式类型。
        返回:
        生成默认的等级符号专题图。

Copyright © 2021–2024 SuperMap. All rights reserved.