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()
        返回颜色集合中颜色的个数。
        返回:
        颜色集合中颜色的个数。
        Default:
        默认值为 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 - 控制色集合。
        返回:
        由间隔色个数和控制色集合生成的随机颜色表。