BrowserInvokeEvent

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

Язык версии:

ActionScript 3.0

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

AIR 1.0

Объект NativeApplication приложения AIR отправляет событие browserInvoke при вызове приложения, когда SWF-файл в браузере использует функцию вызова браузера. Объект NativeApplication также отправляет событие browserInvoke, когда пользователь инициирует функцию бесшовной установки в браузере и SWF-файл в браузере передает массив параметру arguments метода launchApplication() файла air.swf. (Подробные сведения см. в разделе «Распределение, установка и запуск приложений AIR» в руководстве по разработке AIR.)

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

<allowBrowserInvocation>true</allowBrowserInvocation>

Если приложение не запущено, объект NativeApplication отправляет и объект InvokeEvent и событие browserInvoke при запуске из браузера. А если приложение уже запущено, то при запуске из браузера объект NativeApplication отправляет только событие browserInvoke.

Если приложение запущено в результате бесшовной установки из браузера (когда пользователь выбирает запуск после установки), объект NativeApplication отправляет событие BrowserInvoke, только если были переданы аргументы (SWF-файл в браузере должен передать массив параметру arguments метода installApplication() файла air.swf). Подробные сведения см. в разделе «Распределение, установка и запуск приложений AIR» в руководстве по разработке AIR.

Как и события invokeEvent, события browserInvokeEvent отправляются объектом NativeApplication (NativeApplication.nativeApplication). Для получения событий browserInvoke необходимо вызвать метод addEventListener() объекта NativeApplication. Когда регистрируется прослушиватель события browserInvoke, он также получает все события browserInvoke, отправленные до регистрации. Эти события отправлены после возврата вызова addEventListener(), но не обязательно перед другими событиями browserInvoke, которые могут быть получены после регистрации. Это позволяет обрабатывать события browserInvoke, которые произошли до выполнения кода инициализации (например, если приложение было сначала вызвано из браузера). Следует учитывать, что если прослушиватель событий добавляется позже при выполнении (после инициализации приложения), он все равно получает все события browserInvoke, отправленные с момента запуска.

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

flash.events.InvokeEvent
flash.desktop.NativeApplication

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

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

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

	Свойство		Определено
		arguments : Array [только для чтения] Массив аргументов (строк), передаваемых приложению.	BrowserInvokeEvent
		bubbles : Boolean [только для чтения] Определяет, является ли событие событием восходящей цепочки.	Event
		cancelable : Boolean [только для чтения] Указывает, можно ли предотвратить поведение, связанное с событием.	Event
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		currentTarget : Object [только для чтения] Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.	Event
		eventPhase : uint [только для чтения] Текущая фаза в потоке событий.	Event
		isHTTPS : Boolean [только для чтения] Указывает, использует ли содержимое в браузере URL-адрес с HTTPS (true) или нет (false).	BrowserInvokeEvent
		isUserEvent : Boolean [только для чтения] Указывает, выполнен ли вызов из браузера в результате события пользователя (например, щелчка мыши).	BrowserInvokeEvent
		sandboxType : String [только для чтения] Тип изолированной программной среды для содержимого в обозревателе.	BrowserInvokeEvent
		securityDomain : String [только для чтения] Домен защиты для содержимого в браузере, например www.adobe.com или www.example.org.	BrowserInvokeEvent
		target : Object [только для чтения] Целевой объект события.	Event
		type : String [только для чтения] Тип события.	Event

Общедоступные методы

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

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

	Метод		Определено
		BrowserInvokeEvent(type:String, bubbles:Boolean, cancelable:Boolean, arguments:Array, sandboxType:String, securityDomain:String, isHTTPS:Boolean, isUserEvent:Boolean) Функция конструктора для класса BrowserInvokeEvent.	BrowserInvokeEvent
		clone():Event [переопределить] Создает новую копию данного события.	BrowserInvokeEvent
		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

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

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

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

	Константа		Определено
		BROWSER_INVOKE : String = "browserInvoke" [статические] Константа BrowserInvokeEvent.BROWSER_INVOKE определяет значение свойства type объекта BrowserInvokeEvent.	BrowserInvokeEvent

Сведения о свойстве

arguments

свойство

arguments:Array [только для чтения]

Язык версии:

ActionScript 3.0

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

AIR 1.0

Массив аргументов (строк), передаваемых приложению.

Реализация
public function get arguments():Array

isHTTPS

свойство

isHTTPS:Boolean [только для чтения]

Язык версии:

ActionScript 3.0

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

AIR 1.0

Указывает, использует ли содержимое в браузере URL-адреса с HTTPS (true) или нет (false).

Реализация
public function get isHTTPS():Boolean

isUserEvent

свойство

isUserEvent:Boolean [только для чтения]

Язык версии:

ActionScript 3.0

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

AIR 1.0

Указывает, выполнен ли вызов из браузера в результате события пользователя (например, щелчка мыши). В AIR 1.0 всегда имеет значение true; в AIR требуется, чтобы пользователь инициировал вызов функции вызова приложения из браузера.

Реализация
public function get isUserEvent():Boolean

sandboxType

свойство

sandboxType:String [только для чтения]

Язык версии:

ActionScript 3.0

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

AIR 1.0

Тип изолированной программной среды для содержимого в браузере. Может иметь одно из следующих значений.

Security.APPLICATION — содержимое находится в изолированной программной среде безопасности приложения.
Security.LOCAL_TRUSTED — содержимое находится в изолированной программной среде безопасности, надежной для локальной системы.
Security.LOCAL_WITH_FILE — содержимое находится в изолированной программной среде безопасности, локальной для файловой системы.
Security.LOCAL_WITH_NETWORK — содержимое находится в изолированной программной среде безопасности, локальной для сети.
Security.REMOTE — содержимое находится в удаленном (сетевом) домене.

Реализация
public function get sandboxType():String

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

flash.system.Security.sandboxType

securityDomain

свойство

securityDomain:String [только для чтения]

Язык версии:

ActionScript 3.0

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

AIR 1.0

Домен защиты для содержимого в браузере, например www.adobe.com или www.example.org. Это свойство задается только для содержимого в удаленной изолированной программной среде безопасности (для содержимого из сетевого домена), а не для содержимого в локальной среде или среде приложения.

Реализация
public function get securityDomain():String

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

()

Конструктор

public function BrowserInvokeEvent(type:String, bubbles:Boolean, cancelable:Boolean, arguments:Array, sandboxType:String, securityDomain:String, isHTTPS:Boolean, isUserEvent:Boolean)

Язык версии:

ActionScript 3.0

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

AIR 1.0

Функция конструктора для класса BrowserInvokeEvent. Как правило, разработчики не вызывают конструктор BrowserInvokeEvent() напрямую. Объект BrowserInvokeEvent должен создаваться только во время выполнения.

Параметры

	`type:String` — Тип события, представленный в виде `Event.type`.

	`bubbles:Boolean` — Имеет значение `false` для объекта BrowserInvokeEvent.

	`cancelable:Boolean` — Имеет значение `false` для объекта BrowserInvokeEvent.

	`arguments:Array` — Массив аргументов (строк), передаваемых приложению.

	`sandboxType:String` — Тип изолированной программной среды для содержимого в обозревателе.

	`securityDomain:String` — Домен защиты для содержимого в обозревателе.

	`isHTTPS:Boolean` — Указывает, использует ли содержимое в браузере безопасный URL-адрес (HTTPS).

	`isUserEvent:Boolean` — Указывает, был ли вызов из браузера результатом события пользователя.

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

clone

()

метод

override public function clone():Event

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

AIR 1.0

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

Возвращает

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

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

BROWSER_INVOKE

Константа

public static const BROWSER_INVOKE:String = "browserInvoke"

Язык версии:

ActionScript 3.0

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

AIR 1.0

Константа BrowserInvokeEvent.BROWSER_INVOKE определяет значение свойства type объекта BrowserInvokeEvent.

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

Свойства	Значения
`arguments`	Массив строковых аргументов, передаваемых в ходе данного вызова.
`sandBoxType`	Строка, представляющая тип изолированной программной среды содержимого в браузере (`Security.APPLICATION`, `Security.LOCAL_TRUSTED`, `Security.LOCAL_WITH_FILE`, `Security.LOCAL_LOCAL_WITH_NETWORK` или `Security.REMOTE`).
`securityDomain`	Строка, представляющая домен защиты для содержимого в браузере (например, `www.example.com`).
`isHTTPS`	Указывает, использует ли содержимое в браузере URL-адрес с HTTPS (`true`) или нет (`false`)
`isUserEvent`	Указывает, выполнен ли вызов из обозревателя в результате события пользователя (всегда `true` в AIR 1.0).
`bubbles`	Нет.
`cancelable`	`false`; нет поведения по умолчанию для отмены.
`currentTarget`	Объект, активно обрабатывающий объект InvokeEvent с помощью прослушивателя событий.
`target`	Всегда объект NativeApplication.

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

flash.desktop.NativeApplication

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

BrowserInvokeEvent - AS3

Классы x

arguments

isHTTPS

isUserEvent

sandboxType

securityDomain