Pakiet | flash.display |
Klasa | public class Stage |
Dziedziczenie | Stage DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Dla zawartości SWF działającej w przeglądarce (w programie Flash® Player) stół montażowy reprezentuje cały obszar, w którym prezentowana jest zawartość Flash. W przypadku zawartości działającej w aplikacji AIR w systemie operacyjnym dla komputerów stacjonarnych każdy obiekt NativeWindow zawiera odpowiadający mu obiekt Stage.
Obiekt stołu montażowego nie jest dostępny globalnie. Należy uzyskać do niego dostęp za pośrednictwem właściwości stage
instancji DisplayObject.
Klasa Stage zawiera kilka klas-przodków — DisplayObjectContainer, InteractiveObject, DisplayObject oraz EventDispatcher — z których dziedziczy właściwości i metody. Wiele z tych właściwości i metod jest nieodpowiednich dla obiektów Stage lub wymagają kontroli bezpieczeństwa w przypadku ich wywoływania dla obiektu Stage. Właściwości i metody, które wymagają kontroli bezpieczeństwa, są dokumentowane jako część klasy Stage.
Ponadto następujące dziedziczone właściwości nie są odpowiednie dla obiektów Stage. W przypadku próby ich ustawienia zostanie zwrócony błąd IllegalOperationError. Te właściwości zawsze mogą być odczytywane, ale nie mogą zostać ustawione, dlatego zawsze zawierają wartości domyślne.
-
accessibilityProperties
-
alpha
-
blendMode
-
cacheAsBitmap
-
contextMenu
-
filters
-
focusRect
-
loaderInfo
-
mask
-
mouseEnabled
-
name
-
opaqueBackground
-
rotation
-
scale9Grid
-
scaleX
-
scaleY
-
scrollRect
-
tabEnabled
-
tabIndex
-
transform
-
visible
-
x
-
y
Niektóre zdarzenia, które zgodnie z oczekiwaniami mogłyby należeć do klasy Stage, takie jak enterFrame
, exitFrame
, frameConstructed
i render
, nie mogą być zdarzeniami Stage, ponieważ nie można zagwarantować, że odwołanie do obiektu Stage będzie istniało w każdej sytuacji, w której te zdarzenia są używane. Te zdarzenia nie mogą być wywoływane przez obiekt Stage, dlatego są wywoływane przez każdą instancję DisplayObject, co oznacza, że można dodać detektor zdarzeń do dowolnej instancji DisplayObject w celu detekcji tych zdarzeń. Te zdarzenia, które stanowią część klasy DisplayObject, są nazywane zdarzeniami broadcast w celu ich odróżnienia od zdarzeń przeznaczonych dla konkretnej instancji DisplayObject. Dwa inne zdarzenia broadcast: activate
i deactivate
należą do klasy nadrzędnej EventDispatcher instancji DisplayObject. Zdarzenia activate
i deactivate
działają podobnie do zdarzeń DisplayObject broadcast, ale te dwa zdarzenia są wywoływane nie tylko przez wszystkie instancje DisplayObject, ale również przez wszystkie instancje EventDispatcher i instancje innych klas nadrzędnych EventDispatcher. Więcej informacji o zdarzeniach broadcast zawiera opis klasy DisplayObject.
Powiązane elementy interfejsu API
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 | ||
align : String
Wartość z klasy StageAlign, określająca wyrównanie stołu montażowego w programie Flash Player lub w przeglądarce. | Stage | ||
allowsFullScreen : Boolean [tylko do odczytu]
Określa, czy ten stół montażowy umożliwia stosowanie trybu pełnoekranowego.
| Stage | ||
allowsFullScreenInteractive : Boolean [tylko do odczytu]
Określa, czy ten stół montażowy umożliwia wyświetlanie na pełnym ekranie z trybem wprowadzania tekstu.
| Stage | ||
alpha : Number
Wartość przezroczystości alfa określonego obiektu. | DisplayObject | ||
autoOrients : Boolean
Określa, czy orientacja stołu montażowego automatycznie zmienia się, gdy zmienia się orientacja urządzenia. | Stage | ||
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 | ||
browserZoomFactor : Number [tylko do odczytu]
Określa współczynnik powiększenia przeglądarki. | Stage | ||
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 | ||
color : uint
Kolor tła pliku SWF. | Stage | ||
colorCorrection : String
Steruje korekcją kolorów na ekranie realizowaną przez środowisko wykonawcze Flash. | Stage | ||
colorCorrectionSupport : String [tylko do odczytu]
Określa, czy środowisko wykonawcze Flash uruchomione jest w systemie operacyjnym obsługującym korekcję kolorów i czy profil koloru dla głównego (podstawowego) monitora może zostać odczytany i rozpoznany przez środowisko Flash. | Stage | ||
constructor : * | Stage | ||
contentsScaleFactor : Number [tylko do odczytu]
Określa efektywny współczynnik skalowania pikseli stołu montażowego. | Stage | ||
contextMenu : NativeMenu
Określa menu kontekstowe tego obiektu. | InteractiveObject | ||
deviceOrientation : String [tylko do odczytu]
Fizyczna orientacja urządzenia. | Stage | ||
displayState : String
Wartość z klasy StageDisplayState określająca, jakiego stanu wyświetlania należy użyć. | Stage | ||
doubleClickEnabled : Boolean
Określa, czy ten obiekt reaguje na zdarzenia doubleClick (dwukrotne kliknięcia). | InteractiveObject | ||
filters : Array
Indeksowana tablica zawierająca wszystkie filtry aktualnie skojarzone z obiektem wyświetlanym. | DisplayObject | ||
focus : InteractiveObject
Obiekt interaktywny, jeśli aktywna jest klawiatura; wartość null, jeśli obiekt aktywny nie jest określony lub jeśli obiekt aktywny należy do obszaru izolowanego, do którego nie ma dostępu obiekt wywoływany. | Stage | ||
focusRect : Object
Określa, czy z tym obiektem skojarzono ramkę aktywności. | InteractiveObject | ||
frameRate : Number
Pobiera i ustawia liczba klatek na sekundę na stole montażowym. | Stage | ||
fullScreenHeight : uint [tylko do odczytu]
Zwraca wysokość monitora, która zostanie wykorzystana jako rozmiar w trybie pełnego ekranu, jeżeli ten stan zostanie wprowadzony natychmiastowo. | Stage | ||
fullScreenSourceRect : Rectangle
Powoduje, że środowisko wykonawcze Flash skaluje określony region stołu montażowego do trybu pełnoekranowego. | Stage | ||
fullScreenWidth : uint [tylko do odczytu]
Zwraca szerokość monitora, która zostanie wykorzystana jako rozmiar w trybie pełnego ekranu, jeżeli ten stan zostanie wprowadzony natychmiastowo. | Stage | ||
height : Number [przesłanianie]
Wysokość obiektu wyświetlanego w pikselach. | Stage | ||
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 | ||
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 [przesłanianie]
Określa, czy elementy podrzędne obiektu obsługują mysz lub inne urządzenie wejściowe użytkownika. | Stage | ||
mouseEnabled : Boolean
Określa, czy ten obiekt odbiera komunikaty z myszy lub innego urządzenia wejściowego użytkownika. | InteractiveObject | ||
mouseLock : Boolean
Aby włączyć blokowanie myszy, należy ustawić wartość na true. | Stage | ||
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 | ||
nativeWindow : NativeWindow [tylko do odczytu]
Odwołanie do obiektu NativeWindow, zawierającego ten obiekt Stage. | Stage | ||
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 [przesłanianie] [tylko do odczytu]
Zwraca liczbę elementów potomnych tego obiektu. | Stage | ||
opaqueBackground : Object
Określa, czy przy konkretnym kolorze tła obiekt wyświetlany jest nieprzejrzysty. | DisplayObject | ||
orientation : String [tylko do odczytu]
Bieżąca orientacja stołu montażowego. | Stage | ||
parent : DisplayObjectContainer [tylko do odczytu]
Odnosi się do obiektu DisplayObjectContainer, który zawiera obiekt wyświetlany. | DisplayObject | ||
quality : String
Wartość z klasy StageQuality określająca, która jakość renderowania jest stosowana. | Stage | ||
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 | ||
scale9Grid : Rectangle
Aktualnie stosowana siatka skalowania. | DisplayObject | ||
scaleMode : String
Wartość z klasy StageScaleMode określająca, jakiego trybu skalowania należy użyć. | Stage | ||
scaleX : Number
Wskazuje skalę poziomą (procent) obiektu względem punktu odniesienia. | DisplayObject | ||
scaleY : Number
Wskazuje skalę pionową (procent) obiektu względem punktu odniesienia. | DisplayObject | ||
scaleZ : Number
Wskazuje skalę głębokości (procent) obiektu względem punktu odniesienia. | DisplayObject | ||
scrollRect : Rectangle
Granice obszaru przewijania obiektu wyświetlanego. | DisplayObject | ||
showDefaultContextMenu : Boolean
Określa, czy domyślne elementy menu kontekstowego środowiska wykonawczego Flash mają być wyświetlane, czy ukrywane. | Stage | ||
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 | ||
softKeyboardRect : Rectangle [tylko do odczytu]
Prostokąt określający obszar stołu montażowego, który aktualnie zajmuje klawiatura programowa. | Stage | ||
stage : Stage [tylko do odczytu]
Stół montażowy obiektu wyświetlanego. | DisplayObject | ||
stage3Ds : Vector.<Stage3D> [tylko do odczytu]
Lista obiektów Stage3D dostępnych do wyświetlania zawartości 3D. | Stage | ||
stageFocusRect : Boolean
Określa, czy wokół aktywnych obiektów mają być wyświetlane błyszczące ramki. | Stage | ||
stageHeight : int
Określa bieżącą wysokość stołu montażowego (w pikselach). | Stage | ||
stageVideos : Vector.<StageVideo> [tylko do odczytu]
Lista obiektów StageVideo dostępnych do odtwarzania zewnętrznych plików wideo. | Stage | ||
stageWidth : int
Określa bieżącą szerokość stołu montażowego (w pikselach). | Stage | ||
supportedOrientations : Vector.<String> [tylko do odczytu]
Orientacje obsługiwane przez bieżące urządzenie. | Stage | ||
supportsOrientationChange : Boolean [statyczny] [tylko do odczytu]
Informuje, czy aplikacja obsługuje zmiany orientacji stołu montażowego (oraz obrót urządzenia). | Stage | ||
tabChildren : Boolean [przesłanianie]
Określa, czy obiekty podrzędne tego obiektu mają reagować na klawisz Tab. | Stage | ||
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 [przesłanianie] [tylko do odczytu]
Zwraca obiekt TextSnapshot w ramach tej instancji obiektu DisplayObjectContainer. | Stage | ||
transform : flash.geom:Transform
Obiekt z właściwościami dotyczącymi matrycy obiektu wyświetlanego, transformacji kolorów oraz granic pikseli. | DisplayObject | ||
visible : Boolean
Decyduje, czy obiekt wyświetlany jest widoczny, czy nie. | DisplayObject | ||
vsyncEnabled : Boolean
Przedstawia bieżący stan właściwości vsync podstawowego rozwiązania graficznego. Właściwość vsync można włączać/wyłączać w celu natychmiastowego renderowania, bez oczekiwania na kolejny stan określony właściwością VSYNC. | Stage | ||
width : Number [przesłanianie]
Szerokość obiektu wyświetlanego w pikselach. | Stage | ||
wmodeGPU : Boolean [tylko do odczytu]
Wskazuje, czy tworzenie kompozycji przez procesor GPU jest dostępne i używane. | Stage | ||
x : Number
Oznacza współrzędną x instancji obiektu DisplayObject w lokalnym układzie współrzędnych nadrzędnego obiektu DisplayObjectContainer. | DisplayObject | ||
y : Number
Oznacza współrzędną y instancji obiektu DisplayObject w lokalnym układzie współrzędnych nadrzędnego obiektu DisplayObjectContainer. | DisplayObject | ||
z : Number
Wskazuje współrzędną wzdłuż osi Z instancji DisplayObject względem nadrzędnego kontenera 3D. | DisplayObject |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
[przesłanianie]
Dodaje potomną instancję obiektu DisplayObject do tej instancji obiektu DisplayObjectContainer. | Stage | ||
[przesłanianie]
Dodaje potomne wystąpienie klasy DisplayObject do tego wystąpienia klasy DisplayObjectContainer. | Stage | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [przesłanianie]
Rejestruje obiekt detektora zdarzenia w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | Stage | ||
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 | ||
Ustawia aktywność klawiatury na obiekt interaktywny, określony przez właściwość objectToFocus, przy kierunku fokusu określonym przez parametr kierunku. | Stage | ||
Decyduje o tym, czy określony obiekt ekranowy jest potomkiem instancji obiektu DisplayObjectContainer, czy też sam jest taką instancją. | DisplayObjectContainer | ||
[przesłanianie]
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | Stage | ||
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 | ||
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 | ||
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 | ||
[przesłanianie]
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | Stage | ||
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 | ||
Wywołanie metody invalidate() sygnalizuje środowisku wykonawczemu Flash konieczność przygotowania obiektów wyświetlanych na następną okazję renderowania listy wyświetlania (na przykład, gdy głowica przejdzie do nowej klatki animacji). | Stage | ||
Określa, czy właściwość Stage.focus zwraca wartość null z powodów bezpieczeństwa. | Stage | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
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 | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Usuwa określoną instancję obiektu podrzędnego DisplayObject z listy obiektów podrzędnych instancji DisplayObjectContainer. | DisplayObjectContainer | ||
[przesłanianie]
Usuwa obiekt potomny DisplayObject o podanym indeksie z listy potomków obiektu DisplayObjectContainer. | Stage | ||
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 | ||
Powoduje uniesienie klawiatury wirtualnej. | InteractiveObject | ||
Ustawia stół montażowy w orientacji o określonej proporcji. | Stage | ||
[przesłanianie]
Zmienia położenie istniejącego potomka w kontenerze obiektu ekranowego. | Stage | ||
Ustawia stół montażowy w określonej orientacji. | Stage | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Rekurencyjnie zatrzymuje wykonywanie osi czasu wszystkich obiektów MovieClip, dla których ten obiekt jest obiektem głównym. | DisplayObjectContainer | ||
Zamienia kolejność dwóch określonych obiektów podrzędnych. | DisplayObjectContainer | ||
[przesłanianie]
Zamienia miejscami na liście dwa różne obiekty potomne o podanych indeksach. | Stage | ||
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 | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object | ||
[przesłanianie]
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego przodkach. | Stage |
Zdarzenie | Podsumowanie | Zdefiniowane przez | ||
---|---|---|---|---|
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny. | EventDispatcher | |||
Wywoływane, gdy obiekt wyświetlany jest dodawany do listy wyświetlania. | DisplayObject | |||
Wywoływane, gdy obiekt wyświetlany jest dodawany do listy wyświetlania na scenie — albo bezpośrednio, albo wskutek dodania poddrzewa zawierającego obiekt wyświetlany. | DisplayObject | |||
Wywoływane przy zmianie właściwości browserZoomFactor obiektu Stage. | Stage | |||
Wywoływane, gdy użytkownik wybierz opcje „Wyczyść” (lub „Usuń”) z menu kontekstowego dla tekstu. | InteractiveObject | |||
Wywoływane w momencie naciśnięcia i zwolnienia głównego przycisku urządzenia wskazującego przez użytkownika na tej samej instancji InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy w wyniku gestu użytkownika zostanie uaktywnione menu kontekstowe skojarzone z tym obiektem interaktywnym w aplikacji AIR. | InteractiveObject | |||
Wywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację kopiowania lub wybiera polecenie Kopiuj z menu kontekstowego dla tekstu. | InteractiveObject | |||
Wywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację wycięcia lub wybiera polecenie Wytnij z menu kontekstowego dla tekstu. | InteractiveObject | |||
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | |||
Wywoływane w momencie, gdy użytkownik naciska i zwalnia główny przycisk urządzenia wskazującego dwukrotnie w krótkim odstępie czasu nad tym samym obiektem InteractiveObject, podczas gdy flaga doubleClickEnabled obiektu jest ustawiona na wartość true. | InteractiveObject | |||
[zdarzenie broadcast] Wywoływane, gdy głowica odtwarzania przechodzi do nowej klatki. | DisplayObject | |||
[zdarzenie broadcast] Wywoływane, gdy głowica odtwarzania kończy odtwarzanie bieżącej klatki. | DisplayObject | |||
Wywoływane po uaktywnieniu obiektu wyświetlanego. | InteractiveObject | |||
Dysponowana, gdy obiekt ekranowy przestaje być aktywny. | InteractiveObject | |||
[zdarzenie broadcast] Wywoływane po zadziałaniu konstruktorów obiektów wyświetlanych klatek, ale przed działaniem skryptów klatek. | DisplayObject | |||
Wywoływane, gdy obiekt Stage wchodzi lub wychodzi z trybu pełnego ekranu. | Stage | |||
Zostaje rozesłane, gdy użytkownik utworzy punkt styku wzdłuż krawędzi powierzchni dotykowej z instancją obiektu InteractiveObject (np. dotknięcie wzdłuż krawędzi powierzchni dotykowej pilota Siri Remote do telewizora firmy Apple). Niektóre urządzenia mogą również interpretować taki styk, jako kombinację różnych zdarzeń dotykowych. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie na dwa punkty kontaktu nad tą samą instancją klasy InteractiveObject na urządzeniu dotykowym (np. naciśnie dwoma palcami i zwolni obiekt wyświetlany na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa punkt kontaktu nad wystąpieniem klasy InteractiveObject na urządzeniu dotykowym (na przykład przez przesuwanie palców z lewej strony na prawą nad obiektem ekranowym na telefonie komórkowym lub tablecie z ekranem dotykowym). | InteractiveObject | |||
Wywoływane, gdy użytkownik wykona gest obrotu w punkcie kontaktu z instancją klasy InteractiveObject (np. dotknie obiektu wyświetlanego dwoma palcami i obróci palce na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik wykona gest machnięcia w punkcie kontaktu na instancji obiektu InteractiveObject (np. dotknięcie trzema złączonymi palcami ekranu, a następnie szybkie przesunięcie ich nad obiektem wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik utworzy punkt kontaktu z instancją obiektu InteractiveObject, a następnie stuknie w urządzenie dotykowe (np. przyłoży kilka palców do obiektu wyświetlanego w celu otwarcia menu, a następnie stuknie jednym palcem, aby wybrać element menu na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik wykona gest powiększenia w punkcie kontaktu na instancji obiektu InteractiveObject (np. dotknięcie dwoma palcami ekranu, a następnie szybkie rozsunięcie palców nad obiektem wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
To zdarzenie jest wywoływane w każdej aplikacji klienckiej, która obsługuje lokalne wprowadzanie znaków za pomocą edytora IME. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie klawisz. | InteractiveObject | |||
Dysponowana, gdy użytkownik próbuje uaktywnić inny element za pomocą klawiatury. | InteractiveObject | |||
Wywoływane, gdy użytkownik zwolni klawisz. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie i zwolni środkowy przycisk urządzenia wskazującego nad tą samą instancją klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie środkowy przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik zwolni przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie przycisk urządzenia wskazującego nad instancją klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik próbuje uaktywnić inny element za pomocą urządzenia wskazującego. | InteractiveObject | |||
Wywoływane przez obiekt Stage, gdy wskaźnik opuszcza obszar stołu montażowego. | Stage | |||
Dysponowana, gdy użytkownik ustawi kursor nad instancją obiektu InteractiveObject i poruszy urządzenie wskazujące. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesunie kursor poza instancję obiektu InteractiveObject (za pomocą urządzenia wskazującego). | InteractiveObject | |||
Dysponowana, gdy użytkownik przesunie kursor nad instancję obiektu InteractiveObject (za pomocą urządzenia wskazującego). | InteractiveObject | |||
Wywoływane, gdy użytkownik zwolni przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy kółko myszy zostanie obrócone nad instancją klasy InteractiveObject. | InteractiveObject | |||
Wywoływane przez obiekt InteractiveObject inicjujący przeciąganie, gdy użytkownik zwolni przycisk podczas przeciągania. | InteractiveObject | |||
Wywoływane przez docelowy obiekt InteractiveObject, gdy przeciągany obiekt zostanie na niego upuszczony i upuszczenie zostanie zaakceptowane wywołaniem DragManager.acceptDragDrop(). | InteractiveObject | |||
Wywoływane przez obiekt InteractiveObject, gdy podczas gestu przeciągania wskaźnik wchodzi w granice tego obiektu. | InteractiveObject | |||
Wywoływane przez obiekt InteractiveObject, gdy podczas gestu przeciągania wskaźnik opuści granice tego obiektu. | InteractiveObject | |||
Regularnie wywoływane przez obiekt InteractiveObject, gdy wskaźnik podczas przeciągania pozostaje w granicach tego obiektu. | InteractiveObject | |||
Wywoływane na początku operacji przeciągania przez obiekt InteractiveObject określony jako inicjator przeciągania w wywołaniu DragManager.doDrag(). | InteractiveObject | |||
Wywoływane podczas operacji przeciągania przez obiekt InteractiveObject określony jako inicjator przeciągania w wywołaniu DragManager.doDrag(). | InteractiveObject | |||
Wywoływane przez obiekt Stage w przypadku zmiany orientacji stołu montażowego. | Stage | |||
Wywoływane przez obiekt Stage po rozpoczęciu wykonywania zmian związanych z orientacją stołu montażowego. | Stage | |||
Wywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację wklejenia lub wybiera polecenie Wklej z menu kontekstowego dla tekstu. | InteractiveObject | |||
Wywoływane, gdy użytkownik opuści aktywny pisak na odległość mniejszą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik uniesie aktywny pisak na odległość większą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa aktywny pisak nad ekranem, przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa aktywny pisak poza dany obiekt InteractiveObject, przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa aktywny pisak bezpośrednio nad danym obiektem InteractiveObject, przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa aktywny pisak poza obiekt InteractiveObject i jego obiekty potomne, przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa aktywny pisak z obszaru poza drzewem obiektów potomnych danego obiektu InteractiveObject na liście wyświetlania nad ten obiekt (przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna wartość wykrywania dla ekranu). | InteractiveObject | |||
Wywoływane, gdy użytkownik zwalnia przycisk urządzenia wskazującego, jeśli wcześniej nacisnął ten przycisk na wystąpieniu klasy InteractiveObject i przesunął wskaźnik urządzenia poza to wystąpienie klasy InteractiveObject. | InteractiveObject | |||
Dysponowana, gdy obiekt ekranowy ma być usunięty z listy wyświetlania. | DisplayObject | |||
Dysponowana, gdy obiekt ekranowy ma być usunięty z listy wyświetlania na scenie — albo bezpośrednio, albo wskutek usunięcia poddrzewa zawierającego obiekt ekranowy. | DisplayObject | |||
[zdarzenie broadcast] Wywoływane, gdy lista wyświetlania ma być aktualizowana lub renderowana. | DisplayObject | |||
Wywoływane, gdy właściwość scaleMode obiektu Stage ustawiono jako StageScaleMode.NO_SCALE oraz zmieniono rozmiar pliku SWF. | Stage | |||
Wywoływane, gdy użytkownik naciśnie i zwolni prawy przycisk urządzenia wskazującego nad tą samą instancją klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik zwolni przycisk urządzenia wskazującego nad instancją klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesunie kursor poza wystąpienie klasy InteractiveObject (za pomocą urządzenia wskazującego). | InteractiveObject | |||
Wywoływane, gdy użytkownik przesunie kursor nad wystąpienie klasy InteractiveObject (za pomocą urządzenia wskazującego). | InteractiveObject | |||
Wywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację zaznaczenia wszystkiego lub wybiera polecenie „Zaznacz wszystko” z menu kontekstowego dla tekstu. | InteractiveObject | |||
Wywoływane bezpośrednio po uniesieniu klawiatury programowej. | InteractiveObject | |||
Wywoływane bezpośrednio przed uniesieniem klawiatury programowej. | InteractiveObject | |||
Wywoływane bezpośrednio po opuszczeniu klawiatury programowej. | InteractiveObject | |||
Wywoływane przez obiekt Stage, gdy zmienia się stan właściwości stageVideos. | Stage | |||
Wywoływane, gdy zmienia się wartość flagi tabChildren obiektu. | InteractiveObject | |||
Wywoływane, gdy zmienia się flaga tabEnabled obiektu. | InteractiveObject | |||
Wywoływane, gdy zmienia się wartość właściwości tabIndex obiektu. | InteractiveObject | |||
Wywoływane, gdy użytkownik wprowadzi jeden lub większą liczbę znaków tekstu. | InteractiveObject | |||
Wywoływane, gdy użytkownik zainicjuje kontakt z urządzeniem dotykowym (np. dotknie palcem ekranu dotykowego telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik przerwie kontakt z urządzeniem dotykowym (np. uniesie palec z ekranu dotykowego telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik dotyka urządzenia. Wywołanie jest powtarzane w sposób ciągły do momentu usunięcia punktu kontaktu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przemieści punkt kontaktu od instancji klasy InteractiveObject na urządzeniu dotykowym (np. przeciągnie palcem z jednego obiektu wyświetlanego do punktu na drugim obiekcie wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik przemieści punkt kontaktu nad instancję klasy InteractiveObject na urządzeniu dotykowym (np. przeciągnie palcem z punktu poza obiektem wyświetlanym do punktu na obiekcie wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa punkt kontaktu poza wystąpienie klasy InteractiveObject na urządzeniu dotykowym (na przykład przez przeciągnięcie palcem znad obiektu ekranowego do punktu poza obiektem ekranowym na telefonie komórkowym lub tablecie z ekranem dotykowym). | InteractiveObject | |||
Wywoływane, gdy użytkownik przemieści punkt kontaktu nad instancję klasy InteractiveObject na urządzeniu dotykowym (np. przeciągnie palcem z punktu poza obiektem wyświetlanym do punktu na obiekcie wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik zwolni nacisk na ekran dotykowy w punkcie kontaktu na tej samej instancji klasy InteractiveObject, na której kontakt został zainicjowany (na przykład naciśnie palcem i zwolni pojedynczy punkt na obiekcie wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Rozsyłane przez obiekt Stage, gdy zmienia się właściwość vsync. | Stage |
align | właściwość |
align:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wartość z klasy StageAlign, określająca wyrównanie stołu montażowego w programie Flash Player lub w przeglądarce. Poniżej podano prawidłowe wartości:
Wartość | Wyrównanie pionowe | Poziomy |
---|---|---|
StageAlign.TOP | W górę | Do środka |
StageAlign.BOTTOM | W dół | Do środka |
StageAlign.LEFT | Wyśrodkuj | W lewo |
StageAlign.RIGHT | Do środka | W prawo |
StageAlign.TOP_LEFT | Góra | W lewo |
StageAlign.TOP_RIGHT | W górę | W prawo |
StageAlign.BOTTOM_LEFT | Dół | W lewo |
StageAlign.BOTTOM_RIGHT | W dół | W prawo |
Właściwość align
jest dostępna jedynie dla obiektu znajdującego się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain()
lub Security.allowInsecureDomain()
. Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
Implementacja
public function get align():String
public function set align(value:String):void
Powiązane elementy interfejsu API
allowsFullScreen | właściwość |
allowsFullScreenInteractive | właściwość |
allowsFullScreenInteractive:Boolean
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 11.3, AIR 1.0 |
Określa, czy ten stół montażowy umożliwia wyświetlanie na pełnym ekranie z trybem wprowadzania tekstu.
Implementacja
public function get allowsFullScreenInteractive():Boolean
autoOrients | właściwość |
autoOrients:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2 |
Określa, czy orientacja stołu montażowego automatycznie zmienia się, gdy zmienia się orientacja urządzenia.
Początkowa wartość tej właściwości jest określana na podstawie elementu autoOrients
deskryptora aplikacji i jest domyślnie ustawiana na false
. Zachowanie nie jest gwarantowane w przypadku zmiany wartości właściwości na false
. Na niektórych urządzeniach stół montażowy pozostaje w bieżącej orientacji. Na innych orientacja stołu montażowego zmienia się na zdefiniowaną przez urządzenie orientację standardową, po czym nie następują inne zmiany orientacji.
Obsługa profilów AIR: Ta funkcja jest obsługiwana na urządzeniach przenośnych, ale nie jest obsługiwana w komputerowych systemach operacyjnych ani w środowisku AIR dla urządzeń telewizyjnych. W czasie wykonywania można sprawdzić, czy funkcja jest obsługiwana, odczytując właściwość Stage.supportsOrientantionChange
. Więcej informacji o obsłudze elementów interfejsu API w różnych profilach można znaleźć w sekcji Obsługa profilów aplikacji AIR.
Implementacja
public function get autoOrients():Boolean
public function set autoOrients(value:Boolean):void
Powiązane elementy interfejsu API
browserZoomFactor | właściwość |
browserZoomFactor:Number
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 15 |
Określa współczynnik powiększenia przeglądarki. Zmiana współczynnika wpływa na skalowanie stołu montażowego.
Implementacja
public function get browserZoomFactor():Number
color | właściwość |
colorCorrection | właściwość |
colorCorrection:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Steruje korekcją kolorów na ekranie realizowaną przez środowisko wykonawcze Flash. Korekcja kolorów działa tylko wtedy, gdy do monitora głównego przypisany jest poprawny profil kolorów ICC, który określa konkretne atrybuty kolorów urządzenia. Domyślnie środowisko wykonawcze Flash próbuje stosować korekcję kolorów hosta (zazwyczaj przeglądarki).
Właściwość Stage.colorCorrectionSupport
służy do określania, czy korekcja kolorów jest dostępna w bieżącym systemie i dla domyślnego stanu. Jeśli korekcja kolorów jest dostępna, aplikacja zakłada, że wszystkie kolory na stole montażowym należą do przestrzeni kolorów sRGB, która jest najbardziej standardową przestrzenią kolorów. Profile źródłowe urządzeń wejściowych nie są uwzględniane podczas korygowania kolorów. Nie jest stosowana korekcja kolorów na wejściu; na profil kolorów ICC monitora głównego odwzorowywane są tylko wyniki działań na stole montażowym.
Zwykle aktywacja funkcji zarządzania kolorami umożliwia przewidywalne stosowanie spójnych kolorów, zapewnia lepszą konwersję i wierniejsze wydruki, a także umożliwia bardziej efektywne odwzorowanie tych samych obrazów na różnych nośnikach. Należy jednak pamiętać o tym, że zarządzanie kolorami nie zapewnia idealnej konwersji, ponieważ urządzenia mogą udostępniać różne gamy barw — również gamy inne niż gamy obrazów oryginalnych. Zarządzanie kolorami nie eliminuje potrzeby stosowania niestandardowych lub modyfikowanych profili. Profile kolorów są uzależnione od przeglądarek, systemów operacyjnych, rozszerzeń systemów operacyjnych, urządzeń wyjściowych, a także obsługiwanych aplikacji.
Stosowanie korekcji kolorów pogarsza wydajność środowiska wykonawczego Flash. Korekcja kolorów w środowisku wykonawczym Flash stanowi korekcję kolorów stylu dokumentu, ponieważ wszystkie filmy SWF są traktowane jako dokumenty z niejawnymi profilami sRGB. Ustawienie właściwości Stage.colorCorrectionSupport
nakazuje środowisku wykonawczemu Flash korygowanie kolorów przy wyświetlaniu pliku (dokumentu) SWF w przestrzeni kolorów ekranu. Środowisko wykonawcze Flash kompensuje wyłącznie różnice między monitorami, a nie różnice między urządzeniami wejściowymi (aparat/skaner/itp.).
Trzema możliwymi wartościami są ciągi znaków z odpowiednimi stałymi w klasie flash.display.ColorCorrection:
"default"
: Użyj tej samej korekcji kolorów, co system hosta."on"
: Zawsze wykonuj korekcję kolorów."off"
: Nigdy nie wykonuj korekcji kolorów.
Implementacja
public function get colorCorrection():String
public function set colorCorrection(value:String):void
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
Stage.colorCorrection
nie należy do klasy ColorCorrection, funkcja obsługi zgłasza błąd.
function addHandler(add_event:Event) { switch(stage.colorCorrection) { case ColorCorrection.ON: stage.colorCorrection = ColorCorrection.OFF; lblCMEnableState.text = "State: " + stage.colorCorrection; break; case ColorCorrection.OFF: stage.colorCorrection = ColorCorrection.DEFAULT; lblCMEnableState.text = "State: " + stage.colorCorrection; break; case ColorCorrection.DEFAULT: stage.colorCorrection = ColorCorrection.ON; lblCMEnableState.text = "State: " + stage.colorCorrection; break; default: lblCMEnableState.text = "Error."; break; }
colorCorrectionSupport | właściwość |
colorCorrectionSupport:String
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Określa, czy środowisko wykonawcze Flash uruchomione jest w systemie operacyjnym obsługującym korekcję kolorów i czy profil koloru dla głównego (podstawowego) monitora może zostać odczytany i rozpoznany przez środowisko Flash. Właściwość ta zwraca również domyślny stan korekcji kolorów dla systemu hosta (zazwyczaj przeglądarki). Obecnie zwracanymi wartościami mogą być:
Trzema możliwymi wartościami są ciągi znaków z odpowiednimi stałymi w klasie flash.display.ColorCorrectionSupport:
"unsupported"
: Korekcja kolorów jest niedostępna."defaultOn"
: Zawsze wykonuj korekcję kolorów."defaultOff"
: Nigdy nie wykonuj korekcji kolorów.
Implementacja
public function get colorCorrectionSupport():String
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
stage.colorCorrectionSupport
; wartości DEFAULT_ON
i DEFAULT_OFF
, które świadczą o możliwości obsługi korekcji kolorów, należą do klasy ColorCorrectionSupport. Jeśli właściwość ma jedną z tych właściwości, jest ona wyświetlana w polu tekstowym. Jeśli właściwość nie jest równa DEFAULT_ON
ani DEFAULT_OFF
, w polu tekstowym wyświetlany jest wyraz "unsupported".
function addHandler(add_event:Event) { if (stage.colorCorrectionSupport == ColorCorrectionSupport.DEFAULT_ON || stage.colorCorrectionSupport == ColorCorrectionSupport.DEFAULT_OFF) { lblHasCM.text = "stage.colorCorrectionSupport: " + stage.colorCorrectionSupport; } else { lblHasCM.text = "stage.colorCorrectionSupport: unsupported"; } }
constructor | właściwość |
contentsScaleFactor | właściwość |
contentsScaleFactor:Number
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 11.5 |
Określa efektywny współczynnik skalowania pikseli stołu montażowego. Wartość ta wynosi zazwyczaj 1 dla ekranów standardowych i ekranów o wysokiej rozdzielczości (Retina). W przypadku renderowania stołu na ekranach o wysokiej rozdzielczości rozdzielczość w pikselach jest podwajana, nawet jeśli dla trybu skalowania wybrano ustawienie StageScaleMode.NO_SCALE. Wartości Stage.stageWidth i Stage.stageHeight są nadal określane w klasycznych pikselach.
Implementacja
public function get contentsScaleFactor():Number
deviceOrientation | właściwość |
deviceOrientation:String
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2 |
Fizyczna orientacja urządzenia.
Na urządzeniach z wysuwanymi klawiaturami w kontekście określania orientacji urządzenia stan klawiatury ma wyższy priorytet niż obroty wykryte przez przyspieszeniomierz. Oznacza to, że na urządzeniu z pionowym układem ekranu i klawiaturą zamontowaną z boku właściwość deviceOrientation
będzie mieć wartość ROTATED_LEFT
(obrót w lewo), gdy klawiatura nie będzie otwarta — niezależnie od tego, jak użytkownik będzie trzymać urządzenie.
Podczas ustawiania lub porównywania wartości tej właściwości należy używać wartości stałych zdefiniowanych w klasie StageOrientation.
Obsługa profilów AIR: Ta funkcja jest obsługiwana na urządzeniach przenośnych, ale nie jest obsługiwana w systemach operacyjnych dla komputerów stacjonarnych ani w środowisku AIR dla urządzeń telewizyjnych. W czasie wykonywania można sprawdzić, czy funkcja jest obsługiwana, odczytując właściwość Stage.supportsOrientationChange
. Więcej informacji o obsłudze elementów interfejsu API w różnych profilach można znaleźć w sekcji Obsługa profilów aplikacji AIR.
Implementacja
public function get deviceOrientation():String
Powiązane elementy interfejsu API
displayState | właściwość |
displayState:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4 |
Wartość z klasy StageDisplayState określająca, jakiego stanu wyświetlania należy użyć. Poniżej podano prawidłowe wartości:
- Właściwość
StageDisplayState.FULL_SCREEN
konfiguruje aplikację AIR lub zawartość w programie Flash Player do rozszerzania stołu montażowego na cały ekran użytkownika. Dane wejściowe klawiatury są wyłączane (z wyjątkiem ograniczonego zestawu klawiszy, które nie są drukowane). - Właściwość
StageDisplayState.FULL_SCREEN_INTERACTIVE
powoduje rozszerzenie stołu montażowego aplikacji na cały ekran użytkownika, gdy wprowadzanie danych z klawiatury jest dozwolone. (Dostępna w środowisku AIR i programie Flash Player od wersji 11.3 programu Flash Player). - Właściwość
StageDisplayState.NORMAL
powoduje powrót stołu montażowego do standardowego trybu wyświetlania.
Skalowanie filmu odtwarzanego w trybie pełnego ekranu jest określone przez ustawienie scaleMode
(ustawione za pomocą właściwości Stage.scaleMode
lub za pomocą znaczników embed
pliku SWF w pliku HTML). Jeśli dla właściwości scaleMode
będzie ustawiona wartość noScale
, a aplikacja przejdzie do trybu pełnoekranowego, właściwości width
i height
obiektu Stage zostaną zaktualizowane, a obiekt Stage wywoła zdarzenie resize
. Jeśli będzie ustawiony jakikolwiek inny tryb skalowania, zostanie przeprowadzone skalowanie stołu montażowego wraz z zawartością w celu wypełnienia nowych wymiarów ekranu. Obiekt Stage zachowa pierwotne wartości width
i height
. Nie wywoła zdarzenia resize
.
Dla plików SWF odtwarzanych na stronie HTML (nie plików korzystających z autonomicznego programu Flash Player lub środowiska wykonawczego AIR) obowiązują następujące ograniczenia:
- Aby aktywować tryb pełnoekranowy, dodaj parametr
allowFullScreen
do znacznikówobject
iembed
na stronie HTML, która zawiera plik SWF, ustawiającallowFullScreen
na„true”
, co przedstawiono w poniższym przykładzie:<param name="allowFullScreen" value="true" /> ... <embed src="example.swf" allowFullScreen="true" ... >
Strona HTML może również korzystać ze skryptu w celu wygenerowania znaczników osadzających SWF. W takim przypadku należy zmodyfikować skrypt w taki sposób, aby wstawiał poprawne ustawienia
allowFullScreen
. Strony HTML generowane przez programy Flash Professional i Flash Builder korzystają z funkcjiAC_FL_RunContent()
w celu osadzania odwołań do plików SWF — w takim przypadku potrzeba dodawania ustawień parametruallowFullScreen
, jak w poniższym przykładzie:AC_FL_RunContent( ... "allowFullScreen", "true", ... )
- Tryb pełnoekranowy jest inicjowany w odpowiedzi na kliknięcie myszą lub naciśnięcie klawisza przez użytkownika; wartość
Stage.displayState
filmu nie może ulec zmianie bez udziału użytkownika. Środowiska wykonawcze Flash ograniczają wprowadzanie danych z klawiatury w trybie pełnoekranowym. Do dopuszczalnych klawiszy należą skróty klawiszowe, które powodują wyjście z trybu pełnoekranowego, oraz klawisze bez reprezentacji drukowanej, np. strzałki, spacja, klawisze Shift i Tab. (Aby umożliwić używanie dodatkowych klawiszy do wprowadzania danych, należy użyć pełnoekranowego trybu interaktywnego). Skróty klawiszowe, które powodują wyjście z trybu pełnoekranowego to: Escape (systemy Windows, Linux i Mac), Control+W (Windows), Command+W (Mac) oraz Alt+F4. - Od wersji Flash Player 9.0.115.0 tryb pełnoekranowy działa w trybie bez okien w taki sam sposób, jak w trybie z oknami. Jeśli dla trybu okna (
wmode
w HTML) zostanie ustawiona wartość Nieprzezroczysta ściana bez okien (opaque
) lub Przezroczysta ściana bez okien (transparent
), możliwe jest zainicjowanie trybu pełnoekranowego, ale okno tego trybu będzie zawsze nieprzezroczyste. - Aby włączyć interaktywny tryb pełnoekranowy, który obsługuje interakcje korzystające z klawiatury, dodaj parametr
allowFullScreenInteractive
do znacznikówobject
iembed
na stronie HTML, która zawiera plik SWF, ustawiając parametrallowFullScreenInteractive
natrue
zgodnie z poniższym przykładem.<param name="allowFullScreenInteractive" value="true" /> ...
Te ograniczenia nie obowiązują dla zawartości SWF działającej w autonomicznym programie Flash Player lub w aplikacji AIR.
Podczas włączania trybu pełnoekranowego środowisko wykonawcze Flash wyświetla przez krótki czas nałożone na zawartość SWF powiadomienie dla użytkownika, że jest włączony tryb pełnoekranowy i można nacisnąć klawisz Escape, aby go wyłączyć.
Podczas włączania interaktywnego trybu pełnoekranowego program Flash Player wyświetla nałożony na zawartość SWF monit umożliwiający użytkownikowi uzyskanie dostępu do rozszerzonych danych wejściowych klawiatury (w tym klawiszy drukowania), który informuje też użytkowników, że mogą wyłączyć ten tryb przez naciśnięcie klawisza Escape. Nie należy przyjmować założeń dotyczących wyglądu ani położenia tego monitu o potwierdzenie. Wykrywając zdarzenie FullScreenEvent.FULL_SCREEN_INTERACTIVE_ACCEPTED
, można określić, czy użytkownik zezwolił na dostęp do rozszerzonych danych wejściowych klawiatury.
W przypadku zawartości AIR wyświetlanej w trybie pełnego ekranu systemowy wygaszacz ekranu oraz opcje oszczędzania energii są wyłączone w trakcie odtwarzania zawartości wideo do czasu zatrzymania wideo lub wyjścia z trybu pełnego ekranu.
W systemie Linux ustawienie właściwości displayState
na wartość StageDisplayState.FULL_SCREEN
lub StageDisplayState.FULL_SCREEN_INTERACTIVE
jest operacją asynchroniczną.
Implementacja
public function get displayState():String
public function set displayState(value:String):void
Zgłasza
SecurityError — Wywołanie właściwości displayState obiektu Stage spowoduje zgłoszenie wyjątku dla każdego obiektu wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć, właściciel obiektu Stage może nadać uprawnienia do domeny elementu wywołującego przez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów. Próba ustawienia właściwości displayState w momencie wyświetlania dialogu ustawień, bez odpowiedzi ze strony użytkownika, lub gdy atrybut allowFullScreen znacznika HTML param lub embed nie jest ustawiony na wartość true , powoduje zgłoszenie błędu bezpieczeństwa.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
displayState
Uwaga: Tryb pełnego ekranu może być wyzwalany w określonych sytuacjach, jak na przykład w momencie kliknięcia lub przytrzymania klawisza (ze względów bezpieczeństwa). W momencie uruchamiania w przeglądarce właściwość allowFullScreen musi być ustawiona na wartość true.
package { import flash.display.Sprite; import flash.display.Stage; import flash.events.*; import flash.net.NetConnection; import flash.net.NetStream; import flash.media.Video; public class FullScreenExample extends Sprite { private var videoURL:String = "testVideo.flv"; private var connection:NetConnection; private var stream:NetStream; private var video:Video; public function FullScreenExample() { connection = new NetConnection(); connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); connection.connect(null); loaderInfo.addEventListener(Event.INIT, createMouseListener); } private function createMouseListener(event:Event):void { stage.addEventListener(MouseEvent.CLICK,toggleFullScreen); } private function toggleFullScreen(event:MouseEvent):void { switch(stage.displayState) { case "normal": stage.displayState = "fullScreen"; break; case "fullScreen": default: stage.displayState = "normal"; break; } } // Video related: private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace("Unable to locate video: " + videoURL); break; } } private function connectStream():void { var stream:NetStream = new NetStream(connection); stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); video = new Video(stage.stageWidth,stage.stageHeight); video.attachNetStream(stream); stream.play(videoURL); addChild(video); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function asyncErrorHandler(event:AsyncErrorEvent):void { // ignore AsyncErrorEvent events. } } }
focus | właściwość |
focus:InteractiveObject
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Obiekt interaktywny z aktywnością klawiatury; lub wartość null
, jeżeli aktywność nie została ustawiona lub obiekt aktywny należy do obszaru izolowanego, do którego obiekt wywołujący nie ma dostępu.
Implementacja
public function get focus():InteractiveObject
public function set focus(value:InteractiveObject):void
Zgłasza
Error — Zgłasza błąd, jeżeli nie jest możliwe przekazanie aktywności do obiektu docelowego.
|
Przykład ( Sposób korzystania z tego przykładu )
myTF
, dzięki czemu użytkownik może rozpocząć pisanie, bez konieczności klikania elementu interfejsu. Na urządzeniach z systemem iOS i Android oraz na urządzeniach tvOS użytkownik musi kliknąć pole tekstowe, aby aktywować klawiaturę programową. Testując ten kod w interfejsie narzędzia do tworzenia treści, można korzystać tylko z kilku klawiszy, ponieważ aplikacja, w której działa treść (przeglądarka lub narzędzie), jako pierwsza interpretuje większość naciśnięć klawiszy. Aby sprawdzić, czy ten przykład działa zgodnie z zamierzeniami, należy go skompilować i uruchomić uzyskany plik SWF.
var myTF:TextField = new TextField(); myTF.border =true; myTF.type = TextFieldType.INPUT; addChild(myTF); stage.focus= myTF;
frameRate | właściwość |
frameRate:Number
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Pobiera i ustawia szybkość klatek na stole montażowym. Liczba klatek na sekundę jest zdefiniowana jako klatki na sekundę. Domyślnie szybkość ta jest ustawiana według szybkości klatek na sekundę pierwszego załadowanego pliku SWF. Prawidłowy zakres liczby klatek na sekundę wynosi od 0,01 do 1000 klatek na sekundę.
Uwaga: Aplikacja nie zawsze jest w stanie dostosować się do żądanej wysokiej liczby klatek na sekundę. Może to wynikać z niedostatecznej wydajności platformy docelowej lub zsynchronizowana odtwarzacza z sygnałem synchronizacji pionowej monitora (zwykle o częstotliwości 60 Hz w przypadku monitorów LCD). W niektórych przypadkach platforma docelowa może również obniżyć maksymalną liczba klatek na sekundę przy perspektywie wysokiego użycia procesora.
Dla zawartości uruchomionej w aplikacji Adobe AIR ustawienie właściwości frameRate
jednego z obiektów Stage powoduje zmianę tej właściwości dla wszystkich obiektów Stage (używanych przez różne obiekty NativeWindow).
Implementacja
public function get frameRate():Number
public function set frameRate(value:Number):void
Zgłasza
SecurityError — Wywołanie właściwości frameRate obiektu Stage spowoduje zgłoszenie wyjątku dla każdego obiektu wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
fullScreenHeight | właściwość |
fullScreenHeight:uint
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Zwraca wysokość monitora, która zostanie wykorzystana jako rozmiar w trybie pełnego ekranu, jeżeli ten stan zostanie wprowadzony natychmiastowo. Jeżeli użytkownik posiada wiele monitorów, wówczas wykorzystany będzie monitor na którym znajduje się największy fragment stołu montażowego w danym momencie.
Uwaga: Jeżeli użytkownik ma możliwość przeniesienia przeglądarki z jednego monitora na drugi pomiędzy pobraniem wartości a przejściem w tryb pełnego ekranu, wówczas ta wartość może być nieprawidłowa. Jeżeli zostanie pobrana wartość poprzez moduł obsługi zdarzeń, który ustawi właściwość Stage.displayState
na wartość StageDisplayState.FULL_SCREEN
, wówczas będzie ona poprawna.
Jest to wysokość monitora w pikselach i jest ona taka sama, jaka byłaby szerokość stołu montażowego po ustawieniu właściwości Stage.align
na wartość StageAlign.TOP_LEFT
oraz właściwości Stage.scaleMode
na wartość StageScaleMode.NO_SCALE
.
Implementacja
public function get fullScreenHeight():uint
Powiązane elementy interfejsu API
fullScreenSourceRect
fullScreenWidth
scaleMode
StageDisplayState
flash.events.Event.RESIZE
flash.events.FullScreenEvent
Przykład ( Sposób korzystania z tego przykładu )
enterFullScreen()
, który ustawia właściwość fullScreenSourceRect
i powoduje przejście w tryb pełnego ekranu. Ustawianie właściwości fullScreenSourceRect
moduł obsługi zdarzeń rozpoczyna od określenia położenia i wymiarów czerwonego kwadratu. Następnie porównuje proporcje (szerokość podzieloną przez wysokość) czerwonego kwadratu do proporcji szerokości i wysokości stołu montażowego w trybie pełnego ekranu, aby możliwe było rozciągnięcie prostokąta (właściwość fullScreenSourceRect
) w celu dopasowania do proporcji ekranu. Wynikiem jest zajęcie całej wysokości monitora przez czerwony kwadrat, z zielonym tłem widocznym po obu stronach. Jeżeli proporcje nie zostały dopasowane, wówczas tło, które domyślnie ma barwę białą, będzie widoczne po obu stronach, zamiast zielonego tła.
Uwaga: Należy przetestować metodykę poniższego przykładu w przeglądarce. W oknie dialogowym Flash Publish Settings w zakładce HTML należy wybrać szablon Flash Only - Allow Full Screen. Określ Flash Player w wersji 9.0.115.0, i upewnij się, że formaty Flash i HTML zostały wybrane na zakładce Formaty. Następnie opublikuj i otwórz wynikowy plik HTML w przeglądarce.
import flash.display.Sprite; import flash.display.Stage; import flash.display.StageDisplayState; import flash.events.MouseEvent; import flash.geom.Rectangle; // cover the stage with a green rectangle var greenRect:Sprite = new Sprite(); greenRect.graphics.beginFill(0x00FF00); greenRect.graphics.drawRect(0, 0, stage.stageWidth, stage.stageHeight); addChild(greenRect); // create red square on stage, turn it into a button for going to full screen var redSquare:Sprite = new Sprite(); redSquare.graphics.beginFill(0xFF0000); redSquare.graphics.drawRect(0, 0, 300, 300); redSquare.x = 50; redSquare.y = 50; redSquare.addEventListener(MouseEvent.CLICK, enterFullScreen); redSquare.buttonMode = true; addChild(redSquare); function enterFullScreen(e:MouseEvent):void { // we will go to full screen zoomed in on the red square var redSquare:Sprite = e.target as Sprite; var fullScreenRect:Rectangle = new Rectangle(redSquare.x, redSquare.y, redSquare.width, redSquare.height); // calculate aspect ratio of the red square var rectAspectRatio:Number = fullScreenRect.width / fullScreenRect.height; // calculate aspect ratio of the screen var screenAspectRatio:Number = stage.fullScreenWidth / stage.fullScreenHeight; // change the fullScreenRect so that it covers the entire screen, keeping it centered on the redSquare // try commenting out this section to see what happens if you do not fix the aspect ratio. if (rectAspectRatio > screenAspectRatio) { var newHeight:Number = fullScreenRect.width / screenAspectRatio; fullScreenRect.y -= ((newHeight - fullScreenRect.height) / 2); fullScreenRect.height = newHeight; } else if (rectAspectRatio < screenAspectRatio) { var newWidth:Number = fullScreenRect.height * screenAspectRatio; fullScreenRect.x -= ((newWidth - fullScreenRect.width) / 2); fullScreenRect.width = newWidth; } // go to full screen stage.fullScreenSourceRect = fullScreenRect; stage.displayState = StageDisplayState.FULL_SCREEN; }
fullScreenSourceRect | właściwość |
fullScreenSourceRect:Rectangle
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Powoduje, że środowisko wykonawcze Flash skaluje określony region stołu montażowego do trybu pełnoekranowego. Jeśli jest to możliwe, środowisko wykonawcze Flash przeprowadza skalowanie sprzętowe, wykorzystując kartę graficzną i wideo na komputerze użytkownika, z reguły wyświetlając zawartość szybciej niż w przypadku skalowania przez oprogramowanie.
Gdy ta właściwość jest ustawiona na prawidłowy prostokąt, a właściwość displayState
jest ustawiona na tryb pełnego ekranu, środowisko wykonawcze Flash przeprowadza skalowanie określonego obszaru. Właściwy rozmiar obiektu Stage w pikselach wewnątrz skryptu ActionScript nie ulega zmianie. Środowisko wykonawcze Flash wymusza minimalny limit rozmiaru prostokąta, aby dostosować standardowy komunikat o konieczności naciśnięcia klawisza Esc w celu wyjścia z trybu pełnoekranowego. Limit ten wynosi z reguły około 260 na 30 pikseli, lecz może się różnić pod względem platformy i wersji środowiska Flash.
Ta właściwość może zostać ustawiona tylko w momencie, gdy środowisko Flash nie pracuje w trybie pełnoekranowym. W celu poprawnego stosowania tej właściwości należy najpierw ustawić właściwość displayState
na tryb pełnego ekranu, jak zostało to ukazane na przykładach kodów. Uwaga: W programie Flash Player 15 lub nowszym można ustawić tę właściwość nawet wtedy, gdy środowisko wykonawcze Flash jest w trybie pełnoekranowym.
W celu włączenia skalowania należy ustawić właściwość fullScreenSourceRect
na obiekt prostokątny:
// valid, will enable hardware scaling stage.fullScreenSourceRect = new Rectangle(0,0,320,240);
W celu wyłączenia skalowania należy ustawić właściwość fullScreenSourceRect=null
w skrypcie ActionScript 3.0 oraz undefined
w skrypcie ActionScript 2.0.
stage.fullScreenSourceRect = null;
Użytkownik końcowy może również wybrać wewnątrz ustawień Flash Player Display Settings wyłączenie skalowania sprzętowego, które jest włączone domyślnie. Aby znaleźć więcej informacji na ten temat, zobacz na strony www.adobe.com/go/display_settings_pl.
Implementacja
public function get fullScreenSourceRect():Rectangle
public function set fullScreenSourceRect(value:Rectangle):void
Powiązane elementy interfejsu API
Stage.displayState
Stage.scaleMode
flash.events.FullScreenEvent
flash.events.Event.RESIZE
Przykład ( Sposób korzystania z tego przykładu )
import flash.geom.*; { stage.fullScreenSourceRect = new Rectangle(0,0,320,240); stage.displayState = StageDisplayState.FULL_SCREEN; }
Przed wykorzystaniem trybu pełnego ekranu ze skalowaniem sprzętowym, muszą zostać spełnione następujące warunki:
- Wymagany jest program Flash Player w wersji 9.0.115.0 lub późniejszej, a także narzędzie tworzenia, które obsługuję tę wersję.
- Szablony HTML muszą zostać zmienione w celu obsługi trybu pełnego ekranu. Atrybut
allowFullScreen
musi zostać ustawiony na wartośćtrue
dla znacznikówobject
iembed
. (Skrypty generujące znaczniki osadzające pliki SWF muszą również zezwalać na działanie trybu pełnego ekranu). Przykładowe pliki, które mogą być wykorzystane przez moduł Flash Builder, można znaleźć w artykule Exploring full-screen mode in Flash Player 9. - Aplikacja użytkownika musi mieć uprawnienia oraz dostęp do pliku wideo FLV. W tym przykładzie zostało przyjęte, iż plik Flash Video (FLV) znajduje się w tym samym katalogu co plik SWF.
- Użytkownik musi zezwolić na dostęp do trybu pełnego ekranu.
- Dodatkowe informacje na temat skalowania sprzętowego zawiera artykuł Exploring Flash Player support for high-definition H.264 video and AAC audio dotyczący programu Flash Player.
Plik FLW jest ładowany przy użyciu obiektów NetConnection i NetStream. Ponieważ plik FLV znajduje się w tym samym katalogu co plik SWF i zostanie nawiązane połączenie przez HTTP, więc parametr metody NetConnection.connect()
jest ustawiony na wartość null
. Obiekt connect
NetConnection raportuje swój status poprzez wywołanie zdarzenia netStatus
, które wywołuje metodę netStatusHandler()
. Metoda netStatusHandler()
sprawdza czy powiodło się nawiązanie połączenia i wywołuje metodę connectStream()
, która tworzy obiekt NetStream pobierający obiekt NetConnection jako parametr. Tworzy również obiekt wideo oraz dołącza obiekt NetStream do obiektu wideo. Wówczas obiekt wideo jest dołączany do listy wyświetlania i strumień jest gotowy do odgrywania. Ponieważ plik wideo FLV nie zawiera metadanych ani informacji o punktach wskazujących, wywołane zostanie zdarzenie AsyncError
. Detektor musi zostać skonfigurowany, aby obsłużyć zdarzenie. W tym przypadku detektor jest skonfigurowany i ignoruje zdarzenie. Inny detektor dla zdarzenia netStatus
jest również skonfigurowany dla obiektu NetStream. W przypadku nie odnalezienia strumienia zostanie wyświetlony komunikat o błędzie. (Należy zauważyć, iż metoda netStatusHandler()
może zostać wykorzystana do obsługi dowolnej liczby różnych informacji o statusie, raportowanych dla strumienia lub połączenia).
W momencie, gdy dostępne są właściwości i metody załadowanego pliku SWF, wówczas wywoływana jest metoda createMouseListener()
. Powoduje to skonfigurowanie detektora zdarzeń dla momentu kliknięcia myszą na stole montażowym. Metoda toggleFullScreen()
sprawdza czy stan wyświetlania jest w trybie pełnego ekranu czy normalnym. Jeżeli pracuje w trybie normalnym, wówczas rozmiar obiektu wideo jest ustawiony na rozmiar strumienia wideo. Właściwość fullScreenSourceRect
jest ustawiona na prostokąt o wymiarach odpowiadających obiektowi wideo. Wówczas właściwość Stage.displayMode
jest ustawiona na tryb pełnego ekranu, co powoduje rozszerzenie wideo w prostokącie źródłowym aż do wypełnienia obszaru pełnego ekranu. Jeżeli zostały spełnione wymagania sprzętowe, wówczas sprzęt graficzny komputera zostanie użyty w celu usprawnienia działania renderowania wideo w trybie pełnego ekranu oraz stan wyświetlania zostanie ustawiony na tryb pełnego ekranu. W celu wychwycenia wszelkich błędów zabezpieczeń, które mogą wystąpić w momencie przełączania na tryb pełnego ekranu stosowana jest metoda try...catch
. (Należy zauważyć, iż stan wyświetlania musi być ustawiony na tryb pełnego ekranu po ustawieniu właściwości fullScreenSourceRect
). Przed przełączeniem na tryb normalny ekranu szerokość i wysokość obiektu wideo zostaną ustawione z powrotem na zachowane oryginalne wartości. W innym przypadku zmiany dokonane na obiekcie wideo w trybie pełnego ekranu określą szerokość i wysokość.
package { import flash.display.Sprite; import flash.display.StageDisplayState; import flash.media.Video; import flash.net.NetConnection; import flash.net.NetStream; import flash.events.NetStatusEvent; import flash.events.AsyncErrorEvent; import flash.events.SecurityErrorEvent; import flash.events.MouseEvent; import flash.events.Event; import flash.geom.Rectangle; public class Stage_fullScreenSourceRectExample2 extends Sprite { private var videoURL:String = "testVideo1.flv"; private var connection:NetConnection; private var stream:NetStream; private var myVideo:Video; private var savedWidth:uint; private var savedHeight:uint; public function Stage_fullScreenSourceRectExample2() { connection = new NetConnection(); connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); connection.connect(null); loaderInfo.addEventListener(Event.INIT, createMouseListener); } private function createMouseListener(event:Event):void { stage.addEventListener(MouseEvent.CLICK, toggleFullScreen); } private function toggleFullScreen(event:MouseEvent):void { if(stage.displayState == StageDisplayState.NORMAL) { myVideo.width = myVideo.videoWidth; myVideo.height = myVideo.videoHeight; try { stage.fullScreenSourceRect = new Rectangle(myVideo.x, myVideo.y, myVideo.width, myVideo.height); stage.displayState = StageDisplayState.FULL_SCREEN; } catch (e:SecurityError) { trace ("A security error occurred while switching to full screen: " + event); myVideo.width = savedWidth; myVideo.height = savedHeight; } }else { myVideo.width = savedWidth; myVideo.height = savedHeight; stage.displayState = StageDisplayState.NORMAL; } } private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace ("Unable to locate video: " + videoURL); break; } } private function connectStream():void { var stream:NetStream = new NetStream(connection); stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); myVideo = new Video(); myVideo.attachNetStream(stream); stream.play(videoURL); savedWidth = myVideo.width; savedHeight = myVideo.height; addChild(myVideo); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function asyncErrorHandler(event:AsyncErrorEvent):void { } } }
fullScreenWidth | właściwość |
fullScreenWidth:uint
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Zwraca szerokość monitora, która zostanie wykorzystana jako rozmiar w trybie pełnego ekranu, jeżeli ten stan zostanie wprowadzony natychmiastowo. Jeżeli użytkownik posiada wiele monitorów, wówczas wykorzystany będzie monitor na którym znajduje się największy fragment stołu montażowego w danym momencie.
Uwaga: Jeżeli użytkownik ma możliwość przeniesienia przeglądarki z jednego monitora na drugi pomiędzy pobraniem wartości a przejściem w tryb pełnego ekranu, wówczas ta wartość może być nieprawidłowa. Jeżeli zostanie pobrana wartość poprzez moduł obsługi zdarzeń, który ustawi właściwość Stage.displayState
na wartość StageDisplayState.FULL_SCREEN
, wówczas będzie ona poprawna.
Jest to szerokość monitora w pikselach i jest ona taka sama, jaka byłaby szerokość stołu montażowego po ustawieniu właściwości Stage.align
na wartość StageAlign.TOP_LEFT
oraz właściwości Stage.scaleMode
na wartość StageScaleMode.NO_SCALE
.
Implementacja
public function get fullScreenWidth():uint
Powiązane elementy interfejsu API
fullScreenHeight
fullScreenSourceRect
scaleMode
StageDisplayState
flash.events.Event.RESIZE
flash.events.FullScreenEvent
Przykład ( Sposób korzystania z tego przykładu )
enterFullScreen()
, który ustawia właściwość fullScreenSourceRect
i powoduje przejście w tryb pełnego ekranu. Ustawianie właściwości fullScreenSourceRect
moduł obsługi zdarzeń rozpoczyna od określenia położenia i wymiarów czerwonego kwadratu. Następnie porównuje proporcje (szerokość podzieloną przez wysokość) czerwonego kwadratu do proporcji szerokości i wysokości stołu montażowego w trybie pełnego ekranu, aby możliwe było rozciągnięcie prostokąta (właściwość fullScreenSourceRect
) w celu dopasowania do proporcji ekranu. Wynikiem jest zajęcie całej wysokości monitora przez czerwony kwadrat, z zielonym tłem widocznym po obu stronach. Jeżeli proporcje nie zostały dopasowane, wówczas tło, które domyślnie ma barwę białą, będzie widoczne po obu stronach, zamiast zielonego tła.
Uwaga: Należy przetestować metodykę poniższego przykładu w przeglądarce. W oknie dialogowym Flash Publish Settings w zakładce HTML należy wybrać szablon Flash Only - Allow Full Screen. Określ Flash Player w wersji 9.0.115.0, i upewnij się, że formaty Flash i HTML zostały wybrane na zakładce Formaty. Następnie opublikuj i otwórz wynikowy plik HTML w przeglądarce.
import flash.display.Sprite; import flash.display.Stage; import flash.display.StageDisplayState; import flash.events.MouseEvent; import flash.geom.Rectangle; // cover the stage with a green rectangle var greenRect:Sprite = new Sprite(); greenRect.graphics.beginFill(0x00FF00); greenRect.graphics.drawRect(0, 0, stage.stageWidth, stage.stageHeight); addChild(greenRect); // create red square on stage, turn it into a button for going to full screen var redSquare:Sprite = new Sprite(); redSquare.graphics.beginFill(0xFF0000); redSquare.graphics.drawRect(0, 0, 300, 300); redSquare.x = 50; redSquare.y = 50; redSquare.addEventListener(MouseEvent.CLICK, enterFullScreen); redSquare.buttonMode = true; addChild(redSquare); function enterFullScreen(e:MouseEvent):void { // we will go to full screen zoomed in on the red square var redSquare:Sprite = e.target as Sprite; var fullScreenRect:Rectangle = new Rectangle(redSquare.x, redSquare.y, redSquare.width, redSquare.height); // calculate aspect ratio of the red square var rectAspectRatio:Number = fullScreenRect.width / fullScreenRect.height; // calculate aspect ratio of the screen var screenAspectRatio:Number = stage.fullScreenWidth / stage.fullScreenHeight; // change the fullScreenRect so that it covers the entire screen, keeping it centered on the redSquare // try commenting out this section to see what happens if you do not fix the aspect ratio. if (rectAspectRatio > screenAspectRatio) { var newHeight:Number = fullScreenRect.width / screenAspectRatio; fullScreenRect.y -= ((newHeight - fullScreenRect.height) / 2); fullScreenRect.height = newHeight; } else if (rectAspectRatio < screenAspectRatio) { var newWidth:Number = fullScreenRect.height * screenAspectRatio; fullScreenRect.x -= ((newWidth - fullScreenRect.width) / 2); fullScreenRect.width = newWidth; } // go to full screen stage.fullScreenSourceRect = fullScreenRect; stage.displayState = StageDisplayState.FULL_SCREEN; }
height | właściwość |
height:Number
[przesłanianie] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wysokość obiektu wyświetlanego w pikselach. Wysokość jest obliczana na podstawie granic zawartości obiektu wyświetlanego. W przypadku ustawienia właściwości height
właściwość scaleY
jest odpowiednio dostosowywana, jak widać w poniższym kodzie:
var rect:Shape = new Shape(); rect.graphics.beginFill(0xFF0000); rect.graphics.drawRect(0, 0, 100, 100); trace(rect.scaleY) // 1; rect.height = 200; trace(rect.scaleY) // 2;
Z wyjątkiem obiektów TextField i Video obiekt wyświetlany bez zawartości (jak na przykład pusta ikonka) ma wysokość 0, nawet w przypadku próby ustawienia właściwości height
na inną wartość.
Implementacja
override public function get height():Number
override public function set height(value:Number):void
Zgłasza
SecurityError — Odwołanie do właściwości height obiektu Stage spowoduje zgłoszenie wyjątku dla każdego obiektu wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
| |
IllegalOperationError — Nigdy nie jest poprawne ustawianie właściwości height obiektu Stage, nawet jeśli użytkownik jest jego właścicielem.
|
mouseChildren | właściwość |
mouseChildren:Boolean
[przesłanianie] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
override public function get mouseChildren():Boolean
override public function set mouseChildren(value:Boolean):void
Zgłasza
SecurityError — Odwołanie do właściwości mouseChildren obiektu Stage spowoduje zgłoszenie wyjątku dla każdego obiektu wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
mouseLock | właściwość |
mouseLock:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 11.2, AIR 3.2 |
Aby włączyć blokowanie myszy, należy ustawić wartość na true
. Włączenie blokowania myszy powoduje wyłączenie kursora i umożliwia ruchy myszy bez ograniczeń. Blokowanie myszy można włączyć tylko w trybie pełnoekranowym w aplikacjach komputerowych. Ustawienie tej opcji w przypadku aplikacji, która nie jest w trybie pełnoekranowym lub jest przeznaczona dla urządzeń przenośnych, powoduje wygenerowanie wyjątku.
Blokowanie myszy jest automatycznie wyłączane, a kursor myszy jest wyświetlany w następujących sytuacjach:
- Użytkownik wyłącza tryb pełnoekranowy za pomocą klawiszy Esc (na wszystkich platformach), Control+W (Windows), Command+W (Mac) lub Alt+F4 (Windows).
- Okno aplikacji przestaje być aktywne.
- Jest widoczny jakikolwiek interfejs ustawień (dotyczy również wszystkich okien dialogowych prywatności).
- Jest wyświetlane natywne okno dialogowe, na przykład dotyczące wysyłania pliku.
Przy wyłączaniu trybu pełnoekranowego ta właściwość jest automatycznie ustawiana na false
.
Zdarzenia skojarzone z ruchami myszy, takie jak mouseMove
, obsługują obiekt zdarzenia przy użyciu klasy MouseEvent. Gdy blokowanie myszy jest wyłączone, położenie myszy można określić za pomocą właściwości MouseEvent.localX
i MouseEvent.localY
. Gdy blokowanie myszy jest włączone, położenie myszy można określić za pomocą właściwości MouseEvent.movementX
i MouseEvent.movementY
. Właściwości movementX
i movementY
zawierają zmiany położenia myszy od ostatniego zdarzenia, a nie bezwzględne współrzędne położenia myszy.
Uwaga: Gdy aplikacja jest w trybie pełnoekranowym, detektory zdarzeń myszy dołączone do obiektów ekranowych innych niż Stage nie działają. Dlatego w celu odbierania zmian położenia ruchów myszy i innych zdarzeń myszy w sytuacji, gdy właściwość mouseLock
ma wartość true
, wymaga dołączenia detektorów zdarzeń do obiektu Stage.
Implementacja
public function get mouseLock():Boolean
public function set mouseLock(value:Boolean):void
Powiązane elementy interfejsu API
nativeWindow | właściwość |
nativeWindow:NativeWindow
[tylko do odczytu] Wersje środowiska wykonawczego: | AIR 1.0, Flash Lite 4 |
Odniesienie do obiektu NativeWindow zawierającego ten obiekt Stage.
Okno przedstawia okno macierzystego systemu operacyjnego, obiekt Stage przedstawia zawartość okna. Ta właściwość ma zastosowanie tylko dla zawartości uruchomionej w środowisku AIR na platformach obsługujących klasę NativeWindow. Na innych platformach ta właściwość ma wartość null
. W module Flash Player (zawartość uruchomiona w przeglądarce) ta właściwość także ma wartość null
.
Implementacja
public function get nativeWindow():NativeWindow
numChildren | właściwość |
numChildren:int
[tylko do odczytu] [przesłanianie] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwraca liczbę obiektów podrzędnych tego obiektu.
Implementacja
override public function get numChildren():int
Zgłasza
SecurityError — Odwołanie do właściwości numChildren obiektu Stage spowoduje zgłoszenie wyjątku dla każdego obiektu wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
orientation | właściwość |
orientation:String
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2 |
Bieżąca orientacja stołu montażowego. Tej właściwości można przypisać jedną z czterech wartości stałych zdefiniowanych w klasie StageOrientation:
Stała StageOrientation | Orientacja stołu montażowego |
---|---|
StageOrientation.DEFAULT | Ekran jest w orientacji domyślnej. |
StageOrientation.ROTATED_RIGHT | Ekran jest obrócony w prawo. |
StageOrientation.ROTATED_LEFT | Ekran jest obrócony w lewo. |
StageOrientation.UPSIDE_DOWN | Ekran jest odwrócony. |
StageOrientation.UNKNOWN | Aplikacja nie określiła jeszcze początkowej orientacji ekranu. Można dodać detektor zdarzeń orientationChange . |
Aby ustawić orientację stołu montażowego, należy użyć metody setOrientation()
.
Ważne: Właściwość orientation jest obsługiwana na urządzeniach z systemem Android z wersją przestrzeni nazw 2.6 lub nowszą.
Implementacja
public function get orientation():String
Powiązane elementy interfejsu API
quality | właściwość |
quality:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wartość z klasy StageQuality określająca, która jakość renderowania jest stosowana. Poniżej podano prawidłowe wartości:
StageQuality.LOW
—Niska jakość renderowania. Elementy graficzne i bitmapy nie są wygładzane, jednak środowiska wykonawcze używają mipmap.StageQuality.MEDIUM
—Średnia jakość renderowania. Elementy graficzne są poddawane antyaliasingowi w macierzy 2 x 2 piksele, wygładzanie bitmap zależy od ustawieniaBitmap.smoothing
. Środowiska wykonawcze używają mipmap. To ustawienie ma zastosowanie dla filmów bez tekstu.StageQuality.HIGH
—Wysoka jakość renderowania. Elementy graficzne są poddawane antyaliasingowi w macierzy 4 x 4 piksele, a wygładzanie bitmap zależy od ustawieniaBitmap.smoothing
. Środowiska wykonawcze używają mipmap. To ustawienie jakości renderowania jest stosowane domyślnie przez moduł Flash Player.StageQuality.BEST
—Bardzo wysoka jakość renderowania. Elementy graficzne są poddawane antyaliasingowi w macierzy 4 x 4 piksele. Jeśli właściwośćBitmap.smoothing
jest ustawiona natrue
, środowisko wykonawcze korzysta z algorytmu skalowania w dół z wysoką jakością, który prowadzi do powstania mniejszej liczby artefaktów (jednak użycie ustawieniaStageQuality.BEST
z właściwościąBitmap.smoothing
ustawioną natrue
istotnie zmniejsza wydajność i nie jest zalecane).
Ustawienia wyższej jakości generują lepsze renderowanie wyskalowanych bitmap. Należy jednak zauważyć, iż ustawienia wyższej jakości wymagają większych nakładów obliczeniowych. W szczególności stosowanie ustawień wyższej jakości przy renderowaniu wyskalowanego wideo może zmniejszyć liczbę klatek na sekundę.
Metoda BitmapData.draw()
używa wartości właściwości Stage.quality
. Można też użyć metody BitmapData.drawWithQuality()
, która pozwala na podanie parametru quality
i zignorowanie bieżącej wartości Stage.quality
.
W profilu komputerowym środowiska Adobe AIR dla właściwości quality
może być ustawiona wartość StageQuality.BEST
lub StageQuality.HIGH
. (Wartość domyślna to StageQuality.HIGH
). Próba ustawienia tej właściwości na inną wartość nie daje efektu. (Właściwość pozostaje niezmieniona). W profilu AIR dla urządzeń przenośnych są dostępne wszystkie cztery ustawienia jakości. Wartością domyślną na urządzeniach przenośnych jest StageQuality.MEDIUM
.
Dla zawartości uruchomionej w aplikacji Adobe AIR ustawienie właściwości quality
jednego z obiektów Stage powoduje zmianę jakości renderowania dla wszystkich obiektów Stage (używanych przez różne obiekty NativeWindow).
quality
.
Implementacja
public function get quality():String
public function set quality(value:String):void
Zgłasza
SecurityError — Wywołanie właściwości quality obiektu Stage spowoduje zgłoszenie wyjątku dla każdego obiektu wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
Powiązane elementy interfejsu API
scaleMode | właściwość |
scaleMode:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wartość z klasy StageScaleMode określająca, jakiego trybu skalowania należy użyć. Poniżej podano prawidłowe wartości:
- Wartość
StageScaleMode.EXACT_FIT
—Cała aplikacja jest widoczna w określonym obszarze bez prób zachowania oryginalnych proporcji. Mogą wystąpić zniekształcenia, a okno aplikacji może być rozciągnięte lub zwężone. - Wartość
StageScaleMode.SHOW_ALL
—Cała aplikacja jest widoczna w określonym obszarze bez zniekształcania, z zachowaniem oryginalnych proporcji aplikacji. Po obu stronach aplikacji mogą być wyświetlane krawędzie. - Wartość
StageScaleMode.NO_BORDER
—Cała aplikacja wypełnia określony obszar bez zniekształcania, chociaż może występować częściowe obcinanie elementów, wciąż zachowując oryginalne proporcje aplikacji. - Wartość
StageScaleMode.NO_SCALE
—Rozmiary całej aplikacji są ustalone, zatem pozostają te same nawet przy zmianie rozmiarów okna odtwarzacza. Obcinanie elementów może wystąpić, gdy okno odtwarzacza jest mniejsze niż zawartość.
Implementacja
public function get scaleMode():String
public function set scaleMode(value:String):void
Zgłasza
SecurityError — Wywołanie właściwości scaleMode obiektu Stage spowoduje zgłoszenie wyjątku dla każdego obiektu wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
Powiązane elementy interfejsu API
showDefaultContextMenu | właściwość |
showDefaultContextMenu:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Określa, czy domyślne elementy menu kontekstowego środowiska wykonawczego Flash mają być wyświetlane czy ukrywane.
Jeżeli właściwość showDefaultContextMenu
jest ustawiona na wartość true
(domyślnie), wówczas ukazywane są wszystkie elementy menu kontekstowego. Jeżeli właściwość showDefaultContextMenu
jest ustawiona na wartość false
, wówczas ukazywane są tylko elementy menu Ustawienia i Informacje.
Implementacja
public function get showDefaultContextMenu():Boolean
public function set showDefaultContextMenu(value:Boolean):void
Zgłasza
SecurityError — Wywoływanie właściwości showDefaultContextMenu obiektu Stage zgłosi wyjątek dla każdego wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
softKeyboardRect | właściwość |
softKeyboardRect:Rectangle
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.6, Flash Player 10.2 |
Prostokąt określający obszar stołu montażowego, który aktualnie zajmuje klawiatura programowa. Gdy klawiatura programowa nie jest uniesiona, składniki ramki to (0,0,0,0).
Implementacja
public function get softKeyboardRect():Rectangle
Powiązane elementy interfejsu API
stage3Ds | właściwość |
stage3Ds:Vector.<Stage3D>
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 11, AIR 3 |
Lista obiektów Stage3D dostępnych do wyświetlania zawartości 3D.
W danej chwili można używać ograniczonej liczby obiektów Stage3D. Liczba dostępnych obiektów Stage3D zależy od platformy i dostępnego sprzętu.
Obiekt Stage3D jest rysowany przed obiektem StageVideo i za listą wyświetlania aplikacji Flash.
Implementacja
public function get stage3Ds():Vector.<Stage3D>
Powiązane elementy interfejsu API
stageFocusRect | właściwość |
stageFocusRect:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Określa, czy wokół obiektów aktywnych mają być wyświetlane błyszczące ramki.
Implementacja
public function get stageFocusRect():Boolean
public function set stageFocusRect(value:Boolean):void
Zgłasza
SecurityError — Wywołanie właściwości stageFocusRect obiektu Stage spowoduje zgłoszenie wyjątku dla każdego obiektu wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
stageHeight | właściwość |
stageHeight:int
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Określa bieżącą wysokość stołu montażowego (w pikselach).
Jeżeli wartość właściwości Stage.scaleMode
jest ustawiona na wartość StageScaleMode.NO_SCALE
w momencie zmiany rozmiarów okna przez użytkownika, wówczas zawartość obiektu Stage utrzymuje swój zdefiniowany rozmiar, podczas gdy właściwość stageHeight
zmienia się, aby odzwierciedlić nową szerokość obszaru ekranu zajmowanego przez plik SWF. (W innych trybach skalowania właściwość stageHeight
zawsze odzwierciedla oryginalną szerokość pliku SWF). Możliwe jest dodanie detektora zdarzeń dla zdarzenia resize
, a następnie użycie właściwości stageHeight
klasy Stage do określenia właściwego wymiaru w pikselach środowiska wykonawczego Flash po zmianie rozmiaru. Detektor zdarzeń pozwala kontrolować jak zawartość ekranu dostosowuje się przy zmianie rozmiaru okna przez użytkownika.
Zachowanie urządzeń telewizyjnych ze środowiskiem AIR w przypadku ustawienia właściwości stageHeight
jest nieco inne niż urządzeń stacjonarnych. Jeśli właściwość Stage.scaleMode
ma ustawioną wartość StageScaleMode.NO_SCALE
i zostanie ustawiona właściwość stageHeight
, wysokość stołu montażowego zmieni się dopiero w następnej klatce pliku SWF.
Uwaga: Na stronie HTML zarządzającej plikiem SWF atrybuty height
znaczników zarówno object
i embed
muszą być ustawione na wartość procentową (na przykład 100%
) a nie liczbę pikseli. Jeżeli ustawienia są generowane przez kod JavaScript wówczas parametr height
metody AC_FL_RunContent()
muszą być również ustawione na wartość procentową. Wartość procentowa jest zastosowana do wartości właściwości stageHeight
.
Implementacja
public function get stageHeight():int
public function set stageHeight(value:int):void
Zgłasza
SecurityError — Wywołanie właściwości stageHeight obiektu Stage spowoduje zgłoszenie wyjątku dla każdego obiektu wywołującego, który nie znajduje się w tym samym obszarze izolowanym co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
Powiązane elementy interfejsu API
stageVideos | właściwość |
stageVideos:Vector.<StageVideo>
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.5, Flash Player 10.2 |
Lista obiektów StageVideo dostępnych do odtwarzania zewnętrznych plików wideo.
W danej chwili można używać ograniczonej liczby obiektów StageVideo. Gdy rozpoczyna się odtwarzanie pliku SWF, liczba dostępnych obiektów StageVideo zależy od platformy i dostępnego sprzętu.
Aby użyć obiektu StageVideo, należy przypisać element z obiektu wektora stageVideos
do zmiennej StageVideo.
Wszystkie obiekty StageVideo są wyświetlane na stole montażowym za wszystkimi obiektami wyświetlanymi. Obiekty StageVideo są wyświetlane na stole montażowym w kolejności, w jakiej są umieszczone w obiekcie stageVideos
klasy Vector. Załóżmy na przykład, że obiekt stageVideos
klasy Vector zawiera trzy wpisy:
- Obiekt StageVideo o indeksie 0 w obiekcie
stageVideos
klasy Vector jest wyświetlany za wszystkimi obiektami StageVideo. - Obiekt StageVideo o indeksie 1 jest wyświetlany przed obiektem StageVideo o indeksie 0.
- Obiekt StageVideo o indeksie 2 jest wyświetlany przed obiektem StageVideo o indeksie 1.
Kolejność tę można zmienić za pomocą właściwości StageVideo.depth
.
Uwaga: Urządzenia ze środowiskiem AIR for TV obsługują tylko jeden obiekt StageVideo.
Implementacja
public function get stageVideos():Vector.<StageVideo>
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
var stageVideo:StageVideo; if ( stage.stageVideos.length >= 1 ) { stageVideo = stage.stageVideos[0]; }
stageWidth | właściwość |
stageWidth:int
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Określa bieżącą szerokość stołu montażowego (w pikselach).
Jeżeli wartość właściwości Stage.scaleMode
jest ustawiona na wartość StageScaleMode.NO_SCALE
w momencie zmiany rozmiarów okna przez użytkownika, wówczas zawartość obiektu Stage utrzymuje swój zdefiniowany rozmiar, podczas gdy właściwość stageWidth
zmienia się, aby odzwierciedlić nową szerokość obszaru ekranu zajmowanego przez plik SWF. (W innych trybach skalowania właściwość stageWidth
zawsze odzwierciedla oryginalną szerokość pliku SWF). Możliwe jest dodanie detektora zdarzeń dla zdarzenia resize
, a następnie użycie właściwości stageWidth
klasy Stage do określenia właściwego wymiaru w pikselach środowiska wykonawczego Flash po zmianie rozmiaru. Detektor zdarzeń pozwala kontrolować to, jak zawartość ekranu dostosowuje się przy zmianie rozmiaru okna przez użytkownika.
Zachowanie urządzeń telewizyjnych ze środowiskiem AIR w przypadku ustawienia właściwości stageWidth
jest nieco inne niż urządzeń stacjonarnych. Jeśli właściwość Stage.scaleMode
ma ustawioną wartość StageScaleMode.NO_SCALE
i zostanie ustawiona właściwość stageWidth
, szerokość stołu montażowego zmieni się dopiero w następnej klatce pliku SWF.
Uwaga: Na stronie HTML zarządzającej plikiem SWF atrybuty width
znaczników zarówno object
i embed
muszą być ustawione na wartość procentową (na przykład 100%
) a nie liczbę pikseli. Jeżeli ustawienia są generowane przez kod JavaScript wówczas parametr width
metody AC_FL_RunContent()
muszą być również ustawione na wartość procentową. Wartość procentowa jest zastosowana do wartości właściwości stageWidth
.
Implementacja
public function get stageWidth():int
public function set stageWidth(value:int):void
Zgłasza
SecurityError — Wywołanie właściwości stageWidth obiektu Stage spowoduje zgłoszenie wyjątku dla każdego obiektu wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
Powiązane elementy interfejsu API
supportedOrientations | właściwość |
supportedOrientations:Vector.<String>
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.6 |
Orientacje obsługiwane przez bieżące urządzenie.
Ciągów orientacji znajdujących się na tej liście można używać jako parametrów dla metody setOrientation()
. Ustawianie nieobsługiwanej orientacji kończy się niepowodzeniem bez zgłoszenia błędu.
Niektóre możliwe orientacje:
Stała StageOrientation | Orientacja stołu montażowego |
---|---|
StageOrientation.DEFAULT | Ustawia domyślną orientację stołu montażowego. |
StageOrientation.ROTATED_RIGHT | Powoduje, że stół montażowy jest obrócony w prawo. |
StageOrientation.ROTATED_LEFT | Powoduje, że stół montażowy jest obrócony w lewo. |
StageOrientation.UPSIDE_DOWN | Powoduje, że stół montażowy jest odwrócony. |
Implementacja
public function get supportedOrientations():Vector.<String>
Powiązane elementy interfejsu API
supportsOrientationChange | właściwość |
supportsOrientationChange:Boolean
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2 |
Informuje, czy aplikacja obsługuje zmiany orientacji stołu montażowego (oraz obrót urządzenia). Obecnie ta właściwość ma wartość true
wyłącznie w aplikacjach AIR działających na urządzeniach mobilnych.
Implementacja
public static function get supportsOrientationChange():Boolean
Powiązane elementy interfejsu API
tabChildren | właściwość |
tabChildren:Boolean
[przesłanianie] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Określa, czy obiekty podrzędne tego obiektu mają reagować na klawisz Tab. Włącza lub wyłącza przechodzenie klawiszem Tab między elementami podrzędnymi obiektu. Wartością domyślną jest true
.
Uwaga: Nie należy korzystać z właściwości tabChildren
w środowisku Flex. Należy zamiast tego skorzystać z właściwości mx.core.UIComponent.hasFocusableChildren
.
Implementacja
override public function get tabChildren():Boolean
override public function set tabChildren(value:Boolean):void
Zgłasza
SecurityError — Odwołanie do właściwości tabChildren obiektu Stage spowoduje zgłoszenie wyjątku dla każdego obiektu wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
textSnapshot | właściwość |
textSnapshot:flash.text:TextSnapshot
[tylko do odczytu] [przesłanianie] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Zwraca obiekt TextSnapshot dla tego wystąpienia klasy DisplayObjectContainer.
Implementacja
override public function get textSnapshot():flash.text:TextSnapshot
Zgłasza
IllegalOperationError — Odwołanie do właściwości textSnapshot obiektu Stage zgłasza wyjątek, ponieważ klasa Stage nie implementuje tej właściwości. Aby tego uniknąć, należy wywołać właściwość textSnapshot kontenera obiektu wyświetlanego innego niż obiekt Stage.
|
vsyncEnabled | właściwość |
vsyncEnabled:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 29.0 |
Przedstawia bieżący stan właściwości vsync podstawowego rozwiązania graficznego. Właściwość vsync można włączać/wyłączać w celu natychmiastowego renderowania, bez oczekiwania na kolejny stan określony właściwością VSYNC. Odczyt właściwości obowiązuje w dowolnej chwili. Jednak ustawianie właściwości obowiązuje wyłącznie po uruchomieniu zdarzenia VsyncStateChangeAvailabilityEvent.
Implementacja
public function get vsyncEnabled():Boolean
public function set vsyncEnabled(value:Boolean):void
width | właściwość |
width:Number
[przesłanianie] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Szerokość obiektu wyświetlanego w pikselach. Szerokość jest obliczana na podstawie granic zawartości obiektu wyświetlanego. W przypadku ustawienia właściwości width
właściwość scaleX
jest odpowiednio dostosowywana, jak widać w poniższym kodzie:
var rect:Shape = new Shape(); rect.graphics.beginFill(0xFF0000); rect.graphics.drawRect(0, 0, 100, 100); trace(rect.scaleX) // 1; rect.width = 200; trace(rect.scaleX) // 2;
Z wyjątkiem obiektów TextField i Video obiekt wyświetlany bez zawartości (jak na przykład pusta ikonka) ma szerokość 0, nawet w przypadku próby ustawienia właściwości width
na inną wartość.
Implementacja
override public function get width():Number
override public function set width(value:Number):void
Zgłasza
SecurityError — Odwołanie do właściwości width obiektu Stage spowoduje zgłoszenie wyjątku dla każdego obiektu wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
| |
IllegalOperationError — Nigdy nie jest poprawne ustawianie właściwości width obiektu Stage, nawet jeśli użytkownik jest jego właścicielem.
|
wmodeGPU | właściwość |
wmodeGPU:Boolean
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10.0.32, AIR 1.5.2, Flash Lite 4 |
Wskazuje, czy tworzenie kompozycji przez procesor GPU jest dostępne i używane. Właściwość wmodeGPU
ma wartość true
tylko wtedy, gdy spełnione są wszystkie trzy poniższe warunki:
- Zażądano tworzenia kompozycji przez procesor GPU.
- Mechanizm tworzenia kompozycji przez procesor GPU jest dostępny.
- Mechanizm tworzenia kompozycji przez procesor GPU jest używany.
W szczególności wartość właściwości wmodeGPU
wskazuje na jeden z następujących stanów:
- Nie zażądano tworzenia kompozycji przez procesor GPU lub mechanizm ten jest niedostępny. W tym przypadku właściwość
wmodeGPU
ma wartośćfalse
. - Zażądano tworzenia kompozycji przez procesor GPU (jeśli ma zastosowanie, a mechanizm ten jest dostępny), ale środowisko działa w trybie „awaryjnym” (z nieoptymalnym sposobem renderowania) z uwagi na ograniczenia treści. W tym przypadku właściwość
wmodeGPU
ma wartośćtrue
. - Zażądano tworzenia kompozycji przez procesor GPU (jeśli ma zastosowanie, a mechanizm ten jest dostępny), ale środowisko działa w trybie najwyższej jakości. W tym przypadku właściwość
wmodeGPU
także ma wartośćtrue
.
Innymi słowy, właściwość wmodeGPU
identyfikuje możliwości i stan środowiska renderowania. W przypadku środowisk wykonawczych, które nie obsługują tworzenia kompozycji przez GPU, takich jak AIR 1.5.2, właściwość ma zawsze wartość false
, ponieważ (jak wspomniano wcześniej) wartość true
obowiązuje tylko wtedy, gdy spełnione są trzy warunki: zażądano tworzenia kompozycji przez GPU, gdy mechanizm ten jest dostępny i gdy jest używany.
Właściwość wmodeGPU
umożliwia ustalenie w czasie wykonywania, czy mechanizm tworzenia kompozycji przez GPU jest używany. Wartość właściwości wmodeGPU
wskazuje, czy treść będzie skalowana sprzętowo, czy nie, tak aby możliwe było prezentowanie grafiki we właściwym rozmiarze. Można także określić, czy renderowanie odbywa się w trybie przyspieszonym, i odpowiednio dopasować złożoność treści.
W przypadku programu Flash Player działającego w przeglądarce tworzenia kompozycji przez procesor GPU można zażądać, nadając wartość gpu
parametrowi HTML wmode
na stronie, w której jest osadzony plik SWF. W innych konfiguracjach tworzenia kompozycji przez GPU można zażądać w nagłówku pliku SWF (za pomocą narzędzi do projektowania generujących pliki SWF).
Jednak właściwość wmodeGPU
nie określa bieżącej wydajności renderowania. Nawet jeśli tworzenie kompozycji przez GPU jest używane, proces renderowania nie musi przebiegać w najszybszym trybie. Aby dopasować treść pod kątem optymalnego renderowania, należy użyć programu Flash z debugerem i ustawić parametr DisplayGPUBlendsetting
w pliku mm.cfg.
Uwaga: Ta właściwość ma zawsze wartość false
, gdy jest odczytywana przez kod ActionScript działający przed pierwszym cyklem renderingu wykonywanym przez środowisko wykonawcze. Na przykład, jeśli właściwość wmodeGPU
zostanie odczytana przez skrypt w 1. klatce pliku utworzonego w programie Adobe Flash Professional, a plik SWF jest pierwszym plikiem SWF załadowanym do nowej instancji środowiska wykonawczego, właściwość wmodeGPU
zwróci wartość false
. Aby uzyskać wiarygodną wartość należy poczekać, aż zostanie wykonany co najmniej jeden cykl renderowania. Wartość wmodeGPU
odczytana w detektorze zdarzenia exitFrame
dowolnego obiektu DisplayObject
zawsze jest wiarygodna.
Implementacja
public function get wmodeGPU():Boolean
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
wmodeGPU
po zrenderowaniu obiektu mySprite, tak aby odczytana wartość była wiarygodna.
mySprite.addEventListener(EXIT_FRAME, exithandler): function exithandler(exiteventobject:Event):void { trace(stage.wmodeGPU); }
addChild | () | metoda |
override public function addChild(child:DisplayObject):DisplayObject
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 — Instancja DisplayObject do dodania jako element podrzędny tej instancji DisplayObjectContainer.
|
DisplayObject — Instancja DisplayObject, która jest przekazywana w parametrze child .
|
Zgłasza
SecurityError — Wywoływanie metody addChild() obiektu Stage zgłosi wyjątek dla każdego obiektu wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
addChildAt | () | metoda |
override public function addChildAt(child:DisplayObject, index:int):DisplayObject
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 — Instancja DisplayObject do dodania jako element podrzędny tej instancji DisplayObjectContainer.
| |
index:int — Pozycja w indeksie, do której dodawany jest element podrzędny. Jeżeli zostanie określona pozycja w indeksie, która jest obecnie zajęta, wówczas obiekt podrzędny istniejący na tej pozycji i wszystkich powyższych jest przesuwany o jedną pozycję w górę na liście obiektów podrzędnych.
|
DisplayObject — Instancja DisplayObject, która jest przekazywana w parametrze child .
|
Zgłasza
SecurityError — Wywoływanie metody addChildAt() obiektu Stage zgłosi wyjątek dla każdego obiektu wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
addEventListener | () | metoda |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Rejestruje obiekt detektora zdarzenia w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. We wszystkich węzłach listy wyświetlania można rejestrować detektory zdarzeń reagujące na zdarzenia konkretnego typu, znajdujące się w określonej fazie i mające określony priorytet.
Po pomyślnym zarejestrowaniu detektora zdarzeń nie można zmienić jego priorytetu poprzez dodatkowe wywołania metody addEventListener()
. Aby zmienić priorytet detektora, należy najpierw wywołać metodę removeListener()
. Następnie można ponownie zarejestrować detektor z nowym poziomem priorytetu.
Należy pamiętać, że po zarejestrowaniu detektora późniejsze wywołania metody addEventListener()
z różnymi wartościami type
albo useCapture
powodują rejestrowanie odrębnych detektorów. Na przykład detektor zarejestrowany z parametrem useCapture
ustawionym na true
wykrywa tylko zdarzenia w fazie przechwytywania. Po ponownym wywołaniu metody addEventListener()
z tym samym obiektem detektora, ale z parametrem useCapture
ustawionym na false
będą istniały dwa odrębne detektory: jeden wykrywający zdarzenia w fazie przechwytywania, a drugi wykrywający zdarzenia w fazach miejsca docelowego i propagacji.
Nie można zarejestrować detektora zdarzeń, który wykrywałby tylko zdarzenia w fazie miejsca docelowego lub tylko zdarzenia w fazie propagacji. Te fazy są sprzężone podczas rejestracji, ponieważ propagacja zachodzi tylko w przodkach węzła miejsca docelowego.
Gdy detektor zdarzeń przestanie być potrzebny, należy go usunąć, wywołując metodę removeEventListener()
; w przeciwnym razie mogą wystąpić problemy w zarządzaniu pamięcią. Detektory zdarzeń nie są automatycznie usuwane z pamięci, ponieważ proces czyszczenia pamięci nie usuwa detektora, pod warunkiem że istnieje obiekt wywołujący (o ile dla parametru useWeakReference
ustawiona jest wartość true
).
Skopiowanie instancji klasy EventDispatcher nie powoduje skopiowania detektorów zdarzeń dołączonych do tej instancji. (Jeśli utworzono nowy węzeł, dla którego potrzebny jest detektor zdarzeń, należy dołączyć detektor po utworzeniu węzła). Jednak przeniesienie instancji klasy EventDispatcher powoduje również przeniesienia dołączonych do niej detektorów zdarzeń
Jeśli detektor zdarzeń jest rejestrowany w węźle w momencie, gdy ten węzeł przetwarza zdarzenie, detektor nie zostanie wywołany w bieżącej fazie, ale może być wywołany w późniejszej fazie przepływu zdarzeń, np. w fazie propagacji.
Jeśli detektor zdarzeń zostanie usunięty z węzła w momencie, gdy ten węzeł przetwarza zdarzenie, zostanie wywołany przez bieżące operacje. Raz usunięty detektor zdarzeń nie jest nigdy ponownie wywoływany (chyba że zostanie ponownie zarejestrowany na potrzeby dalszego etapu wykonania programu).
Parametry
type:String — Typ zdarzenia.
| |
listener:Function — Funkcja detektora, który przetwarza zdarzenie. Ta funkcja musi przyjmować obiekt Event jako swój jedyny parametr i nie może zwracać żadnych wyników, tak jak ilustruje to poniższy przykład:
function(evt:Event):void Funkcja może mieć dowolną nazwę. | |
useCapture:Boolean (default = false ) —
Określa, czy detektor działa w fazie przechwytywania, czy w fazach miejsca docelowego i propagacji. Jeżeli parametr useCapture jest ustawiony na true , wówczas detektor przetwarza zdarzenie tylko w trakcie fazy przechwytywania, a nie w trakcie fazy miejsca docelowego i propagacji. Jeżeli parametr useCapture ma wartość false , wówczas detektor przetwarza zdarzenie tylko w trakcie fazy miejsca docelowego i propagacji. W celu wykrywania zdarzenia we wszystkich trzech fazach należy wywołać metodę addEventListener dwa razy — raz z parametrem useCapture ustawionym na true , a następnie ponownie, z parametrem useCapture ustawionym na false .
| |
priority:int (default = 0 ) — Poziom priorytetu detektora zdarzeń. Priorytet ma postać 32-bitowej liczby całkowitej ze znakiem. Im wyższa jest liczba, tym wyższy priorytet. Wszystkie detektory z priorytetem n są przetwarzane przed detektorami z priorytetem n-1. Jeżeli dwa lub większa liczba detektorów ma ten sam priorytet, będą one przetwarzane w kolejności, w jakiej zostały dodane. Priorytet domyślny to 0.
| |
useWeakReference:Boolean (default = false ) — Określa, czy odwołanie do detektora jest mocne, czy słabe. Odwołanie mocne (domyślnie) zapobiega usunięciu detektora przy okazji porządkowania pamięci. Odwołanie słabe temu nie zapobiega. Funkcje składowe na poziomie klasy nie podlegają porządkowaniu pamięci, zatem można ustawić właściwość |
Zgłasza
SecurityError — Wywoływanie metody addEventListener obiektu Stage zgłosi wyjątek dla każdego wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
assignFocus | () | metoda |
public function assignFocus(objectToFocus:InteractiveObject, direction:String):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0 |
Ustawia fokus klawiatury na obiekt interaktywny, określony przez właściwość objectToFocus
, przy kierunku fokusu określonym przez parametr direction
.
Koncepcja kierunku fokusu musi być zdefiniowana przez aplikację (lub środowisko aplikacji). Nie istnieją wbudowane zasady sortowania aktywności obiektów interaktywnych, aczkolwiek można wykorzystać inne dostępne właściwości w celu ustalenia zasady ustawiania kolejności. Przykładowo można sortować obiekty interaktywne zgodnie z ich pozycją na stole montażowym lub na liście wyświetlanej. Wywoływanie metody assignFocus()
jest odpowiednikiem ustawienia właściwości Stage.focus
, z dodatkową zdolnością wskazywania kierunku, z którego przekazywana jest aktywność.
Właściwość objectToFocus
wywoła zdarzenie focusIn
w momencie otrzymania punktu skupienia. Właściwość direction
obiektu FocusEvent zaraportuje ustawienie parametru direction
.
Jeśli obiekt HTMLLoader zostanie przypisany do parametru objectToFocus
, obiekt HTMLLoader wybierze odpowiedni obiekt, na którym można ustawić fokus, w HTML DOM — w zależności od wartości parametru direction
. Jeśli jest to FocusDirection.BOTTOM
, fokus jest ustawiany na odpowiednim obiekcie w HTML DOM na końcu kolejki odczytywania. Jeśli jest to FocusDirection.TOP
, fokus jest ustawiany na odpowiednim obiekcie w HTML DOM na początku kolejki odczytywania. Jeśli jest to NONE
, fokus jest ustawiany na obiekt HTMLLoader bez zmiany elementu, na którym aktualnie ustawiony jest fokus.
Parametry
objectToFocus:InteractiveObject — Obiekt, który ma stać się aktywny, lub wartość null , aby usunąć aktywność z dowolnego elementu stołu montażowego.
| |
direction:String — Kierunek, z którego właściwość objectToFocus jest skupiana. Wartości prawidłowe wyliczone jako stałe w klasie FocusDirection.
|
Zgłasza
Error — Jeżeli aktywności nie można ustawić na target lub direction nie jest prawidłowym typem.
|
Powiązane elementy interfejsu API
dispatchEvent | () | metoda |
override public function dispatchEvent(event:Event):Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. Miejscem docelowym zdarzenia jest obiekt EventDispatcher, względem którego wywołano metodę dispatchEvent()
.
Parametry
event:Event — Obiekt Event, który jest wywoływany, tj. kierowany do przepływu zdarzeń. Jeśli zdarzenie jest wywoływane ponownie, automatycznie tworzony jest klon zdarzenia. Po wywołaniu zdarzenia nie można zmienić jego właściwości target , zatem należy utworzyć nową kopię zdarzenia w celu ponownego wywołania.
|
Boolean — Wartość true , jeśli zdarzenie zostało pomyślnie wywołane. Wartość false oznacza niepowodzenie lub wywołanie metody preventDefault() w zdarzeniu.
|
Zgłasza
SecurityError — Wywoływanie metody dispatchEvent() obiektu Stage zgłosi wyjątek dla każdego wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
hasEventListener | () | metoda |
override public function hasEventListener(type:String):Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. Umożliwia to określenie, w którym miejscu hierarchii przepływu zdarzeń w obiekcie EventDispatcher zmodyfikowana jest obsługa zdarzeń danego typu. Aby sprawdzić, czy zdarzenie określonego typu faktycznie wywoła detektor zdarzeń, należy użyć metody willTrigger()
.
Różnica między metodą hasEventListener()
a metodą willTrigger()
polega na tym, że metoda hasEventListener()
sprawdza tylko obiekt, do którego należy, natomiast metoda willTrigger()
sprawdza cały przepływ zdarzenia określonego parametrem type
.
Gdy metoda hasEventListener()
jest wywoływana z obiektu LoaderInfo, pod uwagę brane są tylko detektory, do których obiekt wywołujący może uzyskać dostęp.
Parametry
type:String — Typ zdarzenia.
|
Boolean — Wartość true , jeśli detektor określonego typu jest zarejestrowany, wartość false w przeciwnym wypadku.
|
Zgłasza
SecurityError — Wywoływanie metody hasEventListener() obiektu Stage zgłosi wyjątek dla każdego wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
invalidate | () | metoda |
public function invalidate():void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywołanie metody invalidate()
sygnalizuje środowisku wykonawczemu Flash konieczność przygotowania obiektów wyświetlanych na następną okazję renderowania listy wyświetlania (na przykład, gdy głowica przejdzie do nowej klatki animacji). Po wywołaniu metody invalidate()
przy następnym renderowaniu listy wyświetlania środowisko wykonawcze Flash wysyła zdarzenie render
do każdego obiektu wyświetlanego, które zostało zarejestrowane w celu nasłuchiwania zdarzenia render
. Konieczne jest wywołanie metody invalidate()
za każdym razem, gdy zachodzi potrzeba wysłania zdarzeń render
przez środowisko wykonawcze Flash.
Zdarzenie render
jest okazją do dokonania zmian w liście wyświetlania tuż przed momentem właściwego renderowania. Pozwala to na odroczenie aktualizacji listy wyświetlania do momentu najnowszej okazji. Pomaga to w poprawić wydajność przez eliminację niepotrzebnych aktualizacji ekranu.
Zdarzenie render
jest wywoływane wyłącznie do obiektów wyświetlanych, które znajdują się w tej samej domenie zabezpieczeń co kod wywołujący metodę stage.invalidate()
, lub z domeny zabezpieczeń, która otrzymała uprawnienie poprzez metodę Security.allowDomain()
.
Powiązane elementy interfejsu API
isFocusInaccessible | () | metoda |
public function isFocusInaccessible():Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Określa, czy właściwość Stage.focus
zwraca wartość null
z powodów bezpieczeństwa. Innymi słowy właściwość isFocusInaccessible
zwraca wartość true
, jeżeli obiekt aktywny należy do obszaru izolowanego, do którego plik SWF nie ma dostępu.
Boolean — Wartość true , gdy obiekt aktywny należy do obszaru izolowanego, do którego plik SWF nie ma dostępu.
|
removeChildAt | () | metoda |
override public function removeChildAt(index:int):DisplayObject
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 — Indeks obiektów podrzędnych obiektu DisplayObject do usunięcia.
|
DisplayObject — Instancja DisplayObject, która została usunięta.
|
Zgłasza
SecurityError — Wywoływanie metody removeChildAt() obiektu Stage zgłosi wyjątek dla każdego wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co obiekt do usunięcia. Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
setAspectRatio | () | metoda |
public function setAspectRatio(newAspectRatio:String):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2 |
Ustawia stół montażowy w orientacji o określonych proporcjach.
Jeśli orientacja stołu montażowego zmieni się wskutek wywołania metody, obiekt Stage wywoła zdarzenie orientationChange.
Aby sprawdzić, czy jest obsługiwana orientacja urządzenia, należy sprawdzić wartość właściwości Stage.supportsOrientantionChange
.
Obsługa profilów AIR: Ta funkcja jest obsługiwana na urządzeniach przenośnych, ale nie jest obsługiwana w komputerowych systemach operacyjnych ani w środowisku AIR dla urządzeń telewizyjnych. W czasie wykonywania można sprawdzić, czy funkcja jest obsługiwana, odczytując właściwość Stage.supportsOrientantionChange
. Więcej informacji o obsłudze elementów interfejsu API w różnych profilach można znaleźć w sekcji Obsługa profilów aplikacji AIR.
Parametry
newAspectRatio:String — Kod typu odpowiadający żądanym proporcjom (StageAspectRatio.PORTRAIT , StageAspectRatio.LANDSCAPE lub StageAspectRatio.ANY ).
|
Zgłasza
ArgumentError — Wartość przekazana w parametrze newAspectRatio jest niepoprawna. Wartość musi być zgodna z jedną ze stałych zdefiniowanych w klasie StageAspectRatio.
|
Powiązane elementy interfejsu API
setChildIndex | () | metoda |
override public function setChildIndex(child:DisplayObject, index:int):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 — Potomna instancja DisplayObject, dla której zachodzi potrzeba zmiany numeru indeksu.
| |
index:int — Wynikający numer indeksu child obiektu wyświetlania.
|
Zgłasza
SecurityError — Wywoływanie metody setChildIndex() obiektu Stage zgłosi wyjątek dla każdego wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
setOrientation | () | metoda |
public function setOrientation(newOrientation:String):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2 |
Ustawia stół montażowy w określonej orientacji.
Parametr newOrientation
należy ustawić na jedną z następujących czterech wartości stałych zdefiniowanych w klasie StageOrientation:
Stała StageOrientation | Orientacja stołu montażowego |
---|---|
StageOrientation.DEFAULT | Ustawia domyślną orientację stołu montażowego. |
StageOrientation.ROTATED_RIGHT | Powoduje, że stół montażowy jest obrócony w prawo. |
StageOrientation.ROTATED_LEFT | Powoduje, że stół montażowy jest obrócony w lewo. |
StageOrientation.UPSIDE_DOWN | Powoduje, że stół montażowy jest odwrócony. |
Nie należy ustawiać parametru na wartość StageOrientation.UNKNOWN
ani na żaden ciąg inny niż wymienione w tabeli.
Aby sprawdzić, czy jest obsługiwane zmienianie orientacji urządzenia, należy odczytać wartość właściwości Stage.supportsOrientantionChange
. W celu określenia, które orientacje są obsługiwane przez bieżące urządzenie, należy odczytać listę zawartą we właściwości supportedOrientations
.
Ustawienie orientacji jest operacją asynchroniczną. Jej natychmiastowe zakończenie po wywołaniu metody setOrientation()
nie jest gwarantowane. Aby określić, kiedy zmiana orientacji zostanie zakończona, należy dodać detektor zdarzeń dla zdarzenia orientationChange
.
Ważne: Metoda setOrientation()
nie była obsługiwana na urządzeniach z systemem Android przed wprowadzeniem środowiska AIR 2.6.
setOrientation()
nie powoduje wygenerowania zdarzenia orientationChanging
.
Parametry
newOrientation:String — Nowa orientacja stołu montażowego.
|
Zdarzenia
orientationChange: — Rozmiar stołu montażowego został zmieniony w wyniku wywołania metody setOrientation() .
|
Zgłasza
ArgumentError — Wartość przekazana w parametrze newOrientation jest niepoprawna. Wartość musi być jedną ze stałych zdefiniowanych w klasie StageOriention, inną niż stała StageOrientation.UNKNOWN .
|
Powiązane elementy interfejsu API
swapChildrenAt | () | metoda |
override public function swapChildrenAt(index1:int, index2:int):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 — Pozycja w indeksie pierwszego obiektu potomnego.
| |
index2:int — Pozycja w indeksie drugiego obiektu podrzędnego.
|
Zgłasza
SecurityError — Wywoływanie metody swapChildrenAt() obiektu Stage zgłosi wyjątek dla każdego wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel któregokolwiek z wymienianych obiektów. Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
willTrigger | () | metoda |
override public function willTrigger(type:String):Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego przodkach. Ta metoda zwraca wartość true
, jeśli detektor zdarzeń będzie wywoływany w dowolnej fazie przepływu zdarzeń, gdy zdarzenie określonego typu zostanie wywołane w obiekcie EventDispatcher lub dowolnym z jego przodków.
Różnica między metodą hasEventListener()
a metodą willTrigger()
polega na tym, że metoda hasEventListener()
sprawdza tylko obiekt, do którego należy, natomiast metoda willTrigger()
sprawdza cały przepływ zdarzenia określonego parametrem type
.
Gdy metoda willTrigger()
jest wywoływana z obiektu LoaderInfo, pod uwagę brane są tylko detektory, do których obiekt wywołujący może uzyskać dostęp.
Parametry
type:String — Typ zdarzenia.
|
Boolean — Wartość true , jeśli detektor określonego typu będzie wywoływany, wartość false w przeciwnym wypadku.
|
Zgłasza
SecurityError — Wywoływanie metody willTrigger() obiektu Stage zgłosi wyjątek dla każdego wywołującego, który nie znajduje się w tym samym obszarze izolowanym, co właściciel obiektu Stage (główny plik SWF). Aby tego uniknąć właściciel obiektu Stage może nadać uprawnienia do domeny wywołującego poprzez wywołanie metody Security.allowDomain() lub Security.allowInsecureDomain() . Więcej informacji zawiera rozdział „Zabezpieczenia” w publikacji ActionScript 3.0 — Podręcznik dla programistów.
|
browserZoomChange | Zdarzenie |
flash.events.Event
właściwość Event.type =
flash.events.Event.BROWSER_ZOOM_CHANGE
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 15 |
Wywoływane przy zmianie właściwości browserZoomFactor
obiektu Stage.
Event.BROWSER_ZOOM_CHANGE
definiuje wartość właściwości type
obiektu zdarzenia browserZoomChange
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | false |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Wystąpienie klasy Stage. |
fullScreen | Zdarzenie |
flash.events.FullScreenEvent
właściwość FullScreenEvent.type =
flash.events.FullScreenEvent.FULL_SCREEN
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4 |
Wywoływane, gdy obiekt Stage wchodzi lub wychodzi z trybu pełnego ekranu. Zmiana trybu pełnego ekranu może zostać zainicjowana przez skrypt ActionScript, wywołanie skrótu klawiszowego przez użytkownika lub w momencie, gdy okno trybu pełnego ekranu traci aktywność.
StałaFullScreenEvent.FULL_SCREEN
definiuje wartość właściwości type
obiektu zdarzenia fullScreen
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
fullScreen | true , jeśli jest aktywny tryb pełnoekranowy, albo false , jeśli jest aktywny normalny tryb wyświetlania. |
bubbles | false |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Obiekt Stage. |
mouseLeave | Zdarzenie |
flash.events.Event
właściwość Event.type =
flash.events.Event.MOUSE_LEAVE
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane przez obiekt Stage, gdy wskaźnik opuszcza obszar stołu montażowego. Jeśli przycisk myszy jest naciśnięty, zdarzenie to nie jest wywoływane.
StałaEvent.MOUSE_LEAVE
definiuje wartość właściwości type
obiektu zdarzenia mouseLeave
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | false |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Obiekt Stage. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
orientationChange | Zdarzenie |
flash.events.StageOrientationEvent
właściwość StageOrientationEvent.type =
flash.events.StageOrientationEvent.ORIENTATION_CHANGE
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.0 |
Wywoływane przez obiekt Stage w przypadku zmiany orientacji stołu montażowego.
Zmiana orientacji może wystąpić, gdy użytkownik obraca urządzenie lub otwiera klawiaturę wysuwaną albo następuje wywołanie metody setAspectRatio()
.
Uwaga: Jeśli właściwość autoOrients
ma wartość false
, orientacja stołu montażowego nie zmienia się podczas obracania urządzenia. Zdarzenia StageOrientationEvent są wywoływane w związku z orientacją urządzenia tylko wtedy, gdy właściwość autoOrients
ma wartość true
.
ORIENTATION_CHANGE
definiuje wartość właściwości type
obiektu zdarzenia orientationChange
. To zdarzenie ma następujące właściwości:
Właściwości | Wartości |
---|---|
afterOrientation | Nowa orientacja stołu montażowego. |
beforeOrientation | Stara orientacja stołu montażowego. |
target | Obiekt Stage, który wywołał zmianę orientacji. |
bubbles | true |
currentTarget | Określa obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
cancelable | false (za późno na anulowanie zmiany) |
orientationChanging | Zdarzenie |
flash.events.StageOrientationEvent
właściwość StageOrientationEvent.type =
flash.events.StageOrientationEvent.ORIENTATION_CHANGING
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2.0 |
Wywoływane przez obiekt Stage po rozpoczęciu wykonywania zmian związanych z orientacją stołu montażowego.
Ważne: Zdarzenia orientationChanging nie są wywoływane na urządzeniach z systemem Android.
Uwagi:
-
Jeśli właściwość
autoOrients
ma wartośćfalse
, orientacja stołu montażowego nie zmienia się podczas obracania urządzenia. Zdarzenia StageOrientationEvent są wywoływane w związku z orientacją urządzenia tylko wtedy, gdy właściwośćautoOrients
ma wartośćtrue
. -
Przy orientacji zaprogramowanej za pomocą metody
setOrientation()
zdarzenieorientationChanging
nie jest generowane.
ORIENTATION_CHANGING
definiuje wartość właściwości type
obiektu zdarzenia orientationChanging.
To zdarzenie ma następujące właściwości:
Właściwości | Wartości |
---|---|
afterOrientation | Nowa orientacja stołu montażowego. |
beforeOrientation | Stara orientacja stołu montażowego. |
target | Obiekt Stage, który wywołał zmianę orientacji. |
bubbles | true |
currentTarget | Określa obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
cancelable | true . |
resize | Zdarzenie |
flash.events.Event
właściwość Event.type =
flash.events.Event.RESIZE
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, gdy właściwość scaleMode
obiektu Stage jest ustawiona na StageScaleMode.NO_SCALE
, zaś plik SWF ma zmieniany rozmiar. Jest też wywoływane przy zmianie orientacji ekranu w trybie pełnoekranowym w programie Flash Player 15 lub nowszym.
Event.RESIZE
definiuje wartość właściwości type
obiektu zdarzenia resize
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | false |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Obiekt Stage. |
stageVideoAvailability | Zdarzenie |
flash.events.StageVideoAvailabilityEvent
właściwość StageVideoAvailabilityEvent.type =
flash.events.StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.2 |
Wywoływane przez obiekt Stage, gdy zmienia się stan właściwości stageVideos.
Definiuje wartość właściwościtype
obiektu zdarzenia stageVideoAvailability
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
availability | Stan podawany przez zdarzenie. |
bubbles | false |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt, który aktywnie przetwarza zdarzenie. |
target | Obiekt Stage podający informacje o dostępności wideo na stole montażowym. |
Przykład ( Sposób korzystania z tego przykładu )
StageExample
w celu wywołania zdarzeń w momencie aktywacji stołu montażowego lub zmiany jego rozmiarów. Proces ten jest przeprowadzany poprzez wykonywanie następujących kroków:
- Konstruktor klas w pierwszej kolejności ustala ustawienie aplikacji Flash, bez względu na rozmiar okna Flash Player, a następnie oddaje dwa detektory zdarzeń przy pomocy metod
activateHandler()
iresizeHandler()
. - Metoda
activateHandler()
zostaje uruchomiona w przypadku kliknięcia lewego przycisku myszy. - Metoda
resizeHandler()
zostaje uruchomiona w przypadku zmiany wielkości stołu montażowego.
package { import flash.display.Sprite; import flash.display.StageAlign; import flash.display.StageScaleMode; import flash.events.Event; public class StageExample extends Sprite { public function StageExample() { stage.scaleMode = StageScaleMode.NO_SCALE; stage.align = StageAlign.TOP_LEFT; stage.addEventListener(Event.ACTIVATE, activateHandler); stage.addEventListener(Event.RESIZE, resizeHandler); } private function activateHandler(event:Event):void { trace("activateHandler: " + event); } private function resizeHandler(event:Event):void { trace("resizeHandler: " + event); trace("stageWidth: " + stage.stageWidth + " stageHeight: " + stage.stageHeight); } } }
VsyncStateChangeAvailability | Zdarzenie |
flash.events.VsyncStateChangeAvailabilityEvent
właściwość VsyncStateChangeAvailabilityEvent.type =
flash.events.VsyncStateChangeAvailabilityEvent
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 29.0 |
Rozsyłane przez obiekt Stage, gdy zmienia się właściwość vsync.
Określa wartość właściwości obiektu zdarzenia VsyncStateChangeAvailabilityEvent
.
Przykład ( Sposób korzystania z tego przykładu )
VsyncExample
do rozsyłania zdarzeń, zawsze gdy stan właściwości vsync obiektu stage można włączyć lub wyłączyć. Proces ten jest realizowany przez wykonanie następujących kroków:
- Najpierw konstruktor uruchamia zdarzenie
VsyncStateChangeAvailabilityEvent
- Następuje wywołanie metody
onVsyncStateChangeAvailability
, w której zaznaczono, czy zdarzenieVsyncStateChangeAvailabilityEvent
jest dostępne czy nie. - Jeśli jest dostępne, można przełączać stan obiektu stage. W innym przypadku wartość właściwości
vsyncEnable
pozostaje tylko do odczytu. - Wartość włączania właściwości vsync można aktywować, tylko jeśli zdarzenie zostanie uruchomione.
package { import flash.display.Sprite; import flash.events.VsyncStateChangeAvailabilityEvent public class VsyncExample extends Sprite { public function VsyncExample() { stage.addEventListener(VsyncStateChangeAvailabilityEvent.VSYNC_STATE_CHANGE_AVAILABILITY, onVsyncStateChangeAvailability); } public function onVsyncStateChangeAvailability(event:VsyncStateChangeAvailabilityEvent):void { if (event.available) { // vsyncEnabled is now changeable and can be turned off. stage.vsyncEnabled = false; // Now, AS can change VSYNC state because event.available is true trace("vsyncEnabled of Stage object is changeable"); } else { // vsyncEnabled is not changeable now. This could be due to fallback to software rendering, for example. stage.vsyncEnabled = false; // This will be ignored because event.available is now false trace("vsyncEnabled of Stage object is read-only"); trace("Current value of vsyncEnabled of Stage object is "+ stage.vsyncEnabled); } } } }
Tue Jun 12 2018, 12:06 PM Z