Paket | fl.events |
Klass | public class DataGridEvent |
Arv | DataGridEvent ListEvent Event Object |
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
-
DataGridEvent.COLUMN_STRETCH
: skickas när en användare ändrar storlek på en kolumn vågrätt. -
DataGridEvent.HEADER_RELEASE
: skickas när användaren klickar med musen på en kolumnrubrik. -
DataGridEvent.ITEM_EDIT_BEGIN
: skickas när ett objekt är klart för redigering -
DataGridEvent.ITEM_EDIT_BEGINNING
: skickas när användaren har förberett redigering av ett objekt, det anges t.ex. genom att användaren släpper musknappen när muspekaren befinner sig över objektet. -
DataGridEvent.ITEM_EDIT_END
: skickas när en redigeringssession är slut. -
DataGridEvent.ITEM_FOCUS_IN
: skickas när ett objekt sätts i fokus. -
DataGridEvent.ITEM_FOCUS_OUT
: skickas när ett objekt tas ur fokus.
Relaterade API-element
Egenskap | Definieras med | ||
---|---|---|---|
bubbles : Boolean [skrivskyddad]
indikerar om händelsen är en bubblande händelse. | Event | ||
cancelable : Boolean [skrivskyddad]
Indikerar om beteendet som är kopplat till händelsen kan förhindras. | Event | ||
columnIndex : int [skrivskyddad]
Hämtar kolumnindexvärdet för det objekt som är associerat med händelsen. | ListEvent | ||
constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | ||
currentTarget : Object [skrivskyddad]
Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. | Event | ||
dataField : String
Hämtar eller ställer in namnet på fältet eller egenskapen i data som är associerat till kolumnen. | DataGridEvent | ||
eventPhase : uint [skrivskyddad]
Den nuvarande fasen i händelseflödet. | Event | ||
index : int [skrivskyddad]
Hämtar det nollbaserade indexvärdet för cellen med återgivaren. | ListEvent | ||
item : Object [skrivskyddad]
Hämtar de data som hör till den aktuella cellåtergivaren. | ListEvent | ||
itemRenderer : Object [skrivskyddad]
Hämtar objektåtergivaren för objektet som redigeras eller rubrikåtergivaren som användaren klickar på eller ändrar storlek på. | DataGridEvent | ||
reason : String [skrivskyddad]
Hämtar anledningen till att itemEditEnd-händelsen skickades. | DataGridEvent | ||
rowIndex : Object [skrivskyddad]
Hämtar radindexvärdet för det objekt som är associerat med händelsen. | ListEvent | ||
target : Object [skrivskyddad]
Händelsens mål. | Event | ||
type : String [skrivskyddad]
Händelsens typ. | Event |
Metod | Definieras med | ||
---|---|---|---|
DataGridEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, itemRenderer:Object = null, dataField:String = null, reason:String = null)
Skapar ett nytt DataGridEvent-objekt med de angivna parametrarna. | DataGridEvent | ||
[åsidosätt]
Skapar en kopia av DataGridEvent-objektet och ställer in värdet för varje egenskap så att det matchar originalet. | DataGridEvent | ||
Ett verktyg som används för att implementera metoden toString() i de anpassade klasserna ActionScript 3.0. | Event | ||
Anger om det finns en egenskap angiven för ett objekt. | Object | ||
Kontrollerar om preventDefault()-metoden har anropats för händelsen. | Event | ||
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | ||
Avbryter en händelses standardbeteende om det beteendet kan avbrytas. | Event | ||
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | ||
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | ||
Förhindrar behandling av händelsehanterare i den aktuella noden och alla noder som följer den aktuella noden i händelseflödet. | Event | ||
Förhindrar behandling av händelsehanterare i noder som följer den aktuella noden i händelseflödet. | Event | ||
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | ||
[åsidosätt]
Returnerar en sträng som innehåller alla egenskaper i DataGridEvent-objektet. | DataGridEvent | ||
Returnerar det angivna objektets primitiva värde. | Object |
Konstant | Definieras med | ||
---|---|---|---|
COLUMN_STRETCH : String = "columnStretch" [statisk]
Konstanten DataGridEvent.COLUMN_STRETCH definierar värdet för columnStretch-händelseobjektets type-egenskap. | DataGridEvent | ||
HEADER_RELEASE : String = "headerRelease" [statisk]
Konstanten DataGridEvent.HEADER_RELEASE definierar värdet för headerRelease-händelseobjektets type-egenskap. | DataGridEvent | ||
ITEM_EDIT_BEGIN : String = "itemEditBegin" [statisk]
Konstanten DataGridEvent.ITEM_EDIT_BEGIN definierar värdet för ett itemEditBegin-händelseobjekts type-egenskap. | DataGridEvent | ||
ITEM_EDIT_BEGINNING : String = "itemEditBeginning" [statisk]
Konstanten DataGridEvent.ITEM__EDIT_BEGINNING definierar värdet för ett itemEditBeginning-händelseobjekts type-egenskap. | DataGridEvent | ||
ITEM_EDIT_END : String = "itemEditEnd" [statisk]
Konstanten DataGridEvent.ITEM_EDIT_END definierar värdet för ett itemEditEnd-händelseobjekts type-egenskap. | DataGridEvent | ||
ITEM_FOCUS_IN : String = "itemFocusIn" [statisk]
Konstanten DataGridEvent.ITEM_FOCUS_IN definierar värdet för itemFocusIn-händelseobjektets type-egenskap. | DataGridEvent | ||
ITEM_FOCUS_OUT : String = "itemFocusOut" [statisk]
Konstanten DataGridEvent.ITEM_FOCUS_OUT definierar värdet för ett itemFocusOut-händelseobjekts type-egenskap. | DataGridEvent |
dataField | egenskap |
dataField:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Hämtar eller ställer in namnet på fältet eller egenskapen i data som är associerat till kolumnen.
Implementering
public function get dataField():String
public function set dataField(value:String):void
itemRenderer | egenskap |
itemRenderer:Object
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Hämtar objektåtergivaren för objektet som redigeras eller rubrikåtergivaren som användaren klickar på eller ändrar storlek på.
Implementering
public function get itemRenderer():Object
reason | egenskap |
reason:String
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Hämtar anledningen till att itemEditEnd
-händelsen skickades. Egenskapen är bara giltig för händelser av typen DataGridEvent.ITEM_EDIT_END
.
Möjliga värden är definierade i klassen DataGridEventReason.
Implementering
public function get reason():String
Relaterade API-element
DataGridEvent | () | Konstruktor |
public function DataGridEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, itemRenderer:Object = null, dataField:String = null, reason:String = null)
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Skapar ett nytt DataGridEvent-objekt med de angivna parametrarna.
Parametrartype:String — Händelsetyp; värdet anger vilken åtgärd som orsakade händelsen.
| |
bubbles:Boolean (default = false ) — Anger om händelsen kan bubbla upp i visningslistans hierarki.
| |
cancelable:Boolean (default = false ) — Indikerar om beteendet som är kopplat till händelsen kan förhindras.
| |
columnIndex:int (default = -1 ) — Det nollbaserade indexvärdet för kolumnen med återgivaren.
| |
rowIndex:int (default = -1 ) — Det nollbaserade indexvärdet för raden med återgivaren.
| |
itemRenderer:Object (default = null ) — Objektåtergivaren för objektet som redigeras eller rubrikåtergivaren som användaren klickar på eller drar ut.
| |
dataField:String (default = null ) — Namnet på fältet eller egenskapen i data som är associerat till kolumnen.
| |
reason:String (default = null ) — Anledningen till att itemEditEnd -händelsen skickades.
|
Relaterade API-element
clone | () | metod |
override public function clone():Event
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Skapar en kopia av DataGridEvent-objektet och ställer in värdet för varje egenskap så att det matchar originalet.
ReturnerarEvent — Ett nytt DataGridEvent-objekt med parametervärden som matchar originalet.
|
toString | () | metod |
override public function toString():String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Returnerar en sträng som innehåller alla egenskaper i DataGridEvent-objektet. Strängen är i följande format:
[DataGridEvent type=värde bubbles=värde cancelable=värde columnIndex=värde rowIndex=värde itemRenderer=värde dataField=värde reason=värde
]
String — En sträng som innehåller alla egenskaper i DataGridEvent-objektet.
|
COLUMN_STRETCH | Konstant |
public static const COLUMN_STRETCH:String = "columnStretch"
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Konstanten DataGridEvent.COLUMN_STRETCH
definierar värdet för columnStretch
-händelseobjektets type
-egenskap.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
columnIndex | Det nollbaserade indexet för kolumnrubriken i columns -arrayen i DataGrid-objektet. |
currentTarget | Det objekt som aktivt behandlar event-objektet med en händelseavlyssnare. |
dataField | Namnet på fältet eller egenskapen i data som är associerade med objektets kolumn. |
itemRenderer | Rubrikåtergivaren för den kolumn som sträcktes ut. |
reason | null |
rowIndex | Det nollbaserade indexet för objektet i DataProvider. |
target | Objektet som skickade händelsen. Målet är inte alltid det objekt som avlyssnar händelsen. Använd egenskapen currentTarget så kommer du åt det objekt som avlyssnar händelsen. |
Exempel ( Så här använder du exemplet )
columnStretch
-händelse avlyssnas:
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; import fl.events.DataGridEvent; var dp:DataProvider = new DataProvider(); dp.addItem({col1:"item 1.A", col2:"item 1.B", col3:"item 1.C"}); dp.addItem({col1:"item 2.A", col2:"item 2.B", col3:"item 2.C"}); dp.addItem({col1:"item 3.A", col2:"item 3.B", col3:"item 3.C"}); dp.addItem({col1:"item 4.A", col2:"item 4.B", col3:"item 4.C"}); var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn("col1"); myDataGrid.addColumn("col2"); myDataGrid.addColumn("col3"); myDataGrid.dataProvider = dp; myDataGrid.setSize(300, 200); myDataGrid.move(10, 10); myDataGrid.addEventListener(DataGridEvent.COLUMN_STRETCH, columnStretchHandler); addChild(myDataGrid); function columnStretchHandler(event:DataGridEvent):void { var dg:DataGrid = event.target as DataGrid; var column:DataGridColumn; var columnArray:Array = dg.columns; var dgColWidth:String; trace("resized column:", event.dataField); trace("columnIndex:", event.columnIndex); for each (column in columnArray) { dgColWidth = Number(column.width / dg.width * 100).toFixed(1); trace(column.dataField + ".width:", column.width + " pixels (" + dgColWidth + "%)"); } trace("----------"); }
HEADER_RELEASE | Konstant |
public static const HEADER_RELEASE:String = "headerRelease"
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Konstanten DataGridEvent.HEADER_RELEASE
definierar värdet för headerRelease
-händelseobjektets type
-egenskap.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
columnIndex | Det nollbaserade indexet för kolumnrubriken i columns -arrayen i DataGrid-objektet. |
currentTarget | Det objekt som aktivt behandlar event-objektet med en händelseavlyssnare. |
dataField | Namnet på fältet eller egenskapen i data som är associerade med objektets kolumn. |
itemRenderer | Den rubrikåtergivare som användaren klickade på. |
reason | null |
rowIndex | -1 |
target | Objektet som skickade händelsen. Målet är inte alltid det objekt som avlyssnar händelsen. Använd egenskapen currentTarget så kommer du åt det objekt som avlyssnar händelsen. |
Exempel ( Så här använder du exemplet )
headerRelease
-händelse avlyssnas:
import fl.controls.DataGrid; import fl.controls.dataGridClasses.DataGridColumn; import fl.data.DataProvider; import fl.events.DataGridEvent; var dp:DataProvider = new DataProvider(); dp.addItem({col1:"item 1.A", col2:"item 1.B", col3:"item 1.C"}); dp.addItem({col1:"item 2.A", col2:"item 2.B", col3:"item 2.C"}); dp.addItem({col1:"item 3.A", col2:"item 3.B", col3:"item 3.C"}); dp.addItem({col1:"item 4.A", col2:"item 4.B", col3:"item 4.C"}); var myDataGrid:DataGrid = new DataGrid(); myDataGrid.addColumn("col1"); myDataGrid.addColumn("col2"); myDataGrid.addColumn("col3"); myDataGrid.dataProvider = dp; myDataGrid.setSize(300, 200); myDataGrid.move(10, 10); myDataGrid.addEventListener(DataGridEvent.HEADER_RELEASE, headerReleaseHandler); addChild(myDataGrid); function headerReleaseHandler(event:DataGridEvent):void { var dg:DataGrid = event.target as DataGrid; trace("dataField:", event.dataField, "(columnIndex:" + event.columnIndex + ")"); trace("sortIndex:", dg.sortIndex); trace("sortDescending:", dg.sortDescending); trace("----------"); }
ITEM_EDIT_BEGIN | Konstant |
public static const ITEM_EDIT_BEGIN:String = "itemEditBegin"
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Konstanten DataGridEvent.ITEM__EDIT_BEGIN
definierar värdet för itemEditBegin
-händelseobjektets type
-egenskap.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
columnIndex | Det nollbaserade indexet för kolumnrubriken i columns -arrayen i DataGrid-objektet. |
currentTarget | Det objekt som aktivt behandlar event-objektet med en händelseavlyssnare. |
dataField | null |
itemRenderer | Objektåtergivaren för det objekt som ska redigeras. |
reason | null |
rowIndex | Det nollbaserade indexet för objektet i DataProvider. |
target | Objektet som skickade händelsen. Målet är inte alltid det objekt som avlyssnar händelsen. Använd egenskapen currentTarget så kommer du åt det objekt som avlyssnar händelsen. |
Relaterade API-element
ITEM_EDIT_BEGINNING | Konstant |
public static const ITEM_EDIT_BEGINNING:String = "itemEditBeginning"
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Konstanten DataGridEvent.ITEM__EDIT_BEGINNING
definierar värdet för itemEditBeginning
-händelseobjektets type
-egenskap.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
columnIndex | Det nollbaserade indexet för kolumnrubriken i columns -arrayen i DataGrid-objektet. |
currentTarget | Det objekt som aktivt behandlar event-objektet med en händelseavlyssnare. |
dataField | Namnet på fältet eller egenskapen i data som är associerade med objektets kolumn. |
itemRenderer | Objektåtergivaren för det objekt som ska redigeras. |
reason | null |
rowIndex | Det nollbaserade indexet för objektet i DataProvider. |
target | Objektet som skickade händelsen. Målet är inte alltid det objekt som avlyssnar händelsen. Använd egenskapen currentTarget så kommer du åt det objekt som avlyssnar händelsen. |
Relaterade API-element
ITEM_EDIT_END | Konstant |
public static const ITEM_EDIT_END:String = "itemEditEnd"
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Konstanten DataGridEvent.ITEM__EDIT_END
definierar värdet för itemEditEnd
-händelseobjektets type
-egenskap.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
columnIndex | Det nollbaserade indexet för kolumnrubriken i columns -arrayen i DataGrid-objektet. |
currentTarget | Det objekt som aktivt behandlar event-objektet med en händelseavlyssnare. |
dataField | Namnet på fältet eller egenskapen i data som är associerade med objektets kolumn. |
itemRenderer | Objektåtergivaren för det objekt som ska redigeras. |
reason | En konstant som definierar orsaken till händelsen. Värdet måste vara medlem i klassen DataGridEventReason . |
rowIndex | Det nollbaserade indexet för objektet i DataProvider. |
target | Objektet som skickade händelsen. Målet är inte alltid det objekt som avlyssnar händelsen. Använd egenskapen currentTarget så kommer du åt det objekt som avlyssnar händelsen. |
Relaterade API-element
ITEM_FOCUS_IN | Konstant |
public static const ITEM_FOCUS_IN:String = "itemFocusIn"
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Konstanten DataGridEvent.ITEM_FOCUS_IN
definierar värdet för itemFocusIn
-händelseobjektets type
-egenskap.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
columnIndex | Det nollbaserade indexet för kolumnrubriken i columns -arrayen i DataGrid-objektet. |
currentTarget | Det objekt som aktivt behandlar event-objektet med en händelseavlyssnare. |
dataField | null |
itemRenderer | Objektåtergivaren för det objekt som ska redigeras. |
reason | null |
rowIndex | Det nollbaserade indexet för objektet i DataProvider. |
target | Objektet som skickade händelsen. Målet är inte alltid det objekt som avlyssnar händelsen. Använd egenskapen currentTarget så kommer du åt det objekt som avlyssnar händelsen. |
Relaterade API-element
ITEM_FOCUS_OUT | Konstant |
public static const ITEM_FOCUS_OUT:String = "itemFocusOut"
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Konstanten DataGridEvent.ITEM_FOCUS_OUT
definierar värdet för itemFocusOut
-händelseobjektets type
-egenskap.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
columnIndex | Det nollbaserade indexet för kolumnrubriken i columns -arrayen i DataGrid-objektet. |
currentTarget | Det objekt som aktivt behandlar event-objektet med en händelseavlyssnare. |
dataField | null |
itemRenderer | Objektåtergivaren för det objekt som ska redigeras. |
reason | null |
rowIndex | Det nollbaserade indexet för objektet i DataProvider. |
target | Objektet som skickade händelsen. Målet är inte alltid det objekt som avlyssnar händelsen. Använd egenskapen currentTarget så kommer du åt det objekt som avlyssnar händelsen. |
Relaterade API-element
Följ stegen nedan:
- Lägg till DataGrid-komponenten i biblioteket.
- Spara den här koden som DataGridEventExample.as i samma katalog som din FLA-fil.
- Ställ in DataGridEventExample som DocumentClass i FLA-filen.
package { import fl.controls.DataGrid; import fl.data.DataProvider; import fl.events.DataGridEvent; import fl.events.DataGridEventReason; import flash.display.Sprite; public class DataGridEventExample extends Sprite { private var dg:DataGrid; public function DataGridEventExample() { createDataGrid(); } private function createDataGrid():void { dg = new DataGrid(); addChild(dg); dg.setSize(200,300); dg.editable = true; 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(DataGridEvent.ITEM_EDIT_BEGIN, announceEditBegin); dg.addEventListener(DataGridEvent.ITEM_EDIT_END, announceEditEnd); } private function announceEditBegin(e:DataGridEvent):void { trace("Edit Begin on row: " + e.rowIndex + " col: " + e.columnIndex); } private function announceEditEnd(e:DataGridEvent):void { var reason:String; switch(e.reason) { case DataGridEventReason.CANCELLED: reason = "User cancelled edit"; break; case DataGridEventReason.NEW_ROW: reason = "User focused to another row"; break; case DataGridEventReason.NEW_COLUMN: reason = "User focused to another column"; break; case DataGridEventReason.OTHER: default: reason = "Edit ended for other reason"; reason = e.reason; break; } trace("Edit End on row: " + e.rowIndex + " col: " + e.columnIndex); trace("Reason: " + reason.toString()); } private function getRandomNumber():uint { return Math.round(Math.random()*100); } } }
Tue Jun 12 2018, 01:40 PM Z