构造器详细资料

• Theme3DRange

  public Theme3DRange()

  构造一个新的 Theme3DRange 对象。

• Theme3DRange

  public Theme3DRange(Theme3DRange themeRange3D)

  根据给定的 Theme3DRange 对象构造一个与其完全相同的新对象。

  参数:

  themeRange3D - 给定的 Theme3DRange 对象。

方法详细资料

• get

  public Theme3DRangeItem get(int index)

  返回指定序号的三维分段专题图中三维分段专题图子项。有关三维分段专题图子项详细信息，请参见 Theme3DRangeItem 类。

  参数:

  index - 指定的三维分段专题图序号。

  返回:

  指定序号的三维分段专题图中三维分段专题图子项。

  另请参阅:

  Theme3DRangeItem

• getCount

  public int getCount()

  返回三维分段专题图中分段的个数。

  返回:

  三维分段专题图中分段的个数。

  默认值:

  默认值为 0。

• getRangeExpression

  public String getRangeExpression()

  返回三维分段字段表达式。

  通过对比某要素三维分段字段表达式的值与（按照一定的分段模式确定的）各分段范围的分段值，来确定该要素所在的范围段，从而对落在不同分段内的要素设置为不同的风格。

  返回:

  三维分段字段表达式。

  默认值:

  默认值为一个空的字符串。

• setRangeExpression

  public void setRangeExpression(String value)

  设置三维分段字段表达式。

  通过对比某要素三维分段字段表达式的值与（按照一定的分段模式确定的）各分段范围的分段值，来确定该要素所在的范围段，从而对落在不同分段内的要素设置为不同的风格。

  参数:

  value - 指定三维分段字段表达式。

• addToHead

  public boolean addToHead(Theme3DRangeItem item)

  把一个三维分段专题图子项添加到分段列表的开头。

  参数:

  item - 需要添加的三维分段专题图子项。

  返回:

  如果添加成功返回 true，否则返回 false。

  示范代码:

  请参见 Theme3DRangeItem 类的示例。

• addToTail

  public boolean addToTail(Theme3DRangeItem item)

  把一个三维分段专题图子项添加到分段列表的尾部。

  参数:

  item - 需要添加的三维分段专题图子项。

  返回:

  如果添加成功返回 true，否则返回 false。

• split

  public boolean split(int index,
                       double splitValue,
                       GeoStyle3D style1,
                       String caption1,
                       GeoStyle3D style2,
                       String caption2)

  根据给定的拆分分段值将一个指定序号的三维分段专题图子项拆分成两个具有各自风格和名称的三维分段专题图子项。注：splitValue 必须在拆分的范围之内。即大于三维分段专题图子项的起始值(Start)并且小于三维分段专题图子项的终止值（End），如果不满足上述条件，则抛出异常。

  参数:

  index - 指定的分段专题图子项的序号。

  splitValue - 指定的拆分分段值。

  style1 - 被拆分的两个分段专题图子项中的一个分段专题图子项的名称。

  caption1 - 被拆分的两个分段专题图子项中的一个分段专题图子项的名称。

  style2 - 被拆分的两个分段专题图子项中的另一个分段专题图子项的风格。

  caption2 - 被拆分的两个分段专题图子项中的另一个分段专题图子项的名称。

  返回:

  如果拆分成功返回 true，否则返回 false。

• merge

  public boolean merge(int index,
                       int count,
                       GeoStyle3D style,
                       String caption)

  合并一个从指定序号起始的给定个数的分段专题图子项，并赋给合并后分段专题图子项显示风格和名称。执行该方法后，被合并的对象将被释放，不再可用。

  参数:

  index - 指定的分段专题图子项的序号，并以此序号为起始。

  count - 要合并的分段专题图子项个数，即从指定的序号开始计算。

  style - 合并后的分段专题图子项的风格。

  caption - 合并后的分段专题图子项名称。

  返回:

  如果合并成功返回 true，否则返回 false。

• clear

  public void clear()

  删除分段专题图的所有分段子项。执行该方法后，所有的分段专题图子项都被释放，不再可用。

• makeDefault

  public static Theme3DRange makeDefault(DatasetVector dataset,
                                         String rangeExpression,
                                         RangeMode3D rangeMode,
                                         double rangeParameter)

  根据给定的矢量数据集、分段字段表达式、分段模式和相应的分段参数生成默认的分段专题图。

  参数:

  dataset - 矢量数据集。

  rangeExpression - 分段字段表达式。

  rangeMode - 分段模式。包括等距离分段法，平方根分段法，标准差分段法，对数分段法，等计数分段法，以及自定义距离法。

  rangeParameter - 分段参数。当分段模式为等距离分段法，平方根分段，对数分段法，等计数分段法其中一种模式时，该参数为分段个数；当分段模式为标准差分段法的时候，该参数不起作用；当分段模式为自定义距离时，该参数表示自定义距离。

  返回:

  根据参数构造得到一个新的 Theme3DRange 的对象实例。

• makeDefault

  public static Theme3DRange makeDefault(DatasetVector dataset,
                                         String rangeExpression,
                                         RangeMode3D rangeMode,
                                         double rangeParameter,
                                         ColorGradientType colorGradientType)

  根据给定的矢量数据集、分段字段表达式、分段模式、相应的分段参数和颜色渐变模式生成默认的分段专题图。

  参数:

  dataset - 矢量数据集。

  rangeExpression - 分段字段表达式。

  rangeMode - 分段模式。包括等距离分段法，平方根分段法，标准差分段法，对数分段法，等计数分段法，以及自定义距离法。

  rangeParameter - 分段参数。当分段模式为等距离分段法，平方根分段，对数分段法，等计数分段法其中一种时，该参数为分段个数；当分段模式为标准差分段法的时候，该参数不起作用；当分段模式为自定义距离时，该参数表示自定义距离。

  colorGradientType - 颜色渐变模式。

  返回:

  根据参数构造得到一个新的 Theme3DRange 的对象实例。

• makeDefault

  public static Theme3DRange makeDefault(DatasetVector dataset,
                                         String rangeExpression,
                                         RangeMode3D rangeMode,
                                         double rangeParameter,
                                         ColorGradientType colorGradientType,
                                         JoinItems joinItems)

  根据给定的矢量数据集、分段字段表达式、分段模式、相应的分段参数、颜色渐变填充模式和外部连接表项生成默认的分段专题图。

  注意：通过连接外部表的方式制作专题图时，对于 UDB 数据源，连接类型不支持内连接，即 JoinType 类不支持 INNERJOIN。

  参数:

  dataset - 矢量数据集。

  rangeExpression - 分段字段表达式。

  rangeMode - 分段模式。包括等距离分段法，平方根分段法，标准差分段法，对数分段法，等计数分段法，以及自定义距离法。

  rangeParameter - 分段参数。当分段模式为等距离分段法，平方根分段，对数分段法，等计数分段法其中一种时，该参数为分段个数；当分段模式为标准差分段法的时候，该参数不起作用；当分段模式为自定义距离时，该参数表示自定义距离。

  colorGradientType - 颜色渐变模式。

  joinItems - 外部表连接项。

  返回:

  根据参数构造得到一个新的 Theme3DRange 的对象实例。

• indexOf

  public int indexOf(double value)

  返回分段专题图中指定分段字段值在当前分段序列中的序号。

  参数:

  value - 给定的分段字段值。

  返回:

  分段字段值在分段序列中的序号。如果该值不存在，就返回-1。

• reverseStyle

  public void reverseStyle()

  对分段专题图中分段的风格进行反序显示。比如，专题图有三个分段，分别为 item1，item2，item3，调用反序显示后，item3 的风格与 item1 会调换，item2 的显示风格不变。

• fromXML

  public boolean fromXML(String xml)

  从XML字符串中导入专题图信息

  覆盖:

  fromXML 在类中 Theme3D

  参数:

  xml -

  返回:

  boolean

• toString

  public String toString()

  从类复制的说明: Theme3D
  输出三维专题图格式化字符串。

  格式化字符串提供三维专题图的相关设置信息，与 XML 字符串不同的是，格式化字符串不可导入显示三维专题图，只用于提供三维专题图的相关信息。

  指定者:

  toString 在类中 Theme3D

  返回:

  三维专题图的格式化字符串。

• dispose

  public void dispose()

  释放对象所占用的资源。调用该方法之后，此对象不再可用。

• getRangeMode

  public RangeMode3D getRangeMode()

  返回当前的三维分段模式。

  返回:

  当前的三维分段模式。