Класс 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 |
Определяет максимальный размер списка истории. |
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
final class |
WebHistory.Entry |
Класс Entry представляет отдельную запись в истории сессии. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
ReadOnlyIntegerProperty |
currentIndexProperty() |
Определяет индекс текущей Entry в истории. |
int |
getCurrentIndex() |
Возвращает значение свойства currentIndex. |
ObservableList<WebHistory.Entry> |
getEntries() |
Возвращает неизменяемый наблюдаемый список всех записей в истории. |
int |
getMaxSize() |
Возвращает значение свойства maxSize. |
void |
go |
Перенаправляет веб-движок на URL, определенный объектом Entry, в указанной позиции относительно текущей записи. |
IntegerProperty |
maxSizeProperty() |
Определяет максимальный размер списка истории. |
void |
setMaxSize |
Устанавливает значение свойства maxSize. |
Подробное описание свойств
currentIndex
public ReadOnlyIntegerProperty currentIndexProperty
Определяет индекс текущей
Entry в истории. Текущая запись — это запись, связанная с текущей загруженной страницей. Индекс принадлежит диапазону (index >= 0 && index < getEntries().size()).- См. также:
maxSize
public IntegerProperty maxSizeProperty
Определяет максимальный размер списка истории. Если список достигает максимального размера, и добавляется новая запись, первая запись удаляется из истории.
Значение, заданное для этого свойства, не может быть отрицательным, в противном случае будет брошено исключение IllegalArgumentException.
- Значение по умолчанию:
- 100
- См. также:
Подробное описание методов
currentIndexProperty
public ReadOnlyIntegerProperty currentIndexProperty()
Определяет индекс текущей
Entry в истории. Текущая запись — это запись, связанная с текущей загруженной страницей. Индекс принадлежит диапазону (index >= 0 && index < getEntries().size()).- Возвращает:
- свойство currentIndex
- См. также:
getCurrentIndex
public int getCurrentIndex()
Возвращает значение свойства
currentIndex.- Описание свойства:
- Определяет индекс текущей
Entryв истории. Текущая запись — это запись, связанная с текущей загруженной страницей. Индекс принадлежит диапазону(index >= 0 && index < getEntries().size()). - Возвращает:
- значение свойства
currentIndex - См. также:
maxSizeProperty
public IntegerProperty maxSizeProperty()
Определяет максимальный размер списка истории. Если список достигает максимального размера, и добавляется новая запись, первая запись удаляется из истории.
Значение, заданное для этого свойства, не может быть отрицательным, в противном случае будет брошено исключение IllegalArgumentException.
- Значение по умолчанию:
- 100
- Возвращает:
- свойство maxSize
- См. также:
setMaxSize
public void setMaxSize(int value)
Устанавливает значение свойства
maxSize.- Описание свойства:
- Определяет максимальный размер списка истории. Если список достигает максимального размера, и добавляется новая запись, первая запись удаляется из истории.
Значение, заданное для этого свойства, не может быть отрицательным, в противном случае будет брошено исключение
IllegalArgumentException. - Значение по умолчанию:
- 100
- Параметры:
-
value- значение для свойстваmaxSize - См. также:
getMaxSize
public int getMaxSize()
Возвращает значение свойства
maxSize.- Описание свойства:
- Определяет максимальный размер списка истории. Если список достигает максимального размера, и добавляется новая запись, первая запись удаляется из истории.
Значение, заданное для этого свойства, не может быть отрицательным, в противном случае будет брошено исключение
IllegalArgumentException. - Значение по умолчанию:
- 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.
