| Pakiet | flash.html |
| Klasa | public class HTMLLoader |
| Dziedziczenie | HTMLLoader  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Podklasy | FlexHTMLLoader |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Obsługa profilów AIR: Ta funkcja jest obsługiwana we wszystkich systemach operacyjnych dla komputerów stacjonarnych, ale nie jest obsługiwana na urządzeniach przenośnych ani na urządzeniach telewizyjnych ze środowiskiem AIR. W czasie wykonywania można sprawdzić, czy funkcja jest obsługiwana, odczytując właściwość HTMLLoader.isSupported. 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.
Na komputerach stacjonarnych (w przypadku profilów stacjonarnych i rozszerzonych profilów stacjonarnych) klasa HTMLLoader używa wewnętrznego mechanizmu WebKit środowiska AIR. Dostępne funkcje i wygląd renderowanych materiałów są takie same jak w przypadku klasy StageWebView. Dodatkowo są dostępne ścisła integracja i most skryptów dla języków ActionScript i JavaScript. Klasa StageWebView używa systemowego elementu sterującego do wyświetlania stron internetowych dostarczanego przez wtyczkę Flash Player, dlatego nie jest zalecane równoległe używanie wystąpień klas StageWebView i HTMLLoader, ponieważ nie jest zdefiniowane zachowanie takiej konfiguracji i aplikacja może zostać zamknięta.
Domyślne wymiary HTMLLoader wynoszą 0 x 0 pikseli. Ustaw właściwości width i height, aby obiekt HTMLLoader był widoczny.
Maksymalny rozmiar obiektu HTMLLoader to 4 096 pikseli wysokości i 4 096 pikseli szerokości. Ustawienie właściwości width lub height obiektu HTMLLoader na liczbę większą od 4 095, spowoduje, że obiekt HTMLLoader zgłosi wyjątek ArgumentError. (Maksymalny rozmiar obiektu HTMLLoader w środowisku starszym niż AIR 2 wynosił 2880 pikseli).
Uwaga: Treść SWF osadzona w stronie HTML wyświetlana w oknie przezroczystym musi być osadzona w trybie (wmode) transparent albo opaque. Wartość domyślna właściwości wmode to window, dlatego jeśli nie zostanie jawnie określona, treść SWF może nie być wyświetlana. W systemach Windows i Linux treść SWF zawsze jest wyświetlana nad pozostałą treścią, gdy właściwość wmode jest ustawiona na window lub opaque. Pliki PDF nie mogą być wyświetlane w oknie przezroczystym, niezależnie od ustawienia właściwości wmode.
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 | |
| authenticate : Boolean
Określa, czy żądania uwierzytelnienia powinny być obsługiwane (wartość true) czy nie powinny (wartość false) dla żądań HTTP wydanych przez ten objekt. | HTMLLoader | ||
| 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 | |
| cacheResponse : Boolean
Określa, czy pomyślne odpowiedzi należy zapisać w pamięci podręcznej dla żądań HTTP wydanych przez ten objekt. | HTMLLoader | ||
| constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| contentHeight : Number [tylko do odczytu]
Wysokość treści HTML w pikselach. | HTMLLoader | ||
| contentWidth : Number [tylko do odczytu]
Szerokość treści HTML w pikselach. | HTMLLoader | ||
| 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 | |
| hasFocusableContent : Boolean [tylko do odczytu]
Określa, czy dowolna treść w obiekcie HTMLLoader może być aktywowana. | HTMLLoader | ||
| height : Number [przesłanianie]
Określa wysokość prostokąta renderowanego obszaru roboczego HTML. | HTMLLoader | ||
| historyLength : uint [tylko do odczytu]
Całkowita długość listy historii, w tym wpisów przejść w przód i wstecz. | HTMLLoader | ||
| historyPosition : uint
Bieżące położenie na liście historii. | HTMLLoader | ||
| hitArea : Sprite
Określa ikonkę, która ma pełnić funkcję obszaru naciskania innej ikonki. | Sprite | |
| htmlHost : flash.html:HTMLHost
Obiekt HTMLHost używany do obsługi zmian w zakresie określonych elementów interfejsu użytkownika, takich jak właściwość window.document.title obiektu HTMLLoader. | HTMLLoader | ||
| idleTimeout : Number
Określa limit czasu bezczynności (w milisekundach) dla żądań HTTP wysyłanych przez ten obiekt. | HTMLLoader | ||
| isSupported : Boolean [statyczny] [tylko do odczytu]
Wskazuje, czy klasa HTMLLoader jest obsługiwana w systemie klienckim. | HTMLLoader | ||
| loaded : Boolean [tylko do odczytu]
Określa, czy zdarzenie load JavaScript odpowiadające wcześniejszemu wywołaniu metody load() lub loadString() zostało dostarczone zgodnie ze standardem HTML DOM w obiekcie HTMLLoader. | HTMLLoader | ||
| loaderInfo : LoaderInfo [tylko do odczytu]
Zwraca obiekt LoaderInfo zawierający informacje o ładowaniu pliku, do którego należy ten obiekt wyświetlany. | DisplayObject | |
| location : String [tylko do odczytu]
Adres URL zawartości wczytywanej w obiekcie HTMLLoader. | HTMLLoader | ||
| manageCookies : Boolean
Określa, czy stos protokołu HTTP powinien zarządzać plikami cookie tego obiektu. | HTMLLoader | ||
| 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 | |
| navigateInSystemBrowser : Boolean
Określa, czy nawigacja głównej klatki treści HTML (np. kiedy użytkownik klika odsyłacz po ustawieniu właściwości window.location lub podczas wywoływania window.open()) wywołuje nawigację w obiekcie HTMLLoader (wartość false) lub w domyślnej systemowej przeglądarce sieci Web (wartość true). | HTMLLoader | ||
| 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 | |
| paintsDefaultBackground : Boolean
Określa, czy tło dokumentu HTMLLoader jest nieprzezroczyste białe (wartość true) czy nie (wartość false). | HTMLLoader | ||
| parent : DisplayObjectContainer [tylko do odczytu]
Odnosi się do obiektu DisplayObjectContainer, który zawiera obiekt wyświetlany. | DisplayObject | |
| pdfCapability : int [statyczny] [tylko do odczytu]
Typ obsługi PDF w systemie użytkownika zdefiniowany jako liczba całkowita kodu. | HTMLLoader | ||
| placeLoadStringContentInApplicationSandbox : Boolean
Określa, czy treść załadowana za pomocą metody loadString() jest umieszczana w obszarze izolowanym aplikacji (wartość true) czy w nieaplikacyjnym obszarze izolowanym (wartość false). | HTMLLoader | ||
| 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 | |
| runtimeApplicationDomain : ApplicationDomain
Domena aplikacji używana dla obiektu window.runtime w kodzie JavaScript na stronie HTML. | HTMLLoader | ||
| 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 | |
| scrollH : Number
Położenie przewijania w poziomie treści HTML w obiekcie HTMLLoader. | HTMLLoader | ||
| scrollRect : Rectangle
Granice obszaru przewijania obiektu wyświetlanego. | DisplayObject | |
| scrollV : Number
Położenie przewijania w pionie treści HTML w obiekcie HTMLLoader. | HTMLLoader | ||
| 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 | |
| swfCapability : int [statyczny] [tylko do odczytu]
Typ obsługi SWF w systemie użytkownika zdefiniowany jako liczba całkowita. | HTMLLoader | ||
| 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 | |
| textEncodingFallback : String
Kodowanie znaków stosowane w treści HTMLLoader, jeśli strona HTML nie określa kodowania znaków. | HTMLLoader | ||
| textEncodingOverride : String
Kodowanie znaków stosowane w treści HTMLLoader zastępującedowolne ustawienie na stronie HTML. | HTMLLoader | ||
| 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 | |
| useCache : Boolean
Określa, czy zanim żądania HTTP pochodzące z tego obiektu pobiorą dane, powinien być przeszukiwany bufor lokalny. | HTMLLoader | ||
| 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 | |
| userAgent : String
Ciąg znaków agenta użytkownika użyty we wszystkich nadchodzących żądaniach zawartości pochodzących z tego obiektu HTMLLoader. | HTMLLoader | ||
| visible : Boolean
Decyduje, czy obiekt wyświetlany jest widoczny, czy nie. | DisplayObject | |
| width : Number [przesłanianie]
Określa szerokość prostokąta renderowanego obszaru roboczego HTML. | HTMLLoader | ||
| window : Object [tylko do odczytu]
Globalny obiekt JavaScript dla zawartości wczytywanej do elementu sterującego HTML. | HTMLLoader | ||
| 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 HTMLLoader. | HTMLLoader | ||
|
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 wszystkie trwające operacje wczytywania. | HTMLLoader | ||
|
Decyduje o tym, czy określony obiekt ekranowy jest potomkiem instancji obiektu DisplayObjectContainer, czy też sam jest taką instancją. | DisplayObjectContainer | |
createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):flash.html:HTMLLoader [statyczny]
Tworzy nowy obiekt NativeWindow zawierający obiekt HTMLLoader. | HTMLLoader | ||
|
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 wpis w historii w określonym położeniu. | HTMLLoader | ||
|
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 | |
Powoduje przejście wstecz w historii przeglądania, o ile jest to możliwe. | HTMLLoader | ||
Powoduje przejście do przodu w historii przeglądania, o ile jest to możliwe. | HTMLLoader | ||
Powoduje przejście o określoną liczbę kroków w historii przeglądania. | HTMLLoader | ||
|
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 | |
Ładuje obiekt HTMLLoader z danymi pochodzącymi z serwisu określonego przez parametr urlRequestToLoad. | HTMLLoader | ||
Ładuje obiekt HTMLLoader z treścią HTML zawartą w ciągu znaków HTML. | HTMLLoader | ||
|
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 | |
Ponownie wczytuje stronę z bieżącej lokalizacji. | HTMLLoader | ||
|
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 | |
|
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 | |
| 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, 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 | ||
| Sygnalizuje, że ostatnia operacja ładowania zażądana przez metodę loadString lub load została zakończona. | HTMLLoader | |||
| 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 | ||
| 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 | ||
| Sygnalizuje, że zmieniła się wartość właściwości contentWidth i/lub contentHeight obiektu HTMLLoader. | HTMLLoader | |||
| Sygnalizuje, że obiekt HTML DOM został utworzony w odpowiedzi na operację ładowania. | HTMLLoader | |||
| Sygnalizuje, że renderowanie treści w obiekcie HTMLLoader odbywa się w pełni na bieżąco. | HTMLLoader | |||
| 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 | ||
| Sygnalizuje, że zmieniła się wartość właściwości location obiektu HTMLLoader. | HTMLLoader | |||
| Sygnalizuje, że zmieniła się wartość właściwości location obiektu HTMLLoader. | HTMLLoader | |||
| Sygnalizuje nadchodzącą zmianę właściwości „location” obiektu HTMLLoader. | HTMLLoader | |||
| 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 | ||
| 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, 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 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 | ||
| Sygnalizuje, że właciowość scrollH lub scrollV została zmieniona przez obiekt HTMLLoader. | HTMLLoader | |||
| 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, 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 | ||
| Sygnalizuje, że nieprzechwycony wyjątek JavaScript pojawił się w obiekcie HTMLLoader. | HTMLLoader | |||
authenticate | właściwość |
authenticate:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Określa, czy żądania uwierzytelnienia powinny być obsługiwane (wartość true) czy nie powinny (wartość false) dla żądań HTTP wydanych przez ten objekt. Jeśli wartość to false, uwierzytelnianie zwróci błąd HTTP.
Wartością domyślną jest initialized from URLRequestDefaults.authenticate.
Implementacja
public function get authenticate():Boolean public function set authenticate(value:Boolean):voidPowiązane elementy interfejsu API
cacheResponse | właściwość |
cacheResponse:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Określa, czy pomyślne odpowiedzi należy zapisać w pamięci podręcznej dla żądań HTTP wydanych przez ten objekt. Po ustawieniu wartości true obiekt HTMLLoader korzysta z pamięci podręcznej HTTP systemu operacyjnego.
Wartością domyślną jest initialized from URLRequestDefaults.cacheResponse.
Implementacja
public function get cacheResponse():Boolean public function set cacheResponse(value:Boolean):voidPowiązane elementy interfejsu API
contentHeight | właściwość |
contentHeight:Number [tylko do odczytu] | Wersje środowiska wykonawczego: | AIR 1.0 |
Wysokość treści HTML w pikselach. Ta właściwość może się zmienić podczas zmiany wymiarów obiektu HTMLLoader. Na przykład, strona HTML często zużywa całą wyskość obiektu HTMLLoader, a właściwość contentHeight może się zmienić w przypadku zmiany wysokości obiektu HTMLLoader.
Implementacja
public function get contentHeight():Number contentWidth | właściwość |
contentWidth:Number [tylko do odczytu] | Wersje środowiska wykonawczego: | AIR 1.0 |
Szerokość treści HTML w pikselach. Ta właściwość może się zmienić podczas zmiany wymiarów obiektu HTMLLoader. Na przykład, strona HTML często zużywa całą szerokość obiektu HTMLLoader, a właściwość contentWidth może się zmienić w przypadku zmiany szerokości obiektu HTMLLoader.
Implementacja
public function get contentWidth():Number hasFocusableContent | właściwość |
height | właściwość |
height:Number[przesłanianie] | Wersje środowiska wykonawczego: | AIR 1.0 |
Określa wysokość prostokąta renderowanego obszaru roboczego HTML. Ta wartość właściwości stanowi wysokość obiektu wyświetlania HTMLLoader w pikselach. Maksymalna wartość height wynosi 4 095 pikseli. Zmiana tej właściwości powoduje ponowne renderowanie dokumentu HTML przez obiekt HTMLLoader. Zdarzenie htmlBoundsChanged może być wywołane na skutek zmiany tej właściwości.
Po ustawieniu właściwości width i height obiektu HTMLLoader granice obiektu zostaną zmienione, ale treść nie jest skalowana (tak jak w przypadku innych typów obiektów wyświetlania).
Implementacja
override public function get height():Number override public function set height(value:Number):void historyLength | właściwość |
historyLength:uint [tylko do odczytu] | Wersje środowiska wykonawczego: | AIR 1.0 |
Całkowita długość listy historii, w tym wpisów przejść w przód i wstecz. Ta właściwość zawiera taką samą wartość, co właściwość window.history.length JavaScript strony HTML.
Implementacja
public function get historyLength():uintPowiązane elementy interfejsu API
historyPosition | właściwość |
historyPosition:uint| Wersje środowiska wykonawczego: | AIR 1.0 |
Bieżące położenie na liście historii. Lista historii odpowiada obiektowi window.history strony HTML. Wpisy o indeksie mniejszym niż bieżące położenie należą do list „wstecz", a wpisy późniejsze do listy „dalej”. Próby ustawienia położenia wykraczającego poza koniec powodują ustawienie w położeniu końcowym.
Implementacja
public function get historyPosition():uint public function set historyPosition(value:uint):voidPowiązane elementy interfejsu API
htmlHost | właściwość |
htmlHost:flash.html:HTMLHost| Wersje środowiska wykonawczego: | AIR 1.0 |
Obiekt HTMLHost używany do obsługi zmian w zakresie określonych elementów interfejsu użytkownika, takie jak właściwość window.document.title obiektu HTMLLoader. Aby przesłonić domyślne zachowanie obiektu HTMLLoader, należy utworzyć podklasę dla klasy HTMLHost i przesłonić należące do niej funkcje w celu obsługi różnych zmian interfejsu użytkownika w treści HTML.
Implementacja
public function get htmlHost():flash.html:HTMLHost public function set htmlHost(value:flash.html:HTMLHost):voidPowiązane elementy interfejsu API
idleTimeout | właściwość |
idleTimeout:Number| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2 |
Określa limit czasu bezczynności (w milisekundach) dla żądań HTTP wysyłanych przez ten obiekt.
Limit czasu bezczynności to czas, przez jaki klient czeka na odpowiedź z serwera po nawiązaniu połączenia, zanim zrezygnuje z żądania.
Wartością domyślną jest initialized from URLRequestDefaults.idleTimeout.
Implementacja
public function get idleTimeout():Number public function set idleTimeout(value:Number):voidPowiązane elementy interfejsu API
isSupported | właściwość |
loaded | właściwość |
loaded:Boolean [tylko do odczytu] | Wersje środowiska wykonawczego: | AIR 1.0 |
Określa, czy zdarzenie load JavaScript odpowiadające wcześniejszemu wywołaniu metody load() lub loadString() zostało dostarczone zgodnie ze standardem HTML DOM w obiekcie HTMLLoader. Ta właściwość ma wartość true przed wywołaniem zdarzenia complete. Ta właściwość może nigdy nie mieć wartościtrue. Ma to miejsce w takich samych sytuacjach, kiedy zdarzenie complete nigdy nie zostaje dostarczone.
Implementacja
public function get loaded():Boolean location | właściwość |
manageCookies | właściwość |
manageCookies:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Określa, czy stos protokołu HTTP powinien zarządzać plikami cookie tego obiektu. W przypadku wartości true pliki cookie są dodawane do żądania, a pliki cookie uzyskane w odpowiedzi zapamiętywane. W przypadku wartości false pliki cookie nie są dodawane do żądania, a pliki cookie uzyskane w odpowiedzi nie są zapamiętywane.
Wartością domyślną jest initialized from URLRequestDefaults.manageCookies.
Implementacja
public function get manageCookies():Boolean public function set manageCookies(value:Boolean):voidPowiązane elementy interfejsu API
navigateInSystemBrowser | właściwość |
navigateInSystemBrowser:Boolean| Wersje środowiska wykonawczego: | AIR 1.0 |
Określa, czy nawigacja głównej klatki treści HTML (np. kiedy użytkownik klika odsyłacz po ustawieniu właściwości window.location lub podczas wywoływania window.open()) wywołuje nawigację w obiekcie HTMLLoader (wartość false) lub w domyślnej systemowej przeglądarce sieci Web (wartość true). Ustaw wartość true dla tej właściwości, jeśli nawigacja ma mieć miejsce w systemowej przeglądarce sieci Web (nie w obiekcie HTMLLoader).
Wartością domyślną jest false.
Implementacja
public function get navigateInSystemBrowser():Boolean public function set navigateInSystemBrowser(value:Boolean):void paintsDefaultBackground | właściwość |
paintsDefaultBackground:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Określa, czy tło dokumentu HTMLLoader jest nieprzezroczyste białe (wartość true) czy nie (wartość false). Jeśli dla tej właściwości zostanie ustawiona wartość false, obiekt HTMLLoader używa własnego kontenera obiektu wyświetlania jako tła dla HTML oraz korzysta z krycia·(wartość alpha) kontenera obiektu wyświetlkania jako tła HTML. Jednak jeśli element body lub dowolny inny element dokumentu HTML zawiera nieprzezroczysty kolor tła (określony na przykład przez style="background-color:gray"), wówczas ta sekcja renderowanego HTML korzysta z określonego nieprzezroczystego koloru tła.
Implementacja
public function get paintsDefaultBackground():Boolean public function set paintsDefaultBackground(value:Boolean):void pdfCapability | właściwość |
pdfCapability:int [tylko do odczytu] | Wersje środowiska wykonawczego: | AIR 1.0 |
Typ obsługi PDF w systemie użytkownika zdefiniowany jako liczba całkowita kodu. Obiekt HTMLLoader jest w stanie·wyświetlić treść PDF, wyłącznie·jeśli analiza właściwości daje w wartość·PDFCapability.STATUS_OK. Klasa PDFCapability definiuje stałe możliwe wartości właściwości pdfCapability w następujący sposób:
| stała PDFCapability | Znaczenie |
|---|---|
STATUS_OK | Została wykryta wystarczająca wersja (8.1 lub późniejsza) programu Acrobat i Adobe Reader i można załadować treść PDF do obiektu HTMLLoader.
Uwaga: Jeśli w systemie Windows uruchomiony jest program Acrobat lub Adobe Reader w wersji 7.x w systemie użytkownika, zostanie użyta ta wersja programu, nawet jeśli zainstalowano późniejszą wersję obsługująca ładowanie PDF załadowanego do obiektu HTMLLoader. W takim przypadku jeśli wartość właściwości |
ERROR_INSTALLED_READER_NOT_FOUND | Nie wykryto żadnej wersji programu Acrobat lub Adobe Reader. Obiekt HTMLLoader nie może wyświetlić treści PDF. |
ERROR_INSTALLED_READER_TOO_OLD | Wykryto program Acrobat lub Adobe Reader, ale wersja jest za stara. Obiekt HTMLLoader nie może wyświetlić zawartości PDF. |
ERROR_PREFERED_READER_TOO_OLD | Została wykryta wystarczająca wersja programu Adobe Reader lub Acrobat (8.1 lub późniejsza), ale wersja skonfigurowana do obsługi treści PDF jest strasza niż 8.1. Obiekt HTMLLoader nie może wyświetlić treści PDF. |
Implementacja
public static function get pdfCapability():intPowiązane elementy interfejsu API
placeLoadStringContentInApplicationSandbox | właściwość |
placeLoadStringContentInApplicationSandbox:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.5 |
Określa, czy treść załadowana za pomocą metody loadString() jest umieszczana w obszarze izolowanym aplikacji (wartość true) czy w nieaplikacyjnym obszarze izolowanym (wartość false).
Jeśli ta właściwość jest ustawiona na wartość false, treść załadowana za pomocą metody loadString() jest umieszczana w nieaplikacyjnym obszarze izolowanym o następujących cechach:
- Obszar izolowany ma dostęp z sieci do ładowanej treści (ale nie z systemu plików).
- Obszar izolowany nie może ładować danych za pomocą XMLHttpRequest.
- Właściwość
window.locationma wartość"about:blank". - Treść nie może mieć dostępu do właściwości
window.runtime(analogicznie treść w dowolnym nieaplikacyjnym obszarze izolowanym).
Jeśli ta właściwość jest ustawiona na wartość true, treść załadowana za pomocą metody loadString() jest umieszczana w obszarze izolowanym aplikacji z dostępem do właściwości window.runtime oraz wszystkich interfejsów API środowiska AIR. Należy upewnić się, że źródło danych dla ciągu znaków użyte w wywołaniu metody loadString() jest zaufane. Instrukcje kodu w ciągu znaków HTML są wykonywane z pełnymi uprawnieniami aplikacji, jeśli ta właściwość ma wartość true. Tę właściwość należy ustawić na wartość true tylko wtedy, gdy użytkownik ma pewność, że ciąg znaków nie zawiera szkodliwego kodu.
W aplikacjach skompilowanych za pomocą programu AIR 1.0 SDK lub AIR 1.1 SDK treść załadowana za pomocą metody loadString() jest umieszczana w obszarze izolowanym aplikacji.
Wartością domyślną jest false.
Implementacja
public function get placeLoadStringContentInApplicationSandbox():Boolean public function set placeLoadStringContentInApplicationSandbox(value:Boolean):voidPowiązane elementy interfejsu API
runtimeApplicationDomain | właściwość |
runtimeApplicationDomain:ApplicationDomain| Wersje środowiska wykonawczego: | AIR 1.0 |
Domena aplikacji używana dla obiektu window.runtime w języku JavaScript na stronie HTML.
W przypadku wartości·null lub jeśli treść HTML pochodzi z innej domeny zabezpieczeń niż treść SWF zawierająca obiekt HTMLLoader, strona korzysta z domyślnej domeny aplikacji dla swojej·domeny.
Implementacja
public function get runtimeApplicationDomain():ApplicationDomain public function set runtimeApplicationDomain(value:ApplicationDomain):voidZgłasza
SecurityError — jeśli obiekt ApplicationDomain nie pochodzi z domeny zabezpieczeń wywołującego.
|
Powiązane elementy interfejsu API
scrollH | właściwość |
scrollV | właściwość |
swfCapability | właściwość |
swfCapability:int [tylko do odczytu] | Wersje środowiska wykonawczego: | AIR 2 |
Typ obsługi SWF w systemie użytkownika zdefiniowany jako liczba całkowita. Obiekt HTMLLoader jest w stanie wyświetlić treść SWF tylko wtedy, gdy właściwość ta ma wartość HTMLSWFCapability.STATUS_OK. Klasa HTMLSWFCapability definiuje możliwe stałe wartości właściwości swfCapability w następujący sposób:
| Stała HTMLSWFCapability | Znaczenie |
|---|---|
STATUS_OK | Została wykryta wystarczająca wersja programu Adobe Flash Player i można załadować treść SWF do obiektu HTMLLoader. |
ERROR_INSTALLED_PLAYER_NOT_FOUND | Nie wykryto żadnej wersji programu Adobe Flash Player. Obiekt HTMLLoader nie może wyświetlić treści SWF. |
ERROR_INSTALLED_PLAYER_TOO_OLD | Wykryto program Adobe Flash Player, ale wersja jest za stara. Obiekt HTMLLoader nie może wyświetlić zawartości SWF. |
Implementacja
public static function get swfCapability():intPowiązane elementy interfejsu API
textEncodingFallback | właściwość |
textEncodingFallback:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Kodowanie znaków stosowane w treści HTMLLoader, jeśli strona HTML nie określa kodowania znaków. Strona HTML określa kodowanie znaków w znaczniku meta zgodnie z poniższym:
<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">
Wartości zdefiniowane na liście IANA poprawnych zbiorów znaków.
Jeśli strona HTML, właściwość textEncodingFallback lub właściwość textEncodingOverride nie określa kodowania, treść HTML korzysta z kodowania ISO-8859-1.
Implementacja
public function get textEncodingFallback():String public function set textEncodingFallback(value:String):voidPowiązane elementy interfejsu API
textEncodingOverride | właściwość |
textEncodingOverride:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Kodowanie znaków stosowane w treści HTMLLoader zastępującedowolne ustawienie na stronie HTML. Strona HTML określa kodowanie znaków w znaczniku meta zgodnie z poniższym:
<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">
To ustawienie zastępujerównież dowolne ustawienie właściwości textEncodingFallback.
Wartości zdefiniowane na liście IANA poprawnych zbiorów znaków.
Ustaw właściwość textEncodingOverride po załadowaniu treści HTML, tak aby aplikacja AIR odświeżała treść HTML za pomocą określonego kodowania. Po przejściu obiektu HTMLLoader na nową stronę należy ponownie ustawić właściwość, jeśli na nowej stronie ma być stosowane określone kodowanie.
Jeśli strona HTML, właściwość textEncodingFallback lub właściwość textEncodingOverride nie określa kodowania, zawartość HTML korzysta z kodowania ISO-8859-1.
Ustawienia wartości null dla właściwości textEncodingOverride powoduje przywrócenie zachowania domyślnego.
Implementacja
public function get textEncodingOverride():String public function set textEncodingOverride(value:String):voidPowiązane elementy interfejsu API
useCache | właściwość |
useCache:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Określa, czy zanim żądania HTTP wydane przez ten obiekt pobiorą dane, powinna być przeszukiwana lokalna pamięć podręczna.
Wartością domyślną jest initialized from URLRequestDefaults.useCache.
Implementacja
public function get useCache():Boolean public function set useCache(value:Boolean):voidPowiązane elementy interfejsu API
userAgent | właściwość |
userAgent:String| Wersje środowiska wykonawczego: | AIR 1.0 |
Ciąg znaków agenta użytkownika użyty we wszystkich nadchodzących żądaniach treści z tego obiektu HTMLLoader.
Aby ustawić ciąg znaków agenta użytkownika, należy ustawić właściwość userAgent obiektu HTMLLoader przed wywołaniem metody load(). Właściwość userAgent obiektu URLRequest przekazana do metody load() nie jest używana.
Istnieje możliwość ustawienia domyślnego ciągu znaków agenta użytkownika używanego przez wszystkie obiekty HTMLLoader w domenie aplikacji poprzez ustawienie właściwości URLRequestDefaults.userAgent. Jeśli dla właściwości userAgent obiektu HTMLLoader nie została ustawiona żadna wartość (lub ustawiona wartość to null), dla ciągu·znaków użytkownika zostaje ustawina wartość właściwości statycznej URLRequestDefaults.userAgent.
Jeśli ustawioną wartością nie jest właściwość userAgent obiektu HTML ani URLRequestDefaults.userAgent, jako ciąg znaków agenta użytkownika zostaje użyta wartość domyśla. Ta domyślna wartość różni się w zależności od systemu operacyjnego środowiska wykonania (np. Mac OS, Linux lub Windows), jego języka oraz wersji tak, jak przedstawiono to w dwóch poniższych przykładach:
"Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5""Mozilla/5.0 (Windows; U; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5""Mozilla/5.0 (X11; U; Linux i686; en-US) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
Implementacja
public function get userAgent():String public function set userAgent(value:String):voidPowiązane elementy interfejsu API
width | właściwość |
width:Number[przesłanianie] | Wersje środowiska wykonawczego: | AIR 1.0 |
Określa szerokość prostokąta renderowanego obszaru roboczego HTML. Jest to szerokość obiektu wyświetlania HTMLLoader w pikselach. Maksymalna wartość width wynosi 4 095 pikseli. Zmiana tej właściwości powoduje ponowne renderowanie dokumentu HTML przez obiekt HTMLLoader. Zdarzenie htmlBoundsChange może być wywołane na skutek zmiany tej właściwości. Po ustawieniu właściwości width i height obiektu HTMLLoader granice obiektu zostaną zmienione, ale treść nie jest skalowana (tak jak w przypadku innych typów obiektów wyświetlania).
Implementacja
override public function get width():Number override public function set width(value:Number):void window | właściwość |
HTMLLoader | () | Konstruktor |
public function HTMLLoader()| Wersje środowiska wykonawczego: | AIR 1.0 |
Tworzy obiekt HTMLLoader.
cancelLoad | () | metoda |
public function cancelLoad():void| Wersje środowiska wykonawczego: | AIR 1.0 |
Anuluje wszystkie trwające operacje ładowania.
createRootWindow | () | metoda |
public static function createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):flash.html:HTMLLoader| Wersje środowiska wykonawczego: | AIR 1.0 |
Tworzy nowy obiekt NativeWindow zawierający obiekt HTMLLoader. Użyj obiektu HTMLLoader zwróconego przez tę metodę w celu załadowania treści HTML.
Domyślnie (jeśli podczas wywoływania metody nie zostaną ustawione żadne parametry) okno korzysta ze standardowej systemowej karnacji i uwzględnia w treści elementy sterowania pasków przewijania. Istnieje możliwość ustawienia parametrów w celu zmiany właściwości nowego okna.
W trakcie ładowania treści i stosowania arkuszy stylów w oknie mogą występować drobne niedoskonałości grafiki. Aby takie nieciągłości nie były widoczne, należy ustawić parametr visible na wartość false. Po załadowaniu okna i ułożeniu jego treści można je uwidocznić, przypisując właściwości window.nativeWindow.visible wartość true lub wywołując metodę window.nativeWindow.activate().
Parametry
visible:Boolean (default = true) | |
windowInitOptions:NativeWindowInitOptions (default = null)null korzysta z wartości NativeWindowInitOptions.
| |
scrollBarsVisible:Boolean (default = true) | |
bounds:Rectangle (default = null)null określa granice okna. Jeśli dowolna właściwość x, y, width lub height to NaN, wówczas odpowiadajace wymiary okna zachowują swoje wartości domyślne.
|
flash.html:HTMLLoader — Nowy obiekt HTMLLoader znajdujący się na stole montażowym nowego obiektu NativeWindow.
|
getHistoryAt | () | metoda |
public function getHistoryAt(position:uint):flash.html:HTMLHistoryItem| Wersje środowiska wykonawczego: | AIR 1.0 |
Zwraca wpis w historii w określonym położeniu.
Parametry
position:uint — Położenie na liście historii.
|
flash.html:HTMLHistoryItem — Obiekt URLRequest dla wpisu w historii w określonym położeniu.
|
Powiązane elementy interfejsu API
historyBack | () | metoda |
public function historyBack():void| Wersje środowiska wykonawczego: | AIR 1.0 |
Powoduje przejście wstecz w historii przeglądania, o ile jest to możliwe.
Wywołanie tej metody obiektu HTMLLoader ma taki sam skutek co wywołanie metody back() właściwości window.history w języku JavaScript na stronie HTML.
Ta funkcja nie zgłasza wyjątków.
Powiązane elementy interfejsu API
historyForward | () | metoda |
public function historyForward():void| Wersje środowiska wykonawczego: | AIR 1.0 |
Powoduje przejście do przodu w historii przeglądania, o ile jest to możliwe.
Wywołanie tej metody obiektu HTMLLoader ma taki sam skutek co wywołanie metody forward() właściwości window.history w języku JavaScript na stronie HTML.
Ta funkcja nie zgłasza wyjątków.
Powiązane elementy interfejsu API
historyGo | () | metoda |
public function historyGo(steps:int):void| Wersje środowiska wykonawczego: | AIR 1.0 |
Powoduje przejście o określoną liczbę kroków w historii przeglądania. Powoduje przejście do przodu w przypadku liczby dodatniej lub wstecz w przypadku liczby ujemnej. Przejście przy wartości zerowej wymusza ponowne ładowanie.
Ta metoda jest równoważna z wywołaniem metody go() właściwości window.history w języku JavaScript na stronie HTML.
Ta funkcja nie zgłasza wyjątków.
Parametry
steps:int — Liczba kroków na liście historii, o jaką nastąpi przeniesienie w przód (liczba dodatnia) lub wstecz (liczba ujemna).
|
Powiązane elementy interfejsu API
load | () | metoda |
public function load(urlRequestToLoad:URLRequest):void| Wersje środowiska wykonawczego: | AIR 1.0 |
Ładuje obiekt HTMLLoader z danymi pochodzącymi z serwisu określonego przez parametr urlRequestToLoad. Wywołanie tej metody powoduje wstępne·ustawienie wartości false dla właściwości loaded. Ta metoda inicjuje operację, która zawsze kończy się asynchronicznie.
Wywołanie tej metody niejawnie anuluje wszystkie wcześniejsze oczekujące operacje ładowania rozpoczęte za pomocą tej metody lub metody loadString(). Zdarzenie complete wcześniejszej operacji ładowania nigdy nie zostanie dostarczone.
Zdarzenie complete może nie być nigdy dostarczone. Taka sytuacja ma miejsce, jeśli treść HTML załadowana do obiektu HTMLLoader nie zostanie całkowicie pobrana. Taka sytuacja ma miejsce, jeśli treść HTML odwołuje adres URL do sktyptu CGI, który wielokrotnie, w nieskończoność generuje treść.
Parametry
urlRequestToLoad:URLRequest — Obiekt URLRequest zawiarający informacje na temat adresu URL do załadowania. Oprócz adresu do załadowania, obiekt URLRequest zawiera właściwości definiujące metodę dostarczania formularza HTTP (GET lub POST), dane, które będą przekazane z żądaniem oraz nagłówki z żądaniami.
|
Powiązane elementy interfejsu API
loadString | () | metoda |
public function loadString(htmlContent:String):void| Wersje środowiska wykonawczego: | AIR 1.0 |
Ładuje obiekt HTMLLoader z treścią HTML zawartą w ciągu znaków HTML. Po zakończeniu renderowania treści HTML w ciągu znaków zostaje wywołane zdarzenie complete. Zdarzenie complete jest zawsze wywoływane asynchronicznie.
Wywołanie tej metody niejawnie anuluje wszystkie wcześniejsze oczekujące operacje ładowania rozpoczęte za pomocą tej metody lub metody load(). Zdarzenie complete wcześniejszej operacji wczytywania nigdy nie zostanie dostarczone.
Jeśli HTML określony w ciągu znaków nie zawiera odwołań do zasobów zewnętrznych, wówczas ta metoda synchronicznie renderuje HTML. Jednk zdarzenie complete jest w dalszym ciągu wywoływane asynchronicznie. Jeśli właściwość loaded tej klasy następująca bezpośrednio po wywołaniu tej funkcji stanowi wartość true, treść HTML określona w argumencie htmlContent była renderowana synchronicznie.
Zdarzenie complete może nie być nigdy dostarczone. Taka sytuacja ma miejsce, jeśli treść HTML załadowana do obiektu HTMLLoader nie zostanie całkowicie pobrana. Taka sytuacja ma miejsce, jeśli treść HTML odwołuje adres URL do sktyptu CGI, który wielokrotnie, w nieskończoność generuje treść.
Treść załadowana za pomocą metody loadString() jest umieszczana w obszarze izolowanym aplikacji tylko wtedy, gdy właściwość placeLoadStringContentInApplicationSandbox ma wartość true.
Parametry
htmlContent:String — Ciąg znaków zawierający treść HTML w celu załadowania do obiektu HTMLLoader.
|
Powiązane elementy interfejsu API
reload | () | metoda |
public function reload():void| Wersje środowiska wykonawczego: | AIR 1.0 |
Ponownie ładuje stronę z bieżącego położenia.
complete | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.COMPLETE| Wersje środowiska wykonawczego: | AIR 1.0 |
Sygnalizuje, że ostatnia operacja ładowania zażądana przez metodę loadString lub load została zakończona. Zdarzenie zostaje wywołanie po wywołaniu zdarzenia load JavaScript zgodnie ze standardem HTML DOM w obiekcie HTMLLoader. To zdarzenie jest zawsze wywoływane asynchronicznie. Moduł obsługi zdarzeń tego zdarzenia może wywołać dowolną metodę lub uzyskać dostęp do dowolnej właściwości obiektu HTMLLoader.
Event.COMPLETE definiuje wartość właściwości type obiektu zdarzenia complete.
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 sieciowy, którego ładowanie zostało ukończone. |
Powiązane elementy interfejsu API
htmlBoundsChange | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.HTML_BOUNDS_CHANGE| Wersje środowiska wykonawczego: | AIR 1.0 |
Sygnalizuje, że zmieniła się wartość właściwości contentWidth i/lub contentHeight obiektu HTMLLoader. Może być to spowodowane na przykład nowym obrazem lub inną operacją ładowania treści. Moduły obsługi zdarzeń mogą wywołać dowolną metodę lub uzyskać dostęp do dowolnej właściwości obiektu HTMLLoader.
Obiekt HTMLLoader może wywołać to zdarzenie w dowolnej chwili po zainicjowaniu operacji wczytywania, nawet po wywołaniu zdarzenia complete.
Event.HTML_BOUNDS_CHANGE definiuje wartość właściwości type obiektu zdarzenia htmlBoundsChange.
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 HTMLLoader. |
target | Obiekt HTMLLoader. |
Powiązane elementy interfejsu API
htmlDOMInitialize | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.HTML_DOM_INITIALIZE| Wersje środowiska wykonawczego: | AIR 1.0 |
Sygnalizuje, że obiekt HTML DOM został utworzony w odpowiedzi na operację ładowania. Metody load() i loadString() obiektu HTMLLoader zgłaszają wyjątki podczas wywoływania tego zadarzenia. Każda właściwość lub metoda dowolnego obiektu JavaScript dostępna z właściwości window obiektu HTMLLoader sterująca ładowaniem adresu URL w obiekcie HTMLLoader zgłasza wyjątek w przypadku ustawiania lub wywoływania podczas wywoływania tego zdarzenia. Na przykład, ustawienie window.location poprzez ustawienie właściowości window obiektu HTMLLoader powoduje wyjątek JavaScript.
Event.HTML_DOM_INITIALIZE definiuje wartość właściwości type obiektu zdarzenia htmlDOMInitialize.
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 HTMLLoader. |
target | Obiekt HTMLLoader. |
Powiązane elementy interfejsu API
htmlRender | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.HTML_RENDER| Wersje środowiska wykonawczego: | AIR 1.0 |
Sygnalizuje, że renderowanie treści w obiekcie HTMLLoader odbywa się w pełni na bieżąco. To zdarzenie może być wywoływne stosunkowo często — każdorazowo po zmianie w wyniku renderowania treści HTML. Na przykład, to zdarzenie jest wywoływane po wyświetleniu nowej treści spowodownej kliknięciem przez użytkownika odnośnika lub po renderowaniu HTML przez JavaScript. Detektory zdarzeń mogą wywołać dowolną metodę lub uzyskać dostęp do dowolnej właściwości obiektu HTMLLoader.
Moduły obsługi tego zdarzenia powinny sprawdzić właściwości contentWidth i contentHeight obiektu HTMLLoader, aktualizując wszystkie skojarzone paski przewijania.
Obiekt HTMLLoader może wywołać to zdarzenie w dowolnej chwili po zainicjowaniu operacji ładowania, nawet po wywołaniu zdarzenia complete.
Event.HTML_RENDER definiuje wartość właściwości type obiektu zdarzenia htmlRender.
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 HTMLLoader. |
target | Obiekt HTMLLoader. |
locationChange | Zdarzenie |
flash.events.LocationChangeEventwłaściwość LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGE| Wersje środowiska wykonawczego: | AIR 2.7 |
Sygnalizuje, że zmieniła się wartość właściwości location obiektu HTMLLoader. Moduł obsługi zdarzeń tego zdarzenia może wywołać dowolną metodę lub uzyskać dostęp do dowolnej właściwości obiektu HTMLLoader.
Zdarzenie locationChange typu LocationChangeEvent jest wywoływane przez obiekt HTMLLoader w aplikacjach używających przestrzeni nazw środowiska AIR 2.7 lub nowszego. We wcześniejszych wersjach środowiska AIR obiekt wywoływanego zdarzenia był wystąpieniem klasy Event.
Powiązane elementy interfejsu API
locationChange | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.LOCATION_CHANGE| Wersje środowiska wykonawczego: | AIR 1.0 |
Sygnalizuje, że zmieniła się wartość właściwości location obiektu HTMLLoader. Moduł obsługi zdarzeń tego zdarzenia może wywołać dowolną metodę lub uzyskać dostęp do dowolnej właściwości obiektu HTMLLoader.
Zdarzenie locationChange typu Event jest wywoływane przez obiekt HTMLLoader w aplikacjach używających przestrzeni nazw środowiska AIR w wersji starszej niż 2.7. W środowisku AIR 2.7 lub nowszym obiekt zdarzenia jest wystąpieniem klasy LocationChangeEvent, co zapewnia dodatkową właściwość location zawierającą adres URL nowej strony.
Event.LOCATION_CHANGE definiuje wartość właściwości type obiektu zdarzenia locationChange.
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 HTMLLoader. |
target | Obiekt HTMLLoader. |
Powiązane elementy interfejsu API
locationChanging | Zdarzenie |
flash.events.LocationChangeEventwłaściwość LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGING| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2.7 |
Sygnalizuje nadchodzącą zmianę właściwości location obiektu HTMLLoader.
Zdarzenie locationChanging jest wywoływane tylko wtedy, gdy zmiana lokalizacji jest inicjowana przez działanie użytkownika, na przykład w przypadku kliknięcia łącza przez użytkownika, lub kodu uruchomionego w obiekcie HTMLLoader, na przykład w przypadku przekierowania po stronie klienta. Domyślnie nowa lokalizacja jest wyświetlana w tym obiekcie HTMLLoader. Istnieje możliwość wywołania metody preventDefault() obiektu zdarzenia w celu anulowania tego zachowania. Można na przykład użyć funkcji flash.net.navigateToURL(), aby otworzyć stronę w przeglądarce systemu na podstawie właściwości location obiektu zdarzenia.
Zdarzenie locationChanging() nie jest wywoływane w przypadku wywołania jednej z następujących metod:
- load()
- loadString()
- reload()
- historyBack()
- historyForward()
- historyGo()
To zdarzenie nie jest też wywoływane, gdy właściwość navigateInSystemBrowser ma wartość true, a także w przypadku otwarcia strony docelowej w przeglądarce systemowej, gdyż nie powoduje to zmiany lokalizacji obiektu HTMLLoader.
LOCATION_CHANGING definiuje wartość właściwości type obiektu LocationChangeEvent wywoływanego przed zmianą położenia strony.
Przykład ( Sposób korzystania z tego przykładu )
package{
import flash.display.Sprite;
import flash.html.HTMLLoader;
import flash.net.URLRequest;
public class LocationChanging extends Sprite
{
var htmlLoader:HTMLLoader = new HTMLLoader();
public function LocationChanging()
{
htmlLoader.width = stage.stageWidth;
htmlLoader.height = stage.stageHeight;
htmlLoader.addEventListener( LocationChangeEvent.LOCATION_CHANGING, onLocationChanging );
htmlLoader.load( new URLRequest( "http://www.adobe.com" ) );
this.addChild( htmlLoader );
}
private function onLocationChanging( event:LocationChangeEvent ):void
{
trace( "Location changing: " + event.location );
if ( event.location.indexOf( "http://www.adobe.com" ) < 0 )
{
event.preventDefault();
}
}
}
}
scroll | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.SCROLL| Wersje środowiska wykonawczego: | AIR 1.0 |
Sygnalizuje, że właściwość scrollH lub scrollV została zmieniona przez obiekt HTMLLoader. Obiekt HTMLLoader wywołuje to zdarzenie po tym jak JavaScript działający w obiekcie HTMLLoader wywoła metodę scrollTo() obiektu window i żądane położenie nie jest już widoczne. Zdarzenie nie jest wywoływane po zmianie właściwości scrollH lub scrollV przez kod ActionScript. Moduły obsługi zdarzeń mogą wywołać dowolną metodę lub uzyskać dostęp do dowolnej właściwości obiektu HTMLLoader.
Moduły obsługi zdarzeń tego zdarzenia sprawdzają właściwości scrollH i scrollV, przeprowadzając aktualizację wszystkich pasków przewijania skojarzonych z obiektem HTMLLoader.
Obiekt HTMLLoader może wywołać to zdarzenie w dowolnej chwili po zainicjowaniu operacji wczytywania, nawet po wywołaniu zdarzenia complete.
Event.SCROLL definiuje wartość właściwości type obiektu zdarzeniascroll.
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 TextField, który został przewinięty. Właściwość target nie zawsze jest obiektem na liście wyświetlania, który zarejestrował detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
uncaughtScriptException | Zdarzenie |
flash.events.HTMLUncaughtScriptExceptionEventwłaściwość HTMLUncaughtScriptExceptionEvent.type =
flash.events.HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION| Wersje środowiska wykonawczego: | AIR 1.0 |
Sygnalizuje, że nieprzechwycony wyjątek JavaScript pojawił się w obiekcie HTMLLoader. Moduły obsługi zdarzeń mogą wywołać dowolną metodę lub uzyskać dostęp do dowolnej właściwości obiektu HTMLLoader. Zdarzenie można anulować, a domyślnym zachowaniem podczas uruchamiania aplikacji AIR Debug Launcher jest wysyłanie stosu JavaScript w postaci wyników śledzenia.
StałaHTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION definiuje wartość właściwości type obiektu zdarzenia uncaughtScriptException.
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ć. |
exceptionValue | Wynik obliczenia wyrażenia w instrukcji throw, która wygenerowała nieprzechwycony wyjątek. |
stackTrace | Tablica obiektów reprezentująca zapis stosu z chwili wykonania instrukcji throw, która wygenerowała nieprzechwycony wyjątek. |
target | Obiekt HTMLLoader. |
Powiązane elementy interfejsu API
package {
import flash.display.Sprite;
import flash.html.HTMLLoader;
import flash.net.URLRequest;
public class HTMLLoaderExample extends Sprite
{
public function HTMLLoaderExample()
{
var html:HTMLLoader = new HTMLLoader();
var urlReq:URLRequest = new URLRequest("http://www.adobe.com/");
html.width = stage.stageWidth;
html.height = stage.stageHeight;
html.load(urlReq);
addChild(html);
}
}
}
Tue Jun 12 2018, 12:06 PM Z