events标签:事件监听标签,各属性可在各种场景事件,鼠标事件等发生时执行自定义动作。
领主提醒:该标签比较重要,无论各种效果和程序调试,都需要使用该标签相关属性。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27
|
<events onenterfullscreen="" onexitfullscreen="" onxmlcomplete="" onpreviewcomplete="" onloadcomplete="" onnewpano="" onremovepano="" onnewscene="" onloaderror="" onkeydown="" onkeyup="" onclick="" onsingleclick="" ondoubleclick="" onmousedown="" onmouseup="" onmousewheel="" oncontextmenu="" onidle="" onviewchange="" onviewchanged="" onresize="" onautorotatestart="" onautorotatestop="" onautorotateoneround="" onautorotatechange="" /> |
|
增加命名,设置独立事件响应,这样做的作用是保证事件可以独立执行,不用担心被events全局(events未命名的均为全局)事件相同属性覆盖而导致无法执行。 <events name="..." keep="false" ... any events ... /> |
属性名称
|
变量全称
|
类型
|
默认值
|
name
|
events[...].name
|
String
|
|
-
当定义名称后,该事件将成为一个独立的本地事件的元素.
-
没名字默认为全局事件.
|
|
|
|
|
keep
|
events[...].keep
|
Boolean
|
false
|
|
|
|
|
|
onenterfullscreen
|
events.onenterfullscreen
|
Action Event
|
|
|
|
|
|
|
onexitfullscreen
|
events.onexitfullscreen
|
Action Event
|
|
|
|
|
|
|
onxmlcomplete
|
events.onxmlcomplete
|
Action Event
|
|
-
设置当正在读取XML场景文件时执行的动作.
-
执行动作后,再动态加载场景图像.
|
|
|
|
|
onpreviewcomplete
|
events.onpreviewcomplete
|
Action Event
|
|
|
|
|
|
|
onloadcomplete
|
events.onloadcomplete
|
Action Event
|
|
-
设置场景图像读取完成后执行的动作.
-
当使用多图切片模式时,该事件动作将在所有当前图像读取完成后执行一次.
|
|
|
|
|
onnewpano
|
events.onnewpano
|
Action Event
|
|
|
|
|
|
|
onremovepano
|
events.onremovepano
|
Action Event
|
|
-
设置当移除当前全景前执行的动作,动作将在新场景加载前执行.
|
|
|
|
|
onnewscene
|
events.onnewscene
|
Action Event
|
|
|
|
|
|
|
onloaderror
|
events.onloaderror
|
Action Event
|
|
-
设置读取错误时执行的动作.
-
错误信息将被存放于lasterror属性中.
-
该事件设置后,错误信息将不显示于前台.
|
|
|
|
|
onkeydown
|
events.onkeydown
|
Action Event
|
|
-
当键盘按下时执行的动作.
-
按下的keycode将被存放于keycode属性.
-
当长按键盘某键时,该事件将重复执行. 这个可以在thecontrol.keydownrepeat设置进行控制.
|
|
|
|
|
onkeyup
|
events.onkeyup
|
Action Event
|
|
-
设置当某个按钮释放时执行的动作.
-
keycode将被存放于keycode属性.
|
|
|
|
|
onclick
|
events.onclick
|
Action Event
|
|
|
|
|
|
|
onsingleclick
ondoubleclick
|
events.onsingleclick
events.ondoubleclick
|
Action Event
Action Event
|
|
-
点击鼠标和双击鼠标执行的动作(领主tips: 双击早前需要插件支持).
-
单击与onclick有区域在于点击事件可以 (up to ~400ms) ,用于区别于双击事件.
-
There can be either:
-
One single-click event (延迟释放比onclick).
-
Two single-click events - 两次单击为第二次点击有位移.
-
One double-click event - 双击监测,快速点击且两次点击位移很小.
-
-
mouse.clickx and mouse.clicky 变量存储鼠标在最后一次单击发生时的坐标.
-
上述事件在触摸屏移动设备上均支持.
|
|
|
|
|
onmousedown
|
events.onmousedown
|
Action Event
|
|
|
|
|
|
|
onmouseup
|
events.onmouseup
|
Action Event
|
|
|
|
|
|
|
onmousewheel
|
events.onmousewheel
|
Action Event
|
|
-
当鼠标滚轮执行转动时执行的动作.
-
鼠标滚轮增量将被存放于wheeldelta 和 wheeldelta_raw 变量中.
-
移动设备触屏手势缩放操作时该事件同样可以检测. wheeldelta变量将设置为正或负值取决于放大或缩小. wheeldelta_touchscale 变量, 在这种情况下,将提供关于手势放大的更详细的信息.
|
|
|
|
|
oncontextmenu
|
events.oncontextmenu
|
Action Event
|
|
|
|
|
|
|
onidle
|
events.onidle
|
Action Event
|
|
|
|
|
|
|
onviewchange
|
events.onviewchange
|
Action Event
|
|
-
当场景视角被改变或画面发送新的渲染或重绘时,执行的动作.
-
限制视角时该事件监听不执行. 这意味着在这种情况下,仍然可以在最终呈现之前对视图进行更改.
-
领主Note - 由于监听频繁,使用该事件不要执行太多耗内存的动作或显示太多对象,否则会变慢或crash
|
|
|
|
|
onviewchanged
|
events.onviewchanged
|
Action Event
|
|
当场景视角已被改变或画面已完成新的渲染或重绘时, 执行的动作.
-
领主Note - 由于监听频繁,使用该事件不要执行太多耗内存的动作或显示太多对象,否则会变慢或crash
|
|
|
|
|
onresize
|
events.onresize
|
Action Event
|
|
-
当浏览器屏幕大小发生变化 (或显示区域大小)已经发生变化时执行的动作.
-
在加载新全景图时,该事件均自动执行.
-
改变后浏览器的大小将被存放于 stagewidth and stageheight 变量中.
-
改变后的显示区域大小将被存放于area.pixelwidth andarea.pixelheight变量中.
|
|
|
|
|
onautorotatestart
|
events.onautorotatestart
|
Action Event
|
|
|
|
|
|
|
onautorotatestop
|
events.onautorotatestop
|
Action Event
|
|
-
当自动旋转停止时执行的动作.
-
通常是用户操作导致中断或程序控制停止旋转.
-
可以记录下当前状态,在启动旋转时恢复.
|
|
|
|
|
onautorotateoneround
|
events.onautorotateoneround
|
Action Event
|
|
-
该事件执行条件:
-
1、完成一圈360度旋转(for 360x* panos),
-
2、左到右的旋转一次.
-
可以用于自动跳转漫游,自动跳到下一场景 - e.g. for 'automatic tours'. 官方这个案例,在自动漫游时,可以用 KEEPMOVING 标记切换场景.
|
|
|
|
|
onautorotatechange
|
events.onautorotatechange
|
Action Event
|
|
-
当自动旋转中设定被修改时执行的动作.
-
可以用于更新控制自动旋转的按钮状态.
|
㊣ 凡未注明来源或投稿方的文章,皆为本站原创或原译作品,转载前须经本站同意,并在转载时注明来自 域图新视界 victu360.com,否则将追究相关法律责任。本文标题:《events标签说明—krpano教程》