| Pacote | fl.events |
| Classe | public class DataChangeEvent |
| Herança | DataChangeEvent Event Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS3 |
| Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Esta classe fornece os seguinte evento:
-
DataChangeEvent.DATA_CHANGE: despachado quando os dados do componente são alterados.
Elementos da API relacionados
| Propriedade | Definido por | ||
|---|---|---|---|
![]() | bubbles : Boolean [somente leitura]
Indica se um evento é do tipo bubbling. | Event | |
![]() | cancelable : Boolean [somente leitura]
Indica se o comportamento associado ao evento pode ser impedido. | Event | |
| changeType : String [somente leitura]
Obtém o tipo de alteração que acionou o evento. | DataChangeEvent | ||
![]() | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
![]() | currentTarget : Object [somente leitura]
O objeto que está processando ativamente o objeto Event com um ouvinte de evento. | Event | |
| endIndex : uint [somente leitura]
Obtém o índice do último item alterado na matriz de itens que foram alterados. | DataChangeEvent | ||
![]() | eventPhase : uint [somente leitura]
A fase atual no fluxo de eventos. | Event | |
| items : Array [somente leitura]
Obtém uma matriz que contém os itens alterados. | DataChangeEvent | ||
| startIndex : uint [somente leitura]
Obtém o índice do primeiro item alterado na matriz de itens que foram alterados. | DataChangeEvent | ||
![]() | target : Object [somente leitura]
O destino de evento. | Event | |
![]() | type : String [somente leitura]
O tipo de evento. | Event | |
| Método | Definido por | ||
|---|---|---|---|
DataChangeEvent(eventType:String, changeType:String, items:Array, startIndex:int = -1, endIndex:int = -1)
Cria um novo objeto DataChangeEvent com os parâmetros especificados. | DataChangeEvent | ||
[substituir]
Cria uma cópia do objeto DataEvent e define o valor de cada parâmetro para corresponder ao do original. | DataChangeEvent | ||
![]() |
Uma função de utilitário para implementar o método toString() em classes ActionScript 3.0 Event personalizadas. | Event | |
![]() |
Indica se um objeto tem uma propriedade especificada definida. | Object | |
![]() |
Verifica se o método preventDefault() foi chamado no evento. | Event | |
![]() |
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
![]() |
Cancela um comportamento padrão de evento se esse comportamento puder ser cancelado. | Event | |
![]() |
Indica se a propriedade especificada existe e é enumerável. | Object | |
![]() |
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
![]() |
Impede o processamento de qualquer ouvinte de evento no nó atual e qualquer nó subsequente no fluxo de eventos. | Event | |
![]() |
Impede o processamento de algum ouvinte de evento em nós subsequentes ao nó atual no fluxo de eventos. | Event | |
![]() |
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
[substituir]
Retorna uma string que contém todas as propriedades do objeto DataChangeEvent. | DataChangeEvent | ||
![]() |
Retorna o valor primitivo do objeto especificado. | Object | |
| Constante | Definido por | ||
|---|---|---|---|
| DATA_CHANGE : String = "dataChange" [estático]
Define o valor da propriedade de tipo de um objeto de evento dataChange. | DataChangeEvent | ||
| PRE_DATA_CHANGE : String = "preDataChange" [estático]
Define o valor da propriedade de tipo de um objeto de evento preDataChange. | DataChangeEvent | ||
changeType | propriedade |
changeType:String [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS3 |
| Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém o tipo de alteração que acionou o evento. A classe DataChangeType define os possíveis valores para esta propriedade.
Implementação
public function get changeType():StringElementos da API relacionados
endIndex | propriedade |
endIndex:uint [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS3 |
| Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém o índice do último item alterado na matriz de itens que foram alterados.
Implementação
public function get endIndex():uintElementos da API relacionados
items | propriedade |
startIndex | propriedade |
startIndex:uint [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS3 |
| Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Obtém o índice do primeiro item alterado na matriz de itens que foram alterados.
Implementação
public function get startIndex():uintElementos da API relacionados
DataChangeEvent | () | Construtor |
public function DataChangeEvent(eventType:String, changeType:String, items:Array, startIndex:int = -1, endIndex:int = -1)| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS3 |
| Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Cria um novo objeto DataChangeEvent com os parâmetros especificados.
ParâmetroseventType:String — O tipo de evento de alteração.
| |
changeType:String — O tipo de alteração que foi feita. A classe DataChangeType define os possíveis valores para esse parâmetro.
| |
items:Array — Uma lista de itens que foram alterados.
| |
startIndex:int (default = -1) — O índice do primeiro item alterado.
| |
endIndex:int (default = -1) — O índice do último item foi alterado.
|
clone | () | método |
override public function clone():Event| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS3 |
| Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Cria uma cópia do objeto DataEvent e define o valor de cada parâmetro para corresponder ao do original.
RetornaEvent — Um novo objeto DataChangeEvent com valores de propriedade que correspondem aos do original.
|
toString | () | método |
override public function toString():String| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS3 |
| Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Retorna uma string que contém todas as propriedades do objeto DataChangeEvent. A string está no seguinte formato:
[DataChangeEvent type=value changeType=value startIndex=value endIndex=value bubbles=value cancelable=value]
String — Uma string que contém todas as propriedades do objeto DataChangeEvent.
|
DATA_CHANGE | Constante |
public static const DATA_CHANGE:String = "dataChange"| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS3 |
| Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Define o valor da propriedade type de um objeto de evento dataChange.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
changeType | Identifica o tipo de alteração que foi feita. |
currentTarget | O objeto que está processando ativamente o objeto de evento com um ouvinte de evento. |
endIndex | Identifica o índice do último item alterado. |
itens | Uma matriz que lista os itens que foram alterados. |
startIndex | Identifica o índice do primeiro item alterado. |
target | O objeto que despachou o evento. Nem sempre o destino é o objeto ouvinte do evento. Utilize a propriedade currentTarget para acessar o objeto ouvinte do evento. |
Elementos da API relacionados
PRE_DATA_CHANGE | Constante |
public static const PRE_DATA_CHANGE:String = "preDataChange"| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS3 |
| Versões de runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Define o valor da propriedade type de um objeto de evento preDataChange. Este objeto de evento é despachado antes que seja feita uma alteração nos dados do componente.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
changeType | Identifica o tipo de alteração a ser feita. |
currentTarget | O objeto que está processando ativamente o objeto de evento com um ouvinte de evento. |
endIndex | Identifica o índice do último item a ser alterado. |
itens | Uma matriz que lista os itens a serem alterados. |
startIndex | Identifica o índice do primeiro item a ser alterado. |
target | O objeto que despachou o evento. Nem sempre o destino é o objeto ouvinte do evento. Utilize a propriedade currentTarget para acessar o objeto ouvinte do evento. |
Elementos da API relacionados
- Adicione as classes DataGrid e Buttons à biblioteca.
- Salve esse código como DataChangeEventExample.as no mesmo diretório de FLA.
- Defina DocumentClass em FLA como DataChangeEventExample.
package
{
import flash.display.Sprite;
import flash.events.MouseEvent;
import fl.data.DataProvider;
import fl.events.DataChangeEvent;
import fl.controls.DataGrid;
import fl.controls.Button;
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]);
}
}
}
Wed Jun 13 2018, 11:10 AM Z
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas