InvokeEvent

Пакет	flash.events
Класс	public class InvokeEvent
Наследование	InvokeEvent Event Object

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0

Объект NativeApplication приложения AIR отправляет событие invoke при вызове приложения.

Объект NativeApplication всегда отправляет событие invoke при запуске приложения, но событие может отправляться и в других случаях. Например, работающее приложение отправляет дополнительное событие InvokeEvent, когда пользователь активирует файл, связанный с приложением.

Может быть запущен только один экземпляр данного приложения. Последующие попытки запустить приложение приведут к отправке новых событий invoke объекта NativeApplication работающего экземпляра. Приложение отвечает за обработку данного события и выполнение соответствующего действия, например открытия нового окна приложения для отображения данных файла.

Объекты InvokeEvent отправляются объектом NativeApplication (NativeApplication.nativeApplication). Для получения событий invoke необходимо вызвать метод addEventListener() объекта NativeApplication. Когда регистрируется прослушиватель события invoke, он также получает все события invoke, отправленные до регистрации. Эти предшествующие события отправлены после возврата вызова addEventListener(), но не обязательно перед новым событием invoke, которое может быть отправлено после регистрации. Поэтому не следует полагаться на порядок отправки.

Связанные элементы API

flash.events.BrowserInvokeEvent
flash.desktop.NativeApplication

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		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
		clone():Event [переопределить] Создает новую копию данного события.	InvokeEvent
		formatToString(className:String, ... arguments):String Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event.	Event
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		isDefaultPrevented():Boolean Проверяет, выполнялся ли для события вызова метода preventDefault().	Event
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		preventDefault():void Отменяет поведение по умолчанию для события, если такое поведение можно отменить.	Event
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		stopImmediatePropagation():void Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом.	Event
		stopPropagation():void Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом.	Event
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строку, содержащую все свойства объекта Event.	Event
		valueOf():Object Возвращает элементарное значение заданного объекта.	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.length 3 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.length 3 2
InvokeEvent.arguments[0] url url
InvokeEvent.arguments[1] null action id
InvokeEvent.arguments[2] null NA
Другое приложение вызывает приложение с помощью контроллера взаимодействия между документами (только iOS):
arguments iOS
InvokeEvent.arguments.length 3
InvokeEvent.arguments[0] url
InvokeEvent.arguments[1] source app id
InvokeEvent.arguments[2] annotation

arguments	iOS	Android
`InvokeEvent.arguments.length`	3	2
`InvokeEvent.arguments[0]`	url	url
`InvokeEvent.arguments[1]`	source app id	action id
`InvokeEvent.arguments[2]`	null	NA

arguments	iOS	Android
`InvokeEvent.arguments.length`	3	2
`InvokeEvent.arguments[0]`	url	url
`InvokeEvent.arguments[1]`	null	action id
`InvokeEvent.arguments[2]`	null	NA

arguments	iOS
`InvokeEvent.arguments.length`	3
`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

flash.desktop.InvokeEventReason

Сведения о конструкторе

()

Конструктор

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

flash.desktop.InvokeEventReason

Сведения о методе

clone

()

метод

override public function clone():Event

Версии среды выполнения:

AIR 1.0

Создает новую копию данного события.

Возвращает

Event — Копия события.

Сведения о константе

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

flash.desktop.NativeApplication
flash.desktop.InvokeEventReason

Юридическая информация | Политика конфиденциальности онлайн

InvokeEvent - AS3

Классы x

arguments

currentDirectory

reason

InvokeEvent

clone

INVOKE