Окно активного приложения.

Если активное окно на рабочем столе не принадлежит данному приложению, то activeWindow принимает значение null.

Содержимое файла дескриптора приложения данного приложения AIR.

Идентификатор приложения данного приложения.

Значение идентификатора приложения задается в файле дескриптора приложения.

Указывает, должно ли приложение автоматически завершаться при закрытии всех его окон.

Если autoExit принимает значение true (по умолчанию), то при закрытии всех окон приложения само приложение автоматически завершает работу. Оба события exiting и exit отправляются. Если autoExit принимает значение false, то для завершения работы приложения требуется осуществить вызов функции NativeApplication.nativeApplication.exit().

Значок приложения.

Для определения класса значка используйте NativeApplication.supportsDockIcon и NativeApplication.supportsSystemTrayIcon. Выбранный тип принадлежит одному из подклассов InteractiveIcon. В ОС Mac^® OS X NativeApplication.icon является объектом типа DockIcon. В ОС Windows^® объект NativeApplication.icon принадлежит к типу SystemTrayIcon.

Объект icon создается автоматически, однако его инициализации с данными изображения не происходит. В некоторых ОС, например в Mac OS X, используется изображение по умолчанию. В остальных случаях, например в Windows, значок отображается только после присвоения ему данных изображения. Для присвоения изображения значка следует настроить свойство icon.bitmaps на работу с массивом, в котором содержится, по крайней мере, один объект BitmapData. Если в массиве содержится более одного объекта BitmapData, то ОС выбирает изображение, размер которого в наибольшей степени соответствует размерам значка на экране, и масштабирует его по мере необходимости.

См. также

Период времени в секундах с момента последнего использования клавиатуры или мыши до отправки события presenceChange.

По умолчанию используется значение 300 секунд (5 минут).

См. также

Меню приложения.

Поддержка меню приложений осуществляется, если NativeApplication.nativeApplication.supportsMenu принимает значение true. Меню приложений поддерживают не все ОС. Например, в отличии от Mac OS X, где такая поддержка существует, Windows меню приложений не поддерживает. Присвоить данному свойству объект NativeMenu, если NativeApplication.nativeApplication.supportsMenu принимает значение false возможно, однако это не приведет к выполнению какого-либо действия.

Примечание. Свойство menu в Mac OS X ссылается на меню приложения, используемое в ОС по умолчанию. Существующую структуру меню можно модифицировать путем добавления или удаления элементов, либо путем добавления прослушивателей событий. Также можно полностью заменить используемые по умолчанию меню, присвоив свойству menu новый объект NativeMenu.

См. также

Единственный экземпляр объекта NativeApplication.

В массиве содержатся все собственные открытые окна данного приложения.

Идентификатор издателя данного приложения.

Значение этого идентификатора задается в файле идентификатора издателя приложения, который создается при установке. Данные берутся из цепочки сертификатов, используемых для подписи приложения.

Уровень исправления среды, в которой запускается данное приложение.

Номер версии среды, в которой запускается данное приложение.

Указывает, будет ли данное приложение автоматически запускаться при входе текущего пользователя в систему.

За состояние определенного ОС механизма автоматического запуска приложения при входе пользователя в систему отвечает свойство startAtLogin. Используя пользовательский интерфейс ОС, пользователь может самостоятельно изменить данное состояние. Это свойство отражает текущее состояние, а именно было ли оно изменено ОС или приложением AIR.

Указывает, поддерживает ли AIR в данной ОС значки панелей приложений.

При значении true свойство NativeApplication.icon принадлежит к типу DockIcon.

В Mac OS X и различных пользовательские интерфейсах Linux^® имеется своеобразная "панель" приложений со значками, которые могут использоваться часто используемыми или запущенными приложениями.

См. также

Указывает, поддерживает ли текущая ОС глобальные строки меню приложений.

При значении true свойство NativeApplication.menu может быть использовано для получения доступа или определения собственного меню приложения.

См. также

Указывает, поддерживает ли AIR в данной ОС значки на панели задач.

При значении true свойство NativeApplication.icon принадлежит к типу SystemTrayIcon.

Примечание. В Windows системная область панели задач носит официальное название Область уведомлений.

См. также

Время в секундах с момента последнего использования клавиатуры или мыши.

См. также

Активирует данное приложение.

При некоторых, заданных ОС обстоятельствах, данный метод не приводит к активации приложения. В большинстве ОС приложения не могут активировать сами себя. Это сделано для того, чтобы исключить возможность случайного или умышленного использования пользователем других приложений в своих целях.

Если такая возможность поддерживается ОС, то указанное окно становится активным и появляется на рабочем столе поверх остальных окон или приложений. (Если параметр window принимает значение null, то активируется видимое окно данного приложения.)

При работе с приложениями без видимых окон метод activate() не подходит.

Операция активации является синхронной.

Параметры

Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях. Регистрировать прослушиватели событий можно во всех узлах списка отображения для определенного типа события, фазы и приоритета.

После успешной регистрации прослушивателя событий нельзя изменить его приоритет путем дополнительных вызовов метода addEventListener(). Чтобы изменить приоритет прослушивателя, необходимо сначала вызвать метод removeListener(). Затем можно зарегистрировать прослушиватель еще раз с новым уровнем приоритета.

Следует учесть, что после регистрации прослушивателя последующие вызовы метода addEventListener() с другим значением свойства type или useCapture приводят к регистрации другого прослушивателя. Например, если сначала был зарегистрирован прослушиватель со свойством useCapture в значении true, он прослушивает события только в фазе захвата. Если вызвать метод addEventListener() еще раз с тем же объектом прослушивателя, но со свойством useCapture в значении false, то будет два прослушивателя: один — прослушивающий в фазе захвата, а другой — в фазах назначения и восходящей цепочки.

Нельзя зарегистрировать прослушиватель событий только для фазы цели или только для фазы пузырей. Эти фазы объединяются при регистрации, так как фаза пузырей применяется только к предкам целевого узла.

Если прослушиватель событий больше не нужен, его можно удалить, вызвав метод removeEventListener(); иначе могут возникнуть проблемы с памятью. Объекты с зарегистрированным прослушивателями событий не очищаются из памяти автоматически, так как сборщик мусора не удаляет объекты, на которые есть ссылки.

Копирование экземпляра EventDispatcher не приведет к копированию всех присоединенных к нему прослушивателей событий. (Если для вновь созданного узла требуется прослушиватель событий, его необходимо добавить после создания узла.) Однако если экземпляр EventDispatcher перемещается, все зарегистрированные для него прослушиватели событий перемещаются вместе с ним.

Если прослушиватель регистрируется для узла в тот момент, когда на нем обрабатывается событие, то в текущей фазе он не запускается, однако может запуститься в следующей фазе потока события, например в фазе пузырей.

Если прослушиватель событий удаляется из узла в момент обработки события, он все равно запускается текущими действиями. После удаления прослушиватель событий больше не вызывается (если не будет снова зарегистрирован для дальнейшей обработки).

Параметры

Вызывает внутреннюю команду delete экранного объекта с фокусом.

Если объект с фокусом не поддерживает эту команду, вызов функции игнорируется. В настоящее время эту команду поддерживают только те экранные объекты, которые происходят от классов TextField или HTMLLoader.

Примечание. Команда clear() удаляет выбранный текст. При отсутствии выбранного текста весь текст не удаляется.

Вызывает внутреннюю команду copy экранного объекта с фокусом.

Если компонент не поддерживает эту команду, вызов функции игнорируется. В настоящее время эту команду поддерживают только те экранные объекты, которые происходят от классов TextField или HTMLLoader.

Вызывает внутреннюю команду cut экранного объекта с фокусом.

Если компонент не поддерживает эту команду, вызов функции игнорируется. В настоящее время эти команды поддерживают только те экранные объекты, которые происходят от классов TextField или HTMLLoader.

Передает событие в поток событий. Целью события является объект EventDispatcher, для которого вызывается метод dispatchEvent().

Параметры

Завершает приложение.

Вызов метода exit() приведет к возврату кода выхода. Однако, до тех пор, пока не завершится выполнение текущего кода (например, работа обработчика события) процедура завершения работы не начнется. Ожидающие асинхронные операции могут быть выполнены или отменены.

Имейте ввиду, что событие exiting не отправляется. Если архитектура программы подразумевает использование события exiting, произведите вызов метода NativeApplication.nativeApplication.dispatchEvent(), передав ему в качестве аргумента объект Event типа exiting. При закрытии окон приложения события closing и close не отправляются также. При необходимости оповестить ОС о закрытии приложения, можно отправить события closing каждому открытому окну. Если отправка события закрытия окна close является обязательной, то перед закрытием окна следует прибегнуть к вызову метода ОС close().

Параметры

Определяет приложение по умолчанию для открытия файлов с указанным расширением.

Примечание. Данным метод применим только к типам файлов, объявленным в инструкции fileTypes дескриптора приложения.

Параметры

См. также

Указывает, является ли данное приложение текущим приложением по умолчанию для обработки файлов с указанным расширением.

Параметры

См. также

Вызывает внутреннюю команду paste экранного объекта с фокусом.

Если компонент не поддерживает эту команду, вызов функции игнорируется. В настоящее время эту команду поддерживают только те экранные объекты, которые происходят от классов TextField или HTMLLoader.

Отменяет использование данного приложения в качестве приложения по умолчанию для обработки файлов с указанным расширением.

Примечание. Данным метод применим только к типам файлов, объявленным в инструкции fileTypes дескриптора приложения.

Параметры

См. также

Удаляет прослушиватель из объекта EventDispatcher. Если для объекта EventDispatcher нет зарегистрированного прослушивателя, то вызов этого метода игнорируется.

Параметры

Вызывает внутреннюю команду selectAll экранного объекта с фокусом.

Если компонент не поддерживает эту команду, вызов функции игнорируется. В настоящее время эту команду поддерживают только те экранные объекты, которые происходят от классов TextField или HTMLLoader.

Задает данное приложение в качестве приложения по умолчанию для обработки файлов с указанным расширением.

Примечание. Данным метод применим только к типам файлов, объявленным в инструкции fileTypes дескриптора приложения.

Параметры

См. также

Отправляется, когда данное приложение становится приложением активного рабочего стола.

Примечание. Это событие не имеет фазы захвата и фазы пузырей, поэтому отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.

Данное событие имеет следующие свойства.

Отправляется, когда фокус перемещается с рабочего стола на приложение.

Примечание. Это событие не имеет фазы захвата и фазы пузырей, поэтому отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.

Данное событие имеет следующие свойства.

Отправляется при запуске последовательности операций выхода из приложения.

Событие выхода отправляется, когда ОС инициирует процедуру завершения приложения. Например, по нажатию комбинации клавиш Cmd-Q в Mac OS X или когда свойство autoExit объекта NativeApplication принимает значение true, и закрывается окно последнего активного приложения. При отмене данного события выход из приложения не осуществляется.

Примечание. Вызов метода exit() NativeApplication не приводит к прекращению отправки события exiting. Для уведомления компонентов о предстоящем выходе, следует отправить событие exiting до вызова метода exit().

Данное событие имеет следующие свойства.

Отправляется при вызове приложения.

При повторном вызове приложения, его копия не запускается. Вместо этого первой копии приложения поступает дополнительной событие о вызове. Дальнейшая реакция на повторные события invoke зависит от самого приложения.

Примечание. Все события invoke помещаются в очередь. Если прослушиватель для данного события зарегистрирован, он получает все события из очереди, а также все новые события. События из очереди доставляются как до, так и после новых событий invoke.

Объект InvokeEvent имеет следующие свойства.

Отправляется при обнаружении нового сетевого подключения или при разрыве существующего соединения.

Событие networkChange не обязательно обозначает переход компьютера узла в оперативный или автономный режим. Оно также может обозначать переключение с одного соединения на другое. Приложения могут использовать данное событие для оптимизации задач мониторинга доступности удаленных ресурсов. При отправке события networkChange часто наступает удобный момент для проверки доступности любых удаленных ресурсов.

Примечание. Между изменением состояния сети и отправкой данного события может возникнуть короткая задержка.

Данное событие имеет следующие свойства.

Отправляется, когда пользователь пробыл в режиме ожидания период времени, указанный в свойстве idleThreshold.

Время, прошедшее с момента перехода в режим ожидания, хранится в свойстве timeSinceLastUserInput.

Данное событие имеет следующие свойства.

См. также

Отправляется при обнаружении нажатий клавиш или кнопок мыши в среде ОС в режиме ожидания.

Период времени, после которого наступает режим ожидания, регулируется свойством idleThreshold. Время, прошедшее с момента перехода в режим ожидания, хранится в свойстве timeSinceLastUserInput.

Данное событие имеет следующие свойства.

См. также