IContainer  - AS3 Flex

Określa tryb przycisku tej ikonki. Wartość true powoduje, że ikonka zachowuje się jak przycisk, co oznacza, iż wyzwala wyświetlanie wskaźnika w postaci dłoni w momencie przesunięcia wskaźnika nad ikonkę oraz możliwość odebrania zdarzenia click przy wciśnięciu klawiszy enter lub spacji kiedy ikonka jest aktywna. Możliwe jest ograniczenie wyświetlania kursora rączki poprzez ustawienie właściwości useHandCursor na wartość false, co spowoduje wyświetlanie strzałki.

Wprawdzie lepiej jest stosować klasę SimpleButton w celu utworzenia przycisków, możliwe jest wykorzystanie właściwości buttonMode w celu nadania ikonce kilku funkcjonalności przycisku. W celu włączenia ikonki do sekwencji aktywacji klawiszem Tab, należy ustawić właściwość tabEnabled (odziedziczoną z klasy InteractiveObject z wartością domyślną false) na wartość true. Dodatkowo należy rozważyć, czy obiekty podrzędne ikonki mają reagować na interakcje ze strony użytkownika. W przypadku większości przycisków interakcji z użytkownikiem nie należy włączać dla obiektów podrzędnych, gdyż może to zakłócać strumień zdarzeń. W celu wyłączenia interakcji z użytkownikiem dla obiektów podrzędnych należy ustawić właściwość mouseChildren (odziedziczoną z klasy DisplayObjectContainer) na wartość false.

W przypadku wykorzystania właściwości buttonMode z klasą MovieClip (która jest podklasą klasy Sprite), przycisk może mieć dodatkowe funkcje. Przy zawarciu klatek oznaczonych _up, _over i _down moduł Flash Player zapewnia automatyczne zmiany stanu (funkcjonalność podobna do tej zapewnionej przez poprzednie wersje skryptu ActionScript dla klipów filmowych wykorzystanych jako przyciski). Automatyczne zmiany stanów nie są dostępne dla ikonek, gdyż nie posiadają one osi czasu, a zatem nie mają też ramek, którym można nadać etykiety.

Containers use an internal content pane to control scrolling. The creatingContentPane is true while the container is creating the content pane so that some events can be ignored or blocked.

The Button control designated as the default button for the container. When controls in the container have focus, pressing the Enter key is the same as clicking this Button control.

Określa, czy obiekt otrzymuje zdarzenia doubleClick. Domyślna wartość to false co oznacza, iż domyślnie instancja InteractiveObject nie otrzymuje zdarzeń doubleClick. Jeżeli właściwość doubleClickEnabled jest ustawiona na wartość true, wówczas instancja otrzymuje zdarzenia doubleClick wewnątrz swoich granic. Właściwość mouseEnabled instancji InteractiveObject również musi być ustawiona na wartość true, aby obiekt mógł otrzymywać zdarzenia doubleClick.

Ustawienie tej właściwości nie powoduje wywołania żadnego zdarzenia. Konieczne jest zastosowanie metody addEventListener() w celu dodania detektora zdarzeń dla zdarzenia doubleClick.

Określa obiekt wyświetlany, nad którym jest przeciągana ikonka, lub na którą upuszczono ikonkę.

Gets the FocusManager that controls focus for this component and its peers. Each popup has its own focus loop and therefore its own instance of a FocusManager. To make sure you're talking to the right one, use this method.

Określa, czy z tym obiektem skojarzono ramkę aktywności. Może mieć jedną z trzech wartości: true, false lub null. Wartości true i false działają zgodnie z oczekiwaniami; określają one, czy pojawia się prostokąt oznaczający aktywność obiektu. Wartość null oznacza, że ten obiekt jest zgodny z właściwością stageFocusRect stołu montażowego.

Określa obiekt Graphics skojarzony z ikonką, której mogą dotyczyć polecenia rysowania kształtów wektorowych.

Określa ikonkę, która ma pełnić funkcję obszaru naciskania innej ikonki. Jeżeli właściwość hitArea nie istnieje lub jej wartością jest null bądź undefined, wówczas sama ikonka jest wykorzystywana jako obszar naciskania. Wartością właściwości hitArea może być odwołanie do obiektu Sprite.

Możliwa jest zmiana właściwości hitArea w dowolnym momencie; zmodyfikowana ikonka natychmiast wykorzystuje nowe zachowanie obszaru naciskania. Ikonka określona jako obszar naciskania nie musi być widoczna; jej kształt graficzny, wprawdzie niewidoczny, jest wciąż wykrywany jako obszar naciskania.

Uwaga: Konieczne jest ustawienie właściwości mouseEnabled na wartość false ikonki określonej jako obszar naciskania. W innym przypadku przycisk ikonki może nie funkcjonować, ponieważ ikonka określona jako obszar naciskania, a nie przycisk, otrzymuje zdarzenia interakcji z użytkownikiem.

The current position of the horizontal scroll bar. This is equal to the distance in pixels between the left edge of the scrollable surface and the leftmost piece of the surface that is currently visible.

Określa, czy elementy podrzędne obiektu obsługują mysz lub inne urządzenie wejściowe użytkownika. Jeśli obiekt obsługuje takie urządzenia, użytkownik może wchodzić z nim w interakcje za pomocą myszy lub innego urządzenia wejściowego. Wartością domyślną jest true.

Właściwość ta jest pomocna przy utworzeniu przycisku z instancją klasy Sprite (zamiast wykorzystania klasy SimpleButton). Przy wykorzystaniu instancji Sprite w celu utworzenia przycisku możliwa jest dekoracja przycisku przez zastosowanie metody addChild() w celu dodania innych instancji Sprite. Proces ten może wywołać nieoczekiwane zachowanie ze zdarzeniami myszy, ponieważ dodawane instancje Sprite jako elementy podrzędne mogą stać się obiektami docelowymi zdarzeń myszy, zamiast planowanych obiektów nadrzędnych. W celu zapewnienia, iż obiektami docelowymi zdarzeń myszy będą obiekty nadrzędne, należy ustawić właściwość mouseChildren instancji nadrzędnej na wartość false.

Ustawienie tej właściwości nie powoduje wywołania żadnego zdarzenia. Konieczne jest zastosowanie metody addEventListener() w celu utworzenia interaktywnej funkcjonalności.

Określa, czy ten obiekt odbiera komunikaty z myszy lub innego urządzenia wejściowego użytkownika. Domyślna wartość to true, co oznacza, że domyślnie każda instancja klasy InteractiveObject znajdująca się na liście wyświetlania odbiera zdarzenia myszy lub innego urządzenia wejściowego. Jeśli dla właściwości mouseEnabled jest ustawiona wartość false, wystąpienie nie odbiera zdarzeń myszy (ani innych zdarzeń związanych z interakcją ze strony użytkownika, na przykład zdarzeń klawiatury). Nie ma to wypływu na żaden z obiektów podrzędnych instancji z listy wyświetlania. W celu zmiany zachowania mouseEnabled dla wszystkich obiektów podrzędnych z listy wyświetlania należy zastosować funkcję flash.display.DisplayObjectContainer.mouseChildren.

Ustawienie tej właściwości nie powoduje wywołania żadnego zdarzenia. Konieczne jest zastosowanie metody addEventListener() w celu utworzenia interaktywnej funkcjonalności.

Zwraca liczbę elementów potomnych tego obiektu.

Kontroluje dźwięki skojarzone z tą ikonką.

Uwaga: Ta właściwość nie ma wpływu na treść HTML w obiekcie HTMLControl (w środowisku Adobe AIR).

Determines whether the children of the object are tab enabled.

Note: Do not use this property with Flex. Instead, use the UIComponent.hasFocusableChildren property.

Powiązane elementy interfejsu API

Określa, czy ten obiekt można osiągnąć za pomocą klawisza Tab. Wartość true, jeżeli obiekt ten można osiągnąć za pomocą klawisza Tab; w innym przypadku wartość false. Domyślnie wartość to false, z wyjątkiem sytuacji wymienionych poniżej:

• Wartość true dla obiektu SimpleButton.
• Wartość true dla obiektu TextField z właściwością type = "input".
• Wartość true dla obiektu Sprite lub obiektu MovieClip z właściwością buttonMode = true.

Określa kolejność uaktywniania obiektów (z pliku SWF) za pomocą klawisza Tab. Właściwość tabIndex ma domyślnie wartość -1, co oznacza iż nie jest ustawiony indeks tabulacji dla tego obiektu.

Jeżeli dowolny z obecnie wyświetlanych obiektów w pliku SWF zawiera właściwość tabIndex, wówczas automatyczna kolejność uaktywniania dla klawisza Tab jest wyłączone, zaś kolejność jest określana przez właściwości tabIndex obiektów w pliku SWF. Do własnej kolejności uaktywniania dla klawisza Tab można włączyć tylko obiekty posiadające właściwości tabIndex.

Wartością właściwości tabIndex może być nie ujemna liczba całkowita. Obiekty są porządkowane zgodnie z właściwościami tabIndex w kolejności rosnącej. Obiekt z wartością właściwości tabIndex równą 1 ma pierwszeństwo względem obiektu z wartością właściwości tabIndex równą 2. Nie należy używać tej samej wartości tabIndex dla wielu obiektów.

Własna kolejność uaktywniania definiowana przez właściwość tabIndex to flat. Oznacza to, iż nie zwraca się uwagi na stosunki hierarchiczne obiektów w pliku SWF. Wszystkie obiekty w pliku SWF z właściwościami tabIndex są układane zgodnie z kolejnością aktywacji klawiszem Tab, która jest określane przez wartości właściwości tabIndex.

Uwaga: Aby ustawić kolejność aktywacji klawiszem Tab dla instancji TLFTextField, należy wykonać rzutowanie obiektu podrzędnego obiektu wyświetlanego TLFTextField na klasę InteractiveObject, a następnie ustawić właściwość tabIndex. Na przykład:

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

Zwraca obiekt TextSnapshot dla tego wystąpienia klasy DisplayObjectContainer.

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. Wartość domyślna dla właściwości useHandCursor wynosi true. W przypadku ustawienia właściwości useHandCursor na wartość true, w momencie przesunięcia wskaźnika nad ikonkę przycisku pojawia się wskaźnik w kształcie dłoni. W przypadku ustawienia właściwości useHandCursor na wartość false wykorzystywany jest kursor strzałki.

Możliwa jest zmiana właściwości useHandCursor w dowolnym momencie; zmodyfikowana ikonka natychmiast wykorzystuje nowy wygląd kursora.

Uwaga: Jeśli we Flex lub Flash Builder ikonka zawiera ikonki podrzędne, wówczas właściwość mouseChildren można ustawić na wartość false. Na przykład, jeśli kursor w kształcie rączki ma być wyświetlany nad elementem sterującym Flex <mx:Label>, należy ustawić właściwości useHandCursor i buttonMode na wartość true oraz właściwość mouseChildren na wartość false.

The current position of the vertical scroll bar. This is equal to the distance in pixels between the top edge of the scrollable surface and the topmost piece of the surface that is currently visible.

Returns an object that has four properties: left, top, right, and bottom. The value of each property equals the thickness of the chrome (visual elements) around the edge of the container.

The chrome includes the border thickness. If the horizontalScrollPolicy or verticalScrollPolicy property value is ScrollPolicy.ON, the chrome also includes the thickness of the corresponding scroll bar. If a scroll policy is ScrollPolicy.AUTO, the chrome measurement does not include the scroll bar thickness, even if a scroll bar is displayed.

Subclasses of Container should override this method, so that they include other chrome to be taken into account when positioning the Container's children. For example, the viewMetrics property for the Panel class should return an object whose top property includes the thickness of the Panel container's title bar.

Dodaje potomne wystąpienie klasy DisplayObject do tego wystąpienia klasy DisplayObjectContainer. Obiekt podrzędny jest dodawany na przód (szczyt) pozostałych obiektów podrzędnych w tej instancji DisplayObjectContainer. (W celu dodania obiektu podrzędnego na określony indeks należy wykorzystać metodę addChildAt()).

Dodanie obiektu potomnego, który ma już element macierzysty w postaci innego kontenera obiektów ekranowych, spowoduje usunięcie tego obiektu z listy elementów potomnych tego innego kontenera obiektów ekranowych.

Uwaga: Polecenie stage.addChild() może powodować problemy w opublikowanych plikach SWF, a w szczególności problemy z zabezpieczeniami i konflikty z innymi załadowanymi plikami SWF. W danej instancji środowiska wykonawczego Flash istnieje tylko jeden stół montażowy, niezależnie od tego, ile plików SWF jest załadowanych do środowiska. Dlatego co do zasady nie należy nigdy dodawać obiektów bezpośrednio do stołu montażowego. Jedynym obiektem, jaki powinien zawierać stół montażowy, jest obiekt główny hierarchii. Należy utworzyć obiekt DisplayObjectContainer, który będzie zawierał wszystkie elementy listy wyświetlania. Następnie w razie potrzeby należy dodać tę instancję klasy DisplayObjectContainer do stołu montażowego.

Parametry

Dodaje instancję obiektu podrzędnego DisplayObject do tej instancji obiektu DisplayObjectContainer. Obiekt podrzędny jest dodawany na następnym określonym indeksie. Indeks równy 0 reprezentuje tył (dół) listy wyświetlania dla tego obiektu DisplayObjectContainer.

Trzy obiekty wyświetlane o etykietach a, b i c znajdują się odpowiednio na indeksach 0, 2 i 1, co widać na poniższym przykładzie:

W przypadku dodania obiektu podrzędnego, który jako obiekt nadrzędny posiada już inny kontener obiektów wyświetlanych, jest on usuwany z listy obiektów podrzędnych tego kontenera.

Parametry

Wskazuje, czy ograniczenia ze względów bezpieczeństwa mogą spowodować pominięcie obiektów wyświetlanych z listy zwróconej przy wywołaniu metody DisplayObjectContainer.getObjectsUnderPoint() z określonym punktem point. Domyślnie zawartość jednej domeny nie może mieć dostępu do obiektów innej domeny, chyba że zostało to dozwolone poprzez wywołanie metody Security.allowDomain(). Więcej informacji na temat zabezpieczeń zawiera odpowiedni temat w witrynie Flash Player Developer Center: Bezpieczeństwo.

Parametr point jest określony w układzie współrzędnych obiektu Stage, który może różnić się względem układu współrzędnych kontenera obiektów wyświetlanych (chyba że jest nim obiekt Stage). Możliwe jest zastosowanie metod globalToLocal() i localToGlobal() w celu konwersji punktów pomiędzy dwoma układami współrzędnych.

Parametry

Decyduje o tym, czy określony obiekt wyświetlany jest obiektem podrzędnym instancji obiektu DisplayObjectContainer, czy też sam jest taką instancją. Przeszukiwanie obejmuje całą listę wyświetlania, włącznie z tą instancją DisplayObjectContainer. Obiekty wnucząt i prawnucząt (itd.) zwracają wartość true.

Parametry

Zwraca wystąpienie potomnego obiektu ekranowego o podanym indeksie.

Parametry

Zwraca instancję podrzędnego obiektu wyświetlanego o podanej nazwie. Jeżeli więcej niż jeden podrzędny obiekt wyświetlany nosi tę określoną nazwę, metoda zwraca pierwszy obiekt z listy obiektów podrzędnych.

Metoda getChildAt() jest szybsza niż metoda getChildByName(). Metoda getChildAt() uzyskuje dostęp do obiektu podrzędnego wprost z buforowanej tablicy, zaś metoda getChildByName() musi w tym celu przejść przez powiązaną listę.

Parametry

Zwraca indeks instancji child DisplayObject.

Parametry

Zwraca tablicę obiektów, które leżą poniżej określonego punktu i są obiektami podrzędnymi tej instancji obiektu DisplayObjectContainer. Obiekty niedostępne ze względów bezpieczeństwa są pominięte w zwróconej tablicy. W celu określenia, czy ograniczenia ze względów bezpieczeństwa mają wpływ na zwracaną tablicę, należy wywołać metodę areInaccessibleObjectsUnderPoint().

Parametr point jest określony w układzie współrzędnych obiektu Stage, który może różnić się względem układu współrzędnych kontenera obiektów wyświetlanych (chyba że jest nim obiekt Stage). Możliwe jest zastosowanie metod globalToLocal() i localToGlobal() w celu konwersji punktów pomiędzy dwoma układami współrzędnych.

Parametry

Usuwa określoną instancję child DisplayObject z listy obiektów podrzędnych instancji DisplayObjectContainer. Właściwość parent usuniętego obiektu podrzędnego jest ustawiona na wartość null, zaś obiekt jest usuwany jako element zbędny, jeżeli nie ma do niego innych odwołań. Indeksy dowolnych obiektów wyświetlanych znajdujących się ponad obiektem podrzędnym w obiekcie DisplayObjectContainer są zmniejszane o 1.

Proces czyszczenia pamięci ponownie przydziela niewykorzystane miejsce w pamięci. Jeżeli zmienna lub obiekt nie są już aktywnie używane lub aktywnie przechowywane, wówczas proces czyszczenia pamięci zwalnia zajmowaną przez nie pamięć, o ile nie istnieją odwołania do nich.

Parametry

Usuwa obiekt potomny DisplayObject z określonej pozycji index z listy obiektów potomnych instancji DisplayObjectContainer. Właściwość parent usuniętego obiektu potomnego jest ustawiona na wartość null, zaś obiekt jest usuwany jako element zbędny, jeżeli nie ma do niego innych odwołań. Indeksy dowolnych obiektów wyświetlanych znajdujących się ponad obiektem podrzędnym w obiekcie DisplayObjectContainer są zmniejszane o 1.

Proces czyszczenia pamięci ponownie przydziela niewykorzystane miejsce w pamięci. Jeżeli zmienna lub obiekt nie są już aktywnie używane lub aktywnie przechowywane, wówczas proces czyszczenia pamięci zwalnia zajmowaną przez nie pamięć, o ile nie istnieją odwołania do nich.

Parametry

Zmienia położenie istniejącego potomka w kontenerze obiektu ekranowego. Ma to wpływ na warstwowanie obiektów podrzędnych. Trzy obiekty wyświetlane o etykietach a, b i c znajdują się odpowiednio na indeksach 0, 1 i 2, co widać na poniższym przykładzie:

Przy wykorzystaniu metody setChildIndex() i określeniu indeksu, który jest już zajęty, jedynymi pozycjami ulegającymi zmianie są stara i nowa pozycja obiektu wyświetlanego. Wszystkie inne pozycje pozostają bez zmian. Jeżeli obiekt podrzędny jest przesunięty na index NIŻSZY niż obecny, wówczas wszystkie obiekty w przestrzeni zmiany pozycji ZWIĘKSZAJĄ swoje odwołanie indeksowe o 1. Jeżeli obiekt potomny jest przesunięty na index WYŻSZY niż obecny, wówczas wszystkie obiekty w przestrzeni zmiany pozycji ZMNIEJSZAJĄ swoje odwołanie indeksowe o 1. Przykładowo jeżeli kontener obiektów wyświetlania nosi nazwę container (z poprzedniego przykładu), wówczas możliwa jest zamiana pozycji obiektów wyświetlania nazwanych a i b poprzez wywołanie następującego kodu:

container.setChildIndex(container.getChildAt(1), 0);

Kod ten skutkuje ułożeniem obiektów w sposób przedstawiony poniżej:

Parametry

Pozwala użytkownikowi przeciągnąć określoną ikonkę. Przeciągnięcie ikonki jest możliwe do momentu jawnego zatrzymania poprzez wywołanie do metody Sprite.stopDrag() lub do momentu, możliwe stanie się przeciągnięcie innej ikonki. W danym momencie możliwe jest przeciągnięcie tylko jednej ikonki.

Trójwymiarowe obiekty wyświetlane podążają za ruchem wskaźnika, a metoda Sprite.startDrag() przesuwa obiekt po trójwymiarowej płaszczyźnie zdefiniowanej przez obiekt wyświetlany. Jeśli jednak obiekt wyświetlany jest obiektem dwuwymiarowym oraz elementem podrzędnym obiektu trójwymiarowego, wówczas obiekt dwuwymiarowy jest przesuwany po płaszczyźnie trójwymiarowej zdefiniowanej przez nadrzędny obiekt trójwymiarowy.

Parametry

Kończy metodę startDrag(). Ikonka, której przeciągnięcie stało się możliwe w wyniku wywołania metody startDrag(), utrzymuje ten stan do momentu dodania metody stopDrag() lub gdy stanie się możliwe przeciągnięcie innej ikonki. W danym momencie możliwe jest przeciągnięcie tylko jednej ikonki.

Zamienia kolejność dwóch określonych obiektów podrzędnych. Wszelkie pozostałe obiekty potomne w kontenerze obiektów ekranowych pozostają na tych samych indeksach.

Parametry

Zamienia miejscami na liście dwa różne obiekty podrzędne o podanych indeksach. Wszelkie pozostałe obiekty podrzędne w kontenerze obiektów wyświetlanych pozostają na tych samych indeksach.

Parametry