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 - 如果有效进入位置超出范围