Pakiet | fl.controls |
Klasa | public class List |
Dziedziczenie | List SelectableList BaseScrollPane UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Implementuje | IFocusManagerComponent |
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Składnik List składa się z elementów, wierszy oraz obiektu dostarczającego dane, które są opisane w następujący sposób:
- Element: Obiekt w języku ActionScript zazwyczaj obejmujący właściwość
label
stanowiącą opis oraz właściwośćdata
przechowującą dane skojarzone z tym elementem. - Wiersz: Składnik służący do wyświetlenia elementu.
- Obiekt dostarczający dane: Składnik modelujący elementy wyświetlane za pośrednictwem składnika List.
Domyślnie składnik List korzysta z klasy CellRenderer w celu dostarczenia informacji do wierszy, w których wyświetlane są elementy listy. Użytkownik może tworzyć te wiersze programowo; zwykle służy do tego podklasa klasy CellRenderer. Klasa CellRenderer implementuje interfejs ICellRenderer, który udostępnia zestaw właściwości i metod wykorzystywanych przez składnik List do manipulacji wierszami oraz do wysyłania danych oraz informacji o stanie do poszczególnych wierszy w celu ich wyświetlenia. Dotyczy to również informacji o ilości i kryteriach wyboru danych.
Składnik List udostępnia metody działające na jego obiekcie dostarczającym dane — na przykład metody addItem()
i removeItem()
. Tych i innych metod można używać do manipulowania danymi dowolnej tablicy istniejącej w tej samej klatce, co składnik List, a następnie do rozsyłania zmian do wielu widoków. Jeśli nie zapewniono zewnętrznego obiektu dostarczającego dane dla składnika List, metody te powodują automatyczne tworzenie instancji obiektu dostarczającego dane i uwidocznienie go za pośrednictwem właściwości List.dataProvider
. Składnik List powoduje odświeżenie każdego wiersza za pomocą obiektu Sprite implementującego interfejs ICellRenderer. W celu określenia tego mechanizmu renderującego należy skorzystać z właściwości List.cellRenderer
. Można również zbudować instancję Array lub pobrać ją z serwera i użyć jej jako modelu danych dla wielu list, list kombinowanych, siatek danych itd.
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
Bieżąca implementacja dostępności (AccessibilityImplementation) dla tego wystąpienia klasy InteractiveObject. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
Bieżące opcje dostępności tego obiektu wyświetlanego. | DisplayObject | ||
allowMultipleSelection : Boolean
Pobiera wartość typu Boolean wskazującą, czy można wybrać jednocześnie więcej niż jeden element listy. | SelectableList | ||
alpha : Number
Wartość przezroczystości alfa określonego obiektu. | DisplayObject | ||
blendMode : String
Wartość z klasy BlendMode określająca, jakiego trybu mieszania należy użyć. | DisplayObject | ||
blendShader : Shader [tylko do zapisu]
Ustawia moduł cieniujący, który jest używany do mieszania pierwszego planu oraz tła. | DisplayObject | ||
buttonMode : Boolean
Określa tryb przycisku tej ikonki. | Sprite | ||
cacheAsBitmap : Boolean
Jeśli ustawiono wartość true, środowisko wykonawcze Flash buforuje wewnętrzną reprezentację bitmapy obiektu wyświetlanego. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
W przypadku wartości innej niż null ten obiekt Matrix definiuje sposób renderowania obiektu wyświetlanego, gdy cacheAsBitmap jest ustawione na true. | DisplayObject | ||
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
contextMenu : NativeMenu
Określa menu kontekstowe tego obiektu. | InteractiveObject | ||
dataProvider : DataProvider
Pobiera lub ustawia model danych listy elementów do wyświetlenia. | SelectableList | ||
doubleClickEnabled : Boolean
Określa, czy ten obiekt reaguje na zdarzenia doubleClick (dwukrotne kliknięcia). | InteractiveObject | ||
dropTarget : DisplayObject [tylko do odczytu]
Określa obiekt ekranowy, nad którym jest przeciągana ikonka, lub na który upuszczono ikonkę. | Sprite | ||
enabled : Boolean
Pobiera lub ustawia wartość wskazującą, czy składnik akceptuje interakcje ze strony użytkownika. | UIComponent | ||
filters : Array
Indeksowana tablica zawierająca wszystkie filtry aktualnie skojarzone z obiektem wyświetlanym. | DisplayObject | ||
focusEnabled : Boolean
Pobiera lub ustawia wartość Boolean określającą, czy składnik może stawać się aktywny, gdy użytkownik go kliknie. | UIComponent | ||
focusManager : IFocusManager
Pobiera lub ustawia obiekt FocusManager sterujący aktywnością tego składnika i jego składników równorzędnych. | UIComponent | ||
focusRect : Object
Określa, czy z tym obiektem skojarzono ramkę aktywności. | InteractiveObject | ||
graphics : Graphics [tylko do odczytu]
Określa obiekt Graphics skojarzony z ikonką, której mogą dotyczyć polecenia rysowania kształtów wektorowych. | Sprite | ||
height : Number [przesłanianie]
Pobiera lub ustawia wysokość składnika w pikselach. | UIComponent | ||
hitArea : Sprite
Określa ikonkę, która ma pełnić funkcję obszaru naciskania innej ikonki. | Sprite | ||
horizontalLineScrollSize : Number
Pobiera lub ustawia wartość opisującą, o ile treść ma być przewinięta poziomo po kliknięciu strzałki przewijania. | BaseScrollPane | ||
horizontalPageScrollSize : Number
Pobiera lub ustawia liczbę pikseli, o jaką należy przesunąć uchwyt przewijania na poziomym pasku przewijania po kliknięciu ścieżki paska. | BaseScrollPane | ||
horizontalScrollBar : ScrollBar [tylko do odczytu]
Pobiera odniesienie do poziomego paska przewijania. | BaseScrollPane | ||
horizontalScrollPolicy : String
Pobiera lub ustawia wartość określającą stan poziomego paska przewijania. | BaseScrollPane | ||
horizontalScrollPosition : Number
Pobiera lub ustawia wartość opisującą poziomą pozycję poziomego paska przewijania w panelu przewijania, wyrażoną w pikselach. | BaseScrollPane | ||
iconField : String
Pobiera lub ustawia pole elementu udostępniające ikonę elementu. | List | ||
iconFunction : Function
Pobiera lub ustawia funkcję, która ma być używana w celu uzyskania ikony elementu. | List | ||
labelField : String
Pobiera lub ustawia nazwę pola w obiekcie dataProvider wyświetlaną jako etykietę dla pola TextInput oraz listy rozwijanej. | List | ||
labelFunction : Function
Pobiera lub ustawia funkcję, która ma być używana w celu uzyskania etykiety elementu. | List | ||
length : uint [tylko do odczytu]
Pobiera liczbę elementów obiektu dostarczającego dane. | SelectableList | ||
loaderInfo : LoaderInfo [tylko do odczytu]
Zwraca obiekt LoaderInfo zawierający informacje o ładowaniu pliku, do którego należy ten obiekt wyświetlany. | DisplayObject | ||
mask : DisplayObject
Wywoływany obiekt wyświetlany jest maskowany przez określony obiekt maski. | DisplayObject | ||
maxHorizontalScrollPosition : Number [przesłanianie]
Pobiera lub ustawia liczbę pikseli, o jaką lista jest przewijana w prawo, po ustawieniu właściwości horizontalScrollPolicy na wartość ScrollPolicy.ON. | SelectableList | ||
maxVerticalScrollPosition : Number [tylko do odczytu]
Pobiera maksymalną pionową pozycję przewijania dla bieżącej zawartości, wyrażoną w pikselach. | BaseScrollPane | ||
metaData : Object
Pobiera obiekt metadanych wystąpienia klasy DisplayObject, jeśli metadane są przechowywane razem z tym wystąpieniem klasy DisplayObject w pliku SWF, korzystając ze znacznika PlaceObject4. | DisplayObject | ||
mouseChildren : Boolean
Określa, czy elementy potomne obiektu obsługują mysz lub inne urządzenie wejściowe użytkownika. | DisplayObjectContainer | ||
mouseEnabled : Boolean
Określa, czy ten obiekt odbiera komunikaty z myszy lub innego urządzenia wejściowego użytkownika. | InteractiveObject | ||
mouseFocusEnabled : Boolean
Pobiera lub ustawia wartość określającą, czy składnik może stawać się aktywny, gdy użytkownik go kliknie. | UIComponent | ||
mouseX : Number [tylko do odczytu]
Określa współrzędną x myszy lub urządzenia wejściowego użytkownika w pikselach. | DisplayObject | ||
mouseY : Number [tylko do odczytu]
Określa współrzędną y myszy lub urządzenia wejściowego użytkownika w pikselach. | DisplayObject | ||
name : String
Nazwa instancji obiektu DisplayObject. | DisplayObject | ||
needsSoftKeyboard : Boolean
Określa, czy klawiatura wirtualna (klawiatura programowa wyświetlana na ekranie) powinna być wyświetlana, gdy to wystąpienie klasy InteractiveObject staje się aktywne. | InteractiveObject | ||
numChildren : int [tylko do odczytu]
Zwraca liczbę elementów potomnych tego obiektu. | DisplayObjectContainer | ||
opaqueBackground : Object
Określa, czy przy konkretnym kolorze tła obiekt wyświetlany jest nieprzejrzysty. | DisplayObject | ||
parent : DisplayObjectContainer [tylko do odczytu]
Odnosi się do obiektu DisplayObjectContainer, który zawiera obiekt wyświetlany. | DisplayObject | ||
root : DisplayObject [tylko do odczytu]
Dla obiektu wyświetlanego w załadowanym pliku SWF główną właściwość stanowi obiekt wyświetlany na samym szczycie na liście wyświetlania w postaci struktury drzewa, którą reprezentuje plik SWF. | DisplayObject | ||
rotation : Number
Określa wielkość obrotu instancji obiektu DisplayObject (w kątach). | DisplayObject | ||
rotationX : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi x — od pozycji początkowej względem nadrzędnego kontenera 3D. | DisplayObject | ||
rotationY : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi y — od pozycji początkowej względem nadrzędnego kontenera 3D. | DisplayObject | ||
rotationZ : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi z — od pozycji początkowej względem nadrzędnego kontenera 3D. | DisplayObject | ||
rowCount : uint [przesłanianie]
Pobiera lub ustawia liczbę wierszy, które są przynajmniej częściowo widoczne na liście. | List | ||
rowHeight : Number
Pobiera lub ustawia wysokość każdego wiersza listy, w pikselach. | List | ||
scale9Grid : Rectangle
Aktualnie stosowana siatka skalowania. | DisplayObject | ||
scaleX : Number [przesłanianie]
Mnoży bieżącą szerokość składnika przez współczynnik skalowania. | UIComponent | ||
scaleY : Number [przesłanianie]
Mnoży bieżącą wysokość składnika przez współczynnik skalowania. | UIComponent | ||
scaleZ : Number
Wskazuje skalę głębokości (procent) obiektu względem punktu odniesienia. | DisplayObject | ||
scrollRect : Rectangle
Granice obszaru przewijania obiektu wyświetlanego. | DisplayObject | ||
selectable : Boolean
Pobiera lub ustawia wartość typu Boolean wskazującą, czy można zaznaczyć elementy z listy. | SelectableList | ||
selectedIndex : int
Pobiera lub ustawia indeks elementu, który jest wybierany z listy jednokrotnego wyboru. | SelectableList | ||
selectedIndices : Array
Pobiera lub ustawia tablicę, która zawiera elementy zaznaczone na liście wielokrotnego wyboru. | SelectableList | ||
selectedItem : Object
Pobiera lub ustawia element wybrany z listy jednokrotnego wyboru. | SelectableList | ||
selectedItems : Array
Pobiera lub ustawia tablicę, która zawiera obiekty dla elementów wybranych z listy wielokrotnego wyboru. | SelectableList | ||
softKeyboard : String
Steruje wyglądem klawiatury programowej. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Definiuje obszar, który powinien pozostać na ekranie po wyświetleniu klawiatury programowej (niedostępna w systemie iOS). | InteractiveObject | ||
soundTransform : flash.media:SoundTransform
Kontroluje dźwięki skojarzone z tą ikonką. | Sprite | ||
stage : Stage [tylko do odczytu]
Stół montażowy obiektu wyświetlanego. | DisplayObject | ||
tabChildren : Boolean
Określa, czy elementy potomne tego obiektu mają reagować na klawisz Tab. | DisplayObjectContainer | ||
tabEnabled : Boolean
Określa, czy do tego obiektu można przejść za pomocą klawisza Tab. | InteractiveObject | ||
tabIndex : int
Określa kolejność uaktywniania obiektów (z pliku SWF) za pomocą klawisza Tab. | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [tylko do odczytu]
Zwraca obiekt TextSnapshot dla tego wystąpienia klasy DisplayObjectContainer. | DisplayObjectContainer | ||
transform : flash.geom:Transform
Obiekt z właściwościami dotyczącymi matrycy obiektu wyświetlanego, transformacji kolorów oraz granic pikseli. | DisplayObject | ||
useBitmapScrolling : Boolean
Ustawienie na wartość true powoduje, że właściwość cacheAsBitmap przewijanej treści jest ustawiana na true; ustawienie na false powoduje wyłączenie tej wartości. | BaseScrollPane | ||
useHandCursor : Boolean
Wartość typu Boolean wskazuje, czy wskaźnik dłoni pojawia się w momencie, gdy wskaźnik jest przesuwany nad ikonką, której właściwość buttonMode jest ustawiona na wartość true. | Sprite | ||
verticalLineScrollSize : Number
Pobiera lub ustawia wartość opisującą, o ile pikseli treść ma być przewinięta pionowo po kliknięciu strzałki przewijania. | BaseScrollPane | ||
verticalPageScrollSize : Number
Pobiera lub ustawia liczbę pikseli, o jaką należy przesunąć uchwyt przewijania na pionowym pasku przewijania po kliknięciu ścieżki paska. | BaseScrollPane | ||
verticalScrollBar : ScrollBar [tylko do odczytu]
Pobiera odwołanie do pionowego paska przewijania. | BaseScrollPane | ||
verticalScrollPolicy : String
Pobiera lub ustawia wartość określającą stan poziomego paska przewijania. | BaseScrollPane | ||
verticalScrollPosition : Number
Pobiera lub ustawia wartość opisującą pionową pozycję pionowego paska przewijania w panelu przewijania, wyrażoną w pikselach. | BaseScrollPane | ||
visible : Boolean [przesłanianie]
Pobiera lub ustawia wartość wskazującą, czy bieżąca instancja składnika jest widoczna. | UIComponent | ||
width : Number [przesłanianie]
Pobiera lub ustawia szerokość składnika w pikselach. | UIComponent | ||
x : Number [przesłanianie]
Pobiera lub ustawia współrzędną x reprezentującą pozycję składnika wzdłuż osi x w jego kontenerze nadrzędnym. | UIComponent | ||
y : Number [przesłanianie]
Pobiera lub ustawia współrzędną y reprezentującą pozycję składnika wzdłuż osi y w jego kontenerze nadrzędnym. | UIComponent | ||
z : Number
Wskazuje współrzędną wzdłuż osi Z instancji DisplayObject względem nadrzędnego kontenera 3D. | DisplayObject |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
List()
Tworzy nową instancję składnika List. | List | ||
Dodaje potomne wystąpienie klasy DisplayObject do tego wystąpienia klasy DisplayObjectContainer. | DisplayObjectContainer | ||
Dodaje potomne wystąpienie klasy DisplayObject do tego wystąpienia klasy DisplayObjectContainer. | DisplayObjectContainer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | ||
Dołącza element na końcu listy elementów. | SelectableList | ||
Wstawia element na listę pod określonym indeksem. | SelectableList | ||
Wskazuje, czy ograniczenia ze względów bezpieczeństwa będą powodowały pomijanie obiektów wyświetlanych na liście uzyskanej poprzez wywołanie metody DisplayObjectContainer.getObjectsUnderPoint() z określonym punktem. | DisplayObjectContainer | ||
Kasuje styl elementów renderujących na liście. | SelectableList | ||
Czyści zaznaczony obecnie element listy i ustawia właściwość selectedIndex na -1. | SelectableList | ||
Usuwa właściwość stylu z tego wystąpienia składnika. | UIComponent | ||
Decyduje o tym, czy określony obiekt ekranowy jest potomkiem instancji obiektu DisplayObjectContainer, czy też sam jest taką instancją. | DisplayObjectContainer | ||
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | ||
Wyświetla lub ukrywa wskaźnik aktywności tego składnika. | UIComponent | ||
Inicjuje natychmiastową operację rysowania bez unieważniania wszystkich składników i właściwości, co odróżnia ją od metody invalidateNow. | UIComponent | ||
Zwraca prostokąt definiujący obszar obiektu wyświetlanego (w układzie współrzędnych obiektu targetCoordinateSpace). | DisplayObject | ||
Zwraca instancję podrzędnego obiektu wyświetlanego o podanym indeksie. | DisplayObjectContainer | ||
Zwraca instancję podrzędnego obiektu wyświetlanego o podanej nazwie. | DisplayObjectContainer | ||
Zwraca indeks podrzędnej instancji DisplayObject. | DisplayObjectContainer | ||
Pobiera obiekt, który jest w danej chwili aktywny. | UIComponent | ||
Pobiera element o wskazanym indeksie. | SelectableList | ||
Zwraca indeks następnego elementu w obiekcie dataProvider, w którym pierwszy znak etykiety odpowiada określonemu znakowi ciągu znaków. | SelectableList | ||
Zwraca tablicę obiektów, które leżą poniżej określonego punktu i są obiektami podrzędnymi tej instancji obiektu DisplayObjectContainer. | DisplayObjectContainer | ||
Zwraca prostokąt definiujący granice obiektu wyświetlanego w układzie współrzędnych określonych przez parametr targetCoordinateSpace (z wyłączeniem konturów kształtów). | DisplayObject | ||
Pobiera styl elementów renderujących na liście. | SelectableList | ||
Pobiera właściwość stylu ustawioną w łańcuchu wyszukiwania stylów danego składnika. | UIComponent | ||
[statyczny]
Pobiera domyślną mapę stylów dla bieżącego składnika. | List | ||
Konwertuje obiekt punktowy ze współrzędnych obiektu Stage (globalne) do współrzędnych obiektu wyświetlanego (lokalne). | DisplayObject | ||
Konwertuje punkt dwuwymiarowy ze współrzędnych stołu wymiarowego (globalnych) na współrzędne trójwymiarowego obiektu wyświetlanego (lokalne). | DisplayObject | ||
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Wyznacza prostokąt ograniczający obiekt wyświetlany w celu sprawdzenia, czy zachodzi on lub przecina się z prostokątem ograniczającym obiektu wyświetlanego obj. | DisplayObject | ||
Analizuje obiekt wyświetlany w celu ustalenia czy nakłada się on lub przecina punkt określony przez parametry x i y. | DisplayObject | ||
Oznacza właściwość jako nieważną i ponownie rysuje składnik w następnej klatce, o ile nie określono innego zachowania. | UIComponent | ||
Unieważnia mechanizm renderujący konkretnego elementu. | SelectableList | ||
Unieważnia mechanizm renderujący elementu o podanym indeksie. | SelectableList | ||
Powoduje unieważnienie całej listy, wymuszając przerysowanie elementów listy. | SelectableList | ||
Sprawdza, czy określony element znajduje się na liście. | SelectableList | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Pobiera ICellRenderer dla danego obiektu elementu, o ile istnieje. | SelectableList | ||
[przesłanianie]
Pobiera ciąg znaków, który mechanizm renderujący wyświetla dla danego obiektu danych zgodnie z właściwościami labelField i labelFunction. | List | ||
Konwertuje punkt trójwymiarowy trójwymiarowego obiektu wyświetlanego (lokalnego) na punkt dwuwymiarowy we współrzędnych stołu montażowego (globalnych). | DisplayObject | ||
Konwertuje obiekt punktowy ze współrzędnych obiektu wyświetlanego (lokalne) do współrzędnych obiektu Stage (globalne). | DisplayObject | ||
[statyczny]
Scala style z wielu klas w jeden obiekt. | UIComponent | ||
Przemieszcza składnik do określonej pozycji w jego obiekcie nadrzędnym. | UIComponent | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Usuwa z listy wszystkie elementy. | SelectableList | ||
Usuwa określoną instancję obiektu podrzędnego DisplayObject z listy obiektów podrzędnych instancji DisplayObjectContainer. | DisplayObjectContainer | ||
Usuwa obiekt potomny DisplayObject o podanym indeksie z listy elementów potomnych obiektu DisplayObjectContainer. | DisplayObjectContainer | ||
Powoduje usunięcie wszystkich wystąpień potomnych klasy DisplayObject z listy obiektów potomnych wystąpień klasy DisplayObjectContainer. | DisplayObjectContainer | ||
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | ||
Usuwa z listy określony element. | SelectableList | ||
Usuwa element o podanym indeksie. | SelectableList | ||
Zastępuje element o podanym indeksie innym elementem. | SelectableList | ||
Powoduje uniesienie klawiatury wirtualnej. | InteractiveObject | ||
[przesłanianie]
Przewija listę do elementu o podanym indeksie. | List | ||
Przewija listę do pozycji wskazanej przez bieżącą wartość właściwości selectedIndex. | SelectableList | ||
Zmienia położenie istniejącego elementu potomnego w kontenerze obiektów ekranowych. | DisplayObjectContainer | ||
Ustawia ten składnik jako aktywny. | UIComponent | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Ustawia styl elementów renderujących na liście. | SelectableList | ||
Ustawia szerokość i wysokość składnika na określone wartości. | UIComponent | ||
Ustawia właściwość stylu tej instancji składnika. | UIComponent | ||
Sortuje elementy bieżącego obiektu dostarczającego dane. | SelectableList | ||
Sortuje elementy bieżącego obiektu dostarczającego dane wg jednego lub więcej pól. | SelectableList | ||
Pozwala użytkownikowi przeciągnąć określoną ikonkę. | Sprite | ||
Umożliwia użytkownikowi przeciąganie określonej ikonki na urządzeniu z ekranem dotykowym. | Sprite | ||
Rekurencyjnie zatrzymuje wykonywanie osi czasu wszystkich obiektów MovieClip, dla których ten obiekt jest obiektem głównym. | DisplayObjectContainer | ||
Kończy metodę startDrag(). | Sprite | ||
Kończy działanie metody startTouchDrag(); używana z urządzeniami wyposażonymi w ekran dotykowy. | Sprite | ||
Zamienia kolejność dwóch określonych obiektów podrzędnych. | DisplayObjectContainer | ||
Zamienia miejscami na liście dwa różne obiekty potomne o podanych indeksach. | DisplayObjectContainer | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
Zwraca ciąg reprezentujący określony obiekt. | Object | ||
Sprawdza ważność i aktualizuje właściwości oraz układ tego obiektu, w razie potrzeby rysując go ponownie. | UIComponent | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object | ||
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher |
Wyróżnia się style wspólne i powiązane z konkretnymi motywami. Styl wspólny może być używany z dowolnym motywem. Styl powiązany z konkretnym motywem może być używany pod warunkiem, że w aplikacji jest używany właśnie ten motyw.
iconField | właściwość |
iconField:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera lub ustawia pole elementu udostępniające ikonę elementu.
Uwaga: pole iconField
nie jest używane, jeśli dla właściwości iconFunction
ustawiono funkcję zwrotną.
Wartością domyślną jest "icon".
Implementacja
public function get iconField():String
public function set iconField(value:String):void
Przykład ( Sposób korzystania z tego przykładu )
RedBox
z biblioteki, a we właściwościach symbolu musi być włączony przełącznik „Eksportuj dla ActionScript”:
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 | właściwość |
iconFunction:Function
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera lub ustawia funkcję, która ma być używana w celu uzyskania ikony elementu.
Uwaga: Pole iconField
nie jest używane, jeśli dla właściwości iconFunction
ustawiono funkcję zwrotną.
Wartością domyślną jest null.
Implementacja
public function get iconFunction():Function
public function set iconFunction(value:Function):void
Przykład ( Sposób korzystania z tego przykładu )
iconFunction
do dostarczenia ikony do ograniczonej liczby elementów na liście. Aby ten przykład działał prawidłowo, ikona musi być symbolem o nazwie RedBox
z biblioteki, a we właściwościach symbolu musi być włączony przełącznik „Eksportuj dla ActionScript”:
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 | właściwość |
labelField:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera lub ustawia nazwę pola w obiekcie dataProvider
wyświetlaną jako etykietę dla pola TextInput oraz listy rozwijanej.
Domyślnie składnik wyświetla właściwość label
dla każdego elementu dataProvider
. Jeśli elementy dataProvider
nie zawierają właściwości label
, można przestawić właściwość labelField
tak, aby używana była inna właściwość.
Uwaga: Właściwość labelField
nie jest używana, jeśli właściwość labelFunction
jest ustawiona na funkcję zwrotną.
Wartością domyślną jest "label".
Implementacja
public function get labelField():String
public function set labelField(value:String):void
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
abbreviatedLabel
, nie zaś z właściwością domyślną 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 | właściwość |
labelFunction:Function
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera lub ustawia funkcję, która ma być używana w celu uzyskania etykiety elementu.
Domyślnie składnik wyświetla właściwość label
dla elementu dataProvider
. Niektóre zestawy danych mogą jednak nie zawierać pola label
lub mogą nie mieć pola, którego wartość można użyć jako etykiety bez konieczności jego modyfikacji. Na przykład w danym zestawie danych możliwe jest zapisanie pełnych nazw, lecz zarządzanie nimi jest możliwe tylko z poziomu pól lastName
i firstName
. W takim wypadku właściwości można użyć do ustawienia funkcji zwrotnej, która konkatenuje wartości z pól lastName
i firstName
w jeden ciąg znaków wyświetlany jako pełna nazwa.
Uwaga: właściwość labelField
nie jest używana, jeśli właściwość labelFunction
jest ustawiona na funkcję zwrotną.
Wartością domyślną jest null.
Implementacja
public function get labelFunction():Function
public function set labelFunction(value:Function):void
Przykład ( Sposób korzystania z tego przykładu )
labelFunction
listy na funkcję, która formatuje ciągi do wyświetlenia w poszczególnych komórkach.
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 | właściwość |
rowCount:uint
[przesłanianie] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera lub ustawia liczbę wierszy, które są przynajmniej częściowo widoczne na liście.
Implementacja
override public function get rowCount():uint
override public function set rowCount(value:uint):void
Przykład ( Sposób korzystania z tego przykładu )
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
w oparciu o bieżącą wartość suwaka:
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 | właściwość |
rowHeight:Number
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera lub ustawia wysokość każdego wiersza listy, w pikselach.
Wartością domyślną jest 20.
Implementacja
public function get rowHeight():Number
public function set rowHeight(value:Number):void
List | () | Konstruktor |
public function List()
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Tworzy nowe wystąpienie składnika List.
getStyleDefinition | () | metoda |
public static function getStyleDefinition():Object
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera domyślną mapę stylów dla bieżącego składnika. Mapa stylów zawiera typ odpowiedni dla składnika, w zależności od stylu składnika. Na przykład dla stylu disabledTextFormat
wartość jest równa null
lub jest obiektem TextFormat. Można używać tych stylów w wywołaniach metody setStyle()
dla bieżącego składnika. Poniższy kod przesłania domyślny styl disabledTextFormat
dla określonego składnika:
componentInstance.setStyle("disabledTextFormat", new TextFormat());
Object — Obiekt o stylach domyślnych.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
override public function itemToLabel(item:Object):String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera ciąg znaków, który mechanizm renderujący wyświetla dla danego obiektu danych zgodnie z właściwościami labelField
i labelFunction
.
Uwaga: pole labelField
nie jest używane, jeśli dla właściwości labelFunction
ustawiono funkcję zwrotną.
Parametry
item:Object — Obiekt, który ma być renderowany.
|
String — Ciąg znaków do wyświetlenia na podstawie danych.
|
Przykład ( Sposób korzystania z tego przykładu )
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 | () | metoda |
override public function scrollToIndex(newCaretIndex:int):void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Przewija listę do elementu o podanym indeksie. Jeśli indeks nie mieści się w zakresie, pozycja przewijania nie ulega zmianie.
Parametry
newCaretIndex:int — Indeks, do którego można/należy przewinąć.
|
- Dodaj klasy List, Button i Label do biblioteki.
- Zapisz ten kod pod nazwą ListExample.as w tym samym katalogu, co plik FLA.
- Ustaw właściwość DocumentClass w pliku FLA na wartość 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, 12:06 PM Z