onError

言語バージョン

AS2 and AS3.

語法

... onError:value, ...

パラメーター

value:Function — トゥイーンを実行しようとしてエラーが出た際に実行されるファンクション。 This is used to handle errors more commonly thrown by other events (that is, from code not controlled by Tweener), such as onStart, onUpdate or onComplete. The function scope (in which the event is executed) is the target object itself, unless specified by the onErrorScope parameter.

ActionScript2ではエラーが沈黙する傾向にあるため、このパラメーターはActionScript3でより効果を発揮する。

用例

// オブジェクトをトゥイーンし、何かのイベントでエラーが発生した場合にはその内容を出力する (AS3)
this.handleError = function(errorScope:Object, metaError:Error) {
	trace ("警告! Object " + errorScope + " が以下のエラーを投げました: " + metaError);
};
this.someCrazyFunction = function() {
	// このファンクションではonErrorが拾うようなエラーを投げるための処理が記述されていなければいけない
	// 例えばnullオブジェクトへの参照などである
	var whatever:Object = null;
	var whatever2 = whatever.someProperty;
};
Tweener.addTween(this.box, {x:100, time:1, onUpdate:this.someCrazyFunction, onError:this.handleError});

参照

onErrorScope