Pakket | flash.system |
Klasse | public final class System |
Overerving | System Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Aanvullende eigenschappen en methoden bevinden zich in andere klassen in het flash.system-pakket: de klassen Capabilities, de klasse IME en de klasse Security.
Deze klasse bevat alleen statische methoden en eigenschappen. U kunt geen nieuwe instanties van de klasse System maken.
Verwante API-elementen
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
freeMemory : Number [statisch] [alleen-lezen]
De hoeveelheid geheugen (in bytes) die is toegewezen aan Adobe® Flash® Player of Adobe® AIR® en niet in gebruik is. | System | ||
ime : IME [statisch] [alleen-lezen]
De IME die momenteel op het systeem is geïnstalleerd. | System | ||
privateMemory : Number [statisch] [alleen-lezen]
De volledige geheugenhoeveelheid (in bytes) die door een toepassing wordt gebruikt. | System | ||
totalMemory : uint [statisch] [alleen-lezen]
De geheugenhoeveelheid (in bytes) die momenteel in gebruik is, is rechtstreeks toegewezen door Flash Player of AIR. | System | ||
totalMemoryNumber : Number [statisch] [alleen-lezen]
De geheugenhoeveelheid (in bytes) die momenteel in gebruik is, is rechtstreeks toegewezen door Flash Player of AIR. | System | ||
useCodePage : Boolean [statisch]
Een booleaanse waarde waarmee wordt bepaald welke codepagina moet worden gebruikt om externe tekstbestanden te interpreteren. | System |
Methode | Gedefinieerd door | ||
---|---|---|---|
[statisch]
Maakt het opgegeven XML-object direct beschikbaar voor het opruimproces. | System | ||
[statisch]
Sluit Flash Player. | System | ||
[statisch]
Dwingt het starten van de opschoonfunctie. | System | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
[statisch]
Pauzeert Flash Player of de AIR Debug Launcher (ADL). | System | ||
[statisch]
Informeert de opschoonfunctie dat deze de incrementele verzamelcyclus moet beëindigen als de imminence-parameter van de functie wordt overschreden door de imminence (nabijheid) van de opschoonfunctie. | System | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
[statisch]
Hervat de toepassing na het aanroepen van System.pause(). | System | ||
[statisch]
Vervangt de inhoud van het klembord door een opgegeven tekenreeks. | System | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | ||
Retourneert de primitieve waarde van het opgegeven object. | Object |
freeMemory | eigenschap |
freeMemory:Number
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10.1, AIR 2 |
De hoeveelheid geheugen (in bytes) die is toegewezen aan Adobe® Flash® Player of Adobe® AIR® en niet in gebruik is. Dit ongebruikte gedeelte van toegewezen geheugen (System.totalMemory
) schommelt wanneer het opruimproces plaatsvindt. Gebruik deze eigenschap om het opruimproces te controleren.
Implementatie
public static function get freeMemory():Number
Verwante API-elementen
ime | eigenschap |
ime:IME
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De IME die momenteel op het systeem is geïnstalleerd. U kunt gebeurtenissen voor imeComposition registreren door addEventListener()
aan te roepen op deze instantie.
Implementatie
public static function get ime():IME
Verwante API-elementen
privateMemory | eigenschap |
privateMemory:Number
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10.1, AIR 2 |
De volledige geheugenhoeveelheid (in bytes) die door een toepassing wordt gebruikt. Dit is de hoeveelheid resident privégeheugen voor het gehele proces.
AIR-ontwikkelaars moeten deze eigenschap gebruiken om het verbruik van het gehele geheugen van een toepassing te bepalen.
Voor Flash Player bevat dit ook het geheugen dat wordt gebruikt door de containertoepassing, zoals de webbrowser.
Implementatie
public static function get privateMemory():Number
Verwante API-elementen
totalMemory | eigenschap |
totalMemory:uint
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De geheugenhoeveelheid (in bytes) die momenteel in gebruik is, is rechtstreeks toegewezen door Flash Player of AIR.
Deze eigenschap retourneert niet alle geheugen dat door een Adobe AIR-toepassing wordt gebruikt of door de toepassing (zoals een browser) die Flash Player-inhoud bevat. De browser of het besturingssysteem kan ander geheugen verbruiken. De System.privateMemory
-eigenschap geeft alle geheugen weer dat door een toepassing wordt gebruikt.
Als de hoeveelheid toegewezen geheugen groter is dan de maximumwaarde voor een uint-object (uint.MAX_VALUE
of 4.294.967.295), wordt deze eigenschap ingesteld op 0. De eigenschap System.totalMemoryNumber
staat grotere waarden toe.
Implementatie
public static function get totalMemory():uint
Verwante API-elementen
totalMemoryNumber | eigenschap |
totalMemoryNumber:Number
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10.1, AIR 2 |
De geheugenhoeveelheid (in bytes) die momenteel in gebruik is, is rechtstreeks toegewezen door Flash Player of AIR.
Deze eigenschap wordt uitgedrukt als een getal, zodat hogere waarden dan de eigenschap System.totalMemory
, een type uint, mogelijk zijn.
Deze eigenschap retourneert niet alle geheugen dat door een Adobe AIR-toepassing wordt gebruikt of door de toepassing (zoals een browser) die Flash Player-inhoud bevat. De browser of het besturingssysteem kan ander geheugen verbruiken. De System.privateMemory
-eigenschap geeft alle geheugen weer dat door een toepassing wordt gebruikt.
Implementatie
public static function get totalMemoryNumber():Number
Verwante API-elementen
useCodePage | eigenschap |
useCodePage:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Een booleaanse waarde waarmee wordt bepaald welke codepagina moet worden gebruikt om externe tekstbestanden te interpreteren. Wanneer de eigenschap is ingesteld op false
, worden externe tekstbestanden geïnterpreteerd als Unicode. (deze bestanden moeten als Unicode worden gecodeerd wanneer u ze opslaat). Wanneer de eigenschap is ingesteld op true
, worden externe tekstbestanden geïnterpreteerd met de traditionele codepagina van het besturingssysteem waarop de toepassing wordt uitgevoerd. De standaardwaarde van useCodePage
is false
.
Tekst die u laadt als een extern bestand (met Loader.load()
, de klasse URLLoader of URLStream) moet als Unicode zijn opgeslagen om te zorgen dat de toepassing de tekst als Unicode herkent. Als u externe bestanden wilt coderen als Unicode, slaat u de bestanden op in een toepassing die Unicode ondersteunt, zoals Kladblok in Windows.
Wanneer u externe tekstbestanden laadt die niet als Unicode zijn gecodeerd, moet u useCodePage
instellen op true
. Voeg de volgende code toe als eerste coderegel van het bestand dat de gegevens laadt (in Flash Professional voegt u deze code toe aan het eerste frame):
System.useCodePage = true;
Wanneer deze code aanwezig is, wordt externe tekst in de toepassing geïnterpreteerd met de traditionele codepagina van het besturingssysteem. Dit is in het algemeen bijvoorbeeld CP1252 voor een Engelstalig Windows-besturingssysteem en Shift-JIS voor een Japans besturingssysteem.
Als u useCodePage
instelt op true
, wordt tekst in Flash Player 6 en hogere versies op dezelfde manier behandeld als in Flash Player 5. (In Flash Player 5 werd alle tekst behandeld alsof deze zich op de traditionele codepagina van het besturingssysteem bevond waarop de speler werd uitgevoerd).
Wanneer u useCodePage
instelt op true
, moet de traditionele codepagina van het besturingssysteem waarop de toepassing wordt uitgevoerd de tekens bevatten die worden gebruikt in het externe tekstbestand. Anders wordt de tekst niet weergegeven. Wanneer u een extern tekstbestand laadt dat Chinese tekens bevat, kunnen die tekens niet worden weergegeven op een systeem dat de codepagina CP1252 gebruikt omdat die codepagina geen Chinese tekens bevat.
Codeer alle externe tekstbestanden als Unicode en stel useCodePage
in op false
om te zorgen dat gebruikers op alle platforms de externe tekstbestanden kunnen weergeven die worden gebruikt in uw toepassing. Op die manier interpreteert de toepassing (Flash Player 6 en hoger of AIR) de tekst als Unicode.
Implementatie
public static function get useCodePage():Boolean
public static function set useCodePage(value:Boolean):void
Verwante API-elementen
disposeXML | () | methode |
public static function disposeXML(node:XML):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10.1, AIR 1.5.2 |
Maakt het opgegeven XML-object direct beschikbaar voor het opruimproces. Deze methode verwijdert bovenliggende en onderliggende verbindingen tussen alle knooppunten voor het opgegeven XML-knooppunt.
Parameters
node:XML — XML-referentie die beschikbaar moet worden gemaakt voor het opruimproces.
|
exit | () | methode |
public static function exit(code:uint):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9.0.115.0 |
Sluit Flash Player.
Alleen voor de zelfstandige foutopsporingsversie van Flash Player.
AIR-toepassingen moeten de methode NativeApplication.exit()
aanroepen om de toepassing af te sluiten.
Parameters
code:uint — Een waarde die wordt doorgegeven aan het besturingssysteem. Normaalgesproken is de waarde 0 als het proces normaal wordt afgesloten.
|
Verwante API-elementen
gc | () | methode |
public static function gc():void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Dwingt het starten van de opschoonfunctie.
Alleen voor de foutopsporingsversie van Flash Player en AIR-toepassingen. In een AIR-toepassing is de methode System.gc()
alleen ingeschakeld in inhoud die in de AIR Debug Launcher (ADL) wordt uitgevoerd of, in een geïnstalleerde toepassing, in inhoud in de beveiligingssandbox van de toepassing.
pause | () | methode |
public static function pause():void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Pauzeert Flash Player of de AIR Debug Launcher (ADL). Nadat deze methode is aangeroepen, wordt geen enkele bewerking in de toepassing voortgezet behalve de levering van gebeurtenissen Socket.
Alleen voor de debugger-versie van Flash Player of de AIR Debug Launcher (ADL).
Verwante API-elementen
pauseForGCIfCollectionImminent | () | methode |
public static function pauseForGCIfCollectionImminent(imminence:Number = 0.75):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 11, AIR 3 |
Informeert de opschoonfunctie dat deze de incrementele verzamelcyclus moet beëindigen als de imminence-parameter van de functie wordt overschreden door de imminence (nabijheid) van de opschoonfunctie.
Het algoritme van de Flash-runtime-opschoonfunctie wordt incrementeel uitgevoerd, waarbij het gebruikte geheugen wordt gemarkeerd. De uitvoering van de toepassing wordt onderbroken wanneer ongebruikte gedeelten van het geheugen worden verzameld. De onderbreking die optreedt wanneer de incrementele verzamelcyclus wordt beëindigd, kan langer zijn dan gewenst en kan in bepaalde programma's waarneembaar zijn. Met deze functie kan de toepassing de runtime meedelen dat het een goed moment is om het markeerproces te voltooien en het verzamelproces uit te voeren. Door mogelijke onderbrekingen te plannen op tijden waarop de gebruiker er niets van merkt, wordt de gebruikerservaring verbeterd. Een game kan deze functie bijvoorbeeld na voltooiing van een gameniveau aanroepen, zodat er minder kans is dat een onderbreking tijdens het spelen van de game plaatsvindt.
In deze context is 'imminence' te definiëren als de nabijheid van een door de opschoonfunctie geactiveerde verzamelonderbreking, gebaseerd op de mate van voortgang van het markeerproces. Het argument imminence voor deze functie is een drempel: de opschoonfunctie wordt alleen opgeroepen als de drempelwaarde wordt overschreden door de werkelijke nabijheid. Is dit niet het geval, dan wordt deze aanroep direct verwerkt en wordt geen actie uitgevoerd.
Als u deze functie aanroept met een lage imminence-waarde, geeft de toepassing aan dat wordt aanvaard dat een relatief groot aantal markeringen moet worden voltooid. Een hoge imminence-waarde daarentegen geeft aan dat de toepassing alleen moet worden gepauzeerd wanneer de markering bijna is voltooid. Pauzes duren normaal langer in het eerste geval dan in het laatste.
Het geheugen dat wordt vrijgemaakt is niet afhankelijk van de imminence-parameter. Het is alleen afhankelijk van het aantal objecten dat kan worden vrijgemaakt. Als de toepassing onlangs referenties naar grote gegevensstructuren of een groot aantal objecten vrijgegeven, zal een lage imminence-parameter proberen een verzameling uit te lokken die deze objecten onmiddellijk vrijmaakt.
Parameters
imminence:Number (default = 0.75 ) — Een waarde tussen 0 en 1, waarbij 0 minder imminent betekent en 1 het meest imminent. Waarden die kleiner zijn dan 0, worden standaard ingesteld op 0,25. Waarden die groter zijn dan 1,0, worden standaard ingesteld op 1,0. NaN-waarden worden ingesteld op 0,75.
|
resume | () | methode |
setClipboard | () | methode |
public static function setClipboard(string:String):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Vervangt de inhoud van het klembord door een opgegeven tekenreeks. Deze methode werkt in elke beveiligingscontext wanneer deze wordt opgeroepen als resultaat van een gebruikersgebeurtenis (bijvoorbeeld een gebeurtenishandler voor toetsenborden of invoerapparaten.)
Deze methode wordt gegeven voor SWF-inhoud die in Flash Player 9 wordt uitgevoerd. Er mag alleen inhoud uit tekenreeksen worden toegevoegd aan het klembord.
Inhoud van Flash Player 10 en inhoud in de beveiligingssandbox van de toepassing in een AIR-toepassing kan de methode Clipboard.setData()
aanroepen.
Parameters
string:String — Een tekenreeks met onbewerkte tekst die op het systeemklembord wordt geplaatst, waardoor de huidige inhoud wordt vervangen (indien aanwezig).
|
Verwante API-elementen
System.totalMemory
aan te roepen terwijl u de methode System.setClipboard()
aanroept.
package { import flash.display.Sprite; import flash.system.System; public class SystemExample extends Sprite { public function SystemExample() { System.setClipboard("System.totalMemory: " + System.totalMemory); } } }
Wed Jun 13 2018, 11:42 AM Z