<s:ViewNavigator id="navigator" width="100%" height="100%" firstView="MainView"/>

<?xml version="1.0" encoding="utf-8"?>
<s:View xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        title="Image View"
        actionBarVisible="false">

    <s:Scroller width="100%" height="100%">
        <s:Group>
            <s:BitmapImage source="@Embed('images/img.jpeg')"/>
        </s:Group>
    </s:Scroller>

    <s:Button label="Toggle ActionBar" click="{actionBarVisible = !actionBarVisible}"/>
</s:View>

package mx.events
{

class FlexEvent extends Event
{
/**
 *  Dispatched when the back key is pressed.  A cancelable event.  If
 *  canceled, the navigator's default back logic will not be run.
 */
public static const BACK_KEY_PRESSED:String = "backKeyPressed";

/**
 *  Dispatched when the menu key is pressed.  A cancelable event.  If
 *  canceled, the navigator's default menu logic will not be run.
 */
public static const MENU_KEY_PRESSED:String = "menuKeyPressed";
}
}

package spark.events
{
import flash.events.Event;

/**
 *  The ViewNavigatorEvent class represents event objects dispatched by the 
 *  View class.
 */
public class ViewNavigatorEvent extends Event
{
    //--------------------------------------------------------------------------
    //
    //  Class constants
    //
    //--------------------------------------------------------------------------

    /**
     *  The <code>ViewNavigatorEvent.REMOVING</code> constant defines the value of the
     *  <code>type</code> property of the event object for an <code>removing</code> 
     *  event.  This event is dispatched when a screen is about to be replaced by
     *  another screen through a navigator action.  If <code>preventDefault()</code>
     *  is called on this event, the view removal will be canceled.
     */
    public static const REMOVING:String = "removing";

    /**
     *  The <code>ViewNavigatorEvent.VIEW_ACTIVATE</code> constant defines the value of the
     *  <code>type</code> property of the event object for an <code>viewActivate</code> 
     *  event.  This event is dispatched when a component is activated.
     */
    public static const VIEW_ACTIVATE:String = "viewActivate";

    /**
     *  The <code>ViewNavigatorEvent.VIEW_DEACTIVATE</code> constant defines the value of the
     *  <code>type</code> property of the event object for an <code>viewDeactivate</code> 
     *  event.  This event is dispatched when a component is deactivated.
     */
    public static const VIEW_DEACTIVATE:String = "viewDeactivate";

    //--------------------------------------------------------------------------
    //
    //  Constructor
    //
    //--------------------------------------------------------------------------

    /**
     *  Constructor.
     *
     *  @param type The event type; indicates the action that caused the event.
     *
     *  @param bubbles Specifies whether the event can bubble up
     *  the display list hierarchy.
     *
     *  @param cancelable Specifies whether the behavior
     *  associated with the event can be prevented.
     *
     *  @param action The navigation action committed by the view navigator 
     *  that resulted in the event.
     */
    public function ViewNavigatorEvent(type:String, bubbles:Boolean = false, 
                                       cancelable:Boolean = false,
                                       action:String = null);

    //----------------------------------
    //  action
    //----------------------------------

    /**
     *  The navigation action committed by the view navigator that resulted
     *  in the event.
     *  Possible actions include a view being activated or deactivated.
     */
    public var action:String;
}
}

package spark.components
{
//--------------------------------------
//  SkinStates
//--------------------------------------

/**
 *  The skin state used when the view is in portrait orientation
 *
 *  @langversion 3.0
 *  @playerversion Flash 10
 *  @playerversion AIR 2.5
 *  @productversion Flex 4.5
 */
<a href="SkinState%28%26quot%3Bportrait%26quot%3B%29">SkinState("portrait")</a>

/**
 *  The skin state used when the view is in landscape orientation
 *
 *  @langversion 3.0
 *  @playerversion Flash 10
 *  @playerversion AIR 2.5
 *  @productversion Flex 4.5
 */
<a href="SkinState%28%26quot%3Blandscape%26quot%3B%29">SkinState("landscape")</a>

//--------------------------------------
//  Events
//--------------------------------------
/**
 *  Dispatched when the back key is pressed when a view exists inside
 *  a mobile application.
 */
<a href="Event%28name%3D%26quot%3BbackKeyPressed%26quot%3B%2C%20type%3D%26quot%3Bmx.events.FlexEvent%26quot%3B%29">Event(name="backKeyPressed", type="mx.events.FlexEvent")</a>

/**
 *  Dispatched when the <code>data</code> property changes.
 */
<a href="Event%28name%3D%26quot%3BdataChange%26quot%3B%2C%20type%3D%26quot%3Bmx.events.FlexEvent%26quot%3B%29">Event(name="dataChange", type="mx.events.FlexEvent")</a>

/**
 *  Dispatched when the menu key is pressed when a view exists inside
 *  a mobile application.
 */
<a href="Event%28name%3D%26quot%3BmenuKeyPressed%26quot%3B%2C%20type%3D%26quot%3Bmx.events.FlexEvent%26quot%3B%29">Event(name="menuKeyPressed", type="mx.events.FlexEvent")</a>

/**
 *  Dispatched when the current view has been activated.
 */
<a href="Event%28name%3D%26quot%3BviewActivate%26quot%3B%2C%20type%3D%26quot%3Bspark.events.ViewNavigatorEvent%26quot%3B%29">Event(name="viewActivate", type="spark.events.ViewNavigatorEvent")</a>

/**
 *  Dispatched when the current view has been deactivated.
 */
<a href="Event%28name%3D%26quot%3BviewDeactivate%26quot%3B%2C%20type%3D%26quot%3Bspark.events.ViewNavigatorEvent%26quot%3B%29">Event(name="viewDeactivate", type="spark.events.ViewNavigatorEvent")</a>

/**
 *  Dispatched when the screen is about to be removed in response
 *  to a screen change.  Calling <code>preventDefault()</code>
 *  while handling this event will cancel the screen change.
 */
<a href="Event%28name%3D%26quot%3Bremoving%26quot%3B%2C%20type%3D%26quot%3Bspark.events.ViewNavigatorEvent%26quot%3B%29">Event(name="removing", type="spark.events.ViewNavigatorEvent")</a>

class View extends SkinnableContainer implements IDataRenderer
{

//-----------------------------------------------------------
//
// Properties
//
//-----------------------------------------------------------

/**
 *  Flag indicating whether the current view is active.
 *
 *  @default false
 */
public function get isActive():Boolean;

/**
 *  The string that describes the context in which this view was
 *  created.  This property is assigned to the <code>context</code>
 *  parameter that is passed into <code>ViewNavigator.pushView()</code>.
 *
 *  @default null
 *
 *  @see spark.components.ViewNavigator
 *
 *  @langversion 3.0
 *  @playerversion Flash 10.1
 *  @playerversion AIR 2.5
 *  @productversion Flex 4.5
 */
public function get context():String

/**
 *  The data object for the view.
 *
 *  @default null
 */
public function get data():Object;
public function set data(value:Object):void;

/**
 *  Stores the destruction policy of the view.  If set to
 *  "auto", the view is automatically destroyed as new views
 *  are added.  If set to "none", the view instance remains
 *  in memory.
 *
 *  @default "auto"
 */
<a href="Inspectable%28category%3D%26quot%3BGeneral%26quot%3B%2C%20enumeration%3D%26quot%3Bauto%2Cnever%26quot%3B%2C%20defaultValue%3D%26quot%3Bauto%26quot%3B%29">Inspectable(category="General", enumeration="auto,never", defaultValue="auto")</a>
public function get destructionPolicy():String;
public function set destructionPolicy(value:String):void;

/**
 *  A reference to the ViewNavigator the view lives in.
 *
 *  @default null
 */
public function get navigator():ViewNavigator;

/**
 *  Determines the way the navigator's control bars should be
 *  laid out.  If true, the controls hover on top of the current
 *  view.  If false, the components will follow a standard
 *  vertical layout.
 *
 *  @default false
 */
public function get overlayControls():Boolean;
public function set overlayControls(value:Boolean):void

//----------------------------------------------------------
//
// Template Properties
//
//----------------------------------------------------------

/**
 *  Flag indicating whether a view should show the action bar or not.
 *
 *  @default true
 */
public function get actionBarVisible():Boolean;
public function set actionBarVisible(value:Boolean):void;

/**
 *  An array of VisualElements that the current view would like
 *  displayed in the ActionBar's action content area.
 *
 *  @default null
 */
public function get actionContent():Array;
public function set actionContent(value:Array):void;

/**
 *  The layout the view would like assigned to the ActionBar's
 *  action content group.
 *
 *  @default HorizontalLayout
 */
public function get actionLayout():LayoutBase;
public function set actionLayout(value:LayoutBase):void;

/**
 *  An array of VisualElements that the current view would like
 *  displayed to the ActionBar's navigation content area.
 *
 *  @default null
 */
public function get navigationContent():Array;
public function set navigationContent(value:Array):void;

/**
 *  The layout the view would like assigned to the ActionBar's
 *  navigation content group.
 *
 *  @default HorizontalLayout
 */
public function get navigationLayout():LayoutBase;
public function set navigationLayout(value:LayoutBase):void;

/**
 *  The title of the view.  This string is displayed in the
 *  ActionBar's content group area if the titleContent property
 *  isn't set.
 *
 *  @default
 */
public function get title():String;
public function set title(value:String):void;

/**
 *  An array of VisualElements that the current view would like
 *  added to the ActionBar's title content area.  If this is
 *  null, the ActionBar will display the title of the view.
 *
 *  @default null
 */
public function get titleContent():Array;
public function set titleContent(value:Array):void;

/**
 *  The layout the view would like assigned to the ActionBar's
 *  title content group.
 *
 *  @default HorizontalLayout
 */
public function get titleLayout():LayoutBase;
public function set titleLayout(value:LayoutBase):void;

//-----------------------------------------------------------
//
// Methods
//
//-----------------------------------------------------------
/**
 *  Methods creates an object that should be returned to the
 *  previous screen when this view is popped off a navigator's
 *  stack.
 *
 *  @return null
 *
 *  @langversion 3.0
 *  @playerversion Flash 10.1
 *  @playerversion AIR 2.5
 *  @productversion Flex 4.5
 */
public function createReturnObject():Object;

/**
 *  Returns the name of the state to be applied to the view.
 *  By default, this method will return "portrait" if a portrait
 *  state is defined and the stage orientation is also portrait.
 *  "landscape" is returned if the view has defined a landscape
 *  state and the device is also in a landscape orientation.
 *  Otherwise null is returned.
 *
 *  @param isLandscape Indicates whether that application is
 *  currently in a landscape orientation.
 *
 *  @return null
 */
public function getCurrentViewState(isLandscape:Boolean):String;
}
}

package spark.core
{
/**
 *  The ContainerDestructionPolicy class defines the constant values
 *  for the <code>destructionPolicy</code> property of spark view
 *  classes.
 */
public final class ContainerDestructionPolicy
{
    //--------------------------------------------------------------------------
    //
    //  Class constants
    //
    //--------------------------------------------------------------------------

    /**
     *  The lifespan of the container's children will automatically
     *  be managed by the container based on the container's own
     *  heuristic. The default implementation mimics that behavior of
     *  <code>ContainerDestructionPolicy.ALWAYS</code>
     */
    public static const AUTO:String = "auto";

    /**
     *  The container will never destroy its children.
     */
    public static const NEVER:String = "never";
}
}

package spark.components.supportClasses
{
//--------------------------------------
//  Events
//--------------------------------------

/**
 *  The ViewNavigatorBase class defines the base class logic and
 *  interface used by view navigators.  This class contains
 *  methods and properties related to view management, as well
 *  as integration points with ViewNavigatorApplicationBase application
 *  classes.
 */
public class ViewNavigatorBase extends SkinnableContainer
{
    //--------------------------------------------------------------------------
    //
    // Properties
    //
    //--------------------------------------------------------------------------

    /**
     *  Flag indicating whether the navigator is active.  The parent navigator
     *  will automatically set this flag to true or false as its state changes.
     *
     *  @default true
     */
    public function get isActive():Boolean;

    /**
     *  The currently active view of the navigator.  Only one view can
     *  be active at a time.
     *
     *  @default null
     */
    public function get activeView():View;

    /**
     *  Returns the icon that should be used when this navigator is represented
     *  by a visual component.
     *
     *  @default null
     */
    public function get icon():Object;
    public function set icon(value:Class):Object;

    <a href="Bindable">Bindable</a>
    /**
     *  The label to be used when this stack is represented by a visual component.
     *
     *  @default null
     */
    public function get label():String;
    public function set label(value:String):void;

    /**
    *  The last action performed by the navigator.
    *
    *  @default ViewNavigatorAction.NONE
    */
    public function get lastAction():String;

    /**
     *  Flag indicates how the navigator's ui controls should be
     *  laid out in relation to the active view.  If true, the view
     *  will extend the entire content area of the component, and the
     *  ui controls will hover on top.
     *
     *  Changing this property will result in a skin validation.
     *
     *  @default true
     */
    public function get overlayControls():Boolean;
    public function set overlayControls(value:Boolean):void;

    /**
     *  The parent navigator for this navigator.  This is only used
     *  if a navigator exists as a child of another navigator.
     *
     *  @default null
     */
    public function get parentNavigator():ViewNavigatorBase;

    /**
     *  Flag indicating whether transitions are played by the
     *  navigator when a view changes or when the actionBar or tab bar
     *  visibility changes.
     *
     *  @default true
     *
     *  @langversion 3.0
     *  @playerversion Flash 10.1
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */
    public function get transitionsEnabled():Boolean;
    public function set transitionsEnabled(value:Boolean):void;

    //--------------------------------------------------------------------------
    //
    // Public Methods
    //
    //--------------------------------------------------------------------------

    /**
     *  This method updates various properties of the navigator when a
     *  new view is added and activated.
     *
     *  @param view The view that was added
     */
    public function updateControlsForView(view:View):void;
}
}

package spark.components.supportClasses
{
    /**
     *  The ViewNavigatorAction class defines the constant values
     *  for the <code>lastAction</code> property of ViewNavigator.
     *  It indicates what the last committed operation was.
     */
    public final class ViewNavigatorAction
    {
        //--------------------------------------------------------------------------
        //
        //  Class constants
        //
        //--------------------------------------------------------------------------

        /**
         *
         */
        public static const NONE:String = "none";

        /**
         *
         */
        public static const PUSH:String = "push";

        /**
         *
         */
        public static const POP:String = "pop";

        /**
         *
         */
        public static const POP_ALL:String = "popAll";

        /**
         *
         */
        public static const POP_TO_FIRST:String = "popToFirst";

        /**
         *
         */
        public static const REPLACE_VIEW:String = "replaceView";

        /**
         *
         */
        public static const REPLACE_STACK:String = "replaceStack";
    }
}

package spark.components
{
<a href="DefaultProperty%28%26quot%3BnavigationStack%26quot%3B%29">DefaultProperty("navigationStack")</a>

//--------------------------------------
//  SkinStates
//--------------------------------------

/**
 *  The state used when the navigator is in portrait orientation
 */
<a href="SkinState%28%26quot%3Bportrait%26quot%3B%29">SkinState("portrait")</a>

/**
 *  The state used when the navigator is in landscape orientation
 */
<a href="SkinState%28%26quot%3Blandscape%26quot%3B%29">SkinState("landscape")</a>

/**
 *  The state used when the navigator is in portrait orientation
 *  and the navigator controls are overlaid on top.
 */
<a href="SkinState%28%26quot%3BportraitAndOverlay%26quot%3B%29">SkinState("portraitAndOverlay")</a>

/**
 *  The state used when the navigator is in landscape orientation
 *  and the navigator controls are overlaid on top.
 */
<a href="SkinState%28%26quot%3BlandscapeAndOverlay%26quot%3B%29">SkinState("landscapeAndOverlay")</a>

/**
 *  The ViewNavigator component is a container that consists of a collection of
 *  View objects, where only the top most view is visible and active.  Views can
 *  be added and removed by using the popView() and pushView() methods on the
 *  navigator.
 *
 *  When a new view becomes active, the old view's instance is destroyed.
 *  When a view is pushed on top of navigator's stack, the old view's data
 *  property is automatically persisted and restored when it is reactived
 *  through one of the pop methods.
 *
 *  ViewNavigator doesn't provide index information about the Views that
 *  it is currently managing and strictly follows a stack navigation model.
 *  Jumping between a set of views similar to a ViewStack is not supported
 *  by this component.
 *
 *  ViewNavigator displays an optional action bar that displays contextual
 *  information defined by the active view.  When the active view changes, the
 *  action bar is automatically updated.
 */
public class ViewNavigator extends ViewNavigatorBase
{

    //--------------------------------------------------------------------------
    //
    //  Skin Parts
    //
    //--------------------------------------------------------------------------

    /**
     *  A skin part that defines the action bar of the navigator.
     */
    <a href="SkinPart%28required%3D%26quot%3Bfalse%26quot%3B%29">SkinPart(required="false")</a>
    public var actionBar:ActionBar;

    //--------------------------------------------------------------------------
    //
    //  Properties
    //
    //--------------------------------------------------------------------------
    /**
     *  The string that describes the context in which the current view was
     *  created.  This property is assigned to the <code>context</code>
     *  parameter that is passed into <code>ViewNavigator.pushView()</code>.
     *
     *  @default null
     *
     *  @see spark.components.ViewNavigator
     *
     *  @langversion 3.0
     *  @playerversion Flash 10.1
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */
    public function get context():Object;

    /**
     *  This property is the object to use to initialize the first view
     *  of the stack.  This must be a class that extends <code>View</code>.
     *
     *  @default null
     */
    public function get firstView():Class;
    public function set firstView(value:Class):void;

    /**
     * This is the initialization data to pass to the first view when the
     * navigator is initialized.
     *
     *  @default null
     */
    public function get firstViewData():Object;
    public function set firstViewData(value:Object):void;

    /**
     *  Returns the number of views being managed by the navigator.
     */
    public function get length():int;

    /**
     *  Holds the return object returned by the last view that was popped
     *  off the navigation stack.  This object is only available when the
     *  navigator is in the process of switching views in response to a
     *  pop navigation operation.
     *
     *  <p>This object is guarenteed to be valid when the a view receives
     *  the <code>FlexEvent.ADD</code> event, and is destroyed after
     *  the view receives a <code>ViewNavigatorEvent.VIEW_ACTIVATE</code> event.</p>
     *
     *  @default null
     *
     *  @langversion 3.0
     *  @playerversion Flash 10.1
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */
    public function get poppedViewReturnedObject():ViewReturnObject

    //--------------------------------------------------------------------------
    //
    //  UI Template Properties
    //
    //--------------------------------------------------------------------------

    <a href="ArrayElementType%28%26quot%3Bmx.core.IVisualElement%26quot%3B%29">ArrayElementType("mx.core.IVisualElement")</a>
    /**
     *  Array of visual elements that are used as the ActionBar's
     *  actionContent when a view doesn't define any.
     *
     *  @default null
     *
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */
    public function get actionContent():Array;
    public function set actionContent(value:Array):void;

    /**
     *  The default layout for the ActionBar's action content group if
     *  the view doesn't define one.
     *
     *  @default null
     */
    public function get actionLayout():LayoutBase;
    public function set actionLayout(value:LayoutBase):void;

    <a href="ArrayElementType%28%26quot%3Bmx.core.IVisualElement%26quot%3B%29">ArrayElementType("mx.core.IVisualElement")</a>
    /**
     *  Array of visual elements that are used as the ActionBar's
     *  navigationContent when a view doesn't assign any.
     *
     *  @default null
     */
    public function get navigationContent():Array;
    public function set navigationContent(value:Array):void;

    /**
     *  The default layout for the ActionBar navigation content group if
     *  a view doesn't define one.
     *
     *  @default null
     */
    public function get navigationLayout():LayoutBase;
    public function set navigationLayout(value:LayoutBase):void;

    <a href="Bindable">Bindable</a>
    /**
     *  The default title that should be used by the ActionBar if the
     *  view doesn't provide one.
     *
     *  @default null
     */
    public function get title():String;
    public function set title(value:String):void;

    <a href="ArrayElementType%28%26quot%3Bmx.core.IVisualElement%26quot%3B%29">ArrayElementType("mx.core.IVisualElement")</a>
    /**
     *  Array of visual elements that are used as the ActionBar's
     *  titleContent when a view doesn't define one.
     *
     *  @default null
     */
    public function get titleContent():Array;
    public function set titleContent(value:Array):void;

    /**
     *  Layout for the ActionBar's titleContent group.
     *
     *  @default null
     */
    public function get titleLayout():LayoutBase;
    public function set titleLayout(value:LayoutBase):void;

    //--------------------------------------------------------------------------
    //
    // Public Methods
    //
    //--------------------------------------------------------------------------

    /**
     *  Removes all of the views from the navigator.  This will transition
     *  the current view to a blank screen.
     *
     *  @param transition The view transition to play
     */
    public function popAll(transition:ViewTransition = null):void;

    /**
     *  Pops the top view off the navigation stack.
     *
     *  @param transition The view transition to play
     */
    public function popView(transition:ViewTransition = null):void;

    /**
     *  Removes all views except the bottom one from the navigation stack.
     *
     *  @param transition The view transition to play
     */
    public function popToFirstView(transition:ViewTransition = null):void;

    /**
     *  Pushes a new view to the top of the navigation stack.
     *
     *  @param viewClass The class used to create the view
     *  @param data The data object to pass to the view
     *  @param context An arbitrary object that can be used to describe the context
     *         of the push.  When the new view is created, it will be able to reference
     *         this property.
     *  @param transition The view transition to play
     *
     *  @langversion 3.0
     *  @playerversion Flash 10.1
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */
    public function pushView(viewClass:Class,
                             data:Object = null,
                             context:Object = null,
                             transition:ViewTransition = null):void;

    /**
     *  Replaces the top view of the navigation stack with a View.
     *
     *  @param viewClass The class used to create the view
     *  @param data The data object to pass to the view
     *  @param context An arbitrary object used to describe the context
     *         of the push.  When the new view is created, it will be
     *         able to reference this property.
     *  @param transition The view transition to play
     *
     *  @langversion 3.0
     *  @playerversion Flash 10.1
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */
    public function replaceView(viewClass:Class,
                                data:Object = null,
                                context:Object = null,
                                transition:ViewTransition = null):void;

    /**
     *  Shows the action bar.
     *
     *  @param animate Indicates whether a show effect should be played.
     */
    public function showActionBar(animate:Boolean = true):void;

    /**
     *  Hides the action bar.
     *
     *  @param animate Indicates whether a hide effect should be played.
     */
    public function hideActionBar(animate:Boolean = true):void;

    //--------------------------------------------------------------------------
    //
    // Protected Methods
    //
    //--------------------------------------------------------------------------

    /**
     *  Commits the navigation operations that have been executed
     *  on the navigator and begins the view change process.
     */
    protected function commitNavigatorAction():void;

    /**
     *  Initializes the view change process by disabling inputs on the
     *  navigator.  If the navigator has a parent, the parents mouse
     *  interaction flags are disabled.
     */
    protected function committingNavigatorAction():void;

    /**
     *  Creates the effect to play when the ActionBar is hidden.
     *  The produced effect is responsible for animating both the
     *  actionBar and the contentGroup of the navigator.
     *
     *  @return An effect to play when the ActionBar is hidden
     */
    protected function createActionBarHideEffect():IEffect;


    /**
     *  Creates the effect to play when the actionBar is hidden.
     *  The produced effect is responsible for animating both the
     *  actionBar and the contentGroup of the navigator.
     *
     *  @return An effect to play when the ActionBar is shown
     */
    protected function createActionBarShowEffect():IEffect;

    /**
     *  This method is responsible for completing a view change validation pass.
     *  It is responsible for cleaning up and destroying the old view, as well as
     *  activating the new one.
     *
     *  If a transition was played, this method is called after the transition
     *  completes.
     */
    protected function navigatorActionCommitted():void;
}
}

package spark.components.supportClasses
{
/**
 *  The ViewReturnObject class encapsulates the return value of a view
 *  when it is popped off a navigation stack.  The object contains a reference
 *  to the returned object as well as the context in which the popped view was
 *  created.  The context is an arbitrary object that is passed as part of the
 *  <code>ViewNavigator.pushView()</code> method.
 *
 *  @see spark.components.View
 *  @see spark.components.ViewNavigator#pushView
 *
 *  @langversion 3.0
 *  @playerversion Flash 10.1
 *  @playerversion AIR 2.5
 *  @productversion Flex 4.5
 */
public class ViewReturnObject
{
    //--------------------------------------------------------------------------
    //
    //  Constructor
    //
    //--------------------------------------------------------------------------

    /**
     *  Constructor.
     *
     *  @param object The returned object
     *  @param context The context in which the owner was created
     *
     *  @langversion 3.0
     *  @playerversion Flash 10.1
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */
    public function ViewReturnObject(object:Object, context:String);

    //--------------------------------------------------------------------------
    //
    //  Properties
    //
    //--------------------------------------------------------------------------

    //----------------------------------
    //  object
    //----------------------------------

    /**
     *  The return object generated by the view that is being removed.
     *
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */
    public var object:Object = null;

    //----------------------------------
    //  context
    //----------------------------------

    /**
     *  The context identifier passed to the popped view when it was pushed
     *  onto the navigation stack.
     *
     *  @see spark.components.ViewNavigator#pushView
     *
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */
    public var context:String = null;
}
}

package spark.components.supportClasses
{
import flash.utils.IExternalizable;

/**
 *  The NavigationStack class is a data structure that is internally used by
 *  ViewNavigator to track the current set of views that are being managed
 *  by the navigator.
 */
public class NavigationStack implements IExternalizable
{
    //--------------------------------------------------------------------------
    //
    // Properties
    //
    //--------------------------------------------------------------------------

    /**
     *  Returns the length of the stack.
     */
    public function get length():int;

    //--------------------------------------------------------------------------
    //
    // Methods
    //
    //--------------------------------------------------------------------------

    /**
     *  Clears the entire stack.
     */
    public function clear():void;

    /**
     *  Adds a view to the top of the navigation stack.
     *
     *  @param factory The class of the View to create.
     *  @param data The data object to pass to the view when it is created
     *  @param context The context identifier to pass to the view when created
     *
     *  @return The data structure that represents the current view.
     */
    public function pushView(factory:Class, data:Object, context:String = null): ViewDescriptor;

    /**
     *  Removes the top view off the stack.
     *
     *  @return The data structure that represented the View.
     */
    public function popView():ViewDescriptor;

    /**
     *  Removes all but the root object from the navigation stack.
     *
     *  @return The data structure that represented the View.
     */
    public function popToFirstView(): ViewDescriptor;
}
}

package spark.components.supportClasses
{
import flash.utils.IDataInput;
import flash.utils.IDataOutput;
import flash.utils.IExternalizable;
import flash.utils.getDefinitionByName;
import flash.utils.getQualifiedClassName;

import spark.components.View;

/**
 *  The ViewDescriptor object is a data structure used to store information
 *  about a view that is being managed by a ViewNavigator.
 *
 *  @langversion 3.0
 *  @playerversion Flash 10.1
 *  @playerversion AIR 2.5
 *  @productversion Flex 4.5
 */
public class ViewDescriptor implements IExternalizable
{
    /**
     *  Constructor.
     *
     *  @param viewClass The class used to create the View
     *  @param data The data object to pass to the view when created
     *  @param context The context of the view
     *  @param instance A reference to the instance of the View
     *
     *  @langversion 3.0
     *  @playerversion Flash 10.1
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */
    public function ViewDescriptor(viewClass:Class = null,
                              data:Object = null,
                              context:Object = null,
                              instance:View = null);

    /**
     *  The string that describes the context in which this view was
     *  created.  This property is assigned to the <code>context</code>
     *  parameter that is passed into <code>ViewNavigator.pushView()</code>.
     *
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */
    public var context:Object;

    /**
     *  The current data object that is being used by the view.  When a view
     *  is removed from a navigation stack, this value will be updated to
     *  match the view's instance's current data object.
     *
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */
    public var data:Object;

    /**
     *  A reference to the instance that is represented by this view object.
     *  ViewNavigator will create and assign the instance as needed.  This
     *  property will be nulled out when a view is destroyed.
     *
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */
    public var instance:View;

    /**
     *  The serialized data that the view has requested be saved to disk when
     *  the application is writing data to a shared object or external file.
     *  This object is the result of the <code>serializeData()</code> method
     *  on View.
     *
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */
    public var persistenceData:Object;

    /**
     *  The class used to create the view.  ViewNavigator will expect this
     *  class to subclass View.
     *
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */
    public var viewClass:Class;
}
}