| Пакет | flash.events |
| Класс | public class InvokeEvent |
| Наследование | InvokeEvent  Event Object |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
invoke при вызове приложения.
Объект NativeApplication всегда отправляет событие invoke при запуске приложения, но событие может отправляться и в других случаях. Например, работающее приложение отправляет дополнительное событие InvokeEvent, когда пользователь активирует файл, связанный с приложением.
Может быть запущен только один экземпляр данного приложения. Последующие попытки запустить приложение приведут к отправке новых событий invoke объекта NativeApplication работающего экземпляра. Приложение отвечает за обработку данного события и выполнение соответствующего действия, например открытия нового окна приложения для отображения данных файла.
Объекты InvokeEvent отправляются объектом NativeApplication (NativeApplication.nativeApplication). Для получения событий invoke необходимо вызвать метод addEventListener() объекта NativeApplication. Когда регистрируется прослушиватель события invoke, он также получает все события invoke, отправленные до регистрации. Эти предшествующие события отправлены после возврата вызова addEventListener(), но не обязательно перед новым событием invoke, которое может быть отправлено после регистрации. Поэтому не следует полагаться на порядок отправки.
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
| arguments : Array [только для чтения]
Массив строковых аргументов, передаваемых в ходе данного вызова. | InvokeEvent | ||
 | bubbles : Boolean [только для чтения]
Определяет, является ли событие событием восходящей цепочки. | Event | |
| cancelable : Boolean [только для чтения]
Указывает, можно ли предотвратить поведение, связанное с событием. | Event | |
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| currentDirectory : File [только для чтения]
Каталог, который должен использоваться для разрешения относительных путей в массиве arguments. | InvokeEvent | ||
| currentTarget : Object [только для чтения]
Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. | Event | |
| eventPhase : uint [только для чтения]
Текущая фаза в потоке событий. | Event | |
| reason : String [только для чтения]
Причина данного InvokeEvent. | InvokeEvent | ||
| target : Object [только для чтения]
Целевой объект события. | Event | |
| type : String [только для чтения]
Тип события. | Event | |
| Метод | Определено | ||
|---|---|---|---|
InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")
Функция конструктора для класса InvokeEvent. | InvokeEvent | ||
[переопределить]
Создает новую копию данного события. | InvokeEvent | ||
|
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. | Event | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Проверяет, выполнялся ли для события вызова метода preventDefault(). | Event | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Отменяет поведение по умолчанию для события, если такое поведение можно отменить. | Event | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. | Event | |
|
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. | Event | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строку, содержащую все свойства объекта Event. | Event | |
|
Возвращает элементарное значение заданного объекта. | Object | |
| Константа | Определено | ||
|---|---|---|---|
| INVOKE : String = "invoke" [статические]
Константа InvokeEvent.INVOKE определяет значение свойства typeм объекта InvokeEvent. | InvokeEvent | ||
arguments | свойство |
arguments:Array [только для чтения] | Версии среды выполнения: | AIR 1.0 |
Массив строковых аргументов, передаваемых в ходе данного вызова. Если это вызов из командной строки, массив содержит аргументы командной строки (за исключением имени процесса).
На мобильных платформах это свойство содержит массив параметров, с которыми было запущено приложение, а не набор параметров командной строки. Кроме того, когда на мобильных платформах reason имеет значение InvokeEventReason.OPEN_URL, содержимое массива arguments варьируется следующим образом:
- Другое приложение или браузер вызывает приложение посредством пользовательского URL (в iOS и Android):
arguments iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]source app id action id InvokeEvent.arguments[2]null NA - Система вызывает приложение с целью открытия файла связанного с ним типа (iOS и Android):
arguments iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]null action id InvokeEvent.arguments[2]null NA - Другое приложение вызывает приложение с помощью контроллера взаимодействия между документами (только iOS):
arguments iOS InvokeEvent.arguments.length3 InvokeEvent.arguments[0]url InvokeEvent.arguments[1]source app id InvokeEvent.arguments[2]annotation
Примечание. Когда несколько файлов выделяются и открываются в Mac® OS X, AIR отправляет одно событие invoke, содержащее имена всех выбранных файлов в массивеarguments. В Windows® и Linux, однако, AIR отправляет отдельное событие invoke для каждого выделенного файла, содержащее только имя этого файла в массиве arguments.
Реализация
public function get arguments():Array currentDirectory | свойство |
currentDirectory:File [только для чтения] | Версии среды выполнения: | AIR 1.0 |
Каталог, который должен использоваться для разрешения относительных путей в массиве arguments.
Если приложение запускается из командной строки, для этого свойства обычно задается текущий рабочий каталог оболочки командной строки, из которой запущено приложение. Если приложение запускается из оболочки графического пользовательского интерфейса, как правило, задается корневой каталог файловой системы.
Реализация
public function get currentDirectory():File reason | свойство |
reason:String [только для чтения] | Версии среды выполнения: | AIR 1.5.1 |
Причина данного InvokeEvent. Данное свойство указывает на способ запуска приложения: вручную пользователем или автоматически при входе в систему. Возможные значения перечислены в виде констант в классе InvokeEventReason.
| Константа InvokeEventReason | Значение |
|---|---|
LOGIN | Автоматический запуск при входе в систему. |
NOTIFICATION | Запущено в ответ на уведомление (только в iOS). |
OPEN_URL | Запущено в результате вызова приложения другим приложением. |
STANDARD | Запуск по какой-либо другой причине. |
Примечание. На мобильных платформах свойство reason никогда не имеет значения LOGIN.
Реализация
public function get reason():StringСвязанные элементы API
InvokeEvent | () | Конструктор |
public function InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Функция конструктора для класса InvokeEvent.
Параметрыtype:String — Тип события, представленный в виде Event.type.
| |
bubbles:Boolean (default = false)false для объекта InvokeEvent.
| |
cancelable:Boolean (default = false)false для объекта InvokeEvent.
| |
dir:File (default = null)arguments.
| |
argv:Array (default = null) | |
reason:String (default = "standard")InvokeEventReason.LOGIN, InvokeEventReason.STANDARD, InvokeEventReason.OPEN_URL или InvokeEventReason.NOTIFICATION. (Этот параметр доступен начиная с версии AIR 1.5.1. OPEN_URL и NOTIFICATION доступны начиная с версии AIR 3.5.)
|
Связанные элементы API
clone | () | метод |
INVOKE | Константа |
public static const INVOKE:String = "invoke"| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Константа 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. |
Связанные элементы API
Tue Jun 12 2018, 11:34 AM Z