- java.lang.Object
-
- javafx.scene.web.WebHistory
-
public final class WebHistory extends Object
КлассWebHistoryпредставляет историю сеанса, связанную с экземпляромWebEngine. Единственный экземплярWebHistoryдля конкретного движка веб-браузера можно получить с помощью методаWebEngine.getHistory(). История по сути представляет собой список записей. Каждая запись отображает посещённую страницу и предоставляет доступ к соответствующей информации о странице, такой как URL, заголовок и дата последнего посещения. Записи в списке упорядочены в порядке посещения страниц с самой старой до самой новой. Список можно получить с помощью методаgetEntries(). История и соответствующий список записей изменяются по мере навигацииWebEngineпо сети. Список может расширяться или уменьшаться в зависимости от действий браузера. Эти изменения можно отслеживать с помощью APIObservableList, которое поддерживает список. Индекс записи истории, связанной с текущей посещаемой страницей, представлен свойствомcurrentIndexProperty(). Текущий индекс можно использовать для перехода к любой записи в истории, используя методgo(int). СвойствоmaxSizeProperty()устанавливает максимальный размер истории, который равен размеру списка истории.- Since:
- JavaFX 2.2
-
Краткое описание свойств
Свойства Тип Свойство Описание ReadOnlyIntegerPropertycurrentIndexОпределяет индекс текущейEntryв истории.IntegerPropertymaxSizeОпределяет максимальный размер списка истории.
-
Краткое описание вложенных классов
Вложенные классы Модификатор и тип Класс Описание classWebHistory.EntryКлассEntryпредставляет отдельную запись в истории сеанса.
-
Краткое описание методов
Все методыМетоды экземпляровКонкретные методы Модификатор и тип Метод Описание ReadOnlyIntegerPropertycurrentIndexProperty()Определяет индекс текущейEntryв истории.intgetCurrentIndex()Возвращает значение свойства currentIndex.ObservableList<WebHistory.Entry>getEntries()Возвращает неизменяемый список всех записей в истории.intgetMaxSize()Возвращает значение свойства maxSize.voidgo(int offset)Перенаправляет движок веб-браузера на URL, определённый объектомEntry, в указанной позиции относительно текущей записи.IntegerPropertymaxSizeProperty()Определяет максимальный размер списка истории.voidsetMaxSize(int value)Устанавливает значение свойства maxSize.
-
Подробное описание свойств
-
currentIndex
public ReadOnlyIntegerProperty currentIndexProperty
Определяет индекс текущейEntryв истории. Текущая запись — это запись, связанная с текущей загруженной страницей. Индекс принадлежит диапазону(index >= 0 && index < getEntries().size()).- См. также:
getCurrentIndex()
-
maxSize
public IntegerProperty maxSizeProperty
Определяет максимальный размер списка истории. Если список достигает максимального размера, и добавляется новая запись, первая запись удаляется из истории.Указанное значение для этого свойства не может быть отрицательным, в противном случае выбрасывается
IllegalArgumentException.- Значение по умолчанию:
- 100
- См. также:
-
getMaxSize(),setMaxSize(int)
-
-
Подробное описание методов
-
currentIndexProperty
public ReadOnlyIntegerProperty currentIndexProperty()
Определяет индекс текущейEntryв истории. Текущая запись — это запись, связанная с текущей загруженной страницей. Индекс принадлежит диапазону(index >= 0 && index < getEntries().size()).- См. также:
getCurrentIndex()
-
getCurrentIndex
public int getCurrentIndex()
Получает значение свойства currentIndex.- Описание свойства:
- Определяет индекс текущей
Entryв истории. Текущая запись — это запись, связанная с текущей загруженной страницей. Индекс принадлежит диапазону(index >= 0 && index < getEntries().size()).
-
maxSizeProperty
public IntegerProperty maxSizeProperty()
Определяет максимальный размер списка истории. Если список достигает максимального размера, и добавляется новая запись, первая запись удаляется из истории.Указанное значение для этого свойства не может быть отрицательным, в противном случае выбрасывается
IllegalArgumentException.- Значение по умолчанию:
- 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..размер-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.