| Pakiet | fl.display |
| Klasa | public class ProLoader |
| Dziedziczenie | ProLoader  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Uwaga: Klasa ProLoader nie jest podklasą klasy flash.display.Loader. Aby używać klasy ProLoader, należy zastąpić wszystkie odniesienia do typu Loader odniesieniami do typu ProLoader.
Klasa ProLoader udostępnia spójną obsługę wczytywania. Jest to szczególnie przydatne w przypadku plików SWF realizujących wstępne wczytywanie współużytkowanych bibliotek czasu wykonywania (RSL, Runtime Shared Library). Na przykład pliki SWF używające tekstu TLF domyślnie korzystają ze wstępnego wczytywania RSL. W takich sytuacjach klasa ProLoaderInfo opóźnia wysyłanie zdarzeń INIT i COMPLETE do momentu zakończenia wstępnego wczytywania RSL i udostępnienia rzeczywistej zawartości. W efekcie tego właściwość content pozwala uzyskać dostęp do rzeczywistej zawartości. Klasa ProLoader pozwala również uniknąć pewnych innych problemów:
- Dodatkowe zdarzenia
addedToStageiremovedFromStage - Zawartość wczytana do nieodpowiedniego elementu macierzystego w pierwszej klatce. (Dotyczy zawartości opublikowanej dla programu Flash Player 10.2 lub nowszego za pomocą programu Flash Professional CS5.5 lub nowszego).
Ostrzeżenie: Niektóre elementy klasy ProLoader nie obsługują pewnych wersji środowiska wykonawczego. Należy z nich korzystać tylko pod warunkiem, że obsługuje je wersja środowiska AIR lub programu Flash Player, dla której aplikacja jest publikowana. W przeciwnym razie interfejsy API będą generowały błędy czasu wykonywania. Metody i właściwości z ograniczoną obsługą środowisk wykonawczych:
-
unloadAndStop() -
loadFilePromise() -
uncaughtErrorEvents
Informacje na temat obsługi środowisk wykonawczych można uzyskać w dokumentacji poszczególnych interfejsów API.
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| 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 | |
| alpha : Number
Wartość przezroczystości alfa określonego obiektu. | DisplayObject | |
| blendMode : String
Wartość z klasy BlendMode określająca, jakiego trybu mieszania należy użyć. | DisplayObject | |
| blendShader : Shader [tylko do zapisu]
Ustawia moduł cieniujący, który jest używany do mieszania pierwszego planu oraz tła. | DisplayObject | |
| buttonMode : Boolean
Określa tryb przycisku tej ikonki. | Sprite | |
| cacheAsBitmap : Boolean
Jeśli ustawiono wartość true, środowisko wykonawcze Flash buforuje wewnętrzną reprezentację bitmapy obiektu wyświetlanego. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
W przypadku wartości innej niż null ten obiekt Matrix definiuje sposób renderowania obiektu wyświetlanego, gdy cacheAsBitmap jest ustawione na true. | DisplayObject | |
| constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| content : DisplayObject [tylko do odczytu]
Zawiera główny obiekt graficzny pliku SWF lub obraz (JPG, PNG lub GIF), który wczytano za pomocą metody load() lub loadBytes(). | ProLoader | ||
| contentLoaderInfo : ProLoaderInfo [tylko do odczytu]
Zwraca obiekt ProLoaderInfo odpowiadający aktualnie wczytywanemu obiektowi. | ProLoader | ||
| contextMenu : NativeMenu
Określa menu kontekstowe tego obiektu. | InteractiveObject | |
| doubleClickEnabled : Boolean
Określa, czy ten obiekt reaguje na zdarzenia doubleClick (dwukrotne kliknięcia). | InteractiveObject | |
| dropTarget : DisplayObject [tylko do odczytu]
Określa obiekt ekranowy, nad którym jest przeciągana ikonka, lub na który upuszczono ikonkę. | Sprite | |
| filters : Array
Indeksowana tablica zawierająca wszystkie filtry aktualnie skojarzone z obiektem wyświetlanym. | DisplayObject | |
| focusRect : Object
Określa, czy z tym obiektem skojarzono ramkę aktywności. | InteractiveObject | |
| graphics : Graphics [tylko do odczytu]
Określa obiekt Graphics skojarzony z ikonką, której mogą dotyczyć polecenia rysowania kształtów wektorowych. | Sprite | |
| height : Number
Wysokość obiektu ekranowego w pikselach. | DisplayObject | |
| hitArea : Sprite
Określa ikonkę, która ma pełnić funkcję obszaru naciskania innej ikonki. | Sprite | |
| 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
Określa, czy elementy potomne obiektu obsługują mysz lub inne urządzenie wejściowe użytkownika. | DisplayObjectContainer | |
| mouseEnabled : Boolean
Określa, czy ten obiekt odbiera komunikaty z myszy lub innego urządzenia wejściowego użytkownika. | InteractiveObject | |
| mouseX : Number [tylko do odczytu]
Określa współrzędną x myszy lub urządzenia wejściowego użytkownika w pikselach. | DisplayObject | |
| mouseY : Number [tylko do odczytu]
Określa współrzędną y myszy lub urządzenia wejściowego użytkownika w pikselach. | DisplayObject | |
| name : String
Nazwa instancji obiektu DisplayObject. | DisplayObject | |
| needsSoftKeyboard : Boolean
Określa, czy klawiatura wirtualna (klawiatura programowa wyświetlana na ekranie) powinna być wyświetlana, gdy to wystąpienie klasy InteractiveObject staje się aktywne. | InteractiveObject | |
| numChildren : int [tylko do odczytu]
Zwraca liczbę elementów potomnych tego obiektu. | DisplayObjectContainer | |
| opaqueBackground : Object
Określa, czy przy konkretnym kolorze tła obiekt wyświetlany jest nieprzejrzysty. | DisplayObject | |
| parent : DisplayObjectContainer [tylko do odczytu]
Odnosi się do obiektu DisplayObjectContainer, który zawiera obiekt wyświetlany. | DisplayObject | |
| root : DisplayObject [tylko do odczytu]
Dla obiektu wyświetlanego w załadowanym pliku SWF główną właściwość stanowi obiekt wyświetlany na samym szczycie na liście wyświetlania w postaci struktury drzewa, którą reprezentuje plik SWF. | DisplayObject | |
| rotation : Number
Określa wielkość obrotu instancji obiektu DisplayObject (w kątach). | DisplayObject | |
| rotationX : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi x — od pozycji początkowej względem nadrzędnego kontenera 3D. | DisplayObject | |
| rotationY : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi y — od pozycji początkowej względem nadrzędnego kontenera 3D. | DisplayObject | |
| rotationZ : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi z — od pozycji początkowej względem nadrzędnego kontenera 3D. | DisplayObject | |
| scale9Grid : Rectangle
Aktualnie stosowana siatka skalowania. | DisplayObject | |
| 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 | |
| softKeyboard : String
Steruje wyglądem klawiatury programowej. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
Definiuje obszar, który powinien pozostać na ekranie po wyświetleniu klawiatury programowej (niedostępna w systemie iOS). | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
Kontroluje dźwięki skojarzone z tą ikonką. | Sprite | |
| stage : Stage [tylko do odczytu]
Stół montażowy obiektu wyświetlanego. | DisplayObject | |
| tabChildren : Boolean
Określa, czy elementy potomne tego obiektu mają reagować na klawisz Tab. | DisplayObjectContainer | |
| tabEnabled : Boolean
Określa, czy do tego obiektu można przejść za pomocą klawisza Tab. | InteractiveObject | |
| tabIndex : int
Określa kolejność uaktywniania obiektów (z pliku SWF) za pomocą klawisza Tab. | InteractiveObject | |
| textSnapshot : flash.text:TextSnapshot [tylko do odczytu]
Zwraca obiekt TextSnapshot dla tego wystąpienia klasy DisplayObjectContainer. | DisplayObjectContainer | |
| transform : flash.geom:Transform
Obiekt z właściwościami dotyczącymi matrycy obiektu wyświetlanego, transformacji kolorów oraz granic pikseli. | DisplayObject | |
| uncaughtErrorEvents : EventDispatcher [tylko do odczytu]
Obiekt, który wywołuje zdarzenie uncaughtError, gdy w kodzie pliku SWF tego obiektu ProLoader wystąpi nieobsłużony błąd. | ProLoader | ||
| useHandCursor : Boolean
Wartość typu Boolean wskazuje, czy wskaźnik dłoni pojawia się w momencie, gdy wskaźnik jest przesuwany nad ikonką, której właściwość buttonMode jest ustawiona na wartość true. | Sprite | |
| visible : Boolean
Decyduje, czy obiekt wyświetlany jest widoczny, czy nie. | DisplayObject | |
| width : Number
Szerokość obiektu ekranowego w pikselach. | DisplayObject | |
| 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 | ||
|---|---|---|---|
Tworzy obiekt ProLoader, który umożliwia wczytywanie plików w formatach SWF, JPEG, GIF i PNG. | ProLoader | ||
|
Dodaje potomne wystąpienie klasy DisplayObject do tego wystąpienia klasy DisplayObjectContainer. | DisplayObjectContainer | |
|
Dodaje potomne wystąpienie klasy DisplayObject do tego wystąpienia klasy DisplayObjectContainer. | DisplayObjectContainer | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | |
|
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 | |
Anuluje działanie metody load(), która jest obecnie aktywna dla wystąpienia klasy ProLoader. | ProLoader | ||
|
Decyduje o tym, czy określony obiekt ekranowy jest potomkiem instancji obiektu DisplayObjectContainer, czy też sam jest taką instancją. | DisplayObjectContainer | |
|
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | |
|
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 | |
|
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | |
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Wyznacza prostokąt ograniczający obiekt wyświetlany w celu sprawdzenia, czy zachodzi on lub przecina się z prostokątem ograniczającym obiektu wyświetlanego obj. | DisplayObject | |
|
Analizuje obiekt wyświetlany w celu ustalenia czy nakłada się on lub przecina punkt określony przez parametry x i y. | DisplayObject | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
Wczytuje plik SWF, JPEG, PNG, JPEG progresywny lub GIF bez animacji do obiektu potomnego tego obiektu ProLoader. | ProLoader | ||
Wczytuje dane binarne przechowywane w obiekcie ByteArray. | ProLoader | ||
Wczytuje wystąpienie klasy IFilePromise za pośrednictwem parametru promise. | ProLoader | ||
|
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 | |
|
Usuwa obiekt potomny DisplayObject o podanym indeksie z listy elementów potomnych obiektu DisplayObjectContainer. | DisplayObjectContainer | |
|
Powoduje usunięcie wszystkich wystąpień potomnych klasy DisplayObject z listy obiektów potomnych wystąpień klasy DisplayObjectContainer. | DisplayObjectContainer | |
|
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | |
|
Powoduje uniesienie klawiatury wirtualnej. | InteractiveObject | |
|
Zmienia położenie istniejącego elementu potomnego w kontenerze obiektów ekranowych. | DisplayObjectContainer | |
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Pozwala użytkownikowi przeciągnąć określoną ikonkę. | Sprite | |
|
Umożliwia użytkownikowi przeciąganie określonej ikonki na urządzeniu z ekranem dotykowym. | Sprite | |
|
Rekurencyjnie zatrzymuje wykonywanie osi czasu wszystkich obiektów MovieClip, dla których ten obiekt jest obiektem głównym. | DisplayObjectContainer | |
|
Kończy metodę startDrag(). | Sprite | |
|
Kończy działanie metody startTouchDrag(); używana z urządzeniami wyposażonymi w ekran dotykowy. | Sprite | |
|
Zamienia kolejność dwóch określonych obiektów podrzędnych. | DisplayObjectContainer | |
|
Zamienia miejscami na liście dwa różne obiekty potomne o podanych indeksach. | DisplayObjectContainer | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
|
Zwraca ciąg reprezentujący określony obiekt. | Object | |
Usuwa element potomny tego obiektu ProLoader, który został wczytany za pomocą metody load(). | ProLoader | ||
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
|
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher | |
content | właściwość |
content:DisplayObject [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Zawiera główny obiekt wyświetlany pliku SWF lub plik obrazu (JPG, PNG lub GIF), który został załadowany przy pomocy metod load() lub loadBytes().
Implementacja
public function get content():DisplayObjectZgłasza
SecurityError — Załadowany plik SWF lub plik obrazu należy do obszaru izolowanego, do którego użytkownik nie ma dostępu. W przypadku załadowanego pliku SWF można tego uniknąć poprzez wywołanie metody Security.allowDomain() przez plik lub poprzez określenie przez plik parametru loaderContext właściwości securityDomain ustawionym na wartość SecurityDomain.currentDomain w momencie wywołania metod load() lub loadBytes().
|
contentLoaderInfo | właściwość |
contentLoaderInfo:ProLoaderInfo [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Zwraca obiekt ProLoaderInfo odpowiadający aktualnie wczytywanemu obiektowi. Obiekty ProLoaderInfo są współdzielone przez obiekt ProLoader i obiekt wczytanej zawartości. Obiekt ProLoaderInfo udostępnia informacje o postępie wczytywania oraz dane statystyczne wczytywanego pliku.
Zdarzenia związane z wczytywaniem są wywoływane przez obiekt ProLoaderInfo, do którego odnosi się właściwość contentLoaderInfo obiektu ProLoader. Właściwość contentLoaderInfo jest ustawiana na prawidłowy obiekt ProLoaderInfo jeszcze przed wczytaniem zawartości, co pozwala na dodawanie detektorów zdarzeń do obiektu przed wczytywaniem.
Do wykrywania nieprzechwyconych błędów wywołanych we wczytanym pliku SWF należy używać właściwości ProLoader.uncaughtErrorEvents, a nie właściwości ProLoader.contentLoaderInfo.uncaughtErrorEvents.
Uwaga: Właściwość contentLoaderInfo zwraca obiekt ProLoaderInfo. Klasa ProLoaderInfo nie jest podklasą klasy LoaderInfo, dlatego nie pozwala stosować niejawnego rzutowania na klasę nadrzędną. Z tego powodu należy pamiętać o zmianie deklaracji typu LoaderInfo na ProLoaderInfo.
Implementacja
public function get contentLoaderInfo():ProLoaderInfouncaughtErrorEvents | właściwość |
uncaughtErrorEvents:EventDispatcher [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2.0 |
Obiekt, który wywołuje zdarzenie uncaughtError, gdy w kodzie pliku SWF tego obiektu ProLoader wystąpi nieobsłużony błąd. Sytuacja taka ma miejsce, gdy błąd zostanie wywołany poza blokiem try..catch lub gdy zostanie wywołany obiekt zdarzenia ErrorEvent, dla którego nie zarejestrowano żadnych detektorów.
Ta właściwość jest tworzona po zakończeniu wczytywania pliku przez ten obiekt. Do tego czasu właściwość uncaughtErrorEvents jest równa null. W projektach opartych tylko na języku ActionScript dostęp do tej właściwości można uzyskać podczas wykonywania funkcji konstruktora klasy głównej pliku SWF lub po jej wykonaniu.
Uzyskanie dostępu do tej właściwości obiektu ProLoader w odtwarzaczu, który nie obsługuje tej właściwości, powoduje błąd. Zwraca obiekt EventDispatcher, a nie UncaughtErrorEvents, aby uniknąć generowania błędów w nieobsługiwanych odtwarzaczach.
Implementacja
public function get uncaughtErrorEvents():EventDispatcherPowiązane elementy interfejsu API
ProLoader | () | Konstruktor |
public function ProLoader()| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Tworzy obiekt ProLoader, który umożliwia wczytywanie plików w formatach SWF, JPEG, GIF i PNG. Należy wywołać metodę load() w celu wczytania zasobu jako elementu potomnego wystąpienia klasy ProLoader. Następnie można dodać obiekt ProLoader do listy wyświetlania, używając na przykład metody addChild() wystąpienia klasy DisplayObjectContainer. Zasób zostanie wyświetlony na stole montażowym po wczytaniu.
Wystąpienia klasy ProLoader można także użyć w trybie określanym jako „poza listą” — bez dodawania wystąpienia do kontenera obiektów ekranowych na liście wyświetlania. W tym trybie wystąpienie klasy Loader może służyc do wczytywania pliku SWF zawierającego dodatkowe moduły aplikacji.
W celu wykrycia momentu zakończenia wczytywania pliku SWF można użyć zdarzeń obiektu ProLoaderInfo skojarzonego z właściwością contentLoaderInfo obiektu ProLoader. W tym momencie kod znajdujący się w pliku modułu SWF może zostać wykonany w celu zainicjowania i uruchomienia modułu. W trybie poza listą wystąpienie klasy ProLoader pozwala także wczytać plik SWF zawierający składniki lub zasoby multimedialne. Również w takiej sytuacji dzięki powiadomieniom o zdarzeniach obiektu ProLoaderInfo można wykrywać znaczniki, których wczytywanie zostało zakończone. W tym momencie aplikacja może zacząć korzystać ze składników i zasobów multimedialnych w bibliotece pliku SWF przez utworzenie wystąpień klas języka ActionScript 3.0, które reprezentują te składniki i zasoby.
W celu określenia stanu obiektu ProLoader należy monitorować następujące zdarzenia skojarzone z właściwością contentLoaderInfo obiektu ProLoaderInfo:
- Zdarzenie
openjest wywoływane przy rozpoczęciu ładowania. - Zdarzenie
ioErrorlubsecurityErrorjest wywoływane, w sytuacji gdy plik nie może być załadowany lub przy wystąpieniu błędu w trakcie ładowania. - Zdarzenie
progressjest wywoływane ciągle w trakcie ładowania pliku. - Zdarzenie
completejest wywoływane w momencie zakończenia wczytywania pliku, ale przed udostępnieniem metod i właściwości wczytanego klipu filmowego. Jeśli plik SWF używa wstępnego wczytywania RSL, to zdarzenie jest wywoływane po zakończeniu tej operacji. W tym momencie właściwośćcontentpozwala uzyskać dostęp do rzeczywistej zawartości. - Zdarzenie
initjest wywoływane po udostępnieniu właściwości i metod załadowanego pliku SWF, co umożliwia jego manipulację. Zdarzenie jest wywoływane przed procedurą obsługi zdarzeniacomplete. Przy strumieniowaniu plików SWF zdarzenieinitmoże pojawić się znacznie wcześniej niż zdarzeniecomplete. W większości przypadków należy korzystać z modułu obsługi zdarzeniainit. Jeśli plik SWF używa wstępnego wczytywania RSL, to zdarzenie jest wywoływane po zakończeniu tej operacji. W tym momencie właściwośćcontentpozwala uzyskać dostęp do rzeczywistej zawartości.
Powiązane elementy interfejsu API
close | () | metoda |
public function close():void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player Player - 9 |
Anuluje działanie metody load(), która jest obecnie aktywna dla wystąpienia klasy ProLoader.
load | () | metoda |
public function load(request:URLRequest, context:LoaderContext = null):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Player Player - 9 |
Wczytuje plik SWF, JPEG, PNG, JPEG progresywny lub GIF bez animacji do obiektu potomnego tego obiektu ProLoader. W przypadku wczytywania animowanego pliku GIF wyświetlana jest tylko pierwsza klatka. Obiekt ProLoader może zawierać tylko jeden element potomny, dlatego kolejne żądanie load() kończy poprzednie żądanie (jeśli nadal oczekuje na wykonanie) i rozpoczyna nowe wczytywanie.
Uwaga: W środowisku AIR 1.5 i programie Flash Player 10 maksymalna szerokość i wysokość ładowanego obrazu wynosi 8191 pikseli, a łączna liczba pikseli nie może przekroczyć 16 777 215. (A zatem, jeśli ładowany obraz ma szerokość 8,191 pikseli, nie może być wyższy niż 2048 pikseli). W prorgamie Flash Player 9 i wcześniejszych wersjach oraz w środowisku AIR 1.1 i wcześniejszych wersjach ograniczenie wysokości i szerokości wynosiło 2880 pikseli.
Plik SWF lub obraz wczytany do obiektu ProLoader dziedziczy właściwości położenia, obrotu i skali macierzystych obiektów ekranowych obiektu ProLoader.
Należy stosować metodę unload() do usuwania filmów lub obrazów załadowanych tą metodą, lub do anulowania operacji ładowania będących w trakcie wykonywania.
Istnieje możliwość zablokowania używania tej metody przez plik SWF. W tym celu należy ustawić parametr allowNetworking znaczników object oraz embed na stronie HTML zawierającej zawartość SWF.
Korzystając z tej metody, należy uwzględnić model zabezpieczeń programu Flash Player, który został przedstawiony w opisie klasy ProLoader.
W programie Flash Player 10 i nowszych wersjach, jeśli użyty zostanie wieloczęściowy nagłówek Content-Type (np. "multipart/form-data"), w którym przesyłane są pliki (wskazywane przez parametr "filename" w nagłówku "content-disposition" w treści operacji POST), wówczas operacja POST podlega regułom zabezpieczeń zastosowanym do wysyłania plików:
- Operację POST należy wykonać w odpowiedzi na działanie zainicjowane przez użytkownika, np. kliknięcie myszy lub naciśnięcie klawisza.
- Jeśli operacja POST jest operacją międzydomenową (cel operacji POST nie znajduje się na tym samym serwerze, co plik SWF, który wysyła żądanie POST), docelowy serwer musi dostarczyć plik reguł URL, który zezwoli na międzydomenowy dostęp.
Dla dowolnego wieloczęściowego nagłówka Content-Type również składnia musi być poprawna (zgodnie ze standardem RFC2046). Jeśli składnia okaże się niepoprawna, operacja POST będzie podlegać regułom zabezpieczeń stosowanym do wysyłania plików.
Więcej informacji na temat zabezpieczeń zawiera odpowiedni temat w Centrum programistów programu Flash Player w kategorii Bezpieczeństwo.
Parametry
request:URLRequest — Bezwzględny lub względny URL pliku SWF, JPG, GIF lub PNG, który zostanie załadowany. Ścieżka względna musi być względna w stosunku pliku SWF. Bezwzględny URL musi zawierać odwołanie do protokołu, jak na przykład http:// lub pliku:///. Nazwy plików nie mogą zawierać określeń stacji dysków.
| |
context:LoaderContext (default = null)
Jeśli parametr Aby znaleźć wszystkie szczegóły, zobacz opis właściwości w klasie LoaderContext. |
Zdarzenia
asyncError: — Wywoływane przez obiekt contentLoaderInfo, jeśli określono właściwość LoaderContext.requestedContentParent i nie można dodać wczytanej zawartości jako podrzędnej względem określonego obiektu DisplayObjectContainer. Może się to zdarzyć, jeśli wczytano zawartość typu flash.display.AVM1Movie lub wywołanie metody addChild() obiektu requestedContentParent generuje błąd.
| |
complete: — Wywoływane przez obiekt contentLoaderInfo po załadowaniu pliku. Zdarzenie complete jest zawsze wywoływane po zdarzeniu init.
| |
httpStatus: — Wywoływane przez obiekt contentLoaderInfo po wygenerowaniu żądania sieciowego za pośrednictwem HTTP, pod warunkiem że program Flash Player może wykryć kod stanu HTTP.
| |
init: — Wywoływane przez obiekt contentLoaderInfo, gdy właściwości i metody załadowanego pliku SWF są dostępne. Zdarzenie init zawsze poprzedza zdarzenie complete.
| |
ioError: — Wywoływane przez obiekt contentLoaderInfo, gdy wystąpi błąd wejścia lub wyjścia uniemożliwiający wykonanie operacji ładowania.
| |
open: — Wywoływane przez obiekt contentLoaderInfo po uruchomieniu operacji ładowania.
| |
progress: — Wywoływane przez obiekt contentLoaderInfo w miarę odbierania danych w toku operacji ładowania.
| |
securityError: — Wywoływane przez obiekt contentLoaderInfo, gdy plik SWF w obszarze izolowanym lokalnego systemu plików podejmie próbę załadowania zawartości do obszaru izolowanego sieci lokalnej lub vice versa.
| |
securityError: — Wywoływane przez obiekt contentLoaderInfo, jeśli określono właściwość LoaderContext.requestedContentParent, a obszar izolowany właściwości LoaderContext.requestedContentParent nie ma dostępu do wczytanego pliku SWF.
| |
unload: — Wywoływane przez obiekt contentLoaderInfo po usunięciu załadowanego obiektu.
|
Zgłasza
IOError — Wartością właściwości digest obiektu request nie jest wartość null. Należy tylko ustawić właściwość digest obiektu URLRequest w czasie wywoływania metody URLLoader.load(), gdy wczytywany jest plik SWZ (składnik platformy Adobe).
| |
SecurityError — Właściwość LoaderContext.securityDomain musi mieć wartość null lub SecurityDomain.currentDomain. Odzwierciedla to fakt, iż możliwe jest umieszczenie załadowanego multimedia tylko w jego naturalnym obszarze izolowanym lub użytkownika (ta druga opcja wymaga pliku z polityką).
| |
SecurityError — Lokalne pliki SWF mogą powodować ustawienie właściwości LoaderContext.securityDomain wyłącznie na null. Nie jest dozwolone importowanie multimediów innych niż lokalne do lokalnego obszaru izolowanego, lub umieszczania innych mediów lokalnych w miejscu innym, niż ich naturalny obszar izolowany.
| |
SecurityError — Nie można połączyć się z portem, który zazwyczaj jest zastrzeżony. Pełną listę zablokowanych portów zawiera sekcja „Ograniczanie sieciowych interfejsów API” w publikacji ActionScript 3.0 — podręcznik dla programistów.
| |
SecurityError — Jeżeli właściwości applicationDomain lub securityDomain parametru context pochodzą z niedozwolonej domeny.
| |
SecurityError — Jeżeli lokalny plik SWF próbuje wykorzystać właściwość securityDomain parametru context.
| |
IllegalOperationError — Jeśli właściwość requestedContentParent parametru context jest obiektem ProLoader.
| |
IllegalOperationError — Jeśli dla parametru LoaderContext.parameters ustawiono wartość inną niż null i zawiera on pewne wartości typów innych niż String.
|
Powiązane elementy interfejsu API
loadBytes | () | metoda |
public function loadBytes(bytes:ByteArray, context:LoaderContext = null):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Player 9 |
Wczytuje dane binarne przechowywane w obiekcie ByteArray.
Metoda loadBytes() jest asynchroniczna. Przed uzyskaniem dostępu do właściwości załadowanego obiektu należy poczekać na zdarzenie "init".
Korzystając z tej metody, należy uwzględnić model zabezpieczeń programu Flash Player, który został przedstawiony w opisie klasy ProLoader.
Parametry
bytes:ByteArray — Obiekt ByteArray. Zawartość obiektu ByteArray może być w dowolnym z formatów plików obsługiwanych przez klasę ProLoader: SWF, GIF, JPEG lub PNG.
| |
context:LoaderContext (default = null)applicationDomain obiektu LoaderContext jest stosowana; właściwości checkPolicyFile i securityDomain nie są stosowane.
Jeśli parametr Więcej informacji na temat zabezpieczeń zawiera odpowiedni temat w Centrum programistów programu Flash Player w kategorii Bezpieczeństwo. |
Zdarzenia
asyncError: — Wywoływane przez obiekt contentLoaderInfo, jeśli określono właściwość LoaderContext.requestedContentParent i nie można dodać wczytanej zawartości jako podrzędnej względem określonego obiektu DisplayObjectContainer. Może się to zdarzyć, jeśli wczytano zawartość typu flash.display.AVM1Movie lub wywołanie metody addChild() obiektu requestedContentParent generuje błąd.
| |
complete: — Wywoływane przez obiekt contentLoaderInfo po zakończeniu operacji. Zdarzenie complete jest zawsze wywoływane po zdarzeniu init.
| |
init: — Wywoływane przez obiekt contentLoaderInfo, gdy właściwości i metody załadowanych danych są dostępne. Zdarzenie init zawsze poprzedza zdarzenie complete.
| |
ioError: — Wywoływane przez obiekt contentLoaderInfo, gdy środowisko wykonawcze nie może przeanalizować danych w tablicy bajtów.
| |
open: — Wywoływane przez obiekt contentLoaderInfo po uruchomieniu operacji.
| |
progress: — Wywoływane przez obiekt contentLoaderInfo podczas przesyłania danych w pamięci.
| |
securityError: — Wywoływane przez obiekt contentLoaderInfo, jeśli określono właściwość LoaderContext.requestedContentParent, a obszar izolowany właściwości LoaderContext.requestedContentParent nie ma dostępu do wczytanego pliku SWF.
| |
unload: — Wywoływane przez obiekt contentLoaderInfo po usunięciu załadowanego obiektu.
|
Zgłasza
ArgumentError — Jeżeli właściwość length obiektu ByteArray nie jest większa od 0.
| |
IllegalOperationError — Jeżeli właściwość checkPolicyFile lub securityDomain parametru context mają wartość inną niż null.
| |
IllegalOperationError — Jeśli właściwość requestedContentParent parametru context jest obiektem ProLoader.
| |
IllegalOperationError — Jeśli dla parametru LoaderContext.parameters ustawiono wartość inną niż null i zawiera on pewne wartości typów innych niż String.
| |
SecurityError — Jeżeli dostarczona właściwość applicationDomain parametru context pochodzi z niedozwolonej domeny.
| |
SecurityError — Nie można połączyć się z portem, który zazwyczaj jest zastrzeżony. Pełną listę zablokowanych portów zawiera sekcja „Ograniczanie sieciowych interfejsów API” w publikacji ActionScript 3.0 — podręcznik dla programistów.
|
Powiązane elementy interfejsu API
loadFilePromise | () | metoda |
public function loadFilePromise(promise:Object, context:LoaderContext = null):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | AIR 2.5, AIR 2.0, Flash Player 9 |
Wczytuje wystąpienie klasy IFilePromise za pośrednictwem parametru promise. Dla typu parametru promise jest używana klasa nadrzędna Object, a nie IFilePromise. Ma to na celu uniknięcie występowania błędów w innych odtwarzaczach.
Metoda loadFilePromise przyjmuje obiekt IFilePromise i wczytuje dane binarne. Jeśli dane są w strumieniu progresywnym, na przykład jest to materiał wideo, program czeka na zdarzenia „init” lub „progress” przed uzyskaniem dostępu do właściwości wczytanego obiektu. Jeśli tak nie jest, program czeka na zdarzenie „complete”, aby uzyskać pewność, że dane zostały wczytane do końca.
Korzystając z tej metody, należy uwzględnić model zabezpieczeń programu Flash Player, który został przedstawiony w opisie klasy ProLoader.
Parametry
promise:Object — Obiekt IFilePromise. Źródłem danych tego obiektu może być plik w dowolnym z formatów plików obsługiwanych przez klasę Loader: SWF, GIF, JPEG lub PNG.
| |
context:LoaderContext (default = null)applicationDomain obiektu LoaderContext jest stosowana; właściwości checkPolicyFile i securityDomain nie są stosowane.
Jeśli parametr Więcej informacji na temat zabezpieczeń zawiera odpowiedni temat w Centrum programistów programu Flash Player w kategorii Bezpieczeństwo. |
Zdarzenia
asyncError: — Wywoływane przez obiekt contentLoaderInfo, jeśli określono właściwość LoaderContext.requestedContentParent i nie można dodać wczytanej zawartości jako podrzędnej względem określonego obiektu DisplayObjectContainer. Może się to zdarzyć, jeśli wczytano zawartość typu flash.display.AVM1Movie lub wywołanie metody addChild() obiektu requestedContentParent generuje błąd.
| |
complete: — Wywoływane przez obiekt contentLoaderInfo po zakończeniu operacji. Zdarzenie complete jest zawsze wywoływane po zdarzeniu init.
| |
init: — Wywoływane przez obiekt contentLoaderInfo, gdy właściwości i metody załadowanych danych są dostępne. Zdarzenie init zawsze poprzedza zdarzenie complete.
| |
ioError: — Wywoływane przez obiekt contentLoaderInfo, gdy środowisko wykonawcze nie może wykonać analizy danych ze źródła danych lub nie można odczytać strumienia źródła danych.
| |
open: — Wywoływane przez obiekt contentLoaderInfo po uruchomieniu operacji.
| |
progress: — Wywoływane przez obiekt contentLoaderInfo podczas przesyłania danych w pamięci.
| |
securityError: — Wywoływane przez obiekt contentLoaderInfo, jeśli określono właściwość LoaderContext.requestedContentParent, a obszar izolowany właściwości LoaderContext.requestedContentParent nie ma dostępu do wczytanego pliku SWF.
| |
unload: — Wywoływane przez obiekt contentLoaderInfo po usunięciu załadowanego obiektu.
Ostrzeżenie: Użycie tego interfejsu API poza aplikacją AIR wywoła błąd. |
Zgłasza
IllegalOperationError — Jeśli właściwość requestedContentParent parametru context jest obiektem ProLoader.
| |
IllegalOperationError — Jeśli dla parametru LoaderContext.parameters ustawiono wartość inną niż null i zawiera on pewne wartości typów innych niż String.
| |
ArgumentError — Jeśli obiekt IFilePromise przekazywany jako parametr jest wartością null.
|
Powiązane elementy interfejsu API
unload | () | metoda |
public function unload():void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Usuwa element potomny tego obiektu ProLoader, który został wczytany za pomocą metody load(). Właściwość property skojarzonego obiektu ProLoaderInfo jest zerowana do wartości null. Element potomny nie zawsze jest niszczony, gdyż mogą się do niego odnosić inne obiekty. Przestaje jednak być elementem potomnym obiektu ProLoader.
W ramach najlepszej praktyki przed usunięciem załadowanego podrzędnego pliku SWF koniecznie należ zamknąć wszelkie strumienie w obiektach tego pliku, jak na przykład LocalConnection, NetConnection, NetStream oraz Sound. W innym przypadku audio w podrzędnym pliku SWF może być wciąż odgrywane, mimo iż plik ten został już usunięty. W celu zamknięcia strumieni w potomnym pliku SWF należy dodać detektor zdarzeń do potomka, który nasłuchuje zdarzenia unload. Gdy obiekt macierzysty wywołuje metodę ProLoader.unload(), wówczas do elementu potomnego jest wysyłane zdarzenieunload. Poniższy kod ilustruje sposób realizacji tych działań.
function closeAllStreams(evt:Event) {
myNetStream.close();
mySound.close();
myNetConnection.close();
myLocalConnection.close();
}
myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);
Powiązane elementy interfejsu API
Tue Jun 12 2018, 12:06 PM Z