System  - AS3

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.

Verwandte API-Elemente

Der derzeit installierte System-IME. Rufen Sie addEventListener() für diese Instanz auf, um imeComposition-Ereignisse zu registrieren.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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

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

Verwandte API-Elemente

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.

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

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

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

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

Verwandte API-Elemente