Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
mx.managers 

IBrowserManager  - AS3 Flex

Пакетmx.managers
Интерфейсpublic interface IBrowserManager extends IEventDispatcher

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Интерфейс, реализуемый общедоступным экземпляром BrowserManager. Приложения прослушивают события, вызывают методы и получают доступ к свойствам на общедоступном экземпляре, доступ к которому осуществляется с помощью метода BrowserManager.getInstance().

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



Общедоступные свойства
 СвойствоОпределено
  base : String
[только для чтения] Часть текущего URL-адреса перед #, как она отображается в адресной строке браузера.
IBrowserManager
  fragment : String
[только для чтения] Часть текущего URL-адреса после #, как она отображается в адресной строке браузера.
IBrowserManager
  title : String
[только для чтения] Заголовок приложения, как он должен отображаться в истории браузера.
IBrowserManager
  url : String
[только для чтения] Текущий URL-адрес, как он отображается в адресной строке браузера.
IBrowserManager
Общедоступные методы
 МетодОпределено
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
IEventDispatcher
 Inherited
Посылает событие в поток событий.
IEventDispatcher
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
IEventDispatcher
  
init(value:String = null, title:String = null):void
Инициализирует BrowserManager.
IBrowserManager
  
Инициализирует BrowserManager.
IBrowserManager
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
IEventDispatcher
  
Изменяет в браузере фрагмент URL-адреса после #.
IBrowserManager
  
Изменяет текст в строке заголовка браузера.
IBrowserManager
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
IEventDispatcher
События
 Событие Сводка Определено
  Передается при изменении URL-адреса браузером.IBrowserManager
  Передается при изменении URL-адреса пользователем при помощи взаимодействия с браузером, вызова приложения в AIR или программной установки свойства.IBrowserManager
  Передается при изменении URL-адреса приложением.IBrowserManager
Сведения о свойстве

base

свойство
base:String  [только для чтения]

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Часть текущего URL-адреса перед #, как она отображается в адресной строке браузера.



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

fragment

свойство 
fragment:String  [только для чтения]

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Часть текущего URL-адреса после #, как она отображается в адресной строке браузера. Для изменения этого значения используется метод setURLFragment().



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

title

свойство 
title:String  [только для чтения]

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Заголовок приложения, как он должен отображаться в истории браузера.



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

url

свойство 
url:String  [только для чтения]

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Текущий URL-адрес, как он отображается в адресной строке браузера.



Реализация
    public function get url():String
Сведения о методе

init

()метод
public function init(value:String = null, title:String = null):void

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Инициализирует BrowserManager. BrowserManager получит начальный URL-адрес. При наличии в нем фрагмента он передаст событие BROWSER_URL_CHANGE. Этот метод устанавливает для свойства ApplicationGlobals.application.historyManagementEnabled значение false, т.к. HistoryManager, как правило, сталкивается с обработкой фрагментов URL-адреса приложением.

Параметры

value:String (default = null) — Фрагмент для использования в случае отсутствия фрагмента в начальном URL-адресе.
 
title:String (default = null) — Заголовок для использования в случае отсутствия фрагмента в начальном URL-адресе.

initForHistoryManager

()метод 
public function initForHistoryManager():void

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Инициализирует BrowserManager. HistoryManager вызывает этот метод для подготовки BrowserManager к дальнейшим вызовам из HistoryManager. Невозможно использовать HistoryManager и вызывать из приложения метод setFragment(). В результате метод init() обычно назначает свойству ApplicationGlobals.application.historyManagementEnabled значение false для отключения HistoryManager.

setFragment

()метод 
public function setFragment(value:String):void

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Изменяет в браузере фрагмент URL-адреса после #. Будет выполнена попытка проследить этот URL-адрес в истории браузера.

При установленном заголовке старый заголовок в браузере заменяется новым.

Для хранения URL-адреса вызывается метод JavaScript setBrowserURL(). Оболочка HTML приложения должна иметь этот метод, который должен реализовать механизм для принятия этого значения и регистрации его на схеме истории браузера и в адресной строке.

При установке передается событие APPLICATION_URL_CHANGE. При отмене события метод setBrowserURL() не вызывается.

Параметры

value:String — Новый фрагмент для использования после # в URL-адресе.

setTitle

()метод 
public function setTitle(value:String):void

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Изменяет текст в строке заголовка браузера. Этот метод не влияет на историю браузера.

Параметры

value:String — Новый заголовок для использования в строке заголовка браузера.

Сведения о событии

browserURLChange

Событие
Тип объекта события: mx.events.BrowserChangeEvent
свойство BrowserChangeEvent.type = mx.events.BrowserChangeEvent.BROWSER_URL_CHANGE

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Передается при изменении URL-адреса браузером.

Константа BrowserChangeEvent.BROWSER_URL_CHANGE определяет значение свойства type объекта события browserURLChange.

Свойства объекта события имеют следующие значения:

СвойствоЗначение
bubblesfalse
cancelablefalse
currentTargetОбъект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton.
lastURLПредыдущее значение свойства url этого BrowserManager.
targetОбъект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие.
urlНовое значение свойства url этого BrowserManager.

change

Событие  
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.CHANGE

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Передается при изменении URL-адреса пользователем при помощи взаимодействия с браузером, вызова приложения в AIR или программной установки свойства.

Константа Event.CHANGE определяет значение свойства type объекта события change.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblestrue
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект, значение которого было изменено. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.

urlChange

Событие  
Тип объекта события: mx.events.BrowserChangeEvent
свойство BrowserChangeEvent.type = mx.events.BrowserChangeEvent.URL_CHANGE

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Передается при изменении URL-адреса приложением.

Константа BrowserChangeEvent.URL_CHANGE определяет значение свойства type объекта события urlChange.

Свойства объекта события имеют следующие значения:

СвойствоЗначение
bubblesfalse
cancelablefalse
currentTargetОбъект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton.
lastURLПредыдущее значение свойства url этого BrowserManager.
targetОбъект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие.
urlНовое значение свойства url этого BrowserManager.




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.