The State class defines a view state, a particular view of a component.
For example, a product thumbnail could have two view states;
a base view state with minimal information, and a rich view state with
additional information.
The overrides property specifies a set of child classes
to add or remove from the base view state, and properties, styles, and event
handlers to set when the view state is in effect.
You use the State class in the states property
of Flex components.
You can only specify a states property at the root of an
application or a custom control, not on child controls.
You enable a view state by setting a component's
currentState property.
The name of the view state upon which this view state is based, or
null if this view state is not based on a named view state.
If this value is null, the view state is based on a root
state that consists of the properties, styles, event handlers, and
children that you define for a component without using a State class.
The default value is null.
name
property
public var name:String
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
Flash Player 9, AIR 1.1
The name of the view state.
State names must be unique for a given component.
This property must be set.
overrides
property
public var overrides:Array
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
Flash Player 9, AIR 1.1
The overrides for this view state, as an Array of objects that implement
the IOverride interface. These overrides are applied in order when the
state is entered, and removed in reverse order when the state is exited.
The following Flex classes implement the IOverride interface and let you
define the view state characteristics:
AddChild
RemoveChild
SetEventHandler
SetProperty
SetStyle
The overrides property is the default property of the
State class. You can omit the <mx:overrides> tag
and its child <mx:Array>tag if you use MXML tag
syntax to define the overrides.
stateGroups
property
public var stateGroups:Array
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
Flash Player 9, AIR 1.1
The state groups that this view state belongs to as an array of String.
Constructor Detail
State
()
Constructor
public function State(properties:Object = null)
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
Flash Player 9, AIR 1.1
Constructor.
Parameters
properties:Object (default = null) — Object containing property settings for this State.
The FlexEvent.ENTER_STATE constant defines the value of the
type property of the event object for a enterState event.
This event will only be dispatched when there are one or more relevant listeners
attached to the dispatching object.
The properties of the event object have the following values:
Property
Value
bubbles
false
cancelable
false
currentTarget
The Object that defines the
event listener that handles the event. For example, if you use
myButton.addEventListener() to register an event listener,
myButton is the value of the currentTarget.
target
The Object that dispatched the event;
it is not always the Object listening for the event.
Use the currentTarget property to always access the
Object listening for the event.
Dispatched just before a view state is exited.
This event is dispatched before the changes
to the default view state have been removed.
The FlexEvent.EXIT_STATE constant defines the value of the
type property of the event object for a exitState event.
This event will only be dispatched when there are one or more relevant listeners
attached to the dispatching object.
The properties of the event object have the following values:
Property
Value
bubbles
false
cancelable
false
currentTarget
The Object that defines the
event listener that handles the event. For example, if you use
myButton.addEventListener() to register an event listener,
myButton is the value of the currentTarget.
target
The Object that dispatched the event;
it is not always the Object listening for the event.
Use the currentTarget property to always access the
Object listening for the event.