Most visited

Recently visited

Added in API level 1

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[]

Hooray!