com.supermap.mapping
类 ThemeGridUnique

java.lang.Object
  继承者 com.supermap.mapping.Theme
      继承者 com.supermap.mapping.ThemeGridUnique

public class ThemeGridUnique
extends Theme

栅格单值专题图类。

栅格单值专题图,是将单元格值相同的归为一类,为每一类设定一种颜色,从而用来区分不同的类别。栅格单值专题图适用于离散栅格数据和部分连续栅格数据,对于单元格值各不相同的那些连续栅格数据,使用栅格单值专题图不具有任何意义。


构造方法摘要
ThemeGridUnique()
          默认构造函数,构造一个新的 ThemeGridUnique 对象。
ThemeGridUnique(ThemeGridUnique themeGridUnique)
          拷贝构造函数,根据给定的 ThemeGridUnique 对象构造一个与其完全相同的新对象。
 
方法摘要
 int add(ThemeGridUniqueItem item)
          添加一个栅格单值专题图子项到栅格单值专题图子项列表中。
 void clear()
          删除所有栅格单值专题图子项。
 void dispose()
          释放该对象所占用的资源,当调用该方法之后,此对象不再可用。
 int getCount()
          返回栅格单值专题图子项个数。
 java.awt.Color getDefaultColor()
          返回栅格单值专题图的默认颜色,对于那些未在栅格单值专题图子项之列的对象使用该颜色显示。
 ThemeGridUniqueItem getItem(int index)
          返回指定序号的栅格单值专题图子项。
 int GetSpecialValue()
          已过时。 该方法已过时。 返回栅格单值专题图层的特殊值。

在新增一个栅格图层时,该方法的返回值与数据集的 NoValue 属性值相等。

 java.awt.Color getSpecialValueColor()
          返回栅格单值专题图层特殊值的颜色。
 int indexOf(double unique)
          返回栅格单值专题图中指定子项单值在当前序列中的序号。
 boolean insert(int index, ThemeGridUniqueItem item)
          将给定的栅格单值专题图子项插入到指定序号的位置。
 boolean isSpecialValueTransparent()
          返回栅格单值专题图层的特殊值所处区域是否透明。
static ThemeGridUnique makeDefault(DatasetGrid dataset)
          根据给定的栅格数据集生成默认的栅格单值专题图。
static ThemeGridUnique makeDefault(DatasetGrid dataset, ColorGradientType colorGradientType)
          根据给定的栅格数据集和颜色渐变模式生成默认的栅格单值专题图。
 boolean remove(int index)
          删除一个指定序号的栅格单值专题图子项。
 void reverseColor()
          对栅格单值专题图中子项的颜色进行反序显示。
 void setDefaultColor(java.awt.Color color)
          设置栅格单值专题图的默认颜色,对于那些未在栅格单值专题图子项之列的对象使用该颜色显示。
 void setSpecialValue(int value)
          已过时。 该方法已过时。 设置栅格单值专题图层的特殊值。
 void setSpecialValueColor(java.awt.Color value)
          设置栅格单值专题图层特殊值的颜色。
 void setSpecialValueTransparent(boolean bSpecialValueTransparent)
          设置栅格单值专题图层的特殊值所处区域是否透明。
 java.lang.String toString()
          输出专题图格式化字符串。
 
从类 com.supermap.mapping.Theme 继承的方法
fromXML, getMemoryData, getType, setMemoryData, toXML
 
从类 java.lang.Object 继承的方法
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

ThemeGridUnique

public ThemeGridUnique()
默认构造函数,构造一个新的 ThemeGridUnique 对象。


ThemeGridUnique

public ThemeGridUnique(ThemeGridUnique themeGridUnique)
拷贝构造函数,根据给定的 ThemeGridUnique 对象构造一个与其完全相同的新对象。

参数:
themeGridUnique - 给定的栅格单值专题图对象。
方法详细信息

getItem

public ThemeGridUniqueItem getItem(int index)
返回指定序号的栅格单值专题图子项。

参数:
index - 指定的栅格单值专题图子项的序号。
返回:
指定序号的栅格单值专题图子项。

getCount

public int getCount()
返回栅格单值专题图子项个数。

返回:
栅格单值专题图子项个数。
默认值:
默认值为 0。

getDefaultColor

public java.awt.Color getDefaultColor()
返回栅格单值专题图的默认颜色,对于那些未在栅格单值专题图子项之列的对象使用该颜色显示。如未设置,则使用图层默认的颜色显示。

返回:
栅格单值专题图的默认颜色。
默认值:
默认值为 Color.black。

setDefaultColor

public void setDefaultColor(java.awt.Color color)
设置栅格单值专题图的默认颜色,对于那些未在栅格单值专题图子项之列的对象使用该颜色显示。如未设置,则使用图层默认的颜色显示。

参数:
color - 栅格单值专题图的默认颜色。

add

public int add(ThemeGridUniqueItem item)
添加一个栅格单值专题图子项到栅格单值专题图子项列表中。

参数:
item - 添加的栅格单值专题图子项。
返回:
如果添加成功返回栅格单值专题图子项在子项序列中的序号,否则返回 -1。

insert

public boolean insert(int index,
                      ThemeGridUniqueItem item)
将给定的栅格单值专题图子项插入到指定序号的位置。

参数:
index - 指定的栅格单值专题图子项序列的序号。
item - 插入的栅格单值专题图子项。
返回:
如果插入成功返回 true,否则返回 false。

remove

public boolean remove(int index)
删除一个指定序号的栅格单值专题图子项。

参数:
index - 指定的将被删除的栅格单值专题图子项序列的序号。
返回:
如果删除成功,返回 true;否则返回 false。

clear

public void clear()
删除所有栅格单值专题图子项。执行该方法后,所有的栅格单值专题图子项都被释放,不再可用。


makeDefault

public static ThemeGridUnique makeDefault(DatasetGrid dataset,
                                          ColorGradientType colorGradientType)
根据给定的栅格数据集和颜色渐变模式生成默认的栅格单值专题图。

只支持对栅格值为整型的栅格数据集制作单值专题图,对于栅格值为浮点型的栅格数据集不能制作栅格单值专题图。

参数:
dataset - 给定的栅格数据集。
colorGradientType - 颜色渐变模式。
返回:
根据参数构造得到一个新的栅格单值专题图类的对象实例。

makeDefault

public static ThemeGridUnique makeDefault(DatasetGrid dataset)
根据给定的栅格数据集生成默认的栅格单值专题图。

只支持对栅格值为整型的栅格数据集制作单值专题图,对于栅格值为浮点型的栅格数据集不能制作栅格单值专题图。

参数:
dataset - 给定的栅格数据集。
返回:
根据参数构造得到一个新的栅格单值专题图类的对象实例。

indexOf

public int indexOf(double unique)
返回栅格单值专题图中指定子项单值在当前序列中的序号。

参数:
unique - 给定的栅格单值专题图子项的单值。
返回:
栅格专题图子项在序列中的序号值。如果该值不存在,就返回 -1。

reverseColor

public void reverseColor()
对栅格单值专题图中子项的颜色进行反序显示。


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
返回:
专题图的格式化字符串。

isSpecialValueTransparent

public boolean isSpecialValueTransparent()
返回栅格单值专题图层的特殊值所处区域是否透明。

返回:
一个布尔值,指示栅格单值专题图层的特殊值所处区域是否透明;true表示透明;false表示不透明。
默认值:
默认值为 false。

setSpecialValueTransparent

public void setSpecialValueTransparent(boolean bSpecialValueTransparent)
设置栅格单值专题图层的特殊值所处区域是否透明。

参数:
bSpecialValueTransparent - 一个布尔值,指示栅格单值专题图层的特殊值所处区域是否透明;true表示透明;false表示不透明。

GetSpecialValue

public int GetSpecialValue()
已过时。 该方法已过时。 返回栅格单值专题图层的特殊值。

在新增一个栅格图层时,该方法的返回值与数据集的 NoValue 属性值相等。

返回:
栅格单值专题图层的特殊值。

setSpecialValue

public void setSpecialValue(int value)
已过时。 该方法已过时。 设置栅格单值专题图层的特殊值。

参数:
value - 栅格单值专题图层的特殊值。

getSpecialValueColor

public java.awt.Color getSpecialValueColor()
返回栅格单值专题图层特殊值的颜色。

返回:
栅格单值专题图层特殊值的颜色。
默认值:
默认值为 Color.black。

setSpecialValueColor

public void setSpecialValueColor(java.awt.Color value)
设置栅格单值专题图层特殊值的颜色。

参数:
value - 栅格单值专题图层特殊值的颜色。