flash.events.BrowserInvokeEvent (ActionScript 3.0)

(Только AIR)

Пакет	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, отправленные с момента запуска.

См. также

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
		prototype : Object [статические] Ссылка на модель объекта класса или функции.	Object
		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
		toString():String Возвращает строку, содержащую все свойства объекта "Event".	Event
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object

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

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

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

	Константа		Определено
		ACTIVATE : String = "activate" [статические] Константа Event.ACTIVATE определяет значение свойства type объекта события Activitate.	Event
		ADDED : String = "added" [статические] Константа Event.ADDED определяет значение свойства type добавленного объекта события.	Event
		ADDED_TO_STAGE : String = "addedToStage" [статические] Константа Event.ADDED_TO_STAGE определяет значение свойства type объекта события addedToStage.	Event
		BROWSER_INVOKE : String = "browserInvoke" [статические] Константа BrowserInvokeEvent.INVOKE определяет значение свойства type объекта события BrowserInvokeEvent.	BrowserInvokeEvent
		CANCEL : String = "cancel" [статические] Константа Event.CANCEL определяет значение свойства type объекта события cancel.	Event
		CHANGE : String = "change" [статические] Константа Event.CHANGE определяет значение свойства type объекта события change.	Event
		CLEAR : String = "clear" [статические] Задает значение свойства type для объекта события clear.	Event
		CLOSE : String = "close" [статические] Константа Event.CLOSE определяет значение свойства type объекта события close.	Event
		CLOSING : String = "closing" [статические] Константа Event.CLOSING определяет значение свойства type объекта события closing.	Event
		COMPLETE : String = "complete" [статические] Константа Event.COMPLETE определяет значение свойства type объекта события complete.	Event
		CONNECT : String = "connect" [статические] Константа Event.CONNECT определяет значение свойства type объекта события connect.	Event
		COPY : String = "copy" [статические] Задает значение свойства type для объекта события copy.	Event
		CUT : String = "cut" [статические] Задает значение свойства type для объекта события cut.	Event
		DEACTIVATE : String = "deactivate" [статические] Константа Event.DEACTIVATE определяет значение свойства type объекта события deactivate.	Event
		DISPLAYING : String = "displaying" [статические] Задает значение свойства type для объекта события displaying.	Event
		ENTER_FRAME : String = "enterFrame" [статические] Константа Event.ENTER_FRAME определяет значение свойства type объекта события enterFrame.	Event
		EXIT_FRAME : String = "exitFrame" [статические] Определяет значение свойства type объекта exitFrame.	Event
		EXITING : String = "exiting" [статические] Константа Event.EXITING определяет значение свойства type объекта exiting.	Event
		FRAME_CONSTRUCTED : String = "frameConstructed" [статические] Задает значение свойства type для объекта события frameConstructed.	Event
		FULLSCREEN : String = "fullScreen" [статические] Константа Event.FULL_SCREEN определяет значение свойства type для объекта события fullScreen.	Event
		HTML_BOUNDS_CHANGE : String = "htmlBoundsChange" [статические] Константа Event.HTML_BOUNDS_CHANGE определяет значение свойства type объекта htmlBoundsChange.	Event
		HTML_DOM_INITIALIZE : String = "htmlDOMInitialize" [статические] Константа Event.HTML_DOM_INITIALIZE определяет значение свойства type объекта события htmlDOMInitialize.	Event
		HTML_RENDER : String = "htmlRender" [статические] Константа Event.HTML_RENDER определяет значение свойства type объекта события htmlRender.	Event
		ID3 : String = "id3" [статические] Константа Event.ID3 определяет значение свойства type объекта id3.	Event
		INIT : String = "init" [статические] Константа Event.INIT определяет значение свойства type объекта init.	Event
		LOCATION_CHANGE : String = "locationChange" [статические] Константа Event.LOCATION_CHANGE определяет значение свойства type объекта события locationChange.	Event
		MOUSE_LEAVE : String = "mouseLeave" [статические] Константа Event.MOUSE_LEAVE определяет значение свойства type объекта события mouseLeave.	Event
		NETWORK_CHANGE : String = "networkChange" [статические] Константа Event.NETWORK_CHANGE определяет значение свойства type объекта события networkChange.	Event
		OPEN : String = "open" [статические] Константа Event.OPEN определяет значение свойства type объекта open.	Event
		PASTE : String = "paste" [статические] Задает значение свойства type для объекта события paste.	Event
		REMOVED : String = "removed" [статические] Константа Event.REMOVED определяет значение свойства type объекта события removed.	Event
		REMOVED_FROM_STAGE : String = "removedFromStage" [статические] Константа REMOVED_FROM_STAGE определяет значение свойства type объекта события removedFromStage.	Event
		RENDER : String = "render" [статические] Константа Event.RENDER определяет значение свойства type объекта события render.	Event
		RESIZE : String = "resize" [статические] Константа Event.RESIZE определяет значение свойства type объекта события resize.	Event
		SAMPLE_DATA : String = "sampleData" [статические] Задает значение свойства type для объекта события SampleDataEvent.	Event
		SCROLL : String = "scroll" [статические] Константа Event.SCROLL определяет значение свойства type объекта события scroll.	Event
		SELECT : String = "select" [статические] Константа Event.SELECT определяет значение свойства type объекта события select.	Event
		SELECT_ALL : String = "selectAll" [статические] Задает значение свойства type для объекта события selectAll.	Event
		SOUND_COMPLETE : String = "soundComplete" [статические] Константа Event.SOUND_COMPLETE определяет значение свойства type объекта события soundComplete.	Event
		TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [статические] Константа Event.TAB_CHILDREN_CHANGE определяет значение свойства type объекта события tabChildrenChange.	Event
		TAB_ENABLED_CHANGE : String = "tabEnabledChange" [статические] Константа Event.TAB_ENABLED_CHANGE определяет значение свойства type объекта события tabEnabledChange.	Event
		TAB_INDEX_CHANGE : String = "tabIndexChange" [статические] Константа Event.TAB_INDEX_CHANGE определяет значение свойства type объекта события tabIndexChange.	Event
		UNLOAD : String = "unload" [статические] Константа Event.UNLOAD определяет значение свойства type объекта unload.	Event
		USER_IDLE : String = "userIdle" [статические] Константа Event.USER_IDLE определяет значение свойства type объекта события userIdle.	Event
		USER_PRESENT : String = "userPresent" [статические] Константа Event.USER_PRESENT определяет значение свойства type объекта события userPresent.	Event

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

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

См. также

flash.system.Security.sandboxType

securityDomain

свойство

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

Язык версии :

ActionScript 3.0

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

AIR 1.0

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

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

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

BrowserInvokeEvent

()

Конструктор

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

Руководство , константа, определяет значение свойства type объекта события BrowserInvokeEvent.

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

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

См. также

flash.desktop.NativeApplication

Справочник по языку ActionScript 3.0 и компонентам		Home \| Все пакеты \| Все классы \| Элементы языка \| Указатель \| Приложения \| Сокращения \| Кадры Нет кадров
BrowserInvokeEvent	Свойства \| Методы \| События \| Стили \| Эффекты \| Константы \| Примеры