public class ThemeUnique extends Theme
单值专题图类。
是将专题值相同的要素归为一类,为每一类设定一种渲染风格,如颜色或符号等,专题值相同的要素采用相同的渲染风格,从而区分不同的类别。 例如,在表示土地的面数据中表示土地利用类型的字段中有草地,林地,居民地,耕地等值,使用单值专题图进行渲染时,每种类型的土地利用类型被赋予一种颜色或填充风格,从而可以看出每种类型的土地利用的分布区域和范围。可用于地质图、地貌图、植被图、土地利用图、政治行政区划图、自然区划图、经济区划图等。
单值专题图着重表示现象质的差别,一般不表示数量的特征。尤其是有交叉或重叠现象时,此类不推荐使用,例如:民族分布区等。
下图为山东省行政区划单值专题图,下图中每一种颜色代表一个行政区:
下面的代码展示如何构建一个简单的单值专题图对象:
// 构建单值专题图信息 ThemeUnique themeUnique = new ThemeUnique(); // 设置单值表达式为对应矢量数据集的ID字段 themeUnique.uniqueExpression = "ID"; // 指定单值专题图子项显示风格 // 如果不指定子项显示风格,则使用默认的风格 themeUnique.items = new ThemeUniqueItem[2]; // 设置ID字段值为1对应的地物显示为红色 ThemeUniqueItem item1 = new ThemeUniqueItem(); item1.caption = "item1"; item1.style = new Style(); item1.style.fillForeColor = new Color(255, 0,0); item1.unique = "1"; item1.visible = true; // 设置ID字段值为2对应的地物显示为绿色 ThemeUniqueItem item2 = new ThemeUniqueItem(); item2.caption = "item2"; item2.style = new Style(); item2.style.fillForeColor = new Color(0, 255,0); item2.unique = "2"; item2.visible = true; themeUnique.items[0] = item1; themeUnique.items[1] = item2;
限定符和类型 | 字段和说明 |
---|---|
ColorGradientType |
colorGradientType
颜色渐变模式。
|
java.lang.String |
customMarkerAngleExpression
字段表达式 该字段表达式用于控制对象对应的点单值题图中点符号的旋转角度,字段表达式中的字段必须为数值型字段。
|
java.lang.String |
customMarkerSizeExpression
字段表达式 该字段表达式用于控制对象对应的点单值题图中点符号的大小,字段表达式中的字段必须为数值型字段。
|
Style |
defaultStyle
单值专题图的默认风格。
|
ThemeUniqueItem[] |
items
单值专题图子项数组。
|
java.lang.String |
uniqueExpression
单值专题图字段表达式。
|
memoryData, type
构造器和说明 |
---|
ThemeUnique()
默认构造函数。
|
ThemeUnique(ThemeUnique themeUnique)
拷贝构造函数。
|
限定符和类型 | 方法和说明 |
---|---|
Theme |
copy()
复制单值专题图。
|
boolean |
equals(java.lang.Object obj)
比较指定对象与当前 ThemeUnique 对象是否相等。
|
int |
hashCode()
生成哈希码。
|
boolean |
isHavingValidItems()
判断成员变量 items,即单值专题图子项数组的构成是否合法。
|
public ThemeUniqueItem[] items
单值专题图子项数组。
在单值专题图中,将字段表达式值相同的要素归为一类,为每一类设定一种渲染风格,所以其中每一类就是一个专题图子项。
比如,利用单值专题图制作行政区划图,Name字段代表省/直辖市名,该字段用来做专题变量,如果该字段的字段值总共有5种不同值,则该行政区划图有5个专题图子项,其中每一个子项内的要素Name字段值都相同。
public java.lang.String uniqueExpression
单值专题图字段表达式。
用于制作单值专题图的字段或字段表达式,字段表达式值相等的要素归为一个专题图子项。其中,字段可以为要素的某一属性(如地质图中的年代或成份),其值的数据类型可以为数值型或字符型。
public java.lang.String customMarkerAngleExpression
字段表达式
该字段表达式用于控制对象对应的点单值题图中点符号的旋转角度,字段表达式中的字段必须为数值型字段。
public java.lang.String customMarkerSizeExpression
字段表达式
该字段表达式用于控制对象对应的点单值题图中点符号的大小,字段表达式中的字段必须为数值型字段。
public Style defaultStyle
单值专题图的默认风格。
单值专题图子项数组 (items
)可能未包含所有的要素, 对于那些没有包含的要素,即不参加单值专题表达的要素,使用该风格显示。
public ColorGradientType colorGradientType
颜色渐变模式。
public ThemeUnique()
默认构造函数。
public ThemeUnique(ThemeUnique themeUnique)
拷贝构造函数。
themeUnique
- 单值专题图对象。public boolean equals(java.lang.Object obj)
比较指定对象与当前 ThemeUnique 对象是否相等。
public boolean isHavingValidItems()
判断成员变量 items,即单值专题图子项数组的构成是否合法。
合法的要求:
1、成员变量 items 必须不为 null,且长度大于 0;
2、items 中每个 item 对象不为 null,并且 item 的成员变量 unique 的值在 items 中必须唯一,不能重复。
如不满足以上要求,则 items 构成非法,服务器上会出现单值专题图设置失败的异常信息并将此记录日志。