| Пакет | flash.desktop |
| Класс | public final class NativeApplication |
| Наследование | NativeApplication  EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Класс NativeApplication предоставляет информацию о приложении, дает доступ к самым распространенным функциям приложения и отправляет события уровня приложения.
Единственный экземпляр объекта NativeApplication автоматически создается при запуске. Получить экземпляр объекта NativeApplication приложения можно через статическое свойство NativeApplication.nativeApplication.
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
| activeWindow : NativeWindow [только для чтения]
Окно активного приложения. | NativeApplication | ||
| applicationDescriptor : XML [только для чтения]
Содержимое файла дескриптора приложения данного приложения AIR. | NativeApplication | ||
| applicationID : String [только для чтения]
Идентификатор приложения данного приложения. | NativeApplication | ||
| autoExit : Boolean
Указывает, должно ли приложение автоматически завершаться при закрытии всех его окон. | NativeApplication | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| executeInBackground : Boolean
Указывает, будет ли приложение выполняться в фоновом режиме. | NativeApplication | ||
| icon : InteractiveIcon [только для чтения]
Значок приложения. | NativeApplication | ||
| idleThreshold : int
Период времени в секундах с момента последнего пользовательского ввода до отправки события userIdle. | NativeApplication | ||
| isCompiledAOT : Boolean [только для чтения]
Указывает, должна ли выполняться компиляция или интерпретация приложения для выбранной платформы. | NativeApplication | ||
| menu : NativeMenu
Меню приложения. | NativeApplication | ||
| nativeApplication : NativeApplication [статические] [только для чтения]
Единственный экземпляр объекта NativeApplication. | NativeApplication | ||
| openedWindows : Array [только для чтения]
В массиве содержатся все собственные открытые окна данного приложения. | NativeApplication | ||
| publisherID : String [только для чтения]
Идентификатор издателя данного приложения. | NativeApplication | ||
| runtimePatchLevel : uint [только для чтения]
Уровень исправления среды, в которой запускается данное приложение. | NativeApplication | ||
| runtimeVersion : String [только для чтения]
Номер версии среды, в которой запускается данное приложение. | NativeApplication | ||
| startAtLogin : Boolean
Указывает, будет ли данное приложение автоматически запускаться при входе текущего пользователя в систему. | NativeApplication | ||
| supportsDefaultApplication : Boolean [статические] [только для чтения]
Указывает, поддерживает ли текущая платформа setAsDefaultApplication(), removeAsDefaultApplication() и isSetAsDefaultApplication(). | NativeApplication | ||
| supportsDockIcon : Boolean [статические] [только для чтения]
Указывает, поддерживает ли AIR в данной ОС значки программ на панели задач. | NativeApplication | ||
| supportsMenu : Boolean [статические] [только для чтения]
Указывает, поддерживает ли текущая ОС глобальные строки меню приложений. | NativeApplication | ||
| supportsStartAtLogin : Boolean [статические] [только для чтения]
Указывает, поддерживает ли текущая платформа startAtLogin. | NativeApplication | ||
| supportsSystemTrayIcon : Boolean [статические] [только для чтения]
Указывает, поддерживает ли AIR в данной ОС значки на панели задач. | NativeApplication | ||
| systemIdleMode : String
Позволяет приложениям предотвращать переход пользовательского интерфейса в ждущий режим. | NativeApplication | ||
| timeSinceLastUserInput : int [только для чтения]
Время в секундах с момента последнего пользовательского ввода. | NativeApplication | ||
| Метод | Определено | ||
|---|---|---|---|
Активирует данное приложение. | NativeApplication | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [переопределить]
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | NativeApplication | ||
Вызывает внутреннюю команду delete экранного объекта с фокусом. | NativeApplication | ||
Вызывает внутреннюю команду copy экранного объекта с фокусом. | NativeApplication | ||
Вызывает внутреннюю команду cut экранного объекта с фокусом. | NativeApplication | ||
[переопределить]
Посылает событие в поток событий. | NativeApplication | ||
Завершает приложение. | NativeApplication | ||
Определяет приложение по умолчанию для открытия файлов с указанным расширением. | NativeApplication | ||
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
Указывает, является ли данное приложение текущим приложением по умолчанию для обработки файлов с указанным расширением. | NativeApplication | ||
Вызывает внутреннюю команду paste экранного объекта с фокусом. | NativeApplication | ||
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
Отменяет использование данного приложения в качестве приложения по умолчанию для обработки файлов с указанным расширением. | NativeApplication | ||
[переопределить]
Удаляет прослушиватель из объекта EventDispatcher. | NativeApplication | ||
Вызывает внутреннюю команду selectAll экранного объекта с фокусом. | NativeApplication | ||
Задает данное приложение в качестве приложения по умолчанию для обработки файлов с указанным расширением. | NativeApplication | ||
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| Отправляется, когда данное приложение становится приложением активного рабочего стола. | NativeApplication | |||
| Отправляется при вызове приложения SWF-файлом, выполняющимся в обозревателе пользователя. | NativeApplication | |||
| Отправляется, когда фокус перемещается с рабочего стола на приложение. | NativeApplication | |||
| Отправляется при запуске последовательности операций выхода из приложения. | NativeApplication | |||
| Отправляется при вызове приложения. | NativeApplication | |||
| Отправляется, когда пользователь нажимает клавишу. | NativeApplication | |||
| Отправляется, когда пользователь отпускает клавишу. | NativeApplication | |||
| Отправляется при обнаружении нового сетевого подключения или при разрыве существующего соединения. | NativeApplication | |||
| Отправляется перед тем, как работа приложения будет приостановлена операционной системой. | NativeApplication | |||
| Отправляется, когда пользователь неактивен. | NativeApplication | |||
| Отправляется при обнаружении нажатий клавиш или кнопок мыши в среде ОС в режиме ожидания. | NativeApplication | |||
activeWindow | свойство |
activeWindow:NativeWindow [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Окно активного приложения.
Если активное окно рабочего стола не относится к этому приложению или активные окна отсутствуют, свойство activeWindow имеет значение null.
Это свойство не поддерживается на платформах, на которых отсутствует поддержка класса NativeWindow.
Реализация
public function get activeWindow():NativeWindow applicationDescriptor | свойство |
applicationDescriptor:XML [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Содержимое файла дескриптора приложения данного приложения AIR.
Реализация
public function get applicationDescriptor():XMLПример ( Использование этого примера )
copyright и version из файла дескриптора приложения. Обратите внимание на то, что необходимо использовать пространство имен по умолчанию, определенное в XML-файле дескриптора приложения.
var appDescriptor:XML = NativeApplication.nativeApplication.applicationDescriptor;
var ns:Namespace = appDescriptor.namespace();
var appCopyright:String = appDescriptor.ns::copyright;
var appVersion:String = appDescriptor.ns::version;
trace("appId:", appCopyright);
trace("version:", appVersion);
applicationID | свойство |
autoExit | свойство |
autoExit:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Указывает, должно ли приложение автоматически завершаться при закрытии всех его окон.
Если autoExit принимает значение true (по умолчанию), то при закрытии всех окон приложения само приложение автоматически завершает работу. Оба события exiting и exit отправляются. Если autoExit принимает значение false, то для завершения работы приложения требуется осуществить вызов функции NativeApplication.nativeApplication.exit().
Это свойство не поддерживается на платформах, на которых отсутствует поддержка класса NativeWindow.
Реализация
public function get autoExit():Boolean public function set autoExit(value:Boolean):void executeInBackground | свойство |
executeInBackground:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 3.3 |
Указывает, будет ли приложение выполняться в фоновом режиме.
Когда для executeInBackground установлено значение false (значение по умолчанию), приложение остается в приостановленном состоянии при переходе в фоновый режим. Когда для executeInBackground установлено значение true, приложение может выполняться в фоновом режиме.
Примечание. Для SWF версии 21 или более ранней AIR не поддерживает выполнение в фоновом режиме на платформах iOS и Android, когда выбран прямой режим визуализации. Из-за этого приложения на основе Stage3D не могут выполнять фоновые задачи, в частности, воспроизведение аудио, отправку местоположения, передачу данных по сети и пр. Системой iOS запрещены вызовы, обращенные к графическому интерфейсу OpenGLES или визуализации в фоновом режиме. Работа приложений, предпринимающих попытку вызова OpenGL в фоновом режиме, прерывается системой iOS. Система Android разрешает приложениям выполнять как вызовы OpenGLES в фоновом режиме, так и другие фоновые задачи (такие как воспроизведение аудио). Для SWF версии 22 или более поздней мобильные приложения AIR могут выполняться в фоновом режиме, когда выбран прямой режим визуализации. В среде выполнения AIR iOS возникает ошибка ActionScript (3768 — API-интерфейс Stage3D нельзя использовать при выполнении в фоновом режиме), если вызовы OpenGLES отправляются в фоновом режиме. Однако на платформе Android ошибки не возникают, так как ее собственным приложениям разрешается вызывать OpenGLES в фоновом режиме. Чтобы обеспечить оптимальное использование ресурсов мобильных устройств, не вызывайте методы визуализации, пока приложение работает в фоновом режиме.
Это свойство поддерживается только в AIR для iOS и Android.
Реализация
public function get executeInBackground():Boolean public function set executeInBackground(value:Boolean):void icon | свойство |
icon:InteractiveIcon [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Значок приложения.
Для определения класса значка используйте NativeApplication.supportsDockIcon и NativeApplication.supportsSystemTrayIcon. Выбранный тип принадлежит одному из подклассов InteractiveIcon. В ОС Mac® OS X NativeApplication.icon является объектом типа DockIcon. В ОС Windows® объект NativeApplication.icon принадлежит к типу SystemTrayIcon. Когда значок программы не поддерживается, свойства NativeApplication.supportsDockIcon и NativeApplication.supportsSystemTrayIcon имеют значение false, а свойство icon имеет значение null.
Объект icon создается автоматически, однако его инициализации с данными изображения не происходит. В некоторых ОС, например в Mac OS X, используется изображение по умолчанию. В остальных случаях, например в Windows, значок отображается только после присвоения ему данных изображения. Для присвоения изображения значка следует настроить свойство icon.bitmaps на работу с массивом, в котором содержится, по крайней мере, один объект BitmapData. Если в массиве содержится более одного объекта BitmapData, то ОС выбирает изображение, размер которого в наибольшей степени соответствует размерам значка на экране, и масштабирует его по мере необходимости.
Реализация
public function get icon():InteractiveIconСвязанные элементы API
idleThreshold | свойство |
idleThreshold:int| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Период времени в секундах с момента последнего пользовательского ввода до отправки события userIdle.
По умолчанию используется значение 300 секунд (5 минут). Приемлемый диапазон значений от 5 (5 секунд) до 86 400 (1 день) включительно.
Реализация
public function get idleThreshold():int public function set idleThreshold(value:int):voidВыдает
ArgumentError — При попытке установки свойства в недействительное значение. Приемлемый диапазон значений от 5 (5 секунд) до 86 400 (1 день) включительно.
|
Связанные элементы API
isCompiledAOT | свойство |
isCompiledAOT:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 25.0 |
Указывает, должна ли выполняться компиляция или интерпретация приложения для выбранной платформы. Этот API-интерфейс возвращает значение (true) только для iOS для целей (ipa-app-store, ipa-test, ipa-debug, ipa-ad-hoc). Для других платформ AIR этот API-интерфейс возвращает значение (false).
Реализация
public function get isCompiledAOT():Boolean menu | свойство |
menu:NativeMenu| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Меню приложения.
Поддержка меню приложений осуществляется, если NativeApplication.supportsMenu принимает значение true. Меню приложений поддерживают не все ОС. Например, меню приложений поддерживаются в Mac OS X, но не поддерживаются в Windows или Linux. Присвоить данному свойству объект NativeMenu, если NativeApplication.supportsMenu принимает значение false, возможно, однако это не приведет к выполнению какого-либо действия. Свойство NativeApplication.supportsMenu позволяет определить, поддерживает ли операционная система прикладные меню. Использование других средств (например, Capabilities.os) для определения поддержки может привести к ошибкам программирования (если некоторые целевые операционные системы не рассматриваются).
Поддержка в профилях AIR: эта функция не поддерживается на мобильных устройствах или в средах AIR для телевизионных устройств. Дополнительные сведения о поддержке API-интерфейса в разных профилях см. в разделе «Поддержка в профилях AIR».
Примечание. Свойство menu в Mac OS X ссылается на меню приложения, используемое в ОС по умолчанию. Существующую структуру меню можно модифицировать путем добавления или удаления элементов либо путем добавления прослушивателей событий. Также можно полностью заменить используемые по умолчанию меню, присвоив свойству menu новый объект NativeMenu.
Реализация
public function get menu():NativeMenu public function set menu(value:NativeMenu):voidСвязанные элементы API
nativeApplication | свойство |
nativeApplication:NativeApplication [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Единственный экземпляр объекта NativeApplication.
Реализация
public static function get nativeApplication():NativeApplicationВыдает
Error — При доступе из внешней среды за пределами изолированной программной среды безопасности приложения.
|
openedWindows | свойство |
openedWindows:Array [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
В массиве содержатся все собственные открытые окна данного приложения.
Это свойство не поддерживается на платформах, на которых отсутствует поддержка класса NativeWindow.
Реализация
public function get openedWindows():Array publisherID | свойство |
publisherID:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Идентификатор издателя данного приложения.
Значение этого идентификатора задается в файле идентификатора издателя приложения, который создается при установке. Данные берутся из цепочки сертификатов, используемых для подписи приложения.
Реализация
public function get publisherID():String runtimePatchLevel | свойство |
runtimeVersion | свойство |
startAtLogin | свойство |
startAtLogin:Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Указывает, будет ли данное приложение автоматически запускаться при входе текущего пользователя в систему.
Поддержка в профилях AIR: эта функция поддерживается во всех компьютерных операционных системах, но не поддерживается на мобильных устройствах или в средах AIR для телевизионных устройств. Используйте свойство NativeApplication.supportsStartAtLogin, чтобы проверить наличие поддержки в среде выполнения. Дополнительные сведения о поддержке API-интерфейса в разных профилях см. в разделе «Поддержка в профилях AIR».
За состояние определенного ОС механизма автоматического запуска приложения при входе пользователя в систему отвечает свойство startAtLogin. Используя пользовательский интерфейс ОС, пользователь может самостоятельно изменить данное состояние. Это свойство отражает текущее состояние, а именно, было ли оно изменено ОС или приложением AIR.
Реализация
public function get startAtLogin():Boolean public function set startAtLogin(value:Boolean):voidВыдает
IllegalOperationError — В Windows при наличии другого приложения с тем же именем, но с другим путем к исполняемому файлу, настроенного на запуск при входе пользователя в систему.
| |
IllegalOperationError — Если данное приложение не установлено, как это может произойти при запуске с помощью AIR Debug Launcher (ADL).
|
Связанные элементы API
supportsDefaultApplication | свойство |
supportsDefaultApplication:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2 |
Указывает, поддерживает ли текущая платформа setAsDefaultApplication(), removeAsDefaultApplication() и isSetAsDefaultApplication().
Если это свойство имеет значение true, вышеупомянутые методы будут работать согласно описанию. Если оно имеет значение false, то setAsDefaultApplication() и removeDefaultApplication() не дают результатов, а isSetAsDefaultApplication() возвращает значение false.
Реализация
public static function get supportsDefaultApplication():BooleanСвязанные элементы API
supportsDockIcon | свойство |
supportsDockIcon:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Указывает, поддерживает ли AIR в данной ОС значки программ на панели задач.
При значении true свойство NativeApplication.icon принадлежит к типу DockIcon.
Пользовательский интерфейс ОС Mac OS X включает панель Dock, содержащую значки программ, которые выполняются в данный момент или часто используются.
Свойство NativeApplication.supportsDockIcon позволяет определить, поддерживает ли операционная система значки панелей приложений. Использование других средств (например, Capabilities.os) для определения поддержки может привести к ошибкам программирования (если некоторые целевые операционные системы не рассматриваются).
Реализация
public static function get supportsDockIcon():BooleanСвязанные элементы API
supportsMenu | свойство |
supportsMenu:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Указывает, поддерживает ли текущая ОС глобальные строки меню приложений.
При значении true свойство NativeApplication.menu может быть использовано для получения доступа или определения собственного меню приложения.
Свойство NativeApplication.supportsMenu позволяет определить, поддерживает ли операционная система строки меню приложений. Использование других средств (например, Capabilities.os) для определения поддержки может привести к ошибкам программирования (если некоторые целевые операционные системы не рассматриваются).
Реализация
public static function get supportsMenu():BooleanСвязанные элементы API
supportsStartAtLogin | свойство |
supportsStartAtLogin:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2 |
Указывает, поддерживает ли текущая платформа startAtLogin.
Если имеет значение true, startAtLogin работает согласно описанию. Если имеет значение false, startAtLogin не дает результатов.
Реализация
public static function get supportsStartAtLogin():BooleanСвязанные элементы API
supportsSystemTrayIcon | свойство |
supportsSystemTrayIcon:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Указывает, поддерживает ли AIR в данной ОС значки на панели задач.
При значении true свойство NativeApplication.icon принадлежит к типу SystemTrayIcon.
Пользовательский интерфейс ОС Windows включает область значков на панели задач, которая называется областью уведомлений, где могут отображаться значки приложений. Значки по умолчанию не отображаются. Для отображения значка необходимо задать массив bitmaps объекта Icon.
Свойство NativeApplication.supportsSystemTrayIcon позволяет определить, поддерживает ли операционная система значки на панели задач. Использование других средств (например, Capabilities.os) для определения поддержки может привести к ошибкам программирования (если некоторые целевые операционные системы не рассматриваются).
Реализация
public static function get supportsSystemTrayIcon():BooleanСвязанные элементы API
systemIdleMode | свойство |
systemIdleMode:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2 |
Позволяет приложениям предотвращать переход пользовательского интерфейса в ждущий режим.
Значение из класса SystemIdleMode, позволяющее изменять поведение системы хоста, связанное с переходом в ждущим режим или выходом из него. Это свойство имеет силу для приложения с фокусом ввода. Его можно получить только через содержимое, выполняемое в изолированной программной среде приложения.
Поддержка в профилях AIR: эта функция поддерживается на мобильных устройствах, но не поддерживается в компьютерных операционных системах или средах AIR для телевизионных устройств. Дополнительные сведения о поддержке API-интерфейса в разных профилях см. в разделе «Поддержка в профилях AIR».
Реализация
public function get systemIdleMode():String public function set systemIdleMode(value:String):voidСвязанные элементы API
timeSinceLastUserInput | свойство |
activate | () | метод |
public function activate(window:NativeWindow = null):void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Активирует данное приложение.
Этот метод не поддерживается на платформах, на которых отсутствует поддержка класса NativeWindow.
При некоторых, заданных ОС, обстоятельствах данный метод не приводит к активации приложения. В большинстве ОС приложения не могут активировать сами себя. Это сделано для того, чтобы исключить возможность случайного или умышленного использования пользователем других приложений в своих целях.
Если такая возможность поддерживается ОС, то указанное окно становится активным и появляется на рабочем столе поверх остальных окон или приложений. (Если параметр window принимает значение null, то активируется видимое окно данной программы.)
При работе с приложениями без видимых окон метод activate() не подходит.
Операция активации является синхронной.
Параметры
window:NativeWindow (default = null) |
События
activate: — Отправляется при изменении состояния активности.
|
addEventListener | () | метод |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void| Версии среды выполнения: | AIR 1.0 |
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. Можно регистрировать прослушиватели событий в любом узле из списка отображения для каждого типа события, фазы и приоритета.
После успешной регистрации прослушивателя событий невозможно изменить его приоритет путем дополнительных вызовов addEventListener(). Чтобы изменить приоритет прослушивателя, необходимо сначала вызвать метод removeListener(). Затем можно снова зарегистрировать прослушиватель с новым приоритетом.
Следует учесть, что после регистрации прослушивателя последующие вызовы метода addEventListener() с другим значением свойства type или useCapture приводят к регистрации другого прослушивателя. Например, прослушиватель, изначально зарегистрированный со значением useCapture, равным true, прослушивает только во время фазы захвата. Если вызвать метод addEventListener() еще раз с тем же объектом прослушивателя, но со свойством useCapture в значении false, то будет два прослушивателя: один — прослушивающий в фазе захвата, а другой — в целевой фазе и фазе восходящей цепочки.
Невозможно зарегистрировать прослушиватель события только для целевой фазы или для фазы восходящей цепочки. Эти фазы соединены при регистрации, поскольку восходящая цепочка применяется только к предшественникам целевого узла.
Если прослушиватель событий больше не нужен, его можно удалить, вызвав метод removeEventListener(), иначе могут возникнуть проблемы с памятью. Прослушиватели событий не удаляются из памяти автоматически, так как сборщик мусора не удаляет прослушиватель, пока существует объект, отправляющий соответствующее событие (если параметру useWeakReference не задано значение true).
Копирование экземпляра EventDispatcher не приводит к копированию прослушивателей событий, присоединенных к нему. (Если для вновь создаваемого узла требуется прослушиватель событий, его необходимо присоединить после создания узла.) При этом при перемещении экземпляра EventDispatcher присоединенные к нему прослушиватели событий перемещаются вместе с ним.
Если прослушиватель регистрируется для узла в тот момент, когда на нем обрабатывается событие, то в текущей фазе он не запускается, однако может запуститься в следующей фазе потока события, например в фазе восходящей цепочки.
Прослушиватель событий, удаленный из узла во время обработки события на этом узле, будет запускаться текущими операциями. После удаления прослушиватель событий больше не вызывается (если не будет снова зарегистрирован для дальнейшей обработки).
Параметры
type:String — Тип события.
| |
listener:Function — Функция прослушивателя, обрабатывающая событие. Эта функция должна принимать объект Event в качестве единственного параметра и не должна что-либо возвращать , как показано в примере:
function(evt:Event):void Эта функция может иметь любое имя. | |
useCapture:Boolean (default = false)useCapture равно true, прослушиватель обрабатывает событие только во время фазы захвата, но не во время целевой фазы или фазы восходящей цепочки. Если значение useCapture равно false, то прослушиватель обрабатывает событие только в целевой фазе или фазе восходящей цепочки. Чтобы прослушивать событие во всех трех фазах, необходимо вызвать addEventListener() дважды: один раз с useCapture в значении true, а другой — с useCapture в значении false.
| |
priority:int (default = 0) | |
useWeakReference:Boolean (default = false)Функции элементов уровня класса не подлежат удалению в качестве мусора, вследствие чего можно установить |
clear | () | метод |
public function clear():Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Вызывает внутреннюю команду delete экранного объекта с фокусом.
Если объект с фокусом не поддерживает эту команду, вызов функции игнорируется. В настоящее время эту команду поддерживают только те экранные объекты, которые происходят от классов TextField или HTMLLoader.
Примечание. Команда clear() удаляет выбранный текст. При отсутствии выбранного текста весь текст не удаляется.
Boolean — true.
|
copy | () | метод |
public function copy():Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Вызывает внутреннюю команду copy экранного объекта с фокусом.
Если компонент не поддерживает эту команду, вызов функции игнорируется. В настоящее время эту команду поддерживают только те экранные объекты, которые происходят от классов TextField или HTMLLoader.
ВозвращаетBoolean |
cut | () | метод |
public function cut():Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Вызывает внутреннюю команду cut экранного объекта с фокусом.
Если компонент не поддерживает эту команду, вызов функции игнорируется. В настоящее время эти команды поддерживают только те экранные объекты, которые происходят от классов TextField или HTMLLoader.
ВозвращаетBoolean — true.
|
dispatchEvent | () | метод |
override public function dispatchEvent(event:Event):Boolean| Версии среды выполнения: | AIR 1.0 |
Посылает событие в поток событий. Целью события является объект EventDispatcher, для которого вызывается метод dispatchEvent().
Параметры
event:Event — Объект события, передаваемый в поток событий. Если осуществляется повторная отправка события, автоматически создается его клон. После отправки события нельзя изменить его свойство target, поэтому необходимо создать новую копию события, чтобы обеспечить правильное выполнение повторной отправки.
|
Boolean — Значение true в случае успешной передачи события. Значение false указывает на ошибку или на то, что для события был вызван метод preventDefault().
|
exit | () | метод |
public function exit(errorCode:int = 0):void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Завершает приложение.
Вызов метода exit() приведет к возврату кода выхода. Однако до тех пор, пока не завершится выполнение текущего кода (например, работа обработчика события), процедура завершения работы не начнется. Ожидающие асинхронные операции могут быть выполнены или отменены.
Имейте в виду, что событие exiting не отправляется. Если архитектура программы подразумевает использование события exiting, произведите вызов метода NativeApplication.nativeApplication.dispatchEvent(), передав ему в качестве аргумента объект Event типа exiting. Для любых открытых окон объекты NativeWindow отправляют события closing и close. Вызов метода preventDefault() для объекта события closing предотвращает завершение работы приложения.
Примечание. Этот метод не поддерживается в операционной системе ОС iOS.
Параметры
errorCode:int (default = 0) |
getDefaultApplication | () | метод |
public function getDefaultApplication(extension:String):String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Определяет приложение по умолчанию для открытия файлов с указанным расширением.
Примечание. Данный метод применим только к типам файлов, объявленным в инструкции fileTypes дескриптора приложения.
Этот метод не применим в среде AIR для телевизионных устройств. Если он вызывается с типом файла, объявленным в дескрипторе программы, возвращается значение null.
Параметры
extension:String — Строка с интересующим расширением типа файла (без «.»).
|
String — Путь к приложению по умолчанию.
|
Выдает
Error — Если параметр extension не содержит ни одного расширения файла, объявленного в дескрипторе приложения.
|
Связанные элементы API
isSetAsDefaultApplication | () | метод |
public function isSetAsDefaultApplication(extension:String):Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Указывает, является ли данное приложение текущим приложением по умолчанию для обработки файлов с указанным расширением.
Поддержка в профилях AIR: эта функция поддерживается во всех компьютерных операционных системах, но не поддерживается на мобильных устройствах или в средах AIR для телевизионных устройств. Используйте свойство NativeApplication.supportsDefaultApplication, чтобы проверить наличие поддержки в среде выполнения. Дополнительные сведения о поддержке API-интерфейса в разных профилях см. в разделе «Поддержка в профилях AIR».
Параметры
extension:String — Строка с интересующим расширением типа файла (без «.»).
|
Boolean — true, если по умолчанию используется данное приложение.
|
Выдает
Error — Если параметр extension не содержит ни одного расширения файла, объявленного в дескрипторе приложения.
|
Связанные элементы API
paste | () | метод |
public function paste():Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Вызывает внутреннюю команду paste экранного объекта с фокусом.
Если компонент не поддерживает эту команду, вызов функции игнорируется. В настоящее время эту команду поддерживают только те экранные объекты, которые происходят от классов TextField или HTMLLoader.
ВозвращаетBoolean — true.
|
removeAsDefaultApplication | () | метод |
public function removeAsDefaultApplication(extension:String):void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Отменяет использование данного приложения в качестве приложения по умолчанию для обработки файлов с указанным расширением.
Примечание. Данный метод применим только к типам файлов, объявленным в инструкции fileTypes дескриптора приложения.
Параметры
extension:String — Строка с интересующим расширением типа файла (без «.»).
|
Выдает
Error — Если параметр extension не содержит ни одного расширения файла, объявленного в дескрипторе приложения.
|
Связанные элементы API
removeEventListener | () | метод |
override public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void| Версии среды выполнения: | AIR 1.0 |
Удаляет прослушиватель из объекта EventDispatcher. При отсутствии прослушивателя, зарегистрированного с объектом EventDispatcher, вызов этого метода не оказывает эффекта.
Параметры
type:String — Тип события.
| |
listener:Function — Удаляемый объект прослушивателя.
| |
useCapture:Boolean (default = false)removeEventListener() необходимо вызвать дважды: один раз с useCapture() в значении true, а другой раз с useCapture() в значении false.
|
selectAll | () | метод |
public function selectAll():Boolean| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Вызывает внутреннюю команду selectAll экранного объекта с фокусом.
Если компонент не поддерживает эту команду, вызов функции игнорируется. В настоящее время эту команду поддерживают только те экранные объекты, которые происходят от классов TextField или HTMLLoader.
ВозвращаетBoolean — true.
|
setAsDefaultApplication | () | метод |
public function setAsDefaultApplication(extension:String):void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Задает данное приложение в качестве приложения по умолчанию для обработки файлов с указанным расширением.
Примечание. Данный метод применим только к типам файлов, объявленным в инструкции fileTypes дескриптора приложения.
Параметры
extension:String — Строка с интересующим расширением типа файла (без «.»).
|
Выдает
Error — Если параметр extension не содержит ни одного расширения файла, объявленного в дескрипторе приложения.
|
Связанные элементы API
activate | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.ACTIVATE| Версии среды выполнения: | AIR 1.0 |
Отправляется, когда данное приложение становится приложением активного рабочего стола.
КонстантаACTIVATE определяет значение свойства type объекта события activate.
Примечание. Это событие не имеет фазы захвата и фазы восходящей цепочки, поэтому отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.
На устройствах AIR for TV это событие никогда не отправляется автоматически. Однако его можно отправить вручную.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Любой экземпляр DisplayObject, для которого зарегистрирован прослушиватель события activate. |
browserInvoke | Событие |
flash.events.BrowserInvokeEventсвойство BrowserInvokeEvent.type =
flash.events.BrowserInvokeEvent.Browser_INVOKE| Версии среды выполнения: | AIR 1.0 |
Отправляется при вызове приложения SWF-файлом, выполняющимся в обозревателе пользователя.
Вызов обозревателя разрешается, только если приложение указывает следующие данные в файле дескриптора приложения.
<allowBrowserInvocation>true</allowBrowserInvocation>
deactivate | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.DEACTIVATE| Версии среды выполнения: | AIR 1.0 |
Отправляется, когда фокус перемещается с рабочего стола на приложение.
КонстантаEvent.DEACTIVATE определяет значение свойства type объекта события deactivate.
Примечание. Это событие не имеет фазы захвата и фазы восходящей цепочки, поэтому отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.
На устройствах AIR for TV это событие никогда не отправляется автоматически. Однако его можно отправить вручную.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Любой экземпляр DisplayObject, для которого зарегистрирован прослушиватель события deactivate. |
exiting | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.EXITING| Версии среды выполнения: | AIR 1.0 |
Отправляется при запуске последовательности операций выхода из приложения.
Событие exiting отправляется, когда ОС инициирует процедуру завершения программы. Например, по нажатию комбинации клавиш Cmd-Q в ОС Mac OS X или когда свойство autoExit объекта NativeApplication принимает значение true и закрывается окно последней активной программы. При отмене данного события выход из приложения не осуществляется.
Среда AIR для телевизионных устройств никогда не оправляет событие exiting.
Примечание. Вызов метода exit() NativeApplication не приводит к прекращению отправки события exiting. Для уведомления компонентов о предстоящем выходе следует отправить событие exiting до вызова метода exit().
Event.EXITING определяет значение свойства type объекта события exiting.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | true; отмена данного объекта отменяет операцию выхода. |
currentTarget | Объект NativeApplication. |
target | Объект NativeApplication. |
invoke | Событие |
flash.events.InvokeEventсвойство InvokeEvent.type =
flash.events.InvokeEvent.INVOKE| Версии среды выполнения: | AIR 1.0 |
Отправляется при вызове приложения.
При повторном вызове приложения его копия не запускается. Вместо этого первой копии приложения поступает дополнительное событие о вызове. Дальнейшая реакция на повторные события invoke зависит от самого приложения.
Примечание. Все события invoke помещаются в очередь. Если прослушиватель для данного события зарегистрирован, он получает все события из очереди, а также все новые события. События из очереди доставляются как до, так и после новых событий invoke.
InvokeEvent.INVOKE определяет значение свойства type объекта InvokeEvent.
Объект InvokeEvent имеет следующие свойства.
| Свойства | Значения |
|---|---|
arguments | Массив строковых аргументов, передаваемых в ходе данного вызова. |
currentDirectory | Объект File, представляющий каталог, который должен использоваться для разрешения относительных путей в массиве arguments. |
reason | код, указывающий причину отправки события вызова: в результате автоматического запуска приложения при входе (InvokeEventReason.LOGIN), в результате запуска в качестве ответа на дистанционное уведомление (InvokeEventReason.NOTIFICATION, только в iOS), в результате вызова приложения другим приложением (InvokeEventReason.OPEN_URL) или другую причину (InvokeEventReason.STANDARD). Доступно как в версии AIR 1.5.1. |
bubbles | false. |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект InvokeEvent с помощью прослушивателя событий. |
target | Всегда объект NativeApplication. |
keyDown | Событие |
flash.events.KeyboardEventсвойство KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Отправляется, когда пользователь нажимает клавишу. Экземпляр NativeApplication обеспечивает это событие к командным клавишам клавиатуры поддержки. Это событие клавиатуры отправлено сначала NativeApplication. Отменение этого события также отменяет командные клавиши меню NativeWindow. Это событие происходит перед событием keyUp.
KeyboardEvent.KEY_DOWN определяет значение свойства type объекта события keyDown.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | true |
cancelable | true в AIR, false в Flash Player. Отмена этого события в AIR предотвращает ввод этого символа в текстовое поле. |
charCode | Значение кода символа для нажатой или отпущенной клавиши. |
commandKey | true в Mac, если клавиша Command активна. В противном случае false |
controlKey | true в Windows и Linux, если клавиша Ctrl активна. true в Mac, если клавиша Control активна. В противном случае false |
ctrlKey | true в Windows и Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
keyCode | Значение кода клавиши для нажатой или отпущенной клавиши. |
keyLocation | Расположение клавиши на клавиатуре. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
target | Экземпляр InteractiveObject, находящийся в фокусе. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
Связанные элементы API
keyUp | Событие |
flash.events.KeyboardEventсвойство KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Отправляется, когда пользователь отпускает клавишу. Экземпляр NativeApplication обеспечивает это событие к командным клавишам клавиатуры поддержки. Это событие клавиатуры отправлено сначала NativeApplication. Отменение этого события не имеет никаких эффектов на другие объекты (например, командные клавиши меню NativeWindow). Это событие имеет место после a keyDown событие.
KeyboardEvent.KEY_UP определяет значение свойства type объекта события keyUp.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | true |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
charCode | Содержит значение кода символа для нажатой или отпущенной клавиши. |
commandKey | true в Mac, если клавиша Command активна. В противном случае false |
controlKey | true в Windows и Linux, если клавиша Ctrl активна. true в Mac, если клавиша Control активна. В противном случае false |
ctrlKey | true в Windows, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
keyCode | Значение кода клавиши для нажатой или отпущенной клавиши. |
keyLocation | Расположение клавиши на клавиатуре. |
shiftKey | true, если клавиша Shift активна; иначе — false. |
target | Экземпляр InteractiveObject, находящийся в фокусе. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
Связанные элементы API
networkChange | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.NETWORK_CHANGE| Версии среды выполнения: | AIR 1.0 |
Отправляется при обнаружении нового сетевого подключения или при разрыве существующего соединения.
Событие networkChange не обязательно обозначает переход компьютера узла в оперативный или автономный режим. Оно также может обозначать переключение с одного соединения на другое. Приложения могут использовать данное событие для оптимизации задач мониторинга доступности удаленных ресурсов. При отправке события networkChange часто наступает удобный момент для проверки доступности любых удаленных ресурсов.
Примечания.
- Между изменением состояния сети и доставкой данного события может существовать небольшая задержка.
- На платформе Android объект NativeApplication может отправлять несколько событий networkChange для каждого изменения подключения к сети.
Event.NETWORK_CHANGE определяет значение свойства type объекта события networkChange.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект NativeApplication. |
suspend | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.SUSPEND| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 3.3 |
Отправляется перед тем, как работа приложения будет приостановлена операционной системой.
КонстантаEvent.SUSPEND определяет значение свойства type объекта события suspend. Это событие отправляет только AIR iOS.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект NativeApplication. |
target | Объект NativeApplication. |
userIdle | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.USER_IDLE| Версии среды выполнения: | AIR 1.0 |
Отправляется, когда пользователь неактивен.
Задайте период времени, в течение которого пользователь должен быть неактивным, прежде чем будет отправлено это событие с использованием свойства idleThreshold. Время, прошедшее с момента перехода в режим ожидания, определяется в свойстве timeSinceLastUserInput.
Примечание. Это событие не отправляется на мобильных устройствах или в средах AIR для телевизионных устройств.
КонстантаEvent.USER_IDLE определяет значение свойства type объекта события userIdle.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
target | Объект NativeApplication. |
Связанные элементы API
userPresent | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.USER_PRESENT| Версии среды выполнения: | AIR 1.0 |
Отправляется при обнаружении нажатий клавиш или кнопок мыши в среде ОС в режиме ожидания.
Примечание. Это событие не отправляется на мобильных устройствах или в средах AIR для телевизионных устройств.
Период времени, после которого наступает режим ожидания, регулируется свойством idleThreshold. Время, прошедшее с момента перехода в режим ожидания, определяется в свойстве timeSinceLastUserInput.
Event.USER_PRESENT определяет значение свойства type объекта события userPresent.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
target | Объект NativeApplication. |
Связанные элементы API
Tue Jun 12 2018, 11:34 AM Z