DataProvider  - AS3 Flash

Het aantal items in de gegevensaanbieder.

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);

Hiermee wordt een nieuw object DataProvider gemaakt met een lijst, een XML-instantie of een array van gegevensobjecten als gegevensbron.

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);

Hiermee wordt een item aan het einde van de gegevensaanbieder toegevoegd.

Parameters

Verwante API-elementen

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);

Hiermee wordt een nieuw item aan de gegevensaanbieder bij de opgegeven index toegevoegd. Wanneer de opgegeven index de lengte van de gegevensaanbieder overschrijdt, wordt de index genegeerd.

Parameters

Verwante API-elementen

Hiermee worden meerdere items aan het einde van de DataProvider toegevoegd en wordt een gebeurtenis DataChangeType.ADD verzonden. De items worden toegevoegd in de volgorde waarin zij worden opgegeven.

Parameters

Verwante API-elementen

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);

Hiermee worden diverse items bij de opgegeven index aan de gegevensaanbieder toegevoegd en wordt een gebeurtenis DataChangeType.ADD verzonden.

Parameters

Verwante API-elementen

Hiermee wordt een kopie van het huidige object DataProvider gemaakt.

Hiermee worden de opgegeven items aan het einde van de huidige gegevensaanbieder samengevoegd. Deze methode verzendt een gebeurtenis DataChangeType.ADD.

Parameters

Verwante API-elementen

Retourneert het item bij de opgegeven index.

Parameters

Verwante API-elementen

Retourneert de index van het opgegeven item.

Parameters

Verwante API-elementen

Hiermee worden alle gegevensitems in de DataProvider ongeldig gemaakt en wordt een gebeurtenis DataChangeEvent.INVALIDATE_ALL verzonden. Items worden ongeldig gemaakt nadat zij zijn gewijzigd; de ongeldig gemaakte items worden door de DataProvider automatisch opnieuw getekend.

Verwante API-elementen

Hiermee wordt het opgegeven item ongeldig gemaakt. Een item wordt ongeldig gemaakt nadat het is gewijzigd; het ongeldig gemaakte item wordt door de DataProvider automatisch opnieuw getekend.

Parameters

Verwante API-elementen

Hiermee wordt het item bij de opgegeven index ongeldig gemaakt. Een item wordt ongeldig gemaakt nadat het is gewijzigd; het ongeldig gemaakte item wordt door de DataProvider automatisch opnieuw getekend.

Parameters

Verwante API-elementen

Hiermee worden de opgegeven gegevens aan de gegevens in de gegevensaanbieder toegevoegd en worden alle dubbele items verwijderd. Deze methode verzendt een gebeurtenis DataChangeType.ADD.

Parameters

Verwante API-elementen

Hiermee worden alle items uit de gegevensaanbieder verwijderd en wordt een gebeurtenis DataChangeType.REMOVE_ALL verzonden.

Verwante API-elementen

Hiermee wordt het opgegeven item uit de gegevensaanbieder verwijderd en wordt een gebeurtenis DataChangeType.REMOVE verzonden.

Parameters

Verwante API-elementen

Hiermee wordt het item bij de opgegeven index verwijderd en wordt een gebeurtenis DataChangeType.REMOVE verzonden.

Parameters

Verwante API-elementen

Hiermee wordt een bestaand item door een nieuw item vervangen en wordt een gebeurtenis DataChangeType.REPLACE verzonden.

Parameters

Verwante API-elementen

Hiermee wordt het item bij de opgegeven index vervangen en wordt een gebeurtenis DataChangeType.REPLACE verzonden.

Parameters

Verwante API-elementen

Hiermee worden de items in de gegevensaanbieder gesorteerd en wordt een gebeurtenis DataChangeType.SORT verzonden.

Parameters

Verwante API-elementen

Hiermee worden de items in de gegevensaanbieder op het opgegeven veld gesorteerd en wordt een gebeurtenis DataChangeType.SORT verzonden. Het opgegeven veld kan een tekenreeks zijn, of een array van tekenreekswaarden die verschillende velden aanduiden om op te sorteren volgens prioriteit.

Parameters

Verwante API-elementen

Hiermee wordt een representatie van de gegevens in de gegevensaanbieder gemaakt in de vorm van een object Array.

Hiermee wordt een tekenreeksrepresentatie van de gegevens in de gegevensaanbieder gemaakt.

Wordt verzonden nadat de gegevens zijn gewijzigd.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

Wordt verzonden voordat de gegevens worden gewijzigd.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

U kunt als volgt het voorbeeld uitvoeren:

1. Voeg de componenten Label, Button, ComboBox, TextInput en DataGrid toe aan de bibliotheek.
2. Sla deze code op als DataProviderExample.as in dezelfde map als het FLA-bestand.
3. Stel de klasse Document in het FLA-bestand in op 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);
        }
    }
}