Paquetefl.events
Clasepublic class DataChangeEvent
HerenciaDataChangeEvent Inheritance Event Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

La clase DataChangeEvent define el evento que se distribuye cuando cambian los datos asociados a un componente. Este evento lo utilizan los componentes List, DataGrid, TileList y ComboBox.

Esta clase proporciona el siguiente evento:

Ver los ejemplos

Véase también

DataChangeType


Propiedades públicas
 PropiedadDefinido por
 Inheritedbubbles : Boolean
[read-only] Indica si un evento es un evento de propagación.
Event
 Inheritedcancelable : Boolean
[read-only] Indica si se puede evitar el comportamiento asociado al evento.
Event
  changeType : String
[read-only] Obtiene el tipo de cambio que ha activado el evento.
DataChangeEvent
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
 InheritedcurrentTarget : Object
[read-only] El objeto que procesa de forma activa el objeto de evento con un detector de eventos.
Event
  endIndex : uint
[read-only] Obtiene el índice del último elemento cambiado en la matriz de elementos que se han cambiado.
DataChangeEvent
 InheritedeventPhase : uint
[read-only] La fase actual en el flujo del evento.
Event
  items : Array
[read-only] Obtiene una matriz que contiene los elementos cambiados.
DataChangeEvent
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
  startIndex : uint
[read-only] Obtiene el índice del primer elemento cambiado en la matriz de elementos que se han cambiado.
DataChangeEvent
 Inheritedtarget : Object
[read-only] El destino del evento.
Event
 Inheritedtype : String
[read-only] El tipo de evento.
Event
Métodos públicos
 MétodoDefinido por
  
DataChangeEvent(eventType:String, changeType:String, items:Array, startIndex:int = -1, endIndex:int = -1)
Crea un nuevo objeto DataChangeEvent con los parámetros especificados.
DataChangeEvent
  
Crea una copia del objeto DataEvent y define el valor de cada parámetro para que coincida con el del objeto original.
DataChangeEvent
 Inherited
formatToString(className:String, ... arguments):String
Una función de utilidad para implementar el método toString() en la clase Event personalizada.
Event
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Comprueba si se ha llamado a preventDefault() en el evento.
Event
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Cancela el comportamiento predeterminado de un evento si es posible cancelarlo.
Event
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento.
Event
 Inherited
Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual.
Event
  
Devuelve una cadena con todas las propiedades del objeto DataChangeEvent.
DataChangeEvent
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Constantes públicas
 ConstanteDefinido por
 InheritedACTIVATE : String = "activate"
[static] Define el valor de la propiedad type para un objeto de evento activate.
Event
 InheritedADDED : String = "added"
[static] Define el valor de la propiedad type para un objeto de evento added.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[static] Define el valor de la propiedad type para un objeto de evento addedToStage.
Event
 InheritedCANCEL : String = "cancel"
[static] Define el valor de la propiedad type para un objeto de evento cancel.
Event
 InheritedCHANGE : String = "change"
[static] Define el valor de la propiedad type para un objeto de evento change.
Event
 InheritedCLOSE : String = "close"
[static] Define el valor de la propiedad type para un objeto de evento close.
Event
 InheritedCOMPLETE : String = "complete"
[static] Define el valor de la propiedad type para un objeto de evento complete.
Event
 InheritedCONNECT : String = "connect"
[static] Define el valor de la propiedad type para un objeto de evento connect.
Event
  DATA_CHANGE : String = "dataChange"
[static] Define el valor de la propiedad type para un objeto de evento dataChange.
DataChangeEvent
 InheritedDEACTIVATE : String = "deactivate"
[static] Define el valor de la propiedad type para un objeto de evento deactivate.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[static] Define el valor de la propiedad type para un objeto de evento enterFrame.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[static] Define el valor de la propiedad type para un objeto de evento fullScreen.
Event
 InheritedID3 : String = "id3"
[static] Define el valor de la propiedad type para un objeto de evento id3.
Event
 InheritedINIT : String = "init"
[static] Define el valor de la propiedad type para un objeto de evento init.
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] Define el valor de la propiedad type para un objeto de evento mouseLeave.
Event
 InheritedOPEN : String = "open"
[static] Define el valor de la propiedad type para un objeto de evento open.
Event
  PRE_DATA_CHANGE : String = "preDataChange"
[static] Define el valor de la propiedad type para un objeto de evento preDataChange.
DataChangeEvent
 InheritedREMOVED : String = "removed"
[static] Define el valor de la propiedad type para un objeto de evento removed.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[static] Define el valor de la propiedad type para un objeto de evento removedFromStage.
Event
 InheritedRENDER : String = "render"
[static] Define el valor de la propiedad type para un objeto de evento render.
Event
 InheritedRESIZE : String = "resize"
[static] Define el valor de la propiedad type para un objeto de evento resize.
Event
 InheritedSCROLL : String = "scroll"
[static] Define el valor de la propiedad type para un objeto de evento scroll.
Event
 InheritedSELECT : String = "select"
[static] Define el valor de la propiedad type para un objeto de evento select.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] Define el valor de la propiedad type para un objeto de evento soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] Define el valor de la propiedad type para un objeto de evento tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] Define el valor de la propiedad type para un objeto de evento tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] Define el valor de la propiedad type para un objeto de evento tabIndexChange.
Event
 InheritedUNLOAD : String = "unload"
[static] Define el valor de la propiedad type para un objeto de evento unload.
Event
Información sobre propiedades
changeTypepropiedad
changeType:String  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene el tipo de cambio que ha activado el evento. La clase DataChangeType define los valores posibles de esta propiedad.


Implementación
    public function get changeType():String

Véase también

endIndexpropiedad 
endIndex:uint  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene el índice del último elemento cambiado en la matriz de elementos que se han cambiado.


Implementación
    public function get endIndex():uint

Véase también

itemspropiedad 
items:Array  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene una matriz que contiene los elementos cambiados.


Implementación
    public function get items():Array
startIndexpropiedad 
startIndex:uint  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Obtiene el índice del primer elemento cambiado en la matriz de elementos que se han cambiado.


Implementación
    public function get startIndex():uint

Véase también

Información sobre constructores
DataChangeEvent()constructor
public function DataChangeEvent(eventType:String, changeType:String, items:Array, startIndex:int = -1, endIndex:int = -1)

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Crea un nuevo objeto DataChangeEvent con los parámetros especificados.

Parámetros
eventType:String — Tipo de evento change.
 
changeType:String — Tipo de cambio realizado. La clase DataChangeType define los valores posibles de este parámetro.
 
items:Array — Lista de elementos que se han cambiado.
 
startIndex:int (default = -1) — Índice del primer elemento que se ha cambiado.
 
endIndex:int (default = -1) — Índice del último elemento que se ha cambiado.
Información sobre métodos
clone()método
public override function clone():Event

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Crea una copia del objeto DataEvent y define el valor de cada parámetro para que coincida con el del objeto original.

Valor devuelto
Event — Un nuevo objeto DataChangeEvent con valores de propiedades que coinciden con los del objeto original.
toString()método 
public override function toString():String

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Devuelve una cadena con todas las propiedades del objeto DataChangeEvent. La cadena tiene el siguiente formato:

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

Valor devuelto
String — Una cadena que contiene todas las propiedades del objeto DataChangeEvent.
Información sobre constantes
DATA_CHANGEConstante
public static const DATA_CHANGE:String = "dataChange"

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Define el valor de la propiedad type para un objeto de evento dataChange.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
changeTypeIdentifica el tipo de cambio realizado.
currentTargetObjeto que procesa de forma activa el objeto de evento con un detector de eventos.
endIndexIdentifica el índice del último elemento cambiado.
itemsMatriz que enumera los elementos que se han cambiado.
startIndexIdentifica el índice del primer elemento cambiado.
targetError que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento.

Véase también

PRE_DATA_CHANGEConstante 
public static const PRE_DATA_CHANGE:String = "preDataChange"

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9.0.28.0

Define el valor de la propiedad type para un objeto de evento preDataChange. Este objeto de evento se distribuye antes de que se realicen cambios a los datos del componente.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
changeTypeIdentifica el tipo de cambio que se va a realizar.
currentTargetObjeto que procesa de forma activa el objeto de evento con un detector de eventos.
endIndexIdentifica el índice del último elemento que se va a cambiar.
itemsMatriz que enumera los elementos que se van a cambiar.
startIndexIdentifica el índice del primer elemento que se va a cambiar.
targetError que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento.

Véase también

Ejemplos Cómo utilizar los ejemplos
DataChangeEventExample.as

En este ejemplo, se muestra cómo detectar la difusión de DataChangeEvent por DataProvider y utilizar los eventos para llenar el objeto DataGrid manualmente.

Para realizar el ejemplo, siga estos pasos:

  1. Añada los componentes DataGrid y Button a la biblioteca.
  2. Guarde este código como DataChangeEventExample.as en el mismo directorio que el archivo FLA.
  3. Defina la clase Document como DataChangeEventExample en el archivo FLA.
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]);
        }
    }
}




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/fl/events/DataChangeEvent.html