Класс JTree

@JavaBean(defaultProperty="UI",
          description="A component that displays a set of hierarchical data as an outline.")
public class JTree
extends JComponent
implements Scrollable, Accessible

Управляющий элемент, отображающий набор иерархических данных в виде очерка. Вы можете найти документацию и примеры использования деревьев в Как использовать деревья в учебнике по Java.

Конкретный узел в дереве может быть идентифицирован либо по TreePath (объект, инкапсулирующий узел и всех его предков), либо по строке отображения, где каждая строка в области отображения отображает один узел. Расширенный узел — это нелистовой узел (как определено TreeModel.isLeaf(node) возвращающим false), который отображает своих потомков, когда все его предки являются расширенными. Сжатый узел скрывает потомков. Скрытый узел находится под сжатым предком. Все видимые узлы имеют расширенных родителей, но могут или не могут быть отображены. Отображенный узел является как видимым, так и в области отображения, где его можно увидеть.

Следующие JTree методы используют "видимый" в значении "отображенный":

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

Следующая группа JTree методов использует "видимый" в значении "видимый" (под расширенным родителем):

• 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.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4, поддержка долговременного хранения всех JavaBeans™ была добавлена в пакет java.beans. См. XMLEncoder.