ColorStateList资源

ColorStateList对象可以在XML中定义，像color一样使用，它能根据它应用到的View对象的状态实时改变颜色。例如，Button可以存在多种状态（pressed、focused或other），如果使用ColorStateList，你就能为它的每个状态提供不同的颜色。

 

你可以在XML文件中描述状态列表。每种颜色定义在一个<item>元素里，<item>放在单个<selector>元素里。每个<item>使用不同的特性来描述在何种状态下使用。

 

当每次状态改变时，StateList都会从上到下遍历一次，第一个匹配当前状态的item将被使用——选择的过程不是基于“最佳匹配”，只是符合state的最低标准的第一个item。

注意：如果你想提供一个静态的color资源，使用简单的Color值。

 

File Location：res/color/filename.xml（文件名将作为资源ID）

Compiled Resource Datatype：指向ColorStateList的资源指针

Resouce Reference：R.color.filename(Java)、@[package:]color/filename(XML)

Syntax：

    <?xml version="1.0" encoding="utf-8"?>

    <selector xmlns:android="http://schemas.android.com/apk/res/android" >

        <item

            android:color="hex_color"

            android:state_pressed=["true" | "false"]

            android:state_focused=["true" | "false"]

            android:state_selected=["true" | "false"]

            android:state_active=["true" | "false"]

            android:state_checkable=["true" | "false"]

            android:state_checked=["true" | "false"]

            android:state_enabled=["true" | "false"]

            android:state_window_focused=["true" | "false"] />

    </selector>

 

Elements：

<selector>

必须。必须是根元素。包含一个或多个<item>元素。

              Attributes：

                  xmlns:android

                            String，必须。定义XML的命名空间，必须是

                            “http://schemas.android.com/apk/res/android”.

    <item>

              定义特定状态的color，通过它的特性指定。必须是<selector>的子元素。

              Attributes：

                  android:color

                            16进制颜色。必须。这个颜色由RGB值指定，可带Alpha。

                            这个值必须以“#”开头，后面跟随Alpha-Red-Green-Blue信息：

l   #RGB

l   #ARGB

l   #RRGGBB

l   #AARRGGBB

    android:state_pressed

Boolean。“true”表示按下状态使用（例如按钮按下）；“false”表示非按下状态使用。

                  android:state_focused

Boolean。“true”表示聚焦状态使用（例如使用滚动球/D-pad聚焦Button）；“false”表示非聚焦状态使用。

                  android:state_selected

Boolean。“true”表示选中状态使用（例如Tab打开）；“false”表示非选中状态使用。

                  android:state_checkable

Boolean。“true”表示可勾选状态时使用；“false”表示非可勾选状态使用。（只对能切换可勾选—非可勾选的构件有用。）

                  android:state_checked

                            Boolean。“true”表示勾选状态使用；“false”表示非勾选状态使用。

                  android:state_enabled

Boolean。“true”表示可用状态使用（能接收触摸/点击事件）；“false”表示不可用状态使用。

                  android:window_focused

Boolean。“true”表示应用程序窗口有焦点时使用（应用程序在前台）；“false”表示无焦点时使用（例如Notification栏拉下或对话框显示）。

注意：记住一点，StateList中第一个匹配当前状态的item会被使用。因此，如果第一个item没有任何状态特性的话，那么它将每次都被使用，这也是为什么默认的值必须总是在最后（如下面的例子所示）。

 

Examples：

XML文件保存在res/color/button_text.xml

<?xml version="1.0" encoding="utf-8"?>

<selector xmlns:android="http://schemas.android.com/apk/res/android">

    <item android:state_pressed="true"

          android:color="#ffff0000"/> <!-- pressed -->

    <item android:state_focused="true"

          android:color="#ff0000ff"/> <!-- focused -->

    <item android:color="#ff000000"/> <!-- default -->

</selector>

 

    这个Layout XML会应用ColorStateList到一个View上：

<Button

    android:layout_width="fill_parent"

    android:layout_height="wrap_content"

    android:text="@string/button_text"

    android:textColor="@color/button_text" />