Класс WebHistory

java.lang.Object

javafx.scene.web.WebHistory

public final class WebHistory
extends Object

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

С:: JavaFX 2.2

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

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

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

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

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

Модификатор и тип	Метод	Описание
`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()).

См. также:: getCurrentIndex()

maxSize

public IntegerProperty maxSizeProperty

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

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

Значение по умолчанию:: 100
См. также:: getMaxSize(), setMaxSize(int)

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

currentIndexProperty

public ReadOnlyIntegerProperty currentIndexProperty()

См. также:: getCurrentIndex()

getCurrentIndex

public int getCurrentIndex()

Возвращает значение свойства currentIndex.

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

maxSizeProperty

public IntegerProperty maxSizeProperty()

Значение по умолчанию:: 100
См. также:: getMaxSize(), setMaxSize(int)

setMaxSize

public void setMaxSize(int value)

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

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

getMaxSize

public int getMaxSize()

Возвращает значение свойства maxSize.

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

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.