ThemeRange

java.lang.Object
- com.supermap.services.components.commontypes.Theme
- - com.supermap.services.components.commontypes.ThemeRange

所有已实现的接口:: java.io.Serializable

public class ThemeRange
extends Theme

分段专题图类。

按照提供的分段方法对字段的属性值进行分段，并根据每个属性值所在的分段范围赋予相应对象的显示风格。

在分段专题图中，专题值按照某种分段方式被分成多个范围段，要素根据各自的专题值被分配到其中一个范围段中，在同一个范围段中的要素使用相同的颜色，填充，符号等风格进行显示。分段专题图所基于的专题变量必须为数值型，分段专题图一般用来反映连续分布现象的数量或程度特征，如降水量的分布，土壤侵蚀强度的分布等。

下图为一幅2000年中国各省人均 GDP 情况的分段专题图：

下面的代码展示如何构建一个简单的范围分段专题图对象：

 // 构建范围分段专题图信息
 ThemeRange themeRange = new ThemeRange();
 // 以ID字段作为分段表达式
 themeRange.rangeExpression = "ID";
 // 根据ID值分为三段
 themeRange.rangeParameter = 3;
 // 分段模式
 themeRange.rangeMode = RangeMode.CUSTOMINTERVAL;
 // 设置子项，当前专题图中根据ID数值可以分为三段，分别显示为红绿蓝
 themeRange.items = new ThemeRangeItem[3];
 // 第一分段，对应ID从 0-100
 ThemeRangeItem item0 = new ThemeRangeItem();
 item0.caption = "item0";
 item0.start = 0;
 item0.end = 100;
 item0.visible = true;
 item0.style = new Style();
 item0.style.fillForeColor = new Color(255,0,0);
 // 第二分段，对应ID从 101-200
 ThemeRangeItem item1 = new ThemeRangeItem();
 item1.caption = "item1";
 item1.start = 100;
 item1.end = 200;
 item1.visible = true;
 item1.style = new Style();
 item1.style.fillForeColor = new Color(0,255,0);
 // 第三分段，对应ID从 201-300
 ThemeRangeItem item2 = new ThemeRangeItem();
 item2.caption = "item2";
 item2.start = 200;
 item2.end = 300;
 item2.visible = true;
 item2.style = new Style();
 item2.style.fillForeColor = new Color(0,0,255);
 themeRange.items[0] = item0;
 themeRange.items[1] = item1;
 themeRange.items[2] = item2;

另请参阅:: 序列化表格

字段概要

字段
限定符和类型	字段和说明
`ColorGradientType`	`colorGradientType` 颜色渐变模式。
`ThemeRangeItem[]`	`items` 分段专题图中分段专题图子项数组。
`double`	`precision` 设置范围分段专题图的舍入精度，默认值为0.1。
`java.lang.String`	`rangeExpression` 分段字段表达式。
`RangeMode`	`rangeMode` 分段专题图的分段模式。
`double`	`rangeParameter` 分段参数。

从类继承的字段 com.supermap.services.components.commontypes.Theme
memoryData, type

构造器概要

构造器
构造器和说明

ThemeRange()
默认构造函数。

ThemeRange(ThemeRange themeRange)
拷贝构造函数。

构造器
构造器和说明
`ThemeRange()` 默认构造函数。
`ThemeRange(ThemeRange themeRange)` 拷贝构造函数。

方法概要

方法
限定符和类型	方法和说明
`Theme`	`copy()` 复制分段专题图。
`boolean`	`equals(java.lang.Object obj)` 比较指定对象与当前 ThemeRange 对象是否相等。
`int`	`hashCode()` 生成哈希码。
`boolean`	`isHavingValidItems()` 成员变量 items，即分段专题图子项的构成是否合法。

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

- 字段详细资料
  - rangeMode
```
public RangeMode rangeMode
```
    分段专题图的分段模式。
    
    即按分段字段表达式（rangeExpression）的值划分范围段时采用的方法，包括等距离分段法，平方根分段法，标准差分段法，对数分段法，等计数分段法，以及自定义距离法。
  - rangeParameter
```
public double rangeParameter
```
    分段参数。
    
    当分段模式为等距离分段法，平方根分段，对数分段法，等计数分段法其中一种模式时，该参数为分段个数（注：当分段个数为 1 时无效）；当分段模式为标准差分段法的时候，该参数不起作用；当分段模式为自定义距离时，该参数表示自定义距离。
    
    默认值为 -1。
  - items
```
public ThemeRangeItem[] items
```
    分段专题图中分段专题图子项数组。
    
    分段专题图子项是按分段字段表达式（rangeExpression）的值划分的范围段，同一范围段的要素属于同一个分段专题图子项。
  - rangeExpression
```
public java.lang.String rangeExpression
```
    分段字段表达式。
    
    计算出专题值，用于划分分段专题图子项。分段专题图分段方法根据一定的距离进行分段，因而分段字段表达式的值必须为数值型。
  - colorGradientType
```
public ColorGradientType colorGradientType
```
    颜色渐变模式。
    
    颜色渐变是多种颜色间的逐渐混合，可以是从起始色到终止色两种颜色的渐变，或者在起始色到终止色之间具有多种中间颜色进行渐变。该颜色渐变类型可应用于专题图对象的颜色方案设置中，如：单值专题图、分段专题图、栅格分段专题图。
  - precision
```
public double precision
```
    设置范围分段专题图的舍入精度，默认值为0.1。
- 构造器详细资料
  - ThemeRange
```
public ThemeRange()
```
    默认构造函数。
  - ThemeRange
```
public ThemeRange(ThemeRange themeRange)
```
    拷贝构造函数。
    
    参数:
    
    themeRange - 分段专题图对象。
- 方法详细资料
  - equals
```
public boolean equals(java.lang.Object obj)
```
    比较指定对象与当前 ThemeRange 对象是否相等。
    
    覆盖:
    
    equals 在类中 Theme
    
    参数:
    
    obj - 与当前 ThemeRange 对象进行比较的对象。
    
    返回:
    
    如果两个对象相同，返回 true；否则返回 false。
  - isHavingValidItems
```
public boolean isHavingValidItems()
```
    成员变量 items，即分段专题图子项的构成是否合法。
    
    合法的要求：
    
    1、成员变量 items 必须不为 null，且长度大于 0；
    
    2、items 中每个 item 对象的成员变量不为 null；
    
    3、每个 item 对象的成员变量 end 的值必须大于成员变量 start 的值；
    
    4、当 items 长度大于1的时候，每个 item 的成员变量 start 的值必须等于上一个 item 的成员变量 end 的值。
    
    如不满足以上要求，则 items 构成非法，服务器上会出现分段专题图设置失败的异常信息并将此记录日志。
    
    返回:
    
    返回 true，表示 items 的构成合法；返回 false，表示 items 的构成非法。
  - hashCode
```
public int hashCode()
```
    生成哈希码。
    
    覆盖:
    
    hashCode 在类中 Theme
    
    返回:
    
    哈希码。
  - copy
```
public Theme copy()
```
    复制分段专题图。
    
    指定者:
    
    copy 在类中 Theme
    
    返回:
    
    复制后的分段专题图。

类 ThemeRange

字段概要

从类继承的字段 com.supermap.services.components.commontypes.Theme

构造器概要

方法概要

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

字段详细资料

rangeMode

rangeParameter

items

rangeExpression

colorGradientType

precision

构造器详细资料

ThemeRange

ThemeRange

方法详细资料

equals

isHavingValidItems

hashCode

copy