| Pakiet | flash.system |
| Klasa | public final class System |
| Dziedziczenie | System  Object |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Dodatkowe właściwości i metody są dostępne w innych klasach w pakiecie flash.system: Capabilities, IME oraz klasie Security.
Klasa zawiera tylko statyczne metody i właściwości. Nie można tworzyć nowych instancji klasy System.
Powiązane elementy interfejsu API
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| freeMemory : Number [statyczny] [tylko do odczytu]
Ilość pamięci (w bajtach), która została przydzielona dla programu Adobe® Flash® Player lub środowiska Adobe® AIR®, a obecnie nie jest wykorzystywana. | System | ||
| ime : IME [statyczny] [tylko do odczytu]
Aktualnie zainstalowany systemowy edytor IME. | System | ||
| privateMemory : Number [statyczny] [tylko do odczytu]
Całkowita ilość pamięci (w bajtach) używana przez aplikację. | System | ||
| totalMemory : uint [statyczny] [tylko do odczytu]
Ilość pamięci (w bajtach) obecnie używanej i bezpośrednio przydzielonej przez program Flash Player lub środowisko AIR. | System | ||
| totalMemoryNumber : Number [statyczny] [tylko do odczytu]
Ilość pamięci (w bajtach) obecnie używanej i bezpośrednio przydzielonej przez program Flash Player lub środowisko AIR. | System | ||
| useCodePage : Boolean [statyczny]
Wartość typu Boolean, która określa za pomocą jakiej strony kodowej będą interpretowane zewnętrzne pliki tekstowe. | System | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
[statyczny]
Powoduje, że określony obiekt XML staje się natychmiast dostępny do porządkowania pamięci. | System | ||
[statyczny]
Zamyka program Flash Player. | System | ||
[statyczny]
Wymusza proces gromadzenia elementów zbędnych. | System | ||
|
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 | |
[statyczny]
Wstrzymuje działanie programu Flash Player lub ADL (AIR Debug Launcher). | System | ||
[statyczny]
Sugeruje procesowi czyszczenia pamięci, że jeśli jego ustawienie terminu przekracza wartość parametru imminence funkcji, to proces czyszczenia powinien zakończyć cykl czyszczenia przyrostowego. | System | ||
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
[statyczny]
Wznawia działanie aplikacji po wywołaniu metody System.pause(). | System | ||
[statyczny]
Zastępuje zawartość schowka określonym ciągiem znaków. | System | ||
|
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 | |
freeMemory | właściwość |
freeMemory:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Ilość pamięci (w bajtach), która została przydzielona dla programu Adobe® Flash® Player lub środowiska Adobe® AIR®, a obecnie nie jest wykorzystywana. Wielkość nieużywanej części przydzielonej pamięci (System.totalMemory) ulega zmianom na skutek porządkowania pamięci. Ta właściwość umożliwia monitorowanie procesu porządkowania pamięci.
Implementacja
public static function get freeMemory():NumberPowiązane elementy interfejsu API
ime | właściwość |
ime:IME [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Aktualnie zainstalowany systemowy edytor IME. W celu zarejestrowania zdarzeń imeComposition należy wywołać metodę addEventListener() w tej instancji.
Implementacja
public static function get ime():IMEPowiązane elementy interfejsu API
privateMemory | właściwość |
privateMemory:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Całkowita ilość pamięci (w bajtach) używana przez aplikację. Jest to ilość rezydentnej pamięci prywatnej przydzielonej dla całego procesu.
Programiści piszący aplikacje dla środowiska AIR powinni korzystać z tej właściwości do określania ilości pamięci zużywanej przez ich aplikację.
W przypadku odtwarzacza Flash Player do podanej wartości wliczana jest pamięć używana przez aplikację będącą kontenerem odtwarzacza, np. przeglądarkę sieci Web.
Implementacja
public static function get privateMemory():NumberPowiązane elementy interfejsu API
totalMemory | właściwość |
totalMemory:uint [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ilość pamięci (w bajtach) obecnie używanej i bezpośrednio przydzielonej przez program Flash Player lub środowisko AIR.
Ta właściwość nie zwraca całej ilości pamięci używanej przez aplikację Adobe AIR lub przez aplikację (np. przeglądarkę) zawierającą treść odtwarzaną przez program Flash Player. Możliwe, że przeglądarka lub system operacyjny korzysta z dodatkowej pamięci. Właściwość System.privateMemory zawiera informację o całej pamięci używanej przez aplikację.
Jeśli przydzielona ilość pamięci jest większa od maksymalnej wartości obiektu uint (uint.MAX_VALUE czyli 4 294 967 295), ta właściwość jest ustawiana na 0. Właściwość System.totalMemoryNumber dopuszcza większe wartości.
Implementacja
public static function get totalMemory():uintPowiązane elementy interfejsu API
totalMemoryNumber | właściwość |
totalMemoryNumber:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Ilość pamięci (w bajtach) obecnie używanej i bezpośrednio przydzielonej przez program Flash Player lub środowisko AIR.
Ta właściwość należy do typu Number, dlatego dopuszcza większe wartości niż właściwość System.totalMemory należąca do typu int.
Ta właściwość nie zwraca całej ilości pamięci używanej przez aplikację Adobe AIR lub przez aplikację (np. przeglądarkę) zawierającą treść odtwarzaną przez program Flash Player. Możliwe, że przeglądarka lub system operacyjny korzysta z dodatkowej pamięci. Właściwość System.privateMemory zawiera informację o całej pamięci używanej przez aplikację.
Implementacja
public static function get totalMemoryNumber():NumberPowiązane elementy interfejsu API
useCodePage | właściwość |
useCodePage:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wartość typu Boolean, która określa za pomocą jakiej strony kodowej będą interpretowane zewnętrzne pliki tekstowe. Jeśli właściwość jest ustawiona na wartość false, zewnętrzne pliki tekstowe będą interpretowane jako kod Unicode. (Te pliki muszą zostać zakodowane jako Unicode podczas ich zapisywania). Jeśli dla tej właściwości ustawiona jest wartość true, zewnętrzne pliki tekstowe będą interpretowane za pomocą tradycyjnej strony kodowej systemu operacyjnego, w którym działa program. Domyślna wartość właściwości useCodePage to false.
Tekst ładowany jako plik zewnętrzny (za pomocą metody Loader.load(), klasy URLLoader lub klasy URLStream) należy zapisać jako kod Unicode — tylko wówczas aplikacja rozpozna go jako kod Unicode. Aby zapisywać pliki zewnętrzne w kodzie Unicode, należy zapisywać je w aplikacji, która obsługuje Unicode — np. w notatniku w systemie Windows.
W przypadku ładowania zewnętrznych plików tekstowych, które nie zostały zapisane przy użyciu kodowania Unicode, dla właściwości useCodePage należy ustawić wartość true. Dodaj poniższy kod jako pierwszy wiersz kodu w pliku, który ładuje dane (w programie Flash Professional dodaj kod do pierwszej klatki):
System.useCodePage = true;Jeśli ten kod jest obecny, aplikacja interpretuje tekst zewnętrzny przy użyciu tradycyjnej strony kodowej systemu operacyjnego. Jest to najczęściej strona CP1252 dla systemu operacyjnego Windows w języku angielskim i strona Shift-JIS dla systemu operacyjnego w języku japońskim.
Po ustawieniu dla właściwości useCodePage wartości true program Flash Player 6 i późniejsze wersje traktują tekst w taki sam sposób, jak program Flash Player 5. (Program Flash Player 5 traktował wszystkie teksty w taki sposób, jakby były zapisane za pomocą tradycyjnej strony kodowej systemu operacyjnego, w którym działa program).
W przypadku ustawienia dla właściwości useCodePage wartości true należy pamiętać o tym, że tradycyjna strona kodowa systemu operacyjnego, na którym działa aplikacja musi zawierać znaki używane w zewnętrznym pliku tekstowym — tylko wówczas możliwe będzie wyświetlanie tekstu. Na przykład: jeśli załadowany zostanie zewnętrzny plik tekstowy, który zawiera znaki języka chińskiego, nie pojawią się one w systemie o stronie kodowej CP1252, ponieważ ta strona kodowa nie zawiera znaków języka chińskiego.
Aby upewnić się, że użytkownicy wszystkich platform mogą wyświetlać zewnętrzne pliki tekstowe używane w aplikacji, należy kodować wszystkie zewnętrzne pliki tekstowe jako kod Unicode i pozostawić dla właściwości useCodePage wartość false. Dzięki temu aplikacja (program Flash Player w wersji 6 i późniejszych lub środowisko AIR) będzie interpretowała tekst jako Unicode.
Implementacja
public static function get useCodePage():Boolean public static function set useCodePage(value:Boolean):voidPowiązane elementy interfejsu API
disposeXML | () | metoda |
public static function disposeXML(node:XML):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 1.5.2 |
Powoduje, że określony obiekt XML staje się natychmiast dostępny do porządkowania pamięci. Ta metoda powoduje usunięcie wszystkich połączeń między określonym węzłem XML a jego węzłami nadrzędnymi i podrzędnymi.
Parametry
node:XML — Odwołanie do obiektu XML, który powinien być natychmiast udostępniony do porządkowania pamięci.
|
exit | () | metoda |
public static function exit(code:uint):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9.0.115.0 |
Zamyka program Flash Player.
Tylko dla wersji autonomicznego debugera programu Flash Player.
Aby zakończyć działanie aplikacji, aplikacje AIR powinny wywołać metodę NativeApplication.exit().
Parametry
code:uint — Wartość przekazywana do systemu operacyjnego. Zwykle, jeśli proces zostanie zakończony normalnie, wartość jest równa 0.
|
Powiązane elementy interfejsu API
gc | () | metoda |
public static function gc():void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Wymusza proces gromadzenia elementów zbędnych.
Tylko dla programu Flash Player w wersji z debugerem oraz aplikacji AIR. W aplikacjach AIR metodę System.gc() można uruchomić jedynie w treści działającej w programie ADL (AIR Debug Launcher) lub w treści obszaru izolowanego aplikacji (w zainstalowanej aplikacji).
pause | () | metoda |
public static function pause():void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Wstrzymuje działanie programu Flash Player lub ADL (AIR Debug Launcher). Po wywołaniu tej metody w aplikacji nie są wykonywane żadne operacje z wyjątkiem dostarczania zdarzeń Socket.
Tylko dla programu Flash Player w wersji z debugerem lub ADL (AIR Debug Launcher).
Powiązane elementy interfejsu API
pauseForGCIfCollectionImminent | () | metoda |
public static function pauseForGCIfCollectionImminent(imminence:Number = 0.75):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 11, AIR 3 |
Sugeruje procesowi czyszczenia pamięci, że jeśli jego ustawienie terminu przekracza wartość parametru imminence funkcji, to proces czyszczenia powinien zakończyć cykl czyszczenia przyrostowego.
Algorytm procesu czyszczenia pamięci środowiska wykonawczego Flash jest realizowany w sposób przyrostowy przy jednoczesnym oznaczaniu używanej pamięci. Wstrzymuje on wykonywanie aplikacji podczas gromadzenia nieużywanych części pamięci. Wstrzymanie wykonywania aplikacji występujące w momencie zakończenia cyklu gromadzenia przyrostowego może być dłuższe niż oczekiwane i może być zauważalne lub słyszalne w niektórych programach. Ta funkcja pozwala aplikacji zasugerować środowisku wykonawczemu, że należy zakończyć oznaczanie i przeprowadzić gromadzenie pamięci. Planowanie potencjalnych przerw w wykonywaniu aplikacji w momentach, w których użytkownik ich nie zauważy, poprawia komfort użytkowania programu przez użytkownika. Gra może na przykład wywoływać tę funkcję po ukończeniu poziomu przez gracza, taka aby zmniejszyć szansę wystąpienia przerwy podczas grania.
Argument imminence jest definiowany jako postęp w oznaczaniu zarejestrowany przez proces czyszczenia pamięci, a więc czas pozostały do wystąpienia przerwy na gromadzenie pamięci. Argument imminence dla tej funkcji jest wartością progową. Proces czyszczenia pamięci zostanie wywołany, jeśli rzeczywista wartość argumentu przekroczy wartość progową. W przeciwnym wypadku to wywołanie natychmiast kończy działanie i nie jest wykonywana żadna operacja.
Jeśli aplikacja wywołuje tę funkcję, używając niskiej wartości parametru imminence, wskazuje to na akceptację oznaczania dużej ilości pamięci. Wysoka wartość parametru imminence wskazuje, że działanie aplikacji ma być wstrzymywane tylko wtedy, gdy oznaczanie zostanie prawie ukończone. Zazwyczaj przerwy w działaniu w pierwszym przypadku są dłuższe od przerw w działaniu w drugim przypadku.
Ilość zwalnianej pamięci nie zależy od parametru imminence. Zależy jedynie od liczby obiektów, które można zwolnić. Jeśli aplikacja zwolniła w ostatnim czasie odniesienia do dużych struktur danych lub dużej liczby obiektów, niska wartość parametru imminence na ogół uruchamia proces gromadzenia, który powoduje natychmiastowe zwolnienie tych obiektów.
Parametry
imminence:Number (default = 0.75) |
resume | () | metoda |
public static function resume():void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Wznawia działanie aplikacji po wywołaniu metody System.pause().
Tylko dla programu Flash Player w wersji z debugerem lub ADL (AIR Debug Launcher).
Powiązane elementy interfejsu API
setClipboard | () | metoda |
public static function setClipboard(string:String):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Zastępuje zawartość schowka określonym ciągiem znaków. Ta metoda działa w każdym kontekście zabezpieczeń, jeśli wywoływana jest w wyniku zdarzenia użytkownika (np. moduł obsługi zdarzenia klawiatury lub urządzenia wskazującego).
Ta metoda jest udostępniana dla treści SWF uruchamianej w programie Flash Player 9. Umożliwia jedynie dodawanie treści typu String do schowka.
Metodę Clipboard.setData() może wywoływać treść programu Flash Player 10 oraz treść w obszarze izolowanym aplikacji AIR.
Parametry
string:String — Ciąg znaków zwykłego tekstu, jaki zostanie umieszczony w schowku systemowym i zastąpi aktualną zawartość (jeśli istnieje).
|
Powiązane elementy interfejsu API
System.totalMemory w ramach wywołania metody System.setClipboard().
package {
import flash.display.Sprite;
import flash.system.System;
public class SystemExample extends Sprite {
public function SystemExample() {
System.setClipboard("System.totalMemory: " + System.totalMemory);
}
}
}
Tue Jun 12 2018, 12:06 PM Z