DefaultListSelectionModel (Java Platform SE 8 )

java.lang.Object
- javax.swing.DefaultListSelectionModel

All Implemented Interfaces:

Serializable ， Cloneable ， ListSelectionModel
```
public class DefaultListSelectionModel
extends Object
implements ListSelectionModel, Cloneable, Serializable
```
列表选择的默认数据模型。
警告：此类的序列化对象与将来的Swing版本不兼容。当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。从1.4开始，对所有JavaBeans的长期存储的支持已经添加到java.beans包中。请参阅XMLEncoder 。

另请参见：

ListSelectionModel

Field Summary

Fields
Modifier and Type	Field and Description
`protected boolean`	`leadAnchorNotificationEnabled`
`protected EventListenerList`	`listenerList`

Fields inherited from interface javax.swing.ListSelectionModel
MULTIPLE_INTERVAL_SELECTION, SINGLE_INTERVAL_SELECTION, SINGLE_SELECTION

构造方法摘要

构造方法
Constructor and Description
`DefaultListSelectionModel()`

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`addListSelectionListener(ListSelectionListener l)` 将侦听器添加到每次发生更改选择时通知的列表。
`void`	`addSelectionInterval(int index0, int index1)` 将选择更改为当前选择的集合，以及 `index0`和 `index1`之间的索引。
`void`	`clearSelection()` 将选择更改为空集。
`Object`	`clone()` 返回具有相同选择的此选择模型的克隆。
`protected void`	`fireValueChanged(boolean isAdjusting)` 通知听众我们已经结束了一系列调整。
`protected void`	`fireValueChanged(int firstIndex, int lastIndex)` 通知 `ListSelectionListeners`该选择的值，在闭区间 `firstIndex` ， `lastIndex` ，已经改变。
`protected void`	`fireValueChanged(int firstIndex, int lastIndex, boolean isAdjusting)`
`int`	`getAnchorSelectionIndex()` 从最近调用setSelectionInterval（），addSelectionInterval（）或removeSelectionInterval（）返回第一个索引参数。
`int`	`getLeadSelectionIndex()` 将第二个索引参数从最近的调用返回给setSelectionInterval（），addSelectionInterval（）或removeSelectionInterval（）。
`<T extends EventListener> T[]`	`getListeners(类<T> listenerType)` 在此模型上返回当前注册为 `FooListener`的所有对象的数组。
`ListSelectionListener[]`	`getListSelectionListeners()` 返回在此 `DefaultListSelectionModel`上 `DefaultListSelectionModel`的所有列表选择侦听器的 `DefaultListSelectionModel` 。
`int`	`getMaxSelectionIndex()` 返回最后选择的索引，如果选择为空，则返回-1。
`int`	`getMinSelectionIndex()` 返回第一个选择的索引，如果选择为空，则返回-1。
`int`	`getSelectionMode()` 返回当前选择模式。
`boolean`	`getValueIsAdjusting()` 如果选择正在进行一系列更改，则返回 `true` 。
`void`	`insertIndexInterval(int index, int length, boolean before)` 在索引之前/之后插入长度索引。
`boolean`	`isLeadAnchorNotificationEnabled()` 返回 `leadAnchorNotificationEnabled`标志的值。
`boolean`	`isSelectedIndex(int index)` 如果选择了指定的索引，则返回true。
`boolean`	`isSelectionEmpty()` 如果没有选择索引，则返回true。
`void`	`moveLeadSelectionIndex(int leadIndex)` 设置引导选择索引，保持所有选择值不变。
`void`	`removeIndexInterval(int index0, int index1)` 从选择模型中删除间隔index0，index1（包括）中的索引。
`void`	`removeListSelectionListener(ListSelectionListener l)` 从列表中删除一个侦听器，每次发生更改时都会通知该侦听器。
`void`	`removeSelectionInterval(int index0, int index1)` 将选择变为当前选择的设定差异和 `index0`与 `index1`之间的指数。
`void`	`setAnchorSelectionIndex(int anchorIndex)` 设置锚选择索引，使所有选择值保持不变。
`void`	`setLeadAnchorNotificationEnabled(boolean flag)` 设置leadAnchorNotificationEnabled标志的值。
`void`	`setLeadSelectionIndex(int leadIndex)` 设置引导选择索引，确保锚和新引线之间的值全部被选中或全部被取消选择。
`void`	`setSelectionInterval(int index0, int index1)` 将选择更改为 `index0`和 `index1`包括）。
`void`	`setSelectionMode(int selectionMode)` 设置选择模式。
`void`	`setValueIsAdjusting(boolean isAdjusting)` 设置 `valueIsAdjusting`属性，其指示即将进行的选择更改是否应被视为单个更改的一部分。
`String`	`toString()` 返回显示和标识此对象属性的字符串。

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 字段详细信息
  - listenerList
```
protected EventListenerList listenerList
```
  - leadAnchorNotificationEnabled
```
protected boolean leadAnchorNotificationEnabled
```
- 构造方法详细信息
  - DefaultListSelectionModel
```
public DefaultListSelectionModel()
```
- 方法详细信息
  - getMinSelectionIndex
```
public int getMinSelectionIndex()
```
    返回第一个选择的索引，如果选择为空，则返回-1。
    
    Specified by:
    
    getMinSelectionIndex中的 ListSelectionModel
  - getMaxSelectionIndex
```
public int getMaxSelectionIndex()
```
    返回最后选择的索引，如果选择为空，则返回-1。
    
    Specified by:
    
    getMaxSelectionIndex在界面 ListSelectionModel
  - getValueIsAdjusting
```
public boolean getValueIsAdjusting()
```
    如果选择正在进行一系列更改，则返回 true 。
    
    Specified by:
    
    getValueIsAdjusting中的 ListSelectionModel
    
    结果
    
    如果选择正在进行一系列更改，则为true
    
    另请参见：
    
    ListSelectionModel.setValueIsAdjusting(boolean)
  - getSelectionMode
```
public int getSelectionMode()
```
    返回当前选择模式。
    
    Specified by:
    
    getSelectionMode在接口 ListSelectionModel
    
    结果
    
    当前选择模式
    
    另请参见：
    
    ListSelectionModel.setSelectionMode(int)
  - setSelectionMode
```
public void setSelectionMode(int selectionMode)
```
    设置选择模式。以下列表描述了接受的选择模式：
    - ListSelectionModel.SINGLE_SELECTION - 一次只能选择一个列表索引。在这种模式下， setSelectionInterval和addSelectionInterval是等价的，都用当前选择代替第二个参数（“lead”）表示的索引。
    - ListSelectionModel.SINGLE_INTERVAL_SELECTION - 一次只能选择一个连续的间隔。在此模式下， addSelectionInterval行为类似于setSelectionInterval （替换当前选择），除非给定的间隔与现有选择紧密相邻或重叠，因此可用于增长。
    - ListSelectionModel.MULTIPLE_INTERVAL_SELECTION - 在这种模式下，对于什么可以选择没有限制。
    Specified by:
    
    setSelectionMode在界面 ListSelectionModel
    
    异常
    
    IllegalArgumentException - 如果选择模式不是允许的模式之一
    
    另请参见：
    
    ListSelectionModel.getSelectionMode()
  - isSelectedIndex
```
public boolean isSelectedIndex(int index)
```
    如果选择了指定的索引，则返回true。
    
    Specified by:
    
    isSelectedIndex在界面 ListSelectionModel
  - isSelectionEmpty
```
public boolean isSelectionEmpty()
```
    如果没有选择索引，则返回true。
    
    Specified by:
    
    isSelectionEmpty中的 ListSelectionModel
  - addListSelectionListener
```
public void addListSelectionListener(ListSelectionListener l)
```
    将侦听器添加到每次发生更改选择时通知的列表。
    
    Specified by:
    
    addListSelectionListener在界面 ListSelectionModel
    
    参数
    
    l - ListSelectionListener
    
    另请参见：
    
    ListSelectionModel.removeListSelectionListener(javax.swing.event.ListSelectionListener) ， ListSelectionModel.setSelectionInterval(int, int) ， ListSelectionModel.addSelectionInterval(int, int) ， ListSelectionModel.removeSelectionInterval(int, int) ， ListSelectionModel.clearSelection() ， ListSelectionModel.insertIndexInterval(int, int, boolean) ， ListSelectionModel.removeIndexInterval(int, int)
  - removeListSelectionListener
```
public void removeListSelectionListener(ListSelectionListener l)
```
    从列表中删除一个侦听器，每次发生更改时都会通知该侦听器。
    
    Specified by:
    
    removeListSelectionListener在界面 ListSelectionModel
    
    参数
    
    l - ListSelectionListener
    
    另请参见：
    
    ListSelectionModel.addListSelectionListener(javax.swing.event.ListSelectionListener)
  - getListSelectionListeners
```
public ListSelectionListener[] getListSelectionListeners()
```
    返回在此 DefaultListSelectionModel上 DefaultListSelectionModel的所有列表选择侦听器的 DefaultListSelectionModel 。
    
    结果
    
    所有这个模型的 ListSelectionListener s或一个空数组，如果没有列表选择侦听器当前注册
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    addListSelectionListener(javax.swing.event.ListSelectionListener) ， removeListSelectionListener(javax.swing.event.ListSelectionListener)
  - fireValueChanged
```
protected void fireValueChanged(boolean isAdjusting)
```
    通知听众我们已经结束了一系列调整。
  - fireValueChanged
```
protected void fireValueChanged(int firstIndex,
                                int lastIndex)
```
    通知 ListSelectionListeners该选择的值，在闭区间 firstIndex ， lastIndex ，已经改变。
  - fireValueChanged
```
protected void fireValueChanged(int firstIndex,
                                int lastIndex,
                                boolean isAdjusting)
```
    参数
    
    firstIndex - 间隔中的第一个索引
    
    lastIndex - 间隔中的最后一个索引
    
    isAdjusting - 如果这是一系列调整的最终变化，则为true
    
    另请参见：
    
    EventListenerList
  - getListeners
```
public <T extends EventListener> T[] getListeners(类<T> listenerType)
```
    返回此模型当前注册为FooListener的所有对象的数组。 FooListener使用addFooListener 。
    您可以使用类文字指定listenerType参数，例如FooListener.class 。例如，您可以使用以下代码查询DefaultListSelectionModel实例m作为其列表选择侦听器：
```
  ListSelectionListener[] lsls = (ListSelectionListener[])(m.getListeners(ListSelectionListener.class)); 
```
    如果没有这样的侦听器存在，这个方法返回一个空数组。
    参数
    
    listenerType - 所请求的听众的类型; 此参数应指定从java.util.EventListener下降的java.util.EventListener
    
    结果
    
    在该模型上注册为 FooListener的所有对象的数组，如果没有添加此类侦听器，则为空数组
    
    异常
    
    ClassCastException - 如果 listenerType没有指定实现java.util.EventListener的类或 java.util.EventListener
    
    从以下版本开始：
    
    1.3
    
    另请参见：
    
    getListSelectionListeners()
  - setLeadAnchorNotificationEnabled
```
public void setLeadAnchorNotificationEnabled(boolean flag)
```
    设置leadAnchorNotificationEnabled标志的值。
    
    另请参见：
    
    isLeadAnchorNotificationEnabled()
  - isLeadAnchorNotificationEnabled
```
public boolean isLeadAnchorNotificationEnabled()
```
    返回leadAnchorNotificationEnabled标志的值。当leadAnchorNotificationEnabled为真时，模型将生成带有范围的通知事件，其中包含所有选择的更改以及引用和锚索引的更改。将标志设置为false会导致事件范围变窄，以便仅包含自上次更改以来已被选择或取消选中的元素。无论哪种方式，模型都会在内部继续保持领先和固定变量。默认值为true。
    注意：可以更改引脚或锚点，而不更改选择。通知这些更改通常很重要，例如需要在视图中更新新的线索或锚点时。因此，当更改默认值时请注意。
    
    结果
    
    的价值 leadAnchorNotificationEnabled旗
    
    另请参见：
    
    setLeadAnchorNotificationEnabled(boolean)
  - clearSelection
```
public void clearSelection()
```
    将选择更改为空集。如果这表示对当前选择的更改，则通知每个ListSelectionListener。
    
    Specified by:
    
    clearSelection在接口 ListSelectionModel
    
    另请参见：
    
    ListSelectionModel.addListSelectionListener(javax.swing.event.ListSelectionListener)
  - setSelectionInterval
```
public void setSelectionInterval(int index0,
                                 int index1)
```
    将选择更改为index0和index1之间。 index0不得少于或等于index1 。
    在SINGLE_SELECTION选择模式下，仅使用第二个索引。
    
    如果这表示对当前选择的更改，则通知每个ListSelectionListener更改。
    
    如果任一索引为-1 ，此方法不执行任何操作，无一例外返回。否则，如果任一索引小于-1 ，则抛出一个IndexOutOfBoundsException 。
    
    Specified by:
    
    setSelectionInterval在界面 ListSelectionModel
    
    参数
    
    index0 - 间隔的一端。
    
    index1 - 间隔的另一端
    
    异常
    
    IndexOutOfBoundsException - 如果任一指数小于 -1 （且指数 -1为 -1 ）
    
    另请参见：
    
    addListSelectionListener(javax.swing.event.ListSelectionListener)
  - addSelectionInterval
```
public void addSelectionInterval(int index0,
                                 int index1)
```
    将选择更改为当前选择的集合，以及index0和index1之间的索引。
    在SINGLE_SELECTION选择模式下，这相当于调用setSelectionInterval ，只使用第二个索引。在SINGLE_INTERVAL_SELECTION选择模式下，该方法的行为类似于setSelectionInterval ，除非给定的间隔与现有选择紧邻或重叠，因此可用于增长它。
    
    如果这表示对当前选择的更改，则通知每个ListSelectionListener更改。请注意， index0不必小于等于index1 。
    
    如果任一索引为-1 ，则此方法不执行任何操作并返回。否则，如果任一索引小于-1 ，则抛出IndexOutOfBoundsException 。
    
    Specified by:
    
    addSelectionInterval在界面 ListSelectionModel
    
    参数
    
    index0 - 间隔的一端。
    
    index1 - 间隔的另一端
    
    异常
    
    IndexOutOfBoundsException - 如果任一指数小于 -1 （且指数 -1为 -1 ）
    
    另请参见：
    
    addListSelectionListener(javax.swing.event.ListSelectionListener) ， setSelectionInterval(int, int)
  - removeSelectionInterval
```
public void removeSelectionInterval(int index0,
                                    int index1)
```
    将选择变为当前选择的设定差异和index0与index1之间的指数。 index0不一定要小于或等于index1 。
    在SINGLE_INTERVAL_SELECTION选择模式下，如果删除将产生两个不相交选择，则删除将通过更大的选择结束延长。例如，如果选择为0-10 ，并提供指数5,6 （按任何顺序），则所得的选择为0-4 。
    
    如果这表示对当前选择的更改，则通知每个ListSelectionListener更改。
    
    如果任一索引为-1 ，则此方法不执行任何操作，无一例外返回。否则，如果任一索引小于-1 ，则抛出一个IndexOutOfBoundsException 。
    
    Specified by:
    
    removeSelectionInterval在界面 ListSelectionModel
    
    参数
    
    index0 - 间隔的一端
    
    index1 - 间隔的另一端
    
    异常
    
    IndexOutOfBoundsException - 如果任一指数小于 -1 （既不是指数是 -1 ）
    
    另请参见：
    
    addListSelectionListener(javax.swing.event.ListSelectionListener)
  - insertIndexInterval
```
public void insertIndexInterval(int index,
                                int length,
                                boolean before)
```
    在索引之前/之后插入长度索引。如果索引处的值本身被选择，并且选择模式不是SINGLE_SELECTION，则将所有新插入的项目设置为选定的。否则让他们不选择。该方法通常被称为将选择模型与数据模型中的相应变化同步。
    
    Specified by:
    
    insertIndexInterval在界面 ListSelectionModel
  - removeIndexInterval
```
public void removeIndexInterval(int index0,
                                int index1)
```
    从选择模型中删除间隔index0，index1（包括）中的索引。这通常被称为将选择模型宽度与数据模型中的相应变化同步。注意（一如既往）index0不需要<= index1。
    
    Specified by:
    
    removeIndexInterval在接口 ListSelectionModel
  - setValueIsAdjusting
```
public void setValueIsAdjusting(boolean isAdjusting)
```
    设置valueIsAdjusting属性，其指示即将到来的选择更改是否应被视为单个更改的一部分。该属性的值用于初始化生成的ListSelectionEvent s的valueIsAdjusting属性。
    例如，如果选择是响应于用户拖动被更新，该属性可以被设置为true当拖动开始，并设置为false当拖动结束。在拖动期间，监听器接收到valueIsAdjusting属性设置为true 。拖动结束时，当更改完成时，监听器将收到一个值设置为false的事件。如果希望仅在更改完成后更新，则侦听器可以使用此模式。
    
    将此属性设置为true开始一系列将被视为单个更改的一部分的更改。当财产更改为false时，会发送一个事件，表征整个选择更改（如果有的话），事件的valueIsAdjusting属性设置为false 。
    
    Specified by:
    
    setValueIsAdjusting在界面 ListSelectionModel
    
    参数
    
    isAdjusting - 属性的新值
    
    另请参见：
    
    ListSelectionModel.getValueIsAdjusting() ， ListSelectionEvent.getValueIsAdjusting()
  - toString
```
public String toString()
```
    返回显示和标识此对象属性的字符串。
    
    重写：
    
    toString在 Object
    
    结果
    
    这个对象的 String表示
  - clone
```
public Object clone()
             throws CloneNotSupportedException
```
    返回具有相同选择的此选择模型的克隆。 listenerLists不重复。
    
    重写：
    
    clone在 Object
    
    结果
    
    这个实例的一个克隆。
    
    异常
    
    CloneNotSupportedException - 如果选择模型不同时（a）实现可克隆接口和（b）定义 clone方法。
    
    另请参见：
    
    Cloneable
  - getAnchorSelectionIndex
```
public int getAnchorSelectionIndex()
```
    从最近调用setSelectionInterval（），addSelectionInterval（）或removeSelectionInterval（）返回第一个索引参数。最近的index0被认为是“锚”，最近的index1被认为是“引导”。一些界面特别显示这些索引，例如Windows95显示带有虚线黄色轮廓的引导索引。
    
    Specified by:
    
    getAnchorSelectionIndex在界面 ListSelectionModel
    
    另请参见：
    
    ListSelectionModel.getLeadSelectionIndex() ， ListSelectionModel.setSelectionInterval(int, int) ， ListSelectionModel.addSelectionInterval(int, int)
  - getLeadSelectionIndex
```
public int getLeadSelectionIndex()
```
    将第二个索引参数从最近的调用返回给setSelectionInterval（），addSelectionInterval（）或removeSelectionInterval（）。
    
    Specified by:
    
    getLeadSelectionIndex在接口 ListSelectionModel
    
    另请参见：
    
    ListSelectionModel.getAnchorSelectionIndex() ， ListSelectionModel.setSelectionInterval(int, int) ， ListSelectionModel.addSelectionInterval(int, int)
  - setAnchorSelectionIndex
```
public void setAnchorSelectionIndex(int anchorIndex)
```
    设置锚选择索引，使所有选择值保持不变。如果leadAnchorNotificationEnabled为true，请发送覆盖旧锚点和新锚点的通知。
    
    Specified by:
    
    setAnchorSelectionIndex在界面 ListSelectionModel
    
    另请参见：
    
    getAnchorSelectionIndex() ， setLeadSelectionIndex(int)
  - moveLeadSelectionIndex
```
public void moveLeadSelectionIndex(int leadIndex)
```
    设置引导选择索引，保持所有选择值不变。如果leadAnchorNotificationEnabled为true，请发送覆盖旧的和新的引线单元的通知。
    
    参数
    
    leadIndex - 新的铅选择指数
    
    从以下版本开始：
    
    1.5
    
    另请参见：
    
    setAnchorSelectionIndex(int) ， setLeadSelectionIndex(int) ， getLeadSelectionIndex()
  - setLeadSelectionIndex
```
public void setLeadSelectionIndex(int leadIndex)
```
    设置引导选择索引，确保锚和新引线之间的值全部被选中或全部被取消选择。如果选择了锚索引处的值，首先清除范围[anchor，oldLeadIndex]中的所有值，然后选择范围[anchor，newLeadIndex]中的所有值，其中oldLeadIndex是旧的leadIndex，newLeadIndex是新的一。
    如果没有选择锚索引的值，则在旧范围内反向选择值并取消选择新值中的值，做同样的事情。
    
    为此更改生成单个事件并通知所有侦听器。为了在此事件中产生最小限制，请在单次传递中执行操作; 这样，广播的ListSelectionEvent里的第一个和最后一个索引将会引用由于这个方法而实际改变了值的单元格。如果相反，这个操作是在两个步骤中完成的，那么对选择状态的影响将是相同的，但是会产生两个事件，并且改变的值周围的界限将会更宽，包括首先被清除以后被设置的单元格。
    
    该方法可以在UI类的mouseDragged方法中使用来扩展选择。
    
    Specified by:
    
    setLeadSelectionIndex在界面 ListSelectionModel
    
    另请参见：
    
    getLeadSelectionIndex() ， setAnchorSelectionIndex(int)

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.

Class DefaultListSelectionModel

Field Summary

Fields inherited from interface javax.swing.ListSelectionModel

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

字段详细信息

listenerList

leadAnchorNotificationEnabled

构造方法详细信息

DefaultListSelectionModel

方法详细信息

getMinSelectionIndex

getMaxSelectionIndex

getValueIsAdjusting

getSelectionMode

setSelectionMode

isSelectedIndex

isSelectionEmpty

addListSelectionListener

removeListSelectionListener

getListSelectionListeners

fireValueChanged

fireValueChanged

fireValueChanged

getListeners

setLeadAnchorNotificationEnabled

isLeadAnchorNotificationEnabled

clearSelection

setSelectionInterval

addSelectionInterval

removeSelectionInterval

insertIndexInterval

removeIndexInterval

setValueIsAdjusting

toString

clone

getAnchorSelectionIndex

getLeadSelectionIndex

setAnchorSelectionIndex

moveLeadSelectionIndex

setLeadSelectionIndex