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():uint
Przykł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.DataChangeEvent
wł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.DataChangeEvent
wł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