| Pakiet | flash.events |
| Klasa | public class InvokeEvent |
| Dziedziczenie | InvokeEvent  Event Object |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
invoke przy wywołaniu aplikacji.
Obiekt NativeApplication zawsze wywołuje zdarzenie invoke przy uruchamianiu aplikacji, ale zdarzenie to może być wywoływane także w innych okolicznościach. Na przykład uruchomiona aplikacja wywoła dodatkowe zdarzenie InvokeEvent, gdy użytkownik uaktywni plik skojarzony z tą aplikacją.
Możliwe jest uruchomienie tylko jednej instancji danej aplikacji. Kolejne próby uruchomienia aplikacji będą powodowały wywoływanie nowych zdarzeń invoke przez obiekt NativeApplication uruchomionej instancji. Aplikacja jest odpowiedzialna za obsługę zdarzenia i wykonanie odpowiedniej operacji, takiej jak otwarcie nowego okna aplikacji w celu wyświetlenia danych z pliku.
Obiekty InvokeEvent są wywoływane przez obiekt NativeApplication (NativeApplication.nativeApplication). Aby odbierać zdarzenia invoke, należy wywołać metodę addEventListener() obiektu NativeApplication. Gdy detektor zdarzeń zarejestruje się do odbierania zdarzeń invoke, odbierze także wszystkie zdarzenia invoke, jakie wystąpiły przed rejestracją. Te wcześniejsze zdarzenia są wywoływane przed powrotem z funkcji addEventListener(), ale niekoniecznie przed wywołaniem nowego zdarzenia invoke po rejestracji. Dlatego nie należy zakładać konkretnej kolejności wywoływania zdarzeń.
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 będących ciągami znaków, przekazywana podczas tego wywołania. | InvokeEvent | ||
 | 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 | |
| currentDirectory : File [tylko do odczytu]
Katalog, który powinien być używany jako katalog główny dla ścieżek względnych w tablicy arguments. | InvokeEvent | ||
| 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 | |
| reason : String [tylko do odczytu]
Przyczyna dla tego obiektu InvokeEvent. | InvokeEvent | ||
| target : Object [tylko do odczytu]
Miejsce docelowe zdarzenia. | Event | |
| type : String [tylko do odczytu]
Typ zdarzenia. | Event | |
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")
Funkcja konstruktora dla klasy InvokeEvent. | InvokeEvent | ||
[przesłanianie]
Tworzy nową kopię tego zdarzenia. | InvokeEvent | ||
|
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 | ||
|---|---|---|---|
| INVOKE : String = "invoke" [statyczny]
Stała InvokeEvent.INVOKE definiuje wartość właściwości type obiektu InvokeEvent. | InvokeEvent | ||
arguments | właściwość |
arguments:Array [tylko do odczytu] | Wersje środowiska wykonawczego: | AIR 1.0 |
Tablica argumentów będących ciągami znaków, przekazywana podczas tego wywołania. W przypadku wywołania z wiersza poleceń, tablica będzie zawierała argumenty podane w wierszu poleceń (z wyjątkiem nazwy procesu).
Na platformach przenośnych ta właściwość zawiera tablicę opcji, przy użyciu których uruchomiono aplikację, a nie argumenty wiersza polecenia. Gdy na platformach przenośnych parametr reason ma wartość InvokeEventReason.OPEN_URL, zawartość tablicy arguments może być różna:
- Aplikacja wywołana z innej aplikacji lub z przeglądarki za pomocą własnego adresu URL (systemy iOS i Android):
Argumenty iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]Adres URL Adres URL InvokeEvent.arguments[1]ID aplikacji źródłowej ID operacji InvokeEvent.arguments[2]null Niedostępne - Aplikacja wywołana przez system w celu otwarcia pliku o skojarzonym typie (systemy iOS i Android):
Argumenty iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]Adres URL Adres URL InvokeEvent.arguments[1]null ID operacji InvokeEvent.arguments[2]null Niedostępne - Aplikacja wywołana przez inną aplikację za pomocą kontrolera interakcji dokumentów (tylko w systemie iOS):
Argumenty iOS InvokeEvent.arguments.length3 InvokeEvent.arguments[0]Adres URL InvokeEvent.arguments[1]ID aplikacji źródłowej InvokeEvent.arguments[2]Uwagi
Uwaga: Po zaznaczeniu i otwarciu wielu plików naraz w systemie Mac® OS X, środowisko wykonawcze AIR wywoła jedno zdarzenie invoke zawierające w tablicy arguments nazwy wszystkich zaznaczonych plików. Jednak w systemach Windows® i Linux środowisko wykonawcze AIR wywoła odrębne zdarzenie invoke dla każdego wybranego pliku. Tablica arguments każdego takiego zdarzenia będzie zawierała nazwę tylko jednego pliku.
Implementacja
public function get arguments():Array currentDirectory | właściwość |
currentDirectory:File [tylko do odczytu] | Wersje środowiska wykonawczego: | AIR 1.0 |
Katalog, który powinien być używany jako katalog główny dla ścieżek względnych w tablicy arguments.
Jeśli aplikacja została uruchomiona z wiersza poleceń, ta właściwość jest zwykle ustawiana na bieżący katalog roboczy powłoki wiersza poleceń, z której uruchomiono aplikację. Jeśli aplikacja została uruchomiona z powłoki graficznego interfejsu użytkownika, jest to zazwyczaj katalog główny systemu plików.
Implementacja
public function get currentDirectory():File reason | właściwość |
reason:String [tylko do odczytu] | Wersje środowiska wykonawczego: | AIR 1.5.1 |
Przyczyna dla tego obiektu InvokeEvent. Ta właściwość wskazuje, czy aplikacja została uruchomiona ręcznie przez użytkownika, czy automatycznie podczas logowania. Możliwe wartości są wyliczone jako stałe w klasie InvokeEventReason:
| Stała InvokeEventReason | Znaczenie |
|---|---|
LOGIN | Uruchomiona automatycznie podczas logowania. |
NOTIFICATION | Apilkacja została uruchomiona w odpowiedzi na powiadomienie (tylko w systemie iOS). |
OPEN_URL | Aplikacja została uruchomiona z powodu wywołania przez inną aplikację. |
STANDARD | Uruchomione z innych przyczyn. |
Uwaga: Na platformach przenośnych właściwość reason nigdy nie przyjmuje wartości LOGIN.
Implementacja
public function get reason():StringPowiązane elementy interfejsu API
InvokeEvent | () | Konstruktor |
public function InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Funkcja konstruktora dla klasy InvokeEvent.
Parametrytype:String — Typ zdarzenia, dostępny jako Event.type.
| |
bubbles:Boolean (default = false)false w przypadku obiektu InvokeEvent.
| |
cancelable:Boolean (default = false)false w przypadku obiektu InvokeEvent.
| |
dir:File (default = null)arguments.
| |
argv:Array (default = null) | |
reason:String (default = "standard")InvokeEventReason.LOGIN, InvokeEventReason.STANDARD, InvokeEventReason.OPEN_URL lub InvokeEventReason.NOTIFICATION. Ten parametr jest dostępny od wersji 1.5.1 środowiska AIR. Zdarzenia OPEN_URL i NOTIFICATION są dostępne od wersji 3.5 środowiska AIR.
|
Powiązane elementy interfejsu API
clone | () | metoda |
INVOKE | Stała |
public static const INVOKE:String = "invoke"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Stała InvokeEvent.INVOKE definiuje wartość właściwości type obiektu InvokeEvent.
Obiekt InvokeEvent 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. |
currentDirectory | Obiekt File reprezentujący katalog, który powinien być używany jako katalog główny dla ścieżek względnych w tablicy arguments. |
reason | Kod wskazujący, czy zdarzenie invoke zostało wywołane z powodu automatycznego uruchomienia aplikacji po zalogowaniu się (InvokeEventReason.LOGIN), w odpowiedzi na powiadomienie zdalne (InvokeEventReason.NOTIFICATION; tylko w systemie iOS), z powodu wywołania aplikacji przez inną aplikację (InvokeEventReason.OPEN_URL) lub z innego powodu (InvokeEventReason.STANDARD). Dostępne od wersji AIR 1.5.1. |
bubbles | false. |
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