Module  java.desktop
软件包  javax.swing.event

Class TreeSelectionEvent

  • All Implemented Interfaces:
    Serializable 

    public class TreeSelectionEvent
extends EventObject
    表示当前选择的变化的事件。 更改基于任意数量的路径。 TreeSelectionListeners通常将查询每个潜在更改行的新选定状态的事件源。

    警告：此类的序列化对象与将来的Swing版本不兼容。 当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。 从1.4版本开始，所有JavaBeans的长期存储支持已被添加到java.beans软件包中。 请参阅XMLEncoder 。

    另请参见：
    TreeSelectionListener ， TreeSelectionModel ， Serialized Form

    • 字段详细信息

      • paths

        protected TreePath[] paths
        此事件代表的路径。

      • areNew

        protected boolean[] areNew
        对于每个路径，标识该路径实际上是新的。

      • oldLeadSelectionPath

        protected TreePath oldLeadSelectionPath
        leadSelectionPath在路径更改之前，可能为null。

      • newLeadSelectionPath

        protected TreePath newLeadSelectionPath
        leadSelectionPath在路径更改后可能为null。

    • 构造方法详细信息

      • TreeSelectionEvent

        public TreeSelectionEvent​(Object source,
                          TreePath[] paths,
                          boolean[] areNew,
                          TreePath oldLeadSelectionPath,
                          TreePath newLeadSelectionPath)
        代表TreeSelectionModel的选择的TreeSelectionModel 。 paths标识已从选择中添加或删除的路径。
        参数
        source - 事件来源
        paths - 选择中已更改的路径
        areNew - 一个 boolean数组，指示 paths中的路径是否为新的选择
        oldLeadSelectionPath - 之前的选择路径
        newLeadSelectionPath - 新的引线选择路径

      • TreeSelectionEvent

        public TreeSelectionEvent​(Object source,
                          TreePath path,
                          boolean isNew,
                          TreePath oldLeadSelectionPath,
                          TreePath newLeadSelectionPath)
        代表一个更改TreeSelectionModel的选择。 path标识已从选择中添加或删除的路径。
        参数
        source - 事件的来源
        path - 选择中已更改的路径
        isNew - 路径是否为选择的新路径，false表示从选择中删除路径。
        oldLeadSelectionPath - 先前的选择路径
        新的引线选择路径 newLeadSelectionPath

    • 方法详细信息

      • getPaths

        public TreePath[] getPaths​()
        返回从选择中添加或删除的路径。
        结果
        该事件的 TreePath对象的数组的副本。

      • getPath

        public TreePath getPath​()
        返回第一个路径元素。
        结果
        这个事件代表的第一个 TreePath元素

      • isAddedPath

        public boolean isAddedPath​()
        返回getPath标识的路径是否添加到选择。 的返回值true表示由标识的路径getPath加入到该选择。 返回值为false表示已选择getPath ，但不再选择。
        结果
        true如果 getPath被添加到选择， false否则

      • isAddedPath

        public boolean isAddedPath​(TreePath path)
        返回指定的路径是否添加到选择。 返回值为true表示通过path标识的路径被添加到选择中。 返回值为false表示不再选择path 。 此方法仅适用于从getPaths()返回的路径; 调用一个未包含的路径getPaths()抛出一个IllegalArgumentException 。
        参数
        path - 测试的路径
        结果
        true如果 path被添加到选择，否则为 false
        异常
        IllegalArgumentException - 如果 path不包含在 getPaths
        另请参见：
        getPaths()

      • isAddedPath

        public boolean isAddedPath​(int index)
        返回是否将getPaths()[index]的路径添加到选择。 返回值为true表示添加到选择的路径。 返回值为false表示不再选择路径。
        参数
        index - 测试路径的索引
        结果
        true如果路径被添加到选择，否则为 false
        异常
        IllegalArgumentException - 如果索引超出范围 getPaths
        从以下版本开始：
        1.3
        另请参见：
        getPaths()

      • getOldLeadSelectionPath

        public TreePath getOldLeadSelectionPath​()
        返回先前是引导路径的路径。
        结果
        一个 TreePath包含旧的选择路径

      • getNewLeadSelectionPath

        public TreePath getNewLeadSelectionPath​()
        返回当前引导路径。
        结果
        一个包含新的引线选择路径的 TreePath

      • cloneWithSource

        public Object cloneWithSource​(Object newSource)
        返回接收者的副本，但源代码是newSource。
        参数
        newSource - 事件的来源
        结果
        一个 Object是这个事件的副本，其中源是提供的 newSource