java.lang.Object | |
↳ | android.content.res.ColorStateList |
Lets you map View
state sets to colors.
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:
<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 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Create a ColorStateList from an XML document, given a set of
Resources . | |||||||||||
Describe the kinds of special objects contained in this Parcelable's
marshalled representation.
| |||||||||||
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 or retrieves a ColorStateList that always returns a single color.
| |||||||||||
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.
Create a ColorStateList from an XML document, given a set of Resources
.
Describe the kinds of special objects contained in this Parcelable's marshalled representation.
Return the color associated with the given set of View
states.
stateSet | an array of View states |
---|---|
defaultColor | the color to return if there's not 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 or retrieves a ColorStateList that always returns a single color.
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.
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 .
|