Packagejp.progression
Classpublic class Progression
InheritanceProgression Inheritance flash.events.EventDispatcher
ImplementsIIdGroup

Progression クラスは、Progression を使用するための基本クラスです。 シーン作成やシーン移動の処理は、全て Progression インスタンスを通じて行います。


Example
  // 環境設定を指定する
  Progression.initialize( new BasicAppConfig() );
  
  // Progression インスタンスを作成する
  var manager:Progression = new Progression( "index", stage );
  
  // シーン構造を作成する
  manager.root.addScene( new SceneObject( "about" ) );
  manager.root.addScene( new SceneObject( "gallery" ) );
  manager.root.addScene( new SceneObject( "contact" ) );
  
  // シーンを移動する
  manager.goto( new SceneId( "/index/about" ) );
  

See also

jp.progression.getManagerById()
jp.progression.getManagersByGroup()
jp.progression.casts.CastDocument
jp.progression.events.ProcessEvent
jp.progression.scenes.SceneId
jp.progression.scenes.SceneObject
jp.progression.config


Public Properties
 PropertyDefined by
  autoLock : Boolean
シーンの移動シーケンスが開始された場合に、自動的に lock プロパティを true にするかどうかを取得または設定します。 移動シーケンスが完了後には、lock プロパティは自動的に false に設定されます。
Progression
  config : Configuration
[static][read-only] 初期化時に指定された Configuration を取得します。
Progression
  current : SceneObject
[read-only] 現在位置となる SceneObject インスタンスを取得します。
Progression
  currentSceneId : SceneId
[read-only] 現在位置を示すシーン識別子を取得します。
Progression
  departedSceneId : SceneId
[read-only] 出発位置を示すシーン識別子を取得します。
Progression
  destinedSceneId : SceneId
[read-only] 目的位置を示すシーン識別子を取得します。
Progression
  eventType : String
[read-only] 現在のイベントタイプを取得します。
Progression
  extra : Object
[read-only] 実行時のリレーオブジェクトを取得します。
Progression
  group : String
インスタンスのグループ名を取得または設定します。 Indicates the instance group of the Progression.
Progression
  history : IHistoryManager
[read-only] この Progression インスタンスに関する履歴を管理している IHistoryManager インスタンスを取得します。
Progression
  id : String
インスタンスの識別子を取得します。 Indicates the instance id of the Progression.
Progression
  lock : Boolean
シーン移動処理の実行中に、新しい移動シーケンスの開始を無効化するかどうかを取得または設定します。 このプロパティを設定すると autoLock プロパティが強制的に false に設定されます。
Progression
  root : SceneObject
[read-only] シーンツリーの最上位に位置する SceneObject インスタンスを取得します。
Progression
  stage : Stage
[read-only] 関連付けられている Stage インスタンスを取得します。
Progression
  state : int
[read-only] 現在の処理状態を取得します。
Progression
  sync : Boolean
この Progression インスタンスを同期対象として設定するかどうかを取得または設定します。 同期対象として有効化するためには、Progression を初期化する際にシンクロ機能に対応している Configuration を設定しておく必要があります。
Progression
  syncedManager : Progression
[static][read-only] 現在同期中の Progression インスタンスを取得します。
Progression
  syncedSceneId : SceneId
[read-only] 同期機能が有効化された状態でのシーン識別子を取得します。
Progression
Public Methods
 MethodDefined by
  
Progression(id:String, container:DisplayObjectContainer, rootClass:Class = null, initObject:Object = null)
新しい Progression インスタンスを作成します。 Creates a new Progression object.
Progression
  
createFromXML(container:DisplayObjectContainer, prml:XML):Progression
[static] XML データから Progression インスタンスを生成します。
Progression
  
goto(sceneId:SceneId, extra:Object = null):Boolean
シーンを移動します。
Progression
  
initialize(config:Configuration):Boolean
[static] Progression を初期化します。 この処理は Progression インスタンスを作成する前の状態で 1 回のみ行うことができます。
Progression
  
jumpto(sceneId:SceneId, extra:Object = null):Boolean
シーン移動に関係した処理を全て無視して、すぐに移動します。
Progression
  
setProperties(parameters:Object):Progression
インスタンスに対して、複数のプロパティを一括設定します。
Progression
  
stop():void
シーン移動処理を中断します。
Progression
  
toString():String
指定されたオブジェクトのストリング表現を返します。 Returns the string representation of the specified object.
Progression
Events
 EventSummaryDefined by
   オブジェクトの lock プロパティの値が変更されたときに送出されます。 Progression
   シーン移動処理が実行可能になった瞬間に送出されます。 このイベントが送出される以前に実行された移動命令は、実行可能になるまでスタックされます。 Progression
   管理下にあるシーンの移動処理中に移動先が変更された場合に送出されます。 Progression
   管理下にあるシーンの移動処理が完了した場合に送出されます。 Progression
   シーン移動中にエラーが発生した場合に送出されます。 Progression
   管理下にあるシーンの移動処理中に対象シーンでイベントが発生した場合に送出されます。 Progression
   管理下にあるシーンの移動処理中に対象シーンが変更された場合に送出されます。 Progression
   管理下にあるシーンの移動処理が開始された場合に送出されます。 Progression
   管理下にあるシーンの移動処理が停止された場合に送出されます。 Progression
Public Constants
 ConstantDefined by
  AUTHOR : String = "Copyright (C) 2007-2010 taka:nium.jp, All Rights Reserved."
[static] パッケージの制作者を取得します。
Progression
  NAME : String = "Progression"
[static] パッケージの名前を取得します。 Package name
Progression
  URL : String = "http://progression.jp/"
[static] パッケージの URL を取得します。
Progression
  VERSION : String = "4.0.31"
[static] パッケージのバージョン情報を取得します。
Progression
Property detail
autoLockproperty
autoLock:Boolean  [read-write]

シーンの移動シーケンスが開始された場合に、自動的に lock プロパティを true にするかどうかを取得または設定します。 移動シーケンスが完了後には、lock プロパティは自動的に false に設定されます。

Implementation
    public function get autoLock():Boolean
    public function set autoLock(value:Boolean):void

See also

configproperty 
config:Configuration  [read-only]

初期化時に指定された Configuration を取得します。

Implementation
    public static function get config():Configuration

See also

currentproperty 
current:SceneObject  [read-only]

現在位置となる SceneObject インスタンスを取得します。

Implementation
    public function get current():SceneObject
currentSceneIdproperty 
currentSceneId:SceneId  [read-only]

現在位置を示すシーン識別子を取得します。

Implementation
    public function get currentSceneId():SceneId

See also

departedSceneIdproperty 
departedSceneId:SceneId  [read-only]

出発位置を示すシーン識別子を取得します。

Implementation
    public function get departedSceneId():SceneId

See also

destinedSceneIdproperty 
destinedSceneId:SceneId  [read-only]

目的位置を示すシーン識別子を取得します。

Implementation
    public function get destinedSceneId():SceneId

See also

eventTypeproperty 
eventType:String  [read-only]

現在のイベントタイプを取得します。

Implementation
    public function get eventType():String

See also

extraproperty 
extra:Object  [read-only]

実行時のリレーオブジェクトを取得します。

Implementation
    public function get extra():Object
groupproperty 
group:String  [read-write]

インスタンスのグループ名を取得または設定します。 Indicates the instance group of the Progression.

Implementation
    public function get group():String
    public function set group(value:String):void

See also

historyproperty 
history:IHistoryManager  [read-only]

この Progression インスタンスに関する履歴を管理している IHistoryManager インスタンスを取得します。

Implementation
    public function get history():IHistoryManager

See also

idproperty 
id:String  [read-write]

インスタンスの識別子を取得します。 Indicates the instance id of the Progression.

Implementation
    public function get id():String
    public function set id(value:String):void

See also

lockproperty 
lock:Boolean  [read-write]

シーン移動処理の実行中に、新しい移動シーケンスの開始を無効化するかどうかを取得または設定します。 このプロパティを設定すると autoLock プロパティが強制的に false に設定されます。

Implementation
    public function get lock():Boolean
    public function set lock(value:Boolean):void

See also

rootproperty 
root:SceneObject  [read-only]

シーンツリーの最上位に位置する SceneObject インスタンスを取得します。

Implementation
    public function get root():SceneObject
stageproperty 
stage:Stage  [read-only]

関連付けられている Stage インスタンスを取得します。

Implementation
    public function get stage():Stage
stateproperty 
state:int  [read-only]

現在の処理状態を取得します。

Implementation
    public function get state():int

See also

syncproperty 
sync:Boolean  [read-write]

この Progression インスタンスを同期対象として設定するかどうかを取得または設定します。 同期対象として有効化するためには、Progression を初期化する際にシンクロ機能に対応している Configuration を設定しておく必要があります。

Implementation
    public function get sync():Boolean
    public function set sync(value:Boolean):void

See also

syncedManagerproperty 
syncedManager:Progression  [read-only]

現在同期中の Progression インスタンスを取得します。

Implementation
    public static function get syncedManager():Progression

See also

syncedSceneIdproperty 
syncedSceneId:SceneId  [read-only]

同期機能が有効化された状態でのシーン識別子を取得します。

Implementation
    public function get syncedSceneId():SceneId

See also

Constructor detail
Progression()constructor
public function Progression(id:String, container:DisplayObjectContainer, rootClass:Class = null, initObject:Object = null)

新しい Progression インスタンスを作成します。 Creates a new Progression object.

Parameters
id:Stringインスタンスの識別子です。
 
container:DisplayObjectContainer関連付けたい DisplayObjectContainer インスタンスです。
 
rootClass:Class (default = null)ルートシーンに関連付けたいクラスの参照です。
 
initObject:Object (default = null)設定したいプロパティを含んだオブジェクトです。
Method detail
createFromXML()method
public static function createFromXML(container:DisplayObjectContainer, prml:XML):Progression

XML データから Progression インスタンスを生成します。

Parameters
container:DisplayObjectContainer関連付けたい Stage インスタンスです。
 
prml:XML生成時に使用する設定情報を含んだ XML オブジェクトです。

Returns
Progression生成された Progression インスタンスです。

Example
   // 環境設定を指定する
   Progression.initialize( new BasicAppConfig() );
   
   // XML データを作成する
   var prml:XML =
   <prml version="2.0.0" type="text/prml.plain">
    <scene name="index">
     <scene name="about">
     </scene>
     <scene name="gallery">
     </scene>
     <scene name="contact">
     </scene>
    </scene>
   </prml>;
   
   // XML データから Progression インスタンスを作成する
   var manager:Progression = Progression.createFromXML( stage, prml );
   

goto()method 
public function goto(sceneId:SceneId, extra:Object = null):Boolean

シーンを移動します。

Parameters
sceneId:SceneId移動先を示すシーン識別子です。
 
extra:Object (default = null)実行時にコマンドフローをリレーするオブジェクトです。

Returns
Boolean移動処理が正常に実行された場合は true を、それ以外は false を返します。

See also

initialize()method 
public static function initialize(config:Configuration):Boolean

Progression を初期化します。 この処理は Progression インスタンスを作成する前の状態で 1 回のみ行うことができます。

Parameters
config:Configuration初期化情報として使用したい Configuration インスタンスです。

Returns
Boolean初期化に成功した場合には true を、失敗した場合には false を返します。

See also


Example
   // 環境設定を指定する
   Progression.initialize( new BasicAppConfig() );
   
   // Progression インスタンスを作成する
   var manager:Progression = new Progression( "index", stage );
   

jumpto()method 
public function jumpto(sceneId:SceneId, extra:Object = null):Boolean

シーン移動に関係した処理を全て無視して、すぐに移動します。

Parameters
sceneId:SceneId移動先を示すシーン識別子です。
 
extra:Object (default = null)実行時にコマンドフローをリレーするオブジェクトです。

Returns
Boolean移動処理が正常に実行された場合は true を、それ以外は false を返します。

See also

setProperties()method 
public function setProperties(parameters:Object):Progression

インスタンスに対して、複数のプロパティを一括設定します。

Parameters
parameters:Object設定したいプロパティを含んだオブジェクトです。

Returns
Progression自身の参照です。
stop()method 
public function stop():void

シーン移動処理を中断します。

See also

toString()method 
public override function toString():String

指定されたオブジェクトのストリング表現を返します。 Returns the string representation of the specified object.

Returns
Stringオブジェクトのストリング表現です。 A string representation of the object.
Event detail
managerLockChangeevent 
Event object type: jp.progression.events.ManagerEvent

オブジェクトの lock プロパティの値が変更されたときに送出されます。

managerReadyevent  
Event object type: jp.progression.events.ManagerEvent

シーン移動処理が実行可能になった瞬間に送出されます。 このイベントが送出される以前に実行された移動命令は、実行可能になるまでスタックされます。

processChangeevent  
Event object type: jp.progression.events.ProcessEvent

管理下にあるシーンの移動処理中に移動先が変更された場合に送出されます。

processCompleteevent  
Event object type: jp.progression.events.ProcessEvent

管理下にあるシーンの移動処理が完了した場合に送出されます。

processErrorevent  
Event object type: jp.progression.events.ProcessEvent

シーン移動中にエラーが発生した場合に送出されます。

processEventevent  
Event object type: jp.progression.events.ProcessEvent

管理下にあるシーンの移動処理中に対象シーンでイベントが発生した場合に送出されます。

processSceneevent  
Event object type: jp.progression.events.ProcessEvent

管理下にあるシーンの移動処理中に対象シーンが変更された場合に送出されます。

processStartevent  
Event object type: jp.progression.events.ProcessEvent

管理下にあるシーンの移動処理が開始された場合に送出されます。

processStopevent  
Event object type: jp.progression.events.ProcessEvent

管理下にあるシーンの移動処理が停止された場合に送出されます。

Constant detail
AUTHORconstant
public static const AUTHOR:String = "Copyright (C) 2007-2010 taka:nium.jp, All Rights Reserved."

パッケージの制作者を取得します。

NAMEconstant 
public static const NAME:String = "Progression"

パッケージの名前を取得します。 Package name

URLconstant 
public static const URL:String = "http://progression.jp/"

パッケージの URL を取得します。

VERSIONconstant 
public static const VERSION:String = "4.0.31"

パッケージのバージョン情報を取得します。