| Pakiet | flash.events |
| Klasa | public class BrowserInvokeEvent |
| Dziedziczenie | BrowserInvokeEvent  Event Object |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
browserInvoke, gdy aplikacja zostaje wywołana w wyniku otwarcia pliku SWF w przeglądarce przy użyciu funkcji wywołania z przeglądarki. Obiekt NativeApplication wywołuje także zdarzenie browserInvoke, gdy użytkownik uruchomi funkcję zautomatyzowanej instalacji w przeglądarce, a plik SWF w przeglądarce przekaże tablicę do parametru arguments metody launchApplication() pliku air.swf. (Szczegółowe informacje zawiera rozdział poświęcony dystrybuowaniu, instalowaniu i uruchamianiu aplikacji AIR w podręczniku dla programistów środowiska wykonawczego AIR).
Wywołanie z przeglądarki jest dozwolone tylko wtedy, gdy w pliku deskryptora aplikacji określone są następujące dane:
<allowBrowserInvocation>true</allowBrowserInvocation>
Jeśli aplikacja nie jest uruchomiona, obiekt NativeApplication przy uruchomieniu z przeglądarki wywołuje zarówno zdarzenie InvokeEvent, jak i zdarzenie browserInvoke. W przeciwnym razie, jeśli aplikacja jest już uruchomiona z przeglądarki, obiekt NativeApplication wywołuje tylko zdarzenie browserInvoke.
Jeśli aplikacja została uruchomiona z przeglądarki w wyniku zautomatyzowanej instalacji (gdy użytkownik wybrał opcję uruchomienia od razu po zainstalowaniu), obiekt NativeApplication wywołuje zdarzenie BrowserInvoke tylko wówczas, gdy zostały przekazane argumenty (przekazanie tablicy do parametru arguments metody installApplication() pliku air.swf za pośrednictwem pliku SWF w przeglądarce). (Szczegółowe informacje zawiera rozdział poświęcony dystrybuowaniu, instalowaniu i uruchamianiu aplikacji AIR w podręczniku dla programistów środowiska wykonawczego AIR).
Podobnie jak zdarzenie invokeEvent, obiekty browserInvokeEvent są wywoływane przez obiekt NativeApplication (NativeApplication.nativeApplication). Aby odbierać zdarzenia browserInvoke, należy wywołać metodę addEventListener() obiektu NativeApplication. Gdy detektor zdarzeń zarejestruje się do odbierania zdarzeń browserInvoke, odbierze także wszystkie zdarzenia browserInvoke, jakie wystąpiły przed rejestracją. Zdarzenia te są wywoływane po powrocie z wywołania addEventListener(), ale nie ma gwarancji, że stanie się to przed wywołaniem innych zdarzeń browserInvoke odebranych już po rejestracji. Takie rozwiązanie umożliwia obsługę zdarzeń browserInvoke, które wystąpiły przed wykonaniem kodu inicjującego aplikacji użytkownika (np. gdy aplikacja została pierwotnie wywołana z przeglądarki). Należy pamiętać, że w przypadku dodania detektora zdarzeń na późniejszym etapie wykonania (po zainicjowaniu aplikacji) detektor także odbierze wszystkie zdarzenia browserInvoke, które wystąpiły od momentu uruchomienia aplikacji.
Powiązane elementy interfejsu API
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
| arguments : Array [tylko do odczytu]
Tablica argumentów (ciągów znaków) przeznaczona do przekazania do aplikacji. | BrowserInvokeEvent | ||
 | bubbles : Boolean [tylko do odczytu]
Określa, czy zdarzenie może przechodzić fazę propagacji. | Event | |
| cancelable : Boolean [tylko do odczytu]
Wskazuje, czy można uniemożliwić operacje skojarzone ze zdarzeniem. | Event | |
| constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| currentTarget : Object [tylko do odczytu]
Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. | Event | |
| eventPhase : uint [tylko do odczytu]
Bieżąca faza przepływu zdarzeń. | Event | |
| isHTTPS : Boolean [tylko do odczytu]
Określa, czy dla treści w przeglądarce jest (wartość true), czy nie jest (wartość false) używany schemat adresu URL HTTPS. | BrowserInvokeEvent | ||
| isUserEvent : Boolean [tylko do odczytu]
Określa, czy wywołanie z przeglądarki jest wynikiem zdarzenia użytkownika (np. kliknięcia myszą). | BrowserInvokeEvent | ||
| sandboxType : String [tylko do odczytu]
Typ obszaru izolowanego dla zawartości w przeglądarce. | BrowserInvokeEvent | ||
| securityDomain : String [tylko do odczytu]
Domena zabezpieczeń dla treści w przeglądarce, na przykład "www.adobe.com" lub "www.example.org". | BrowserInvokeEvent | ||
| target : Object [tylko do odczytu]
Miejsce docelowe zdarzenia. | Event | |
| type : String [tylko do odczytu]
Typ zdarzenia. | Event | |
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
BrowserInvokeEvent(type:String, bubbles:Boolean, cancelable:Boolean, arguments:Array, sandboxType:String, securityDomain:String, isHTTPS:Boolean, isUserEvent:Boolean)
Funkcja konstruktora dla klasy BrowserInvokeEvent. | BrowserInvokeEvent | ||
[przesłanianie]
Tworzy nową kopię tego zdarzenia. | BrowserInvokeEvent | ||
|
Funkcja narzędziowa umożliwiająca implementację metody toString() w niestandardowych klasach Event w języku ActionScript 3.0. | Event | |
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Sprawdza, czy w odniesieniu do tego zdarzenia wywołano metodę preventDefault(). | Event | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
|
Anuluje domyślne ustawienia zdarzenia, o ile zachowanie to może być anulowane. | Event | |
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węźle bieżącym i węzłach następujących po nim. | Event | |
|
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węzłach następujących po węźle bieżącym w przepływie zdarzeń. | Event | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
|
Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu Event. | Event | |
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
| Stała | Zdefiniowane przez | ||
|---|---|---|---|
| BROWSER_INVOKE : String = "browserInvoke" [statyczny]
Stała BrowserInvokeEvent.BROWSER_INVOKE definiuje wartość właściwości type obiektu BrowserInvokeEvent. | BrowserInvokeEvent | ||
arguments | właściwość |
isHTTPS | właściwość |
isUserEvent | właściwość |
isUserEvent:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Określa, czy wywołanie z przeglądarki jest wynikiem zdarzenia użytkownika (np. kliknięcia myszą). W środowisku wykonawczym AIR 1.0 ta właściwość jest zawsze ustawiona na true; w środowisku AIR wywołanie z przeglądarki jest możliwe tylko w wyniku zdarzenia użytkownika.
Implementacja
public function get isUserEvent():Boolean sandboxType | właściwość |
sandboxType:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Typ obszaru izolowanego dla treści w przeglądarce. Może przyjąć jedną z następujących wartości:
Security.APPLICATION— treść znajduje się w obszarze izolowanym aplikacji.Security.LOCAL_TRUSTED— treść znajduje się w lokalnym zaufanym obszarze izolowanym.Security.LOCAL_WITH_FILE— treść znajduje się w lokalnym obszarze izolowanym z dostępem do systemu plików.Security.LOCAL_WITH_NETWORK— treść znajduje się w lokalnym obszarze izolowanym z dostępem do sieci.Security.REMOTE— treść znajduje się w domenie zdalnej (sieciowej).
Implementacja
public function get sandboxType():StringPowiązane elementy interfejsu API
securityDomain | właściwość |
securityDomain:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Domena zabezpieczeń dla treści w przeglądarce, na przykład "www.adobe.com" lub "www.example.org". Ta właściwość jest ustawiana tylko dla treści w zdalnym obszarze izolowanym (treści z domeny sieciowej), a nie dla treści w lokalnym obszarze izolowanym lub obszarze izolowanym aplikacji.
Implementacja
public function get securityDomain():String BrowserInvokeEvent | () | Konstruktor |
public function BrowserInvokeEvent(type:String, bubbles:Boolean, cancelable:Boolean, arguments:Array, sandboxType:String, securityDomain:String, isHTTPS:Boolean, isUserEvent:Boolean)| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Funkcja konstruktora dla klasy BrowserInvokeEvent. Z reguły programiści nie wywołują bezpośrednio konstruktora BrowserInvokeEvent(). Tylko środowisko wykonawcze powinno tworzyć obiekt BrowserInvokeEvent.
type:String — Typ zdarzenia, dostępny jako właściwość Event.type.
| |
bubbles:Boolean — Przyjmuje wartość false w przypadku obiektu BrowserInvokeEvent.
| |
cancelable:Boolean — Przyjmuje wartość false w przypadku obiektu BrowserInvokeEvent.
| |
arguments:Array — Tablica argumentów (ciągów znaków) przeznaczona do przekazania do aplikacji.
| |
sandboxType:String — Typ obszaru izolowanego dla treści w przeglądarce.
| |
securityDomain:String — Domena zabezpieczeń dla treści w przeglądarce.
| |
isHTTPS:Boolean — Określa, czy dla treści w przeglądarce używany jest schemat adresu URL HTTPS.
| |
isUserEvent:Boolean — Określa, czy wywołanie z przeglądarki było wynikiem zdarzenia użytkownika.
|
clone | () | metoda |
BROWSER_INVOKE | Stała |
public static const BROWSER_INVOKE:String = "browserInvoke"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Stała BrowserInvokeEvent.BROWSER_INVOKE definiuje wartość właściwości type obiektu BrowserInvokeEvent.
Obiekt BrowserInvokeEvent ma następujące właściwości:
| Właściwości | Wartości |
|---|---|
arguments | Tablica argumentów będących ciągami znaków, przekazywana podczas tego wywołania. |
sandBoxType | Ciąg znaków określający typ obszaru izolowanego dla treści w przeglądarce (Security.APPLICATION, Security.LOCAL_TRUSTED, Security.LOCAL_WITH_FILE, Security.LOCAL_LOCAL_WITH_NETWORK albo Security.REMOTE). |
securityDomain | Ciąg znaków określający domenę zabezpieczeń dla treści w przeglądarce (na przykład "www.example.com"). |
isHTTPS | Określa, czy dla treści w przeglądarce używany jest schemat adresu URL HTTPS (wartość true), czy nie (wartość false). |
isUserEvent | Określa, czy wywołanie z przeglądarki jest wynikiem zdarzenia użytkownika (zawsze true w środowisku wykonawczym AIR 1.0). |
bubbles | Nie. |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Określa obiekt, który aktywnie przetwarza ten obiekt InvokeEvent za pomocą detektora zdarzeń. |
target | Zawsze obiekt NativeApplication. |
Powiązane elementy interfejsu API
Tue Jun 12 2018, 12:06 PM Z