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():String
Elementos 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():uint
Elementos 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():uint
Elementos 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