Пакет | mx.managers |
Класс | public class HistoryManager |
Наследование | HistoryManager Object |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Как правило, для поддержания состояния приложения, а также управления URL-адресами и историей браузера следует использовать класс BrowserManager и внешние ссылки, но при некоторых обстоятельствах, например при использовании устаревшего приложения Flex, может быть рекомендован класс HistoryManager. Невозможно запустить классы HistoryManager и BrowserManager в одном приложении Flex даже в том случае, если они используют один набор файлов поддержки.
Управление историей по умолчанию включается для контейнеров Accordion и TabNavigator. Это означает, что если пользователь выбирает одну из панелей в элементе управления Accordion, он может вернуться к предыдущей панели путем нажатия кнопки браузера «Назад» или команды навигации «Назад». Управление историей для контейнера навигатора ViewStack по умолчанию отключается.
Отключить управление историей можно путем установки для свойства контейнера навигатора historyManagementEnabled
значения false
.
Можно также включить управление историей для других объектов приложения путем регистрации этих объектов в HistoryManager. Для регистрации компонента в классе HistoryManager следует вызвать метод класса HistoryManager register()
со ссылкой на экземпляр компонента, реализующий интерфейс IHistoryManagerClient. В следующем примере компонент приложения (this
) зарегистрирован в классе HistoryManager при инициализации приложения:
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" implements="mx.managers.IHistoryManagerClient" initialize="mx.managers.HistoryManager.register(this);">Для завершения регистрации компонента следует также реализовать методы
saveState()
и loadState()
интерфейса IHistoryManagerClient. Компоненты, являющиеся расширением UIComponent, автоматически наследуют метод loadState()
.
Все методы и свойства HistoryManager являются статическими, и таким образом, отсутствует необходимость создания его экземпляра.
Связанные элементы API
Метод | Определено | ||
---|---|---|---|
Показывает, определено ли заданное свойство для объекта. | Object | ||
[статические]
Устаревший – инициализирует HistoryManager. | HistoryManager | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
[статические]
Регистрирует объект в HistoryManager. | HistoryManager | ||
[статические]
Сохраняет текущее состояние приложения для его последующего восстановления. | HistoryManager | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
[статические]
Отменяет регистрацию объекта в HistoryManager. | HistoryManager | ||
Возвращает элементарное значение заданного объекта. | Object |
initialize | () | метод |
public static function initialize(sm:ISystemManager):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Устаревший – инициализирует HistoryManager. Как правило, необходимость в его вызове отсутствует, так как при каждом добавлении компонента с использованием historyManagementEnabled
Flex выполняет вызов этого метода. Однако HistoryManager не будет работать правильно, если он не будет инициализирован из приложения верхнего уровня. Таким образом, если приложение не содержит каких-либо включенных в него посредством HistoryManager компонентов и загружает другие подчиненные приложения, содержащие их, то в главном приложении следует вызвать метод HistoryManager.initialize()
, обычно из обработчика событий initialize
этого приложения.
Параметры
sm:ISystemManager — SystemManager для этого приложения.
|
register | () | метод |
public static function register(obj:IHistoryManagerClient):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Регистрирует объект в HistoryManager. Объект должен реализовывать интерфейс IHistoryManagerClient.
Параметры
obj:IHistoryManagerClient — Регистрируемый объект.
|
Связанные элементы API
save | () | метод |
public static function save():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сохраняет текущее состояние приложения для его последующего восстановления. Этот метод автоматически вызывается контейнерами навигатора при каждом изменении состояния навигации. Если интерфейс зарегистрирован в HistoryManager, то при изменении состояния приложения следует вызвать метод save()
.
unregister | () | метод |
public static function unregister(obj:IHistoryManagerClient):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отменяет регистрацию объекта в HistoryManager.
Параметры
obj:IHistoryManagerClient — Объект, для которого отменяется регистрация.
|
Tue Jun 12 2018, 11:34 AM Z