Skip to content

Most visited

Recently visited

navigation

StateSet

public class StateSet
extends Object

java.lang.Object
   ↳ android.util.StateSet


State sets are arrays of positive ints where each element represents the state of a View (e.g. focused, selected, visible, etc.). A View may be in one or more of those states. A state spec is an array of signed ints where each element represents a required (if positive) or an undesired (if negative) View state. Utils dealing with state sets. In theory we could encapsulate the state set and state spec arrays and not have static methods here but there is some concern about performance since these methods are called during view drawing.

Summary

Fields

public static final int[] NOTHING

A state set that does not contain any valid states.

public static final int[] WILD_CARD

A state specification that will be matched by all StateSets.

Public methods

static String dump(int[] states)
static boolean isWildCard(int[] stateSetOrSpec)

Return whether the stateSetOrSpec is matched by all StateSets.

static boolean stateSetMatches(int[] stateSpec, int[] stateSet)

Return whether the stateSet matches the desired stateSpec.

static boolean stateSetMatches(int[] stateSpec, int state)

Return whether the state matches the desired stateSpec.

static int[] trimStateSet(int[] states, int newSize)

Inherited methods

From class java.lang.Object

Fields

NOTHING

added in API level 11
int[] NOTHING

A state set that does not contain any valid states.

WILD_CARD

added in API level 1
int[] WILD_CARD

A state specification that will be matched by all StateSets.

Public methods

dump

added in API level 1
String dump (int[] states)

Parameters
states int

Returns
String

isWildCard

added in API level 1
boolean isWildCard (int[] stateSetOrSpec)

Return whether the stateSetOrSpec is matched by all StateSets.

Parameters
stateSetOrSpec int: a state set or state spec.

Returns
boolean

stateSetMatches

added in API level 1
boolean stateSetMatches (int[] stateSpec, 
                int[] stateSet)

Return whether the stateSet matches the desired stateSpec.

Parameters
stateSpec int: an array of required (if positive) or prohibited (if negative) View states.

stateSet int: an array of View states

Returns
boolean

stateSetMatches

added in API level 1
boolean stateSetMatches (int[] stateSpec, 
                int state)

Return whether the state matches the desired stateSpec.

Parameters
stateSpec int: an array of required (if positive) or prohibited (if negative) View states.

state int: a View state

Returns
boolean

trimStateSet

added in API level 1
int[] trimStateSet (int[] states, 
                int newSize)

Parameters
states int

newSize int

Returns
int[]

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience. (Dec 2017 Android Platform & Tools Survey)