TreeSelectionModel (Java Platform SE 8 )

所有已知实现类：

DefaultTreeSelectionModel ， JTree.EmptySelectionModel
```
public interface TreeSelectionModel
```
此接口表示树组件选择的当前状态。有关使用树选择模型的信息和示例，请参阅Java教程中的 How to Use Trees 。
树选择的状态由一组TreePaths和可选的一组整数表征。从TreePath到整数的映射是通过RowMapper的一个实例来完成的。 TreeSelectionModel没有必要使RowMapper正确运行，但没有RowMapper getSelectionRows将返回null。

可以将TreeSelectionModel配置为仅允许一个路径（ SINGLE_TREE_SELECTION ）多个连续路径（ CONTIGUOUS_TREE_SELECTION ）或多个不连续路径（ DISCONTIGUOUS_TREE_SELECTION ）。 A RowMapper用于确定TreePath是否是连续的。在没有RowMapper CONTIGUOUS_TREE_SELECTION和DISCONTIGUOUS_TREE_SELECTION行为相同的情况下，就是它们允许在TreeSelectionModel中包含任意数量的路径。

对于选择模型CONTIGUOUS_TREE_SELECTION的路径被变更的任何时间（ setSelectionPath ， addSelectionPath ...）的TreePath，则再次检查，以他们是连续的。还可以通过调用resetRowSelection来强制对resetRowSelection 。一组不连贯的TreePath如何映射到一个连续的集合是由这个接口的实现者执行一个特定的策略。

实现应该将添加到选择中的重复TreePath组合起来。例如，以下代码
```
  TreePath[] paths = new TreePath[] { treePath, treePath };
   treeSelectionModel.setSelectionPaths(paths); 
```
应该只能选择一个路径： treePath ，而不是treePath两个treePath 。
引导TreePath是添加（或设置）的最后一个路径。那么引导行就是从RowMapper确定的对应于TreePath的行。

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`CONTIGUOUS_TREE_SELECTION` 选择只能是连续的。
`static int`	`DISCONTIGUOUS_TREE_SELECTION` 选择可以包含任何数量的不一定连续的项目。
`static int`	`SINGLE_TREE_SELECTION` 选择一次只能包含一个路径。

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`void`	`addPropertyChangeListener(PropertyChangeListener listener)` 将PropertyChangeListener添加到侦听器列表。
`void`	`addSelectionPath(TreePath path)` 添加当前选择的路径。
`void`	`addSelectionPaths(TreePath[] paths)` 将路径添加到当前选择。
`void`	`addTreeSelectionListener(TreeSelectionListener x)` 将x添加到每次选定的TreePath集合更改时通知的侦听器列表。
`void`	`clearSelection()` 清空当前的选择。
`TreePath`	`getLeadSelectionPath()` 返回添加的最后一个路径。
`int`	`getLeadSelectionRow()` 返回引导选择索引。
`int`	`getMaxSelectionRow()` 返回从当前所选TreePath集合的RowMapper获取的最大值。
`int`	`getMinSelectionRow()` 返回从当前所选TreePath集合的RowMapper获取的最小值。
`RowMapper`	`getRowMapper()` 返回能够将TreePath映射到行的RowMapper实例。
`int`	`getSelectionCount()` 返回所选路径的数量。
`int`	`getSelectionMode()` 返回当前选择模式，一个 `SINGLE_TREE_SELECTION` ， `CONTIGUOUS_TREE_SELECTION`或 `DISCONTIGUOUS_TREE_SELECTION` 。
`TreePath`	`getSelectionPath()` 返回选择中的第一个路径。
`TreePath[]`	`getSelectionPaths()` 返回选择中的路径。
`int[]`	`getSelectionRows()` 返回当前选定的所有行。
`boolean`	`isPathSelected(TreePath path)` 如果路径 `path`在当前选择中，则返回true。
`boolean`	`isRowSelected(int row)` 如果选择了 `row`的行，则返回true。
`boolean`	`isSelectionEmpty()` 如果选择当前为空，则返回true。
`void`	`removePropertyChangeListener(PropertyChangeListener listener)` 从侦听器列表中移除PropertyChangeListener。
`void`	`removeSelectionPath(TreePath path)` 从选择中删除路径。
`void`	`removeSelectionPaths(TreePath[] paths)` 从选择中删除路径。
`void`	`removeTreeSelectionListener(TreeSelectionListener x)` 从每次所选树形路径组更改时通知的侦听器列表中删除x。
`void`	`resetRowSelection()` 将此对象的映射从TreePath更新为行。
`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)` 将选择设置为路径。

- 字段详细信息
  - SINGLE_TREE_SELECTION
```
static final int SINGLE_TREE_SELECTION
```
    选择一次只能包含一个路径。
    
    另请参见：
    
    Constant Field Values
  - CONTIGUOUS_TREE_SELECTION
```
static final int CONTIGUOUS_TREE_SELECTION
```
    选择只能是连续的。仅当提供了RowMapper实例时，才会执行此操作。也就是说，如果没有设置RowMapper，则其行为与DISCONTIGUOUS_TREE_SELECTION相同。
    
    另请参见：
    
    Constant Field Values
  - DISCONTIGUOUS_TREE_SELECTION
```
static final int DISCONTIGUOUS_TREE_SELECTION
```
    选择可以包含任何数量的不一定连续的项目。
    
    另请参见：
    
    Constant Field Values
- 方法详细信息
  - setSelectionMode
```
void setSelectionMode(int mode)
```
    设置选择模型，它必须是SINGLE_TREE_SELECTION，CONTIGUOUS_TREE_SELECTION或DISCONTIGUOUS_TREE_SELECTION之一。
    如果当前选择对新模式无效，这可能会更改选择。例如，如果在模式更改为SINGLE_TREE_SELECTION时选择了三个TreePath，则只保留一个TreePath。确定什么TreePath保持选择是由特定的实现决定的。
  - getSelectionMode
```
int getSelectionMode()
```
    返回当前选择模式，一个 SINGLE_TREE_SELECTION ， CONTIGUOUS_TREE_SELECTION或 DISCONTIGUOUS_TREE_SELECTION 。
  - setSelectionPath
```
void setSelectionPath(TreePath path)
```
    将选择设置为路径。如果这表示更改，则会通知TreeSelectionListeners。如果path为null，则与调用clearSelection具有相同的效果。
    
    参数
    
    path - 要选择的新路径
  - setSelectionPaths
```
void setSelectionPaths(TreePath[] paths)
```
    将选择设置为路径。如果这表示更改，则会通知TreeSelectionListeners。如果paths为null，则与调用clearSelection具有相同的效果。
    
    参数
    
    paths - 新的选择
  - addSelectionPath
```
void addSelectionPath(TreePath path)
```
    添加当前选择的路径。如果路径当前不在选择中，则会通知TreeSelectionListeners。如果path为空，则无效。
    
    参数
    
    path - 添加到当前选择的新路径
  - addSelectionPaths
```
void addSelectionPaths(TreePath[] paths)
```
    将路径添加到当前选择。如果路径中的任何路径当前不在选择中，则会通知TreeSelectionListeners。如果paths为空，则无效。
    
    参数
    
    paths - 添加到当前选择的新路径
  - removeSelectionPath
```
void removeSelectionPath(TreePath path)
```
    从选择中删除路径。如果路径在选择中TreeSelectionListeners被通知。如果path为空，则path 。
    
    参数
    
    path - 从选择中删除的路径
  - removeSelectionPaths
```
void removeSelectionPaths(TreePath[] paths)
```
    从选择中删除路径。如果选择了paths中的任何路径， paths通知TreeSelectionListeners。如果paths为空，则此方法无效。
    
    参数
    
    paths - 从选择中删除的路径
  - getSelectionPath
```
TreePath getSelectionPath()
```
    返回选择中的第一个路径。如何第一被定义为至多实现者，并且可以不必是与从确定的最小整数值的TreePath RowMapper 。
  - getSelectionPaths
```
TreePath[] getSelectionPaths()
```
    返回选择中的路径。如果当前没有选择任何内容，这将返回null（或一个空数组）。
  - getSelectionCount
```
int getSelectionCount()
```
    返回所选路径的数量。
  - isPathSelected
```
boolean isPathSelected(TreePath path)
```
    如果路径 path位于当前选择中，则返回true。
  - isSelectionEmpty
```
boolean isSelectionEmpty()
```
    如果选择当前为空，则返回true。
  - clearSelection
```
void clearSelection()
```
    清空当前的选择。如果这表示当前选择的变化，通知选择听众。
  - setRowMapper
```
void setRowMapper(RowMapper newMapper)
```
    设置RowMapper实例。此实例用于确定特定TreePath的行。
  - getRowMapper
```
RowMapper getRowMapper()
```
    返回能够将TreePath映射到行的RowMapper实例。
  - getSelectionRows
```
int[] getSelectionRows()
```
    返回当前选定的所有行。如果没有选择的TreePath或者没有设置RowMapper，这将返回null（或一个空数组）。
  - getMinSelectionRow
```
int getMinSelectionRow()
```
    返回从当前所选TreePath集合的RowMapper获取的最小值。如果没有选择，或没有RowMapper，则返回-1。
  - getMaxSelectionRow
```
int getMaxSelectionRow()
```
    返回从当前所选TreePath集合的RowMapper获取的最大值。如果没有选择，或没有RowMapper，则返回-1。
  - isRowSelected
```
boolean isRowSelected(int row)
```
    如果选择了 row的行，则返回true。
  - resetRowSelection
```
void resetRowSelection()
```
    将此对象的映射从TreePath更新为行。当从TreePaths到整数的映射已经改变（例如，一个节点已经被扩展）时，这个应该被调用。
    你一般不用这样叫; JTree及其相关的监听器将为您调用。如果您正在实现自己的视图类，那么您将必须调用此视图。
  - getLeadSelectionRow
```
int getLeadSelectionRow()
```
    返回引导选择索引。这是添加的最后一个索引。
  - getLeadSelectionPath
```
TreePath getLeadSelectionPath()
```
    返回添加的最后一个路径。这可能与JTree维护的leadSelectionPath属性不同。
  - addPropertyChangeListener
```
void addPropertyChangeListener(PropertyChangeListener listener)
```
    将PropertyChangeListener添加到侦听器列表。所有属性都注册了监听器。
    当选择模式更改时，PropertyChangeEvent将被触发。
    
    参数
    
    listener - 要添加的PropertyChangeListener
  - removePropertyChangeListener
```
void removePropertyChangeListener(PropertyChangeListener listener)
```
    从侦听器列表中移除PropertyChangeListener。这会删除为所有属性注册的PropertyChangeListener。
    
    参数
    
    listener - 要删除的PropertyChangeListener
  - addTreeSelectionListener
```
void addTreeSelectionListener(TreeSelectionListener x)
```
    将x添加到每次选定的TreePath集合更改时通知的侦听器列表。
    
    参数
    
    x - 要添加的新侦听器
  - removeTreeSelectionListener
```
void removeTreeSelectionListener(TreeSelectionListener x)
```
    从每次所选树形路径组更改时通知的侦听器列表中删除x。
    
    参数
    
    x - 要删除的侦听器

Submit a bug or feature
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, 2014, Oracle and/or its affiliates. All rights reserved.

Interface TreeSelectionModel

Field Summary

方法摘要

字段详细信息

SINGLE_TREE_SELECTION

CONTIGUOUS_TREE_SELECTION

DISCONTIGUOUS_TREE_SELECTION

方法详细信息

setSelectionMode

getSelectionMode

setSelectionPath

setSelectionPaths

addSelectionPath

addSelectionPaths

removeSelectionPath

removeSelectionPaths

getSelectionPath

getSelectionPaths

getSelectionCount

isPathSelected

isSelectionEmpty

clearSelection

setRowMapper

getRowMapper

getSelectionRows

getMinSelectionRow

getMaxSelectionRow

isRowSelected

resetRowSelection

getLeadSelectionRow

getLeadSelectionPath

addPropertyChangeListener

removePropertyChangeListener

addTreeSelectionListener

removeTreeSelectionListener