处理用户输入事件。可以添加自定义函数,
在用户输入时执行。
| Name | Type | Default | Description |
|---|---|---|---|
element |
HTMLCanvasElement |
document
|
optional 要添加事件的元素。 |
Members
接收到任何触摸事件后,鼠标事件将被禁用的时长(以毫秒为单位),
以便任何模拟的鼠标事件都将被忽略。
-
Default Value:
800
屏幕上的触摸持续时长(以毫秒为单位),之后变为
触摸并按住。
-
Default Value:
1500
Methods
移除此对象持有的侦听器。
对象一旦被销毁,就不应再使用;调用除
对象一旦被销毁,就不应再使用;调用除
isDestroyed以外的任何函数都将导致DeveloperError异常。因此,
如示例所示,将返回值(undefined)分配给对象。
Throws:
-
DeveloperError : 此对象已被销毁,即已调用destroy()。
Example:
handler = handler && handler.destroy();
See:
getInputAction(type, modifier) → ScreenSpaceEventHandler.PositionedEventCallback|ScreenSpaceEventHandler.MotionEventCallback|ScreenSpaceEventHandler.WheelEventCallback|ScreenSpaceEventHandler.TwoPointEventCallback|ScreenSpaceEventHandler.TwoPointMotionEventCallback
返回要在输入事件上执行的函数。
| Name | Type | Description |
|---|---|---|
type |
ScreenSpaceEventType | 输入事件的ScreenSpaceEventType。 |
modifier |
KeyboardEventModifier |
optional
当type事件发生时按住的KeyboardEventModifier键。 |
Returns:
要在输入事件上执行的函数。
Returns:
如果此对象已被销毁则为
true;否则为false。
移除要在输入事件上执行的函数。
| Name | Type | Description |
|---|---|---|
type |
ScreenSpaceEventType | 输入事件的ScreenSpaceEventType。 |
modifier |
KeyboardEventModifier |
optional
当type事件发生时按住的KeyboardEventModifier键。 |
设置要在输入事件上执行的函数。
| Name | Type | Description |
|---|---|---|
action |
ScreenSpaceEventHandler.PositionedEventCallback | ScreenSpaceEventHandler.MotionEventCallback | ScreenSpaceEventHandler.WheelEventCallback | ScreenSpaceEventHandler.TwoPointEventCallback | ScreenSpaceEventHandler.TwoPointMotionEventCallback | 当输入事件发生时执行的函数。 |
type |
ScreenSpaceEventType | 输入事件的ScreenSpaceEventType。 |
modifier |
KeyboardEventModifier |
optional
当type事件发生时按住的KeyboardEventModifier键。 |
Type Definitions
从一个位置开始并在另一个位置结束的事件。
Properties:
| Name | Type | Description |
|---|---|---|
startPosition |
Cartesian2 | 起始位置 |
endPosition |
Cartesian2 | 结束位置 |
| Name | Type | Description |
|---|---|---|
event |
ScreenSpaceEventHandler.MotionEvent | 触发侦听器的事件 |
在屏幕上单个位置发生的事件。
Properties:
| Name | Type | Description |
|---|---|---|
position |
Cartesian2 | 位置 |
| Name | Type | Description |
|---|---|---|
event |
ScreenSpaceEventHandler.PositionedEvent | 触发侦听器的事件 |
在屏幕上两个位置发生的事件。
Properties:
| Name | Type | Description |
|---|---|---|
position1 |
Cartesian2 | 第一个位置 |
position2 |
Cartesian2 | 第二个位置 |
| Name | Type | Description |
|---|---|---|
event |
ScreenSpaceEventHandler.TwoPointEvent | 触发监听器的事件 |
在屏幕上两个位置开始并移动到另外两个位置的事件。
Properties:
| Name | Type | Description |
|---|---|---|
position1 |
Cartesian2 | 第一个位置 |
position2 |
Cartesian2 | 第二个位置 |
previousPosition1 |
Cartesian2 | 第一个先前位置 |
previousPosition2 |
Cartesian2 | 第二个先前位置 |
| Name | Type | Description |
|---|---|---|
event |
ScreenSpaceEventHandler.TwoPointMotionEvent | 触发监听器的事件 |
| Name | Type | Description |
|---|---|---|
delta |
number | 鼠标滚轮移动的量 |
