public interface TreeSelectionModel
Состояние древовидного выбора характеризуется рядом TreePaths, и дополнительно ряда целых чисел. Отображение от TreePath до целого числа делается посредством экземпляра RowMapper. Не необходимо для TreeSelectionModel иметь RowMapper, чтобы правильно работать, но без RowMapper getSelectionRows
возвратит нуль.
TreeSelectionModel может быть сконфигурирован, чтобы позволить только один путь (SINGLE_TREE_SELECTION
) много continguous путей (CONTIGUOUS_TREE_SELECTION
) или много несмежных путей (DISCONTIGUOUS_TREE_SELECTION
). A RowMapper
используется, чтобы определить, непрерывны ли TreePaths. В отсутствие RowMapper CONTIGUOUS_TREE_SELECTION
и DISCONTIGUOUS_TREE_SELECTION
ведите себя то же самое, которое является, они позволяют любому числу путей содержаться в TreeSelectionModel.
Для модели выбора CONTIGUOUS_TREE_SELECTION
любое время пути изменяется (setSelectionPath
, addSelectionPath
...) TreePaths снова проверяются, чтобы сделать, они непрерывны. Проверка TreePaths может также быть вызвана, вызывая resetRowSelection
. То, как ряд несмежного TreePaths отображается на непрерывный набор, оставляют конструкторам этого интерфейса осуществить определенную политику.
Реализации должны объединить двойные TreePaths, которые добавляются к выбору. Например, следующий код
TreePath[] paths = new TreePath[] { treePath, treePath }; treeSelectionModel.setSelectionPaths(paths);должен привести только к одному выбираемому пути:
treePath
, а не две копии treePath
. Ведущий TreePath является последним путем, который был добавлен (или установлен). Ведущая строка является тогда строкой, которая соответствует TreePath как определено от RowMapper.
Модификатор и Тип | Поле и Описание |
---|---|
static int |
CONTIGUOUS_TREE_SELECTION
Выбор может только быть непрерывным.
|
static int |
DISCONTIGUOUS_TREE_SELECTION
Выбор может содержать любое число элементов, которые не обязательно непрерывны.
|
static int |
SINGLE_TREE_SELECTION
Выбор может только содержать один путь за один раз.
|
Модификатор и Тип | Метод и Описание |
---|---|
void |
addPropertyChangeListener(PropertyChangeListener listener)
Добавляет PropertyChangeListener к списку слушателя.
|
void |
addSelectionPath(TreePath path)
Добавляет путь к текущему выбору.
|
void |
addSelectionPaths(TreePath[] paths)
Добавляют пути к текущему выбору.
|
void |
addTreeSelectionListener(TreeSelectionListener x)
Добавляет x к списку слушателей, которые уведомляются каждый раз набор выбранных изменений TreePaths.
|
void |
clearSelection()
Освобождает текущий выбор.
|
TreePath |
getLeadSelectionPath()
Возвращает последний путь, который был добавлен.
|
int |
getLeadSelectionRow()
Возвращается ведущий выбор индексируют.
|
int |
getMaxSelectionRow()
Возвращает самое большое значение, полученное из RowMapper для текущего набора выбранного TreePaths.
|
int |
getMinSelectionRow()
Возвращает самое маленькое значение, полученное из RowMapper для текущего набора выбранного TreePaths.
|
RowMapper |
getRowMapper()
Возвращает экземпляр RowMapper, который в состоянии отобразить TreePath на строку.
|
int |
getSelectionCount()
Возвращает число путей, которые выбираются.
|
int |
getSelectionMode()
Возвращает текущий режим выбора, один из
SINGLE_TREE_SELECTION , CONTIGUOUS_TREE_SELECTION или DISCONTIGUOUS_TREE_SELECTION . |
TreePath |
getSelectionPath()
Возвращает первый путь в выборе.
|
TreePath[] |
getSelectionPaths()
Возвращает пути в выборе.
|
int[] |
getSelectionRows()
Возвраты все в настоящий момент выбранные строки.
|
boolean |
isPathSelected(TreePath path)
Возвращает true если путь,
path , находится в текущем выборе. |
boolean |
isRowSelected(int row)
Возвращает true если строка, идентифицированная
row выбирается. |
boolean |
isSelectionEmpty()
Возвращает true, если выбор в настоящий момент пуст.
|
void |
removePropertyChangeListener(PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка слушателя.
|
void |
removeSelectionPath(TreePath path)
Удаляет путь из выбора.
|
void |
removeSelectionPaths(TreePath[] paths)
Удаляет пути из выбора.
|
void |
removeTreeSelectionListener(TreeSelectionListener x)
Удаляет x из списка слушателей, которые уведомляются каждый раз набор выбранных изменений TreePaths.
|
void |
resetRowSelection()
Обновления отображение этого объекта от TreePaths до строк.
|
void |
setRowMapper(RowMapper newMapper)
Устанавливает экземпляр RowMapper.
|
void |
setSelectionMode(int mode)
Устанавливает модель выбора, которая должна быть одним из SINGLE_TREE_SELECTION, CONTIGUOUS_TREE_SELECTION или DISCONTIGUOUS_TREE_SELECTION.
|
void |
setSelectionPath(TreePath path)
Устанавливает выбор в путь.
|
void |
setSelectionPaths(TreePath[] paths)
Устанавливает выбор в путь.
|
static final int SINGLE_TREE_SELECTION
static final int CONTIGUOUS_TREE_SELECTION
static final int DISCONTIGUOUS_TREE_SELECTION
void setSelectionMode(int mode)
Это может изменить выбор, если текущий выбор не допустим для нового режима. Например, если три TreePaths выбираются, когда режим изменяется на SINGLE_TREE_SELECTION
, только один TreePath останется выбранным. Это до определенной реализации, чтобы решить то, что TreePath остается выбранным.
int getSelectionMode()
SINGLE_TREE_SELECTION
, CONTIGUOUS_TREE_SELECTION
или DISCONTIGUOUS_TREE_SELECTION
.void setSelectionPath(TreePath path)
path
нуль, это имеет тот же самый эффект как вызов clearSelection
.path
- новый путь, чтобы выбратьvoid setSelectionPaths(TreePath[] paths)
paths
нуль, это имеет тот же самый эффект как вызов clearSelection
.paths
- новый выборvoid addSelectionPath(TreePath path)
path
нуль.path
- новый путь, чтобы добавить к текущему выборуvoid addSelectionPaths(TreePath[] paths)
paths
нуль.paths
- новые пути, чтобы добавить к текущему выборуvoid removeSelectionPath(TreePath path)
path
нуль.path
- путь, чтобы удалить из выбораvoid removeSelectionPaths(TreePath[] paths)
paths
находятся в выборе, TreeSelectionListeners уведомляются. Этот метод не имеет никакого эффекта если paths
нуль.paths
- путь, чтобы удалить из выбораTreePath getSelectionPath()
RowMapper
.TreePath[] getSelectionPaths()
int getSelectionCount()
boolean isPathSelected(TreePath path)
path
, находится в текущем выборе.boolean isSelectionEmpty()
void clearSelection()
void setRowMapper(RowMapper newMapper)
RowMapper getRowMapper()
int[] getSelectionRows()
int getMinSelectionRow()
int getMaxSelectionRow()
boolean isRowSelected(int row)
row
выбирается.void resetRowSelection()
Вы не должны обычно вызывать это; JTree и его связанные слушатели вызовут это для Вас. Если Вы реализуете свое собственное представление class, то необходимо вызвать это.
int getLeadSelectionRow()
TreePath getLeadSelectionPath()
void addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeEvent будет уволен, когда режим выбора изменится.
listener
- PropertyChangeListener, который будет добавленvoid removePropertyChangeListener(PropertyChangeListener listener)
listener
- PropertyChangeListener, который будет удаленvoid addTreeSelectionListener(TreeSelectionListener x)
x
- новый слушатель, который будет добавленvoid removeTreeSelectionListener(TreeSelectionListener x)
x
- слушатель, чтобы удалить
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92