| Pacchetto | flash.system |
| Classe | public final class System |
| Ereditarietà | System  Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ulteriori proprietà e metodi sono contenuti in altre classi del pacchetto flash.system: la classe Capabilities, la classe IME e la classe Security.
Questa classe contiene soltanto proprietà e metodi statici. Non è consentito creare nuove istanze della classe System.
Altri esempi
Elementi API correlati
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| freeMemory : Number [statico] [sola lettura]
La quantità di memoria (in byte) allocata per Adobe® Flash® Player o Adobe® AIR® e non utilizzata. | System | ||
| ime : IME [statico] [sola lettura]
L'IME di sistema attualmente installato. | System | ||
| privateMemory : Number [statico] [sola lettura]
L'intera quantità di memoria (in byte) utilizzata da un'applicazione. | System | ||
| totalMemory : uint [statico] [sola lettura]
La quantità di memoria (in byte) attualmente in uso allocata direttamente da Flash Player o AIR. | System | ||
| totalMemoryNumber : Number [statico] [sola lettura]
La quantità di memoria (in byte) attualmente in uso allocata direttamente da Flash Player o AIR. | System | ||
| useCodePage : Boolean [statico]
Un valore booleano che indica la tabella codici da utilizzare per interpretare i file di testo esterni. | System | ||
| Metodo | Definito da | ||
|---|---|---|---|
[statico]
Rende immediatamente disponibile l'oggetto XML specificato per la procedura di garbage collection. | System | ||
[statico]
Chiude Flash Player. | System | ||
[statico]
Forza il processo di garbage collection. | System | ||
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
[statico]
Mette in pausa Flash Player o AIR Debug Launcher (ADL). | System | ||
[statico]
Informa il garbage collector che se l'imminenza del collector supera il parametro imminence della funzione, il collector deve terminare il ciclo di raccolta incrementale. | System | ||
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
[statico]
Riprende l'applicazione dopo aver chiamato System.pause(). | System | ||
[statico]
Sostituisce il contenuto degli Appunti con una stringa di testo specificata. | System | ||
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
freeMemory | proprietà |
freeMemory:Number [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2 |
La quantità di memoria (in byte) allocata per Adobe® Flash® Player o Adobe® AIR® e non utilizzata. Questa parte inutilizzata della memoria allocata (System.totalMemory) varia mentre è in corso la procedura di garbage collection. Utilizzate questa proprietà per monitorare la procedura di garbage collection.
Implementazione
public static function get freeMemory():NumberElementi API correlati
ime | proprietà |
ime:IME [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
L'IME di sistema attualmente installato. Per registrarsi per gli eventi imeComposition, chiamare addEventListener() su questa istanza.
Implementazione
public static function get ime():IMEAltri esempi
Elementi API correlati
privateMemory | proprietà |
privateMemory:Number [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2 |
L'intera quantità di memoria (in byte) utilizzata da un'applicazione. Corrisponde alla quantità di memoria privata residente per l'intero processo.
Si consiglia agli sviluppatori AIR di utilizzare questa proprietà per determinare l'intero consumo di memoria di un'applicazione.
Per Flash Player, questo valore include la memoria utilizzata dall'applicazione contenitore, ad esempio browser Web.
Implementazione
public static function get privateMemory():NumberElementi API correlati
totalMemory | proprietà |
totalMemory:uint [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La quantità di memoria (in byte) attualmente in uso allocata direttamente da Flash Player o AIR.
Questa proprietà non restituisce tutta la memoria utilizzata da un'applicazione Adobe AIR o dall'applicazione (quale un browser) che include il contenuto di Flash Player. Il browser o il sistema operativo può consumare un'ulteriore quantità di memoria. La proprietà System.privateMemory riflette tutta la memoria utilizzata da un'applicazione.
Se la quantità di memoria allocata è maggiore del valore massimo per un oggetto uint (uint.MAX_VALUE o 4.294.967.295), questa proprietà è impostata su 0. La proprietà System.totalMemoryNumber consente valori più elevati.
Implementazione
public static function get totalMemory():uintAltri esempi
Elementi API correlati
totalMemoryNumber | proprietà |
totalMemoryNumber:Number [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2 |
La quantità di memoria (in byte) attualmente in uso allocata direttamente da Flash Player o AIR.
Questa proprietà viene espressa come tipo Number e consente quindi di utilizzare valori più elevati rispetto alla proprietà System.totalMemory, che è di tipo int.
Questa proprietà non restituisce tutta la memoria utilizzata da un'applicazione Adobe AIR o dall'applicazione (quale un browser) che include il contenuto di Flash Player. Il browser o il sistema operativo può consumare un'ulteriore quantità di memoria. La proprietà System.privateMemory riflette tutta la memoria utilizzata da un'applicazione.
Implementazione
public static function get totalMemoryNumber():NumberElementi API correlati
useCodePage | proprietà |
useCodePage:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un valore booleano che indica la tabella codici da utilizzare per interpretare i file di testo esterni. Quando questa proprietà è impostata su false, i file di testo esterni vengono interpretati come Unicode. (Questi file devono essere codificati come Unicode quando vengono salvati.) Quando la proprietà è impostata su true, i file di testo esterni vengono interpretati utilizzando la tabella codici tradizionale del sistema operativo su cui è in esecuzione l'applicazione. Il valore predefinito di useCodePage è false.
Il testo che viene caricato come file esterno (utilizzando Loader.load(), la classe URLLoader o URLStream) deve essere stato salvato come Unicode perché l'applicazione lo riconosca come Unicode. Per codificare i file esterni come Unicode, dovete salvarli in un'applicazione che supporti Unicode, ad esempio il Blocco note di Windows.
Se caricate file di testo esterni che non hanno codifica Unicode, impostate useCodePage su true. Aggiungete il codice seguente come prima riga di codice del file che sta caricando i dati (in Flash Professional, aggiungetelo al primo fotogramma):
System.useCodePage = true;Quando questo codice è impostato su true, l'applicazione interpreta il testo esterno utilizzando la tabella codici tradizionale del sistema operativo. Di solito si tratta, ad esempio, di CP1252 per i sistemi operativi Windows in inglese e Maiusc-JIS per i sistemi operativi giapponesi.
Se impostate useCodePage su true, Flash Player 6 e versioni successive considerano il testo in modo analogo a Flash Player 5, ovvero come se tutto il testo fosse codificato nella tabella codici tradizionale del sistema operativo su cui è in esecuzione il lettore.
Se impostate la proprietà useCodePage su true, tenete presente che la tabella codici tradizionale del sistema operativo su cui è in esecuzione l'applicazione deve includere i caratteri utilizzati nel file di testo esterno per consentire la visualizzazione del testo. Ad esempio, se caricate un file esterno contenente caratteri cinesi, questi caratteri non possono essere visualizzati su un sistema che utilizza la tabella codici CP1252, poiché questa tabella codici non include i caratteri cinesi.
Per garantire che gli utenti di tutte le piattaforme siano in grado di visualizzare i file di testo esterni utilizzati nell'applicazione, codificate tutti i file di testo esterni come Unicode e lasciate la proprietà useCodepage impostata su false. In tal modo, l'applicazione (Flash Player 6 e le versioni successive o AIR) interpretano il testo come Unicode.
Implementazione
public static function get useCodePage():Boolean public static function set useCodePage(value:Boolean):voidAltri esempi
Elementi API correlati
disposeXML | () | metodo |
public static function disposeXML(node:XML):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 1.5.2 |
Rende immediatamente disponibile l'oggetto XML specificato per la procedura di garbage collection. Questo metodo rimuove le connessioni principali e secondarie tra tutti i nodi per il nodo XML specificato.
Parametri
node:XML — Riferimento XML che deve essere reso disponibile per la procedura di garbage collection.
|
exit | () | metodo |
public static function exit(code:uint):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9.0.115.0 |
Chiude Flash Player.
Disponibile solo nella versione di debug autonoma di Flash Player.
Le applicazioni AIR devono chiamare il metodo NativeApplication.exit() per uscire dall'applicazione.
Parametri
code:uint — È un valore da passare al sistema operativo. Di solito se il processo si chiude normalmente, il valore è 0.
|
Elementi API correlati
gc | () | metodo |
public static function gc():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Forza il processo di garbage collection.
Disponibile solo nella versione di debug di Flash Player e nelle applicazioni AIR. In un'applicazione AIR, il metodo System.gc() viene abilitato esclusivamente nel contenuto in esecuzione in AIR Debug Launcher (ADL) o, in un'applicazione installata, nel contenuto che si trova nella sandbox di sicurezza dell'applicazione.
pause | () | metodo |
public static function pause():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Mette in pausa Flash Player o AIR Debug Launcher (ADL). Dopo aver richiamato questo metodo nell'applicazione vengono interrotte tutte le operazioni tranne gli eventi socket.
Solo per la versione di debug di Flash Player o per AIR Debug Launcher (ADL).
Elementi API correlati
pauseForGCIfCollectionImminent | () | metodo |
public static function pauseForGCIfCollectionImminent(imminence:Number = 0.75):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 11, AIR 3 |
Informa il garbage collector che se l'imminenza del collector supera il parametro imminence della funzione, il collector deve terminare il ciclo di raccolta incrementale.
L'algoritmo del garbage collector di Flash Runtime viene eseguito in modo incrementale mentre contrassegna la memoria in uso. Quando raccoglie parti di memoria inutilizzata, interrompe l'esecuzione dell'applicazione. La pausa che si verifica mentre viene completato il ciclo di raccolta incrementale può risultare più lunga di quanto sia auspicabile e può essere osservata o udita in alcuni programmi. Questa funzione consente all'applicazione di notificare al runtime che è un momento opportuno per completare l'operazione di contrassegno ed eseguire la raccolta. La pianificazione delle possibili pause in un momento in cui non vengono notate, consente di migliorare l'esperienza utente. Questa funzione può essere chiamata, ad esempio, da un gioco al completamento di un livello, riducendo in tal modo la possibilità che si verifichi una pausa durante l'esecuzione del gioco.
L'imminenza definisce la percentuale di completamento del processo di contrassegno percepita dal collector e, di conseguenza, quanto manca all'attivazione di una pausa durante la raccolta. L'argomento imminence per questa funzione è una soglia: il garbage collector verrà richiamato solo se l'imminenza effettiva supera il valore di soglia. In caso contrario, la chiamata restituisce immediatamente un valore senza eseguire alcuna azione.
Richiamando questa funzione con un valore di imminence basso, l'applicazione indica che è disponibile ad accettare che venga completata una quantità relativamente grande di operazioni di contrassegno. Un valore di imminence alto, d'altro canto, indica che l'applicazione deve essere messa in pausa solo se le operazioni di contrassegno sono quasi terminate. Generalmente, le pause sono più lunghe nel primo caso che nel secondo.
La quantità di memoria resa disponibile non dipende dal parametro di imminence. Dipende esclusivamente dal numero di oggetti che è possibile liberare. Se l'applicazione ha recentemente rilasciato riferimenti a grandi strutture di dati o a un elevato numero di oggetti, un parametro di imminence basso tenderà ad attivare una raccolta che libererà immediatamente tali oggetti.
Parametri
imminence:Number (default = 0.75) |
resume | () | metodo |
public static function resume():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Riprende l'applicazione dopo aver chiamato System.pause().
Solo per la versione di debug di Flash Player o per AIR Debug Launcher (ADL).
Elementi API correlati
setClipboard | () | metodo |
public static function setClipboard(string:String):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Sostituisce il contenuto degli Appunti con una stringa di testo specificata. Questo metodo funziona da ogni contesto di sicurezza quando viene chiamato come risultato di un evento utente (come un gestore di eventi tastiera o dispositivo di input).
Tale metodo viene fornito per contenuto SWF in esecuzione in Flash Player 9. Consente solo di aggiungere il contenuto dell'elemento String agli Appunti.
Il contenuto di Flash Player 10 e quello nella sandbox di sicurezza di un'applicazione AIR possono chiamare il metodo Clipboard.setData().
Parametri
string:String — Una stringa di testo normale contenente caratteri da inserire negli Appunti di sistema, che sostituisce l'eventuale contenuto presente.
|
Altri esempi
Elementi API correlati
System.totalMemory all'interno di una chiamata al metodo 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, 02:44 PM Z