Paket | flash.system |
Klasse | public final class System |
Vererbung | System Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Weitere Eigenschaften und Methoden befinden sich in den folgenden anderen Klassen des flash.system-Pakets: in der Capabilities-Klasse, der IME-Klasse und der Security-Klasse.
Diese Klasse enthält lediglich statische Methoden und Eigenschaften. Sie können keine neuen Instanzen der System-Klasse erstellen.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
freeMemory : Number [statisch] [schreibgeschützt]
Der Speicherbetrag (in Byte), der Adobe® Flash® Player oder Adobe® AIR® zugewiesen wurde und der nicht genutzt wird. | System | ||
ime : IME [statisch] [schreibgeschützt]
Der derzeit installierte System-IME. | System | ||
privateMemory : Number [statisch] [schreibgeschützt]
Der gesamte Speicher (in Byte), der von einer Anwendung genutzt wird. | System | ||
totalMemory : uint [statisch] [schreibgeschützt]
Die Größe des zurzeit genutzten Speichers (in Byte), der direkt von Flash Player oder AIR zugewiesen wurde. | System | ||
totalMemoryNumber : Number [statisch] [schreibgeschützt]
Die Größe des zurzeit genutzten Speichers (in Byte), der direkt von Flash Player oder AIR zugewiesen wurde. | System | ||
useCodePage : Boolean [statisch]
Ein boolescher Wert, der bestimmt, welche Codepage in Flash Player zur Erkennung externer Textdateien verwendet werden soll. | System |
Methode | Definiert von | ||
---|---|---|---|
[statisch]
Macht das angegebene XML-Objekt sofort für die Speicherbereinigung verfügbar. | System | ||
[statisch]
Schließt Flash Player. | System | ||
[statisch]
Erzwingt den Garbagekollektor-Prozess. | System | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
[statisch]
Hält den Flash Player oder den AIR Debug Launcher (ADL) an. | System | ||
[statisch]
Teilt dem Garbage Collector mit, den inkrementellen Speicherräumungszyklus abzuschließen, wenn das nahe Bevorstehen des Collectors den imminence-Parameter der Funktion übersteigt. | System | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
[statisch]
Nimmt die Anwendung nach dem Aufrufen von System.pause() wieder auf. | System | ||
[statisch]
Ersetzt den Inhalt der Zwischenablage durch den angegebenen Textstring. | System | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
freeMemory | Eigenschaft |
freeMemory:Number
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Der Speicherbetrag (in Byte), der Adobe® Flash® Player oder Adobe® AIR® zugewiesen wurde und der nicht genutzt wird. Dieser nicht genutzte Teil des zugewiesenen Speichers (System.totalMemory
) ändert sich, wenn Garbage Collection (Speicherbereinigung) stattfindet. Verwenden Sie diese Eigenschaft, um die Garbage Collection zu überwachen.
Implementierung
public static function get freeMemory():Number
Verwandte API-Elemente
ime | Eigenschaft |
ime:IME
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Der derzeit installierte System-IME. Rufen Sie addEventListener()
für diese Instanz auf, um imeComposition-Ereignisse zu registrieren.
Implementierung
public static function get ime():IME
Verwandte API-Elemente
privateMemory | Eigenschaft |
privateMemory:Number
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Der gesamte Speicher (in Byte), der von einer Anwendung genutzt wird. Dies ist der Betrag des residenten privaten Speichers für den gesamten Prozess.
AIR-Entwickler sollten diese Eigenschaft verwenden, um den gesamten Speicherverbrauch einer Anwendung zu ermitteln.
Bei Flash Player gehört dazu auch der Speicher, der von der Containeranwendung, zum Beispiel vom Browser, verwendet wird.
Implementierung
public static function get privateMemory():Number
Verwandte API-Elemente
totalMemory | Eigenschaft |
totalMemory:uint
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Die Größe des zurzeit genutzten Speichers (in Byte), der direkt von Flash Player oder AIR zugewiesen wurde.
Diese Eigenschaft gibt nicht den gesamten Speicher zurück, der von einer Adobe AIR-Anwendung oder von der Anwendung, die den Flash Player-Inhalt enthält (zum Beispiel ein Browser) genutzt wird. Durch den Browser oder das Betriebssystem kann zusätzlicher Speicher belegt werden. Die System.privateMemory
-Eigenschaft gibt den gesamten Speicher an, der von einer Anwendung genutzt wird.
Wenn der Wert des zugewiesenen Speichers größer als der Höchstwert für ein uint-Objekt (uint.MAX_VALUE
, oder 4.294.967.295) ist, wird diese Eigenschaft auf 0 gesetzt. Die System.totalMemoryNumber
-Eigenschaft lässt größere Werte zu.
Implementierung
public static function get totalMemory():uint
Verwandte API-Elemente
totalMemoryNumber | Eigenschaft |
totalMemoryNumber:Number
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Die Größe des zurzeit genutzten Speichers (in Byte), der direkt von Flash Player oder AIR zugewiesen wurde.
Diese Eigenschaft wird als Typ „Number“ ausgedrückt, wodurch höhere Werte möglich sind als mit der System.totalMemory
-Eigenschaft, die den Typ „int“ aufweist.
Diese Eigenschaft gibt nicht den gesamten Speicher zurück, der von einer Adobe AIR-Anwendung oder von der Anwendung, die den Flash Player-Inhalt enthält (zum Beispiel ein Browser) genutzt wird. Durch den Browser oder das Betriebssystem kann zusätzlicher Speicher belegt werden. Die System.privateMemory
-Eigenschaft gibt den gesamten Speicher an, der von einer Anwendung genutzt wird.
Implementierung
public static function get totalMemoryNumber():Number
Verwandte API-Elemente
useCodePage | Eigenschaft |
useCodePage:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ein boolescher Wert, der bestimmt, welche Codepage in Flash Player zur Erkennung externer Textdateien verwendet werden soll. Wenn die Eigenschaft den Wert false
hat, werden externe Textdateien als Unicode interpretiert. (Diese Dateien müssen beim Speichern als Unicode kodiert werden.) Wenn die Eigenschaft auf true
gesetzt ist, werden externe Textdateien mit der herkömmlichen Codepage des Betriebssystems interpretiert, unter dem die Anwendung ausgeführt wird. Der Standardwert useCodePage
ist false
.
Text, den Sie als eine externe Datei laden (mit Loader.load()
, der URLLoader-Klasse oder URLStream), muss als Unicode gespeichert worden sein, damit die Anwendung ihn als Unicode erkennt. Wenn Sie externe Dateien als Unicode kodieren möchten, müssen Sie die Dateien in einer Anwendung speichern, die Unicode unterstützt, beispielsweise Notepad unter Windows.
Wenn Sie externe Textdateien laden, die nicht als Unicode kodiert sind, setzen Sie useCodePage
auf true
. Fügen Sie Folgendes als erste Codezeile der Datei, die die Daten lädt, hinzu (für Flash Professional, fügen Sie es dem ersten Bild hinzu):
System.useCodePage = true;
Wenn dieser Code vorhanden ist, werden externe Textdateien von der Anwendung mit der Standard-Codepage des Betriebssystems interpretiert. Unter einem deutschen Windows-Betriebssystem ist dies zum Beispiel im Allgemeinen CP1252, unter einem japanischen Betriebssystem Shift-JIS.
Wenn Sie useCodePage
auf true
setzen, wird Text in Flash Player 6 und aktuelleren Versionen wie in Flash Player 5 behandelt. (In Flash Player 5 wird Text so behandelt, als ob die herkömmliche Codepage des Betriebssystems verwendet wird, unter dem Flash Player ausgeführt wird.)
Wenn Sie useCodePage
auf true
setzen, müssen Sie darauf achten, dass die Standard-Codepage des Betriebssystems, unter dem die Anwendung ausgeführt wird, die in der externen Textdatei verwendeten Zeichen enthält, damit der Text angezeigt werden kann. Wenn Sie beispielsweise eine externe Textdatei mit chinesischen Zeichen laden, werden die Zeichen unter einem System mit der Codepage CP1252 nicht angezeigt, da diese Codepage keine chinesischen Zeichen enthält.
Sie können sicherstellen, dass die externen Textdateien in Ihrer Anwendung auf allen Plattformen angezeigt werden, indem Sie alle externen Textdateien als Unicode kodieren und useCodePage
auf false
gesetzt lassen. Somit wird der Text von der Anwendung (Flash Player 6 und höher oder AIR) als Unicode erkannt.
Implementierung
public static function get useCodePage():Boolean
public static function set useCodePage(value:Boolean):void
Verwandte API-Elemente
disposeXML | () | Methode |
public static function disposeXML(node:XML):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 1.5.2 |
Macht das angegebene XML-Objekt sofort für die Speicherbereinigung verfügbar. Diese Methode entfernt über- und untergeordnete Verbindungen zwischen allen Knoten für den angegebenen XML-Knoten.
Parameter
node:XML — XML-Referenz, die für die Speicherbereinigung verfügbar gemacht werden soll.
|
exit | () | Methode |
public static function exit(code:uint):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9.0.115.0 |
Schließt Flash Player.
Nur für die Debugger-Version des eigenständigen Flash Player.
AIR-Anwendungen sollten die NativeApplication.exit()
-Methode aufrufen, um die Anwendung zu beenden.
Parameter
code:uint — Ein Wert, der an das Betriebssystem übergeben wird. Wenn der Prozess normal beendet wurde, ist dieser Wert normalerweise 0.
|
Verwandte API-Elemente
gc | () | Methode |
public static function gc():void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Erzwingt den Garbagekollektor-Prozess.
Nur für die Debugger-Version von Flash Player und AIR-Anwendungen. In AIR-Anwendungen ist die System.gc()
-Methode nur in Inhalt aktiviert, der im AIR Debug Launcher (ADL) ausgeführt wird, bzw. in installierten Anwendungen in Inhalt in der Sicherheitssandbox der Anwendung.
pause | () | Methode |
public static function pause():void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Hält den Flash Player oder den AIR Debug Launcher (ADL) an. Nach dem Aufrufen dieser Methode wird in der Anwendung nichts fortgesetzt abgesehen von der Weitergabe von Socket-Ereignissen.
Nur für die Debugger-Version des Flash Player oder den AIR Debug Launcher (ADL).
Verwandte API-Elemente
pauseForGCIfCollectionImminent | () | Methode |
public static function pauseForGCIfCollectionImminent(imminence:Number = 0.75):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11, AIR 3 |
Teilt dem Garbage Collector mit, den inkrementellen Speicherräumungszyklus abzuschließen, wenn das nahe Bevorstehen des Collectors den imminence-Parameter der Funktion übersteigt.
Der Garbage Collector der Flash-Laufzeitumgebung wird inkrementell ausgeführt, während der verwendete Speicher markiert wird. Die Ausführung der Anwendung wird angehalten, wenn nicht verwendete Speicherbereiche bereinigt werden. Die Pause, die beim Beenden des inkrementellen Räumungszyklus auftritt, kann länger als erwünscht sein und ist in einigen Programmen sicht- oder hörbar. Diese Funktion ermöglicht es der Anwendung, der Laufzeitumgebung mitzuteilen, dass dies ein guter Zeitpunkt ist, um sowohl die Markierung abzuschließen als auch die Räumung auszuführen. Das Einplanen möglicher Pausen zu Zeiten, wenn sie der Benutzer nicht bemerkt, verbessert das Benutzererlebnis. Zum Beispiel könnte ein Spiel diese Funktion aufrufen, wenn ein Level des Spiels abgeschlossen ist, sodass es weniger wahrscheinlich ist, dass mitten im Spiel eine Pause auftritt.
„Imminence“ (nahes Bevorstehen) wird als der Fortschritt definiert, den der Collector nach seinem Dafürhalten gemacht hat, und demnach, wie nah das Auslösen einer Räumungspause ist. Das imminence-Argument für diese Funktion ist ein Schwellenwert: Der Garbage Collector wird nur aufgerufen, wenn die tatsächliche Imminence den Schwellenwert übersteigt. Andernfalls gibt dieser Aufruf sofort etwas zurück, ohne eine Aktion auszuführen.
Durch das Aufrufen dieser Funktion mit einem niedrigen imminence-Wert zeigt die Anwendung an, dass sie bereit ist zu akzeptieren, dass eine relativ große Menge an Markierungen abgeschlossen werden muss. Ein hoher imminence-Wert zeigt dagegen an, dass die Anwendung nur angehalten werden soll, wenn die Markierung nahezu abgeschlossen ist. In ersterem Fall sind die Pausen länger als in letzterem Fall.
Die Menge des verfügbar gemachten Speichers ist nicht vom imminence-Parameter abhängig. Sie richtet sich allein nach der Anzahl der verfügbar zu machenden Objekte. Wenn die Anwendung kürzlich Verweise auf große Datenstrukturen oder auf eine große Anzahl von Objekten ausgegeben hat, löst ein niedriger imminence-Parameter eher eine Speicherräumung aus, die diese Objekte unverzüglich verfügbar macht.
Parameter
imminence:Number (default = 0.75 ) — Eine Zahl zwischen 0 und 1, wobei 0 weniger imminent und 1 sehr imminent bedeutet. Bei Werten unter null wird standardmäßig 0.25 verwendet. Bei Werten über 1.0 wird standardmäßig 1.0 verwendet. Bei NaN wird standardmäßig 0.75 verwendet
|
resume | () | Methode |
public static function resume():void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Nimmt die Anwendung nach dem Aufrufen von System.pause()
wieder auf.
Nur für die Debugger-Version des Flash Player oder den AIR Debug Launcher (ADL).
Verwandte API-Elemente
setClipboard | () | Methode |
public static function setClipboard(string:String):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Ersetzt den Inhalt der Zwischenablage durch den angegebenen Textstring. Diese Methode funktioniert von jedem Sicherheitskontext, wenn sie als Ergebnis des Benutzerereignisses (z. B. eine Tastatur- Eingabegerät-Ereignisprozedur) aufgerufen wird.
Diese Methode wird für SWF-Inhalt bereitgestellt, der in Flash Player 9 ausgeführt wird. Sie erlaubt nur das Hinzufügen von Stringinhalt zur Zwischenablage.
Flash Player 10-Inhalt und Inhalt in der Sicherheitssandbox der Anwendung in einer AIR-Anwendung können die Clipboard.setData()
-Methode aufrufen.
Parameter
string:String — Ein String mit Klartextzeichen, der in der Zwischenablage des Systems abgelegt wird und den aktuellen Inhalt (sofern vorhanden) ersetzt.
|
Verwandte API-Elemente
System.totalMemory
in einem Aufruf der System.setClipboard()
-Methode kopieren.
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, 10:04 AM Z