Pacchetto | fl.controls |
Classe | public class List |
Ereditarietà | List SelectableList BaseScrollPane UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Implementa | IFocusManagerComponent |
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Il componente List è composto da voci, da righe e da un fornitore di dati, che sono descritti di seguito:
- Voce: un oggetto ActionScript che solitamente contiene una proprietà
label
descrittiva e una proprietàdata
che memorizza i dati associati alla voce. - Riga: un componente usato per visualizzare la voce.
- Fornitore di dati: un componente che modella le voci visualizzate dal componente List.
Per impostazione predefinita, il componente List utilizza la classe CellRenderer per fornire le righe in cui vengono visualizzate le voci di elenco. Potete creare queste righe a livello di codice, generalmente suddividendo in classi la classe CellRenderer. La classe CellRenderer implementa l'interfaccia CellRenderer, che fornisce il set di proprietà e metodi utilizzato dal componente List per manipolare le proprie righe e inviare dati e informazioni sullo stato a ogni riga da visualizzare. Le informazioni includono le dimensioni e la selezione dei dati.
Il componente List fornisce dei metodi che agiscono sul relativo fornitore di dati; ad esempio, i metodi addItem()
e removeItem()
. Potete utilizzare questi e altri metodi per manipolare i dati di qualunque array presente nello stesso frame come componente List e successivamente distribuire le modifiche a più visualizzazioni. Se a un componente List non viene fornito un fornitore di dati esterno, questi metodi creano automaticamente un'istanza di un fornitore di dati che viene elaborata con la proprietà List.dataProvider
. Il componente List esegue il rendering di ogni riga mediante uno Sprite che implementa l'interfaccia ICellRenderer. Per specificare questo renderer, utilizzate la proprietà List.cellRenderer
. Potete anche creare un'istanza Array o chiamarne una da un server e usarla come modello di dati per più elenchi, caselle combinate, griglie dati e così via.
Proprietà | Definito da | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
L'implementazione di accessibilità corrente (AccessibilityImplementation) di questa istanza InteractiveObject. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
Le opzioni di accessibilità correnti di questo oggetto di visualizzazione. | DisplayObject | ||
allowMultipleSelection : Boolean
Ottiene un valore booleano che indica se è possibile selezionare più di una voce di elenco per volta. | SelectableList | ||
alpha : Number
Indica il valore della trasparenza alfa dell'oggetto specificato. | DisplayObject | ||
blendMode : String
Un valore della classe BlendMode che specifica il metodo di fusione da utilizzare. | DisplayObject | ||
blendShader : Shader [sola scrittura]
Imposta uno shader utilizzato per la fusione dei colori di primo piano e sfondo. | DisplayObject | ||
buttonMode : Boolean
Specifica la modalità pulsante di questo sprite. | Sprite | ||
cacheAsBitmap : Boolean
Se è impostata su true, nella cache dei runtime Flash viene memorizzata una rappresentazione bitmap interna dell'oggetto di visualizzazione. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Se il valore è diverso da null, questo oggetto Matrix definisce il modo in cui viene eseguito il rendering di un oggetto di visualizzazione quando cacheAsBitmap è impostato su true. | DisplayObject | ||
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
contextMenu : NativeMenu
Specifica il menu di scelta rapida associato all'oggetto. | InteractiveObject | ||
dataProvider : DataProvider
Ottiene o imposta il modello di dati dell'elenco di voci da visualizzare. | SelectableList | ||
doubleClickEnabled : Boolean
Specifica se l'oggetto riceve gli eventi doubleClick. | InteractiveObject | ||
dropTarget : DisplayObject [sola lettura]
Specifica l'oggetto di visualizzazione sopra il quale viene trascinato lo sprite o sul quale viene rilasciato. | Sprite | ||
enabled : Boolean
Ottiene o imposta un valore che indica se il componente può accettare l'interazione dell'utente. | UIComponent | ||
filters : Array
Un array indicizzato che contiene ogni oggetto filtro attualmente associato all'oggetto di visualizzazione. | DisplayObject | ||
focusEnabled : Boolean
Ottiene o imposta un valore booleano che indica se il componente può ricevere l'attivazione quando un utente fa clic su di esso. | UIComponent | ||
focusManager : IFocusManager
Ottiene o imposta il FocusManager che controlla l'attivazione di questo componente e dei suoi pari. | UIComponent | ||
focusRect : Object
Specifica se l'oggetto visualizza un rettangolo di attivazione. | InteractiveObject | ||
graphics : Graphics [sola lettura]
Specifica l'oggetto Graphics che appartiene a questo oggetto Sprite, in cui possono essere eseguiti i comandi di disegno vettoriale. | Sprite | ||
height : Number [override]
Ottiene o imposta l'altezza del componente in pixel. | UIComponent | ||
hitArea : Sprite
Definisce un altro sprite come area attiva di uno sprite. | Sprite | ||
horizontalLineScrollSize : Number
Ottiene o imposta un valore che descrive la quantità di contenuto da scorrere in senso orizzontale quando viene fatto clic su una freccia di scorrimento. | BaseScrollPane | ||
horizontalPageScrollSize : Number
Ottiene o imposta il numero di pixel per cui spostare la casella di scorrimento sulla barra di scorrimento orizzontale quando viene premuta la traccia della barra di scorrimento. | BaseScrollPane | ||
horizontalScrollBar : ScrollBar [sola lettura]
Ottiene un riferimento alla barra di scorrimento orizzontale. | BaseScrollPane | ||
horizontalScrollPolicy : String
Ottiene o imposta un valore che indica lo stato della barra di scorrimento orizzontale. | BaseScrollPane | ||
horizontalScrollPosition : Number
Ottiene o imposta un valore che descrive la posizione orizzontale, espressa in pixel, della barra di scorrimento orizzontale nel pannello di scorrimento. | BaseScrollPane | ||
iconField : String
Ottiene o imposta il campo delle voci che fornisce l'icona per la voce. | List | ||
iconFunction : Function
Ottiene o imposta la funzione da utilizzare per ottenere l'icona per la voce. | List | ||
labelField : String
Ottiene o imposta il nome del campo dell'oggetto dataProvider da visualizzare come etichetta del campo e dell'elenco a discesa TextInput. | List | ||
labelFunction : Function
Ottiene o imposta la funzione da utilizzare per ottenere l'etichetta per la voce. | List | ||
length : uint [sola lettura]
Ottiene il numero di voci presenti nel fornitore di dati. | SelectableList | ||
loaderInfo : LoaderInfo [sola lettura]
Restituisce un oggetto LoaderInfo contenente informazioni sul caricamento del file al quale questo oggetto di visualizzazione appartiene. | DisplayObject | ||
mask : DisplayObject
L'oggetto di visualizzazione chiamante viene mascherato dall'oggetto mask specificato. | DisplayObject | ||
maxHorizontalScrollPosition : Number [override]
Ottiene o imposta il numero di pixel per cui l'elenco scorre verso destra, quando la proprietà horizontalScrollPolicy è impostata su ScrollPolicy.ON. | SelectableList | ||
maxVerticalScrollPosition : Number [sola lettura]
Ottiene la posizione di scorrimento verticale massima per il contenuto corrente, espressa in pixel. | BaseScrollPane | ||
metaData : Object
Ottiene l’oggetto di metadati dell’istanza DisplayObject se i metadati sono stati memorizzati insieme all’istanza di questo DisplayObject nel file SWF mediante un tag PlaceObject4. | DisplayObject | ||
mouseChildren : Boolean
Determina se gli elementi secondari dell'oggetto sono abilitati o meno per il mouse o per il dispositivo di input dell'utente. | DisplayObjectContainer | ||
mouseEnabled : Boolean
Specifica se questo oggetto riceve messaggi del mouse o di altri dispositivi di input dell'utente. | InteractiveObject | ||
mouseFocusEnabled : Boolean
Ottiene o imposta un valore che indica se il componente può ricevere l'attivazione quando un utente fa clic su di esso. | UIComponent | ||
mouseX : Number [sola lettura]
Indica la coordinata x del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel. | DisplayObject | ||
mouseY : Number [sola lettura]
Indica la coordinata y del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel. | DisplayObject | ||
name : String
Indica il nome dell'istanza dell'oggetto DisplayObject. | DisplayObject | ||
needsSoftKeyboard : Boolean
Specifica se deve essere visualizzata una tastiera virtuale (una tastiera software a video) quando questa istanza InteractiveObject riceve lo stato di attivazione. | InteractiveObject | ||
numChildren : int [sola lettura]
Restituisce il numero di elementi secondari di questo oggetto. | DisplayObjectContainer | ||
opaqueBackground : Object
Specifica se l'oggetto di visualizzazione è opaco con un determinato colore di sfondo. | DisplayObject | ||
parent : DisplayObjectContainer [sola lettura]
Indica l'oggetto DisplayObjectContainer che contiene questo oggetto di visualizzazione. | DisplayObject | ||
root : DisplayObject [sola lettura]
Nel caso di un oggetto di visualizzazione all'interno di un file SWF caricato, la proprietà principale è l'oggetto di visualizzazione più in alto nella porzione della struttura dell'elenco di visualizzazione rappresentata da quel file SWF. | DisplayObject | ||
rotation : Number
Indica la rotazione dell'istanza DisplayObject, espressa in gradi, rispetto alla posizione originale. | DisplayObject | ||
rotationX : Number
Indica la rotazione dell'asse x dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D. | DisplayObject | ||
rotationY : Number
Indica la rotazione dell'asse y dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D. | DisplayObject | ||
rotationZ : Number
Indica la rotazione dell'asse z dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D. | DisplayObject | ||
rowCount : uint [override]
Ottiene o imposta il numero di righe visibili almeno parzialmente nell'elenco. | List | ||
rowHeight : Number
Ottiene o imposta l'altezza di ciascuna riga dell'elenco, espressa in pixel. | List | ||
scale9Grid : Rectangle
La griglia di modifica in scala attualmente attiva. | DisplayObject | ||
scaleX : Number [override]
Moltiplica la larghezza corrente del componente per un fattore di scala. | UIComponent | ||
scaleY : Number [override]
Moltiplica l'altezza corrente del componente per un fattore di scala. | UIComponent | ||
scaleZ : Number
Indica la scala di profondità (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto. | DisplayObject | ||
scrollRect : Rectangle
I limiti del rettangolo di scorrimento dell'oggetto di visualizzazione. | DisplayObject | ||
selectable : Boolean
Ottiene o imposta un valore booleano che indica se è possibile selezionare le voci nell'elenco. | SelectableList | ||
selectedIndex : int
Ottiene o imposta l'indice della voce selezionata in un elenco a selezione singola. | SelectableList | ||
selectedIndices : Array
Ottiene o imposta un array che contiene le voci che sono state selezionate da un elenco a selezione multipla. | SelectableList | ||
selectedItem : Object
Ottiene o imposta la voce selezionata in un elenco a selezione singola. | SelectableList | ||
selectedItems : Array
Ottiene o imposta un array che contiene gli oggetti per le voci che sono state selezionate da un elenco a selezione multipla. | SelectableList | ||
softKeyboard : String
Controlla l'aspetto della tastiera software. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Definisce l’area che deve rimanere visibile sullo schermo quando è visualizzata una tastiera virtuale (non disponibile in iOS). | InteractiveObject | ||
soundTransform : flash.media:SoundTransform
Controlla il suono nello sprite. | Sprite | ||
stage : Stage [sola lettura]
Lo stage dell'oggetto di visualizzazione. | DisplayObject | ||
tabChildren : Boolean
Determina se gli elementi secondari dell'oggetto sono abilitati per la tabulazione. | DisplayObjectContainer | ||
tabEnabled : Boolean
Specifica se questo oggetto è incluso nell'ordine di tabulazione. | InteractiveObject | ||
tabIndex : int
Specifica l'ordine di tabulazione degli oggetti in un file SWF. | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [sola lettura]
Restituisce un oggetto TextSnapshot per questa istanza DisplayObjectContainer. | DisplayObjectContainer | ||
transform : flash.geom:Transform
Un oggetto con proprietà relative alla matrice, alla trasformazione del colore e ai limiti di pixel di un oggetto di visualizzazione. | DisplayObject | ||
useBitmapScrolling : Boolean
Se è true, il valore della proprietà cacheAsBitmap per il contenuto scorrevole è true; se è false, questo valore è disattivato. | BaseScrollPane | ||
useHandCursor : Boolean
Un valore booleano che indica se viene visualizzato un cursore a forma di mano quando il puntatore passa sopra uno sprite in cui la proprietà buttonMode è impostata su true. | Sprite | ||
verticalLineScrollSize : Number
Ottiene o imposta un valore che descrive la quantità di pixel da scorrere in senso verticale quando viene fatto clic su una freccia di scorrimento. | BaseScrollPane | ||
verticalPageScrollSize : Number
Ottiene o imposta il numero di pixel per cui spostare la casella di scorrimento sulla barra di scorrimento verticale quando viene premuta la traccia della barra di scorrimento. | BaseScrollPane | ||
verticalScrollBar : ScrollBar [sola lettura]
Ottiene un riferimento alla barra di scorrimento verticale. | BaseScrollPane | ||
verticalScrollPolicy : String
Ottiene o imposta un valore che indica lo stato della barra di scorrimento verticale. | BaseScrollPane | ||
verticalScrollPosition : Number
Ottiene o imposta un valore che descrive la posizione verticale, espressa in pixel, della barra di scorrimento verticale nel pannello di scorrimento. | BaseScrollPane | ||
visible : Boolean [override]
Ottiene o imposta un valore che indica se l'istanza corrente del componente è visibile. | UIComponent | ||
width : Number [override]
Ottiene o imposta la larghezza del componente in pixel. | UIComponent | ||
x : Number [override]
Ottiene o imposta la coordinata x che rappresenta la posizione del componente sull'asse x nel contenitore principale. | UIComponent | ||
y : Number [override]
Ottiene o imposta la coordinata y che rappresenta la posizione del componente sull'asse y nel contenitore principale. | UIComponent | ||
z : Number
Indica la posizione della coordinata z lungo l'asse z dell'istanza DisplayObject relativa al contenitore principale 3D. | DisplayObject |
Metodo | Definito da | ||
---|---|---|---|
List()
Crea una nuova istanza del componente List. | List | ||
Aggiunge un'istanza secondaria DisplayObject a questa istanza DisplayObjectContainer. | DisplayObjectContainer | ||
Aggiunge un'istanza secondaria DisplayObject a questa istanza DisplayObjectContainer. | DisplayObjectContainer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | ||
Aggiunge una voce alla fine dell'elenco di voci. | SelectableList | ||
Inserisce una voce nell'elenco nella posizione di indice specificata. | SelectableList | ||
Indica se le restrizioni di sicurezza possono determinare l'omissione di eventuali oggetti di visualizzazione dall'elenco restituito dalla chiamata al metodo DisplayObjectContainer.getObjectsUnderPoint() con il punto specificato. | DisplayObjectContainer | ||
Cancella uno stile che è impostato sui renderer nell'elenco. | SelectableList | ||
Cancella la voce selezionata nell'elenco e imposta la proprietà selectedIndex su -1. | SelectableList | ||
Elimina una proprietà di stile dall'istanza del componente. | UIComponent | ||
Determina se l'oggetto di visualizzazione specificato è un elemento secondario dell'istanza DisplayObjectContainer oppure è l'istanza stessa. | DisplayObjectContainer | ||
Invia un evento nel flusso di eventi. | EventDispatcher | ||
Mostra o nasconde l'indicatore di attivazione sul componente. | UIComponent | ||
Avvia un'azione di disegno immediata, senza invalidare tutto come fa invalidateNow. | UIComponent | ||
Restituisce un rettangolo che definisce l'area dell'oggetto di visualizzazione relativa al sistema di coordinate dell'oggetto targetCoordinateSpace. | DisplayObject | ||
Restituisce l'istanza dell'oggetto di visualizzazione secondario che si trova in corrispondenza della posizione di indice specificata. | DisplayObjectContainer | ||
Restituisce l'oggetto di visualizzazione secondario al quale corrisponde il nome specificato. | DisplayObjectContainer | ||
Restituisce la posizione di indice di un'istanza DisplayObject secondaria. | DisplayObjectContainer | ||
Recupera l'oggetto che è l'elemento attivo corrente. | UIComponent | ||
Recupera la voce nella posizione di indice specificata. | SelectableList | ||
Restituisce l'indice della voce successiva nel dataProvider in cui il primo carattere dell'etichetta corrisponde a un carattere della stringa specificato. | SelectableList | ||
Restituisce un array di oggetti che si trovano sotto il punto specificato e sono elementi secondari (di uno o più livelli inferiori) di questa istanza DisplayObjectContainer. | DisplayObjectContainer | ||
Restituisce un rettangolo che definisce i bordi dell'oggetto di visualizzazione in base al sistema di coordinate definito dal parametro targetCoordinateSpace, esclusi gli eventuali tratti presenti sulle forme. | DisplayObject | ||
Recupera uno stile che è impostato sui renderer nell'elenco. | SelectableList | ||
Recupera una proprietà style impostata nella catena di ricerca dello stile del componente. | UIComponent | ||
[statico]
Recupera la mappa di stile predefinita del componente corrente. | List | ||
Converte le coordinate dello stage (globali) in quelle (locali) dell'oggetto di visualizzazione per l'oggetto Point. | DisplayObject | ||
Converte un punto bidimensionale dalle coordinate dello stage (globali) in quelle (locali) di un oggetto di visualizzazione tridimensionale. | DisplayObject | ||
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Valuta il riquadro di delimitazione dell'oggetto di visualizzazione per verificare se si sovrappone o si interseca con il riquadro di delimitazione dell'oggetto di visualizzazione obj. | DisplayObject | ||
Valuta l'oggetto di visualizzazione per stabilire se si sovrappone o si interseca con il punto specificato dai parametri x e y. | DisplayObject | ||
Contrassegna una proprietà come non valida e ridisegna il componente sul fotogramma successivo salvo diversa indicazione. | UIComponent | ||
Invalida un renderer di voci specifico. | SelectableList | ||
Invalida il renderer per la voce nella posizione di indice specificata. | SelectableList | ||
Invalida l'intero elenco e fa in modo che tutte le voci vengano ridisegnate. | SelectableList | ||
Verifica se la voce specificata è selezionata nell'elenco. | SelectableList | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
Recupera ICellRenderer per una determinata voce di menu, se presente. | SelectableList | ||
[override]
Recupera la stringa che il renderer visualizza per l'oggetto di dati specificato in base alle proprietà labelField e labelFunction. | List | ||
Converte un punto tridimensionale delle coordinate (locali) dell'oggetto di visualizzazione tridimensionale in un punto bidimensionale nelle coordinate dello stage (globali). | DisplayObject | ||
Converte le coordinate dell'oggetto di visualizzazione (locali) in quelle dello stage (globali) per l'oggetto Point. | DisplayObject | ||
[statico]
Unisce gli stili di più classi in un unico oggetto. | UIComponent | ||
Sposta il componente in una posizione specificata all'interno del relativo elemento principale. | UIComponent | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
Rimuove tutte le voci dall'elenco. | SelectableList | ||
Rimuove l'istanza DisplayObject secondaria specificata dall'elenco degli elementi secondari dell'istanza DisplayObjectContainer. | DisplayObjectContainer | ||
Rimuove un'istanza DisplayObject secondaria dalla posizione di indice specificata nell'elenco degli elementi secondari di DisplayObjectContainer. | DisplayObjectContainer | ||
Rimuove tutte le istanze DisplayObject secondarie dall'elenco degli elementi secondari dell'istanza DisplayObjectContainer. | DisplayObjectContainer | ||
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | ||
Rimuove la voce specificata dall'elenco. | SelectableList | ||
Rimuove la voce nella posizione di indice specificata. | SelectableList | ||
Sostituisce la voce nella posizione di indice specificata con un'altra voce. | SelectableList | ||
Alza una tastiera virtuale. | InteractiveObject | ||
[override]
Scorre l'elenco fino alla voce che si trova nella posizione di indice specificata. | List | ||
Scorre l'elenco fino alla voce che si trova nella posizione indicata dal valore corrente della proprietà selectedIndex. | SelectableList | ||
Cambia la posizione di un elemento secondario nel contenitore di oggetto di visualizzazione. | DisplayObjectContainer | ||
Imposta questo componente come elemento attivo. | UIComponent | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Imposta uno stile sui renderer nell'elenco. | SelectableList | ||
Imposta il componente sulla larghezza e sull'altezza specificate. | UIComponent | ||
Imposta una proprietà di stile per l'istanza del componente. | UIComponent | ||
Ordina gli elementi nel fornitore di dati corrente. | SelectableList | ||
Ordina gli elementi nel fornitore di dati corrente in base a uno o più dei relativi campi. | SelectableList | ||
Consente all'utente di trascinare lo sprite specificato. | Sprite | ||
Consente all'utente di trascinare lo sprite specificato su un dispositivo abilitato per il tocco. | Sprite | ||
Interrompe in modo ricorsivo l’esecuzione della linea temporale di qualsiasi MovieClips che ha origine in questo oggetto. | DisplayObjectContainer | ||
Termina il metodo startDrag(). | Sprite | ||
Termina il metodo startTouchDrag(), utilizzato con i dispositivi abilitati per il tocco. | Sprite | ||
Scambia lo z-order (ordine di profondità) degli oggetti secondari specificati. | DisplayObjectContainer | ||
Scambia lo z-order (ordine di profondità) degli oggetti secondari nelle due posizioni di indice specificate nell'elenco degli elementi secondari. | DisplayObjectContainer | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | ||
Convalida e aggiorna le proprietà e il layout di questo oggetto e lo ridisegna, se necessario. | UIComponent | ||
Restituisce il valore di base dell'oggetto specificato. | Object | ||
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher |
Gli stili sono di tipo comune oppure associati a un tema specifico. Se lo stile è comune, può essere utilizzato con qualunque tema. Se è associato a un tema specifico, può essere utilizzato solo se la vostra applicazione ne fa uso.
iconField | proprietà |
iconField:String
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta il campo delle voci che fornisce l'icona per la voce.
Nota: iconField
non viene utilizzata se la proprietà iconFunction
è impostata su una funzione di callback.
Il valore predefinito è "icon".
Implementazione
public function get iconField():String
public function set iconField(value:String):void
Esempio ( Come utilizzare questo esempio )
RedBox
deve essere presente nella libreria e la casella "Esporta per ActionScript" deve essere selezionata nelle relative proprietà:
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 | proprietà |
iconFunction:Function
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta la funzione da utilizzare per ottenere l'icona per la voce.
Nota: iconField
non viene utilizzata se la proprietà iconFunction
è impostata su una funzione di callback.
Il valore predefinito è null.
Implementazione
public function get iconFunction():Function
public function set iconFunction(value:Function):void
Esempio ( Come utilizzare questo esempio )
iconFunction
per fornire un'icona a un numero limitato di voci in un elenco. Affinché l'esempio funzioni correttamente, un simbolo di nome RedBox
deve essere presente nella libreria e la casella "Esporta per ActionScript" deve essere selezionata nelle relative proprietà:
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 | proprietà |
labelField:String
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta il nome del campo dell'oggetto dataProvider
da visualizzare come etichetta del campo e dell'elenco a discesa TextInput.
Per impostazione predefinita, il componente visualizza la proprietà label
di ogni voce dataProvider
. Se le voci di dataProvider
non contengono una proprietà label
, è possibile impostare la proprietà labelField
in modo che utilizzi una proprietà diversa.
Nota: labelField
non viene utilizzata se la proprietà labelFunction
è impostata su una funzione di callback.
Il valore predefinito è "label".
Implementazione
public function get labelField():String
public function set labelField(value:String):void
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
abbreviatedLabel
invece della proprietà predefinita label
:
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 | proprietà |
labelFunction:Function
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta la funzione da utilizzare per ottenere l'etichetta per la voce.
Per impostazione predefinita, il componente visualizza la proprietà label
di una voce dataProvider
. Tuttavia, alcuni set di dati non hanno una proprietà label
oppure non hanno un campo il cui valore possa essere utilizzato come etichetta senza essere modificato. Ad esempio, un determinato set di dati può memorizzare i nomi completi ma conservarli nei campi lastName
e firstName
. In tal caso, questa proprietà può essere utilizzata per impostare una funzione di callback che concatena i valori dei campi lastName
e firstName
in una stringa dal nome completo da visualizzare.
Nota: labelField
non viene utilizzata se la proprietà labelFunction
è impostata su una funzione di callback.
Il valore predefinito è null.
Implementazione
public function get labelFunction():Function
public function set labelFunction(value:Function):void
Esempio ( Come utilizzare questo esempio )
labelFunction
di un elenco su una funzione che formatta la stringa da visualizzare in ciascuna cella:
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 | proprietà |
rowCount:uint
[override] Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta il numero di righe visibili almeno parzialmente nell'elenco.
Implementazione
override public function get rowCount():uint
override public function set rowCount(value:uint):void
Esempio ( Come utilizzare questo esempio )
rowCount
:
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
in base al valore corrente di un componente Slider:
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 | proprietà |
rowHeight:Number
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Ottiene o imposta l'altezza di ciascuna riga dell'elenco, espressa in pixel.
Il valore predefinito è 20.
Implementazione
public function get rowHeight():Number
public function set rowHeight(value:Number):void
List | () | Funzione di costruzione |
public function List()
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Crea una nuova istanza del componente List.
getStyleDefinition | () | metodo |
public static function getStyleDefinition():Object
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Recupera la mappa di stile predefinita del componente corrente. La mappa di stile contiene il tipo appropriato per il componente, in base allo stile utilizzato dal componente. Ad esempio, lo stile disabledTextFormat
contiene un valore null
o un oggetto TextFormat. È possibile utilizzare questi stili e chiamare setStyle()
sul componente corrente. Il codice seguente consente di ignorare lo stile disabledTextFormat
predefinito sul componente specificato:
componentInstance.setStyle("disabledTextFormat", new TextFormat());
Object — Oggetto stili predefinito.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
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 | () | metodo |
override public function itemToLabel(item:Object):String
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Recupera la stringa che il renderer visualizza per l'oggetto di dati specificato in base alle proprietà labelField
e labelFunction
.
Nota: labelField
non viene utilizzata se la proprietà labelFunction
è impostata su una funzione di callback.
Parametri
item:Object — L'oggetto di cui eseguire il rendering.
|
String — La stringa da visualizzare in base ai dati.
|
Esempio ( Come utilizzare questo esempio )
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 | () | metodo |
override public function scrollToIndex(newCaretIndex:int):void
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS3 |
Versioni runtime: | Flash Player 9.0.28.0, AIR 1.0 |
Scorre l'elenco fino alla voce che si trova nella posizione di indice specificata. Se l'indice è fuori dall'intervallo, la posizione di scorrimento non cambia.
Parametri
newCaretIndex:int — La posizione di indice fino a cui effettuare lo scorrimento.
|
- Aggiungete le classi List, Button e Label alla libreria.
- Salvate questo codice come ListExample.as nella stessa directory del FLA.
- Impostate DocumentClass nel FLA su ListExample.
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, 02:44 PM Z