Colors

java.lang.Object
- com.supermap.data.InternalHandle
- - com.supermap.data.InternalHandleDisposable
  - - com.supermap.data.Colors

```
public class Colors
extends InternalHandleDisposable
```
颜色集合类。

该类主要作用是提供颜色序列。提供各种渐变色和随机色的生成，以及 SuperMap 预定义渐变色的生成。

颜色集合类可用于各个专题图对象如：单值专题图、分段专题图、统计专题图、等级符号专题图、标签专题图、点密度专题图及各个空间对象（比如Geometry 类）中颜色属性的设置。

构造器概要

构造器
构造器和说明
`Colors()` 构造一个新的 Colors 对象。
`Colors(Color[] colors)` 根据指定的参数来构造一个 Colors 的新对象。
`Colors(Colors colors)` 根据给定的 Colors 对象构造一个与其完全相同的新对象。

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`int`	`add(Color color)` 将指定的颜色值对象添加到当前的颜色集合对象中，该对象将置于集合的末尾。
`int`	`addRange(Color[] colors)` 将颜色集合数组添加到当前颜色集合对象中。
`void`	`clear()` 删除所有的颜色元素。
`void`	`dispose()` 释放该对象所占用的资源。
`Color`	`get(int index)` 返回颜色集合中指定序号的颜色值。
`int`	`getCount()` 返回颜色集合中颜色的个数。
`boolean`	`insert(int index, Color color)` 在颜色集合中指定的位置插入指定的颜色对象。
`static Colors`	`makeGradient(int count, Color[] gradientColors)` 根据给定颜色的数量和控制颜色生成一组渐变色。
`static Colors`	`makeGradient(int count, ColorGradientType type, boolean reverse)` 此方法用于生成系统预定义渐变色。
`static Colors`	`makeRandom(int count)` 用于生成一定数量的随机颜色。
`Colors`	`makeRandom(int count, Color[] color)` 用于生成一定数量的随机颜色。
`boolean`	`remove(int index)` 从指定序号处开始移除颜色元素。
`void`	`set(int index, Color value)` 设置颜色集合中指定序号的颜色值。
`Color[]`	`toArray()` 将当前颜色集合对象转换为一个颜色对象数组。
`java.lang.String`	`toString()` 返回一个表示该颜色集合的字符串，格式为 {Count=}。

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造器详细资料
  - Colors
```
public Colors()
```
    构造一个新的 Colors 对象。
  - Colors
```
public Colors(Color[] colors)
```
    根据指定的参数来构造一个 Colors 的新对象。
    
    参数:
    
    colors - 指定的颜色列表。
  - Colors
```
public Colors(Colors colors)
```
    根据给定的 Colors 对象构造一个与其完全相同的新对象。
    
    参数:
    
    colors - 给定的 Colors 对象。
- 方法详细资料
  - get
```
public Color get(int index)
```
    返回颜色集合中指定序号的颜色值。
    
    参数:
    
    index - 指定的颜色值的序号（从0开始）。
    
    返回:
    
    颜色集合中指定序号的颜色值。
  - set
```
public void set(int index,
                Color value)
```
    设置颜色集合中指定序号的颜色值。
    
    参数:
    
    index - 指定的颜色值的序号（从0开始）。
    
    value - 颜色值。
  - getCount
```
public int getCount()
```
    返回颜色集合中颜色的个数。
    
    返回:
    
    颜色集合中颜色的个数。
    
    默认值:
    
    默认值为 0。
  - add
```
public int add(Color color)
```
    将指定的颜色值对象添加到当前的颜色集合对象中，该对象将置于集合的末尾。
    
    参数:
    
    color - 新增的颜色值对象。
    
    返回:
    
    新增的颜色元素在集合中的序号。
  - addRange
```
public int addRange(Color[] colors)
```
    将颜色集合数组添加到当前颜色集合对象中。
    
    参数:
    
    colors - 要添加到此颜色集合对象实例的颜色集合数组。
    
    返回:
    
    添加的个数。
  - insert
```
public boolean insert(int index,
                      Color color)
```
    在颜色集合中指定的位置插入指定的颜色对象。
    
    参数:
    
    index - 指定的插入位置在集合中的序号。
    
    color - 指定的待插入的颜色对象。
    
    返回:
    
    如果插入成功，返回 true，否则返回 false。
  - remove
```
public boolean remove(int index)
```
    从指定序号处开始移除颜色元素。
    
    参数:
    
    index - 指定的颜色集合的序号。
    
    返回:
    
    如果删除成功返回 true，否则返回 false。
    
    另请参阅:
    
    clear()
  - clear
```
public void clear()
```
    删除所有的颜色元素。
  - makeRandom
```
public static Colors makeRandom(int count)
```
    用于生成一定数量的随机颜色。
    
    参数:
    
    count - 要生成的随机颜色的数量。
    
    返回:
    
    一个随机颜色类型。
  - makeGradient
```
public static Colors makeGradient(int count,
                                  Color[] gradientColors)
```
    根据给定颜色的数量和控制颜色生成一组渐变色。
    
    参数:
    
    count - 用户给定的生成渐变色的颜色总数。其中用户可以设定不同颜色之间渐变的中间颜色的个数。
    
    gradientColors - 渐变颜色集。即生成渐变色的控制颜色。
    
    返回:
    
    一个随机颜色实例。
  - makeGradient
```
public static Colors makeGradient(int count,
                                  ColorGradientType type,
                                  boolean reverse)
```
    此方法用于生成系统预定义渐变色。
    
    参数:
    
    count - 要生成的渐变色的颜色总数。
    
    type - 渐变颜色的类型。
    
    reverse - 是否反向生成渐变色，即是否从终止色到起始色生成渐变色。
    
    返回:
    
    一个颜色集合类的渐变颜色对象。
    
    另请参阅:
    
    ColorGradientType
  - toArray
```
public Color[] toArray()
```
    将当前颜色集合对象转换为一个颜色对象数组。
    
    返回:
    
    当前颜色集合对象转换成的一个颜色对象数组。
  - toString
```
public java.lang.String toString()
```
    返回一个表示该颜色集合的字符串，格式为 {Count=}。
    
    覆盖:
    
    toString 在类中 java.lang.Object
    
    返回:
    
    一个表示该颜色集合类的字符串。
  - dispose
```
public void dispose()
```
    释放该对象所占用的资源。当调用该方法之后，此对象不再可用。
  - makeRandom
```
public Colors makeRandom(int count,
                         Color[] color)
```
    用于生成一定数量的随机颜色。
    
    参数:
    
    count - 间隔色个数。
    
    color - 控制色集合。
    
    返回:
    
    由间隔色个数和控制色集合生成的随机颜色表。

类 Colors

构造器概要

方法概要

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

构造器详细资料

Colors

Colors

Colors

方法详细资料

get

set

getCount

add

addRange

insert

remove

clear

makeRandom

makeGradient

makeGradient

toArray

toString

dispose

makeRandom