你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
处理映像事件
本文介绍如何使用地图事件类。 该属性突出显示地图上以及地图的不同层上的事件。 还可以在与 HTML 标记交互时突出显示事件。
地图事件示例突出显示了与地图交互时触发的事件的名称。 有关此示例的源代码,请参阅映射事件源代码。
图层事件示例突出显示了与符号图层交互时触发的事件的名称。 符号、气泡、线条和多边形层都支持同一组事件。 热度地图和图块层不支持其中任何事件。 有关此示例的源代码,请参阅图层事件源代码。
HTML 标记层事件示例突出显示了与 HTML 标记层交互时触发的事件的名称。 有关此示例的源代码,请参阅 HTML 标记层事件源代码。
下表列出了所有受支持的地图类事件。
事件 | 说明 |
---|---|
boxzoomend |
在“框缩放”交互结束时触发。 |
boxzoomstart |
在“框缩放”交互开始时触发。 |
click |
在地图上的同一点按下并释放指针设备时触发。 |
close |
在通过手动或编程方式关闭弹出窗口时触发。 |
contextmenu |
在单击鼠标右键时触发。 |
data |
在加载或更改任何地图数据时触发。 |
dataadded |
在将形状添加到 DataSource 时触发。 |
dataremoved |
在从 DataSource 中移除形状时触发。 |
datasourceupdated |
在更新 DataSource 对象时触发。 |
dblclick |
在地图上的同一点单击指针设备两次时触发。 |
drag |
在地图、弹出窗口或 HTML 标记上进行“拖动以平移”交互期间反复触发。 |
dragend |
在地图、弹出窗口或 HTML 标记上的“拖动以平移”交互结束时触发。 |
dragstart |
在地图、弹出窗口或 HTML 标记上的“拖动以平移”交互开始时触发。 |
error |
在发生错误时触发。 |
idle |
在地图进入“空闲”状态之前呈现的最后一帧之后触发:
|
keydown |
在按下某个键时触发。 |
keypress |
在按下生成可键入字符的键(ANSI 键)时触发。 |
keyup |
在松开某个键时触发。 |
layeradded |
在向地图添加层时触发。 |
layerremoved |
在从地图移除层时触发。 |
load |
在下载了所有必需的资源并进行了第一次视觉上完整的地图呈现后立即触发。 |
mousedown |
在地图内按下指针设备时或在指针设备位于元素顶部时触发。 |
mouseenter |
在指针设备最初移到地图或元素上时触发。 |
mouseleave |
在指针设备移出地图或元素时触发。 |
mousemove |
在指针设备于地图或元素内移动时触发。 |
mouseout |
在指针设备离开地图画布或离开元素时触发。 |
mouseover |
在指针设备移到地图或元素上时触发。 |
mouseup |
在指针设备于地图内释放或位于元素顶部时触发。 |
move |
因用户交互或方法而在从一个视图到另一个视图的动画过渡期间反复触发。 |
moveend |
因用户交互或方法而在地图完成从一个视图过渡到另一个视图后触发。 |
movestart |
因用户交互或方法而在地图开始从一个视图过渡到另一个视图前触发。 |
open |
在通过手动或编程方式打开弹出窗口时触发。 |
pitch |
因用户交互或方法而在地图的俯仰角(倾斜度)每次更改时触发。 |
pitchend |
因用户交互或方法而在地图的俯仰角(倾斜度)完成更改后立即触发。 |
pitchstart |
因用户交互或方法而在地图的俯仰角(倾斜度)每次开始更改时触发。 |
ready |
在地图准备好以编程方式进行交互前就加载了所需的最少地图资源时触发。 |
render |
出于以下原因而在地图每次绘制到屏幕上时触发:
|
resize |
在调整地图大小后立即触发。 |
rotate |
在“拖动以旋转”交互期间反复触发。 |
rotateend |
在“拖动以旋转”交互结束时触发。 |
rotatestart |
在“拖动以旋转”交互开始时触发。 |
shapechanged |
在更改形状对象属性时触发。 |
sourcedata |
在其中一个地图源加载或更改时触发,包括属于某个源的图块加载或更改的情况。 |
sourceadded |
在向地图添加 DataSource 或 VectorTileSource 时触发。 |
sourceremoved |
在从地图移除 DataSource 或 VectorTileSource 时触发。 |
styledata |
在加载或更改地图的样式时触发。 |
styleimagemissing |
在层尝试从不存在的图像子画面加载图像时触发 |
tokenacquired |
在获得 Microsoft Entra 访问令牌时触发。 |
touchcancel |
在地图中发生 touchcancel 事件时触发。 |
touchend |
在地图中发生 touchend 事件时触发。 |
touchmove |
在地图中发生 touchmove 事件时触发。 |
touchstart |
在地图中发生 touchstart 事件时触发。 |
wheel |
在地图中发生鼠标滚轮事件时触发。 |
zoom |
因用户交互或方法而在从一个缩放级别到另一个缩放级别的动画过渡期间反复触发。 |
zoomend |
因用户交互或方法而在地图完成从一个缩放级别过渡到另一缩放级别后触发。 |
zoomstart |
因用户交互或方法而在地图开始从一个缩放级别过渡到另一个缩放级别前触发。 |
有关完整代码示例,请参阅以下文章: