| Paquete | flash.system |
| Clase | public final class System |
| Herencia | System  Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Las propiedades y métodos adicionales se encuentran en otras clases del paquete flash.system: clases Capabilities, Security e IME.
Esta clase sólo incluye propiedades y métodos estáticos. No se pueden crear nuevas instancias de la clase System.
Elementos de API relacionados
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
 | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| freeMemory : Number [estática] [solo lectura]
La cantidad de memoria (en bytes) que se asigna a Adobe® Flash® Player o Adobe® AIR® y que no está en uso. | System | ||
| ime : IME [estática] [solo lectura]
IME del sistema instalado actualmente. | System | ||
| privateMemory : Number [estática] [solo lectura]
Toda la cantidad de memoria (en bytes) que utiliza una aplicación. | System | ||
| totalMemory : uint [estática] [solo lectura]
La cantidad de memoria (en bytes) que utiliza actualmente que ha sido asignada directamente por Flash Player o AIR. | System | ||
| totalMemoryNumber : Number [estática] [solo lectura]
La cantidad de memoria (en bytes) que utiliza actualmente que ha sido asignada directamente por Flash Player o AIR. | System | ||
| useCodePage : Boolean [estática]
Valor booleano que indica qué página de código utilizar para interpretar archivos de texto externos. | System | ||
| Método | Definido por | ||
|---|---|---|---|
[estática]
Hace que el objeto XML especificado esté disponible inmediatamente para la recolección de elementos no utilizados. | System | ||
[estática]
Cierra Flash Player. | System | ||
[estática]
Obliga a efectuar el proceso de recolección de elementos no utilizados. | System | ||
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
[estática]
Detiene temporalmente Flash Player o ADL (AIR Debug Launcher). | System | ||
[estática]
Sugiere al recolector de datos innecesarios que si la inminencia del recolector supera el parámetro imminence de la función, el receptor debe finalizar el ciclo incremental de recolección. | System | ||
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
[estática]
Reanuda la aplicación tras llamar a System.pause(). | System | ||
[estática]
Reemplaza el contenido del portapapeles por una cadena de texto especificada. | System | ||
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
|
Devuelve la representación de cadena del objeto especificado. | Object | |
|
Devuelve el valor simple del objeto especificado. | Object | |
freeMemory | propiedad |
freeMemory:Number [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
La cantidad de memoria (en bytes) que se asigna a Adobe® Flash® Player o Adobe® AIR® y que no está en uso. Esta porción de memoria asignada sin utilizar (System.totalMemory) oscila cuando tiene lugar la recolección de elementos no utilizados. Utilice esta propiedad para supervisar la recolección de elementos no utilizados.
Implementación
public static function get freeMemory():NumberElementos de API relacionados
ime | propiedad |
ime:IME [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
IME del sistema instalado actualmente. Para registrar eventos imeComposition, llame a addEventListener() en esta instancia.
Implementación
public static function get ime():IMEElementos de API relacionados
privateMemory | propiedad |
privateMemory:Number [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
Toda la cantidad de memoria (en bytes) que utiliza una aplicación. Es la cantidad de memoria privada residente para todo el proceso.
Los desarrolladores de AIR deben utilizar esta propiedad para determinar todo el consumo de memoria de una aplicación.
En Flash Player, esto incluye la memoria utilizada por la aplicación contenedora, como por ejemplo, el navegador web.
Implementación
public static function get privateMemory():NumberElementos de API relacionados
totalMemory | propiedad |
totalMemory:uint [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La cantidad de memoria (en bytes) que utiliza actualmente que ha sido asignada directamente por Flash Player o AIR.
Esta propiedad no devuelve toda la memoria utilizada por una aplicación de Adobe AIR o por la aplicación (como un navegador) que contenga el contenido de Flash Player. El navegador o el sistema operativo pueden consumir otra memoria. La propiedad System.privateMemory refleja toda la memoria utilizada por una aplicación.
Si la cantidad de memoria asignada es mayor que el valor máximo de un objeto uint (uint.MAX_VALUE, o 4.294.967.295), esta propiedad se establece en 0. La propiedad System.totalMemoryNumber permite valores más grandes.
Implementación
public static function get totalMemory():uintElementos de API relacionados
totalMemoryNumber | propiedad |
totalMemoryNumber:Number [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
La cantidad de memoria (en bytes) que utiliza actualmente que ha sido asignada directamente por Flash Player o AIR.
Esta propiedad se expresa como un número, que permite valores más altos que la propiedad System.totalMemory, que es de tipo int.
Esta propiedad no devuelve toda la memoria utilizada por una aplicación de Adobe AIR o por la aplicación (como un navegador) que contenga el contenido de Flash Player. El navegador o el sistema operativo pueden consumir otra memoria. La propiedad System.privateMemory refleja toda la memoria utilizada por una aplicación.
Implementación
public static function get totalMemoryNumber():NumberElementos de API relacionados
useCodePage | propiedad |
useCodePage:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Valor booleano que indica qué página de código utilizar para interpretar archivos de texto externos. Si la propiedad se establece en false, los archivos de texto externos se interpretan como Unicode. (Estos archivos deben codificarse como Unicode al guardarlos.) Si la propiedad se establece en true, los archivos de texto externos se interpretan con la página de código tradicional del sistema operativo en el que se ejecuta en la aplicación. El valor predeterminado de useCodePage es false.
El texto cargado como archivo externo (con Loader.load() o con la clase URLLoader de URLStream) debe guardarse en formato Unicode para que la aplicación lo reconozca como Unicode. Para codificar archivos externos como Unicode, guárdelos en una aplicación que admita Unicode, como el Bloc de notas en Windows.
Si carga archivos de texto externos que no están codificados como Unicode, defina useCodePage como true. Añada el código siguiente como la primera línea de código del archivo que carga los datos (para Flash Professional, añádalo al primer fotograma):
System.useCodePage = true;Cuando este código está presente, la aplicación interpreta el texto externo empleando la página de códigos tradicional del sistema operativo en el que se ejecuta. Por ejemplo, suele ser CP1252 para el sistema operativo Windows en inglés y Shift-JIS para un sistema operativo en japonés.
Si establece useCodePage con el valor true, Flash Player 6 y versiones posteriores tratarán el texto de la misma forma que Flash Player 5. (Flash Player 5 consideraba todo el texto como si estuviera en la página de códigos tradicional del sistema operativo en el que se ejecuta el reproductor.)
Si define useCodePage como true, recuerde que la página de códigos tradicional del sistema operativo en el que se ejecuta la aplicación debe incluir los caracteres utilizados en el archivo de texto externo para que se muestre el texto. Por ejemplo, si carga un archivo de texto externo que contiene caracteres chinos, dichos caracteres no se visualizarán en un sistema que utilice la página de códigos CP1252, ya que dicha página no contiene caracteres chinos.
Para garantizar que los usuarios de todas las plataformas puedan ver los archivos de texto externos que se utilizan en la aplicación, debe codificar todos los archivos de texto externos como Unicode y establecer useCodePage en false. De esta forma, la aplicación (Flash Player 6 y versiones posteriores o AIR) interpreta el texto como Unicode.
Implementación
public static function get useCodePage():Boolean public static function set useCodePage(value:Boolean):voidElementos de API relacionados
disposeXML | () | método |
public static function disposeXML(node:XML):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 1.5.2 |
Hace que el objeto XML especificado esté disponible inmediatamente para la recolección de elementos no utilizados. Este método eliminará las conexiones principal y secundaria entre todos los nodos para el nodo XML especificado.
Parámetros
node:XML — Referencia XML que debe estar disponible para la recolección de elementos no utilizados.
|
exit | () | método |
public static function exit(code:uint):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9.0.115.0 |
Cierra Flash Player.
Sólo para la versión del depurador de Flash Player independiente.
Las aplicaciones de AIR deben llamar al método NativeApplication.exit() para salir de la aplicación.
Parámetros
code:uint — Valor que se transfiere al sistema operativo. Por lo general, si el proceso sale normalmente, el valor es 0.
|
Elementos de API relacionados
gc | () | método |
public static function gc():void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Obliga a efectuar el proceso de recolección de elementos no utilizados.
Sólo para la versión del depurador de Flash Player y para aplicaciones de AIR. En una aplicación de AIR, el método System.gc() sólo se activa si el contenido se ejecuta en ADL (AIR Debug Launcher) o (en el caso de una aplicación instalada) en el entorno limitado de seguridad.
pause | () | método |
public static function pause():void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Detiene temporalmente Flash Player o ADL (AIR Debug Launcher). Después de llamar a este método, no continúa nada en la aplicación, salvo el envío de eventos Socket.
Sólo para la versión del depurador de Flash Player o la versión de ADL (AIR Debug Launcher).
Elementos de API relacionados
pauseForGCIfCollectionImminent | () | método |
public static function pauseForGCIfCollectionImminent(imminence:Number = 0.75):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 11, AIR 3 |
Sugiere al recolector de datos innecesarios que si la inminencia del recolector supera el parámetro imminence de la función, el receptor debe finalizar el ciclo incremental de recolección.
El algoritmo del recolector de datos innecesarios del motor de ejecución de Flash se ejecuta de forma incremental mientras marca la memoria en uso. La ejecución de la aplicación se pone en pausa cuando se recolectan fragmentos no usados de memoria. La pausa que se produce cuando el ciclo de recolección incremental termina puede ser más larga de los deseado y puede ser observable o audible en algunos programas. Esta función permite a la aplicación aconsejar al motor de ejecución de que se trata de un buen momento para terminar el marcado y llevar a cabo recolección. Planificar pausas potenciales en momentos en los que el usuario no lo note, consigue una mejor experiencia de usuario. Por ejemplo, un juego puede llamar a esta función al terminar un nivel, con lo que se reducen también las posibilidades de una pausa durante el juego.
La inminencia se define como el nivel de progreso de marcado asumido por el recolector, esto es, cómo de cerca está de activar una pausa en la recolección. El argumento de inminencia en esta función es un umbral: el recolector de datos innecesarios se invoca sólo si la inminencia real supera el valor del umbral. De lo contrario, esta llamada se devuelve inmediatamente sin tomar medidas.
Por llamar a esta función con un valor de inminencia baja, la aplicación indica que está dispuesta a aceptar el procesamiento de una gran cantidad de marcado. Un valor de inminencia alto, por otro lado, indica que la aplicación debe ponerse en pausa sólo si el marcado está casi completo. Normalmente, las pausas son más largas en el primer caso que en el segundo.
La cantidad de memoria liberada no depende del parámetro de inminencia. Sólo depende del número de objetos liberables. Si la aplicación ha publicado recientemente referencias a grandes estructuras de datos o a un gran número de objetos, un parámetro de inminencia baja tiende a activar una colección que permitirá liberar esos objetos inmediatamente.
Parámetros
imminence:Number (default = 0.75) |
resume | () | método |
public static function resume():void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Reanuda la aplicación tras llamar a System.pause().
Sólo para la versión del depurador de Flash Player o la versión de ADL (AIR Debug Launcher).
Elementos de API relacionados
setClipboard | () | método |
public static function setClipboard(string:String):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Reemplaza el contenido del portapapeles por una cadena de texto especificada. Este método funciona en cualquier contexto de seguridad si se llama como resultado de un evento de usuario (por ejemplo, un controlador de eventos de teclado o de dispositivo de entrada).
Este método se suministra para contenido SWF ejecutado en Flash Player 9. Permite añadir solamente contenido String a Clipboard.
El contenido de Flash Player 10 y el del entorno limitado de seguridad de la aplicación en una aplicación de AIR puede llamar al método Clipboard.setData().
Parámetros
string:String — Cadena de texto normal que se sitúa en el portapapeles del sistema, reemplazando el contenido actual (si existe).
|
Elementos de API relacionados
System.totalMemory en una llamada al método 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:12 PM Z