ScrollPane.scroll

可用性

Flash Player 6.0.79。

版本

Flash MX 2004。

用法

用法 1:

on(scroll){
  ...
}

用法 2:

listenerObject = new Object();
listenerObject.scroll = function(eventObject){
  ...
}
scrollPaneInstance.addEventListener("scroll", listenerObject)

事件对象

除了标准的事件对象属性之外,还有一个为 scroll 事件定义的 type 属性,其值为 "scroll"。另外还有一个 direction 属性,其可能值为 "vertical""horizontal"

描述

事件;当用户按下滚动条按钮、滑块或轨道时,向所有已注册的侦听器广播。与其他事件不同的是,当用户按下滚动条时,scroll 事件开始持续广播,直到用户松开滚动条。

第一个用法范例使用一个 on() 处理函数,并且必须直接附加到 ScrollPane 组件实例。附加到组件的 on() 处理函数内部使用的关键字 this 是指该组件实例。例如,下面附加到实例 sp 的代码将“_level0.sp”发送到“输出”面板:

on(scroll){
  trace(this);
}

第二个用法范例使用一个调度程序/侦听器事件模型。组件实例 (scrollPaneInstance) 调度一个事件(在本例中为 scroll),而该事件由附加到您创建的侦听器对象 (listenerObject) 的函数处理。您定义一个与侦听器对象上的事件同名的方法;当该事件被触发时,就会调用该方法。该事件被触发时,它会自动将一个事件对象 (eventObject) 传递到侦听器对象方法。每个事件对象都有一组属性,这些属性包含有关该事件的信息。您可以使用这些属性来编写处理该事件的代码。最后,对广播该事件的组件实例调用 UIEventDispatcher.addEventListener() 方法,以将侦听器注册到实例。当该实例调度该事件时,就会调用该侦听器。

有关事件对象的详细信息,请参阅事件对象

范例

该范例创建一个具有 scroll 回调函数的 form 侦听器对象,该侦听器对象注册到 spInstance 实例:您必须为 spInstance 填写内容,如下所示:

spInstance.contentPath = "mouse3.jpg";
form = new Object(); 
form.scroll = function(eventObj){
  trace("ScrollPane scrolled");
}
spInstance.addEventListener("scroll", form);

另请参见

UIEventDispatcher.addEventListener()