| Пакет | flash.events |
| Класс | public class BrowserInvokeEvent |
| Наследование | BrowserInvokeEvent  Event Object |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
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
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
| 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 | ||
[переопределить]
Создает новую копию данного события. | BrowserInvokeEvent | ||
|
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. | Event | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Проверяет, выполнялся ли для события вызова метода preventDefault(). | Event | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Отменяет поведение по умолчанию для события, если такое поведение можно отменить. | Event | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. | Event | |
|
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. | Event | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строку, содержащую все свойства объекта Event. | Event | |
|
Возвращает элементарное значение заданного объекта. | Object | |
| Константа | Определено | ||
|---|---|---|---|
| BROWSER_INVOKE : String = "browserInvoke" [статические]
Константа BrowserInvokeEvent.BROWSER_INVOKE определяет значение свойства type объекта BrowserInvokeEvent. | BrowserInvokeEvent | ||
arguments | свойство |
isHTTPS | свойство |
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
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 | () | метод |
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
Tue Jun 12 2018, 11:34 AM Z