| Pakiet | fl.display |
| Klasa | public class ProLoaderInfo |
| Dziedziczenie | ProLoaderInfo  EventDispatcher Object |
| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Niektóre elementy tej klasy, między innymi childSandboxBridge i parentSandboxBridge, są obsługiwane tylko w pewnych wersjach programu Flash Player i środowiska AIR. Te właściwości należy wywoływać tylko pod warunkiem, że obsługuje je wersja środowiska AIR lub programu Flash Player, dla której aplikacja jest publikowana. Wywoływanie tych właściwości w innych kontekstach powoduje błędy czasu wykonywania.
Powiązane elementy interfejsu API
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
| actionScriptVersion : uint [tylko do odczytu]
Wersja ActionScript wczytanego pliku SWF. | ProLoaderInfo | ||
| applicationDomain : ApplicationDomain [tylko do odczytu]
Gdy jest wczytany zewnętrzny plik SWF, definicje języka ActionScript 3.0 zawarte we wczytanej klasie są przechowywane we właściwości applicationDomain. | ProLoaderInfo | ||
| bytes : ByteArray [tylko do odczytu]
Bajty skojarzone z obiektem ProLoaderInfo. | ProLoaderInfo | ||
| bytesLoaded : uint [tylko do odczytu]
Liczba wczytanych bajtów. | ProLoaderInfo | ||
| bytesTotal : uint [tylko do odczytu]
Przed pierwszym wywołaniem zdarzenia progress przez odpowiedni obiekt ProLoader tego obiektu wartość właściwości bytesTotal wynosi 0. | ProLoaderInfo | ||
| childAllowsParent : Boolean [tylko do odczytu]
Wyraża relację zaufania między zawartością (element potomny) i obiektem ProLoader (element nadrzędny). | ProLoaderInfo | ||
| childSandboxBridge : Object
Obiekt, który może być określony przez kod wczytywanej zawartości w celu udostępnienia właściwości i metod dla kodu w obszarze izolowanym obiektu ProLoader. | ProLoaderInfo | ||
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| content : DisplayObject [tylko do odczytu]
Wczytany obiekt skojarzony z tym obiektem ProLoaderInfo. | ProLoaderInfo | ||
| contentType : String [tylko do odczytu]
Typ MIME wczytanego pliku. | ProLoaderInfo | ||
| frameRate : Number [tylko do odczytu]
liczba klatek na sekundę w ramach wczytanego pliku SWF (liczba ramek na sekundę). | ProLoaderInfo | ||
| height : int [tylko do odczytu]
Nominalna wysokość wczytanego elementu. | ProLoaderInfo | ||
| isURLInaccessible : Boolean [tylko do odczytu]
Wskazuje, czy właściwość ProLoaderInfo.url została przycięta. | ProLoaderInfo | ||
| loader : ProLoader [tylko do odczytu]
Obiekt ProLoader skojarzony z tym obiektem ProLoaderInfo. | ProLoaderInfo | ||
| loaderURL : String [tylko do odczytu]
Adres URL pliku SWF, który zainicjował wczytywanie zawartości multimedialnej opisanej w tym obiekcie ProLoaderInfo. | ProLoaderInfo | ||
| parameters : Object [tylko do odczytu]
Obiekt zawierający pary nazwa-wartość, odpowiadające parametrom przekazywanym do wczytanego pliku SWF. | ProLoaderInfo | ||
| parentAllowsChild : Boolean [tylko do odczytu]
Wyraża relację zaufania między obiektem ProLoader (element nadrzędny) i zawartością (element potomny). | ProLoaderInfo | ||
| parentSandboxBridge : Object
Obiekt, który może zostać ustawiony przez kod w obszarze izolowanym obiektu ProLoader, aby udostępnić właściwości i metody dla kodu wczytywanej zawartości. | ProLoaderInfo | ||
| sameDomain : Boolean [tylko do odczytu]
Odpowiada relacji między modułem wczytującym i zawartością: prawda w przypadku tej samej domeny źródłowej; fałsz - w przeciwnym przypadku. | ProLoaderInfo | ||
| sharedEvents : EventDispatcher [tylko do odczytu]
Podczas wczytywania zawartości realizującej wstępne wczytywanie współużytkowanych bibliotek czasu wykonywania (RSL, Runtime Shared Library) występują problemy z dopasowaniem czasu, dlatego zalecane jest, aby przed dodaniem detektorów do obiektu sharedEvents zaczekać na odebranie zdarzenia init. Można również dodać detektory ponownie po odebraniu zdarzenia init. | ProLoaderInfo | ||
| swfVersion : uint [tylko do odczytu]
Wersja formatu wczytanego pliku SWF. | ProLoaderInfo | ||
| url : String [tylko do odczytu]
Adres URL wczytywanych danych. | ProLoaderInfo | ||
| width : int [tylko do odczytu]
Nominalna szerokość wczytanego elementu. | ProLoaderInfo | ||
actionScriptVersion | właściwość |
actionScriptVersion:uint [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Wersja ActionScript wczytanego pliku SWF. Wersja językowa jest określona przez uporządkowania klasy ActionScriptVersion, jak na przykład ActionScriptVersion.ACTIONSCRIPT2 oraz ActionScriptVersion.ACTIONSCRIPT3.
Uwaga: Ta właściwość zawsze ma wartość ActionScriptVersion.ACTIONSCRIPT2 lub ActionScriptVersion.ACTIONSCRIPT3. Skrypty ActionScript 1.0 i 2.0 są zgłaszane jako wartość ActionScriptVersion.ACTIONSCRIPT2 (wersja 2.0). Ta właściwość odróżnia tylko skrypty ActionScript 1.0 i 2.0 od skryptu ActionScript 3.0.
Implementacja
public function get actionScriptVersion():uintPowiązane elementy interfejsu API
applicationDomain | właściwość |
applicationDomain:ApplicationDomain [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Gdy ładowany jest zewnętrzny plik SWF, definicje języka ActionScript 3.0 zawarte w załadowanej klasie są przechowywane we właściwości applicationDomain.
Całość kodu zawartego w pliku SWF jest zdefiniowana celu istnienia w domenie aplikacji. Obecna domena aplikacji to ta, w której uruchomiona jest główna aplikacja. Domena systemowa zwiera domeny wszystkich aplikacji, w tym domenę bieżącą, i wszystkie klasy używane przez program Flash Player lub środowisko Adobe AIR.
Wszystkie domeny aplikacji, z wyjątkiem domeny systemu, posiadają skojarzoną domenę nadrzędną. Domeną nadrzędną domeny applicationDomain głównej aplikacji jest domena systemu. Załadowane klasy są definiowane tylko wtedy, gdy nie zostały one już zdefiniowane przez obiekt nadrzędny. Nie jest możliwe nadpisanie definicji załadowanej klasy przy pomocy nowszej definicji.
W celu zapoznania się z przykładami wykorzystania domen aplikacji należy zapoznać się z informacjami zawartymi w rozdziale „Środowisko systemu klienckiego" w publikacji ActionScript 3.0 — Podręcznik dla programistów.
Implementacja
public function get applicationDomain():ApplicationDomainPowiązane elementy interfejsu API
bytes | właściwość |
bytesLoaded | właściwość |
bytesLoaded:uint [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Liczba wczytanych bajtów. Gdy ta liczba równa jest wartości właściwości bytesTotal, wówczas wszystkie bajty są ładowane.
Implementacja
public function get bytesLoaded():uintPowiązane elementy interfejsu API
bytesTotal | właściwość |
bytesTotal:uint [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Przed pierwszym wywołaniem zdarzenia progress przez odpowiedni obiekt ProLoader tego obiektu wartość właściwości bytesTotal wynosi 0. Po pierwszym zdarzeniu progress obiektu ProLoader właściwość bytesTotal odzwierciedla aktualną liczbę bajtów do pobrania.
Implementacja
public function get bytesTotal():uintPowiązane elementy interfejsu API
childAllowsParent | właściwość |
childAllowsParent:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Wyraża relację zaufania między zawartością (element potomny) i obiektem ProLoader (element nadrzędny). Wartość true, jeżeli obiekt nadrzędny ma dostęp do obiektu podrzędnego; wartość false w innym przypadku. Właściwość ta jest ustawiona na wartość true, jeżeli obiekt podrzędny wywołał metodę allowDomain() w celu nadania pozwolenia domenie nadrzędnej, lub strategia URL jest ładowana na domenie podrzędnej, która nadaje pozwolenia domenie nadrzędnej. Jeżeli obiekt podrzędny i nadrzędny znajdują się w tej samej domenie ta właściwość ma wartość true.
Więcej informacji na temat zabezpieczeń zawiera odpowiedni temat w witrynie Flash Player Developer Center: Bezpieczeństwo.
Implementacja
public function get childAllowsParent():BooleanPowiązane elementy interfejsu API
childSandboxBridge | właściwość |
childSandboxBridge:Object| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Obiekt, który może być określony przez kod wczytywanej zawartości w celu udostępnienia właściwości i metod dla kodu w obszarze izolowanym obiektu ProLoader. Ten most między obszarami izolowanymi umożliwia treści z domeny nieaplikacyjnej uzyskanie kontrolowanego dostępu do skryptów w obszarze izolowanym aplikacji AIR i odwrotnie. Most między obszarami izolowanymi łączy te obszary, pozwalając na jawne interakcje między aplikacyjnymi i nieaplikacyjnymi obszarami izolowanymi zabezpieczeń.
Implementacja
public function get childSandboxBridge():Object public function set childSandboxBridge(value:Object):voidZgłasza
SecurityError — Tę właściwość może ustawiać tylko zawartość w obszarze izolowanym wczytywanej zawartości.
|
Powiązane elementy interfejsu API
content | właściwość |
content:DisplayObject [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Wczytany obiekt skojarzony z tym obiektem ProLoaderInfo.
Implementacja
public function get content():DisplayObjectPowiązane elementy interfejsu API
contentType | właściwość |
contentType:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Typ MIME wczytanego pliku. Wartość null, gdy nie została załadowana część pliku wystarczająco duża, by można było określić jego typ. Poniższa lista ilustruje możliwe wartości:
"application/x-shockwave-flash""image/jpeg""image/gif""image/png"
Implementacja
public function get contentType():StringPowiązane elementy interfejsu API
frameRate | właściwość |
frameRate:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Liczba klatek na sekundę w ramach wczytanego pliku SWF (liczba ramek na sekundę). Z reguły liczba ta jest liczbą całkowitą, chociaż nie jest to konieczne.
Wartość ta może się różnić od właściwej wykorzystywanej liczby klatek na sekundę. Program Flash Player lub środowisko AIR wykorzystuje tylko jedną częstość klatek dla wszystkich załadowanych plików SWF w danym momencie, która jest określona przez nominalną liczbę klatek na sekundę w głównym pliku SWF. Ponadto osiągnięcie głównej częstości klatek nie zawsze jest możliwe — zależy to od sprzętu, synchronizacji dźwięku i innych czynników.
Implementacja
public function get frameRate():NumberPowiązane elementy interfejsu API
height | właściwość |
height:int [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Nominalna wysokość wczytanego elementu. Wartość ta może się różnić od właściwej wysokości wyświetlanej zawartości, ponieważ załadowana zawartość lub jego nadrzędne obiekty wyświetlane mogą być skalowane.
Implementacja
public function get height():intPowiązane elementy interfejsu API
isURLInaccessible | właściwość |
isURLInaccessible:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Wskazuje, czy właściwość ProLoaderInfo.url została przycięta. Jeśli właściwość isURLInaccessible ma wartość true, wówczas wartość ProLoaderInfo.url jest wyłącznie domeną końcowego adresu URL, z którego wczytano zawartość. Na przykład właściwość zostanie przycięta, jeśli zawartość wczytano z adresu http://www.adobe.com/assets/hello.swf, a właściwość ProLoaderInfo.url ma wartość http://www.adobe.com. isURLInaccessible ma wartość true tylko wówczas, gdy spełnione są wszystkie następujące warunki:
- Doszło do przekierowania HTTP podczas ładowania treści.
- Plik SWF wywołujący metodę
ProLoader.load()pochodzi z domeny innej niż końcowy adres URL zawartości. - Plik SWF wywołujący metodę
ProLoader.load()nie ma uprawnień dostępu do zawartości. Wydano uprawnienie do uzyskiwania dostępu do treści, a w ten sam sposób wydano uprawnienie do metodyBitmapData.draw(): należy wywołać metodęSecurity.allowDomain(), aby uzyskać dostęp do pliku SWF (w przypadku pliku treści innej niż SWF należy określić plik reguły i użyć właściwościLoaderContext.checkPolicyFile).
Uwaga: Właściwość isURLInaccessible została dodana dla programu Flash Player 10.1 i środowiska AIR 2.0. Jednak ta właściwość jest dostępna dla plików SWF wszystkich wersji, pod warunkiem że środowisko wykonawcze Flash obsługuje tę właściwość. Dlatego stosowanie narzędzi do tworzenia treści w trybie „ścisłym” powoduje błąd kompilacji. W celu obejścia błędu należy użyć składni przekierowania myLoaderInfo["isURLInaccessible"] lub wyłączyć tryb ścisły. Jeśli do tworzenia aplikacji używany jest program Flash Professional CS5 lub środowisko Flex SDK 4.1, można wykorzystywać i kompilować odwołania do tego elementu interfejsu API dla środowisk wykonawczych wydanych wcześniej niż wersje Flash Player 10.1 i AIR 2.
W przypadku treści aplikacji w środowisku AIR ta właściwość ma zawsze wartość false.
Implementacja
public function get isURLInaccessible():BooleanPowiązane elementy interfejsu API
loader | właściwość |
loader:ProLoader [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Obiekt ProLoader skojarzony z tym obiektem ProLoaderInfo. Jeżeli ten obiekt ProLoaderInfo jest właściwością loaderInfo wystąpienia głównej klasy pliku SWF, wówczas żaden obiekt ProLoader nie jest skojarzony.
Implementacja
public function get loader():ProLoaderPowiązane elementy interfejsu API
loaderURL | właściwość |
loaderURL:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Adres URL pliku SWF, który zainicjował wczytywanie zawartości multimedialnej opisanej w tym obiekcie ProLoaderInfo. W przypadku wystąpienia głównej klasy pliku SWF ten adres URL jest taki sam jak adres URL pliku SWF.
Implementacja
public function get loaderURL():StringPowiązane elementy interfejsu API
parameters | właściwość |
parameters:Object [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Obiekt zawierający pary nazwa-wartość, odpowiadające parametrom przekazywanym do wczytanego pliku SWF.
Możliwe jest wykorzystanie pętli for-in w celu wyodrębnienia wszystkich nazw oraz wartości z obiektu parameters.
Istnieją dwa źródła parametrów: ciąg znaków zapytania w adresie URL głównego pliku SWF oraz wartość właściwości FlashVars parametru HTML (ma to wpływ tylko na główny plik SWF).
Właściwość parameters zastępuje technikę skryptu ActionScript 1.0 i 2.0, polegającą na dostarczaniu parametrów pliku SWF jako właściwości głównej osi czasu.
Wartość właściwości parameters wynosi null dla obiektów ProLoader zawierających pliki SWF, które korzystają z języka ActionScript 1.0 lub 2.0. Ma ona wartość inną niż null tylko w przypadku obiektów ProLoader zawierających pliki SWF oparte na języku ActionScript 3.0.
Implementacja
public function get parameters():ObjectPowiązane elementy interfejsu API
parentAllowsChild | właściwość |
parentAllowsChild:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Wyraża relację zaufania między obiektem ProLoader (element nadrzędny) i zawartością (element potomny). Wartość true, jeżeli obiekt podrzędny ma dostęp do obiektu nadrzędnego; wartość false w innym przypadku. Właściwość ta jest ustawiona na wartość true, jeżeli obiekt nadrzędny wywołał metodę allowDomain() w celu nadania pozwolenia domenie podrzędnej, lub plik reguł URL jest ładowany na domenie nadrzędnej, która nadaje pozwolenia domenie podrzędnej. Jeżeli obiekt podrzędny i nadrzędny znajdują się w tej samej domenie ta właściwość ma wartość true.
Więcej informacji na temat zabezpieczeń zawiera odpowiedni temat w witrynie Flash Player Developer Center: Bezpieczeństwo.
Implementacja
public function get parentAllowsChild():BooleanZgłasza
Error — Błąd zgłaszany, jeżeli plik nie został pobrany w stopniu pozwalającym na pobranie żądanych informacji.
|
Powiązane elementy interfejsu API
parentSandboxBridge | właściwość |
parentSandboxBridge:Object| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Obiekt, który może zostać ustawiony przez kod w obszarze izolowanym obiektu ProLoader, aby udostępnić właściwości i metody dla kodu wczytywanej zawartości. Ten most między obszarami izolowanymi umożliwia treści z domeny nieaplikacyjnej uzyskanie kontrolowanego dostępu do skryptów w obszarze izolowanym aplikacji AIR i odwrotnie. Most między obszarami izolowanymi łączy te obszary, pozwalając na jawne interakcje między aplikacyjnymi i nieaplikacyjnymi obszarami izolowanymi zabezpieczeń.
Implementacja
public function get parentSandboxBridge():Object public function set parentSandboxBridge(value:Object):voidZgłasza
SecurityError — Tę właściwość może ustawiać tylko zawartość w obszarze izolowanym obiektu ProLoader.
|
Powiązane elementy interfejsu API
sameDomain | właściwość |
sameDomain:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Wyraża relacje między programem ładującym i zawartością: wartość true, jeżeli posiadają one tą samą domenę źródłową; wartość false w innym przypadku.
Implementacja
public function get sameDomain():BooleanPowiązane elementy interfejsu API
sharedEvents | właściwość |
sharedEvents:EventDispatcher [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Podczas wczytywania zawartości realizującej wstępne wczytywanie współużytkowanych bibliotek czasu wykonywania (RSL, Runtime Shared Library) występują problemy z dopasowaniem czasu, dlatego zalecane jest, aby przed dodaniem detektorów do obiektu sharedEvents zaczekać na odebranie zdarzenia init. Można również dodać detektory ponownie po odebraniu zdarzenia init.
Implementacja
public function get sharedEvents():EventDispatcherPowiązane elementy interfejsu API
swfVersion | właściwość |
swfVersion:uint [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Wersja formatu wczytanego pliku SWF. Format pliku jest określany przez wartość wyliczeniową z klasy SWFVersion, na przykład SWFVersion.FLASH7 oraz SWFVersion.FLASH9.
Implementacja
public function get swfVersion():uintPowiązane elementy interfejsu API
url | właściwość |
url:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Adres URL ładowanych danych.
Przed wywołaniem pierwszego zdarzenia progress przez odpowiedni obiekt ProLoader tego obiektu ProLoaderInfo wartość właściwości url może odzwierciedlać tylko początkowy adres URL określony w wywołaniu metody load() obiektu ProLoader. Po pierwszym wywołaniu zdarzenia progress, właściwość url odzwierciedla ostateczny adres URL nośnika, po rozpoznaniu przekierowań i względnych adresów URL.
W niektórych przypadkach wartość właściwości url jest przycięta; szczegółowe informacje zawiera opis właściwości isURLInaccessible.
Implementacja
public function get url():Stringwidth | właściwość |
width:int [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS5.5 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Nominalna szerokość wczytanego elementu. Wartość ta może się różnić od właściwej szerokości wyświetlanej zawartości, ponieważ załadowana zawartość lub jego nadrzędne obiekty wyświetlane mogą być skalowane.
Implementacja
public function get width():intPowiązane elementy interfejsu API
Tue Jun 12 2018, 12:06 PM Z