套件 | fl.events |
類別 | public class ListEvent |
繼承 | ListEvent Event Object |
子類別 | DataGridEvent |
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
-
ListEvent.ITEM_CLICK
:在使用者以滑鼠按一下組件中的項目之後傳送。 -
ListEvent.ITEM_DOUBLE_CLICK
:在使用者以滑鼠連續兩次快速按下組件中的項目之後傳送。 -
ListEvent.ITEM_ROLL_OUT
:在使用者的滑鼠指標滑出組件中某個項目之後傳送。 -
ListEvent.ITEM_ROLL_OVER
:在使用者的滑鼠指標滑入組件中某個項目之後傳送。
相關 API 元素
公用屬性
屬性 | 定義自 | ||
---|---|---|---|
bubbles : Boolean [唯讀]
指出事件是否為反昇事件。 | Event | ||
cancelable : Boolean [唯讀]
指出是否可避免與事件相關聯的行為指令。 | Event | ||
columnIndex : int [唯讀]
會取得與此事件相關聯之項目的欄索引。 | ListEvent | ||
constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | ||
currentTarget : Object [唯讀]
正主動使用事件偵聽程式處理 Event 物件的物件。 | Event | ||
eventPhase : uint [唯讀]
事件流程中的目前階段。 | Event | ||
index : int [唯讀]
會取得包含輸出器之儲存格的索引 (從零開始)。 | ListEvent | ||
item : Object [唯讀]
會取得屬於目前儲存格輸出器的資料。 | ListEvent | ||
rowIndex : Object [唯讀]
會取得與此事件相關聯之項目的列索引。 | ListEvent | ||
target : Object [唯讀]
事件目標。 | Event | ||
type : String [唯讀]
事件類型。 | Event |
公用方法
方法 | 定義自 | ||
---|---|---|---|
ListEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, index:int = -1, item:Object = null)
以指定的參數建立新的 ListEvent 物件。 | ListEvent | ||
[覆寫]
建立 ListEvent 物件的副本,並設定每個參數的值以符合原始物件的參數值。 | ListEvent | ||
公用程式函數,可用來實作自訂 ActionScript 3.0 Event 類別中的 toString() 方法。 | Event | ||
指出物件是否有已定義的指定屬性。 | Object | ||
檢查是否已經對事件呼叫 preventDefault() 方法。 | Event | ||
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | ||
如果可以取消事件的預設行為指令,則取消該行為指令。 | Event | ||
指出指定的屬性是否存在,以及是否可列舉。 | Object | ||
為迴圈作業設定動態屬性的可用性。 | Object | ||
避免處理事件流程中,目前節點以及任何後續節點中的任何事件偵聽程式。 | Event | ||
避免處理接續在事件流程中的目前節點之後,後續節點中的任何事件偵聽程式。 | Event | ||
傳回代表此物件的字串,根據地區特定慣例進行格式化。 | Object | ||
[覆寫]
會傳回包含 ListEvent 物件所有屬性的字串。 | ListEvent | ||
會傳回指定之物件的基本值。 | Object |
公用常數
常數 | 定義自 | ||
---|---|---|---|
ITEM_CLICK : String = "itemClick" [靜態]
會定義 itemClick 事件物件的 type 屬性值。 | ListEvent | ||
ITEM_DOUBLE_CLICK : String = "itemDoubleClick" [靜態]
會定義 itemDoubleClick 事件物件的 type 屬性值。 | ListEvent | ||
ITEM_ROLL_OUT : String = "itemRollOut" [靜態]
會定義 itemRollOut 事件物件的 type 屬性值。 | ListEvent | ||
ITEM_ROLL_OVER : String = "itemRollOver" [靜態]
會定義 itemRollOver 事件物件的 type 屬性值。 | ListEvent |
屬性詳細資訊
columnIndex | 屬性 |
index | 屬性 |
item | 屬性 |
rowIndex | 屬性 |
建構函式詳細資料
ListEvent | () | 建構函式 |
public function ListEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, index:int = -1, item:Object = null)
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
以指定的參數建立新的 ListEvent 物件。
參數type:String — 事件類型,這個值會識別導致此事件的動作。
| |
bubbles:Boolean (default = false ) — 會指出此事件是否能反昇顯示清單階層。
| |
cancelable:Boolean (default = false ) — 指出是否可避免與事件相關聯的行為指令。
| |
columnIndex:int (default = -1 ) — 從零開始的欄索引,該欄包含輸出器或欄中資料的視覺呈現形式。
| |
rowIndex:int (default = -1 ) — 從零開始的列索引,該列包含輸出器或列中資料的視覺呈現形式。
| |
index:int (default = -1 ) — DataProvider 中項目的索引 (從零開始)。
| |
item:Object (default = null ) — 屬於輸出器之資料的參考。
|
方法詳細資訊
clone | () | 方法 |
toString | () | 方法 |
常數詳細資訊
ITEM_CLICK | 常數 |
public static const ITEM_CLICK:String = "itemClick"
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會定義 itemClick
事件物件的 type
屬性值。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | false |
cancelable | true |
columnIndex | 包含輸出器的欄索引 (從零開始)。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
index | DataProvider (包含輸出器) 中從零開始的索引。 |
item | 屬於輸出器之資料的參考。 |
rowIndex | 包含輸出器的列索引 (從零開始)。 |
target | 已經傳送該事件的物件。 此目標不一定是偵聽該事件的物件。 您可以使用 currentTarget 屬性,存取目前正在偵聽該事件的物件。 |
ITEM_DOUBLE_CLICK | 常數 |
public static const ITEM_DOUBLE_CLICK:String = "itemDoubleClick"
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會定義 itemDoubleClick
事件物件的 type
屬性值。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | false |
cancelable | true |
columnIndex | 包含輸出器的欄索引 (從零開始)。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
index | DataProvider (包含輸出器) 中從零開始的索引。 |
item | 屬於輸出器之資料的參考。 |
rowIndex | 包含輸出器的列索引 (從零開始)。 |
target | 已經傳送該事件的物件。 此目標不一定是偵聽該事件的物件。 您可以使用 currentTarget 屬性,存取目前正在偵聽該事件的物件。 |
ITEM_ROLL_OUT | 常數 |
public static const ITEM_ROLL_OUT:String = "itemRollOut"
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會定義 itemRollOut
事件物件的 type
屬性值。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | false |
cancelable | false ;沒有要取消的預設行為指令。 |
columnIndex | 包含輸出器的欄索引 (從零開始)。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
index | DataProvider (包含輸出器) 中從零開始的索引。 |
item | 屬於輸出器之資料的參考。 |
rowIndex | 包含輸出器的列索引 (從零開始)。 |
target | 已經傳送該事件的物件。 此目標不一定是偵聽該事件的物件。 您可以使用 currentTarget 屬性,存取目前正在偵聽該事件的物件。 |
相關 API 元素
ITEM_ROLL_OVER | 常數 |
public static const ITEM_ROLL_OVER:String = "itemRollOver"
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會定義 itemRollOver
事件物件的 type
屬性值。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | false |
cancelable | false ;沒有要取消的預設行為指令。 |
columnIndex | 包含輸出器的欄索引 (從零開始)。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
index | DataProvider (包含輸出器) 中從零開始的索引。 |
item | 屬於輸出器之資料的參考。 |
rowIndex | 包含輸出器的列索引 (從零開始)。 |
target | 已經傳送該事件的物件。 此目標不一定是偵聽該事件的物件。 您可以使用 currentTarget 屬性,存取目前正在偵聽該事件的物件。 |
相關 API 元素
範例 如何使用本範例
ListEventExample.as
此範例將示範如何使用 ListEvent 類別,判斷資料格中某個項目的列與欄。
- 將 DataGrid 組件加入元件庫。
- 將這個程式碼儲存成 ListEventExample.as,並與您的 FLA 存放在相同的目錄中。
- 將 FLA 中的 DocumentClass 設定為 ListEventExample。
package { import flash.display.Sprite; import fl.data.DataProvider; import fl.controls.DataGrid; import fl.events.ListEvent; public class ListEventExample extends Sprite { private var dg:DataGrid; public function ListEventExample() { createDataGrid(); } private function createDataGrid():void { dg = new DataGrid(); addChild(dg); dg.setSize(200,300); var dp:DataProvider = new DataProvider(); var i:uint; var totalRows:uint = 42; for(i=0; i<totalRows; i++) { dp.addItem( { col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber() } ); } dg.dataProvider = dp; dg.addEventListener(ListEvent.ITEM_ROLL_OVER, declarePosition); } private function declarePosition(e:ListEvent):void { trace("You are above row: " + e.rowIndex + " column: " + e.columnIndex); } private function getRandomNumber():uint { return Math.round(Math.random()*100); } } }
Tue Jun 12 2018, 03:47 PM Z