ScrollEvent

套件	fl.events
類別	public class ScrollEvent
繼承	ScrollEvent Event Object

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

ScrollEvent 類別會定義與 ScrollBar 組件有關聯的 scroll 事件。

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		bubbles : Boolean [唯讀] 指出事件是否為反昇事件。	Event
		cancelable : Boolean [唯讀] 指出是否可避免與事件相關聯的行為指令。	Event
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		currentTarget : Object [唯讀] 正主動使用事件偵聽程式處理 Event 物件的物件。	Event
		delta : Number [唯讀] 會取得捲動位置變更的大小，以像素為單位。	ScrollEvent
		direction : String [唯讀] 會取得常數值，指出與事件相關聯的移動方向。	ScrollEvent
		eventPhase : uint [唯讀] 事件流程中的目前階段。	Event
		position : Number [唯讀] 會取得目前的捲動位置，以像素為單位。	ScrollEvent
		target : Object [唯讀] 事件目標。	Event
		type : String [唯讀] 事件類型。	Event

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		ScrollEvent(direction:String, delta:Number, position:Number) 以指定的參數建立新的 ScrollEvent 物件。	ScrollEvent
		clone():Event [覆寫] 建立 ScrollEvent 物件的副本，並設定每個參數的值以符合原始物件的參數值。	ScrollEvent
		formatToString(className:String, ... arguments):String 公用程式函數，可用來實作自訂 ActionScript 3.0 Event 類別中的 toString() 方法。	Event
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isDefaultPrevented():Boolean 檢查是否已經對事件呼叫 preventDefault() 方法。	Event
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		preventDefault():void 如果可以取消事件的預設行為指令，則取消該行為指令。	Event
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		stopImmediatePropagation():void 避免處理事件流程中，目前節點以及任何後續節點中的任何事件偵聽程式。	Event
		stopPropagation():void 避免處理接續在事件流程中的目前節點之後，後續節點中的任何事件偵聽程式。	Event
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String [覆寫] 會傳回包含 ScrollEvent 物件所有屬性的字串。	ScrollEvent
		valueOf():Object 會傳回指定之物件的基本值。	Object

公用常數

隱藏繼承公用常數

顯示繼承公用常數

	常數		定義自
		SCROLL : String = "scroll" [靜態] 定義 scroll 事件物件的 type 屬性值。	ScrollEvent

屬性詳細資訊

delta

屬性

delta:Number [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會取得捲動位置變更的大小，以像素為單位。正值表示向下或向右捲動；負值則表示向上或向左捲動。

實作
public function get delta():Number

direction

屬性

direction:String [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會取得常數值，指出與事件相關聯的移動方向。值為 ScrollBarDirection.HORIZONTAL 表示水平移動；值為 ScrollBarDirection.VERTICAL 則表示垂直移動。

實作
public function get direction():String

相關 API 元素

fl.controls.ScrollBarDirection

position

屬性

position:Number [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會取得目前的捲動位置，以像素為單位。

實作
public function get position():Number

建構函式詳細資料

()

建構函式

public function ScrollEvent(direction:String, delta:Number, position:Number)

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

以指定的參數建立新的 ScrollEvent 物件。

參數

	`direction:String` — 與事件相關聯的移動方向。值為 `ScrollBarDirection.HORIZONTAL` 表示水平移動；值為 `ScrollBarDirection.VERTICAL` 則表示垂直移動。

	`delta:Number` — 捲動位置的變更，以像素為單位。正值表示向下或向右捲動；負值則表示向上或向左捲動。

	`position:Number` — 目前的捲動位置。

方法詳細資訊

clone

()

方法

override public function clone():Event

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

建立 ScrollEvent 物件的副本，並設定每個參數的值以符合原始物件的參數值。

傳回值

Event — 新的 ScrollEvent 物件，其參數值符合原始物件的參數值。

toString

()

方法

override public function toString():String

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會傳回包含 ScrollEvent 物件所有屬性的字串。此字串的格式如下：

[ ScrollEvent type= value bubbles= value cancelable= value direction= value delta= value position= value ]

傳回值

String — ScrollEvent 物件的字串形式。

常數詳細資訊

SCROLL

常數

public static const SCROLL:String = "scroll"

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

定義 scroll 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`delta`	`1`，指出捲動了多少距離的值。
`direction`	`vertical`，ScrollBar 的方向。
`position`	`0`，捲軸縮圖移動後所在的位置。
`target`	已經傳送該事件的物件。此目標不一定是偵聽該事件的物件。您可以使用 `currentTarget` 屬性，存取目前正在偵聽該事件的物件。

範例 ( 如何使用本範例 )

下列範例會偵聽 scroll 事件，並使用 ScrollEvent 類別的 direction 屬性，判斷是以水平或垂直方向捲動內容：


import fl.containers.ScrollPane;
import fl.events.ScrollEvent;
import fl.controls.ScrollBarDirection;

var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.scrollDrag = true;
myScrollPane.source = "http://www.helpexamples.com/flash/images/image1.jpg";
myScrollPane.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myScrollPane);

function scrollHandler(event:ScrollEvent):void {
    switch (event.direction) {
        case ScrollBarDirection.HORIZONTAL:
            trace("horizontal scroll", event.position, "of", event.currentTarget.maxHorizontalScrollPosition);
            break;
        case ScrollBarDirection.VERTICAL:
            trace("vertical scroll", event.position, "of", event.currentTarget.maxVerticalScrollPosition);
            break;
    }
}

法律聲明 | 線上隱私權政策

ScrollEvent - AS3 Flash

類別 x

delta

direction

position

ScrollEvent

clone

toString

SCROLL