Package | laya.utils |
Class | public class Handler |
Inheritance | Handler Object |
Handler
是事件处理器类。
推荐使用 Handler.create() 方法从对象池创建,减少对象创建消耗。创建的 Handler 对象不再使用后,可以使用 Handler.recover() 将其回收到对象池,回收后不要再使用此对象,否则会导致不可预料的错误。
注意:由于鼠标事件也用本对象池,不正确的回收及调用,可能会影响鼠标事件的执行。
Property | Defined By | ||
---|---|---|---|
args : Array 参数。 | Handler | ||
caller : * 执行域(this)。 | Handler | ||
method : Function 处理方法。 | Handler | ||
once : Boolean = false 表示是否只执行一次。如果为true,回调后执行recover()进行回收,回收后会被再利用,默认为false 。 | Handler |
Method | Defined By | ||
---|---|---|---|
Handler(caller:* = null, method:Function = null, args:Array = null, once:Boolean = false)
根据指定的属性值,创建一个 Handler 类的实例。
| Handler | ||
清理对象引用。
| Handler | ||
[static]
从对象池内创建一个Handler,默认会执行一次并立即回收,如果不需要自动回收,设置once参数为false。
| Handler | ||
recover():void
清理并回收到 Handler 对象池内。
| Handler | ||
run():*
执行处理器。
| Handler | ||
runWith(data:*):*
执行处理器,携带额外数据。
| Handler | ||
设置此对象的指定属性值。
| Handler |
args | property |
public var args:Array
参数。
caller | property |
public var caller:*
执行域(this)。
method | property |
public var method:Function
处理方法。
once | property |
public var once:Boolean = false
表示是否只执行一次。如果为true,回调后执行recover()进行回收,回收后会被再利用,默认为false 。
Handler | () | Constructor |
public function Handler(caller:* = null, method:Function = null, args:Array = null, once:Boolean = false)
根据指定的属性值,创建一个 Handler
类的实例。
caller:* (default = null ) — 执行域。
| |
method:Function (default = null ) — 处理函数。
| |
args:Array (default = null ) — 函数参数。
| |
once:Boolean (default = false ) — 是否只执行一次。
|
clear | () | method |
create | () | method |
public static function create(caller:*, method:Function, args:Array = null, once:Boolean = true):Handler
从对象池内创建一个Handler,默认会执行一次并立即回收,如果不需要自动回收,设置once参数为false。
Parameters
caller:* — 执行域(this)。
| |
method:Function — 回调方法。
| |
args:Array (default = null ) — 携带的参数。
| |
once:Boolean (default = true ) — 是否只执行一次,如果为true,回调后执行recover()进行回收,默认为true。
|
Handler — 返回创建的handler实例。
|
recover | () | method |
public function recover():void
清理并回收到 Handler 对象池内。
run | () | method |
public function run():*
执行处理器。
Returns* |
runWith | () | method |
public function runWith(data:*):*
执行处理器,携带额外数据。
Parameters
data:* — 附加的回调数据,可以是单数据或者Array(作为多参)。
|
* |
setTo | () | method |
public function setTo(caller:*, method:Function, args:Array, once:Boolean):Handler
设置此对象的指定属性值。
Parameters
caller:* — 执行域(this)。
| |
method:Function — 回调方法。
| |
args:Array — 携带的参数。
| |
once:Boolean — 是否只执行一次,如果为true,执行后执行recover()进行回收。
|
Handler — 返回 handler 本身。
|