| Pakiet | flash.desktop |
| Klasa | public final class NativeApplication |
| Dziedziczenie | NativeApplication  EventDispatcher Object |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Klasa NativeApplication zawiera informacje dotyczące aplikacji, funkcje aplikacji oraz dysponuje zdarzeniami z poziomu aplikacji.
Obiekt NativeApplication jest pojedynczym obiektem, tworzonym automatycznie przy uruchomieniu. Pobierz instancję NativeApplication z aplikacji posiadającej statyczną właściwość NativeApplication.nativeApplication.
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
| activeWindow : NativeWindow [tylko do odczytu]
Aktywne okno aplikacji. | NativeApplication | ||
| applicationDescriptor : XML [tylko do odczytu]
Zawartość pliku deskryptora aplikacji dla tej aplikacji AIR. | NativeApplication | ||
| applicationID : String [tylko do odczytu]
ID aplikacji dla tej aplikacji. | NativeApplication | ||
| autoExit : Boolean
Określa, czy aplikacja powinna być zamknięta automatycznie po zamknięciu wszystkich okien. | NativeApplication | ||
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| executeInBackground : Boolean
Określa, czy aplikacja będzie czy nie będzie działać w tle. | NativeApplication | ||
| icon : InteractiveIcon [tylko do odczytu]
Ikona aplikacji. | NativeApplication | ||
| idleThreshold : int
Liczba sekund, która musi upłynąć bez interakcji ze strony użytkownika przed wywołaniem zdarzenia userIdle. | NativeApplication | ||
| isCompiledAOT : Boolean [tylko do odczytu]
Określa, czy dla żądanej platformy aplikacja ma być kompilowana czy interpretowana. | NativeApplication | ||
| menu : NativeMenu
Menu aplikacji. | NativeApplication | ||
| nativeApplication : NativeApplication [statyczny] [tylko do odczytu]
Pojedyncze wystąpienie klasy NativeApplication. | NativeApplication | ||
| openedWindows : Array [tylko do odczytu]
Tablica zawierająca wszystkie otwarte okna macierzyste tej aplikacji | NativeApplication | ||
| publisherID : String [tylko do odczytu]
Identyfikator wydawcy tej aplikacji. | NativeApplication | ||
| runtimePatchLevel : uint [tylko do odczytu]
Wersja poprawki dla środowiska wykonawczego zarządzającego tą aplikacją. | NativeApplication | ||
| runtimeVersion : String [tylko do odczytu]
Numer wersji środowiska wykonawczego zarządzającego tą aplikacją. | NativeApplication | ||
| startAtLogin : Boolean
Określa, czy ta aplikacja uruchamiana jest automatycznie w momencie zalogowania się użytkownika. | NativeApplication | ||
| supportsDefaultApplication : Boolean [statyczny] [tylko do odczytu]
Wskazuje, czy metody setAsDefaultApplication(), removeAsDefaultApplication() i isSetAsDefaultApplication() są obsługiwane na bieżącej platformie. | NativeApplication | ||
| supportsDockIcon : Boolean [statyczny] [tylko do odczytu]
Wskazuje, czy aplikacja AIR obsługuje ikony aplikacji typowe dla Docku w obecnym systemie operacyjnym. | NativeApplication | ||
| supportsMenu : Boolean [statyczny] [tylko do odczytu]
Określa, czy obecny system operacyjny obsługuje globalny pasek menu aplikacji. | NativeApplication | ||
| supportsStartAtLogin : Boolean [statyczny] [tylko do odczytu]
Wskazuje, czy metoda startAtLogin jest obsługiwana na bieżącej platformie. | NativeApplication | ||
| supportsSystemTrayIcon : Boolean [statyczny] [tylko do odczytu]
Określa, czy aplikacja AIR obsługuje ikony zasobnika systemowego w obecnym systemie operacyjnym. | NativeApplication | ||
| systemIdleMode : String
Umożliwia aplikacji uniknięcie przejścia interfejsu użytkownika do trybu „bezczynności”. | NativeApplication | ||
| timeSinceLastUserInput : int [tylko do odczytu]
Czas w sekundach od ostatniej interakcji ze strony użytkownika. | NativeApplication | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
Aktywuje tą aplikację. | NativeApplication | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [przesłanianie]
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | NativeApplication | ||
Wywołuje wewnętrzne polecenie usunięcia na aktywnym obiekcie ekranowym. | NativeApplication | ||
Wywołuje wewnętrzne polecenie kopiowania na aktywnym obiekcie ekranowym. | NativeApplication | ||
Wywołuje wewnętrzne polecenie wycięcia na aktywnym obiekcie ekranowym. | NativeApplication | ||
[przesłanianie]
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | NativeApplication | ||
Zamyka tą aplikację. | NativeApplication | ||
Pobiera domyślną aplikację do otwierania plików z określonym rozszerzeniem. | NativeApplication | ||
|
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | |
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
Określa czy ta aplikacja jest obecnie domyślną aplikacją do otwierania plików z określonym rozszerzeniem. | NativeApplication | ||
Wywołuje wewnętrzną komendę wklej na aktywnym obiekcie wyświetlania. | NativeApplication | ||
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
Usuwa tę aplikację jako pozycję domyślną do otwierania plików z określonym rozszerzeniem. | NativeApplication | ||
[przesłanianie]
Usuwa detektor z obiektu EventDispatcher. | NativeApplication | ||
Wywołuje wewnętrzne polecenie selectAll na aktywnym obiekcie ekranowym. | NativeApplication | ||
Ustawia tę aplikację jako aplikację domyślną do otwierania plików z określonym rozszerzeniem. | NativeApplication | ||
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
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 | ||
|---|---|---|---|---|
| Wywoływane, gdy aplikacja staje się aktywną aplikacją pulpitu. | NativeApplication | |||
| Wywoływane, gdy aplikacja zostanie wywołana przez plik SWF uruchomiony w przeglądarce użytkownika. | NativeApplication | |||
| Wywoływane, gdy aktywność pulpitu jest przełączana na inną aplikację | NativeApplication | |||
| Wywoływane w momencie rozpoczęcia sekwencji zamykania aplikacji. | NativeApplication | |||
| Wywoływane, gdy aplikacja jest wywoływana. | NativeApplication | |||
| Wywoływane, gdy użytkownik naciśnie klawisz. | NativeApplication | |||
| Wywoływane, gdy użytkownik zwolni klawisz. | NativeApplication | |||
| Wywoływane, gdy dostępne jest nowe połączenie sieciowe, lub istniejące połączenie sieciowe jest utracone. | NativeApplication | |||
| Wywoływane tuż przed wstrzymaniem aplikacji przez system operacyjny. | NativeApplication | |||
| Wywoływane, gdy użytkownik pozostawał bezczynny. | NativeApplication | |||
| Wywoływane, gdy system operacyjny wykrywa aktywność myszy lub klawiatury po okresie braku bezczynności. | NativeApplication | |||
activeWindow | właściwość |
activeWindow:NativeWindow [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Aktywne okno aplikacji.
Jeśli aktywne okno pulpitu nie należy do tej aplikacji lub żadne okno nie jest aktywne, właściwość activeWindow ma wartość null.
Właściwość ta nie jest obsługiwana na platformach, które nie obsługują klasy NativeWindow.
Implementacja
public function get activeWindow():NativeWindow applicationDescriptor | właściwość |
applicationDescriptor:XML [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Zawartość pliku deskryptora aplikacji dla tej aplikacji AIR.
Implementacja
public function get applicationDescriptor():XMLPrzykład ( Sposób korzystania z tego przykładu )
copyright i version są odczytywane z pliku deskryptora aplikacji. Należy zauważyć, że użytkownik musi używać domyślnej przestrzeni nazw zdefiniowanej w pliku XML deskryptora aplikacji.
var appDescriptor:XML = NativeApplication.nativeApplication.applicationDescriptor;
var ns:Namespace = appDescriptor.namespace();
var appCopyright:String = appDescriptor.ns::copyright;
var appVersion:String = appDescriptor.ns::version;
trace("appId:", appCopyright);
trace("version:", appVersion);
applicationID | właściwość |
autoExit | właściwość |
autoExit:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Określa, czy aplikacja powinna zostać zamknięta automatycznie po zamknięciu wszystkich okien.
Kiedy parametr autoExit ma wartość true, wówczas aplikacja zostanie zamknięta po zamknięciu wszystkich okien. Oba zdarzenia zostaną wywołane, zarówno exiting, jak i exit. Kiedy parametr autoExit ma wartość false, należy wywołać metodę NativeApplication.nativeApplication.exit() w celu zamknięcia aplikacji.
Właściwość ta nie jest obsługiwana na platformach, które nie obsługują klasy NativeWindow.
Implementacja
public function get autoExit():Boolean public function set autoExit(value:Boolean):void executeInBackground | właściwość |
executeInBackground:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3.3 |
Określa, czy aplikacja będzie czy nie będzie działać w tle.
Gdy właściwość executeInBackground ma wartość false (domyślną), aplikacja przeniesiona do tła pozostaje w stanie wstrzymania. Gdy właściwości executeInBackground ma wartość true, aplikacja może być wykonywana w tle.
Uwaga: W przypadku wersji 21 i starszych formatu SWF środowisko AIR nie obsługuje wykonywania w tle w systemach iOS i Android, gdy jest ustawiony bezpośredni tryb renderowania. Z powodu tego ograniczenia aplikacje używające mechanizmu Stage3D nie mogą realizować zadań w tle, takich jak odtwarzanie dźwięku, aktualizacja lokalizacji czy wysyłanie lub pobieranie danych przez sieć. System iOS nie umożliwia wywoływania procedur interfejsu OpenGL ES ani realizacji innych funkcji wyświetlania obrazu w tle. Próby wykonania takich operacji są przerywane przez system iOS. Takie ograniczenie nie występuje w systemie Android, który umożliwia wywoływanie w tle procedur interfejsu Open GL ES lub innych zadań, na przykład odtwarzania dźwięku. W przypadku wersji 22 i starszych formatu SWF aplikacje AIR dla urządzeń przenośnych mogą działać w tle, gdy jest ustawiony bezpośredni tryb renderowania. Środowisko wykonawcze AIR w systemie iOS powoduje błąd języka (3768 — nie można używać interfejsu API obiektu Stage3D podczas działania w tle) w przypadku wywołań OpenGL ES w tle. W systemie Android nie występują takie błędy, ponieważ jego aplikacje natywne mogą używać wywołań OpenGL ES podczas działania w tle. Aby optymalnie używać zasobu na urządzeniu przenośnym, nie należy stosować wywołań renderowania, gdy aplikacja działa w tle.
Ta właściwość jest obsługiwana w środowisku AIR dla systemów iOS i Android.
Implementacja
public function get executeInBackground():Boolean public function set executeInBackground(value:Boolean):void icon | właściwość |
icon:InteractiveIcon [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Ikona aplikacji.
Użyj obiektów NativeApplication.supportsDockIcon i NativeApplication.supportsSystemTrayIcon, aby określić klasę ikony. Typem będzie jedna z podklas obiektu InteractiveIcon. W systemie operacyjnym Mac® OS X obiekt NativeApplication jest obiektem typu DockIcon. W systemie Windows® obiekt NativeApplication.icon jest obiektem typu SystemTrayIcon. Gdy ikona aplikacji nie jest obsługiwana, właściwości NativeApplication.supportsDockIcon i NativeApplication.supportsSystemTrayIcon mają wartość false, a właściwość icon jest równa null.
Obiekt icon jest tworzony automatycznie, ale nie jest inicjalizowany z danymi obrazu. W niektórych systemach operacyjnych, jak na przykład Mac OS X, obraz domyślny jest dostarczany. W innych, jak na przykład Windows, ikona nie jest wyświetlana (o ile nie ma danych obrazu przypisanych do niej). Aby przypisać obraz ikony, należy ustawić właściwość icon.bitmaps z tablicą zawierającą co najmniej jeden obiekt BitmapData. Jeżeli więcej niż jeden obiekt BitmapData jest dołączony do tablicy, wówczas system operacyjny wybierze obraz, który jest najbliższy pod względem rozmiaru do wymiarów wyświetlanej ikony, w razie konieczności skalując obraz.
Implementacja
public function get icon():InteractiveIconPowiązane elementy interfejsu API
idleThreshold | właściwość |
idleThreshold:int| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Liczba sekund, która musi upłynąć bez interakcji ze strony użytkownika przed wywołaniem zdarzenia userIdle.
Domyślnie próg bezczynności wynosi 300 sekund (5 minut). Poprawne są wartości z zakresu od 5 (5 sekund) do 86400 (1 dzień) włącznie.
Implementacja
public function get idleThreshold():int public function set idleThreshold(value:int):voidZgłasza
ArgumentError — Jeśli podjęta została próba przypisania tej właściwości niepoprawnej wartości. Poprawne są wartości z zakresu od 5 (5 sekund) do 86400 (1 dzień) włącznie.
|
Powiązane elementy interfejsu API
isCompiledAOT | właściwość |
isCompiledAOT:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 25.0 |
Określa, czy dla żądanej platformy aplikacja ma być kompilowana czy interpretowana. Ten interfejs API zwraca wartość (true) tylko dla pakietu targets(ipa-app-store, ipa-test, ipa-debug, ipa-ad-hoc) dla systemu iOS. W przypadku innych platform w środowisku AIR ten interfejs API zwraca wartość (false).
Implementacja
public function get isCompiledAOT():Boolean menu | właściwość |
menu:NativeMenu| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Menu aplikacji.
Menu aplikacji są obsługiwane, gdy parametr NativeApplication.supportsMenu ma wartość true. Nie wszystkie systemy operacyjne obsługują menu aplikacji. Na przykład menu aplikacji są obsługiwane w systemie operacyjnym Mac OS X, ale nie w systemie Windows ani Linux. Przypisanie obiektu NativeMenu do tej właściwości, kiedy parametr NativeApplication.supportsMenu ma wartość false, jest dozwolone, ale nie ma żadnych skutków. Należy pamiętać o sprawdzeniu, czy system operacyjny obsługuje menu aplikacji, przez użycie właściwości NativeApplication.supportsMenu. Użycie innych sposobów (na przykład właściwości Capabilities.os) do określenia możliwości obsługi może prowadzić do błędów programowania (jeśli niektóre docelowe systemy operacyjne nie zostaną uwzględnione).
Obsługa profilów AIR: Ta funkcja nie jest obsługiwana na urządzeniach przenośnych ani na urządzeniach telewizyjnych ze środowiskiem AIR. 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.
Uwaga: W systemie operacyjnym Mac X właściwość menu odwołuje się do domyślnego menu aplikacji, dostarczonego przez system operacyjny. Można modyfikować istniejącą strukturę menu poprzez dodawanie i usuwanie elementów i podmenu oraz dodawanie detektorów zdarzeń. Można także całkowicie zastąpić domyślne menu przypisując nowy obiekt NativeMenu do tej właściwości menu.
Implementacja
public function get menu():NativeMenu public function set menu(value:NativeMenu):voidPowiązane elementy interfejsu API
nativeApplication | właściwość |
nativeApplication:NativeApplication [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Pojedyncza instancja obiektu NativeApplication.
Implementacja
public static function get nativeApplication():NativeApplicationZgłasza
Error — Jeśli uzyskano dostęp za pośrednictwem treści spoza obszaru izolowanego aplikacji.
|
openedWindows | właściwość |
openedWindows:Array [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Tablica zawierająca wszystkie otwarte okna natywne tej aplikacji
Właściwość ta nie jest obsługiwana na platformach, które nie obsługują klasy NativeWindow.
Implementacja
public function get openedWindows():Array publisherID | właściwość |
publisherID:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
ID wydawcy tej aplikacji.
Wartość tego ID jest ustawiona w pliku publisherid aplikacji, który jest generowany w czasie instalacji z łańcucha certyfikacji, użytego przy podpisywaniu aplikacji.
Implementacja
public function get publisherID():String runtimePatchLevel | właściwość |
runtimeVersion | właściwość |
startAtLogin | właściwość |
startAtLogin:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Określa, czy ta aplikacja uruchamiana jest automatycznie w momencie zalogowania się użytkownika.
Obsługa profilów AIR: Ta funkcja jest obsługiwana we wszystkich komputerowych systemach operacyjnych, 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ść NativeApplication.supportsStartAtLogin. 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.
Właściwość startAtLogin odzwierciedla stan mechanizmu zdefiniowanego przez system operacyjny, służącego do określania, czy aplikacja powinna się uruchamiać automatycznie przy zalogowaniu użytkownika. Użytkownik może zmienić stan ręcznie, korzystając z interfejsu systemu operacyjnego. Ta właściwość odzwierciedla obecny stan, bez względu na to czy stan był ostatnio zmieniany przez aplikację AIR lub system operacyjny.
Implementacja
public function get startAtLogin():Boolean public function set startAtLogin(value:Boolean):voidZgłasza
IllegalOperationError — W systemie Windows, kiedy inna aplikacja o tej samej nazwie (ale posiadająca inną ścieżkę do pliku wykonywalnego) jest skonfigurowana tak, aby uruchamiała się przy logowaniu się użytkownika.
| |
IllegalOperationError — Jeśli ta aplikacja nie jest zainstalowana, co może nastąpić w przypadku uruchamiania przez program ADL (AIR Debug Launcher)
|
Powiązane elementy interfejsu API
supportsDefaultApplication | właściwość |
supportsDefaultApplication:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2 |
Wskazuje, czy metody setAsDefaultApplication(), removeAsDefaultApplication() i isSetAsDefaultApplication() są obsługiwane na bieżącej platformie.
W przypadku wartości true powyższe metody będą działały w sposób opisany w dokumentacji. W przypadku wartości false metody setAsDefaultApplication() i removeDefaultApplication() nie robią nic, a metoda isSetAsDefaultApplication() zwraca wartość false.
Implementacja
public static function get supportsDefaultApplication():BooleanPowiązane elementy interfejsu API
supportsDockIcon | właściwość |
supportsDockIcon:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Wskazuje, czy aplikacja AIR obsługuje ikony aplikacji typowe dla mechanizmu dokowania w obecnym systemie operacyjnym.
Jeżeli parametr ma wartość true, wówczas właściwość NativeApplication.icon jest typu DockIcon.
Interfejs użytkownika systemu Mac OS X obejmuje „Dock” zawierający ikony aplikacji, które są uruchomione lub często używane.
W celu ustalenia, czy system operacyjny obsługuje ikony Docku, należy koniecznie użyć właściwości NativeApplication.supportsDockIcon. Użycie innych sposobów (na przykład właściwości Capabilities.os) do określenia możliwości obsługi może prowadzić do błędów programowania (jeśli niektóre docelowe systemy operacyjne nie zostaną uwzględnione).
Implementacja
public static function get supportsDockIcon():BooleanPowiązane elementy interfejsu API
supportsMenu | właściwość |
supportsMenu:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Określa, czy obecny system operacyjny obsługuje globalny pasek menu aplikacji.
Jeżeli parametr ma wartość true, wówczas właściwość NativeApplication.menu może zostać użyta do definiowania (lub uzyskiwania dostępu) menu aplikacji macierzystej.
W celu ustalenia, czy system operacyjny obsługuje pasek menu aplikacji, należy koniecznie użyć właściwości NativeApplication.supportsMenu. Użycie innych sposobów (na przykład właściwości Capabilities.os) do określenia możliwości obsługi może prowadzić do błędów programowania (jeśli niektóre docelowe systemy operacyjne nie zostaną uwzględnione).
Implementacja
public static function get supportsMenu():BooleanPowiązane elementy interfejsu API
supportsStartAtLogin | właściwość |
supportsStartAtLogin:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2 |
Wskazuje, czy metoda startAtLogin jest obsługiwana na bieżącej platformie.
W przypadku wartości true metoda startAtLogin będzie działała w sposób opisany w dokumentacji. W przypadku wartości false metoda startAtLogin nie wykona żadnego działania.
Implementacja
public static function get supportsStartAtLogin():BooleanPowiązane elementy interfejsu API
supportsSystemTrayIcon | właściwość |
supportsSystemTrayIcon:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Określa, czy aplikacja AIR obsługuje ikony zasobnika systemowego w obecnym systemie operacyjnym.
Jeżeli parametr ma wartość true, wówczas właściwość NativeApplication.icon jest typu SystemTrayIcon.
Interfejs użytkownika systemu Windows zawiera „zasobnik systemowy”, oficjalnie nazywany obszarem powiadomień na pasku zadań. W zasobniku mogą być wyświetlane ikony aplikacji. Nie jest wyświetlana żadna ikona domyślna. Aby ikona była wyświetlana, należy nadać wartość tablicy bitmaps obiektu ikony.
W celu ustalenia, czy system operacyjny obsługuje ikony zasobnika systemowego, należy koniecznie użyć właściwości NativeApplication.supportsSystemTrayIcon. Użycie innych sposobów (na przykład właściwości Capabilities.os) do określenia możliwości obsługi może prowadzić do błędów programowania (jeśli niektóre docelowe systemy operacyjne nie zostaną uwzględnione).
Implementacja
public static function get supportsSystemTrayIcon():BooleanPowiązane elementy interfejsu API
systemIdleMode | właściwość |
systemIdleMode:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2 |
Umożliwia aplikacji zablokowanie przechodzenia interfejsu użytkownika do trybu bezczynności.
Wartość z klasy SystemIdleMode oddziałująca na zachowanie trybu bezczynności systemu hosta. Ta właściwość jest skuteczna tylko w aplikacji aktywnej dla interakcji z użytkownikiem, a dostęp do niej można uzyskać jedynie z treści uruchomionej w obszarze izolowanym aplikacji.
Obsługa profilów AIR: Ta funkcja jest obsługiwana na urządzeniach przenośnych, ale nie jest obsługiwana w komputerowych systemach operacyjnych ani w środowisku AIR dla urządzeń telewizyjnych. 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.
Implementacja
public function get systemIdleMode():String public function set systemIdleMode(value:String):voidPowiązane elementy interfejsu API
timeSinceLastUserInput | właściwość |
activate | () | metoda |
public function activate(window:NativeWindow = null):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Aktywuje tę aplikację.
Metoda ta nie jest obsługiwana na platformach, które nie obsługują klasy NativeWindow.
W niektórych sytuacjach określonych przez system operacyjny, ta metoda nie uaktywni aplikacji. Większość systemów operacyjnych ogranicza zdolność aplikacji do samoaktywacji, aby ograniczyć możliwość przypadkowego lub złośliwego uniemożliwienia używania przez użytkownika innych aplikacji.
Jeśli system operacyjny zezwoli na aktywację, wówczas określone okno będzie uaktywnione i przesunięte na pierwszy plan pulpitu, czyli przed okna lub inne otwarte aplikacje. (Jeśli parametr window jest równy null, zostanie aktywowane dowolne widoczne okno tej aplikacji).
Metoda activate() nie daje żadnych efektów, jeżeli aplikacja nie posiada widocznych okien.
Operacja aktywowania jest synchroniczna.
Parametry
window:NativeWindow (default = null) |
Zdarzenia
activate: — Wywoływane po zmianie stanu aktywności.
|
addEventListener | () | metoda |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void| Wersje środowiska wykonawczego: | AIR 1.0 |
Rejestruje obiekt detektora zdarzenia w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. We wszystkich węzłach listy wyświetlania można rejestrować detektory zdarzeń reagujące na zdarzenia konkretnego typu, znajdujące się w określonej fazie i mające określony priorytet.
Po pomyślnym zarejestrowaniu detektora zdarzeń nie można zmienić jego priorytetu poprzez dodatkowe wywołania metody addEventListener(). Aby zmienić priorytet detektora, należy najpierw wywołać metodę removeListener(). Następnie można ponownie zarejestrować detektor z nowym poziomem priorytetu.
Należy pamiętać, że po zarejestrowaniu detektora późniejsze wywołania metody addEventListener() z różnymi wartościami type albo useCapture powodują rejestrowanie odrębnych detektorów. Na przykład detektor zarejestrowany z parametrem useCapture ustawionym na true wykrywa tylko zdarzenia w fazie przechwytywania. Po ponownym wywołaniu metody addEventListener() z tym samym obiektem detektora, ale z parametrem useCapture ustawionym na false będą istniały dwa odrębne detektory: jeden wykrywający zdarzenia w fazie przechwytywania, a drugi wykrywający zdarzenia w fazach miejsca docelowego i propagacji.
Nie można zarejestrować detektora zdarzeń, który wykrywałby tylko zdarzenia w fazie miejsca docelowego lub tylko zdarzenia w fazie propagacji. Te fazy są sprzężone podczas rejestracji, ponieważ propagacja zachodzi tylko w przodkach węzła miejsca docelowego.
Gdy detektor zdarzeń przestanie być potrzebny, należy go usunąć, wywołując metodę removeEventListener(); w przeciwnym razie mogą wystąpić problemy w zarządzaniu pamięcią. Detektory zdarzeń nie są automatycznie usuwane z pamięci, ponieważ proces czyszczenia pamięci nie usuwa detektora, pod warunkiem że istnieje obiekt wywołujący (o ile dla parametru useWeakReference ustawiona jest wartość true).
Skopiowanie instancji klasy EventDispatcher nie powoduje skopiowania detektorów zdarzeń dołączonych do tej instancji. (Jeśli utworzono nowy węzeł, dla którego potrzebny jest detektor zdarzeń, należy dołączyć detektor po utworzeniu węzła). Jednak przeniesienie instancji klasy EventDispatcher powoduje również przeniesienia dołączonych do niej detektorów zdarzeń
Jeśli detektor zdarzeń jest rejestrowany w węźle w momencie, gdy ten węzeł przetwarza zdarzenie, detektor nie zostanie wywołany w bieżącej fazie, ale może być wywołany w późniejszej fazie przepływu zdarzeń, np. w fazie propagacji.
Jeśli detektor zdarzeń zostanie usunięty z węzła w momencie, gdy ten węzeł przetwarza zdarzenie, zostanie wywołany przez bieżące operacje. Raz usunięty detektor zdarzeń nie jest nigdy ponownie wywoływany (chyba że zostanie ponownie zarejestrowany na potrzeby dalszego etapu wykonania programu).
Parametry
type:String — Typ zdarzenia.
| |
listener:Function — Funkcja detektora, który przetwarza zdarzenie. Ta funkcja musi przyjmować obiekt Event jako swój jedyny parametr i nie może zwracać żadnych wyników, tak jak ilustruje to poniższy przykład:
function(evt:Event):void Funkcja może mieć dowolną nazwę. | |
useCapture:Boolean (default = false)useCapture jest ustawiony na true, wówczas detektor przetwarza zdarzenie tylko w trakcie fazy przechwytywania, a nie w trakcie fazy miejsca docelowego i propagacji. Jeżeli parametr useCapture ma wartość false, wówczas detektor przetwarza zdarzenie tylko w trakcie fazy miejsca docelowego i propagacji. W celu wykrywania zdarzenia we wszystkich trzech fazach należy wywołać metodę addEventListener dwa razy — raz z parametrem useCapture ustawionym na true, a następnie ponownie, z parametrem useCapture ustawionym na false.
| |
priority:int (default = 0) | |
useWeakReference:Boolean (default = false)Funkcje składowe na poziomie klasy nie podlegają porządkowaniu pamięci, zatem można ustawić właściwość |
clear | () | metoda |
public function clear():Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywołuje wewnętrzną komendę usuń na aktywnym obiekcie wyświetlania.
To wywołanie funkcji jest zignorowane, jeżeli aktywny obiekt nie implementuje polecenia. Jedynie obiekty ekranowe pochodzące z klas TextField lub HTMLLoader implementują obecnie to polecenie.
Uwaga: Polecenie clear() usuwa zaznaczony tekst. Jeśli nic nie zostało zaznaczone, nie czyści całego tekstu.
Boolean — true.
|
copy | () | metoda |
public function copy():Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywołuje wewnętrzne polecenie kopiuj na aktywnym obiekcie wyświetlanym.
To wywołanie funkcji jest ignorowane, jeżeli składnik nie implementuje polecenia. Jedynie obiekty wyświetlane pochodzące z klas TextField lub HTMLLoader implementują obecnie to polecenie.
ZwracaBoolean |
cut | () | metoda |
public function cut():Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywołuje wewnętrzną komendę wytnij na aktywnym obiekcie wyświetlania.
To wywołanie funkcji jest zignorowane, jeżeli składnik nie implementuje polecenia. Jedynie obiekty wyświetlane pochodzące z klas TextField lub HTMLLoader implementują obecnie to polecenie.
ZwracaBoolean — true.
|
dispatchEvent | () | metoda |
override public function dispatchEvent(event:Event):Boolean| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. Miejscem docelowym zdarzenia jest obiekt EventDispatcher, względem którego wywołano metodę dispatchEvent().
Parametry
event:Event — Obiekt Event, który jest wywoływany, tj. kierowany do przepływu zdarzeń. Jeśli zdarzenie jest wywoływane ponownie, automatycznie tworzony jest klon zdarzenia. Po wywołaniu zdarzenia nie można zmienić jego właściwości target, zatem należy utworzyć nową kopię zdarzenia w celu ponownego wywołania.
|
Boolean — Wartość true, jeśli zdarzenie zostało pomyślnie wywołane. Wartość false oznacza niepowodzenie lub wywołanie metody preventDefault() w zdarzeniu.
|
exit | () | metoda |
public function exit(errorCode:int = 0):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Kończy działanie tej aplikacji.
Wywołanie metody exit() zostanie zwrócone. Sekwencja zamykania nie rozpocznie się, dopóki obecnie wykonywany kod (np. obecny moduł obsługi zdarzeń) nie zostanie zakończony. Oczekujące operacje asynchroniczne są anulowane i będą lub nie będą zakończone.
Należy zauważyć, że zdarzenie exiting nie jest wywoływane. Jeżeli zdarzenie exiting jest wymagane przez logikę aplikacji, należy wywołać metodę NativeApplication.nativeApplication.dispatchEvent(), podając obiekt Event typu exiting. Dla wszystkich otwartych okien obiekty NativeWindow wywołują zdarzenia closing i close. Wywołanie metody preventDefault() obiektu zdarzenia closing zapobiega zakończeniu działania aplikacji.
Uwaga: Metoda ta nie jest obsługiwana na komputerach z systemem operacyjnym iOS.
Parametry
errorCode:int (default = 0) |
getDefaultApplication | () | metoda |
public function getDefaultApplication(extension:String):String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Pobiera domyślną aplikację do otwierania plików z określonym rozszerzeniem.
Uwaga: Ta metoda może być stosowana jedynie w przypadku typów plików zadeklarowanych w zdaniu fileTypes deskryptora aplikacji.
Metoda ta nie ma zastosowania do urządzeń telewizyjnych ze środowiskiem AIR. Jeśli zostanie wywołana dla typu pliku zadeklarowanego w deskryptorze aplikacji, zwróci wartość null.
Parametry
extension:String — Ciąg znaków zawierający rozszerzenie zainteresowanego typu plików (bez kropki).
|
String — Ścieżka domyślnej aplikacji.
|
Zgłasza
Error — Jeżeli parametr extension nie zawiera jednego z rozszerzeń plików zadeklarowanych w deskryptorze aplikacji.
|
Powiązane elementy interfejsu API
isSetAsDefaultApplication | () | metoda |
public function isSetAsDefaultApplication(extension:String):Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Wskazuje, czy ta aplikacja jest obecnie domyślną aplikacją do otwierania plików z określonym rozszerzeniem.
Obsługa profilów AIR: Ta funkcja jest obsługiwana we wszystkich komputerowych systemach operacyjnych, 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ść NativeApplication.supportsDefaultApplication. 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.
Parametry
extension:String — Ciąg znaków zawierający rozszerzenie zainteresowanego typu plików (bez kropki).
|
Boolean — Wartość true jeśli ta aplikacja jest domyślną.
|
Zgłasza
Error — Jeżeli parametr extension nie zawiera jednego z rozszerzeń plików zadeklarowanych w deskryptorze aplikacji.
|
Powiązane elementy interfejsu API
paste | () | metoda |
public function paste():Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywołuje wewnętrzne polecenie wklejenia na aktywnym obiekcie ekranowym.
To wywołanie funkcji jest ignorowane, jeżeli składnik nie implementuje polecenia. Jedynie obiekty wyświetlane pochodzące z klas TextField lub HTMLLoader implementują obecnie to polecenie.
ZwracaBoolean — true.
|
removeAsDefaultApplication | () | metoda |
public function removeAsDefaultApplication(extension:String):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Usuwa tą aplikację jako pozycję domyślną do otwierania plików z określonym rozszerzeniem.
Uwaga: Ta metoda może być stosowana jedynie w przypadku typów plików zadeklarowanych w zdaniu fileTypes deskryptora aplikacji.
Parametry
extension:String — Ciąg znaków zawierający rozszerzenie zainteresowanego typu plików (bez ".").
|
Zgłasza
Error — Jeżeli parametr extension nie posiada jednego z rozszerzeń plików zadeklarowanych w deskryptorze aplikacji.
|
Powiązane elementy interfejsu API
removeEventListener | () | metoda |
override public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void| Wersje środowiska wykonawczego: | AIR 1.0 |
Usuwa detektor z obiektu EventDispatcher. Jeśli w obiekcie EventDispatcher nie ma zarejestrowanego zgodnego detektora zdarzeń, wywołanie tej metody nie odnosi żadnego skutku.
Parametry
type:String — Typ zdarzenia.
| |
listener:Function — Obiekt detektora przeznaczony do usunięcia.
| |
useCapture:Boolean (default = false)removeEventListener(): jedno wywołanie z parametrem useCapture ustawionym na true, a następne wywołanie z parametrem useCapture ustawionym na false.
|
selectAll | () | metoda |
public function selectAll():Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywołuje wewnętrzną komendę selectAll na aktywnym obiekcie wyświetlania.
To wywołanie funkcji jest ignorowane, jeżeli składnik nie implementuje polecenia. Jedynie obiekty wyświetlane pochodzące z klas TextField lub HTMLLoader implementują obecnie to polecenie.
ZwracaBoolean — true.
|
setAsDefaultApplication | () | metoda |
public function setAsDefaultApplication(extension:String):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Ustawia tą aplikację jako aplikację domyślną do otwierania plików z określonym rozszerzeniem.
Uwaga: Ta metoda może być stosowana jedynie w przypadku typów plików zadeklarowanych w zdaniu fileTypes deskryptora aplikacji.
Parametry
extension:String — Ciąg znaków zawierający rozszerzenie zainteresowanego typu plików (bez ".").
|
Zgłasza
Error — Jeżeli parametr extension nie posiada jednego z rozszerzeń plików zadeklarowanych w deskryptorze aplikacji.
|
Powiązane elementy interfejsu API
activate | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.ACTIVATE| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane, gdy aplikacja staje się aktywną aplikacją pulpitu.
StałaACTIVATE definiuje wartość właściwości type obiektu zdarzenia activate.
Uwaga: to zdarzenie nie zawiera fazy „przechwytywania” ani „propagacji”, co oznacza, że detektory zdarzeń muszą być dodawane bezpośrednio do każdego potencjalnego obiektu docelowego — niezależnie od tego, czy obiekt znajduje się na liście wyświetlania.
To zdarzenie nie jest nigdy automatycznie wywoływane na urządzeniach telewizyjnych ze środowiskiem AIR. Można wywołać je ręcznie.
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 | Dowolna instancja klasy DisplayObject z detektorem zarejestrowanym dla zdarzenia activate. |
browserInvoke | Zdarzenie |
flash.events.BrowserInvokeEventwłaściwość BrowserInvokeEvent.type =
flash.events.BrowserInvokeEvent.Browser_INVOKE| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane, gdy aplikacja zostanie wywołana przez plik SWF uruchomiony w przeglądarce użytkownika.
Wywołanie z przeglądarki jest dozwolone tylko wtedy, gdy w pliku deskryptora aplikacji określone są następujące dane:
<allowBrowserInvocation>true</allowBrowserInvocation>
deactivate | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.DEACTIVATE| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane, gdy punkt skupienia pulpitu przechodzi do innej aplikacji.
StałaEvent.DEACTIVATE definiuje wartość właściwości type obiektu zdarzenia deactivate.
Uwaga: to zdarzenie nie zawiera fazy „przechwytywania” ani „propagacji”, co oznacza, że detektory zdarzeń muszą być dodawane bezpośrednio do każdego potencjalnego obiektu docelowego — niezależnie od tego, czy obiekt znajduje się na liście wyświetlania.
To zdarzenie nie jest nigdy automatycznie wywoływane na urządzeniach telewizyjnych ze środowiskiem AIR. Można wywołać je ręcznie.
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 | Dowolna instancja klasy DisplayObject z detektorem zarejestrowanym dla zdarzenia deactivate. |
exiting | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.EXITING| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane w momencie rozpoczęcia sekwencji zamykania aplikacji.
Zdarzenie exiting jest wywoływane, gdy zamykanie aplikacji jest inicjowane przez system operacyjny, na przykład kiedy użytkownik naciśnie sekwencję klawiszy Command+Q w systemie operacyjnym Mac OS X, lub gdy parametrautoExit obiektu NativeApplication ma wartość true i ostatnie okno aplikacji zostanie zamknięte. Anulowanie tego zdarzenia zapobiega zamknięciu aplikacji.
Urządzenia telewizyjne ze środowiskiem AIR nigdy nie wywołują zdarzenia exiting.
Uwaga: Wywoływanie metody exit() obiektu NativeApplication nie powoduje wywołania zdarzenia exiting. Aby ostrzec składniki o nadchodzącym zamknięciu, należy wywołać zdarzenie exiting przed wywołaniem metody exit().
Event.EXITING definiuje wartość właściwości type obiektu zdarzenia exiting.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | false |
cancelable | true; anulowanie tego zdarzenia zatrzymuje operację zakończenia. |
currentTarget | Obiekt NativeApplication. |
target | Obiekt NativeApplication. |
invoke | Zdarzenie |
flash.events.InvokeEventwłaściwość InvokeEvent.type =
flash.events.InvokeEvent.INVOKE| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane, gdy aplikacja jest wywoływana.
Kiedy aplikacja jest wywoływana po raz drugi, nie jest otwierana kolejna instancja tej aplikacji. Zamiast tego pierwsza instancja otrzymuje dodatkowe zdarzenie wywołania. Do obowiązków aplikacji należy odpowiednia obsługa kolejnych zdarzeń invoke.
Uwaga: Wszystkie zdarzenia invoke są kolejkowane. Kiedy detektor dla tego zdarzenia jest rejestrowany, wówczas otrzymuje on wszystkie zdarzenia w kolejce oraz wszystkie nowe zdarzenia. Zdarzenia kolejkowane mogą być dostarczone przed lub po nowych zdarzeniach invoke.
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. |
keyDown | Zdarzenie |
flash.events.KeyboardEventwłaściwość KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane, gdy użytkownik naciśnie klawisz. Wystąpienie klasy NativeApplication udostępnia to zdarzenie na potrzeby obsługi skrótów klawiaturowych. To zdarzenie klawiatury jest wywoływane (wysyłane) najpierw do obiektu NativeApplication. Anulowanie tego zdarzenia powoduje również anulowanie skrótów menu obiektu NativeWindow. Zdarzenie to występuje przed zdarzeniem keyUp.
ScreenMouseEvent.KEY_DOWN definiuje wartość właściwości type obiektu zdarzenia keyDown.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | true |
cancelable | true w AIR, false w programie Flash Player; anulowanie zdarzenia w środowisku AIR zapobiega wprowadzeniu znaku do pola tekstowego. |
charCode | Kod znaku naciśniętego lub zwolnionego klawisza. |
commandKey | true w systemie Mac, jeśli klawisz Command jest aktywny. W przeciwnym razie false |
controlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemie Mac, jeśli którykolwiek klawisz Control jest aktywny. W przeciwnym razie false |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
keyCode | Kod znaku przypisanego do klawisza, który wciśnięto lub zwolniono. |
keyLocation | Położenie klawisza na klawiaturze. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
target | Instancja klasy InteractiveObject, która jest aktywna. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
Powiązane elementy interfejsu API
keyUp | Zdarzenie |
flash.events.KeyboardEventwłaściwość KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane, gdy użytkownik zwolni klawisz. Wystąpienie klasy NativeApplication udostępnia to zdarzenie na potrzeby obsługi skrótów klawiaturowych. To zdarzenie klawiatury jest wywoływane (wysyłane) najpierw do obiektu NativeApplication. Anulowanie tego zdarzenia nie ma wpływu na inne obiekty (takie jak skróty menu obiektu NativeWindow). Zdarzenie to ma miejsce po zdarzeniu keyDown.
ScreenMouseEvent.KEY_UP definiuje wartość właściwości type obiektu zdarzenia keyUp.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
charCode | Zawiera kod znaku przypisanego do klawisza, który wciśnięto lub zwolniono. |
commandKey | true w systemie Mac, jeśli klawisz Command jest aktywny. W przeciwnym razie false |
controlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemie Mac, jeśli którykolwiek klawisz Control jest aktywny. W przeciwnym razie false |
ctrlKey | true w systemach Windows, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
keyCode | Kod znaku przypisanego do klawisza, który wciśnięto lub zwolniono. |
keyLocation | Położenie klawisza na klawiaturze. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
target | Instancja klasy InteractiveObject, która jest aktywna. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
Powiązane elementy interfejsu API
networkChange | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.NETWORK_CHANGE| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane, gdy dostępne jest nowe połączenie sieciowe lub następuje utrata istniejącego połączenia sieciowego.
Zdarzenie networkChange nie koniecznie oznacza, że komputer host przeszedł w stan online lub offline. Możliwe, że jedynie przechodzi z jednego typu połączenia na drugi. Aplikacje mogą stosować to zdarzenie, aby pomóc optymalizować operację monitorowania dostępności zasobu zdalnego. Dyspozycja zdarzenia networkChange często jest odpowiednim momentem weryfikacji dostępności wszelkich zasobów zdalnych.
Uwagi:
- Uwaga: Możliwe jest niewielkie opóźnienie między zmianą sieci a dostarczeniem tego zdarzenia.
- W systemie Android obiekt NativeApplication może wywołać więcej niż jedno zdarzenie networkChange dla każdej zmiany połączenia sieciowego.
Event.NETWORK_CHANGE definiuje wartość właściwości type obiektu zdarzenia networkChange.
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 NativeApplication. |
suspend | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.SUSPEND| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3.3 |
Wywoływane tuż przed wstrzymaniem aplikacji przez system operacyjny.
StałaEvent.SUSPEND definiuje wartość właściwości type obiektu zdarzenia suspend. To zdarzenie jest wywoływane tylko w środowisku AIR for iOS.
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 NativeApplication. |
target | Obiekt NativeApplication. |
userIdle | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.USER_IDLE| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane, gdy użytkownik pozostawał bezczynny.
Właściwość idleThreshold określa czas, przez jaki użytkownik musi pozostawać bezczynny, aby zostało wywołane to zdarzenie. Czas, w którym użytkownik nie wykazywał aktywności, można określić za pomocą właściwości timeSinceLastUserInput.
Uwaga: To zdarzenie nie jest wywoływane na urządzeniach przenośnych ani na urządzeniach telewizyjnych ze środowiskiem AIR.
StałaEvent.USER_IDLE definiuje wartość właściwości type obiektu zdarzenia userIdle.
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ć. |
target | Obiekt NativeApplication. |
Powiązane elementy interfejsu API
userPresent | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.USER_PRESENT| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane, gdy system operacyjny wykrywa aktywność myszy lub klawiatury po bezczynności.
Uwaga: to zdarzenie nie jest wywoływane na urządzeniach przenośnych ani na urządzeniach telewizyjnych ze środowiskiem AIR.
Okres czasu, który jest uznawany za brak aktywności jest możliwy do konfiguracji we właściwości idleThreshold. Czas, w którym użytkownik nie wykazywał aktywności może być określony z właściwości timeSinceLastUserInput.
Event.USER_PRESENT definiuje wartość właściwości type obiektu zdarzenia userPresent.
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ć. |
target | Obiekt NativeApplication. |
Powiązane elementy interfejsu API
Tue Jun 12 2018, 12:06 PM Z