DataProvider를 사용한 작업

ComboBox, List 및 TileList 구성 요소의 경우에는 제작 환경에서 dataProvider 매개 변수를 사용하여 DataProvider를 만들 수 있습니다. 여러 열을 포함할 수 있는 DataGrid 구성 요소의 경우에는 데이터 공급자가 더 복잡하기 때문에 속성 관리자에 dataProvider 매개 변수가 없습니다. ActionScript를 사용하여 DataGrid를 비롯한 이들 구성 요소의 DataProvider를 만들 수도 있습니다.

addItem() 및 addItemAt() 메서드는 DataProvider에 항목을 추가하는 데 사용됩니다. 다음 예제에서는 사용자가 편집 가능한 ComboBox의 텍스트 필드에 입력하는 항목을 추가합니다. 이 예제에서는 ComboBox를 스테이지에 드래그하고 인스턴스 이름을 aCb 로 지정했다고 가정합니다.

import fl.data.DataProvider; 
import fl.events.ComponentEvent; 
 
var items:Array = [ 
{label:"Roger"}, 
{label:"Carolyn"}, 
{label:"Darrell"}, 
{label:"Rebecca"}, 
{label:"Natalie"}, 
{label:"Mitchell"}, 
]; 
aCb.dataProvider = new DataProvider(items); 
     
aCb.addEventListener(ComponentEvent.ENTER, newItemHandler); 
 
function newItemHandler(event:ComponentEvent):void { 
    var newRow:int = event.target.length + 1; 
        event.target.addItemAt({label:event.target.selectedLabel}, 
        event.target.length); 
}

DataProvider를 통해 구성 요소의 항목을 바꾸거나 제거할 수도 있습니다. 다음 예제에서는 listA 와 listB 라는 두 개의 List 구성 요소를 구현하고 Sync라는 레이블이 지정된 Button을 제공합니다. 사용자가 Button을 클릭하면 replaceItemAt() 메서드를 통해 listB 의 항목이 listA 의 항목으로 바뀝니다. listA 가 listB 보다 긴 경우에는 addItem() 메서드를 호출하여 listB 에 항목을 더 추가합니다. 또한 listB 가 listA 보다 긴 경우에는 removeItemAt() 메서드를 호출하여 ListB 의 남는 항목을 제거합니다.

// Requires the List and Button components to be in the library 
 
import fl.controls.List; 
import fl.controls.Button; 
import flash.events.Event; 
import fl.data.DataProvider; 
 
var listA:List = new List(); 
var listB:List = new List(); 
var syncButton:Button = new Button(); 
syncButton.label = "Sync"; 
 
var itemsA:Array = [ 
{label:"David"}, 
{label:"Colleen"}, 
{label:"Sharon"}, 
{label:"Ronnie"}, 
{label:"James"}, 
]; 
var itemsB:Array = [ 
{label:"Roger"}, 
{label:"Carolyn"}, 
{label:"Darrell"}, 
{label:"Rebecca"}, 
{label:"Natalie"}, 
{label:"Mitchell"}, 
]; 
listA.dataProvider = new DataProvider(itemsA); 
listB.dataProvider = new DataProvider(itemsB); 
 
addChild(listA); 
addChild(listB); 
addChild(syncButton); 
 
listA.move(100, 100); 
listB.move(250, 100); 
syncButton.move(175, 220); 
 
syncButton.addEventListener(MouseEvent.CLICK, syncHandler); 
 
function syncHandler(event:MouseEvent):void { 
    var i:uint = 0; 
    if(listA.length > listB.length) {     //if listA is longer, add items to B 
        while(i < listB.length) { 
            listB.dataProvider.replaceItemAt(listA.dataProvider.getItemAt(i), i); 
            ++i; 
        } 
        while(i < listA.length) { 
            listB.dataProvider.addItem(listA.dataProvider.getItemAt(i++)); 
        } 
    } else if(listA.length == listB.length) { //if listA and listB are equal length 
        while(i < listB.length) { 
            listB.dataProvider.replaceItemAt(listA.dataProvider.getItemAt(i), i); 
            ++i; 
        } 
    } else {                //if listB is longer, remove extra items from B 
        while(i < listA.length) { 
            listB.dataProvider.replaceItemAt(listA.dataProvider.getItemAt(i), i); 
            ++i; 
        } 
        while(i < listB.length) { 
            listB.dataProvider.removeItemAt(i++); 
        } 
    } 
}

merge() , sort() 및 sortOn() 메서드를 사용하여 DataProvider를 병합하거나 정렬할 수도 있습니다. 다음은 aDg 와 bDg 라는 두 개의 DataGrid 인스턴스를 소프트볼 팀 명단으로 채웁니다. 그런 다음 레이블이 Merge인 Button을 추가합니다. 사용자가 이 Button을 클릭하면 이벤트 핸들러( mrgHandler )가 bDg 의 명단과 aDg 의 명단을 병합하고 Name 열에서 결과 DataGrid를 정렬합니다.

import fl.data.DataProvider; 
import fl.controls.DataGrid; 
import fl.controls.Button; 
 
var aDg:DataGrid = new DataGrid(); 
var bDg:DataGrid = new DataGrid(); 
var mrgButton:Button = new Button(); 
addChild(aDg); 
addChild(bDg); 
addChild(mrgButton); 
bldRosterGrid(aDg); 
bldRosterGrid(bDg); 
var aRoster:Array = new Array(); 
var bRoster:Array = new Array(); 
aRoster = [ 
        {Name:"Wilma Carter", Bats:"R", Throws:"R", Year:"So", Home: "Redlands, CA"},  
        {Name:"Sue Pennypacker", Bats:"L", Throws:"R", Year:"Fr", Home: "Athens, GA"}, 
        {Name:"Jill Smithfield", Bats:"R", Throws:"L", Year:"Sr", Home: "Spokane, WA"}, 
        {Name:"Shirley Goth", Bats:"R", Throws:"R", Year:"Sr", Home: "Carson, NV"} 
]; 
bRoster = [ 
        {Name:"Angelina Davis", Bats:"R", Throws:"R", Year:"So", Home: "Odessa, TX"}, 
        {Name:"Maria Santiago", Bats:"L", Throws:"L", Year:"Sr", Home: "Tacoma, WA"}, 
        {Name:"Debbie Ferguson", Bats:"R", Throws:"R", Year: "Jr", Home: "Bend, OR"} 
]; 
aDg.dataProvider = new DataProvider(aRoster); 
bDg.dataProvider = new DataProvider(bRoster); 
aDg.move(50,50); 
aDg.rowCount = aDg.length; 
bDg.move(50,200); 
bDg.rowCount = bDg.length; 
mrgButton.label = "Merge"; 
mrgButton.move(200, 315); 
mrgButton.addEventListener(MouseEvent.CLICK, mrgHandler); 
 
function bldRosterGrid(dg:DataGrid){ 
    dg.setSize(400, 300); 
    dg.columns = ["Name", "Bats", "Throws", "Year", "Home"]; 
    dg.columns[0].width = 120; 
    dg.columns[1].width = 50; 
    dg.columns[2].width = 50; 
    dg.columns[3].width = 40; 
    dg.columns[4].width = 120; 
}; 
 
function mrgHandler(event:MouseEvent):void { 
    aDg.dataProvider.merge(bDg.dataProvider); 
    aDg.dataProvider.sortOn("Name"); 
}

자세한 내용은 ActionScript 3.0 참조 설명서 를 참조하십시오.