颜色状态列表资源

ColorStateList 是一个您可以在 XML 中定义的对象，您可以将其作为颜色来应用，但它实际上会更改颜色，具体取决于其应用到的 View 对象的状态。例如，Button 微件可以处于多种不同状态中的一种（按下、聚焦或既不按下也不聚焦），而使用颜色状态列表，您可以为每种状态提供不同的颜色。

您可以在 XML 文件中描述状态列表。每种颜色都在单个  元素内的  元素中定义。每个  使用不同的属性描述其应在什么状态下使用。

在每次状态更改期间，系统将从上到下遍历状态列表，并且将使用与当前状态匹配的第一项。系统的选择并非基于“最佳匹配”，而仅仅是基于符合状态的最低标准的第一项。

注意：如果要提供静态颜色资源，请使用简单的颜色值。

文件位置：

res/color/filename.xml
该文件名将用作资源 ID。

编译后的资源数据类型：

指向 ColorStateList 的资源指针。

资源引用：

在 Java 中：R.color.filename
在 XML 中：@[package:]color/filename

语法：

 

元素：

必需。该元素必须是根元素。包含一个或多个  元素。

属性：

xmlns:android

字符串。必需。定义 XML 命名空间，该命名空间必须为 "http://schemas.android.com/apk/res/android"。

定义在某些状态下使用的颜色，状态通过其属性来描述。必须是  元素的子元素。

属性：

android:color

十六进制颜色。必需。颜色通过 RGB 值和可选的 Alpha 通道指定。

该值始终以井号 (#) 字符开头，后跟以下某种格式的“透明度、红、绿、蓝”(Alpha-Red-Green-Blue) 信息：

• #RGB
• #ARGB
• #RRGGBB
• #AARRGGBB

android:state_pressed

布尔值。如果此项应在按下对象时（例如轻触/点按了按钮时）使用，则为“true”；如果此项应在默认的非按下状态下使用，则为“false”。

android:state_focused

布尔值。如果此项应在聚焦对象时（例如使用轨迹球/方向键突出显示按钮时）使用，则为“true”；如果此项应在默认的非聚焦状态下使用，则为“false”。

android:state_selected

布尔值。如果此项应在选择对象时（例如打开标签页时）使用，则为“true”；如果此项应在未选择对象时使用，则为“false”。

android:state_checkable

布尔值。如果此项应在对象可勾选时使用，则为“true”；如果此项应在对象不可勾选时使用，则为“false”。（仅适用于对象可在可勾选和不可勾选的微件之间转换的情况。）

android:state_checked

布尔值。如果此项应在勾选对象时使用，则为“true”；如果应在取消勾选对象时使用，则为“false”。

android:state_enabled

布尔值。如果此项应在启用对象（能够接收轻触/点按事件）时使用，则为“true”；如果应在停用对象时使用，则为“false”。

android:state_window_focused

布尔值。如果此项应在应用窗口具有焦点（应用位于前台）时使用，则为“true”；如果此项应在应用窗口没有焦点时（例如通知栏下拉或出现一个对话框时）使用，则为“false”。

注意：请注意，系统将应用状态列表中与对象的当前状态匹配的第一项。因此，如果列表中的第一项不包含上述任何状态属性，则每次都会应用该项，因此默认值应始终为最后一项，如以下示例所示。

示例：

保存于 res/color/button_text.xml 的 XML 文件：
 

此布局 XML 会将颜色列表应用到 View：

 

另请参阅：