Pacote | flash.system |
Classe | public final class System |
Herança | System Object |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
As propriedades adicionais e os métodos estão dentro do pacote flash.system em outras classes: a classe Capabilities, a classe IME, e a classe Security.
Esta classe contém apenas propriedades e métodos estáticos. Você não pode criar novas ocorrências da classe System.
Elementos da API relacionados
Propriedade | Definido por | ||
---|---|---|---|
constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | ||
freeMemory : Number [estático] [somente leitura]
A quantidade de memória (em bytes) que é alocada para Adobe® Flash® Player ou Adobe® AIR® e que não está em uso. | System | ||
ime : IME [estático] [somente leitura]
O IME do sistema instalado atualmente. | System | ||
privateMemory : Number [estático] [somente leitura]
A quantidade de memória total (em bytes) usada por um aplicativo. | System | ||
totalMemory : uint [estático] [somente leitura]
A quantidade de memória (em bytes) atualmente em uso que foi diretamente separada pelo Flash Player ou AIR. | System | ||
totalMemoryNumber : Number [estático] [somente leitura]
A quantidade de memória (em bytes) atualmente em uso que foi diretamente separada pelo Flash Player ou AIR. | System | ||
useCodePage : Boolean [estático]
Um valor booliano que determina qual a página de código a ser usada para interpretar arquivos de texto externos. | System |
Método | Definido por | ||
---|---|---|---|
[estático]
Torna o objeto XML especificado imediatamente disponível para a coleta de lixo. | System | ||
[estático]
Fecha o Flash Player. | System | ||
[estático]
Força o processo de coleta de lixo. | System | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
[estático]
Pausa o Flash Player ou o AIR Debug Launcher (ADL). | System | ||
[estático]
Sugere ao coletor de lixo que, se a proximidade do coletor de lixo ultrapassar o parâmetro de proximidade da função, o coletor deve finalizar o ciclo de coleta incremental. | System | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
[estático]
Reinicia o aplicativo após a chamada de System.pause(). | System | ||
[estático]
Substitui o conteúdo da área de transferência por uma string de texto especificada. | System | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | ||
Retorna a representação de string do objeto especificado. | Object | ||
Retorna o valor primitivo do objeto especificado. | Object |
freeMemory | propriedade |
freeMemory:Number
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10.1, AIR 2 |
A quantidade de memória (em bytes) que é alocada para Adobe® Flash® Player or Adobe® AIR® e que não está em uso. Esta porção não usada de memória alocada (System.totalMemory
) flutua à medida que a coleta de resíduos ocorre. Use esta propriedade para controlar a coleta de resíduo.
Implementação
public static function get freeMemory():Number
Elementos da API relacionados
ime | propriedade |
ime:IME
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O IME do sistema instalado atualmente. Para registrar em eventos imeComposition, chame o addEventListener()
nessa ocorrência.
Implementação
public static function get ime():IME
Elementos da API relacionados
privateMemory | propriedade |
privateMemory:Number
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10.1, AIR 2 |
A quantidade de memória total (em bytes) usada por um aplicativo. Isto é a quantidade da memória separada residente para todo o processo.
Os desenvolvedores de AIR devem usar esta propriedade para determinar o consumo de memória total de um aplicativo.
Para Flash Player, isto inclui a memória usada pelo aplicativo do caontainer, como o navegador.
Implementação
public static function get privateMemory():Number
Elementos da API relacionados
totalMemory | propriedade |
totalMemory:uint
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A quantidade de memória (em bytes) atualmente em uso que foi diretamente separada pelo Flash Player ou AIR.
Esta propriedade não retorna toda memória usada por um aplicativo do Adobe AIR ou pelo aplicativo (como um navegador) contendo o conteúdo do Flash Player. O navegador ou o sistema operacional pode consumir outra memória. A propriedade System.privateMemory
reflete toda a memória usada por um aplicativo.
Se a quantidade de memória separada for maior do que o valor máximo de um objeto de uint (uint. MAX_VALUE
, ou 4.294.967.295), então esta propriedade é definida para 0. A propriedade System.totalMemoryNumber
ermite valores maiores.
Implementação
public static function get totalMemory():uint
Elementos da API relacionados
totalMemoryNumber | propriedade |
totalMemoryNumber:Number
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10.1, AIR 2 |
A quantidade de memória (em bytes) atualmente em uso que foi diretamente separada pelo Flash Player ou AIR.
Esta propriedade é expressa como um Número, que permite valores maiores do que a propriedade System.totalMemory
, que é do tipo int.
Esta propriedade não retorna toda memória usada por um aplicativo do Adobe AIR ou pelo aplicativo (como um navegador) contendo o conteúdo do Flash Player. O navegador ou o sistema operacional pode consumir outra memória. A propriedade System.privateMemory
reflete toda a memória usada por um aplicativo.
Implementação
public static function get totalMemoryNumber():Number
Elementos da API relacionados
useCodePage | propriedade |
useCodePage:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Um valor booliano que determina qual a página de código a ser usada para interpretar arquivos de texto externos. Quando a propriedade for definida como false
, os arquivos de texto externos serão interpretados como Unicode. (Esses arquivos devem ser codificados como Unicode quando você os salva). Quando a propriedade está definida como true
, os arquivos de texto externos são interpretados usando a página de código tradicional do sistema operacional que executa o aplicativo. O valor padrão de useCodePage
é false
.
O texto carregado como arquivo externo (usando a classe Loader.load()
, URLLoader ou URLStream) deve ter sido salvo como Unicode para que o aplicativo o reconheça como Unicode. Para codificar arquivos externos como Unicode, salve-os em um aplicativo que ofereça suporte a Unicode, como Bloco de notas do Windows.
Se você carregar arquivos de texto externos que não sejam codificados como Unicode, defina o useCodePage
como true
. Adicione o seguinte como a primeira linha de código do arquivo que está carregando os dados (no Flash Professional, adicione-o ao primeiro quadro):
System.useCodePage = true;
Quando esse código está presente, o aplicativo interpreta o texto externo usando a página de código tradicional do sistema operacional que executa o sistema operacional. Por exemplo, geralmente, é CP1252 em um sistema operacional Windows em inglês e Shift-JIS em um sistema operacional japonês.
Se você definir useCodePage
como true
, o Flash Player 6 e superior tratarão o texto como o Flash Player 5 o trata. (O Flash Player 5 tratava todos os textos como se estivessem na página de código tradicional do sistema operacional que executava o player.)
Se você definir useCodePage
como true
, lembre-se de que a página de código tradicional do sistema operacional que executa o aplicativo deve incluir os caracteres usados no arquivo de texto externo para que o texto seja exibido. Por exemplo, se você carregar um arquivo de texto externo com caracteres chineses, esses caracteres não poderão ser exibidos em um sistema que use a página de código CP1252, pois essa página de código não inclui caracteres chineses.
Para assegurar que todos os usuários de todas as plataformas possam visualizar arquivos de texto externos usados no aplicativo, você deverá codificar todos os arquivos de texto externos como Unicode e deixar useCodePage
definido como false
. Dessa maneira, o aplicativo (Flash Player 6 e posterior ou AIR) interpreta o texto como Unicode.
Implementação
public static function get useCodePage():Boolean
public static function set useCodePage(value:Boolean):void
Elementos da API relacionados
disposeXML | () | método |
public static function disposeXML(node:XML):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10.1, AIR 1.5.2 |
Torna o objeto XML especificado imediatamente disponível para a coleta de lixo. Este método removerá conexões filho e pai entre todos os nós do nó XML especificado.
Parâmetros
node:XML — A referência de XML que deve se tornar disponível para a coleta de resíduos.
|
exit | () | método |
public static function exit(code:uint):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9.0.115.0 |
Fecha o Flash Player.
Somente para a versão independente de depurador do Flash Player.
Os aplicativos AIR devem chamar o método NativeApplication.exit()
para sair do aplicativo.
Parâmetros
code:uint — Um valor para ser transmitido ao sistema operacional. Geralmente, se o processo for encerrado de maneira normal, o valor será 0.
|
Elementos da API relacionados
gc | () | método |
public static function gc():void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Força o processo de coleta de lixo.
Somente para a versão de depuração do Flash Player e aplicativos AIR. Em um aplicativo AIR, o método System.gc()
somente é ativado no conteúdo em execução no AIR Debug Launcher (ADL) ou em um aplicativo instalado no conteúdo da área de segurança do aplicativo.
pause | () | método |
public static function pause():void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Pausa o Flash Player ou o AIR Debug Launcher (ADL). Depois de chamar esse método, nada mais no aplicativo continuará, exceto a remessa de eventos Socket.
Somente para a versão de depuração do Flash Player ou do AIR Debug Launcher (ADL).
Elementos da API relacionados
pauseForGCIfCollectionImminent | () | método |
public static function pauseForGCIfCollectionImminent(imminence:Number = 0.75):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 11, AIR 3 |
Sugere ao coletor de lixo que, se a proximidade do coletor de lixo ultrapassar o parâmetro de proximidade da função, o coletor deve finalizar o ciclo de coleta incremental.
O algoritmo de coletor de lixo do Flash Runtime executa com incremento marcando memória em uso. Ele faz uma pausa na execução do aplicativo reunindo partes não utilizadas da memória. A pausa que ocorre quando o ciclo de coleção incremental termina pode ser mais longa do que desejado e pode ser observável ou audível em alguns programas. Esta função permite ao aplicativo avisar que o tempo de execução é uma boa hora tanto para concluir a marcação como executar a coleção. Planejar pausas potenciais de horas quando o usuário não as notará torna a experiência do usuário melhor. Por exemplo, um jogo poderia invocar esta função depois da conclusão de um nível em um jogo, assim reduzindo as possibilidades de uma pausa ocorrer durante o gameplay.
A iminência é definida o quão distante a marcação do coletar acredita que é, e por isso o quão perto para disparar a pausa de coleção. O argumento de iminência para esta função é um limite: o coletor de lixo será invocado somente se a iminência real exceder o valor de limite. De outra maneira, esta chamada retorna imediatamente sem tomar medidas.
Ao chamar esta função com um valor de iminência baixo, o aplicativo indica que está disposto a reconhecer que uma quantidade relativamente grande de marcações deve ser concluída. Um alto valor de iminência, de outro lado, indica que o aplicativo deverá fazer uma pausa somente se a marcação estiver quase concluída. Normalmente, as pausas são mais longas nesse caso do que naquele.
A quantidade de memória liberada não depende do parâmetro de iminência. Só depende do número de objetos de liberáveis. Se o aplicativo tiver liberado referências recentemente para grandes estruturas de dados ou a um grande número de objetos, um parâmetro de iminência baixo tenderá a acionar uma coleção que liberará aqueles objetos imediatamente.
Parâmetros
imminence:Number (default = 0.75 ) — Um número entre 0 e 1 onde 0 significa menos iminente e 1 mais iminente. Valores padrão menores que 0 a 0,25. Valores padrão maiores ou iguais a 1,0. Padrões de NaN até 0,75.
|
resume | () | método |
public static function resume():void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Reinicia o aplicativo após a chamada de System.pause()
.
Somente para a versão de depuração do Flash Player ou do AIR Debug Launcher (ADL).
Elementos da API relacionados
setClipboard | () | método |
public static function setClipboard(string:String):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Substitui o conteúdo da área de transferência por uma string de texto especificada. Esse método funciona em qualquer contexto de segurança quando é chamado como resultado de evento de usuário (por exemplo, manipulador do evento de teclado ou de dispositivo de entrada).
Esse método é fornecido para o conteúdo SWF em execução no Flash Player 9. Ele só permite a adição de conteúdo String à Área de Transferência.
O conteúdo do Flash Player 10 e do conteúdo na área de segurança do aplicativo em um aplicativo do AIR podem chamar o método Clipboard.setData()
.
Parâmetros
string:String — String de texto sem formatação para ser colocada na área de transferência do sistema, substituindo o respectivo conteúdo atual (se houver).
|
Elementos da API relacionados
System.totalMemory
em uma chamada do 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); } } }
Wed Jun 13 2018, 11:10 AM Z