| 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ść
labelstanowiącą opis oraz właściwośćdataprzechowują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):voidPrzykł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):voidPrzykł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):voidPowią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):voidPrzykł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):voidPrzykł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):voidList | () | 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
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne