Пакет | flash.system |
Класс | public final class System |
Наследование | System Object |
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Дополнительные свойства и методы находятся в других классах пакета flash.system: класс Capabilities, класс IME и класс Security.
Этот класс содержит только статические методы и свойства. Невозможно создать новые экземпляры класса System.
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
freeMemory : Number [статические] [только для чтения]
Объем памяти (в байтах), который выделен для Adobe® Flash® Player или Adobe® AIR® и не используется в данный момент. | System | ||
ime : IME [статические] [только для чтения]
Текущая установленная система IME. | System | ||
privateMemory : Number [статические] [только для чтения]
Весь объем памяти (в байтах), используемый приложением. | System | ||
totalMemory : uint [статические] [только для чтения]
Используемый в данным момент объем памяти (в байтах), который выделен непосредственно средой Flash Player или AIR. | System | ||
totalMemoryNumber : Number [статические] [только для чтения]
Используемый в данным момент объем памяти (в байтах), который выделен непосредственно средой Flash Player или AIR. | System | ||
useCodePage : Boolean [статические]
Значение типа Boolean, указывающее кодовую страницу, которую следует использовать для интерпретации внешних текстовых файлов. | System |
Метод | Определено | ||
---|---|---|---|
[статические]
Объект XML сразу же становится доступным для сборки мусора. | System | ||
[статические]
Закрывает проигрыватель Flash Player. | System | ||
[статические]
Запускает процесс очистки. | System | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
[статические]
Устанавливает паузу в работе Flash Player или AIR Debug Launcher (ADL). | System | ||
[статические]
Предлагает сборщику мусора завершения инкрементного цикла сборки, если превышено значение параметра приближения функции. | System | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
[статические]
Возобновляет работу приложения после вызова метода System.pause(). | System | ||
[статические]
Заменяет содержимое буфера обмена заданной текстовой строкой. | System | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
Возвращает элементарное значение заданного объекта. | Object |
freeMemory | свойство |
freeMemory:Number
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Объем памяти (в байтах), который выделен для Adobe® Flash® Player или Adobe® AIR® и не используется в данный момент. Эта неиспользованная часть выделенной памяти (System.totalMemory
) меняется по мере «сбора мусора». Используйте это свойство для отслеживания «сбора мусора»
Реализация
public static function get freeMemory():Number
Связанные элементы API
ime | свойство |
ime:IME
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Текущая установленная система IME. Чтобы подписаться на события imeComposition, вызовите addEventListener()
для этого экземпляра.
Реализация
public static function get ime():IME
Связанные элементы API
privateMemory | свойство |
privateMemory:Number
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Весь объем памяти (в байтах), используемый приложением. Это объем резидентной памяти всего процесса
Разработчикам AIR следует использовать это свойство для определения общего потребления памяти приложением.
Для Flash Player это значение включает память, используемую приложением-контейнером, например веб-браузером.
Реализация
public static function get privateMemory():Number
Связанные элементы API
totalMemory | свойство |
totalMemory:uint
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Используемый в данным момент объем памяти (в байтах), который выделен непосредственно средой Flash Player или AIR.
Это свойство не указывает весь объем памяти, используемый приложением Adobe AIR или приложением (например, браузером), в котором выполняется содержимое Flash Player. Браузер или операционная система может использовать остальную часть памяти. Свойство System.privateMemory
отражает весь объем памяти, используемый приложением.
Если выделенный объем памяти превышает максимальное значение для объекта uint (uint.MAX_VALUE
, или 4294967295), тогда это свойство получает значение 0. Свойство System.totalMemoryNumber
допускает использование объема памяти, превышающего это значение.
Реализация
public static function get totalMemory():uint
Связанные элементы API
totalMemoryNumber | свойство |
totalMemoryNumber:Number
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Используемый в данным момент объем памяти (в байтах), который выделен непосредственно средой Flash Player или AIR.
Это свойство представлено объектом Number, который позволяет использовать более высокие значения, чем свойство System.totalMemory
, которое представлено целым числом.
Это свойство не указывает весь объем памяти, используемый приложением Adobe AIR или приложением (например, браузером), в котором выполняется содержимое Flash Player. Браузер или операционная система может использовать остальную часть памяти. Свойство System.privateMemory
отражает весь объем памяти, используемый приложением.
Реализация
public static function get totalMemoryNumber():Number
Связанные элементы API
useCodePage | свойство |
useCodePage:Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Значение типа Boolean, указывающее кодовую страницу, которую следует использовать для интерпретации внешних текстовых файлов. Если это свойство имеет значение false
, при интерпретации внешних текстовых файлов используется кодировка Юникод. (Эти файлы должны быть в кодировке Юникод при сохранении.) Если для этого свойства задано значение true
, внешние текстовые файлы интерпретируются с помощью стандартной кодовой страницы операционной системы, в которой выполняется приложение. По умолчанию для свойства useCodePage
задано значение false
.
Текст, загружаемый как внешний файл (с помощью Loader.load()
, класса URLLoader или класса URLStream), должен быть сохранен в кодировке Юникод, чтобы приложение правильно распознало его. Чтобы изменить кодировку внешних файлов на Юникод, сохраните их в приложении, поддерживающем эту кодировку, например с помощью программы блокнот в Windows.
При загрузке внешних текстовых файлов, кодировка которых не Юникод, установите для свойства useCodePage
значение true
. Добавьте следующий фрагмент в качестве первой строки кода в файле, который загружает данные (для Flash Professional эту строку нужно добавить в первый кадр):
System.useCodePage = true;
Если имеется эта кодировка, приложение интерпретирует внешний текст с помощью стандартной кодовой страницы операционной системы. Например, это обычно бывает кодировка CP1252 для английской версии операционной системы Windows и Shift-JIS для японской операционной системы.
Если для свойства useCodePage
установить значение true
, в проигрывателе Flash Player 6 и более поздних версиях обрабатывают текст также, как проигрыватель Flash Player 5. (Проигрыватель Flash Player 5 обрабатывает все тексты таким образом, как если бы они все были в стандартной кодировке операционной системы, в которой запущен проигрыватель.)
Если для свойства useCodePage
установлено значение true
, помните, что стандартная кодовая страница операционной системы, в которой выполняется приложение, должна включать символы, используемые во внешнем текстовом файле, чтобы можно было отобразить данный текст. Например, если загружается внешний текстовый файл, содержащий китайские символы, эти символы невозможно отобразить в системе, где используется кодовая страница CP1252, поскольку она не содержит символов для китайского языка.
Чтобы обеспечить пользователям на всех платформах возможность просматривать внешние текстовые файлы, используемые в вашем приложении, необходимо использовать в этих текстовых файлах кодировку Юникод и оставить для свойства useCodePage
значение false
. Таким образом приложение (Flash Player 6 и более поздних версий или AIR) интерпретирует текст как Юникод.
Реализация
public static function get useCodePage():Boolean
public static function set useCodePage(value:Boolean):void
Связанные элементы API
disposeXML | () | метод |
public static function disposeXML(node:XML):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 1.5.2 |
Объект XML сразу же становится доступным для сборки мусора. С помощью этого метода удаляются родительские и дочерние соединения всех узлов указанного узла XML.
Параметры
node:XML — Ссылка XML, которую необходимо сделать доступной для сборки мусора.
|
exit | () | метод |
public static function exit(code:uint):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.115.0 |
Закрывает проигрыватель Flash Player.
Только для отладочной версии проигрывателя Flash Player.
Чтобы выйти из приложения, приложения AIR должны вызвать метод NativeApplication.exit()
.
Параметры
code:uint — Значение, передаваемое в операционную систему. Обычно, если процесс нормально завершается, это значение равно 0.
|
Связанные элементы API
gc | () | метод |
public static function gc():void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Запускает процесс очистки.
Только для отладочной версии Flash Player и приложений AIR. В приложении AIR метод System.gc()
работает только в содержимом, выполняющемся в AIR Debug Launcher (ADL), или, в случае с установленным приложением, в содержимом в изолированной программной среде безопасности приложения.
pause | () | метод |
public static function pause():void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Устанавливает паузу в работе Flash Player или AIR Debug Launcher (ADL). После вызова этого метода все операции приложения прекращаются, за исключением доставки событий Socket.
Только для отладочной версии Flash Player или AIR Debug Launcher (ADL).
Связанные элементы API
pauseForGCIfCollectionImminent | () | метод |
public static function pauseForGCIfCollectionImminent(imminence:Number = 0.75):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 11, AIR 3 |
Предлагает сборщику мусора завершения инкрементного цикла сборки, если превышено значение параметра приближения функции.
Алгоритм сборщика мусора среды выполнения Flash выполняется инкрементно, отмечая используемую память. Это приостанавливает выполнение приложения, когда собираются неиспользуемые фрагменты памяти. Пауза, которая возникает по завершении цикла инкрементной сборки, может продолжаться дольше желаемого. В некоторых программах она может быть достаточно заметна и слышна. Эта функция позволяет приложению сообщить среде выполнения, что настало время для завершения пометки и перехода к сбору. В качестве компенсации можно планировать возможные паузы на время, когда пользователь их не будет замечать. Например, в игре эту функцию можно вызвать после прохождения уровня, чтобы уменьшить вероятность пауз во время активной игры.
Приближение определяется тем, когда сборщик решает, что процесс пометки завершен и, следовательно, когда наступает время сборки мусора. Аргументом приближения для этой функции является пороговое значение: сборщик мусора будет вызываться, только если фактическое приближение превышает пороговое значение. В противном случае этот вызов немедленно возвращается без выполнения какого-либо действия.
Вызывая эту функцию с низким значением приближения, приложение показывает, что оно готово принять, что необходимо выполнить относительно большой объем пометки. С другой стороны, высокое значение приближения обозначает, что приложение следует приостановить, только если маркировка почти закончена. Как правило, в первом случае паузы длиннее, чем во втором.
Освобождаемый объем памяти не зависит от параметра приближения. Он зависит только от числа освобождаемых объектов. Если приложение недавно освободило ссылки на большие структуры данных или на большое количество объектов, низкое значение приближения запускает сбор мусора, в результате чего эти объекты немедленно освобождаются.
Параметры
imminence:Number (default = 0.75 ) — Число между 0 и 1, где 0 означает наименьшее приближение, а 1 — наибольшее. Если значение меньше 0, по умолчанию используется 0,25. Если значение больше 1,0, по умолчанию используется 1,0. Если значение не является числом (NaN), по умолчанию используется 0,75
|
resume | () | метод |
public static function resume():void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Возобновляет работу приложения после вызова метода System.pause()
.
Только для отладочной версии Flash Player или AIR Debug Launcher (ADL).
Связанные элементы API
setClipboard | () | метод |
public static function setClipboard(string:String):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Заменяет содержимое буфера обмена заданной текстовой строкой. Этот метод работает в любом контексте безопасности, если вызывается в результате пользовательского события (например, обработчика события клавиатуры или устройства ввода).
Этот метод доступен для SWF-содержимого, выполняемого во Flash Player 9. Он позволяет добавлять в буфер обмена только содержимое типа String.
Содержимое Flash Player 10 и содержимое в изолированной программной среде безопасности приложения AIR может вызывать метод Clipboard.setData()
.
Параметры
string:String — Состоящая из символов строка с обычным текстом для размещения в буфере обмена системы, замещая текущее содержимое (если есть).
|
Связанные элементы API
System.totalMemory
при вызове метода 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, 11:34 AM Z