Module  javafx.web
软件包  javafx.scene.web

Class WebHistory


  • public final class WebHistory
extends Object
    WebHistory类代表与WebEngine实例相关联的会话历史。 的单个实例WebHistory用于特定Web引擎可以通过获得WebEngine.getHistory()方法。 历史基本上是条目列表。 每个条目表示访问页面，它提供对相关页面信息的访问，例如URL，标题以及页面上次访问的日期。 列表中的条目按照从最早到最晚访问相应页面的顺序排列。 该列表可以通过使用getEntries()方法获得。 历史记录和相应的条目列表将以WebEngine进行网络浏览。 根据浏览器操作，该列表可能会扩展或缩小。 这些更改可以由列表公开的ObservableList API来监听。 与当前访问页面相关联的历史记录条目的索引由currentIndexProperty()表示。 当前索引可用于使用go(int)方法导航到历史记录中的任何条目。 maxSizeProperty()设置最大历史记录大小，即历史列表的大小。
    从以下版本开始：
    JavaFX 2.2

    • Property Detail

      • currentIndex

        public ReadOnlyIntegerProperty currentIndexProperty
        定义历史上当前Entry的指数。 当前条目是与当前加载的页面相关联的条目。 该索引属于(index >= 0 && index < getEntries().size())的范围。
        另请参见：
        getCurrentIndex()

      • maxSize

        public IntegerProperty maxSizeProperty
        定义历史记录列表的最大大小。 如果列表达到其最大值并添加了新条目，则第一个条目将从历史记录中删除。

        为此属性指定的值不能为负值，否则抛出IllegalArgumentException 。

        Default value:
        100
        另请参见：
        getMaxSize() ， setMaxSize(int)

    • 方法详细信息

      • currentIndexProperty

        public ReadOnlyIntegerProperty currentIndexProperty​()
        定义历史上当前Entry的指数。 当前条目是与当前加载的页面相关联的条目。 该指数属于(index >= 0 && index < getEntries().size())的范围。
        另请参见：
        getCurrentIndex()

      • getCurrentIndex

        public int getCurrentIndex​()
        获取属性currentIndex的值。
        Property description:
        定义历史上当前Entry的指数。 当前条目是与当前加载的页面相关联的条目。 该指数属于(index >= 0 && index < getEntries().size())的范围。

      • maxSizeProperty

        public IntegerProperty maxSizeProperty​()
        定义历史记录列表的最大大小。 如果列表达到其最大值并添加了新条目，则第一个条目将从历史记录中删除。

        为此属性指定的值不能为负值，否则抛出IllegalArgumentException 。

        Default value:
        100
        另请参见：
        getMaxSize() ， setMaxSize(int)

      • setMaxSize

        public void setMaxSize​(int value)
        设置属性maxSize的值。
        Property description:
        定义历史记录列表的最大大小。 如果列表达到其最大值并添加了新条目，则第一个条目将从历史记录中删除。

        为此属性指定的值不能为负值，否则抛出IllegalArgumentException 。

        Default value:
        100

      • getMaxSize

        public int getMaxSize​()
        获取属性maxSize的值。
        Property description:
        定义历史记录列表的最大大小。 如果列表达到其最大值并添加了新条目，则第一个条目将从历史记录中删除。

        为此属性指定的值不能为负值，否则抛出IllegalArgumentException 。

        Default value:
        100

      • getEntries

        public ObservableList<WebHistory.Entry> getEntries​()
        返回历史记录中所有条目的不可修改的可观察列表。
        结果
        所有历史记录列表

      • go

        public void go​(int offset)
        throws IndexOutOfBoundsException
        将Web引擎导航到Entry对象在相对于当前条目的指定位置中定义的URL。 负offset值指定当前条目之前的位置，正值offset值指定当前条目之后的位置。 例如，-1分到前一个条目，1分到下一个条目，分别对应于按下网页浏览器的“后退”和“转发”按钮。 零offset值被默认忽略（no-op）。 有效入场点应属于[0..size-1]的愤怒。 否则，抛出IndexOutOfBoundsException 。
        参数
        offset - 负值指定当前条目之前的位置，正值指定当前条目后的位置，零值不起作用
        异常
        IndexOutOfBoundsException - 如果有效进入位置超出范围