Spec-Zone .ru
спецификации, руководства, описания, API
|
public class JTree extends JComponent implements Scrollable, Accessible
Определенный узел в дереве может быть идентифицирован любой a 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
объект с a KeyStroke
и выполните действие при указанных условиях.
Предупреждение: Swing не ориентирован на многопотоковое исполнение. Для получения дополнительной информации см., что Swing Распараллеливает Политику.
Предупреждение: Сериализированные объекты этого class не будут совместимыми с будущими выпусками Swing. Текущая поддержка сериализации является подходящей для краткосрочного хранения или RMI между приложениями, выполняющими ту же самую версию Swing. С 1.4, поддержка длительного хранения всего JavaBeansTM была добавлена к java.beans
пакет. Пожалуйста, см. XMLEncoder
.
Модификатор и Тип | Класс и Описание |
---|---|
protected class |
JTree. AccessibleJTree
Этот class реализует поддержку доступности
JTree class. |
static class |
JTree. DropLocation
Подкласс
TransferHandler.DropLocation представление расположения отбрасывания для a JTree . |
static class |
JTree. DynamicUtilTreeNode
DynamicUtilTreeNode может обернуть векторы/хеш-таблицы/массивы/строки и создать соответствующие дочерние узлы дерева по мере необходимости. |
protected static class |
JTree. EmptySelectionModel
EmptySelectionModel a TreeSelectionModel это не позволяет ничему быть выбранным. |
protected class |
JTree. TreeModelHandler
Слушает модель и обновляет
expandedState соответственно, когда узлы удаляются, или изменяются. |
protected class |
JTree. TreeSelectionRedirector
Дескрипторы, создающие новое
TreeSelectionEvent с JTree как источник и выдавание этого всем слушателям. |
JComponent. AccessibleJComponent
Контейнер. AccessibleAWTContainer
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Модификатор и Тип | Поле и Описание |
---|---|
static String |
ANCHOR_SELECTION_PATH_PROPERTY
Связанное имя свойства для пути выбора привязки.
|
static String |
CELL_EDITOR_PROPERTY
Связанное имя свойства для
cellEditor . |
static String |
CELL_RENDERER_PROPERTY
Связанное имя свойства для
cellRenderer . |
protected TreeCellEditor |
cellEditor
Редактор для записей.
|
protected TreeCellRenderer |
cellRenderer
Ячейка, используемая, чтобы потянуть узлы.
|
protected boolean |
доступный для редактирования
Действительно ли дерево доступно для редактирования? Значение по умолчанию является ложью.
|
static String |
EDITABLE_PROPERTY
Связанное имя свойства для
editable . |
static String |
EXPANDS_SELECTED_PATHS_PROPERTY
Связанное имя свойства для разворачивает выбранное свойство путей
|
static String |
INVOKES_STOP_CELL_EDITING_PROPERTY
Связанное имя свойства для
messagesStopCellEditing . |
protected boolean |
invokesStopCellEditing
Если это правда, когда редактирование должно быть остановлено посредством изменения выбора, данных в древовидном изменении или других средствах
stopCellEditing вызывается, и изменения сохраняются. |
static String |
LARGE_MODEL_PROPERTY
Связанное имя свойства для
largeModel . |
protected boolean |
largeModel
Действительно ли это - дерево большая модель? Это - установка оптимизации кода.
|
static String |
LEAD_SELECTION_PATH_PROPERTY
Связанное имя свойства для
leadSelectionPath . |
static String |
ROOT_VISIBLE_PROPERTY
Связанное имя свойства для
rootVisible . |
protected boolean |
rootVisible
Истина, если корневой узел выводится на экран, ложь, если ее дочерние элементы являются самыми высокими видимыми узлами.
|
static String |
ROW_HEIGHT_PROPERTY
Связанное имя свойства для
rowHeight . |
protected int |
rowHeight
Высота, чтобы использовать для каждой строки дисплея.
|
static String |
SCROLLS_ON_EXPAND_PROPERTY
Связанное имя свойства для
scrollsOnExpand . |
protected boolean |
scrollsOnExpand
Если это правда, когда узел расширяется, так многие из потомков прокручиваются, чтобы быть видимыми.
|
static String |
SELECTION_MODEL_PROPERTY
Связанное имя свойства для selectionModel.
|
protected TreeSelectionModel |
selectionModel
Моделирует набор выбранных узлов в этом дереве.
|
protected JTree.TreeSelectionRedirector |
selectionRedirector
Создает новое событие и выдавал это
selectionListeners . |
static String |
SHOWS_ROOT_HANDLES_PROPERTY
Связанное имя свойства для
showsRootHandles . |
protected boolean |
showsRootHandles
Истина, если дескрипторы выводятся на экран на самом верхнем уровне дерева.
|
static String |
TOGGLE_CLICK_COUNT_PROPERTY
Связанное имя свойства для
toggleClickCount . |
protected int |
toggleClickCount
Число щелчков мышью перед узлом расширяется.
|
static String |
TREE_MODEL_PROPERTY
Связанное имя свойства для
treeModel . |
protected TreeModel |
treeModel
Модель, которая определяет дерево, выведенное на экран этим объектом.
|
protected TreeModelListener |
treeModelListener
Обновления
expandedState . |
static String |
VISIBLE_ROW_COUNT_PROPERTY
Связанное имя свойства для
visibleRowCount . |
protected int |
visibleRowCount
Число строк, чтобы сделать видимый когда-то.
|
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Конструктор и Описание |
---|
JTree()
Возвраты a
JTree с демонстрационной моделью. |
JTree(Hashtable<?,?> value)
Возвраты a
JTree создаваемый из a Hashtable который не выводит на экран с корнем. |
JTree(Object[] value)
Возвраты a
JTree с каждым элементом указанного массива как дочерний элемент нового корневого узла, который не выводится на экран. |
JTree(TreeModel newModel)
Возвращает экземпляр
JTree который выводит на экран корневой узел - дерево создается, используя указанную модель данных. |
JTree(TreeNode root)
Возвраты a
JTree с указанным TreeNode как его корень, который выводит на экран корневой узел. |
JTree(TreeNode root, boolean asksAllowsChildren)
Возвраты a
JTree с указанным TreeNode как его корень, который выводит на экран корневой узел и который решает, является ли узел вершиной указанным способом. |
JTree(Vector<?> value)
Возвраты a
JTree с каждым элементом указанного Vector как дочерний элемент нового корневого узла, который не выводится на экран. |
Модификатор и Тип | Метод и Описание |
---|---|
void |
addSelectionInterval(int index0, int index1)
Добавляют указанные строки (включительно) к выбору.
|
void |
addSelectionPath(TreePath path)
Добавляет узел, идентифицированный указанным
TreePath к текущему выбору. |
void |
addSelectionPaths(TreePath[] paths)
Добавляет каждый путь в массиве путей к текущему выбору.
|
void |
addSelectionRow(int row)
Добавляет путь в указанной строке к текущему выбору.
|
void |
addSelectionRows(int[] rows)
Добавляют пути в каждой из указанных строк к текущему выбору.
|
void |
addTreeExpansionListener(TreeExpansionListener tel)
Добавляет слушатель для
TreeExpansion события. |
void |
addTreeSelectionListener(TreeSelectionListener tsl)
Добавляет слушатель для
TreeSelection события. |
void |
addTreeWillExpandListener(TreeWillExpandListener tel)
Добавляет слушатель для
TreeWillExpand события. |
void |
cancelEditing()
Отменяет текущий сеанс редактирования.
|
void |
clearSelection()
Очищает выбор.
|
protected void |
clearToggledPaths()
Очищает кэш переключенных древовидных путей.
|
void |
collapsePath(TreePath path)
Гарантирует, что узел, идентифицированный указанным путем, сворачивается и просматриваемый.
|
void |
collapseRow(int row)
Гарантирует, что узел в указанной строке сворачивается.
|
Строка |
convertValueToText(Object value, boolean selected, boolean expanded, boolean leaf, int row, boolean hasFocus)
Вызванный средствами рендеринга, чтобы преобразовать указанное значение в текст.
|
protected static TreeModel |
createTreeModel(Object value)
Возвраты a
TreeModel обертывание указанного объекта. |
protected TreeModelListener |
createTreeModelListener()
Создает и возвращает экземпляр
TreeModelHandler . |
void |
expandPath(TreePath path)
Гарантирует, что узел, идентифицированный указанным путем, расширяется и просматриваемый.
|
void |
expandRow(int row)
Гарантирует, что узел в указанной строке расширяется и просматриваемый.
|
void |
fireTreeCollapsed(TreePath path)
Уведомляет всех слушателей, которые зарегистрировали интерес для уведомления на этом типе события.
|
void |
fireTreeExpanded(TreePath path)
Уведомляет всех слушателей, которые зарегистрировали интерес для уведомления на этом типе события.
|
void |
fireTreeWillCollapse(TreePath path)
Уведомляет всех слушателей, которые зарегистрировали интерес для уведомления на этом типе события.
|
void |
fireTreeWillExpand(TreePath path)
Уведомляет всех слушателей, которые зарегистрировали интерес для уведомления на этом типе события.
|
protected void |
fireValueChanged(TreeSelectionEvent e)
Уведомляет всех слушателей, которые зарегистрировали интерес для уведомления на этом типе события.
|
AccessibleContext |
getAccessibleContext()
Связали AccessibleContext с этим JTree.
|
TreePath |
getAnchorSelectionPath()
Возвращает путь, идентифицированный как привязка.
|
TreeCellEditor |
getCellEditor()
Возвращает редактора, используемого, чтобы отредактировать записи в дереве.
|
TreeCellRenderer |
getCellRenderer()
Возвращает ток
TreeCellRenderer это представляет каждую ячейку. |
TreePath |
getClosestPathForLocation(int x, int y)
Возвращает путь к узлу, который является самым близким к x, y.
|
int |
getClosestRowForLocation(int x, int y)
Возвращает строку узлу, который является самым близким к x, y.
|
protected static TreeModel |
getDefaultTreeModel()
Создает и возвращает выборку
TreeModel . |
protected Enumeration<TreePath> |
getDescendantToggledPaths(TreePath parent)
Возвраты
Enumeration из TreePaths это было расширено, которые потомки parent . |
boolean |
getDragEnabled()
Включаются возвраты, перетаскивают ли автоматический обработку.
|
JTree. DropLocation |
getDropLocation()
Возвращает расположение, на которое этот компонент должен визуально указать как расположение отбрасывания во время работы DnD по компоненту, или
null если никакое расположение нельзя в настоящий момент показать. |
DropMode |
getDropMode()
Возвращает режим отбрасывания для этого компонента.
|
TreePath |
getEditingPath()
Возвращает путь к элементу, который в настоящий момент редактируется.
|
Enumeration<TreePath> |
getExpandedDescendants(TreePath parent)
Возвраты
Enumeration из потомков пути parent это в настоящий момент расширяется. |
boolean |
getExpandsSelectedPaths()
Возвраты
expandsSelectedPaths свойство. |
boolean |
getInvokesStopCellEditing()
Возвращает индикатор, который говорит то, что происходит, когда редактирование прерывается.
|
Объект |
getLastSelectedPathComponent()
Возвращает последний компонент пути выбранного пути.
|
TreePath |
getLeadSelectionPath()
Возвращает путь, идентифицированный как вывод.
|
int |
getLeadSelectionRow()
Возвращается строка индексируют соответствие ведущему пути.
|
int |
getMaxSelectionRow()
Возвращает самую большую выбранную строку.
|
int |
getMinSelectionRow()
Возвращает самую маленькую выбранную строку.
|
TreeModel |
getModel()
Возвраты
TreeModel это обеспечивает данные. |
TreePath |
getNextMatch(String prefix, int startingRow, Position.Bias bias)
Возвращает TreePath следующему древовидному элементу, который начинается с префикса.
|
protected TreePath[] |
getPathBetweenRows(int index0, int index1)
Возвращает пути (включительно) между указанными строками.
|
Прямоугольник |
getPathBounds(TreePath path)
Возвраты
Rectangle то, что указанный узел будет вовлечен. |
TreePath |
getPathForLocation(int x, int y)
Возвращает путь для узла в указанном расположении.
|
TreePath |
getPathForRow(int row)
Возвращает путь для указанной строки.
|
Размерность |
getPreferredScrollableViewportSize()
Возвращает привилегированный размер дисплея a
JTree . |
Прямоугольник |
getRowBounds(int row)
Возвраты
Rectangle то, что узел в указанной строке оттягивается в. |
int |
getRowCount()
Возвращает число просматриваемых узлов.
|
int |
getRowForLocation(int x, int y)
Возвращает строку для указанного расположения.
|
int |
getRowForPath(TreePath path)
Возвращает строку, которая выводит на экран узел, идентифицированный указанным путем.
|
int |
getRowHeight()
Возвращает height каждой строки.
|
int |
getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
Возвращает количество для блочного инкремента, который является height или width
visibleRect , основанный на orientation . |
boolean |
getScrollableTracksViewportHeight()
Возвращает false, чтобы указать, что height области просмотра не определяет height таблицы, если привилегированный height дерева не меньше чем области просмотра height.
|
boolean |
getScrollableTracksViewportWidth()
Возвращает false, чтобы указать, что width области просмотра не определяет width таблицы, если привилегированный width дерева не меньше чем области просмотра width.
|
int |
getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
Возвращает количество, чтобы постепенно увеличиться, прокручивая.
|
boolean |
getScrollsOnExpand()
Возвращает значение
scrollsOnExpand свойство. |
int |
getSelectionCount()
Возвращает число выбранных узлов.
|
TreeSelectionModel |
getSelectionModel()
Возвращает модель для выборов.
|
TreePath |
getSelectionPath()
Возвращает путь к первому выбранному узлу.
|
TreePath[] |
getSelectionPaths()
Возвращает пути всех выбранных значений.
|
int[] |
getSelectionRows()
Возвраты все в настоящий момент выбранные строки.
|
boolean |
getShowsRootHandles()
Возвращает значение
showsRootHandles свойство. |
int |
getToggleClickCount()
Возвращается число щелчков мышью должно было развернуть или закрыть узел.
|
Строка |
getToolTipText(MouseEvent event)
Переопределения
JComponent 's getToolTipText метод, чтобы позволить подсказкам средства рендеринга использоваться, если ему установили текст. |
TreeExpansionListener[] |
getTreeExpansionListeners()
Возвращает массив весь
TreeExpansionListener s добавленный к этому JTree с addTreeExpansionListener (). |
TreeSelectionListener[] |
getTreeSelectionListeners()
Возвращает массив весь
TreeSelectionListener s добавленный к этому JTree с addTreeSelectionListener (). |
TreeWillExpandListener[] |
getTreeWillExpandListeners()
Возвращает массив весь
TreeWillExpandListener s добавленный к этому JTree с addTreeWillExpandListener (). |
TreeUI |
getUI()
Возвращается L&F объект, который представляет этот компонент.
|
Строка |
getUIClassID()
Возвращает имя L&F class, который представляет этот компонент.
|
int |
getVisibleRowCount()
Возвращает число строк, которые выводятся на экран в области дисплея.
|
boolean |
hasBeenExpanded(TreePath path)
Возвращает true, если узел, идентифицированный путем, когда-либо расширялся.
|
boolean |
isCollapsed(int row)
Возвращает true, если узел в указанной строке дисплея сворачивается.
|
boolean |
isCollapsed(TreePath path)
Возвращает true, если значение, идентифицированное путем, будет в настоящий момент свернуто, то это возвратит false, если какое-либо из значений в пути не будет в настоящий момент выведено на экран.
|
boolean |
isEditable()
Возвращает true, если дерево доступно для редактирования.
|
boolean |
isEditing()
Возвращает true, если дерево редактируется.
|
boolean |
isExpanded(int row)
Возвращает true, если узел в указанной строке дисплея в настоящий момент расширяется.
|
boolean |
isExpanded(TreePath path)
Возвращает true, если узел, идентифицированный путем, в настоящий момент расширяется,
|
boolean |
isFixedRowHeight()
Возвращает true, если height каждой строки дисплея является фиксированным размером.
|
boolean |
isLargeModel()
Возвращает true, если дерево конфигурируется для большой модели.
|
boolean |
isPathEditable(TreePath path)
Возвраты
isEditable . |
boolean |
isPathSelected(TreePath path)
Возвращает true, если элемент, идентифицированный путем, в настоящий момент выбирается.
|
boolean |
isRootVisible()
Возвращает true, если корневой узел дерева выводится на экран.
|
boolean |
isRowSelected(int row)
Возвращает true, если узел, идентифицированный строкой, выбирается.
|
boolean |
isSelectionEmpty()
Возвращает true, если выбор в настоящий момент пуст.
|
boolean |
isVisible(TreePath path)
Возвращает true, если значение, идентифицированное путем, является в настоящий момент просматриваемым, что означает, что это - или корень или все его родители, расширяются.
|
void |
makeVisible(TreePath path)
Гарантирует, что узел, идентифицированный путем, является в настоящий момент просматриваемым.
|
protected String |
paramString()
Возвращает строковое представление этого
JTree . |
protected boolean |
removeDescendantSelectedPaths(TreePath path, boolean includePath)
Удаляет любые пути в выборе, которые являются потомками
path . |
protected void |
removeDescendantToggledPaths(Enumeration<TreePath> toRemove)
Удаляет любых потомков
TreePaths в toRemove это было расширено. |
void |
removeSelectionInterval(int index0, int index1)
Удаляет указанные строки (включительно) из выбора.
|
void |
removeSelectionPath(TreePath path)
Удаляет узел, идентифицированный указанным путем от текущего выбора.
|
void |
removeSelectionPaths(TreePath[] paths)
Удаляет узлы, идентифицированные указанными путями от текущего выбора.
|
void |
removeSelectionRow(int row)
Удаляет строку при индексировании
row от текущего выбора. |
void |
removeSelectionRows(int[] rows)
Удаляет строки, которые выбираются в каждой из указанных строк.
|
void |
removeTreeExpansionListener(TreeExpansionListener tel)
Удаляет слушателя для
TreeExpansion события. |
void |
removeTreeSelectionListener(TreeSelectionListener tsl)
Удаляет a
TreeSelection слушатель. |
void |
removeTreeWillExpandListener(TreeWillExpandListener tel)
Удаляет слушателя для
TreeWillExpand события. |
void |
scrollPathToVisible(TreePath path)
Удостоверяется, что все компоненты пути в пути расширяются (за исключением последнего компонента пути) и прокрутки так, чтобы узел, идентифицированный путем, был выведен на экран.
|
void |
scrollRowToVisible(int row)
Прокручивает элемент, идентифицированный строкой, пока это не выводится на экран.
|
void |
setAnchorSelectionPath(TreePath newPath)
Устанавливает путь, идентифицированный как привязка.
|
void |
setCellEditor(TreeCellEditor cellEditor)
Устанавливает редактора ячейки.
|
void |
setCellRenderer(TreeCellRenderer x)
Наборы
TreeCellRenderer это будет использоваться, чтобы потянуть каждую ячейку. |
void |
setDragEnabled(boolean b)
Включает или выключает автоматический, перетаскивают обработку.
|
void |
setDropMode(DropMode dropMode)
Устанавливает режим отбрасывания для этого компонента.
|
void |
setEditable(boolean flag)
Определяет, доступно ли дерево для редактирования.
|
protected void |
setExpandedState(TreePath path, boolean state)
Устанавливает расширенное состояние этого
JTree . |
void |
setExpandsSelectedPaths(boolean newValue)
Конфигурирует
expandsSelectedPaths свойство. |
void |
setInvokesStopCellEditing(boolean newValue)
Определяет то, что происходит, когда редактирование прерывается, выбирая другой узел в дереве, изменение в данных дерева, или некоторыми другими средствами.
|
void |
setLargeModel(boolean newValue)
Определяет, должен ли UI использовать большую модель.
|
void |
setLeadSelectionPath(TreePath newPath)
Наборы путь идентифицируют как вывод.
|
void |
setModel(TreeModel newModel)
Наборы
TreeModel это обеспечит данные. |
void |
setRootVisible(boolean rootVisible)
Определяет действительно ли корневой узел от
TreeModel видимо. |
void |
setRowHeight(int rowHeight)
Устанавливает height каждой ячейки, в пикселях.
|
void |
setScrollsOnExpand(boolean newValue)
Наборы
scrollsOnExpand свойство, которое определяет, могло ли бы дерево прокрутить, чтобы показать ранее скрытым дочерним элементам. |
void |
setSelectionInterval(int index0, int index1)
Выбирает строки в указанном интервале (включительно).
|
void |
setSelectionModel(TreeSelectionModel selectionModel)
Устанавливает модель выбора дерева.
|
void |
setSelectionPath(TreePath path)
Выбирает узел, идентифицированный указанным путем.
|
void |
setSelectionPaths(TreePath[] paths)
Выбирает узлы, идентифицированные указанным массивом путей.
|
void |
setSelectionRow(int row)
Выбирает узел в указанной строке в дисплее.
|
void |
setSelectionRows(int[] rows)
Выбирает узлы, соответствующие каждой из указанных строк в дисплее.
|
void |
setShowsRootHandles(boolean newValue)
Устанавливает значение
showsRootHandles свойство, которое определяет, должны ли дескрипторы узла быть выведены на экран. |
void |
setToggleClickCount(int clickCount)
Определяет номер щелчков мышью прежде, чем узел расширится или закроется.
|
void |
setUI(TreeUI ui)
Устанавливает L&F объект, который представляет этот компонент.
|
void |
setVisibleRowCount(int newCount)
Определяет номер строк, которые должны быть выведены на экран.
|
void |
startEditingAtPath(TreePath path)
Выбирает узел, идентифицированный указанным путем и новичками, редактирующими.
|
boolean |
stopEditing()
Заканчивает текущий сеанс редактирования.
|
void |
treeDidChange()
Отправленный, когда дерево изменилось достаточно, что мы должны изменить размеры границ, но недостаточно что мы должны удалить расширенный набор узлов (например, узлы были расширены или свернуты, или узлы, были вставлены в дерево).
|
void |
updateUI()
Уведомление от
UIManager то, что L&F изменился. |
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
protected transient TreeModel treeModel
protected transient TreeSelectionModel selectionModel
protected boolean rootVisible
protected transient TreeCellRenderer cellRenderer
null
, UI использует значение по умолчанию cellRenderer
.protected int rowHeight
protected boolean showsRootHandles
Дескриптор является маленьким значком, который выводит на экран смежный с узлом, который позволяет пользователю щелкать однажды развернуть или свернуть узел. Общий интерфейс показывает знак "плюс" (+) для узла, который может быть расширен и знак "минус" (-) для узла, который может быть свернут. Дескрипторы всегда показывают для узлов ниже самого верхнего уровня.
Если rootVisible
установка определяет, что корневой узел должен быть выведен на экран, тогда это - единственный узел на самом верхнем уровне. Если корневой узел не выводится на экран, то все его дочерние элементы на самом верхнем уровне дерева. Дескрипторы всегда выводятся на экран для узлов кроме самого верхнего.
Если корневой узел не видим, это - обычно польза, чтобы сделать эту истину значения. Иначе, дерево точно походит на список, и пользователи, возможно, не знают, что "записи списка" являются фактически древовидными узлами.
rootVisible
protected transient JTree.TreeSelectionRedirector selectionRedirector
selectionListeners
.protected transient TreeCellEditor cellEditor
null
(дерево не доступно для редактирования).protected boolean editable
protected boolean largeModel
Это значение является только предложением к UI. Не весь UIs использует в своих интересах это. Значение по умолчанию является ложью.
protected int visibleRowCount
Scrollable
интерфейс. Это определяет привилегированный размер области дисплея.protected boolean invokesStopCellEditing
stopCellEditing
вызывается, и изменения сохраняются. Если ложь, cancelCellEditing
вызывается, и изменения отбрасываются. Значение по умолчанию является ложью.protected boolean scrollsOnExpand
protected int toggleClickCount
protected transient TreeModelListener treeModelListener
expandedState
.public static final String CELL_RENDERER_PROPERTY
cellRenderer
.public static final String TREE_MODEL_PROPERTY
treeModel
.public static final String ROOT_VISIBLE_PROPERTY
rootVisible
.public static final String SHOWS_ROOT_HANDLES_PROPERTY
showsRootHandles
.public static final String ROW_HEIGHT_PROPERTY
rowHeight
.public static final String CELL_EDITOR_PROPERTY
cellEditor
.public static final String EDITABLE_PROPERTY
editable
.public static final String LARGE_MODEL_PROPERTY
largeModel
.public static final String SELECTION_MODEL_PROPERTY
public static final String VISIBLE_ROW_COUNT_PROPERTY
visibleRowCount
.public static final String INVOKES_STOP_CELL_EDITING_PROPERTY
messagesStopCellEditing
.public static final String SCROLLS_ON_EXPAND_PROPERTY
scrollsOnExpand
.public static final String TOGGLE_CLICK_COUNT_PROPERTY
toggleClickCount
.public static final String LEAD_SELECTION_PATH_PROPERTY
leadSelectionPath
.public static final String ANCHOR_SELECTION_PATH_PROPERTY
public static final String EXPANDS_SELECTED_PATHS_PROPERTY
public JTree()
JTree
с демонстрационной моделью. Модель значения по умолчанию, используемая деревом, определяет вершину как любой узел без дочерних элементов.DefaultTreeModel.asksAllowsChildren
public JTree(Object[] value)
JTree
с каждым элементом указанного массива как дочерний элемент нового корневого узла, который не выводится на экран. По умолчанию дерево определяет вершину как любой узел без дочерних элементов.value
- массив Object
sDefaultTreeModel.asksAllowsChildren
public JTree(Vector<?> value)
JTree
с каждым элементом указанного Vector
как дочерний элемент нового корневого узла, который не выводится на экран. По умолчанию дерево определяет вершину как любой узел без дочерних элементов.value
- a Vector
DefaultTreeModel.asksAllowsChildren
public JTree(Hashtable<?,?> value)
JTree
создаваемый из a Hashtable
который не выводит на экран с корнем. Каждая половина значения пар ключ/значение в HashTable
становится дочерним элементом нового корневого узла. По умолчанию дерево определяет вершину как любой узел без дочерних элементов.value
- a Hashtable
DefaultTreeModel.asksAllowsChildren
public JTree(TreeNode root)
JTree
с указанным TreeNode
как его корень, который выводит на экран корневой узел. По умолчанию дерево определяет вершину как любой узел без дочерних элементов.root
- a TreeNode
объектDefaultTreeModel.asksAllowsChildren
public JTree(TreeNode root, boolean asksAllowsChildren)
JTree
с указанным TreeNode
как его корень, который выводит на экран корневой узел и который решает, является ли узел вершиной указанным способом.root
- a TreeNode
объектasksAllowsChildren
- если ложь, какой-либо узел без дочерних элементов является вершиной; если это правда, только узлы, которые не позволяют дочерним элементам, являются вершинамиDefaultTreeModel.asksAllowsChildren
@ConstructorProperties(value="model") public JTree(TreeModel newModel)
JTree
который выводит на экран корневой узел - дерево создается, используя указанную модель данных.newModel
- TreeModel
использовать в качестве модели данныхprotected static TreeModel getDefaultTreeModel()
TreeModel
. Используемый прежде всего для beanbuilders, чтобы показать что-то интересное.TreeModel
protected static TreeModel createTreeModel(Object value)
TreeModel
обертывание указанного объекта. Если объект:Object
s, Hashtable
, или Vector
"root"
.value
- Object
используемый в качестве основы для TreeModel
TreeModel
обертывание указанного объектаpublic TreeUI getUI()
TreeUI
объект, который представляет этот компонентpublic void setUI(TreeUI ui)
Это - связанное свойство.
ui
- TreeUI
L&F объектUIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
UIManager
то, что L&F изменился. Заменяет текущий объект UI последней версией от UIManager
.updateUI
в class JComponent
JComponent.updateUI()
public String getUIClassID()
getUIClassID
в class JComponent
JComponent.getUIClassID()
, UIDefaults.getUI(javax.swing.JComponent)
public TreeCellRenderer getCellRenderer()
TreeCellRenderer
это представляет каждую ячейку.TreeCellRenderer
это представляет каждую ячейкуpublic void setCellRenderer(TreeCellRenderer x)
TreeCellRenderer
это будет использоваться, чтобы потянуть каждую ячейку. Это - связанное свойство.
x
- TreeCellRenderer
это должно представить каждую ячейкуpublic void setEditable(boolean flag)
Это - связанное свойство.
flag
- булево значение, истина, если дерево доступно для редактированияpublic boolean isEditable()
public void setCellEditor(TreeCellEditor cellEditor)
null
значение подразумевает, что дерево не может быть отредактировано. Если это представляет изменение в cellEditor
, propertyChange
метод вызывается на всех слушателей. Это - связанное свойство.
cellEditor
- TreeCellEditor
использоватьpublic TreeCellEditor getCellEditor()
TreeCellEditor
в использовании, или null
если дерево не может быть отредактированоpublic TreeModel getModel()
TreeModel
это обеспечивает данные.TreeModel
это обеспечивает данныеpublic void setModel(TreeModel newModel)
TreeModel
это обеспечит данные. Это - связанное свойство.
newModel
- TreeModel
это должно обеспечить данныеpublic boolean isRootVisible()
rootVisible
public void setRootVisible(boolean rootVisible)
TreeModel
видимо. Это - связанное свойство.
rootVisible
- истина, если корневой узел дерева должен быть выведен на экранrootVisible
public void setShowsRootHandles(boolean newValue)
showsRootHandles
свойство, которое определяет, должны ли дескрипторы узла быть выведены на экран. Значение по умолчанию этого свойства зависит от конструктора, используемого, чтобы создать JTree
. Некоторый взгляд и чувства не могли бы поддерживать дескрипторы; они проигнорируют это свойство. Это - связанное свойство.
newValue
- true
если корневые дескрипторы должны быть выведены на экран; иначе, false
showsRootHandles
, getShowsRootHandles()
public boolean getShowsRootHandles()
showsRootHandles
свойство.showsRootHandles
свойствоshowsRootHandles
public void setRowHeight(int rowHeight)
Это - связанное свойство.
rowHeight
- height каждой ячейки, в пикселяхpublic int getRowHeight()
public boolean isFixedRowHeight()
public void setLargeModel(boolean newValue)
Это - связанное свойство.
newValue
- истина, чтобы предложить большую модель UIlargeModel
public boolean isLargeModel()
largeModel
public void setInvokesStopCellEditing(boolean newValue)
true
заставляет изменения быть автоматически сохраненными, когда редактирование прерывается. Запускает изменение свойства для INVOKES_STOP_CELL_EDITING_PROPERTY.
newValue
- истина означает это stopCellEditing
вызывается, когда редактирование прерывается, и данные сохраняются; ложь означает это cancelCellEditing
вызывается, и изменения теряютсяpublic boolean getInvokesStopCellEditing()
setInvokesStopCellEditing(boolean)
public void setScrollsOnExpand(boolean newValue)
scrollsOnExpand
свойство, которое определяет, могло ли бы дерево прокрутить, чтобы показать ранее скрытым дочерним элементам. Если это свойство true
(значение по умолчанию), то, когда узел разворачивает дерево, может использовать прокрутку, чтобы сделать максимальное возможное число потомков узла видимым. В некотором взгляде и чувствах, деревья, возможно, не должны были бы прокручивать когда расширено; те смотрят, и чувства проигнорируют это свойство. Это - связанное свойство.
newValue
- false
отключить прокрутку на расширении; true
включать этомуgetScrollsOnExpand()
public boolean getScrollsOnExpand()
scrollsOnExpand
свойство.scrollsOnExpand
свойствоpublic void setToggleClickCount(int clickCount)
Это - связанное свойство.
public int getToggleClickCount()
public void setExpandsSelectedPaths(boolean newValue)
expandsSelectedPaths
свойство. Если это правда, любое время выбор изменяется, любой через TreeSelectionModel
, или методы покрытия, обеспеченные JTree
, TreePath
s родители будет расширен, чтобы сделать их видимыми (видимое значение, что родительский путь расширяется, не обязательно в видимом прямоугольнике JTree
). Если ложь, когда выбор изменяет родителя узлов, не делается видимой (все его расширенные родители). Это полезно, если Вы хотите иметь свою модель выбора, поддерживают пути, которые не всегда видимы (все расширенные родители). Это - связанное свойство.
newValue
- новое значение для expandsSelectedPaths
public boolean getExpandsSelectedPaths()
expandsSelectedPaths
свойство.setExpandsSelectedPaths(boolean)
public void setDragEnabled(boolean b)
true
, и дерево TransferHandler
потребности быть non-null
. Значение по умолчанию dragEnabled
свойство false
. Задание удостаивания этого свойства, и распознавания пользователя перетаскивает жест, находится с реализацией стили, и в частности дерево TreeUI
. Когда автоматический перетащите обработку, включается, большинство взгляда и чувств (включая тех, которые разделяют на подклассы BasicLookAndFeel
) начните перетаскивание и отбросьте работу всякий раз, когда пользователь нажимает кнопку мыши по элементу и затем перемещает мышь несколько пикселей. Установка этого свойства к true
может поэтому иметь тонкий эффект на то, как выборы ведут себя.
Если стиль используется, который игнорирует это свойство, можно все еще начать перетаскивание и отбросить работу, вызывая exportAsDrag
на дереве TransferHandler
.
b
- включить ли автоматический, перетаскивают обработкуHeadlessException
- если b
true
и GraphicsEnvironment.isHeadless()
возвраты true
GraphicsEnvironment.isHeadless()
, getDragEnabled()
, JComponent.setTransferHandler(javax.swing.TransferHandler)
, TransferHandler
public boolean getDragEnabled()
dragEnabled
свойствоsetDragEnabled(boolean)
public final void setDropMode(DropMode dropMode)
DropMode.USE_SELECTION
. Использование одного из других режимов рекомендуется, однако, для улучшенного пользовательского опыта. DropMode.ON
, например, подобное поведение предложений показа элементов как выбрано, но делает так, не влияя на фактический выбор в дереве.
JTree
поддерживает следующие режимы отбрасывания:
DropMode.USE_SELECTION
DropMode.ON
DropMode.INSERT
DropMode.ON_OR_INSERT
Режим отбрасывания только значим, если у этого компонента есть a TransferHandler
это принимает отбрасывания.
dropMode
- режим отбрасывания, чтобы использоватьIllegalArgumentException
- если режим отбрасывания неподдерживается или null
getDropMode()
, getDropLocation()
, JComponent.setTransferHandler(javax.swing.TransferHandler)
, TransferHandler
public final DropMode getDropMode()
setDropMode(javax.swing.DropMode)
public final JTree.DropLocation getDropLocation()
null
если никакое расположение нельзя в настоящий момент показать. Этот метод не предназначается для того, чтобы запросить расположение отбрасывания от a TransferHandler
, поскольку расположение отбрасывания только устанавливается после TransferHandler
's canImport
возвратился и учел расположение, которое будет показано.
Когда это свойство изменяется, событие изменения свойства с именем "dropLocation" запускается компонентом.
setDropMode(javax.swing.DropMode)
, TransferHandler.canImport(TransferHandler.TransferSupport)
public boolean isPathEditable(TreePath path)
isEditable
. Это вызывается от UI прежде, чем редактирование начнет обеспечивать, чтобы данный путь мог быть отредактирован. Это предоставляется как точка входа подклассификаторам, чтобы добавить фильтруемое редактирование, не имея необходимость обращаться к созданию нового редактора.isEditable()
public String getToolTipText(MouseEvent event)
JComponent
's getToolTipText
метод, чтобы позволить подсказкам средства рендеринга использоваться, если ему установили текст. ОТМЕТЬТЕ: Для JTree
должным образом вывести на экран подсказки его средств рендеринга, JTree
должен быть зарегистрированный компонент с ToolTipManager
. Это может быть сделано, вызывая ToolTipManager.sharedInstance().registerComponent(tree)
. Это не делается автоматически!
getToolTipText
в class JComponent
event
- MouseEvent
это инициировало ToolTip
дисплейnull
если event
нульpublic String convertValueToText(Object value, boolean selected, boolean expanded, boolean leaf, int row, boolean hasFocus)
value.toString
, игнорирование всех других параметров. Чтобы управлять преобразованием, разделите этот метод на подклассы и используйте любой из параметров, в которых Вы нуждаетесь.value
- Object
преобразовать в текстselected
- истина, если узел выбираетсяexpanded
- истина, если узел расширяетсяleaf
- истина, если узел является вершинойrow
- целое число, определяющее строку дисплея узла, где 0 первая строка в дисплееhasFocus
- истина, если у узла есть фокусString
представление значения узлаpublic int getRowCount()
isRootVisible()
true
. Это возвращается 0
если UI не был установлен.public void setSelectionPath(TreePath path)
getExpandsSelectedPaths
истина, она представляется (сделанный просматриваемым).path
- TreePath
определение узла, чтобы выбратьpublic void setSelectionPaths(TreePath[] paths)
getExpandsSelectedPaths
истина, она представляется (сделанный просматриваемым).paths
- массив TreePath
объекты, который определяет узлы, чтобы выбратьpublic void setLeadSelectionPath(TreePath newPath)
JTree
, скорее UI обновит это. Это - связанное свойство.
newPath
- новый ведущий путьpublic void setAnchorSelectionPath(TreePath newPath)
JTree
, скорее UI обновит это. Это - связанное свойство.
newPath
- новый путь привязкиpublic void setSelectionRow(int row)
row
- строка, чтобы выбрать, где 0 первая строка в дисплееpublic void setSelectionRows(int[] rows)
rows
< 0 or >= getRowCount
, это будет проигнорировано. Если ни один из элементов в rows
допустимые строки, выбор будет очищен. Это - это, будет то, как будто clearSelection
был вызван.rows
- массив ints определение строк, чтобы выбрать, где 0 указывает на первую строку в дисплееpublic void addSelectionPath(TreePath path)
TreePath
к текущему выбору. Если какой-либо компонент пути не является просматриваемым, и getExpandsSelectedPaths
истина, это делается просматриваемым. Отметьте это JTree
не позволяет двойным узлам существовать как дочерние элементы под тем же самым родителем - каждый одноуровневый элемент должен быть уникальным объектом.
path
- TreePath
добавитьpublic void addSelectionPaths(TreePath[] paths)
getExpandsSelectedPaths
истина, это делается просматриваемым. Отметьте это JTree
не позволяет двойным узлам существовать как дочерние элементы под тем же самым родителем - каждый одноуровневый элемент должен быть уникальным объектом.
paths
- массив TreePath
объекты, который определяет узлы, чтобы добавитьpublic void addSelectionRow(int row)
row
- целое число, определяющее строку узла, чтобы добавить, где 0 первая строка в дисплееpublic void addSelectionRows(int[] rows)
rows
- массив ints определение строк, чтобы добавить, где 0 указывает на первую строку в дисплееpublic Object getLastSelectedPathComponent()
getSelectionModel().getSelectionPath().getLastPathComponent()
. Это обычно только полезно, если у выбора есть один путь.null
если ничто не выбираетсяTreePath.getLastPathComponent()
public TreePath getLeadSelectionPath()
public TreePath getAnchorSelectionPath()
public TreePath getSelectionPath()
TreePath
для первого выбранного узла, или null
если ничто в настоящий момент не выбираетсяpublic TreePath[] getSelectionPaths()
TreePath
объекты, указывающие на выбранные узлы, или null
если ничто в настоящий момент не выбираетсяpublic int[] getSelectionRows()
TreeSelectionModel
. Если ничто не выбирается null
или пустой массив будет возвращен, основан на TreeSelectionModel
реализация.public int getSelectionCount()
public int getMinSelectionRow()
-1
возвращается.public int getMaxSelectionRow()
-1
возвращается.public int getLeadSelectionRow()
leadPath
null
public boolean isPathSelected(TreePath path)
path
- a TreePath
идентификация узлаpublic boolean isRowSelected(int row)
row
- целое число, определяющее строку дисплея, где 0 первая строка в дисплееpublic Enumeration<TreePath> getExpandedDescendants(TreePath parent)
Enumeration
из потомков пути parent
это в настоящий момент расширяется. Если parent
в настоящий момент не расширяется, это возвратится null
. Если Вы расширяетесь/выходите из строя узлы, выполняя итерации по возвращенному Enumeration
это, возможно, не возвращает все расширенные пути, или могут обратные пути, которые больше не расширяются.parent
- путь, который должен быть исследованEnumeration
из потомков parent
, или null
если parent
в настоящий момент не расширяетсяpublic boolean hasBeenExpanded(TreePath path)
path
когда-либо расширялсяpublic boolean isExpanded(TreePath path)
path
- TreePath
определение узла, чтобы проверитьpublic boolean isExpanded(int row)
row
- строка, чтобы проверить, где 0 первая строка в дисплееpublic boolean isCollapsed(TreePath path)
path
- TreePath
проверятьpublic boolean isCollapsed(int row)
row
- строка, чтобы проверить, где 0 первая строка в дисплееpublic void makeVisible(TreePath path)
path
- TreePath
сделать видимымpublic boolean isVisible(TreePath path)
public Rectangle getPathBounds(TreePath path)
Rectangle
то, что указанный узел будет вовлечен. Возвраты null
если какой-либо компонент в пути скрывается (под свернутым родителем). Отметьте:
Этот метод возвращает допустимый прямоугольник, даже если указанный узел в настоящий момент не выводится на экран.
path
- TreePath
идентификация узлаRectangle
узел оттягивается в, или null
public Rectangle getRowBounds(int row)
Rectangle
то, что узел в указанной строке оттягивается в.row
- строка, которая будет оттянута, где 0 первая строка в дисплееRectangle
узел оттягивается вpublic void scrollPathToVisible(TreePath path)
JTree
содержится в a JScrollPane
.path
- TreePath
идентификация узла, чтобы принести в представлениеpublic void scrollRowToVisible(int row)
JTree
содержится в a JScrollPane
.row
- целое число, определяющее строку, чтобы прокрутить, где 0 первая строка в дисплееpublic TreePath getPathForRow(int row)
row
не видимо, или a TreeUI
не был установлен, null
возвращается.row
- целое число, определяющее строкуTreePath
к указанному узлу, null
если row < 0
or row >= getRowCount()
public int getRowForPath(TreePath path)
path
- the TreePath
identifying a nodepublic void expandPath(TreePath path)
path
- the TreePath
identifying a nodepublic void expandRow(int row)
If row
is < 0 or >= getRowCount
this will have no effect.
row
- an integer specifying a display row, where 0 is the first row in the displaypublic void collapsePath(TreePath path)
path
- the TreePath
identifying a nodepublic void collapseRow(int row)
If row
is < 0 or >= getRowCount
this will have no effect.
row
- an integer specifying a display row, where 0 is the first row in the displaypublic TreePath getPathForLocation(int x, int y)
x
- an integer giving the number of pixels horizontally from the left edge of the display area, minus any left marginy
- an integer giving the number of pixels vertically from the top of the display area, minus any top marginTreePath
for the node at that locationpublic int getRowForLocation(int x, int y)
x
- an integer giving the number of pixels horizontally from the left edge of the display area, minus any left marginy
- an integer giving the number of pixels vertically from the top of the display area, minus any top margingetClosestRowForLocation(int, int)
public TreePath getClosestPathForLocation(int x, int y)
null
, otherwise it always returns a valid path. To test if the node is exactly at x, y, get the node's bounds and test x, y against that.x
- an integer giving the number of pixels horizontally from the left edge of the display area, minus any left marginy
- an integer giving the number of pixels vertically from the top of the display area, minus any top marginTreePath
for the node closest to that location, null
if nothing is viewable or there is no modelgetPathForLocation(int, int)
, getPathBounds(javax.swing.tree.TreePath)
public int getClosestRowForLocation(int x, int y)
x
- an integer giving the number of pixels horizontally from the left edge of the display area, minus any left marginy
- an integer giving the number of pixels vertically from the top of the display area, minus any top margingetRowForLocation(int, int)
, getRowBounds(int)
public boolean isEditing()
getSelectionPath
.getSelectionPath()
public boolean stopEditing()
DefaultTreeCellEditor
object saves any edits that are currently in progress on a cell. Other implementations may operate differently.) Has no effect if the tree isn't being edited. Note:
To make edit-saves automatic whenever the user changes their position in the tree, usesetInvokesStopCellEditing(boolean)
.
public void cancelEditing()
public void startEditingAtPath(TreePath path)
CellEditor
does not allow editing for the specified item.path
- the TreePath
identifying a nodepublic TreePath getEditingPath()
TreePath
for the node being editedpublic void setSelectionModel(TreeSelectionModel selectionModel)
null
value is specified an empty selectionModel
is used, which does not allow selections. This is a bound property.
selectionModel
- the TreeSelectionModel
to use, or null
to disable selectionsTreeSelectionModel
public TreeSelectionModel getSelectionModel()
null
value. If you don't want to allow anything to be selected set the selection model to null
, which forces an empty selection model to be used.protected TreePath[] getPathBetweenRows(int index0, int index1)
10
, and this method is invoked with -1, 20
, then the specified indices are constrained to the viewable set of rows, and this is treated as if invoked with 0, 9
. On the other hand, if this were invoked with -10, -1
, then the specified indices do not bound the viewable set of rows, and an empty array is returned. The parameters are not order dependent. That is, getPathBetweenRows(x, y)
is equivalent to getPathBetweenRows(y, x)
.
An empty array is returned if the row count is 0
, or the specified indices do not bound the viewable set of rows.
index0
- the first index in the rangeindex1
- the last index in the rangepublic void setSelectionInterval(int index0, int index1)
10
, and this method is invoked with -1, 20
, then the specified indices bounds the viewable range, and this is treated as if invoked with 0, 9
. On the other hand, if this were invoked with -10, -1
, then the specified indices do not bound the viewable set of rows, and the selection is cleared. The parameters are not order dependent. That is, setSelectionInterval(x, y)
is equivalent to setSelectionInterval(y, x)
.
index0
- the first index in the range to selectindex1
- the last index in the range to selectpublic void addSelectionInterval(int index0, int index1)
10
, and this method is invoked with -1, 20
, then the specified indices bounds the viewable range, and this is treated as if invoked with 0, 9
. On the other hand, if this were invoked with -10, -1
, then the specified indices do not bound the viewable set of rows, and the selection is unchanged. The parameters are not order dependent. That is, addSelectionInterval(x, y)
is equivalent to addSelectionInterval(y, x)
.
index0
- the first index in the range to add to the selectionindex1
- the last index in the range to add to the selectionpublic void removeSelectionInterval(int index0, int index1)
10
, and this method is invoked with -1, 20
, then the specified range bounds the viewable range, and this is treated as if invoked with 0, 9
. On the other hand, if this were invoked with -10, -1
, then the specified range does not bound the viewable set of rows, and the selection is unchanged. The parameters are not order dependent. That is, removeSelectionInterval(x, y)
is equivalent to removeSelectionInterval(y, x)
.
index0
- the first row to remove from the selectionindex1
- the last row to remove from the selectionpublic void removeSelectionPath(TreePath path)
path
- the TreePath
identifying a nodepublic void removeSelectionPaths(TreePath[] paths)
paths
- an array of TreePath
objects that specifies the nodes to removepublic void removeSelectionRow(int row)
row
from the current selection.row
- the row to removepublic void removeSelectionRows(int[] rows)
rows
- an array of ints specifying display rows, where 0 is the first row in the displaypublic void clearSelection()
public boolean isSelectionEmpty()
public void addTreeExpansionListener(TreeExpansionListener tel)
TreeExpansion
events.tel
- a TreeExpansionListener that will be notified when a tree node is expanded or collapsed (a "negative expansion")public void removeTreeExpansionListener(TreeExpansionListener tel)
TreeExpansion
events.tel
- the TreeExpansionListener
to removepublic TreeExpansionListener[] getTreeExpansionListeners()
TreeExpansionListener
s added to this JTree with addTreeExpansionListener().TreeExpansionListener
s added or an empty array if no listeners have been addedpublic void addTreeWillExpandListener(TreeWillExpandListener tel)
TreeWillExpand
events.tel
- a TreeWillExpandListener
that will be notified when a tree node will be expanded or collapsed (a "negative expansion")public void removeTreeWillExpandListener(TreeWillExpandListener tel)
TreeWillExpand
events.tel
- the TreeWillExpandListener
to removepublic TreeWillExpandListener[] getTreeWillExpandListeners()
TreeWillExpandListener
s added to this JTree with addTreeWillExpandListener().TreeWillExpandListener
s added or an empty array if no listeners have been addedpublic void fireTreeExpanded(TreePath path)
path
parameter.path
- the TreePath
indicating the node that was expandedEventListenerList
public void fireTreeCollapsed(TreePath path)
path
parameter.path
- the TreePath
indicating the node that was collapsedEventListenerList
public void fireTreeWillExpand(TreePath path) throws ExpandVetoException
path
parameter.path
- the TreePath
indicating the node that was expandedExpandVetoException
EventListenerList
public void fireTreeWillCollapse(TreePath path) throws ExpandVetoException
path
parameter.path
- the TreePath
indicating the node that was expandedExpandVetoException
EventListenerList
public void addTreeSelectionListener(TreeSelectionListener tsl)
TreeSelection
events.tsl
- the TreeSelectionListener
that will be notified when a node is selected or deselected (a "negative selection")public void removeTreeSelectionListener(TreeSelectionListener tsl)
TreeSelection
listener.tsl
- the TreeSelectionListener
to removepublic TreeSelectionListener[] getTreeSelectionListeners()
TreeSelectionListener
s added to this JTree with addTreeSelectionListener().TreeSelectionListener
s added or an empty array if no listeners have been addedprotected void fireValueChanged(TreeSelectionEvent e)
e
- the TreeSelectionEvent
to be fired; generated by the TreeSelectionModel
when a node is selected or deselectedEventListenerList
public void treeDidChange()
public void setVisibleRowCount(int newCount)
JScrollPane
, and will adjust the preferred size and size of that scrollpane. This is a bound property.
newCount
- the number of rows to displaypublic int getVisibleRowCount()
public TreePath getNextMatch(String prefix, int startingRow, Position.Bias bias)
TreePath
into a String, convertValueToText
is used.prefix
- the string to test for a matchstartingRow
- the row for starting the searchbias
- the search direction, either Position.Bias.Forward or Position.Bias.Backward.IllegalArgumentException
- if prefix is null or startingRow is out of boundspublic Dimension getPreferredScrollableViewportSize()
JTree
. The height is determined from getVisibleRowCount
and the width is the current preferred width.getPreferredScrollableViewportSize
in interface Scrollable
Dimension
object containing the preferred sizeJComponent.getPreferredSize()
public int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
getScrollableUnitIncrement
in interface Scrollable
visibleRect
- the view area visible within the viewportorientation
- either SwingConstants.VERTICAL
or SwingConstants.HORIZONTAL
direction
- less than zero to scroll up/left, greater than zero for down/rightJScrollBar.setUnitIncrement(int)
public int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
visibleRect
, based on orientation
.getScrollableBlockIncrement
in interface Scrollable
visibleRect
- the view area visible within the viewportorientation
- either SwingConstants.VERTICAL
or SwingConstants.HORIZONTAL
direction
- less than zero to scroll up/left, greater than zero for down/right.JScrollBar.setBlockIncrement(int)
public boolean getScrollableTracksViewportWidth()
getScrollableTracksViewportWidth
in interface Scrollable
Scrollable.getScrollableTracksViewportWidth()
public boolean getScrollableTracksViewportHeight()
getScrollableTracksViewportHeight
in interface Scrollable
Scrollable.getScrollableTracksViewportHeight()
protected void setExpandedState(TreePath path, boolean state)
JTree
. If state
is true, all parents of path
and path are marked as expanded. If state
is false, all parents of path
are marked EXPANDED, but path
itself is marked collapsed. This will fail if a TreeWillExpandListener
vetos it.
protected Enumeration<TreePath> getDescendantToggledPaths(TreePath parent)
Enumeration
of TreePaths
that have been expanded that are descendants of parent
.protected void removeDescendantToggledPaths(Enumeration<TreePath> toRemove)
TreePaths
in toRemove
that have been expanded.toRemove
- an enumeration of the paths to remove; a value of null
is ignoredClassCastException
- if toRemove
contains an element that is not a TreePath
; null
values are ignoredprotected void clearToggledPaths()
TreeExpansionListener
events.protected TreeModelListener createTreeModelListener()
TreeModelHandler
. The returned object is responsible for updating the expanded state when the TreeModel
changes. For more information on what expanded state means, see the JTree description above.
protected boolean removeDescendantSelectedPaths(TreePath path, boolean includePath)
path
. If includePath
is true and path
is selected, it will be removed from the selection.protected String paramString()
JTree
. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be null
.paramString
in class JComponent
JTree
.public AccessibleContext getAccessibleContext()
getAccessibleContext
in interface Accessible
getAccessibleContext
in class Component
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b92