javax.swing
类 JTree

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JTree

所有已实现的接口：

ImageObserver, MenuContainer, Serializable, Accessible, Scrollable

public class JTree
     

      extends 
      JComponent
     
     

      implements 
      Scrollable, 
      Accessible
     

将分层数据集显示为轮廓的控件。有关面向任务的文档和使用树的示例，请参阅 The Java Tutorial 中的 How to Use Trees 一节。

树中特定的节点可以由 TreePath（封装节点及其所有祖先的对象）标识，或由其显示行（其中显示区域中的每一行都显示一个节点）标识。展开 节点是一个非叶节点（由返回 false 的 TreeModel.isLeaf(node) 标识），当展开 其所有祖先时，该节点将显示其子节点。折叠 节点是隐藏它们的节点。隐藏 节点是位于折叠祖先下面的节点。所有可查看 节点的父节点都是可以展开的，但是可以显示它们，也可以不显示它们。显示 节点是可查看的并且位于可以看到它的显示区域。

以下 JTree 方法使用 "visible" 来表示 "displayed"：

• isRootVisible()
• setRootVisible()
• scrollPathToVisible()
• scrollRowToVisible()
• getVisibleRowCount()
• setVisibleRowCount()

下一组 JTree 方法使用 "visible" 表示 "viewable"（在展开的父节点下面）：

• isVisible()
• makeVisible()

如果您有兴趣了解选择何时更改，请实现 TreeSelectionListener 接口，并使用方法 addTreeSelectionListener 添加实例。当选择更改时，将调用 valueChanged，即如果用户在同一节点上单击两次，则仅调用 valueChanged 一次。

如果有兴趣检测双击事件或用户何时单击节点（不管是否选中它），建议您执行以下操作：

 final JTree tree = ...;

 MouseListener ml = new MouseAdapter() {
     public void mousePressed(MouseEvent e) {
         int selRow = tree.getRowForLocation(e.getX(), e.getY());
         TreePath selPath = tree.getPathForLocation(e.getX(), e.getY());
         if(selRow != -1) {
             if(e.getClickCount() == 1) {
                 mySingleClick(selRow, selPath);
             }
             else if(e.getClickCount() == 2) {
                 myDoubleClick(selRow, selPath);
             }
         }
     }
 };
 tree.addMouseListener(ml);
 

要使用 JTree 显示复合节点（例如，同时包含图形图标和文本的节点），请为 TreeCellRenderer 创建子类，并使用 setCellRenderer(javax.swing.tree.TreeCellRenderer) 通知树使用它。要编辑此类节点，请为 TreeCellEditor 创建子类，并使用 setCellEditor(javax.swing.tree.TreeCellEditor)。

与所有 JComponent 类一样，可以使用 InputMap 和 ActionMap 将 Action 对象与 KeyStroke 关联，并在指定条件下执行操作。

警告：Swing 不是线程安全的。有关更多信息，请参阅　Swing's Threading Policy。

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。