# ColorStateList Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) # ColorStateList *** ** * ** *** Kotlin\|[Java](https://developer.android.com/reference/android/content/res/ColorStateList "View this page in Java") ``` open class ColorStateList : Parcelable ``` |---|--------------------------------------------------------------------------------------------------------------------------| | [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html) || | ↳ | [android.content.res.ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#) | Lets you map[android.view.View](https://developer.android.com/reference/kotlin/android/view/View.html#)state sets to colors. [android.content.res.ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#)s are created from XML resource files defined in the "color" subdirectory directory of an application's resource directory. The XML file contains a single "selector" element with a number of "item" elements inside. For example: ```kotlin ``` This defines a set of state spec / color pairs where each state spec specifies a set of states that a view must either be in or not be in and the color specifies the color associated with that spec. ### State specs Each item defines a set of state spec and color pairs, where the state spec is a series of attributes set to either`true`or`false`to represent inclusion or exclusion. If an attribute is not specified for an item, it may be any value. For example, the following item will be matched whenever the focused state is set; any other states may be set or unset: ```kotlin ``` Typically, a color state list will reference framework-defined state attributes such as[android:state_focused](https://developer.android.com/reference/kotlin/android/R.attr.html#state_focused:kotlin.Int)or[android:state_enabled](https://developer.android.com/reference/kotlin/android/R.attr.html#state_enabled:kotlin.Int); however, app-defined attributes may also be used. **Note:**The list of state specs will be matched against in the order that they appear in the XML file. For this reason, more-specific items should be placed earlier in the file. An item with no state spec is considered to match any set of states and is generally useful as a final item to be used as a default. If an item with no state spec is placed before other items, those items will be ignored. ### Item attributes Each item must define an[android:color](https://developer.android.com/reference/kotlin/android/R.attr.html#color:kotlin.Int)attribute, which may be an HTML-style hex color, a reference to a color resource, or -- in API 23 and above -- a theme attribute that resolves to a color. Starting with API 23, items may optionally define an[android:alpha](https://developer.android.com/reference/kotlin/android/R.attr.html#alpha:kotlin.Int)attribute to modify the base color's opacity. This attribute takes a either floating-point value between 0 and 1 or a theme attribute that resolves as such. The item's overall color is calculated by multiplying by the base color's alpha channel by the`alpha`value. For example, the following item represents the theme's accent color at 50% opacity: ```kotlin ``` Starting with API 31, items may optionally define an[android:lStar](https://developer.android.com/reference/kotlin/android/R.attr.html#lStar:kotlin.Int)attribute to modify the base color's perceptual luminance. This attribute takes either a floating-point value between 0 and 100 or a theme attribute that resolves as such. The item's overall color is calculated by converting the base color to an accessibility friendly color space and setting its L\* to the value specified on the`lStar`attribute. For example, the following item represents the theme's accent color at 50% perceptual luminance: ```kotlin ``` ### Developer guide For more information, see the guide to[Color State List Resource](https://developer.android.com/guide/topics/resources/color-list-resource.html). ## Summary | XML attributes || |--------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------| | [`android:alpha`](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#attr_ColorStateList) | Alpha multiplier applied to the base color. | | [`android:color`](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#attr_ColorStateList) | Base color for this state. | | [`android:lStar`](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#attr_ColorStateList) | Perceptual luminance applied to the base color. | | Inherited constants || |---|---| | From class[Parcelable](https://developer.android.com/reference/kotlin/android/os/Parcelable.html#) |----------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [CONTENTS_FILE_DESCRIPTOR](https://developer.android.com/reference/kotlin/android/os/Parcelable.html#CONTENTS_FILE_DESCRIPTOR:kotlin.Int)
Descriptor bit used with[describeContents()](https://developer.android.com/reference/kotlin/android/os/Parcelable.html#describeContents()): indicates that the Parcelable object's flattened representation includes a file descriptor.
| | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [PARCELABLE_WRITE_RETURN_VALUE](https://developer.android.com/reference/kotlin/android/os/Parcelable.html#PARCELABLE_WRITE_RETURN_VALUE:kotlin.Int)
Flag for use with[writeToParcel](https://developer.android.com/reference/kotlin/android/os/Parcelable.html#writeToParcel(android.os.Parcel,%20kotlin.Int)): the object being written is a return value, that is the result of a function such as "`Parcelable someFunction()`", "`void someFunction(out Parcelable)`", or "`void someFunction(inout Parcelable)`". Some implementations may want to release resources at this point.
| || | Public constructors || |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---| | [ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#ColorStateList(kotlin.Array,%20kotlin.IntArray))`(`states:` `[Array](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/index.html)<[IntArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int-array/index.html)!>!`, `colors:` `[IntArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int-array/index.html)!`)` Creates a ColorStateList that returns the specified mapping from states to colors. | | Public methods || |----------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | openstatic[ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#) | [createFromXml](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#createFromXml(android.content.res.Resources,%20org.xmlpull.v1.XmlPullParser))`(`r:` `[Resources](https://developer.android.com/reference/kotlin/android/content/res/Resources)!`, `parser:` `[XmlPullParser](https://developer.android.com/reference/kotlin/org/xmlpull/v1/XmlPullParser.html#)!`)` Creates a ColorStateList from an XML document. | | openstatic[ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#) | [createFromXml](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#createFromXml(android.content.res.Resources,%20org.xmlpull.v1.XmlPullParser,%20android.content.res.Resources.Theme))`(`r:` `[Resources](https://developer.android.com/reference/kotlin/android/content/res/Resources)`, `parser:` `[XmlPullParser](https://developer.android.com/reference/kotlin/org/xmlpull/v1/XmlPullParser.html#)`, `theme:` `[Resources.Theme](https://developer.android.com/reference/kotlin/android/content/res/Resources.Theme)?`)` Creates a ColorStateList from an XML document using given a set of[Resources](https://developer.android.com/reference/kotlin/android/content/res/Resources)and a[Theme](https://developer.android.com/reference/kotlin/android/content/res/Resources.Theme). | | open[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [describeContents](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#describeContents())`()`
| | open[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [getChangingConfigurations](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#getChangingConfigurations())`()` Returns a mask of the configuration parameters for which this color state list may change, requiring that it be re-created. | | open[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [getColorForState](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#getColorForState(kotlin.IntArray,%20kotlin.Int))`(`stateSet:` `[IntArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int-array/index.html)?`, `defaultColor:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Return the color associated with the given set of[android.view.View](https://developer.android.com/reference/kotlin/android/view/View.html#)states. | | open[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [getDefaultColor](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#getDefaultColor())`()` Return the default color in this[ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#). | | open[Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | [isOpaque](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#isOpaque())`()` Indicates whether this color state list is opaque, which means that every color returned from[getColorForState(int[],int)](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#getColorForState(kotlin.IntArray,%20kotlin.Int))has an alpha value of 255. | | open[Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | [isStateful](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#isStateful())`()` Indicates whether this color state list contains at least one state spec and the first spec is not empty (e.g. match-all). | | open[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [toString](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#toString())`()`
| | openstatic[ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#) | [valueOf](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#valueOf(kotlin.Int))`(`color:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)`
| | open[ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#) | [withAlpha](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#withAlpha(kotlin.Int))`(`alpha:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Creates a new ColorStateList that has the same states and colors as this one but where each color has the specified alpha value (0-255). | | open[ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#) | [withLStar](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#withLStar(kotlin.Float))`(`lStar:` `[Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html)`)` Creates a new ColorStateList that has the same states and colors as this one but where each color has the specified perceived luminosity value (0-100). | | open[Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | [writeToParcel](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#writeToParcel(android.os.Parcel,%20kotlin.Int))`(`dest:` `[Parcel](https://developer.android.com/reference/kotlin/android/os/Parcel.html#)`, `flags:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)`
| | Properties || |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------| | static[Parcelable.Creator](https://developer.android.com/reference/kotlin/android/os/Parcelable.Creator.html#)\<[ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#)!\> | [CREATOR](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#CREATOR:android.os.Parcelable.Creator)
| ## XML attributes ### android:alpha ``` android:alpha ``` Alpha multiplier applied to the base color. May be a floating point value, such as "`1.2`". ### android:color ``` android:color ``` Base color for this state. May be a color value, in the form of "*rgb*", "*argb*", "*rrggbb*", or "*aarrggbb*". ### android:lStar ``` android:lStar ``` Perceptual luminance applied to the base color. From 0 to 100. May be a floating point value, such as "`1.2`". ## Public constructors ### ColorStateList Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` ColorStateList(     states: Array!,     colors: IntArray!) ``` Creates a ColorStateList that returns the specified mapping from states to colors. ## Public methods ### createFromXml Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) Deprecated in[API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` open static fun createFromXml(     r: Resources!,     parser: XmlPullParser! ): ColorStateList ``` **Deprecated:** *Use #createFromXml(Resources, XmlPullParser parser, Theme)* Creates a ColorStateList from an XML document. | Parameters || |----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------| | `r` | [Resources](https://developer.android.com/reference/kotlin/android/content/res/Resources)!:Resources against which the ColorStateList should be inflated. | | `parser` | [XmlPullParser](https://developer.android.com/reference/kotlin/org/xmlpull/v1/XmlPullParser.html#)!:Parser for the XML document defining the ColorStateList. | | Return || |------------------------------------------------------------------------------------------------------|-----------------------------------------------------| | [ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#) | A new color state list. This value cannot be`null`. | ### createFromXml Added in[API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` open static fun createFromXml(     r: Resources,     parser: XmlPullParser,     theme: Resources.Theme? ): ColorStateList ``` Creates a ColorStateList from an XML document using given a set of[Resources](https://developer.android.com/reference/kotlin/android/content/res/Resources)and a[Theme](https://developer.android.com/reference/kotlin/android/content/res/Resources.Theme). | Parameters || |----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `r` | [Resources](https://developer.android.com/reference/kotlin/android/content/res/Resources):Resources against which the ColorStateList should be inflated. This value cannot be`null`. | | `parser` | [XmlPullParser](https://developer.android.com/reference/kotlin/org/xmlpull/v1/XmlPullParser.html#):Parser for the XML document defining the ColorStateList. This value cannot be`null`. | | `theme` | [Resources.Theme](https://developer.android.com/reference/kotlin/android/content/res/Resources.Theme)?:Optional theme to apply to the color state list, may be`null`. | | Return || |------------------------------------------------------------------------------------------------------|-----------------------------------------------------| | [ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#) | A new color state list. This value cannot be`null`. | ### describeContents Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` open fun describeContents(): Int ``` | Return || |----------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either`0`or[android.os.Parcelable#CONTENTS_FILE_DESCRIPTOR](https://developer.android.com/reference/kotlin/android/os/Parcelable.html#CONTENTS_FILE_DESCRIPTOR:kotlin.Int) | ### getChangingConfigurations Added in[API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` open fun getChangingConfigurations(): Int ``` Returns a mask of the configuration parameters for which this color state list may change, requiring that it be re-created. | Return || |----------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | a mask of the changing configuration parameters, as defined by[android.content.pm.ActivityInfo](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#)Value is either`0`or a combination of[android.content.pm.ActivityInfo#CONFIG_MCC](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_MCC:kotlin.Int),[android.content.pm.ActivityInfo#CONFIG_MNC](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_MNC:kotlin.Int),[android.content.pm.ActivityInfo#CONFIG_LOCALE](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_LOCALE:kotlin.Int),[android.content.pm.ActivityInfo#CONFIG_TOUCHSCREEN](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_TOUCHSCREEN:kotlin.Int),[android.content.pm.ActivityInfo#CONFIG_KEYBOARD](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_KEYBOARD:kotlin.Int),[android.content.pm.ActivityInfo#CONFIG_KEYBOARD_HIDDEN](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_KEYBOARD_HIDDEN:kotlin.Int),[android.content.pm.ActivityInfo#CONFIG_NAVIGATION](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_NAVIGATION:kotlin.Int),[android.content.pm.ActivityInfo#CONFIG_ORIENTATION](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_ORIENTATION:kotlin.Int),[android.content.pm.ActivityInfo#CONFIG_SCREEN_LAYOUT](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_SCREEN_LAYOUT:kotlin.Int),[android.content.pm.ActivityInfo#CONFIG_UI_MODE](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_UI_MODE:kotlin.Int),[android.content.pm.ActivityInfo#CONFIG_SCREEN_SIZE](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_SCREEN_SIZE:kotlin.Int),[android.content.pm.ActivityInfo#CONFIG_SMALLEST_SCREEN_SIZE](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_SMALLEST_SCREEN_SIZE:kotlin.Int),[android.content.pm.ActivityInfo#CONFIG_DENSITY](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_DENSITY:kotlin.Int),[android.content.pm.ActivityInfo#CONFIG_LAYOUT_DIRECTION](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_LAYOUT_DIRECTION:kotlin.Int),[android.content.pm.ActivityInfo#CONFIG_COLOR_MODE](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_COLOR_MODE:kotlin.Int),[android.content.pm.ActivityInfo#CONFIG_FONT_SCALE](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_FONT_SCALE:kotlin.Int),[android.content.pm.ActivityInfo#CONFIG_GRAMMATICAL_GENDER](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_GRAMMATICAL_GENDER:kotlin.Int),[android.content.pm.ActivityInfo#CONFIG_FONT_WEIGHT_ADJUSTMENT](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_FONT_WEIGHT_ADJUSTMENT:kotlin.Int), android.content.pm.ActivityInfo.CONFIG_WINDOW_CONFIGURATION,[android.content.pm.ActivityInfo#CONFIG_ASSETS_PATHS](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_ASSETS_PATHS:kotlin.Int), and[android.content.pm.ActivityInfo#CONFIG_RESOURCES_UNUSED](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#CONFIG_RESOURCES_UNUSED:kotlin.Int) | **See Also** - [android.content.pm.ActivityInfo](https://developer.android.com/reference/kotlin/android/content/pm/ActivityInfo.html#) ### getColorForState Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` open fun getColorForState(     stateSet: IntArray?,     defaultColor: Int ): Int ``` Return the color associated with the given set of[android.view.View](https://developer.android.com/reference/kotlin/android/view/View.html#)states. | Parameters || |----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `stateSet` | [IntArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int-array/index.html)?:an array of[android.view.View](https://developer.android.com/reference/kotlin/android/view/View.html#)states This value may be`null`. | | `defaultColor` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):the color to return if there's no matching state spec in this[ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#)that matches the stateSet. | | Return || |----------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------| | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | the color associated with that set of states in this[ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#). | ### getDefaultColor Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` open fun getDefaultColor(): Int ``` Return the default color in this[ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#). | Return || |----------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------| | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | the default color in this[ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#). | ### isOpaque Added in[API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` open fun isOpaque(): Boolean ``` Indicates whether this color state list is opaque, which means that every color returned from[getColorForState(int[],int)](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#getColorForState(kotlin.IntArray,%20kotlin.Int))has an alpha value of 255. | Return || |------------------------------------------------------------------------------------|------------------------------------------| | [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | True if this color state list is opaque. | ### isStateful Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` open fun isStateful(): Boolean ``` Indicates whether this color state list contains at least one state spec and the first spec is not empty (e.g. match-all). | Return || |------------------------------------------------------------------------------------|------------------------------------------------------------------------------| | [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | True if this color state list changes color based on state, false otherwise. | **See Also** - [#getColorForState(int[], int)](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#getColorForState(kotlin.IntArray,%20kotlin.Int)) ### toString Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` open fun toString(): String ``` | Return || |----------------------------------------------------------------------------------|----------------------------------------| | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | a string representation of the object. | ### valueOf Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` open static fun valueOf(color: Int): ColorStateList ``` | Return || |------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------| | [ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#) | A ColorStateList containing a single color. This value cannot be`null`. | ### withAlpha Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` open fun withAlpha(alpha: Int): ColorStateList ``` Creates a new ColorStateList that has the same states and colors as this one but where each color has the specified alpha value (0-255). | Parameters || |---------|-----------------------------------------------------------------------------------------------------------------| | `alpha` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):The new alpha channel value (0-255). | | Return || |------------------------------------------------------------------------------------------------------|-----------------------------------------------------| | [ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#) | A new color state list. This value cannot be`null`. | ### withLStar Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` open fun withLStar(lStar: Float): ColorStateList ``` Creates a new ColorStateList that has the same states and colors as this one but where each color has the specified perceived luminosity value (0-100). | Parameters || |---------|---------------------------------------------------------------------------------------------------------------------| | `lStar` | [Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html):Target perceptual luminance (0-100). | | Return || |------------------------------------------------------------------------------------------------------|-----------------------------------------------------| | [ColorStateList](https://developer.android.com/reference/kotlin/android/content/res/ColorStateList#) | A new color state list. This value cannot be`null`. | ### writeToParcel Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` open fun writeToParcel(     dest: Parcel,     flags: Int ): Unit ``` | Parameters || |---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `dest` | [Parcel](https://developer.android.com/reference/kotlin/android/os/Parcel.html#):The Parcel in which the object should be written. This value cannot be`null`. | | `flags` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):Additional flags about how the object should be written. May be 0 or[PARCELABLE_WRITE_RETURN_VALUE](https://developer.android.com/reference/kotlin/android/os/Parcelable.html#PARCELABLE_WRITE_RETURN_VALUE:kotlin.Int). Value is either`0`or a combination of[android.os.Parcelable#PARCELABLE_WRITE_RETURN_VALUE](https://developer.android.com/reference/kotlin/android/os/Parcelable.html#PARCELABLE_WRITE_RETURN_VALUE:kotlin.Int), and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES | ## Properties ### CREATOR Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) ``` static val CREATOR: Parcelable.Creator ```