Packageorg.spicefactory.parsley.view
Classpublic class FirstChildContext
InheritanceFirstChildContext Inheritance Object

Waits for the first child Context that gets created somewhere in the view hieararchy at or below the specified view instance. The various callbacks allow to either modify the configuration before the Context gets built, or the receive the Context instance once it has either been just created or fully initialized.



Public Methods
 MethodDefined By
  
bootstrap(handler:Function):FirstChildContext
The handler to invoke when the bootstrap of the child Context starts.
FirstChildContext
  
complete(handler:Function):FirstChildContext
The handler to invoke when the child Context has finished its initialization.
FirstChildContext
  
created(handler:Function):FirstChildContext
The handler to invoke when the child Context has been created.
FirstChildContext
  
error(handler:Function):FirstChildContext
The handler to invoke when the creation of the child Context aborts with an error.
FirstChildContext
  
Applies all handlers and configuration that have been specified and waits for the first child Context to be created in the view.
FirstChildContext
  
timeout(milliseconds:uint):FirstChildContext
Specifies the amount of time to wait until the final of the specified callbacks gets invoked.
FirstChildContext
  
view(view:DisplayObject):FirstChildContext
[static] The view to use for waiting for the first child Context in the hierarchy below.
FirstChildContext
Method Detail
bootstrap()method
public function bootstrap(handler:Function):FirstChildContext

The handler to invoke when the bootstrap of the child Context starts. This is a very early callback, the actual Context instance is not available yet. Instead the provided BoostrapConfig instance allows to transparently add configuration options and managed objects to the child Context without the child Context being aware of this. This is primarily useful for developing application shells where some aspects like navigation status might need to be provided to modules or tabs in a transparent way.

The function must accept a parameter of type BootstrapConfig

.

Parameters

handler:Function — the handler to invoke when the bootstrap of the child Context starts

Returns
FirstChildContext — this instance for method chaining
complete()method 
public function complete(handler:Function):FirstChildContext

The handler to invoke when the child Context has finished its initialization. At this point all non-lazy singletons have been created and configured and the Context had fired its initialized event.

The function must accept a parameter of type Context.

Parameters

handler:Function — the handler to invoke when the child Context has finished its initialization

Returns
FirstChildContext — this instance for method chaining
created()method 
public function created(handler:Function):FirstChildContext

The handler to invoke when the child Context has been created. This is an early callback, invoked right after the Context instance has created, but potentially before it fired its configured or initialized events.

The function must accept a parameter of type Context.

Parameters

handler:Function — the handler to invoke when the child Context has been created

Returns
FirstChildContext — this instance for method chaining
error()method 
public function error(handler:Function):FirstChildContext

The handler to invoke when the creation of the child Context aborts with an error.

The function must accept a parameter of type Object. It will be the cause of the error, so usually an instance of ErrorEvent or Error.

Parameters

handler:Function — the handler to invoke when the creation of the child Context aborts with an error

Returns
FirstChildContext — this instance for method chaining
execute()method 
public function execute():ContextLookup

Applies all handlers and configuration that have been specified and waits for the first child Context to be created in the view.

Returns
ContextLookup — a lookup instance that allows to cancel the operation
timeout()method 
public function timeout(milliseconds:uint):FirstChildContext

Specifies the amount of time to wait until the final of the specified callbacks gets invoked. In case the operation times out, the error handler will get invoked with a parameter of type TimerEvent.

Parameters

milliseconds:uint — the number of milliseconds to wait until the final callback gets invoked

Returns
FirstChildContext — this instance for method chaining
view()method 
public static function view(view:DisplayObject):FirstChildContext

The view to use for waiting for the first child Context in the hierarchy below.

Parameters

view:DisplayObject — the view to use for waiting for the first child Context in the hierarchy below

Returns
FirstChildContext — a new ParentContext instance for specifying various callbacks