Пакет | 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 ) — Активируемый с приложением объект NativeWindow окна.
|
События
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 ) — Уровень приоритета прослушивателя событий. Приоритет определяется 32-разрядным целым числом со знаком. Чем больше число, тем выше приоритет. Все прослушиватели событий с приоритетом n обрабатываются перед прослушивателями с приоритетом n-1. Прослушиватели с одинаковым приоритетом обрабатываются в порядке их добавления. Значение приоритета по умолчанию равно 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