Paket | fl.controls |
Klass | public class List |
Arv | List SelectableList BaseScrollPane UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Implementerar | IFocusManagerComponent |
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
List-komponenten består av objekt, rader och en DataProvider, som beskrivs enligt följande:
- Objekt: Ett ActionScript-objekt som oftast har en beskrivande
label
-egenskap och endata
-egenskap som sparar data som tillhör det objektet. - Rad: En komponent som används för att visa objektet.
- DataProvider: En komponent som formger objekten som visas av List-komponenten.
List-komponenten använder som standard CellRenderer-klassen för att ange raderna som listobjekten visas i. Du kan skapa dessa rader med programkod. Det görs oftast genom att CellRenderer-klassen underklassas. Klassen CellRenderer implementerar ICellRenderer-gränssnittet, som är en uppsättning egenskaper och metoder som List-komponenten använder för att hantera varje rad och skicka data och statusinformation till raden som ska visas. Här ingår information om datastorlekar och urval.
List-komponenten har metoder som företräder dess DataProvider, till exempel metoderna addItem()
och removeItem()
. Du kan använda dessa och andra metoder för att hantera arraydata som finns i samma bildruta som en List-komponent och sedan sända ut ändringarna till flera vyer. Om ingen extern DataProvider finns med i List-komponenten skapar dessa metoder automatiskt en instans av DataProvider och visar den genom List.dataProvider
-egenskapen. List-komponenten återger varje rad genom att använda en Sprite som implementerar ICellRenderer-gränssnittet. Den här renderaren kan anges med List.cellRenderer
-egenskapen. Du kan även bygga en Array-instans eller hämta en från en server och använda den som en datamodell för flera listor, kombinationsrutor, datarutnät och så vidare.
Egenskap | Definieras med | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
Den aktuella hjälpmedelsimplementeringen (AccessibilityImplementation) för den här InteractiveObject-instansen. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
De nuvarande hjälpmedelsalternativen för det här visningsobjektet. | DisplayObject | ||
allowMultipleSelection : Boolean
Hämtar ett booleskt värde som anger om mer än ett listobjekt kan markeras åt gången. | SelectableList | ||
alpha : Number
Anger det angivna objektets alfagenomskinlighetsvärde. | DisplayObject | ||
blendMode : String
Ett värde från klassen BlendMode som anger vilket blandningsläge som ska användas. | DisplayObject | ||
blendShader : Shader [lässkyddad]
Ställer in en skuggning som används för blandning av förgrund och bakgrund. | DisplayObject | ||
buttonMode : Boolean
Anger knappläge för den här spriten. | Sprite | ||
cacheAsBitmap : Boolean
Om det är true, sparar Flash-miljöerna en intern bitmappsrepresentation av visningsobjektet i cache-minnet. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Om detta inte är null definierar det här Matrix-objektet hur ett visningsobjekt återges när cacheAsBitmap har värdet true. | DisplayObject | ||
constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | ||
contextMenu : NativeMenu
Anger vilken snabbmeny som är associerad med det här objektet. | InteractiveObject | ||
dataProvider : DataProvider
Hämtar eller ställer in datamodellen för listobjekten som ska visas. | SelectableList | ||
doubleClickEnabled : Boolean
Anger om det här objektet tar emot doubleClick-händelser. | InteractiveObject | ||
dropTarget : DisplayObject [skrivskyddad]
Anger det visningsobjekt som spriten dras över, eller som spriten släpptes på. | Sprite | ||
enabled : Boolean
Hämtar eller ställer in värde som anger om komponenten kan ta emot användarinteraktion. | UIComponent | ||
filters : Array
En indexerad array som innehåller varje filterobjekt som är associerat med visningsobjektet. | DisplayObject | ||
focusEnabled : Boolean
Hämtar eller ställer in booleskt värde som anger om komponenten kan ta emot fokus när användaren har klickat på den. | UIComponent | ||
focusManager : IFocusManager
Hämtar eller ställer in FocusManager som kontrollerar fokus för den här komponenten och dess jämlikar. | UIComponent | ||
focusRect : Object
Anger om det här objektet visar en fokusram. | InteractiveObject | ||
graphics : Graphics [skrivskyddad]
Anger det Graphics-objekt som tillhör denna sprite där kommandon för vektorritning kan göras. | Sprite | ||
height : Number [åsidosätt]
Hämtar eller ställer in komponenternas höjd, i pixlar. | UIComponent | ||
hitArea : Sprite
Utser en annan sprite som ska fungera som träffområde för en sprite. | Sprite | ||
horizontalLineScrollSize : Number
Hämtar eller ställer in ett värde som beskriver vilken mängd innehåll som ska rullas, vågrätt, när användaren klickar på en rullningspil. | BaseScrollPane | ||
horizontalPageScrollSize : Number
Hämtar eller ställer in antalet pixlar som rullningsreglaget ska flyttas med på den vågräta rullningslisten när spårning av rullningslist är aktiverad. | BaseScrollPane | ||
horizontalScrollBar : ScrollBar [skrivskyddad]
Hämtar en referens till den vågräta rullningslisten. | BaseScrollPane | ||
horizontalScrollPolicy : String
Hämtar eller ställer in ett värde som anger status för den vågräta rullningslisten. | BaseScrollPane | ||
horizontalScrollPosition : Number
Hämtar eller ställer in ett värde som beskriver den vågräta positionen för den vågräta rullningslisten i rullningsfönstret, i pixlar. | BaseScrollPane | ||
iconField : String
Hämtar eller ställer in objektfältet med objektets ikon. | List | ||
iconFunction : Function
Hämtar eller ställer in funktionen som ska användas för att hämta ikonen för objektet. | List | ||
labelField : String
Hämtar eller ställer in namnet på fältet i dataProvider-objektet som ska visas som etikett i TextInput-fältet och listrutan. | List | ||
labelFunction : Function
Hämtar eller ställer in funktionen som ska användas för att hämta etiketten för objektet. | List | ||
length : uint [skrivskyddad]
Hämtar antalet objekt i DataProvider. | SelectableList | ||
loaderInfo : LoaderInfo [skrivskyddad]
Returnerar ett LoaderInfo-objekt som innehåller information om hur filen som visningsobjektet tillhör ska läsas in. | DisplayObject | ||
mask : DisplayObject
Det anropande visningsobjektet maskeras av det angivna visningsobjektet. | DisplayObject | ||
maxHorizontalScrollPosition : Number [åsidosätt]
Hämtar eller ställer in antalet pixlar som listan kan rullas till höger, när horizontalScrollPolicy-egenskapen är inställd på ScrollPolicy.ON. | SelectableList | ||
maxVerticalScrollPosition : Number [skrivskyddad]
Hämtar maximal lodrät rullningsposition för det aktuella innehållet, i pixlar. | BaseScrollPane | ||
metaData : Object
Erhåller metadataobjektet för instansen DisplayObject om metadata har lagrats tillsammans med instansen för detta DisplayObject i SWF-filen via en PlaceObject4-tagg. | DisplayObject | ||
mouseChildren : Boolean
Avgör om objektets underordnade objekt är aktiverade för en mus eller annan användarindataenhet (eller inte). | DisplayObjectContainer | ||
mouseEnabled : Boolean
Anger om det här objektet tar emot musmeddelanden eller annan indata från användaren. | InteractiveObject | ||
mouseFocusEnabled : Boolean
Hämtar eller ställer in ett värde som anger om komponenten kan ta emot fokus när användaren har klickat på den. | UIComponent | ||
mouseX : Number [skrivskyddad]
Anger x-koordinaten för musens eller användarens indataenhets position i pixlar. | DisplayObject | ||
mouseY : Number [skrivskyddad]
Anger y-koordinaten för musens eller användarens indataenhets position i pixlar. | DisplayObject | ||
name : String
Anger instansnamnet för DisplayObject. | DisplayObject | ||
needsSoftKeyboard : Boolean
Anger om ett virtuellt tangentbord (t.ex. ett skärmtangentbord) ska visas när den här InteractiveObject-instansen är i fokus. | InteractiveObject | ||
numChildren : int [skrivskyddad]
Returnerar antalet underordnade objekt det här objektet har. | DisplayObjectContainer | ||
opaqueBackground : Object
Anger om visningsobjektet är ogenomskinligt med en viss bakgrundsfärg. | DisplayObject | ||
parent : DisplayObjectContainer [skrivskyddad]
Anger DisplayObjectContainer-objektet som innehåller visningsobjektet. | DisplayObject | ||
root : DisplayObject [skrivskyddad]
För ett visningsobjekt i en inläst SWF-fil är rotegenskapen det översta visningsobjektet i den del av visningslistans trädstruktur som representeras av den SWF-filen. | DisplayObject | ||
rotation : Number
Anger DisplayObject-instansens rotation i grader från den ursprungliga orienteringen. | DisplayObject | ||
rotationX : Number
Anger x-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren. | DisplayObject | ||
rotationY : Number
Anger y-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren. | DisplayObject | ||
rotationZ : Number
Anger z-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren. | DisplayObject | ||
rowCount : uint [åsidosätt]
Hämtar eller ställer in antalet rader som är åtminstone delvis synliga i listan. | List | ||
rowHeight : Number
Hämtar eller ställer in höjden för varje rad i listan, i pixlar. | List | ||
scale9Grid : Rectangle
Det skalningsrutnät som används för närvarande. | DisplayObject | ||
scaleX : Number [åsidosätt]
Multiplicerar komponentens aktuella bredd med en skalfaktor. | UIComponent | ||
scaleY : Number [åsidosätt]
Multiplicerar komponentens aktuella höjd med en skalfaktor. | UIComponent | ||
scaleZ : Number
Anger djupskala (procent) för objektet utifrån dess registreringspunkt. | DisplayObject | ||
scrollRect : Rectangle
Visningsobjektets gränser för rullningsrektangeln. | DisplayObject | ||
selectable : Boolean
Hämtar eller ställer in ett booleskt värde som anger om objekten i listan kan markeras. | SelectableList | ||
selectedIndex : int
Hämtar eller ställer in indexvärdet för objektet som är markerat i en lista där bara ett objekt kan vara markerat. | SelectableList | ||
selectedIndices : Array
Hämtar eller ställer in en array som innehåller objekten som markerades från en lista där flera objekt är markerade. | SelectableList | ||
selectedItem : Object
Hämtar eller ställer in objektet som markerades från en lista där bara ett objekt kan vara markerat. | SelectableList | ||
selectedItems : Array
Hämtar eller ställer in en array som innehåller objekten från en lista där flera objekt är markerade. | SelectableList | ||
softKeyboard : String
Kontrollerar utseendet på skärmtangentbordet. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Definierar det område som ska behållas på skärmen när skärmtangentbordet visas (ej tillgängligt på iOS). | InteractiveObject | ||
soundTransform : flash.media:SoundTransform
Styr ljudet i den här spriten. | Sprite | ||
stage : Stage [skrivskyddad]
Visningsobjektets scen. | DisplayObject | ||
tabChildren : Boolean
Avgör om objektets underordnade objekt är tabbaktiverade. | DisplayObjectContainer | ||
tabEnabled : Boolean
Anger om det här objektet inkluderas i tabbordningen. | InteractiveObject | ||
tabIndex : int
Anger tabbordningen för objekt i en SWF-fil. | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [skrivskyddad]
Returnerar ett TextSnapshot-objekt för den här DisplayObjectContainer-instansen. | DisplayObjectContainer | ||
transform : flash.geom:Transform
Ett objekt med egenskaper som gäller ett visningsobjekts matris, färgomformning och pixelgränser. | DisplayObject | ||
useBitmapScrolling : Boolean
Med true inställt anges värdet i cacheAsBitmap-egenskapen för rullningsinnehållet till true; med false inställt stängs värdet av. | BaseScrollPane | ||
useHandCursor : Boolean
Ett booleskt värde som anger om den pekande handen (handpekaren) ska visas när pekaren passerar över en sprite, vars buttonMode-egenskap är true. | Sprite | ||
verticalLineScrollSize : Number
Hämtar eller ställer in ett värde som beskriver hur många pixlar som ska rullas lodrätt när användaren klickar på en rullningspil. | BaseScrollPane | ||
verticalPageScrollSize : Number
Hämtar eller ställer in antalet pixlar som rullningsreglaget ska flyttas med på den lodräta rullningslisten när spårning av rullningslist är aktiverad. | BaseScrollPane | ||
verticalScrollBar : ScrollBar [skrivskyddad]
Hämtar en referens till den lodräta rullningslisten. | BaseScrollPane | ||
verticalScrollPolicy : String
Hämtar eller ställer in ett värde som anger status för den lodräta rullningslisten. | BaseScrollPane | ||
verticalScrollPosition : Number
Hämtar eller ställer in ett värde som beskriver den lodräta positionen för den lodräta rullningslisten i rullningsfönstret, i pixlar. | BaseScrollPane | ||
visible : Boolean [åsidosätt]
Hämtar eller ställer in värde som anger om den aktuella komponentinstansen är synlig. | UIComponent | ||
width : Number [åsidosätt]
Hämtar eller ställer in komponenternas bredd, i pixlar. | UIComponent | ||
x : Number [åsidosätt]
Hämtar eller ställer in x-koordinaten som motsvarar komponentens position längs x-axeln inom dess överordnade behållare. | UIComponent | ||
y : Number [åsidosätt]
Hämtar eller ställer in y-koordinaten som motsvarar komponentens position längs y-axeln inom dess överordnade behållare. | UIComponent | ||
z : Number
Anger z-koordinatens position längs DisplayObject-instansens z-axel i förhållande till den överordnade 3D-behållaren. | DisplayObject |
Metod | Definieras med | ||
---|---|---|---|
List()
Skapar en ny instans av komponenten List. | List | ||
Lägger till en underordnad DisplayObject-instans i den här DisplayObjectContainer-instansen. | DisplayObjectContainer | ||
Lägger till en underordnad DisplayObject-instans i den här DisplayObjectContainer-instansen. | DisplayObjectContainer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser. | EventDispatcher | ||
Lägg till ett objekt i slutet av objektlistan. | SelectableList | ||
Infogar ett objekt i listan vid den angivna indexplatsen. | SelectableList | ||
Anger om säkerhetsrestriktionerna kan göra att visningsobjekt utelämnas från listan som returneras när metoden DisplayObjectContainer.getObjectsUnderPoint() anropas med den angivna punkten. | DisplayObjectContainer | ||
Tar bort ett format som angetts för renderarna i listan. | SelectableList | ||
Rensar det objekt i listan som är markerat för tillfället och ställer in selectedIndex-egenskapen på -1. | SelectableList | ||
Tar bort en formategenskap från den här komponentinstansen. | UIComponent | ||
Avgör om det angivna visningsobjektet är underordnat DisplayObjectContainer-instansen eller själva instansen. | DisplayObjectContainer | ||
Skickar en händelse till händelseflödet. | EventDispatcher | ||
Visar eller döljer fokusindikatorn på komponenten. | UIComponent | ||
Initierar omedelbar ritning utan att göra allt ogiltigt som invalidateNow gör. | UIComponent | ||
Returnerar en rektangel som definierar visningsområdets område i relation till targetCoordinateSpace-objektets koordinatsystem. | DisplayObject | ||
Returnerar den underordnade visningsobjektsinstansen som finns vid det angivna indexvärdet. | DisplayObjectContainer | ||
Returnerar det underordnade visningsobjektet som har ett visst namn. | DisplayObjectContainer | ||
Returnerar indexpositionen för en underordnad DisplayObject-instans. | DisplayObjectContainer | ||
Hämtar objektet som är i fokus. | UIComponent | ||
Hämtar objektet vid det angivna indexvärdet. | SelectableList | ||
Returnerar indexvärdet för nästa objekt i den dataProvider där etikettens första tecken matchar ett angivet strängtecken. | SelectableList | ||
Returnerar en array med objekt som ligger under den angivna punkten och är underordnade (eller indirekt underordnade) den här DisplayObjectContainer-instansen. | DisplayObjectContainer | ||
Returnerar en rektangel som definierar visningsområdets gräns, baserat på koordinatsystemet som definieras av targetCoordinateSpace-parametern, exklusive eventuella linjer i former. | DisplayObject | ||
Hämtar ett format som angetts för renderarna i listan. | SelectableList | ||
Hämtar en formategenskap som är inställd i komponentens sökkedja. | UIComponent | ||
[statisk]
Hämtar standardformatförskjutningen för den aktuella komponenten. | List | ||
Konverterar punktobjektet från scenens (globala) koordinater till visningsobjektets (lokala) koordinater. | DisplayObject | ||
Konverterar en tvådimensionell punkt från scenens (globala) koordinater till ett tredimensionellt visningsobjekts (lokala) koordinater. | DisplayObject | ||
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse. | EventDispatcher | ||
Anger om det finns en egenskap angiven för ett objekt. | Object | ||
Utvärderar begränsningsramen för visningsobjektet för att kontrollera om den överlappar eller korsar begränsningsramen för obj-visningsobjektet. | DisplayObject | ||
Utvärderar visningsobjektet för att avgöra om det överlappar eller korsar den punkt som anges av x- och y-parametrarna. | DisplayObject | ||
Markerar en egenskap som ogiltig och ritar om komponenten i nästa bildruta om inte annat anges. | UIComponent | ||
Gör en specifik objektrenderare ogiltig. | SelectableList | ||
Gör renderaren ogiltig för objektet vid det angivna indexvärdet. | SelectableList | ||
Gör hela listan ogiltig. Alla objekt måste göras om. | SelectableList | ||
Kontrollerar om det angivna objektet har markerats i listan. | SelectableList | ||
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | ||
Hämtar ICellRenderer för ett angivet objekt om det finns något. | SelectableList | ||
[åsidosätt]
Hämtar den sträng renderaren visar för det givna dataobjektet baserat på egenskaperna labelField och labelFunction. | List | ||
Konverterar en tredimensionell punkt för det tredimensionella visningsobjektets (lokala) koordinater till en tvådimensionell punkt i scenens (globala) koordinater. | DisplayObject | ||
Konverterar punktobjektet från visningsobjektets (lokala) koordinater till scenens (globala) koordinater. | DisplayObject | ||
[statisk]
Sammanfogar format från flera klasser till ett objekt. | UIComponent | ||
Flyttar komponenten till den angivna positionen inom dess överordnade. | UIComponent | ||
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | ||
Tar bort alla objekt från listan. | SelectableList | ||
Tar bort den angivna underordnade DisplayObject-instansen från listan med underordnade för DisplayObjectContainer-instansen. | DisplayObjectContainer | ||
Tar bort ett underordnat DisplayObject från den angivna indexpositionen i den underordnade listan i DisplayObjectContainer. | DisplayObjectContainer | ||
Tar bort alla child-DisplayObject-instanser från listan med underordnade för DisplayObjectContainer-instansen. | DisplayObjectContainer | ||
Tar bort en avlyssnare från EventDispatcher-objektet. | EventDispatcher | ||
Tar bort det angivna objektet från listan. | SelectableList | ||
Tar bort objektet vid den angivna indexpositionen. | SelectableList | ||
Ersätter objektet vid den angivna indexplatsen med ett annat objekt. | SelectableList | ||
Visar ett virtuellt tangentbord. | InteractiveObject | ||
[åsidosätt]
Rullar listan till objektet vid det angivna indexvärdet. | List | ||
Rullar listan till objektet på den plats som anges av det aktuella värdet för selectedIndex-egenskapen. | SelectableList | ||
Ändrar positionen för ett befintligt underordnat objekt i behållaren för visningsobjekt. | DisplayObjectContainer | ||
Ställer in fokus på den här komponenten. | UIComponent | ||
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | ||
Ställer in ett format för renderarna i listan. | SelectableList | ||
Ställer in komponenten på angiven bredd och höjd. | UIComponent | ||
Ställer in en formategenskap för en komponentinstans. | UIComponent | ||
Sorterar elementen i aktuell DataProvider. | SelectableList | ||
Sorterar elementen i aktuell DataProvider efter en eller flera fält. | SelectableList | ||
Gör att användaren kan dra angiven sprite. | Sprite | ||
Låter användaren dra angiven sprite på en beröringsaktiverad enhet. | Sprite | ||
Stoppar rekursivt tidslinjekörning av alla filmklipp vars rot är detta objekt. | DisplayObjectContainer | ||
Avslutar metoden startDrag(). | Sprite | ||
Avslutar metoden startTouchDrag(), som används med beröringsaktiverade enheter. | Sprite | ||
Byter z-ordningen (framifrån och bakåt-ordning) för de två underordnade objekten. | DisplayObjectContainer | ||
Byter z-ordningen (framifrån och bakåt-ordning) för underordnade objekt vid de två angivna indexpositionerna i listan med underordnade objekt. | DisplayObjectContainer | ||
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | ||
Returnerar det angivna objektets strängbeteckning. | Object | ||
Validerar och uppdaterar egenskaper och layout för det här objektet och ritar om det vid behov. | UIComponent | ||
Returnerar det angivna objektets primitiva värde. | Object | ||
Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen. | EventDispatcher |
Format är antingen allmänna eller kopplade till ett visst tema. Om formatet är allmänt kan det användas med alla teman. Om ett format är kopplat till ett visst tema kan det bara användas om programmet använder just det temat.
iconField | egenskap |
iconField:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Hämtar eller ställer in objektfältet med objektets ikon.
Obs! iconField
används inte om egenskapen iconFunction
är inställd på en callback-funktion.
Standardvärdet är "icon".
Implementering
public function get iconField():String
public function set iconField(value:String):void
Exempel ( Så här använder du exemplet )
RedBox
måste finnas i biblioteket och "Exportera för ActionScript" ska vara aktiverat i symbolegenskaperna:
import fl.data.DataProvider; import fl.controls.List; var dp:DataProvider = new DataProvider(); dp.addItem( { iconSource:RedBox, label:"Item 1" } ); dp.addItem( { iconSource:RedBox, label:"Item 2" } ); dp.addItem( { iconSource:RedBox, label:"Item 3" } ); var list:List = new List(); list.iconField = "iconSource"; list.dataProvider = dp; addChild(list);
iconFunction | egenskap |
iconFunction:Function
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Hämtar eller ställer in funktionen som ska användas för att hämta ikonen för objektet.
Obs! iconField
används inte om egenskapen iconFunction
är inställd på en callback-funktion.
Standardvärdet är null.
Implementering
public function get iconFunction():Function
public function set iconFunction(value:Function):void
Exempel ( Så här använder du exemplet )
iconFunction
-egenskapen för att tillhandahålla en ikon till ett begränsat antal objekt i en lista. En symbol med namnet RedBox
måste finnas i biblioteket och "Exportera för ActionScript" ska vara aktiverat i symbolegenskaperna för att det här exemplet ska fungera:
import fl.data.DataProvider; import fl.controls.List; var dp:DataProvider = new DataProvider(); dp.addItem( { label:"Item 1" } ); dp.addItem( { label:"Item 2" } ); dp.addItem( { label:"Item 3" } ); var list:List = new List(); list.iconFunction = determineIcon; list.dataProvider = dp; addChild(list); function determineIcon(item:Object):String { if(item.label == "Item 2") { return "RedBox"; } else { return null; } }
labelField | egenskap |
labelField:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Hämtar eller ställer in namnet på fältet i dataProvider
-objektet som ska visas som etikett i TextInput-fältet och listrutan.
Komponenten visar som standard label
-egenskapen för varje dataProvider
-objekt. Om dataProvider
-objekten inte innehåller en label
-egenskap kan du ange att labelField
-egenskapen ska använda en annan egenskap.
Obs! labelField
-egenskapen används inte om egenskapen labelFunction
är inställd på en callback-funktion.
Standardvärdet är "label".
Implementering
public function get labelField():String
public function set labelField(value:String):void
Relaterade API-element
Exempel ( Så här använder du exemplet )
abbreviatedLabel
-egenskapen istället för label
-standardegenskapen:
import fl.data.DataProvider; import fl.controls.List; var dp:DataProvider = new DataProvider(); dp.addItem( { abbreviatedLabel:"NY", label:"New York" } ); dp.addItem( { abbreviatedLabel:"CA", label:"California" } ); dp.addItem( { abbreviatedLabel:"WA", label:"Washington" } ); dp.addItem( { abbreviatedLabel:"CT", label:"Connecticut" } ); dp.addItem( { abbreviatedLabel:"VT", label:"Vermont" } ); var list:List = new List(); list.setSize(40,100); list.labelField = "abbreviatedLabel" list.dataProvider = dp; addChild(list);
labelFunction | egenskap |
labelFunction:Function
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Hämtar eller ställer in funktionen som ska användas för att hämta etiketten för objektet.
Komponenten visar som standard label
-egenskapen för ett dataProvider
-objekt. Det är inte säkert att alla datauppsättningar har ett label
-fält eller ett fält vars värde kan användas som en etikett utan ändring. En viss datauppsättning kanske t.ex. sparar fullständiga namn men behåller dem i lastName
- och firstName
-fälten. I så fall kan den här egenskapen användas för att ange en callback-funktion som sammanfogar värdena i lastName
- och firstName
-fälten till en fullständig namnsträng som ska visas.
Obs! labelField
-egenskapen används inte om egenskapen labelFunction
är inställd på en callback-funktion.
Standardvärdet är null.
Implementering
public function get labelFunction():Function
public function set labelFunction(value:Function):void
Exempel ( Så här använder du exemplet )
labelFunction
in i en lista på en funktion som formaterar strängen som ska visas i varje cell:
import fl.data.DataProvider; import fl.controls.List; var myDataProvider:DataProvider = new DataProvider(); myDataProvider.addItem({name:"User A", price:0.43}); myDataProvider.addItem({name:"User B", price:0.34}); var users:List = new List(); users.dataProvider = myDataProvider; users.labelFunction = myLabelFunction; addChild(users); function myLabelFunction(item:Object):String { return item.name + " ($" + item.price.toFixed(2) + ")"; }
rowCount | egenskap |
rowCount:uint
[åsidosätt] Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Hämtar eller ställer in antalet rader som är åtminstone delvis synliga i listan.
Implementering
override public function get rowCount():uint
override public function set rowCount(value:uint):void
Exempel ( Så här använder du exemplet )
rowCount
spåras:
import fl.data.DataProvider; import fl.controls.List; var dp:DataProvider = new DataProvider(); var i:uint; for(i=0; i<100; i++) { dp.addItem( { label: "Item " + i } ); } var list:List = new List(); list.setSize(100,300); list.dataProvider = dp; addChild(list); trace(list.rowCount); // 15
rowCount
baserat på skjutreglagets aktuella värde:
import fl.controls.Slider; import fl.controls.List; import fl.data.DataProvider; import fl.events.SliderEvent; var dp:DataProvider = new DataProvider(); var i:int; for (i=0; i<8; i++) { dp.addItem({label:"Item " + i}); } var mySlider:Slider = new Slider(); mySlider.move(10, 10); mySlider.tickInterval = 1; mySlider.snapInterval = 1; mySlider.minimum = 2; mySlider.maximum = 9; mySlider.liveDragging = true; mySlider.addEventListener(SliderEvent.CHANGE, changeHandler); addChild(mySlider); var myList:List = new List(); myList.dataProvider = dp; myList.move(mySlider.x, mySlider.y + 20); myList.setSize(100, 50); addChild(myList); function changeHandler(event:SliderEvent):void { myList.rowCount = event.value; }
rowHeight | egenskap |
rowHeight:Number
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Hämtar eller ställer in höjden för varje rad i listan, i pixlar.
Standardvärdet är 20.
Implementering
public function get rowHeight():Number
public function set rowHeight(value:Number):void
List | () | Konstruktor |
public function List()
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Skapar en ny instans av komponenten List.
getStyleDefinition | () | metod |
public static function getStyleDefinition():Object
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Hämtar standardformatförskjutningen för den aktuella komponenten. Formatförskjutningen innehåller den type som är lämplig för komponenten, beroende på det format komponenten använder. Till exempel innehåller formatet disabledTextFormat
värdet null
eller ett TextFormat-objekt. Du kan använda dessa format och anropa setStyle()
på den aktuella komponenten. Följande kod åsidosätter standardformatet för disabledTextFormat
för den angivna komponenten:
componentInstance.setStyle("disabledTextFormat", new TextFormat());
Object — Objekt i standardformat.
|
Relaterade API-element
Exempel ( Så här använder du exemplet )
import fl.controls.*; import fl.containers.*; import fl.controls.listClasses.*; import fl.controls.dataGridClasses.*; import fl.controls.progressBarClasses.*; import fl.core.UIComponent; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem( { label: "BaseScrollPane", data:BaseScrollPane } ); dp.addItem( { label: "Button", data:Button } ); dp.addItem( { label: "CellRenderer", data:CellRenderer } ); dp.addItem( { label: "CheckBox", data:CheckBox } ); dp.addItem( { label: "ColorPicker", data:ColorPicker } ); dp.addItem( { label: "ComboBox", data:ComboBox } ); dp.addItem( { label: "DataGrid", data:DataGrid } ); dp.addItem( { label: "HeaderRenderer", data:HeaderRenderer } ); dp.addItem( { label: "ImageCell", data:ImageCell } ); dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } ); dp.addItem( { label: "Label", data:Label } ); dp.addItem( { label: "List", data:List } ); dp.addItem( { label: "NumericStepper", data:NumericStepper } ); dp.addItem( { label: "ProgressBar", data:ProgressBar } ); dp.addItem( { label: "RadioButton", data:RadioButton } ); dp.addItem( { label: "ScrollPane", data:ScrollPane } ); dp.addItem( { label: "Slider", data:Slider } ); dp.addItem( { label: "TextArea", data:TextArea } ); dp.addItem( { label: "TextInput", data:TextInput } ); dp.addItem( { label: "TileList", data:TileList } ); dp.addItem( { label: "UILoader", data:UILoader } ); dp.addItem( { label: "UIComponent", data:UIComponent } ); var cb:ComboBox = new ComboBox(); cb.move(10,10); cb.setSize(300,25); cb.prompt = "Select a component to view its styles"; cb.rowCount = 12; cb.dataProvider = dp; cb.addEventListener(Event.CHANGE, showStyleDefinition); addChild(cb); var dg:DataGrid = new DataGrid(); dg.setSize(425,300); dg.move(10,50); dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ]; addChild(dg); function showStyleDefinition(e:Event):void { var componentClass:Class = e.target.selectedItem.data as Class; var styles:Object = componentClass["getStyleDefinition"].call(this); trace(styles.toString()); var styleData:DataProvider = new DataProvider(); for(var i:* in styles) { trace(i + " : " + styles[i]); styleData.addItem( { StyleName:i, DefaultValue:styles[i] } ); } styleData.sortOn("StyleName"); dg.dataProvider = styleData; }
itemToLabel | () | metod |
override public function itemToLabel(item:Object):String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Hämtar den sträng renderaren visar för det givna dataobjektet baserat på egenskaperna labelField
och labelFunction
.
Obs! labelField
används inte om egenskapen labelFunction
är inställd på en callback-funktion.
Parametrar
item:Object — Objektet som ska renderas.
|
String — Strängen som ska visas baserad på data.
|
Exempel ( Så här använder du exemplet )
import fl.controls.List; import fl.data.DataProvider; import fl.events.ListEvent; var myDataProvider:DataProvider = new DataProvider(); myDataProvider.addItem({label:"Carrot", price:0.43}); myDataProvider.addItem({label:"Tomato", price:0.34}); myDataProvider.addItem({label:"Blueberry", price:0.72}); myDataProvider.addItem({label:"Turnip", price:0.24}); var myList:List = new List(); myList.setSize(300,80); myList.dataProvider = myDataProvider; myList.labelFunction = myLabelFunction; myList.addEventListener(ListEvent.ITEM_ROLL_OVER, announceLabel); addChild(myList); function myLabelFunction(item:Object):String { return item.label + " - Current price: ($" + item.price.toFixed(2) + ")"; } function announceLabel(e:ListEvent):void { var list:List = e.target as List; var item:Object = e.item; trace("Label: " + item.label); trace("Label displayed: " + list.itemToLabel(item)); }
scrollToIndex | () | metod |
override public function scrollToIndex(newCaretIndex:int):void
Språkversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Körningsmiljöversioner: | Flash Player 9.0.28.0, AIR 1.0 |
Rullar listan till objektet vid det angivna indexvärdet. Om indexvärdet ligger utanför intervallet ändras inte rullningspositionen.
Parametrar
newCaretIndex:int — Indexplatsen som du ska bläddra till.
|
- Lägg till List-, Button- och Label-klasserna i biblioteket.
- Spara koden som ListExample.as i samma katalog som din FLA-fil.
- Ställ in ListExample som DocumentClass i FLA-filen.
package { import flash.display.Sprite public class ListExample extends Sprite { import flash.events.*; import fl.data.DataProvider; import fl.controls.List import fl.controls.Label import fl.controls.Button private var clearButton:Button; private var availableItems:List; private var selectedItemList:List; private var selectedItemsList:List; public function ListExample() { createComponents(); setupComponents(); } private function setupComponents():void { var dp:Array = new Array(); var i:uint; var count:uint = availableItems.rowCount * 2; for (i = 0; i < count; i++) { dp.push({label:"Item " + i}); } availableItems.allowMultipleSelection = true; availableItems.dataProvider = new DataProvider(dp); availableItems.addEventListener(Event.CHANGE, updateLists); clearButton.addEventListener(MouseEvent.CLICK, clearHandler); } private function clearHandler(event:MouseEvent):void { availableItems.clearSelection(); // clear data providers selectedItemList.dataProvider = new DataProvider(); selectedItemsList.dataProvider = new DataProvider(); } private function updateLists(e:Event):void { selectedItemList.dataProvider = availableItems.selectedItem ? new DataProvider([availableItems.selectedItem]) : new DataProvider(); selectedItemsList.dataProvider = new DataProvider(availableItems.selectedItems); } private function createComponents():void { clearButton = new Button(); availableItems = new List(); selectedItemList = new List(); selectedItemsList = new List(); var availableItemsLabel:Label = new Label(); var selectedItemListLabel:Label = new Label(); var selectedItemsListLabel:Label = new Label(); clearButton.move(10,142); availableItems.move(10,32); selectedItemList.move(120,32); selectedItemsList.move(230,32); availableItemsLabel.move(10,10); selectedItemListLabel.move(120,10); selectedItemsListLabel.move(230,10); clearButton.label = "Clear Selection" availableItemsLabel.text = "Available Items"; selectedItemListLabel.text = "Selected Item"; selectedItemsListLabel.text = "All Selected Items"; addChild(clearButton); addChild(availableItems); addChild(selectedItemList); addChild(selectedItemsList); addChild(availableItemsLabel); addChild(selectedItemListLabel); addChild(selectedItemsListLabel); } } }
Tue Jun 12 2018, 01:40 PM Z