| Pakiet | mx.core |
| Interfejs | public interface IContainer extends IUIComponent , IFlexDisplayObject , IBitmapDrawable , IEventDispatcher |
| Implementory | Container, Legend |
| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Powiązane elementy interfejsu API
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
 | accessibilityProperties : AccessibilityProperties
Bieżące opcje dostępności tego obiektu wyświetlanego. | IFlexDisplayObject | |
| alpha : Number
Wartość przezroczystości alfa określonego obiektu. | IFlexDisplayObject | |
| baselinePosition : Number [tylko do odczytu]
The y-coordinate of the baseline
of the first line of text of the component. | IUIComponent | |
| blendMode : String
Wartość z klasy BlendMode określająca, jakiego trybu mieszania należy użyć. | IFlexDisplayObject | |
| buttonMode : Boolean
Określa tryb przycisku tej ikonki. | IContainer | ||
| cacheAsBitmap : Boolean
Jeśli ustawiono wartość true, środowisko wykonawcze Flash buforuje wewnętrzną reprezentację bitmapy obiektu wyświetlanego. | IFlexDisplayObject | |
| creatingContentPane : Boolean
Containers use an internal content pane to control scrolling. | IContainer | ||
| defaultButton : IFlexDisplayObject
The Button control designated as the default button
for the container. | IContainer | ||
| document : Object
A reference to the document object associated with this component. | IUIComponent | |
| doubleClickEnabled : Boolean
Określa, czy ten obiekt reaguje na zdarzenia doubleClick (dwukrotne kliknięcia). | IContainer | ||
| dropTarget : DisplayObject [tylko do odczytu]
Określa obiekt ekranowy, nad którym jest przeciągana ikonka, lub na który upuszczono ikonkę. | IContainer | ||
| enabled : Boolean
Whether the component can accept user interaction. | IUIComponent | |
| explicitHeight : Number
The explicitly specified height for the component,
in pixels, as the component's coordinates. | IUIComponent | |
| explicitMaxHeight : Number [tylko do odczytu]
Number that specifies the maximum height of the component,
in pixels, as the component's coordinates. | IUIComponent | |
| explicitMaxWidth : Number [tylko do odczytu]
Number that specifies the maximum width of the component,
in pixels, as the component's coordinates. | IUIComponent | |
| explicitMinHeight : Number [tylko do odczytu]
Number that specifies the minimum height of the component,
in pixels, as the component's coordinates. | IUIComponent | |
| explicitMinWidth : Number [tylko do odczytu]
Number that specifies the minimum width of the component,
in pixels, as the component's coordinates. | IUIComponent | |
| explicitWidth : Number
The explicitly specified width for the component,
in pixels, as the component's coordinates. | IUIComponent | |
| filters : Array
Indeksowana tablica zawierająca wszystkie filtry aktualnie skojarzone z obiektem wyświetlanym. | IFlexDisplayObject | |
| focusManager : IFocusManager [tylko do odczytu]
Gets the FocusManager that controls focus for this component
and its peers. | IContainer | ||
| focusPane : Sprite
A single Sprite object that is shared among components
and used as an overlay for drawing the focus indicator. | IUIComponent | |
| focusRect : Object
Określa, czy z tym obiektem skojarzono ramkę aktywności. | IContainer | ||
| graphics : Graphics [tylko do odczytu]
Określa obiekt Graphics skojarzony z ikonką, której mogą dotyczyć polecenia rysowania kształtów wektorowych. | IContainer | ||
| height : Number
Wysokość obiektu ekranowego w pikselach. | IFlexDisplayObject | |
| hitArea : Sprite
Określa ikonkę, która ma pełnić funkcję obszaru naciskania innej ikonki. | IContainer | ||
| horizontalScrollPosition : Number
The current position of the horizontal scroll bar. | IContainer | ||
| includeInLayout : Boolean
Specifies whether this component is included in the layout of the
parent container. | IUIComponent | |
| isPopUp : Boolean
Set to true by the PopUpManager to indicate
that component has been popped up. | IUIComponent | |
| loaderInfo : LoaderInfo [tylko do odczytu]
Zwraca obiekt LoaderInfo zawierający informacje o ładowaniu pliku, do którego należy ten obiekt wyświetlany. | IFlexDisplayObject | |
| mask : DisplayObject
Wywoływany obiekt wyświetlany jest maskowany przez określony obiekt maski. | IFlexDisplayObject | |
| maxHeight : Number [tylko do odczytu]
Number that specifies the maximum height of the component,
in pixels, as the component's coordinates. | IUIComponent | |
| maxWidth : Number [tylko do odczytu]
Number that specifies the maximum width of the component,
in pixels, as the component's coordinates. | IUIComponent | |
| measuredHeight : Number [tylko do odczytu]
The measured height of this object. | IFlexDisplayObject | |
| measuredMinHeight : Number
The default minimum height of the component, in pixels. | IUIComponent | |
| measuredMinWidth : Number
The default minimum width of the component, in pixels. | IUIComponent | |
| measuredWidth : Number [tylko do odczytu]
The measured width of this object. | IFlexDisplayObject | |
| minHeight : Number [tylko do odczytu]
Number that specifies the minimum height of the component,
in pixels, as the component's coordinates. | IUIComponent | |
| minWidth : Number [tylko do odczytu]
Number that specifies the minimum width of the component,
in pixels, as the component's coordinates. | IUIComponent | |
| mouseChildren : Boolean
Określa, czy elementy potomne obiektu obsługują mysz lub inne urządzenie wejściowe użytkownika. | IContainer | ||
| mouseEnabled : Boolean
Określa, czy ten obiekt odbiera komunikaty z myszy lub innego urządzenia wejściowego użytkownika. | IContainer | ||
| mouseX : Number [tylko do odczytu]
Określa współrzędną x myszy lub urządzenia wejściowego użytkownika w pikselach. | IFlexDisplayObject | |
| mouseY : Number [tylko do odczytu]
Określa współrzędną y myszy lub urządzenia wejściowego użytkownika w pikselach. | IFlexDisplayObject | |
| name : String
Nazwa instancji obiektu DisplayObject. | IFlexDisplayObject | |
| numChildren : int [tylko do odczytu]
Zwraca liczbę elementów potomnych tego obiektu. | IContainer | ||
| opaqueBackground : Object
Określa, czy przy konkretnym kolorze tła obiekt wyświetlany jest nieprzejrzysty. | IFlexDisplayObject | |
| owner : DisplayObjectContainer
The owner of this IVisualElement object. | IUIComponent | |
| parent : DisplayObjectContainer [tylko do odczytu]
Odnosi się do obiektu DisplayObjectContainer, który zawiera obiekt wyświetlany. | IFlexDisplayObject | |
| percentHeight : Number
Number that specifies the height of a component as a
percentage of its parent's size. | IUIComponent | |
| percentWidth : Number
Number that specifies the width of a component as a
percentage of its parent's size. | IUIComponent | |
| 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. | IFlexDisplayObject | |
| rotation : Number
Określa wielkość obrotu instancji obiektu DisplayObject (w kątach). | IFlexDisplayObject | |
| scale9Grid : Rectangle
Aktualnie stosowana siatka skalowania. | IFlexDisplayObject | |
| scaleX : Number
Wskazuje skalę poziomą (procent) obiektu względem punktu odniesienia. | IFlexDisplayObject | |
| scaleY : Number
Wskazuje skalę pionową (procent) obiektu względem punktu odniesienia. | IFlexDisplayObject | |
| scrollRect : Rectangle
Granice obszaru przewijania obiektu wyświetlanego. | IFlexDisplayObject | |
| soundTransform : flash.media:SoundTransform
Kontroluje dźwięki skojarzone z tą ikonką. | IContainer | ||
| stage : Stage [tylko do odczytu]
Stół montażowy obiektu wyświetlanego. | IFlexDisplayObject | |
| systemManager : ISystemManager
A reference to the SystemManager object for this component. | IUIComponent | |
| tabChildren : Boolean
Determines whether the children of the object are tab enabled. | IContainer | ||
| tabEnabled : Boolean
Określa, czy do tego obiektu można przejść za pomocą klawisza Tab. | IContainer | ||
| tabIndex : int
Określa kolejność uaktywniania obiektów (z pliku SWF) za pomocą klawisza Tab. | IContainer | ||
| textSnapshot : flash.text:TextSnapshot [tylko do odczytu]
Zwraca obiekt TextSnapshot dla tego wystąpienia klasy DisplayObjectContainer. | IContainer | ||
| transform : flash.geom:Transform
Obiekt z właściwościami dotyczącymi matrycy obiektu wyświetlanego, transformacji kolorów oraz granic pikseli. | IFlexDisplayObject | |
| tweeningProperties : Array
Used by EffectManager. | IUIComponent | |
| 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. | IContainer | ||
| verticalScrollPosition : Number
The current position of the vertical scroll bar. | IContainer | ||
| viewMetrics : EdgeMetrics [tylko do odczytu]
Returns an object that has four properties: left,
top, right, and bottom. | IContainer | ||
| visible : Boolean
Decyduje, czy obiekt wyświetlany jest widoczny, czy nie. | IFlexDisplayObject | |
| width : Number
Szerokość obiektu ekranowego w pikselach. | IFlexDisplayObject | |
| x : Number
Oznacza współrzędną x instancji obiektu DisplayObject w lokalnym układzie współrzędnych nadrzędnego obiektu DisplayObjectContainer. | IFlexDisplayObject | |
| y : Number
Oznacza współrzędną y instancji obiektu DisplayObject w lokalnym układzie współrzędnych nadrzędnego obiektu DisplayObjectContainer. | IFlexDisplayObject | |
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
Dodaje potomne wystąpienie klasy DisplayObject do tego wystąpienia klasy DisplayObjectContainer. | IContainer | ||
Dodaje potomne wystąpienie klasy DisplayObject do tego wystąpienia klasy DisplayObjectContainer. | IContainer | ||
| 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. | IEventDispatcher | |
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. | IContainer | ||
Decyduje o tym, czy określony obiekt ekranowy jest potomkiem instancji obiektu DisplayObjectContainer, czy też sam jest taką instancją. | IContainer | ||
|
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | IEventDispatcher | |
|
Zwraca prostokąt definiujący obszar obiektu wyświetlanego (w układzie współrzędnych obiektu targetCoordinateSpace). | IFlexDisplayObject | |
Zwraca instancję podrzędnego obiektu wyświetlanego o podanym indeksie. | IContainer | ||
Zwraca instancję podrzędnego obiektu wyświetlanego o podanej nazwie. | IContainer | ||
Zwraca indeks podrzędnej instancji DisplayObject. | IContainer | ||
|
A convenience method for determining whether to use the
explicit or measured height
| IUIComponent | |
|
A convenience method for determining whether to use the
explicit or measured width
| IUIComponent | |
Zwraca tablicę obiektów, które leżą poniżej określonego punktu i są obiektami podrzędnymi tej instancji obiektu DisplayObjectContainer. | IContainer | ||
|
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). | IFlexDisplayObject | |
|
Konwertuje obiekt punktowy ze współrzędnych obiektu Stage (globalne) do współrzędnych obiektu wyświetlanego (lokalne). | IFlexDisplayObject | |
|
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | IEventDispatcher | |
|
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. | IFlexDisplayObject | |
|
Analizuje obiekt wyświetlany w celu ustalenia czy nakłada się on lub przecina punkt określony przez parametry x i y. | IFlexDisplayObject | |
|
Initialize the object. | IUIComponent | |
|
Konwertuje obiekt punktowy ze współrzędnych obiektu wyświetlanego (lokalne) do współrzędnych obiektu Stage (globalne). | IFlexDisplayObject | |
|
Moves this object to the specified x and y coordinates. | IFlexDisplayObject | |
|
Returns true if the chain of owner properties
points from child to this UIComponent. | IUIComponent | |
|
Called by Flex when a UIComponent object is added to or removed from a parent. | IUIComponent | |
Usuwa określoną instancję obiektu podrzędnego DisplayObject z listy obiektów podrzędnych instancji DisplayObjectContainer. | IContainer | ||
Usuwa obiekt potomny DisplayObject o podanym indeksie z listy elementów potomnych obiektu DisplayObjectContainer. | IContainer | ||
|
Usuwa detektor z obiektu EventDispatcher. | IEventDispatcher | |
|
Sets the actual size of this object. | IFlexDisplayObject | |
Zmienia położenie istniejącego elementu potomnego w kontenerze obiektów ekranowych. | IContainer | ||
|
Called when the visible property changes. | IUIComponent | |
Pozwala użytkownikowi przeciągnąć określoną ikonkę. | IContainer | ||
Kończy metodę startDrag(). | IContainer | ||
Zamienia kolejność dwóch określonych obiektów podrzędnych. | IContainer | ||
Zamienia miejscami na liście dwa różne obiekty potomne o podanych indeksach. | IContainer | ||
|
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | IEventDispatcher | |
buttonMode | właściwość |
buttonMode:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get buttonMode():Boolean public function set buttonMode(value:Boolean):voidcreatingContentPane | właściwość |
creatingContentPane:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get creatingContentPane():Boolean public function set creatingContentPane(value:Boolean):voiddefaultButton | właściwość |
defaultButton:IFlexDisplayObject| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get defaultButton():IFlexDisplayObject public function set defaultButton(value:IFlexDisplayObject):voiddoubleClickEnabled | właściwość |
doubleClickEnabled:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get doubleClickEnabled():Boolean public function set doubleClickEnabled(value:Boolean):voiddropTarget | właściwość |
dropTarget:DisplayObject [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Określa obiekt wyświetlany, nad którym jest przeciągana ikonka, lub na którą upuszczono ikonkę.
Implementacja
public function get dropTarget():DisplayObjectfocusManager | właściwość |
focusManager:IFocusManager [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get focusManager():IFocusManagerfocusRect | właściwość |
focusRect:Object| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get focusRect():Object public function set focusRect(value:Object):voidgraphics | właściwość |
graphics:Graphics [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Określa obiekt Graphics skojarzony z ikonką, której mogą dotyczyć polecenia rysowania kształtów wektorowych.
Implementacja
public function get graphics():GraphicshitArea | właściwość |
hitArea:Sprite| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get hitArea():Sprite public function set hitArea(value:Sprite):voidhorizontalScrollPosition | właściwość |
horizontalScrollPosition:Number| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get horizontalScrollPosition():Number public function set horizontalScrollPosition(value:Number):voidmouseChildren | właściwość |
mouseChildren:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get mouseChildren():Boolean public function set mouseChildren(value:Boolean):voidmouseEnabled | właściwość |
mouseEnabled:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get mouseEnabled():Boolean public function set mouseEnabled(value:Boolean):voidnumChildren | właściwość |
soundTransform | właściwość |
soundTransform:flash.media:SoundTransform| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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).
Implementacja
public function get soundTransform():flash.media:SoundTransform public function set soundTransform(value:flash.media:SoundTransform):voidtabChildren | właściwość |
tabChildren:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Determines whether the children of the object are tab enabled.
Note: Do not use this property with Flex.
Instead, use the UIComponent.hasFocusableChildren property.
Implementacja
public function get tabChildren():Boolean public function set tabChildren(value:Boolean):voidPowiązane elementy interfejsu API
tabEnabled | właściwość |
tabEnabled:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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ść
truedla obiektu SimpleButton. - Wartość
truedla obiektu TextField z właściwościątype = "input". - Wartość
truedla obiektu Sprite lub obiektu MovieClip z właściwościąbuttonMode = true.
Implementacja
public function get tabEnabled():Boolean public function set tabEnabled(value:Boolean):voidtabIndex | właściwość |
tabIndex:int| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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;Aby odwrócić kolejność aktywacji klawiszem Tab względem ustawienia domyślnego dla trzech instancji obiektu TLFTextField (
tlfInstance1, tlfInstance2 i tlfInstance3), należy użyć poniższego kodu:
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Implementacja
public function get tabIndex():int public function set tabIndex(value:int):voidtextSnapshot | właściwość |
textSnapshot:flash.text:TextSnapshot [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Zwraca obiekt TextSnapshot dla tego wystąpienia klasy DisplayObjectContainer.
Implementacja
public function get textSnapshot():flash.text:TextSnapshotuseHandCursor | właściwość |
useHandCursor:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get useHandCursor():Boolean public function set useHandCursor(value:Boolean):voidverticalScrollPosition | właściwość |
verticalScrollPosition:Number| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get verticalScrollPosition():Number public function set verticalScrollPosition(value:Number):voidviewMetrics | właściwość |
viewMetrics:EdgeMetrics [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get viewMetrics():EdgeMetricsaddChild | () | metoda |
public function addChild(child:DisplayObject):DisplayObject| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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
child:DisplayObject — The DisplayObject instance to add as a child of this DisplayObjectContainer instance.
|
DisplayObject — The DisplayObject instance that you pass in the
child parameter.
|
addChildAt | () | metoda |
public function addChildAt(child:DisplayObject, index:int):DisplayObject| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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
child:DisplayObject — The DisplayObject instance to add as a child of this
DisplayObjectContainer instance.
| |
index:int — The index position to which the child is added. If you specify a
currently occupied index position, the child object that exists at that position and all
higher positions are moved up one position in the child list.
|
DisplayObject — The DisplayObject instance that you pass in the
child parameter.
|
areInaccessibleObjectsUnderPoint | () | metoda |
public function areInaccessibleObjectsUnderPoint(point:Point):Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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
point:Point — The point under which to look.
|
Boolean — true if the point contains child display objects with security restrictions.
|
contains | () | metoda |
public function contains(child:DisplayObject):Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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
child:DisplayObject — The child object to test.
|
Boolean — true if the child object is a child of the DisplayObjectContainer
or the container itself; otherwise false.
|
getChildAt | () | metoda |
public function getChildAt(index:int):DisplayObject| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Zwraca wystąpienie potomnego obiektu ekranowego o podanym indeksie.
Parametry
index:int — The index position of the child object.
|
DisplayObject — The child display object at the specified index position.
|
getChildByName | () | metoda |
public function getChildByName(name:String):DisplayObject| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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
name:String — The name of the child to return.
|
DisplayObject — The child display object with the specified name.
|
getChildIndex | () | metoda |
public function getChildIndex(child:DisplayObject):int| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Zwraca indeks instancji child DisplayObject.
Parametry
child:DisplayObject — The DisplayObject instance to identify.
|
int — The index position of the child display object to identify.
|
getObjectsUnderPoint | () | metoda |
public function getObjectsUnderPoint(point:Point):Array| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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
point:Point — The point under which to look.
|
Array — An array of objects that lie under the specified point and are children
(or grandchildren, and so on) of this DisplayObjectContainer instance.
|
removeChild | () | metoda |
public function removeChild(child:DisplayObject):DisplayObject| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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
child:DisplayObject — The DisplayObject instance to remove.
|
DisplayObject — The DisplayObject instance that you pass in the
child parameter.
|
removeChildAt | () | metoda |
public function removeChildAt(index:int):DisplayObject| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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
index:int — The child index of the DisplayObject to remove.
|
DisplayObject — The DisplayObject instance that was removed.
|
setChildIndex | () | metoda |
public function setChildIndex(child:DisplayObject, index:int):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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
child:DisplayObject — The child DisplayObject instance for which you want to change
the index number.
| |
index:int — The resulting index number for the child display object.
|
startDrag | () | metoda |
public function startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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
lockCenter:Boolean (default = false)true), or locked to the point where the user first clicked the
sprite (false).
| |
bounds:Rectangle (default = null) |
stopDrag | () | metoda |
public function stopDrag():void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
swapChildren | () | metoda |
public function swapChildren(child1:DisplayObject, child2:DisplayObject):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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
child1:DisplayObject — The first child object.
| |
child2:DisplayObject — The second child object.
|
swapChildrenAt | () | metoda |
public function swapChildrenAt(index1:int, index2:int):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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
index1:int — The index position of the first child object.
| |
index2:int — The index position of the second child object.
|
Tue Jun 12 2018, 12:06 PM Z