Класс WebHistory

java.lang.Object

fx.scene.web.WebHistory

public final class WebHistory extends Object

Класс WebHistory представляет историю сеанса, связанную с экземпляром WebEngine. Единственный экземпляр WebHistory для конкретного веб-движка можно получить через метод WebEngine.getHistory(). История по сути является списком записей. Каждая запись представляет посещенную страницу и предоставляет доступ к соответствующей информации о странице, такой как URL, заголовок и дата последнего посещения. Записи в списке упорядочены в порядке посещения страниц от старых к новым. Список можно получить, используя метод getEntries(). История и соответствующий список записей изменяются по мере того, как WebEngine перемещается по веб-страницам. Список может увеличиваться или уменьшаться в зависимости от действий браузера. Эти изменения можно прослушивать с помощью API ObservableList, который предоставляет список. Индекс записи истории, связанной с текущей посещаемой страницей, представлен свойством currentIndexProperty(). Текущий индекс можно использовать для перехода к любой записи в истории, используя метод go(int). Свойство maxSizeProperty() задает максимальный размер истории, который соответствует размеру списка истории.

Since:: JavaFX 2.2

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`final class`	`WebHistory.Entry`	Класс `Entry` представляет собой отдельную запись в истории сеанса.

Краткое описание свойств

Тип	Свойство	Описание
`ReadOnlyIntegerProperty`	`currentIndex`	Определяет индекс текущей `Entry` в истории.
`IntegerProperty`	`maxSize`	Определяет максимальный размер списка истории.

Краткое описание методов

Модификатор и тип	Метод	Описание
`ReadOnlyIntegerProperty`	`currentIndexProperty()`	Определяет индекс текущей `Entry` в истории.
`int`	`getCurrentIndex()`	Получает значение свойства `currentIndex`.
`ObservableList<WebHistory.Entry>`	`getEntries()`	Возвращает неизменяемый наблюдаемый список всех записей в истории.
`int`	`getMaxSize()`	Получает значение свойства `maxSize`.
`void`	`go(int offset)`	Перемещает веб-движок по URL, определенному объектом `Entry`, в указанной позиции относительно текущей записи.
`IntegerProperty`	`maxSizeProperty()`	Определяет максимальный размер списка истории.
`void`	`setMaxSize(int value)`	Устанавливает значение свойства `maxSize`.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание свойств

currentIndex

public ReadOnlyIntegerProperty currentIndexProperty

Определяет индекс текущей Entry в истории. Текущая запись — это запись, связанная с текущей загруженной страницей. Индекс находится в диапазоне (index >= 0 && index < getEntries().size()).

См. также:

maxSize

public IntegerProperty maxSizeProperty

Определяет максимальный размер списка истории. Если список достигает максимального размера, и добавляется новая запись, то из истории удаляется первая запись.

Значение, заданное для этого свойства, не может быть отрицательным, в противном случае будет выброшено исключение IllegalArgumentException.

Значение по умолчанию:

100

См. также:

Подробное описание методов

currentIndexProperty

public ReadOnlyIntegerProperty currentIndexProperty()

Возвращает:

свойство currentIndex

См. также:

getCurrentIndex

public int getCurrentIndex()

Получает значение свойства currentIndex.

Описание свойства:

Возвращает:

значение свойства currentIndex

См. также:

maxSizeProperty

public IntegerProperty maxSizeProperty()

Значение по умолчанию:

100

Возвращает:

свойство maxSize

См. также:

setMaxSize

public void setMaxSize(int value)

Устанавливает значение свойства maxSize.

Описание свойства:

Значение по умолчанию:

100

Параметры:

value - значение для свойства maxSize

См. также:

getMaxSize

public int getMaxSize()

Получает значение свойства maxSize.

Описание свойства:

Значение по умолчанию:

100

Возвращает:

значение свойства maxSize

См. также:

getEntries

public ObservableList<WebHistory.Entry> getEntries()

Возвращает неизменяемый наблюдаемый список всех записей в истории.

Возвращает:: список всех записей истории

go

public void go(int offset) throws IndexOutOfBoundsException

Переходит в веб-движке к URL, определенному объектом Entry в указанной позиции относительно текущей записи. Отрицательное значение offset указывает на позицию, предшествующую текущей записи, а положительное значение offset указывает на позицию, следующую за текущей записью. Например, -1 указывает на предыдущую запись, а 1 указывает на следующую запись, соответствующие нажатию на кнопки "Назад" и "Вперед" в веб-браузере соответственно. Нулевое значение offset игнорируется (бездействие). Эффективная позиция записи должна принадлежать диапазону [0..size-1]. В противном случае выброшено исключение IndexOutOfBoundsException.

Параметры:: offset - отрицательное значение указывает на позицию, предшествующую текущей записи, положительное значение указывает на позицию, следующую за текущей записью, нулевое значение не оказывает влияния
Исключения:: IndexOutOfBoundsException - если эффективная позиция записи находится вне диапазона

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.