English | Site Directory

Android - An Open Handset Alliance Project

android.graphics
public class

android.graphics.ColorStateList

java.lang.Object
android.graphics.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:colore="@color/testcolor3" />
   <item android:state_active="true" android:color="@color/testcolor4" />
   <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.

Summary

Public Constructors

          ColorStateList(int[][] states, int[] colors)
Creates a ColorStateList that returns the specified mapping from states to colors.

Public Methods

      static  ColorStateList  createFromXml(Resources r, XmlPullParser parser)
Create a ColorStateList from an XML document, given a set of Resources.
        int  getColorForState(int[] stateSet, int defaultColor)
Return the color associated with the given set of View states.
        int  getDefaultColor()
Return the default color in this ColorStateList.
        boolean  isStateful()
        String  toString()
Answers a string containing a concise, human-readable description of the receiver.
      static  ColorStateList  valueOf(int color)
Creates or retrieves a ColorStateList that always returns a single color.
        ColorStateList  withAlpha(int alpha)
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).
Methods inherited from class java.lang.Object

Details

Public Constructors

public ColorStateList(int[][] states, int[] colors)

Creates a ColorStateList that returns the specified mapping from states to colors.

Public Methods

public static ColorStateList createFromXml(Resources r, XmlPullParser parser)

Create a ColorStateList from an XML document, given a set of Resources.

Throws

XmlPullParserException
IOException

public int getColorForState(int[] stateSet, int defaultColor)

Return the color associated with the given set of View states.

Parameters

stateSet an array of View states
defaultColor the color to return if there's not state spec in this ColorStateList that matches the stateSet.

Returns

public int getDefaultColor()

Return the default color in this ColorStateList.

Returns

public boolean isStateful()

public String toString()

Answers a string containing a concise, human-readable description of the receiver.

public static ColorStateList valueOf(int color)

Creates or retrieves a ColorStateList that always returns a single color.

public ColorStateList withAlpha(int alpha)

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).
Build m5-rc15g - 14 May 2008 12:50