ColorStateList

public class ColorStateList
extends Object implements Parcelable

让您将 View状态集映射为颜色。

ColorStateList是从应用程序资源目录的“color”子目录中定义的XML资源文件创建的。 XML文件包含一个单独的“选择器”元素，其中包含多个“item”元素。 例如：

 <selector xmlns:android="http://schemas.android.com/apk/res/android">
   <item android:state_focused="true"
           android:color="@color/sample_focused" />
   <item android:state_pressed="true"
           android:state_enabled="false"
           android:color="@color/sample_disabled_pressed" />
   <item android:state_enabled="false"
           android:color="@color/sample_disabled_not_pressed" />
   <item android:color="@color/sample_default" />
 </selector>
 

State specs

每个项目定义一组状态规格和颜色对，其中状态规范是一系列设置为true或false的属性以表示包含或排除。 如果没有为某个项目指定属性，则可能是任何值。

例如，每当设置了关注状态时，下列项目都会匹配; 任何其他状态可能被设置或取消设置：

 <item android:state_focused="true"
         android:color="@color/sample_focused" />
 

通常，颜色状态列表将引用框架定义的状态属性，例如android:state_focused或android:state_enabled ; 但是，也可以使用应用程序定义的属性。

注意：状态规格列表将按照它们出现在XML文件中的顺序进行匹配。 出于这个原因，更具体的项目应该放在文件的早期位置。 没有状态规范的项目被认为与任何一组状态匹配，并且通常作为用作缺省的最终项目是有用的。

如果没有状态规格的物品放置在其他物品之前，这些物品将被忽略。

Item attributes

每个项目必须定义一个 android:color属性，该属性可以是HTML样式的十六进制颜色，对颜色资源的引用，或者 - 在API 23及更高版本中 - 可解析为颜色的主题属性。

从API 23开始，项目可以选择定义一个android:alpha属性来修改基本颜色的不透明度。 该属性采用介于0和1之间的浮点值或可以解析的主题属性。 项目的整体颜色是通过将基本颜色的Alpha通道乘以alpha值来计算的。 例如，以下项目表示50％不透明度下主题的重音颜色：

 <item android:state_enabled="false"
         android:color="?android:attr/colorAccent"
         android:alpha="0.5" />
 

Developer guide

有关更多信息，请参阅 Color State List Resource的指南。

摘要(Summary)

Inherited constants
From interface android.os.Parcelable int CONTENTS_FILE_DESCRIPTOR 与 describeContents()使用的描述符位：表示 describeContents()对象的展平表示包含文件描述符。 int PARCELABLE_WRITE_RETURN_VALUE 与 writeToParcel(Parcel, int)一起使用的 writeToParcel(Parcel, int) ：正在写入的对象是返回值，即“ Parcelable someFunction() ”，“ void someFunction(out Parcelable) ”或“ void someFunction(inout Parcelable) ”等函数的结果。

继承方法(Inherited methods)
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为该对象调用方法 notify()或 notifyAll()方法，或者某个其他线程中断当前线程，或者经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的方法 notify()或方法 notifyAll() 。
From interface android.os.Parcelable abstract int describeContents() 描述此Parcelable实例的封送表示中包含的特殊对象的种类。 abstract void writeToParcel(Parcel dest, int flags) 将此对象平铺到一个包裹中。

XML attributes

android:alpha

应用于基本颜色的Alpha倍数。

必须是浮点值，例如“ 1.2 ”。

这也可能是对包含此类型值的资源（形式为“ @[package:]type:name ”）或主题属性（形式为“ ?[package:][type:]name ”）的 ?[package:][type:]name 。

这对应于全局属性资源符号 alpha 。

android:color

此状态的基础颜色。

必须是“ #rgb ”，“ #argb ”，“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这也可能是对包含此类型值的资源（形式为“ @[package:]type:name ”）或主题属性（形式为“ ?[package:][type:]name ”）的 ?[package:][type:]name 。

这对应于全局属性资源符号 color 。

Fields

Creator<ColorStateList> CREATOR

Public constructors

ColorStateList (int[][] states, 
                int[] colors)

公共方法(Public methods)

ColorStateList createFromXml (Resources r, 
                XmlPullParser parser)

ColorStateList createFromXml (Resources r, 
                XmlPullParser parser, 
                Resources.Theme theme)

int describeContents ()

int getChangingConfigurations ()

int getColorForState (int[] stateSet, 
                int defaultColor)

int getDefaultColor ()

boolean isOpaque ()

boolean isStateful ()

String toString ()

ColorStateList valueOf (int color)

ColorStateList withAlpha (int alpha)

void writeToParcel (Parcel dest, 
                int flags)