Module java.desktop
Package javax.swing.event

Class TreeSelectionEvent

java.lang.Object
java.util.EventObject
javax.swing.event.TreeSelectionEvent
所有已实现的接口:
Serializable
public class TreeSelectionEvent extends EventObject
表示当前选择发生变化的事件。该变化基于任意数量的路径。TreeSelectionListeners通常会查询事件源，以获取每个可能更改的行的新选择状态。

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

参见:

  • Field Details

    • paths

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

    • areNew

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

    • oldLeadSelectionPath

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

    • newLeadSelectionPath

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

  • Constructor Details

    • TreeSelectionEvent

      public TreeSelectionEvent(Object source, TreePath[] paths, boolean[] areNew, TreePath oldLeadSelectionPath, TreePath newLeadSelectionPath)
      表示TreeSelectionModel选择发生变化。 paths标识已添加或从选择中移除的路径。
      参数:
      source - 事件源
      paths - 在选择中发生更改的路径
      areNew - 一个boolean数组，指示paths中的路径是否是选择中的新路径
      oldLeadSelectionPath - 先前的lead选择路径
      newLeadSelectionPath - 新的lead选择路径

    • TreeSelectionEvent

      public TreeSelectionEvent(Object source, TreePath path, boolean isNew, TreePath oldLeadSelectionPath, TreePath newLeadSelectionPath)
      表示TreeSelectionModel选择发生变化。 path标识已添加或从选择中移除的路径。
      参数:
      source - 事件源
      path - 在选择中发生更改的路径
      isNew - 路径是否是选择中的新路径，false表示路径已从选择中移除
      oldLeadSelectionPath - 先前的lead选择路径
      newLeadSelectionPath - 新的lead选择路径

  • Method Details

    • getPaths

      public TreePath[] getPaths()
      返回已添加或从选择中移除的路径。
      返回:
      为此事件表示的TreePath对象数组的副本。

    • getPath

      public TreePath getPath()
      返回第一个路径元素。
      返回:
      由此事件表示的第一个TreePath元素

    • isAddedPath

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

    • isAddedPath

      public boolean isAddedPath(TreePath path)
      返回指定路径是否已添加到选择中。返回值为true表示由path指定的路径已添加到选择中。返回值为false表示path不再选择。此方法仅适用于从getPaths()返回的路径；对未包含在getPaths()中的路径调用会引发IllegalArgumentException。
      参数:
      path - 要测试的路径
      返回:
      如果path已添加到选择中，则为true，否则为false
      抛出:
      IllegalArgumentException - 如果path不包含在getPaths中
      参见:

    • isAddedPath

      public boolean isAddedPath(int index)
      返回指定路径是否已添加到选择中。返回值为true表示路径已添加到选择中。返回值为false表示路径不再选择。
      参数:
      index - 要测试的路径的索引
      返回:
      如果路径已添加到选择中，则为true，否则为false
      抛出:
      IllegalArgumentException - 如果索引超出getPaths的范围
      自:
      1.3
      参见:

    • getOldLeadSelectionPath

      public TreePath getOldLeadSelectionPath()
      返回先前的lead路径。
      返回:
      包含旧lead选择路径的TreePath

    • getNewLeadSelectionPath

      public TreePath getNewLeadSelectionPath()
      返回当前lead路径。
      返回:
      包含新lead选择路径的TreePath

    • cloneWithSource

      public Object cloneWithSource(Object newSource)
      返回接收者的副本，但源是新的。
      参数:
      newSource - 事件源
      返回:
      一个Object，是具有提供的newSource作为源的此事件的副本