Android APIs
public class

StateSet

extends Object
java.lang.Object
   ↳ android.util.StateSet

Class Overview

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)
[Expand]
Inherited Methods
From class java.lang.Object

Fields

public static final int[] NOTHING

Added in API level 11

A state set that does not contain any valid states.

public static final int[] WILD_CARD

Added in API level 1

A state specification that will be matched by all StateSets.

Public Methods

public static String dump (int[] states)

Added in API level 1

Parameters
states int
Returns
String

public static boolean isWildCard (int[] stateSetOrSpec)

Added in API level 1

Return whether the stateSetOrSpec is matched by all StateSets.

Parameters
stateSetOrSpec int: a state set or state spec.
Returns
boolean

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

Added in API level 1

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

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

Added in API level 1

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

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

Added in API level 1

Parameters
states int
newSize int
Returns
int[]