| Pakiet | fl.data |
| Klasa | public class DataProvider |
| Dziedziczenie | DataProvider EventDispatcher Object |
| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Obiekt dostarczający dane jest to liniowa kolekcja elementów pełniąca rolę źródła danych, np. tablica. Każdy element w obiekcie dostarczającym dane jest obiektem lub obiektem XML zawierającym co najmniej jedno pole danych. Dostęp do elementów zawartych w obiekcie dostarczającym dane można uzyskiwać na podstawie indeksów, korzystając z metody DataProvider.getItemAt().
| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
![]() | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| length : uint [tylko do odczytu]
Liczba elementów obiektu dostarczającego dane. | DataProvider | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
DataProvider(value:Object = null)
Tworzy nowy obiekt DataProvider, jako źródła danych używając listy, wystąpienia klasy XML lub tablicy obiektów danych. | DataProvider | ||
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | |
Dołącza element na końcu obiektu dostarczającego dane. | DataProvider | ||
Dodaje nowy element do obiektu dostarczającego dane, w miejscu o podanym indeksie. | DataProvider | ||
Dołącza wiele elementów na końcu obiektu DataProvider i wywołuje zdarzenie DataChangeType.ADD. | DataProvider | ||
Dodaje kilka elementów do obiektu dostarczającego dane, w miejscu o określonym indeksie, a ponadto wywołuje zdarzenie DataChangeType.ADD. | DataProvider | ||
Tworzy kopię bieżącego obiektu DataProvider. | DataProvider | ||
Dokonuje konkatenacji określonych elementów na końcu bieżącego obiektu dostarczającego dane. | DataProvider | ||
![]() |
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | |
Zwraca element o podanym indeksie. | DataProvider | ||
Zwraca indeks podanego elementu. | DataProvider | ||
![]() |
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | |
![]() |
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
Unieważnia wszystkie elementy danych zawarte w obiekcie DataProvider i wywołuje zdarzenie DataChangeEvent.INVALIDATE_ALL. | DataProvider | ||
Unieważnia określony element. | DataProvider | ||
Unieważnia element o podanym indeksie. | DataProvider | ||
![]() |
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
Dołącza określone dane do danych zawartych w obiekcie dostarczającym dane i usuwa ewentualne powielone elementy. | DataProvider | ||
![]() |
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
Usuwa wszystkie elementy z obiektu dostarczającego dane i wywołuje zdarzenie DataChangeType.REMOVE_ALL. | DataProvider | ||
![]() |
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | |
Usuwa określony element z obiektu dostarczającego dane i wywołuje zdarzenie DataChangeType.REMOVE. | DataProvider | ||
Usuwa element o podanym indeksie i wywołuje zdarzenie DataChangeType.REMOVE. | DataProvider | ||
Zastępuje istniejący element nowym elementem i wywołuje zdarzenie DataChangeType.REPLACE. | DataProvider | ||
Zastępuje element o określonym indeksie i wywołuje zdarzenie DataChangeType.REPLACE. | DataProvider | ||
![]() |
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
Sortuje elementy zawarte w obiekcie dostarczającym dane i wywołuje zdarzenie DataChangeType.SORT. | DataProvider | ||
Sortuje elementy zawarte w obiekcie dostarczającym dane według określonego pola i wywołuje zdarzenie DataChangeType.SORT. | DataProvider | ||
Tworzy obiekt Array, reprezentujący dane zawarte w obiekcie dostarczającym dane. | DataProvider | ||
![]() |
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
[przesłanianie]
Tworzy ciąg reprezentujący dane zawarte w obiekcie dostarczającym dane. | DataProvider | ||
![]() |
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
![]() |
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher | |
| Zdarzenie | Podsumowanie | Zdefiniowane przez | ||
|---|---|---|---|---|
![]() | [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny. | EventDispatcher | ||
| Wywoływane po zmianie danych. | DataProvider | |||
![]() | [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | ||
| Wywoływane przed zmianą danych. | DataProvider | |||
length | właściwość |
length:uint [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Liczba elementów obiektu dostarczającego dane.
Implementacja
public function get length():uintPrzykład ( Sposób korzystania z tego przykładu )
import fl.controls.List;
import fl.data.DataProvider;
var dp:DataProvider = new DataProvider();
dp.addItem({label:"Item 1"});
dp.addItem({label:"Item 2"});
dp.addItem({label:"Item 3"});
dp.addItem({label:"Item 4"});
var myList:List = new List();
myList.dataProvider = dp;
myList.rowHeight = 35;
myList.rowCount = dp.length;
myList.move(10, 10);
addChild(myList);
DataProvider | () | Konstruktor |
public function DataProvider(value:Object = null)| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Tworzy nowy obiekt DataProvider, jako źródła danych używając listy, instancji XML lub tablicy obiektów danych.
Parametryvalue:Object (default = null) — Dane używane do utworzenia obiektu DataProvider.
|
Przykład ( Sposób korzystania z tego przykładu )
addItem():
import fl.controls.ComboBox;
import fl.data.DataProvider;
var dp:DataProvider = new DataProvider();
dp.addItem({label:"item 1a"});
dp.addItem({label:"item 2a"});
var myComboBox:ComboBox = new ComboBox()
myComboBox.dataProvider = dp;
myComboBox.move(10, 10);
addChild(myComboBox);
import fl.controls.ComboBox;
import fl.data.DataProvider;
var arr:Array = new Array();
arr.push({label:"item 1b"});
arr.push({label:"item 2b"});
var dp:DataProvider = new DataProvider(arr);
var myComboBox:ComboBox = new ComboBox()
myComboBox.dataProvider = dp;
myComboBox.move(10, 10);
addChild(myComboBox);
import fl.controls.ComboBox;
import fl.data.DataProvider;
var xml:XML = <items>
<item label="item 1c" />
<item label="item 2c" />
</items>;
var dp:DataProvider = new DataProvider(xml);
var myComboBox:ComboBox = new ComboBox()
myComboBox.dataProvider = dp;
myComboBox.move(10, 10);
addChild(myComboBox);
import fl.controls.ComboBox;
import fl.data.DataProvider;
var xml:XML = <items>
<item>
<label>item 1d</label>
</item>
<item>
<label>item 2d</label>
</item>
</items>;
var dp:DataProvider = new DataProvider(xml);
var myComboBox:ComboBox = new ComboBox()
myComboBox.dataProvider = dp;
myComboBox.move(10, 10);
addChild(myComboBox);
addItem | () | metoda |
public function addItem(item:Object):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Dołącza element na końcu obiektu dostarczającego dane.
Parametry
item:Object — Element, który ma być dołączony na końcu obiektu dostarczającego dane.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
addItem().
import fl.controls.ComboBox;
import fl.data.DataProvider;
var dp:DataProvider = new DataProvider();
dp.addItem({label:"item 1a"});
dp.addItem({label:"item 2a"});
var myComboBox:ComboBox = new ComboBox()
myComboBox.dataProvider = dp;
myComboBox.move(10, 10);
addChild(myComboBox);
addItemAt | () | metoda |
public function addItemAt(item:Object, index:uint):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Dodaje nowy element do obiektu dostarczającego dane, w miejscu o podanym indeksie. Jeśli określony indeks jest większy niż długość obiektu dostarczającego dane, zostanie zignorowany.
Parametry
item:Object — Obiekt zawierający dane elementu, który ma być dodany.
| |
index:uint — Indeks, w którym ma zostać dodany element.
|
Zgłasza
RangeError — Podany indeks jest mniejszy niż 0 albo większy lub równy długości obiektu dostarczającego dane.
|
Powiązane elementy interfejsu API
addItems | () | metoda |
public function addItems(items:Object):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Dołącza wiele elementów na końcu obiektu DataProvider i wywołuje zdarzenie DataChangeType.ADD. Elementy są dodawane w kolejności, w jakiej zostaną określone.
Parametry
items:Object — Elementy, które mają zostać dołączone do obiektu dostarczającego dane.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
addItems() w celu dodania kilku elementów do obiektu dostarczającego dane:
import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;
var arr:Array = [{col1:"1.A", col2:"1.B"}, {col1:"2.A", col2:"2.B"}]
var dp:DataProvider = new DataProvider();
dp.addItems(arr);
trace(dp.length); // 2
var c1:DataGridColumn = new DataGridColumn("col1");
var c2:DataGridColumn = new DataGridColumn("col2");
var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn(c1);
myDataGrid.addColumn(c2);
myDataGrid.dataProvider = dp;
myDataGrid.setSize(200, 160);
myDataGrid.move(10, 10);
addChild(myDataGrid);
addItemsAt | () | metoda |
public function addItemsAt(items:Object, index:uint):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Dodaje kilka elementów do obiektu dostarczającego dane w pozycji określonej przez indeks, a następnie wywołuje zdarzenie DataChangeType.ADD.
Parametry
items:Object — Elementy, które mają zostać dodane do obiektu dostarczającego dane.
| |
index:uint — Indeks, w którym elementy mają zostać dodane.
|
Zgłasza
RangeError — Podany indeks jest mniejszy niż 0 albo większy lub równy długości obiektu dostarczającego dane.
|
Powiązane elementy interfejsu API
clone | () | metoda |
public function clone():DataProvider| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Tworzy kopię bieżącego obiektu DataProvider.
ZwracaDataProvider — Nowa instancja tego obiektu DataProvider.
|
concat | () | metoda |
public function concat(items:Object):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Dokonuje konkatenacji określonych elementów na końcu bieżącego obiektu dostarczającego dane. Ta metoda wywołuje zdarzenie DataChangeType.ADD.
Parametry
items:Object — Elementy, które mają zostać dodane do obiektu dostarczającego dane.
|
Powiązane elementy interfejsu API
getItemAt | () | metoda |
public function getItemAt(index:uint):Object| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Zwraca element o podanym indeksie.
Parametry
index:uint — Położenie elementu, który ma zostać zwrócony.
|
Object — Element o określonym indeksie.
|
Zgłasza
RangeError — Podany indeks jest mniejszy niż 0 albo większy lub równy długości obiektu dostarczającego dane.
|
Powiązane elementy interfejsu API
getItemIndex | () | metoda |
public function getItemIndex(item:Object):int| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Zwraca indeks podanego elementu.
Parametry
item:Object — Element do odszukania.
|
int — Indeks określonego elementu lub -1, jeśli nie znaleziono takiego elementu.
|
Powiązane elementy interfejsu API
invalidate | () | metoda |
public function invalidate():void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Unieważnia wszystkie elementy danych zawarte w obiekcie DataProvider i wywołuje zdarzenie DataChangeEvent.INVALIDATE_ALL. Elementy są unieważniane po tym, jak zostaną zmienione; obiekt DataProvider automatycznie ponownie rysuje unieważnione elementy.
Powiązane elementy interfejsu API
invalidateItem | () | metoda |
public function invalidateItem(item:Object):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Unieważnia określony element. Element jest unieważniany po tym, jak zostanie zmieniony; obiekt DataProvider automatycznie ponownie rysuje unieważniony element.
Parametry
item:Object — Element, który ma być unieważniony.
|
Powiązane elementy interfejsu API
invalidateItemAt | () | metoda |
public function invalidateItemAt(index:int):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Unieważnia element o podanym indeksie. Element jest unieważniany po tym, jak zostanie zmieniony; obiekt DataProvider automatycznie ponownie rysuje unieważniony element.
Parametry
index:int — Indeks elementu, który ma zostać unieważniony.
|
Zgłasza
RangeError — Podany indeks jest mniejszy niż 0 albo większy lub równy długości obiektu dostarczającego dane.
|
Powiązane elementy interfejsu API
merge | () | metoda |
public function merge(newData:Object):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Dołącza określone dane do danych zawartych w obiekcie dostarczającym dane i usuwa ewentualne powielone elementy. Ta metoda wywołuje zdarzenie DataChangeType.ADD.
Parametry
newData:Object — Dane są scalane z zawartością obiektu dostarczającego dane.
|
Powiązane elementy interfejsu API
removeAll | () | metoda |
public function removeAll():void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Usuwa wszystkie elementy z obiektu dostarczającego dane i wywołuje zdarzenie DataChangeType.REMOVE_ALL.
Powiązane elementy interfejsu API
removeItem | () | metoda |
public function removeItem(item:Object):Object| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Usuwa określony element z obiektu dostarczającego dane i wywołuje zdarzenie DataChangeType.REMOVE.
Parametry
item:Object — Element, który ma zostać usunięty.
|
Object — Usunięty element.
|
Powiązane elementy interfejsu API
removeItemAt | () | metoda |
public function removeItemAt(index:uint):Object| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Usuwa element o określonym indeksie i wywołuje zdarzenie DataChangeType.REMOVE.
Parametry
index:uint — Indeks elementu, który ma zostać usunięty.
|
Object — Usunięty element.
|
Zgłasza
RangeError — Podany indeks jest mniejszy niż 0 albo większy lub równy długości obiektu dostarczającego dane.
|
Powiązane elementy interfejsu API
replaceItem | () | metoda |
public function replaceItem(newItem:Object, oldItem:Object):Object| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Zastępuje istniejący element nowym elementem i wywołuje zdarzenie DataChangeType.REPLACE.
Parametry
newItem:Object — Element do zastąpienia.
| |
oldItem:Object — Element zastępczy.
|
Object — Element został zastąpiony.
|
Zgłasza
RangeError — Element nie został znaleziony w obiekcie dostarczającym dane.
|
Powiązane elementy interfejsu API
replaceItemAt | () | metoda |
public function replaceItemAt(newItem:Object, index:uint):Object| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Zastępuje element o określonym indeksie i wywołuje zdarzenie DataChangeType.REPLACE.
Parametry
newItem:Object — Element zastępczy.
| |
index:uint — Indeks elementu, który ma zostać zastąpiony.
|
Object — Element został zastąpiony.
|
Zgłasza
RangeError — Podany indeks jest mniejszy niż 0 albo większy lub równy długości obiektu dostarczającego dane.
|
Powiązane elementy interfejsu API
sort | () | metoda |
public function sort(... sortArgs):*| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Sortuje elementy zawarte w obiekcie dostarczającym dane i wywołuje zdarzenie DataChangeType.SORT.
Parametry
... sortArgs — Argumenty, na podstawie których ma być wykonane sortowanie.
|
* — Zwracana wartość jest zależna od tego, czy metoda ma argumenty. Więcej informacji można znaleźć w opisie metody Array.sort(). Ta metoda zwraca 0, gdy właściwość sortOption jest ustawiona na Array.UNIQUESORT.
|
Powiązane elementy interfejsu API
sortOn | () | metoda |
public function sortOn(fieldName:Object, options:Object = null):*| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Sortuje elementy zawarte w obiekcie dostarczającym dane według określonego pola i wywołuje zdarzenie DataChangeType.SORT. Określone pole może zawierać ciąg znaków lub tablicę ciągów znaków określających wiele pól, uwzględnianych wówczas przy sortowaniu w kolejności, w jakiej zostały podane.
Parametry
fieldName:Object — Pole elementu, według którego ma być wykonywane sortowanie. Ta wartość może być ciągiem znaków lub tablicą ciągów znaków.
| |
options:Object (default = null) — Opcje sortowania
|
* — Zwracana wartość jest zależna od tego, czy metoda ma argumenty. Więcej informacji zawiera opis metody Array.sortOn(). Jeśli właściwość sortOption jest ustawiona na Array.UNIQUESORT, ta metoda zwraca 0.
|
Powiązane elementy interfejsu API
toArray | () | metoda |
public function toArray():Array| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Tworzy obiekt Array reprezentujący dane zawarte w obiekcie dostarczającym dane.
ZwracaArray — Obiekt Array reprezentujący dane zawarte w obiekcie dostarczającym dane.
|
toString | () | metoda |
override public function toString():String| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Tworzy ciąg znaków, reprezentujący dane zawarte w obiekcie dostarczającym dane.
ZwracaString — Ciąg znaków reprezentujący dane zawarte w obiekcie dostarczającym dane.
|
dataChange | Zdarzenie |
fl.events.DataChangeEventwłaściwość DataChangeEvent.type =
fl.events.DataChangeEvent.DATA_CHANGE| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wywoływane po zmianie danych.
Definiuje wartość właściwościtype obiektu zdarzenia dataChange.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | false |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
changeType | Identyfikuje typ dokonanej zmiany. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
endIndex | Identyfikuje indeks ostatniego zmienionego elementu. |
items | Tablica z listą zmienionych elementów. |
startIndex | Identyfikuje indeks pierwszego zmienionego elementu. |
target | Obiekt, który wywołał zdarzenie. Celem nie zawsze jest obiekt wykrywający zdarzenie. Aby uzyskać dostęp do obiektu, który wykrywa zdarzenie, należy skorzystać z właściwości currentTarget. |
Powiązane elementy interfejsu API
preDataChange | Zdarzenie |
fl.events.DataChangeEventwłaściwość DataChangeEvent.type =
fl.events.DataChangeEvent.PRE_DATA_CHANGE| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wywoływane przed zmianą danych.
Definiuje wartość właściwościtype obiektu zdarzenia preDataChange. To zdarzenie jest wywoływane zanim dane składnika zostaną zmienione.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | false |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
changeType | Identyfikuje typ zmiany, która ma być dokonana. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
endIndex | Identyfikuje indeks ostatniego elementu do zmiany. |
items | Tablica z listą elementów do zmiany. |
startIndex | Identyfikuje indeks pierwszego elementu do zmiany. |
target | Obiekt, który wywołał zdarzenie. Celem nie zawsze jest obiekt wykrywający zdarzenie. Aby uzyskać dostęp do obiektu, który wykrywa zdarzenie, należy skorzystać z właściwości currentTarget. |
Powiązane elementy interfejsu API
W celu uruchomienia przykładu należy wykonać poniższe czynności:
- Dodaj do biblioteki składniki Label, Button, ComboBox, TextInput i DataGrid.
- Zapisz ten kod pod nazwą DataProviderExample.as w tym samym katalogu, co plik FLA.
- W pliku FLA ustaw klasę dokumentu na DataProviderExample.
package
{
import fl.controls.Button;
import fl.controls.ComboBox;
import fl.controls.DataGrid;
import fl.controls.Label;
import fl.controls.TextInput;
import fl.data.DataProvider;
import flash.display.Sprite;
import flash.events.*;
import flash.text.TextFieldAutoSize;
public class DataProviderExample extends Sprite
{
private var southern:DataGrid;
private var northern:DataGrid;
private var world:DataGrid;
private var southernRoster:DataProvider;
private var northernRoster:DataProvider;
private var leagueCB:ComboBox;
private var nameTI:TextInput;
private var goalsTI:TextInput;
private var submitBtn:Button;
public function DataProviderExample() {
southernRoster = new DataProvider();
northernRoster = new DataProvider();
createDataGrids();
createUI();
}
private function createUI():void {
var description:Label = new Label();
description.text = "Enter player's name, goals scored, and hemisphere of origin:";
description.autoSize = TextFieldAutoSize.LEFT;
nameTI = new TextInput();
goalsTI = new TextInput();
var submitBtn:Button = new Button();
submitBtn.label = "Submit Player";
submitBtn.addEventListener(MouseEvent.CLICK, submitPlayer);
leagueCB = new ComboBox();
leagueCB.addItem( { label:"Northern", data: 0 } );
leagueCB.addItem( { label:"Southern", data: 1 } );
description.move(10,10);
nameTI.move(10,40);
nameTI.setSize(150,24);
goalsTI.move(170,40);
goalsTI.setSize(40,24);
leagueCB.move(220,40);
leagueCB.setSize(120,24);
submitBtn.move(350,40);
goalsTI.restrict = "0123456789";
addChild(description);
addChild(leagueCB);
addChild(submitBtn);
addChild(nameTI);
addChild(goalsTI);
}
private function submitPlayer(e:MouseEvent):void {
if(nameTI.text != "" && goalsTI.text != "") {
var targetRoster:DataProvider;
if(leagueCB.selectedItem.label == "Southern") {
targetRoster = southernRoster;
}
else {
targetRoster = northernRoster;
}
targetRoster.addItem( { Name: nameTI.text, Goals: goalsTI.text } );
var worldRoster:DataProvider = southernRoster.clone();
worldRoster.merge(northernRoster);
worldRoster.sortOn("Goals", Array.NUMERIC | Array.DESCENDING);
southernRoster.sortOn("Goals", Array.NUMERIC | Array.DESCENDING);
northernRoster.sortOn("Goals", Array.NUMERIC | Array.DESCENDING);
world.dataProvider = worldRoster;
nameTI.text = "";
goalsTI.text = "";
}
}
private function createDataGrids():void {
southern = new DataGrid();
northern = new DataGrid();
world = new DataGrid();
southern.move(10,100);
northern.move(180,100);
world.move(350,100);
southern.setSize(170, 250);
northern.setSize(170, 250);
world.setSize(170, 250);
southern.columns =
northern.columns =
world.columns = [ "Name", "Goals" ];
southern.dataProvider = southernRoster;
northern.dataProvider = northernRoster;
addChild(southern);
addChild(northern);
addChild(world);
var northernLabel:Label = new Label();
northernLabel.autoSize = TextFieldAutoSize.LEFT;
northernLabel.text = "Southern Hemisphere";
northernLabel.move(10,75);
addChild(northernLabel);
var southernLabel:Label = new Label();
southernLabel.autoSize = TextFieldAutoSize.LEFT;
southernLabel.text = "Northern Hemisphere";
southernLabel.move(180,75);
addChild(southernLabel);
var majorLabel:Label = new Label();
majorLabel.autoSize = TextFieldAutoSize.LEFT;
majorLabel.text = "World";
majorLabel.move(350,75);
addChild(majorLabel);
}
}
}
Tue Jun 12 2018, 12:06 PM Z
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne