处理用户输入事件。可以添加自定义功能以在用户输入时执行。
Name | Type | Default | Description |
---|---|---|---|
element
|
HTMLCanvasElement |
document
|
可选 要添加事件的元素。 |
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 |
可选
发生
type
事件时持有的 KeyboardEventModifier 键。
|
Returns:
要在输入事件上执行的函数。
Returns:
如果此对象被销毁,则为
true
;否则,
false
。
删除要在输入事件上执行的函数。
Name | Type | Description |
---|---|---|
type
|
ScreenSpaceEventType | 输入事件的 ScreenSpaceEventType。 |
modifier
|
KeyboardEventModifier |
可选
发生
type
事件时持有的 KeyboardEventModifier 键。
|
设置要在输入事件上执行的功能。
Name | Type | Description |
---|---|---|
action
|
ScreenSpaceEventHandler.PositionedEventCallback | ScreenSpaceEventHandler.MotionEventCallback | ScreenSpaceEventHandler.WheelEventCallback | ScreenSpaceEventHandler.TwoPointEventCallback | ScreenSpaceEventHandler.TwoPointMotionEventCallback | 当输入事件发生时要执行的函数。 |
type
|
ScreenSpaceEventType | 输入事件的 ScreenSpaceEventType。 |
modifier
|
KeyboardEventModifier |
可选
发生
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 | 鼠标滚轮移动的量 |