Pacchettofl.events
Classepublic class DataChangeEvent
EreditarietàDataChangeEvent Inheritance Event Inheritance Object

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

La classe DataChangeEvent definisce l'evento inviato quando i dati associati a un componente vengono modificati. Questo evento viene utilizzato dai componenti List, DataGrid, TileList e ComboBox.

Questa classe fornisce il seguente evento:

Vedere gli esempi

Vedere anche

DataChangeType


Proprietà pubbliche
 ProprietàDefinito da
 Inheritedbubbles: Boolean
[sola lettura] Indica se un evento è un evento di bubbling.
Event
 Inheritedcancelable: Boolean
[sola lettura] Indica se il comportamento associato all'evento può essere impedito.
Event
  changeType: String
[sola lettura] Ottiene il tipo di modifica che ha attivato l'evento.
DataChangeEvent
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
 InheritedcurrentTarget: Object
[sola lettura] L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
Event
  endIndex: uint
[sola lettura] Ottiene l'indice dell'ultima voce modificata nell'array di voci modificate.
DataChangeEvent
 InheritedeventPhase: uint
[sola lettura] La fase attuale del flusso di eventi.
Event
  items: Array
[sola lettura] Ottiene un array contenente le voci modificate.
DataChangeEvent
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
  startIndex: uint
[sola lettura] Ottiene l'indice della prima voce modificata nell'array di voci modificate.
DataChangeEvent
 Inheritedtarget: Object
[sola lettura] Il target dell'evento.
Event
 Inheritedtype: String
[sola lettura] Il tipo di evento.
Event
Metodi pubblici
 MetodoDefinito da
  
DataChangeEvent(eventType:String, changeType:String, items:Array, startIndex:int = -1, endIndex:int = -1)
Crea un nuovo oggetto DataChangeEvent con i parametri specificati.
DataChangeEvent
  
Crea una copia dell'oggetto DataEvent e imposta il valore di ogni parametro in modo che corrisponda a quello dell'originale.
DataChangeEvent
 Inherited
formatToString(className:String, ... arguments):String
Una funzione di utilità per l'implementazione del metodo toString() nella classe Event personalizzata.
Event
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Verifica se sull'evento è stato chiamato il metodo preventDefault().
Event
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato.
Event
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi.
Event
 Inherited
Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente.
Event
  
Restituisce una stringa che contiene tutte le proprietà dell'oggetto DataChangeEvent.
DataChangeEvent
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Costanti pubbliche
 CostanteDefinito da
 InheritedACTIVATE: String = "activate"
[statico] Definisce il valore della proprietà type di un oggetto evento activate.
Event
 InheritedADDED: String = "added"
[statico] Definisce il valore della proprietà type di un oggetto evento added.
Event
 InheritedADDED_TO_STAGE: String = "addedToStage"
[statico] Definisce il valore della proprietà type di un oggetto evento addedToStage.
Event
 InheritedCANCEL: String = "cancel"
[statico] Definisce il valore della proprietà type di un oggetto evento cancel.
Event
 InheritedCHANGE: String = "change"
[statico] Definisce il valore della proprietà type di un oggetto evento change.
Event
 InheritedCLOSE: String = "close"
[statico] Definisce il valore della proprietà type di un oggetto evento close.
Event
 InheritedCOMPLETE: String = "complete"
[statico] Definisce il valore della proprietà type di un oggetto evento complete.
Event
 InheritedCONNECT: String = "connect"
[statico] Definisce il valore della proprietà type di un oggetto evento connect.
Event
  DATA_CHANGE: String = "dataChange"
[statico] Definisce il valore della proprietà type di un oggetto evento dataChange.
DataChangeEvent
 InheritedDEACTIVATE: String = "deactivate"
[statico] Definisce il valore della proprietà type di un oggetto evento deactivate.
Event
 InheritedENTER_FRAME: String = "enterFrame"
[statico] Definisce il valore della proprietà type di un oggetto evento enterFrame.
Event
 InheritedFULLSCREEN: String = "fullScreen"
[statico] Definisce il valore della proprietà type di un oggetto evento fullScreen.
Event
 InheritedID3: String = "id3"
[statico] Definisce il valore della proprietà type di un oggetto evento id3.
Event
 InheritedINIT: String = "init"
[statico] Definisce il valore della proprietà type di un oggetto evento init.
Event
 InheritedMOUSE_LEAVE: String = "mouseLeave"
[statico] Definisce il valore della proprietà type di un oggetto evento mouseLeave.
Event
 InheritedOPEN: String = "open"
[statico] Definisce il valore della proprietà type di un oggetto evento open.
Event
  PRE_DATA_CHANGE: String = "preDataChange"
[statico] Definisce il valore della proprietà type di un oggetto evento preDataChange.
DataChangeEvent
 InheritedREMOVED: String = "removed"
[statico] Definisce il valore della proprietà type di un oggetto evento removed.
Event
 InheritedREMOVED_FROM_STAGE: String = "removedFromStage"
[statico] Definisce il valore della proprietà type di un oggetto evento removedFromStage.
Event
 InheritedRENDER: String = "render"
[statico] Definisce il valore della proprietà type di un oggetto evento render.
Event
 InheritedRESIZE: String = "resize"
[statico] Definisce il valore della proprietà type di un oggetto evento resize.
Event
 InheritedSCROLL: String = "scroll"
[statico] Definisce il valore della proprietà type di un oggetto evento scroll.
Event
 InheritedSELECT: String = "select"
[statico] Definisce il valore della proprietà type di un oggetto evento select.
Event
 InheritedSOUND_COMPLETE: String = "soundComplete"
[statico] Definisce il valore della proprietà type di un oggetto evento soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE: String = "tabChildrenChange"
[statico] Definisce il valore della proprietà type di un oggetto evento tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE: String = "tabEnabledChange"
[statico] Definisce il valore della proprietà type di un oggetto evento tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE: String = "tabIndexChange"
[statico] Definisce il valore della proprietà type di un oggetto evento tabIndexChange.
Event
 InheritedUNLOAD: String = "unload"
[statico] Definisce il valore della proprietà type di un oggetto evento unload.
Event
Descrizione delle proprietà
changeTypeproprietà
changeType:String  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Ottiene il tipo di modifica che ha attivato l'evento. La classe DataChangeType definisce i valori possibili per questa proprietà.


Implementazione
    public function get changeType():String

Vedere anche

endIndexproprietà 
endIndex:uint  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Ottiene l'indice dell'ultima voce modificata nell'array di voci modificate.


Implementazione
    public function get endIndex():uint

Vedere anche

itemsproprietà 
items:Array  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Ottiene un array contenente le voci modificate.


Implementazione
    public function get items():Array
startIndexproprietà 
startIndex:uint  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Ottiene l'indice della prima voce modificata nell'array di voci modificate.


Implementazione
    public function get startIndex():uint

Vedere anche

Descrizione della funzione di costruzione
DataChangeEvent()Funzione di costruzione
public function DataChangeEvent(eventType:String, changeType:String, items:Array, startIndex:int = -1, endIndex:int = -1)

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Crea un nuovo oggetto DataChangeEvent con i parametri specificati.

Parametri
eventType:String — Il tipo di evento change.
 
changeType:String — Il tipo di modifica che è stata apportata. La classe DataChangeType definisce i valori possibili per questo parametro.
 
items:Array — Un elenco di voci modificate.
 
startIndex:int (default = -1) — L'indice della prima voce che è stata modificata.
 
endIndex:int (default = -1) — L'indice dell'ultima voce che è stata modificata.
Descrizione dei metodi
clone()metodo
public override function clone():Event

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Crea una copia dell'oggetto DataEvent e imposta il valore di ogni parametro in modo che corrisponda a quello dell'originale.

Restituisce
Event — Un nuovo oggetto DataChangeEvent con proprietà dai valori identici a quelli dell'originale.
toString()metodo 
public override function toString():String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Restituisce una stringa che contiene tutte le proprietà dell'oggetto DataChangeEvent. La stringa ha il seguente formato:

[DataChangeEvent type=value changeType=value startIndex=value endIndex=value bubbles=value cancelable=value]

Restituisce
String — Una stringa che contiene tutte le proprietà dell'oggetto DataChangeEvent.
Descrizione delle costanti
DATA_CHANGECostante
public static const DATA_CHANGE:String = "dataChange"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Definisce il valore della proprietà type di un oggetto evento dataChange.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
changeTypeIdentifica il tipo di modifica che è stata apportata.
currentTargetL'oggetto che elabora attivamente l'oggetto event con un listener di eventi.
endIndexIdentifica l'indice dell'ultima voce che è stata modificata.
itemsUn array che elenca le voci modificate.
startIndexIdentifica l'indice della prima voce che è stata modificata.
targetL'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzare la proprietà currentTarget per accedere all'oggetto che ascolta l'evento.

Vedere anche

PRE_DATA_CHANGECostante 
public static const PRE_DATA_CHANGE:String = "preDataChange"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Definisce il valore della proprietà type di un oggetto evento preDataChange. Questo oggetto evento viene inviato prima che i dati del componente vengano modificati.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
changeTypeIdentifica il tipo di modifica che deve essere apportata.
currentTargetL'oggetto che elabora attivamente l'oggetto event con un listener di eventi.
endIndexIdentifica l'indice dell'ultima voce da modificare.
itemsUn array che elenca le voci da modificare.
startIndexIdentifica l'indice della prima voce da modificare.
targetL'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzare la proprietà currentTarget per accedere all'oggetto che ascolta l'evento.

Vedere anche

Esempi Come utilizzare gli esempi
DataChangeEventExample.as

Nell'esempio seguente viene illustrato come intercettare il DataChangeEvent trasmesso da DataProvider e usare i relativi eventi per popolare manualmente una DataGrid.

Per provare l'esempio, eseguire queste operazioni:

  1. Aggiungere i componenti DataGrid e Button alla libreria.
  2. Salvare questo codice come DataChangeEventExample.as nella stessa directory del file FLA.
  3. Impostare la classe documento nel file FLA su DataChangeEventExample.
package
{
    import fl.controls.Button;
    import fl.controls.DataGrid;
    import fl.data.DataProvider;
    import fl.events.DataChangeEvent;
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    
    public class DataChangeEventExample extends Sprite
    {
        private var dg:DataGrid;
        private var dp:DataProvider;
        private var names:Array = [ "Mary", "Bob", "Sue", "Joe" ];
        
        public function DataChangeEventExample() {
            dp = new DataProvider();
            dp.addEventListener(DataChangeEvent.DATA_CHANGE,dataChanged);
        
            dg = new DataGrid();
            dg.move(10,45);
            dg.setSize(300,250);
            dg.columns = [ "name", "phone", "email" ];
            addChild(dg);

            var addContactBtn:Button = new Button();
            addContactBtn.label = "Add Contact";
            addContactBtn.move(10,10);
            addContactBtn.addEventListener(MouseEvent.CLICK, addContact);
            addChild(addContactBtn);            
        }
        
        private function getRandomPhone():String {
            return randomDigit()+randomDigit()+randomDigit()+"-"+randomDigit()+randomDigit()+randomDigit()+"-"+randomDigit()+randomDigit()+randomDigit()+randomDigit();    
        }
        private function randomDigit():String {
            return String(Math.round(Math.random()*10)%10);    
        }
        private function getRandomName():String {
            return names[Math.round(Math.random()*names.length)%names.length];    
        }
        private function addContact(e:MouseEvent):void {
            var randomName:String = getRandomName()
            dp.addItem( { name: randomName, phone: getRandomPhone(), email: randomName + "@fictitious.com" } );
        }
        private function dataChanged(e:DataChangeEvent):void {
            var changedItems:Array = e.items;
            dg.addItem(changedItems[0]);
        }
    }
}




 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/fl/events/DataChangeEvent.html