| java.lang.Object | |
| ↳ | android.content.res.ColorStateList |
Lets you map View state sets to colors.
ColorStateLists 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:
<selector xmlns:android="http://schemas.android.com/apk/res/android"> <item android:state_focused="true" android:color="@color/testcolor1"/> <item android:state_pressed="true" android:state_enabled="false" android:color="@color/testcolor2" /> <item android:state_enabled="false" android:color="@color/testcolor3" /> <item android:color="@color/testcolor5"/> </selector>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. The list of state specs will be processed in order of the items in the XML 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. Note that if you have such an item before any other items in the list then any subsequent items will end up being ignored.
For more information, see the guide to Color State List Resource.
|
[Expand]
Inherited Constants | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
 From interface
android.os.Parcelable
| |||||||||||
| Fields | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| CREATOR | |||||||||||
| Public Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Creates a ColorStateList that returns the specified mapping from
states to colors.
| |||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
This method was deprecated
in API level 23.
Use #createFromXml(Resources, XmlPullParser parser, Theme)
| |||||||||||
Creates a ColorStateList from an XML document using given a set of
Resources and a Resources.Theme.
| |||||||||||
Describe the kinds of special objects contained in this Parcelable's
marshalled representation.
| |||||||||||
Returns a mask of the configuration parameters for which this color
state list may change, requiring that it be re-created.
| |||||||||||
Return the color associated with the given set of
View states.
| |||||||||||
Return the default color in this
ColorStateList.
| |||||||||||
Indicates whether this color state list is opaque, which means that every
color returned from
getColorForState(int[], int) has an alpha
value of 255.
| |||||||||||
Indicates whether this color state list contains more than one state spec
and will change color based on state.
| |||||||||||
Returns a string containing a concise, human-readable description of this
object.
| |||||||||||
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).
| |||||||||||
Flatten this object in to a Parcel.
| |||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
From class
java.lang.Object
| |||||||||||
|
From interface
android.os.Parcelable
| |||||||||||
Creates a ColorStateList that returns the specified mapping from states to colors.
This method was deprecated
in API level 23.
Use #createFromXml(Resources, XmlPullParser parser, Theme)
Creates a ColorStateList from an XML document.
| r | Resources against which the ColorStateList should be inflated. |
|---|---|
| parser | Parser for the XML document defining the ColorStateList. |
Creates a ColorStateList from an XML document using given a set of
Resources and a Resources.Theme.
| r | Resources against which the ColorStateList should be inflated. |
|---|---|
| parser | Parser for the XML document defining the ColorStateList. |
| theme | Optional theme to apply to the color state list, may be
null. |
Describe the kinds of special objects contained in this Parcelable's marshalled representation.
Returns a mask of the configuration parameters for which this color state list may change, requiring that it be re-created.
Developers
ActivityInfoReturn the color associated with the given set of
View states.
| stateSet | an array of View states |
|---|---|
| defaultColor | the color to return if there's no matching state
spec in this ColorStateList that matches the
stateSet. |
ColorStateList.
Return the default color in this ColorStateList.
ColorStateList.
Indicates whether this color state list is opaque, which means that every
color returned from getColorForState(int[], int) has an alpha
value of 255.
Indicates whether this color state list contains more than one state spec and will change color based on state.
Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression:
getClass().getName() + '@' + Integer.toHexString(hashCode())
See Writing a useful
toString method
if you intend implementing your own toString method.
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).
| alpha | The new alpha channel value (0-255). |
|---|
Flatten this object in to a Parcel.
| dest | The Parcel in which the object should be written. |
|---|---|
| flags | Additional flags about how the object should be written.
May be 0 or PARCELABLE_WRITE_RETURN_VALUE.
|