Pacchetto | fl.events |
Classe | public class DataGridEvent |
Ereditarietà | DataGridEvent ListEvent Event Object |
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
-
DataGridEvent.COLUMN_STRETCH
: inviato quando un utente ridimensiona una colonna in senso orizzontale. -
DataGridEvent.HEADER_RELEASE
: inviato quando un vento preme e rilascia il mouse sull'intestazione di una colonna. -
DataGridEvent.ITEM_EDIT_BEGIN
: inviato quanto una voce è pronta per essere modificata. -
DataGridEvent.ITEM_EDIT_BEGINNING
: inviato quando l'utente è pronto per modificare una voce; ciò è indicato, ad esempio, dal rilascio del pulsante del mouse quando il mouse si trova sopra la voce. -
DataGridEvent.ITEM_EDIT_END
: inviato al termine di una sessione di modifica. -
DataGridEvent.ITEM_FOCUS_IN
: inviato quando una voce riceve l'attivazione. -
DataGridEvent.ITEM_FOCUS_OUT
: inviato quando una voce perde l'attivazione.
Elementi API correlati
Proprietà | Definito da | ||
---|---|---|---|
bubbles : Boolean [sola lettura]
Indica se un evento è un evento di bubbling. | Event | ||
cancelable : Boolean [sola lettura]
Indica se il comportamento associato all'evento può essere impedito. | Event | ||
columnIndex : int [sola lettura]
Ottiene l'indice di colonna della voce associata all'evento. | ListEvent | ||
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
currentTarget : Object [sola lettura]
L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. | Event | ||
dataField : String
Ottiene o imposta il nome del campo o della proprietà nei dati associati alla colonna. | DataGridEvent | ||
eventPhase : uint [sola lettura]
La fase attuale del flusso di eventi. | Event | ||
index : int [sola lettura]
Ottiene l'indice a base zero della cella che contiene il renderer. | ListEvent | ||
item : Object [sola lettura]
Ottiene i dati che appartengono al renderer della cella corrente. | ListEvent | ||
itemRenderer : Object [sola lettura]
Ottiene il renderer di voci per la voce che è in corso di modifica o il renderer di intestazioni su cui si fa clic o che si sta ridimensionando. | DataGridEvent | ||
reason : String [sola lettura]
Ottiene il motivo per cui è stato inviato l'evento itemEditEnd. | DataGridEvent | ||
rowIndex : Object [sola lettura]
Ottiene l'indice di riga della voce associata all'evento. | ListEvent | ||
target : Object [sola lettura]
Il target dell'evento. | Event | ||
type : String [sola lettura]
Il tipo di evento. | Event |
Metodo | Definito da | ||
---|---|---|---|
DataGridEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, itemRenderer:Object = null, dataField:String = null, reason:String = null)
Crea un nuovo oggetto DataGridEvent con i parametri specificati. | DataGridEvent | ||
[override]
Crea una copia dell'oggetto DataGridEvent e imposta il valore di ogni proprietà in modo che corrisponda all'originale. | DataGridEvent | ||
Una funzione dell'utilità per l'implementazione del metodo toString() in classi Event ActionScript 3.0 personalizzate. | Event | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Verifica se sull'evento è stato chiamato il metodo preventDefault(). | Event | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato. | Event | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi. | Event | ||
Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente. | Event | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
[override]
Restituisce una stringa che contiene tutte le proprietà dell'oggetto DataGridEvent. | DataGridEvent | ||
Restituisce il valore di base dell'oggetto specificato. | Object |
Costante | Definito da | ||
---|---|---|---|
COLUMN_STRETCH : String = "columnStretch" [statico]
La costante DataGridEvent.COLUMN_STRETCH definisce il valore della proprietà type di un oggetto evento columnStretch. | DataGridEvent | ||
HEADER_RELEASE : String = "headerRelease" [statico]
La costante DataGridEvent.HEADER_RELEASE definisce il valore della proprietà type di un oggetto evento headerRelease. | DataGridEvent | ||
ITEM_EDIT_BEGIN : String = "itemEditBegin" [statico]
La costante DataGridEvent.ITEM_EDIT_BEGIN definisce il valore della proprietà type di un oggetto evento itemEditBegin. | DataGridEvent | ||
ITEM_EDIT_BEGINNING : String = "itemEditBeginning" [statico]
La costante DataGridEvent.ITEM__EDIT_BEGINNING definisce il valore della proprietà type di un oggetto evento itemEditBeginning. | DataGridEvent | ||
ITEM_EDIT_END : String = "itemEditEnd" [statico]
La costante DataGridEvent.ITEM_EDIT_END definisce il valore della proprietà type di un oggetto evento itemEditEnd. | DataGridEvent | ||
ITEM_FOCUS_IN : String = "itemFocusIn" [statico]
La costante DataGridEvent.ITEM_FOCUS_IN definisce il valore della proprietà type di un oggetto evento itemFocusIn. | DataGridEvent | ||
ITEM_FOCUS_OUT : String = "itemFocusOut" [statico]
La costante DataGridEvent.ITEM_FOCUS_OUT definisce il valore della proprietà type di un oggetto evento itemFocusOut. | DataGridEvent |
dataField | proprietà |
dataField:String
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta il nome del campo o della proprietà nei dati associati alla colonna.
Implementazione
public function get dataField():String
public function set dataField(value:String):void
itemRenderer | proprietà |
itemRenderer:Object
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene il renderer di voci per la voce che è in corso di modifica o il renderer di intestazioni su cui si fa clic o che si sta ridimensionando.
Implementazione
public function get itemRenderer():Object
reason | proprietà |
reason:String
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene il motivo per cui è stato inviato l'evento itemEditEnd
. Questa proprietà è valida solo per eventi di tipo DataGridEvent.ITEM_EDIT_END
.
I valori possibili sono definiti nella classe DataGridEventReason.
Implementazione
public function get reason():String
Elementi API correlati
DataGridEvent | () | Funzione di costruzione |
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)
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Crea un nuovo oggetto DataGridEvent con i parametri specificati.
Parametritype:String — Il tipo di evento; valore che indica l'azione che ha provocato l'evento.
| |
bubbles:Boolean (default = false ) — Indica se l'evento può effettuare la propagazione (o bubbling) della gerarchia dell'elenco di visualizzazione.
| |
cancelable:Boolean (default = false ) — Indica se il comportamento associato all'evento può essere impedito.
| |
columnIndex:int (default = -1 ) — L'indice a base zero della colonna che contiene il renderer.
| |
rowIndex:int (default = -1 ) — L'indice a base zero della riga che contiene il renderer.
| |
itemRenderer:Object (default = null ) — Il renderer di voci per la voce che è in corso di modifica o il renderer di intestazioni su cui si fa clic o che si sta allungando.
| |
dataField:String (default = null ) — Il nome del campo o della proprietà nei dati associati alla colonna.
| |
reason:String (default = null ) — Il motivo per cui è stato inviato l'evento itemEditEnd .
|
Elementi API correlati
clone | () | metodo |
override public function clone():Event
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Crea una copia dell'oggetto DataGridEvent e imposta il valore di ogni proprietà in modo che corrisponda all'originale.
RestituisceEvent — Un nuovo oggetto DataGridEvent con valori di parametri identici a quelli dell'originale.
|
toString | () | metodo |
override public function toString():String
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Restituisce una stringa che contiene tutte le proprietà dell'oggetto DataGridEvent. La stringa ha il seguente formato:
[DataGridEvent type=value bubbles=value cancelable=value columnIndex=value rowIndex=value itemRenderer=value dataField=value reason=value
]
String — Una stringa che contiene tutte le proprietà dell'oggetto DataGridEvent.
|
COLUMN_STRETCH | Costante |
public static const COLUMN_STRETCH:String = "columnStretch"
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
La costante DataGridEvent.COLUMN_STRETCH
definisce il valore della proprietà type
di un oggetto evento columnStretch
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | false |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
columnIndex | L'indice a base zero della colonna di intestazione nell'array columns dell'oggetto DataGrid. |
currentTarget | L'oggetto che elabora attivamente l'oggetto event con un listener di eventi. |
dataField | Il nome del campo o della proprietà nei dati associati alla colonna della voce. |
itemRenderer | Il renderer dell'intestazione della colonna che è stata allungata. |
reason | null |
rowIndex | La posizione di indice a base zero della voce nel fornitore di dati. |
target | L'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzate la proprietà currentTarget per accedere all'oggetto che intercetta l'evento. |
Esempio ( Come utilizzare questo esempio )
columnStretch
:
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 | Costante |
public static const HEADER_RELEASE:String = "headerRelease"
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
La costante DataGridEvent.HEADER_RELEASE
definisce il valore della proprietà type
di un oggetto evento headerRelease
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | false |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
columnIndex | L'indice a base zero della colonna di intestazione nell'array columns dell'oggetto DataGrid. |
currentTarget | L'oggetto che elabora attivamente l'oggetto event con un listener di eventi. |
dataField | Il nome del campo o della proprietà nei dati associati alla colonna della voce. |
itemRenderer | Il renderer dell'intestazione sul quale è stato fatto clic. |
reason | null |
rowIndex | -1 |
target | L'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzate la proprietà currentTarget per accedere all'oggetto che intercetta l'evento. |
Esempio ( Come utilizzare questo esempio )
headerRelease
:
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 | Costante |
public static const ITEM_EDIT_BEGIN:String = "itemEditBegin"
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
La costante DataGridEvent.ITEM_EDIT_BEGIN
definisce il valore della proprietà type
di un oggetto evento itemEditBegin
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | false |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
columnIndex | L'indice a base zero della colonna di intestazione nell'array columns dell'oggetto DataGrid. |
currentTarget | L'oggetto che elabora attivamente l'oggetto event con un listener di eventi. |
dataField | null |
itemRenderer | Il renderer della voce da modificare. |
reason | null |
rowIndex | La posizione di indice a base zero della voce nel fornitore di dati. |
target | L'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzate la proprietà currentTarget per accedere all'oggetto che intercetta l'evento. |
Elementi API correlati
ITEM_EDIT_BEGINNING | Costante |
public static const ITEM_EDIT_BEGINNING:String = "itemEditBeginning"
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
La costante DataGridEvent.ITEM__EDIT_BEGINNING
definisce il valore della proprietà type
di un oggetto evento itemEditBeginning
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | false |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
columnIndex | L'indice a base zero della colonna di intestazione nell'array columns dell'oggetto DataGrid. |
currentTarget | L'oggetto che elabora attivamente l'oggetto event con un listener di eventi. |
dataField | Il nome del campo o della proprietà nei dati associati alla colonna della voce. |
itemRenderer | Il renderer della voce da modificare. |
reason | null |
rowIndex | La posizione di indice a base zero della voce nel fornitore di dati. |
target | L'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzate la proprietà currentTarget per accedere all'oggetto che intercetta l'evento. |
Elementi API correlati
ITEM_EDIT_END | Costante |
public static const ITEM_EDIT_END:String = "itemEditEnd"
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
La costante DataGridEvent.ITEM_EDIT_END
definisce il valore della proprietà type
di un oggetto evento itemEditEnd
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | false |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
columnIndex | L'indice a base zero della colonna di intestazione nell'array columns dell'oggetto DataGrid. |
currentTarget | L'oggetto che elabora attivamente l'oggetto event con un listener di eventi. |
dataField | Il nome del campo o della proprietà nei dati associati alla colonna della voce. |
itemRenderer | Il renderer della voce da modificare. |
reason | Una costante che definisce il motivo dell'evento. Il valore deve essere un membro della classe DataGridEventReason . |
rowIndex | La posizione di indice a base zero della voce nel fornitore di dati. |
target | L'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzate la proprietà currentTarget per accedere all'oggetto che intercetta l'evento. |
Elementi API correlati
ITEM_FOCUS_IN | Costante |
public static const ITEM_FOCUS_IN:String = "itemFocusIn"
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
La costante DataGridEvent.ITEM_FOCUS_IN
definisce il valore della proprietà type
di un oggetto evento itemFocusIn
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | false |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
columnIndex | L'indice a base zero della colonna di intestazione nell'array columns dell'oggetto DataGrid. |
currentTarget | L'oggetto che elabora attivamente l'oggetto event con un listener di eventi. |
dataField | null |
itemRenderer | Il renderer della voce da modificare. |
reason | null |
rowIndex | La posizione di indice a base zero della voce nel fornitore di dati. |
target | L'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzate la proprietà currentTarget per accedere all'oggetto che intercetta l'evento. |
Elementi API correlati
ITEM_FOCUS_OUT | Costante |
public static const ITEM_FOCUS_OUT:String = "itemFocusOut"
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
La costante DataGridEvent.ITEM_FOCUS_OUT
definisce il valore della proprietà type
di un oggetto evento itemFocusOut
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | false |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
columnIndex | L'indice a base zero della colonna di intestazione nell'array columns dell'oggetto DataGrid. |
currentTarget | L'oggetto che elabora attivamente l'oggetto event con un listener di eventi. |
dataField | null |
itemRenderer | Il renderer della voce da modificare. |
reason | null |
rowIndex | La posizione di indice a base zero della voce nel fornitore di dati. |
target | L'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzate la proprietà currentTarget per accedere all'oggetto che intercetta l'evento. |
Elementi API correlati
Per provare l'esempio, eseguite queste operazioni:
- Aggiungete il componente DataGrid alla libreria.
- Salvate questo codice come DataGridEventExample.as nella stessa directory del file FLA.
- Impostate la classe documento nel file FLA su DataGridEventExample.
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, 02:44 PM Z