パッケージfl.motion
クラスpublic class Animator
継承Animator Inheritance EventDispatcher Inheritance Object

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

Animator クラスは、モーショントゥイーンの XML 記述を表示オブジェクトに適用します。Animator クラスのプロパティおよびメソッドはモーションの再生を制御し、Flash Player はモーションのステータスの変化に応じてイベントをブロードキャストします。Animator クラスは、主に Flash CS3 の [ActionScript としてのモーションのコピー] コマンドで使用されています。これにより、アプリケーションプログラミングインターフェイス (API) を使用して ActionScript を編集できるようになります。また、独自のカスタムアニメーションを作成することもできます。

Animator クラスのメソッドを関数内で呼び出す場合、Animator インスタンスを関数の外部で宣言し、オブジェクトのスコープが関数内に限定されないようにします。関数の内部でインスタンスを宣言すると、関数の最後に、Flash Player の "ガベージコレクション" ルーチンによって Animator インスタンスが削除され、ターゲットオブジェクトのアニメーションが無効になります。

メモ : Flash CS3 を使用せずに SWF ファイルをコンパイルする場合は、モーションを表示オブジェクトに適用するために、コンパイル時のクラスパス内に fl.motion のクラスが必要です。

デフォルトの MXML プロパティmotion

関連項目

モーション XML エレメント

パブリック プロパティ
 プロパティ定義元
  autoRewind : Boolean = false
アニメーションが終了後に再開するように設定します。
Animator
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  isPlaying : Boolean
[read-only] アニメーションが現在再生中かどうかを示します。
Animator
  motion : Motion
アニメーションのモーショントゥイーンプロパティを含んでいるオブジェクトです。
Animator
  orientToPath : Boolean = false
モーションパスに沿って表示オブジェクトの位置を設定します。
Animator
  positionMatrix : Matrix
全体的な変換をモーションパスに適用する Matrix オブジェクトです。
Animator
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  repeatCount : int = 1
アニメーションを繰り返す回数を表します。
Animator
  target : DisplayObject
アニメーション中の表示オブジェクトです。
Animator
  time : int
現在のアニメーションの時間を表示および制御するゼロから始まる整数です。
Animator
  transformationPoint : Point
表示オブジェクトを回転または拡大 / 縮小するための基準点です。
Animator
パブリック メソッド
 メソッド定義元
  
Animator(xml:XML = null, target:DisplayObject = null)
Animator オブジェクトを作成して、XML ベースのモーショントゥイーン記述を表示オブジェクトに適用します。
Animator
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
 Inherited
dispatchEvent(event:Event):Boolean
イベントをイベントフローに送出します。
EventDispatcher
  
end():void
アニメーションを停止し、Flash Player がアニメーションシーケンスの最後のフレームに直ちに移動します。
Animator
  
fromXMLString(xmlString:String, target:DisplayObject = null):Animator
[static] XML のストリングから Animator オブジェクトを作成します。
Animator
 Inherited
hasEventListener(type:String):Boolean
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
  
nextFrame():void
Flash Player をアニメーションシーケンス内の次のフレームに進めます。
Animator
  
pause():void
resume() メソッドを呼び出すまでアニメーションを一時停止します。
Animator
  
play():void
アニメーションを開始します。
Animator
 Inherited
propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し列挙できるかどうかを示します。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
  
resume():void
pause() メソッドで一時停止されていたアニメーションを再開します。
Animator
  
rewind():void
Flash Player をアニメーションの最初のフレームに設定します。
Animator
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
  
stop():void
アニメーションを停止し、Flash Player がアニメーションシーケンスの最初のフレームに戻ります。
Animator
 Inherited
toString():String
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
willTrigger(type:String):Boolean
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
イベント
 イベント 概要 定義元
 Inherited
activate
Flash Player がオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited
deactivate
Flash Player がオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
  
motionEnd
モーションの最後に到達したか、stop() メソッドまたは end() メソッドによってモーションが中断されたために、再生が完了したときに送出されます。Animator
  
motionStart
モーションの再生開始時に送出されます。Animator
  
motionUpdate
モーションが変更され、画面が更新された場合に送出されます。Animator
  
timeChange
Animator の時間値が変化したとき、画面の更新前 (motionUpdate イベントなど) に送出されます。Animator
プロパティの詳細
autoRewindプロパティ
public var autoRewind:Boolean = false

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

アニメーションが終了後に再開するように設定します。

isPlayingプロパティ 
isPlaying:Boolean  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

アニメーションが現在再生中かどうかを示します。


実装
    public function get isPlaying():Boolean
motionプロパティ 
motion:Motion  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

アニメーションのモーショントゥイーンプロパティを含んでいるオブジェクトです。


実装
    public function get motion():Motion
    public function set motion(value:Motion):void
orientToPathプロパティ 
public var orientToPath:Boolean = false

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

モーションパスに沿って表示オブジェクトの位置を設定します。true に設定すると、表示オブジェクトのベースラインがモーションパスに指定されます。それ以外の場合は、基準点がモーションパスに指定されます。

positionMatrixプロパティ 
public var positionMatrix:Matrix

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

全体的な変換をモーションパスに適用する Matrix オブジェクトです。このマトリックスを使用すると、表示オブジェクトの外観を変更せずに、パスをシフト、拡大 / 縮小、傾斜、または回転することができます。

repeatCountプロパティ 
public var repeatCount:int = 1

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

アニメーションを繰り返す回数を表します。有効な値は 0 以上の整数です。値が 1 の場合、アニメーションが 1 回再生されます。値が 0 の場合、end() メソッドを呼び出すなどして明示的に停止するまでアニメーションが無期限に再生されます。

デフォルト値 : 1.

関連項目

end()
targetプロパティ 
target:DisplayObject  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

アニメーション中の表示オブジェクトです。MovieClip、Sprite、Bitmap など、flash.display.DisplayObject のサブクラスを利用できます。


実装
    public function get target():DisplayObject
    public function set target(value:DisplayObject):void

関連項目

flash.display.DisplayObject
timeプロパティ 
time:int  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

現在のアニメーションの時間を表示および制御するゼロから始まる整数です。アニメーションの最初のフレームでは、time は 0 です。アニメーションの継続時間が 10 フレームである場合、最後のフレームの time は 9 です。


実装
    public function get time():int
    public function set time(value:int):void
transformationPointプロパティ 
public var transformationPoint:Point

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

表示オブジェクトを回転または拡大 / 縮小するための基準点です。変換ポイントは、表示オブジェクトの境界ボックスを基準にして表します。ポイントの座標は 1px × 1px のボックスに縮小 / 拡大されます。ここで、(1, 1) はオブジェクトの右下隅を表し、(0, 0) は左上隅を表します。

コンストラクタの詳細
Animator()コンストラクタ
public function Animator(xml:XML = null, target:DisplayObject = null)

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

Animator オブジェクトを作成して、XML ベースのモーショントゥイーン記述を表示オブジェクトに適用します。

パラメータ
xml:XML (default = null) — XML ベースのモーショントゥイーン記述を含んでいる E4X オブジェクトです。
 
target:DisplayObject (default = null) — モーショントゥイーンを使用する表示オブジェクトです。

関連項目

モーション XML エレメント
メソッドの詳細
end()メソッド
public function end():void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

アニメーションを停止し、Flash Player がアニメーションシーケンスの最後のフレームに直ちに移動します。autoRewind プロパティを true に設定すると、Flash Player がアニメーションシーケンスの最初のフレームに移動します。

関連項目

autoRewind
fromXMLString()メソッド 
public static function fromXMLString(xmlString:String, target:DisplayObject = null):Animator

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

XML のストリングから Animator オブジェクトを作成します。このメソッドは、E4X オブジェクトを受け入れる Animator コンストラクタの代わりに使用されます。

パラメータ

xmlString:String — モーショントゥイーンを記述する XML のストリングです。
 
target:DisplayObject (default = null) — モーショントゥイーンを使用する表示オブジェクトです。

戻り値
Animator — 指定した xmlString を、指定した target に適用する Animator インスタンスです。

関連項目

モーション XML エレメント
nextFrame()メソッド 
public function nextFrame():void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

Flash Player をアニメーションシーケンス内の次のフレームに進めます。

pause()メソッド 
public function pause():void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

resume() メソッドを呼び出すまでアニメーションを一時停止します。

関連項目

resume()
play()メソッド 
public function play():void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

アニメーションを開始します。end() メソッドを呼び出した後で play() メソッドを呼び出すことで、それまで実行されていたアニメーションのインスタンスをすべて終了してから新しいインスタンスを開始できます。

関連項目

end()
resume()メソッド 
public function resume():void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

pause() メソッドで一時停止されていたアニメーションを再開します。

関連項目

pause()
rewind()メソッド 
public function rewind():void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

Flash Player をアニメーションの最初のフレームに設定します。アニメーションが再生中だった場合は、最初のフレームから再生が続行されます。アニメーションが停止していた場合は、最初のフレームで停止状態になります。

stop()メソッド 
public function stop():void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

アニメーションを停止し、Flash Player がアニメーションシーケンスの最初のフレームに戻ります。

関連項目

end()
イベントの詳細
motionEnd イベント
イベントオブジェクトの型: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_END

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

モーションの最後に到達したか、stop() メソッドまたは end() メソッドによってモーションが中断されたために、再生が完了したときに送出されます。

Animator.stop() または Animator.end() が明示的に呼び出されるか、Motion インスタンスの最後に到達することによって、モーションが停止されたことを示します。

イベントオブジェクトの各プロパティには次の値が設定されています。

プロパティ値
bubblesfalse
cancelablefalse
currentTargetイベント処理を行うイベントリスナーの定義用オブジェクトを表します。たとえば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は "currentTarget" となります。
targetイベントを送出したオブジェクトを表します。このオブジェクトは必ずイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。
motionStart イベント  
イベントオブジェクトの型: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_START

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

モーションの再生開始時に送出されます。

Motion インスタンスの再生が開始されたことを示します。

イベントオブジェクトの各プロパティには次の値が設定されています。

プロパティ値
bubblesfalse
cancelablefalse
currentTargetイベント処理を行うイベントリスナーの定義用オブジェクトを表します。たとえば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は "currentTarget" となります。
targetイベントを送出したオブジェクトを表します。このオブジェクトは必ずイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。
motionUpdate イベント  
イベントオブジェクトの型: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_UPDATE

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

モーションが変更され、画面が更新された場合に送出されます。

Motion インスタンスが変更され、画面が更新されたことを示します。

イベントオブジェクトの各プロパティには次の値が設定されています。

プロパティ値
bubblesfalse
cancelablefalse
currentTargetイベント処理を行うイベントリスナーの定義用オブジェクトを表します。たとえば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は "currentTarget" となります。
targetイベントを送出したオブジェクトを表します。このオブジェクトは必ずイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。
timeChange イベント  
イベントオブジェクトの型: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.TIME_CHANGE

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

Animator の time 値が変化したとき、画面の更新 (motionUpdate イベントなど) 前に送出されます。

Animator インスタンスの time 値は変化したが、画面はまだ更新されていない (motionUpdate イベントが送出されていない) ことを示します。

イベントオブジェクトの各プロパティには次の値が設定されています。

プロパティ値
bubblesfalse
cancelablefalse
currentTargetイベント処理を行うイベントリスナーの定義用オブジェクトを表します。たとえば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は "currentTarget" となります。
targetイベントを送出したオブジェクトを表します。このオブジェクトは必ずイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。



© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Thu Oct 25 2007, 12:41 AM GMT-07:00

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flash/9.0_jp/ActionScriptLangRefV3/fl/motion/Animator.html