State Flex class
The State class is a small class that is really only used to define the states of a component. It inherits only from EventDispatcher. State has a three public properties: overrides:Array, basedOn:String, and name:String. overrides holds the operations that the State will perform when it is applied to a component. name sets the name of the state and basedOn established a hierarchy between states. The functionality for the State is implemented in UIComponent and the individual overrides, which all implement the IOverride interface.
The State class exposes three internal methods using the mx_internal namespace so that UIComponent can call them when it is applying states to itself. These methods are initialize(), dispatchEnterState(), and dispatchExitState().
initialize() simply loops through its child overrides, calling initialize() on them and then marking itself as initialized:
-
mx_internal function initialize():void
-
{
-
if (!initialized)
-
{
-
initialized = true;
-
for (var i:int = 0; i < overrides.length; i++)
-
{
-
IOverride(overrides[i]).initialize();
-
}
-
}
-
}
Each of the dispatch* methods simply perform a dispatchEvent() of the appropriate events. I don't know why the Adobe developers would add methods such as these because dispatchEvent() is a public method on EventDispatcher and UIComponent could just call this directly on the State (as it inherits from EventDispatcher). Perhaps they just wanted to encapsulate the functionality in case it would change in the future.
In the case where the UIComponent is returning to its base state, there is not an explicit State object associated with this state, so the UIComponent dispatches the enterState event on itself:
-
// If we're going back to the base state, dispatch an
-
// enter state event, otherwise apply the state.
-
if (isBaseState(currentState))
-
dispatchEvent(new FlexEvent(FlexEvent.ENTER_STATE));
-
else
-
applyState(_currentState, commonBaseState);