ListSelectionModel (Java Platform SE 8)

既知のすべての実装クラス:

DefaultListSelectionModel
```
public interface ListSelectionModel
```
固定のインデックスを持つ値のリストを表示するコンポーネントの、現在の選択状態を表します。選択状態は区間のセットとしてモデル化され、各区間は選択されたリスト要素の連続範囲を表します。選択された区間のセットを変更するメソッドはすべて、閉じた区間を表すindex0とindex1を1組とするインデックスをとります。つまり、区間にはindex0とindex1の両方が含まれます。

関連項目:

DefaultListSelectionModel

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static int`	`MULTIPLE_INTERVAL_SELECTION` selectionModeプロパティの値です。インデックスの連続範囲を1回に1つ以上選択します。
`static int`	`SINGLE_INTERVAL_SELECTION` selectionModeプロパティの値です。インデックスの連続範囲を1回に1つ選択します。
`static int`	`SINGLE_SELECTION` selectionModeプロパティの値です。リスト・インデックスを1回に1つ選択します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド抽象メソッド
修飾子と型	メソッドと説明
`void`	`addListSelectionListener(ListSelectionListener x)` 選択範囲の変更が通知されるリスナーをリストに追加します。
`void`	`addSelectionInterval(int index0, int index1)` 選択範囲を、現在の選択範囲と`index0`以上`index1`以下のインデックスの示す範囲との和集合に変更します。
`void`	`clearSelection()` 選択範囲を空のセットに変更します。
`int`	`getAnchorSelectionIndex()` setSelectionInterval()、addSelectionInterval()、またはremoveSelectionInterval()の直前の呼び出しから、最初のインデックス引数を返します。
`int`	`getLeadSelectionIndex()` setSelectionInterval()、addSelectionInterval()、またはremoveSelectionInterval()の直前の呼び出しから、2番目のインデックス引数を返します。
`int`	`getMaxSelectionIndex()` 最後に選択されたインデックスを返すか、選択範囲が空の場合に -1を返します。
`int`	`getMinSelectionIndex()` 最初に選択されたインデックスを返すか、選択範囲が空の場合に -1を返します。
`int`	`getSelectionMode()` 現在の選択モードを返します。
`boolean`	`getValueIsAdjusting()` 選択に一連の変更を適用中である場合は`true`を返します。
`void`	`insertIndexInterval(int index, int length, boolean before)` indexの前/後から始まるlengthインデックスを挿入します。
`boolean`	`isSelectedIndex(int index)` 指定のインデックスが選択されている場合にtrueを返します。
`boolean`	`isSelectionEmpty()` インデックスが選択されていない場合にtrueを返します。
`void`	`removeIndexInterval(int index0, int index1)` 選択モデルから、index0とindex1を両端として含む区間のインデックスを削除します。
`void`	`removeListSelectionListener(ListSelectionListener x)` 選択範囲の変更が通知されるリスナーをリストから削除します。
`void`	`removeSelectionInterval(int index0, int index1)` 選択範囲を、現在の選択範囲と`index0`以上`index1`以下のインデックスの示す範囲との差集合に変更します。
`void`	`setAnchorSelectionIndex(int index)` 選択範囲のアンカー・インデックスを設定します。
`void`	`setLeadSelectionIndex(int index)` 選択範囲のリード・インデックスを設定します。
`void`	`setSelectionInterval(int index0, int index1)` 選択範囲を`index0`以上`index1`以下に変更します。
`void`	`setSelectionMode(int selectionMode)` 選択モードを設定します。
`void`	`setValueIsAdjusting(boolean valueIsAdjusting)` 選択に対する複数の変更を1つの変更の一部であると見なすかどうかを指定する、`valueIsAdjusting`プロパティを設定します。

- フィールドの詳細
  - SINGLE_SELECTION
```
static final int SINGLE_SELECTION
```
    selectionModeプロパティの値です。リスト・インデックスを1回に1つ選択します。
    
    関連項目:
    
    setSelectionMode(int), 定数フィールド値
  - SINGLE_INTERVAL_SELECTION
```
static final int SINGLE_INTERVAL_SELECTION
```
    selectionModeプロパティの値です。インデックスの連続範囲を1回に1つ選択します。
    
    関連項目:
    
    setSelectionMode(int), 定数フィールド値
  - MULTIPLE_INTERVAL_SELECTION
```
static final int MULTIPLE_INTERVAL_SELECTION
```
    selectionModeプロパティの値です。インデックスの連続範囲を1回に1つ以上選択します。
    
    関連項目:
    
    setSelectionMode(int), 定数フィールド値
- メソッドの詳細
  - setSelectionInterval
```
void setSelectionInterval(int index0,
                          int index1)
```
    選択範囲をindex0以上index1以下に変更します。index0はindex1以下でなくてもかまいません。
    SINGLE_SELECTION選択モードでは、2番目のインデックスだけが使用されます。
    これによって現在の選択範囲が変更される場合には、各ListSelectionListenerに変更が通知されます。
    
    パラメータ:
    
    index0 - 範囲の一方の端の値。
    
    index1 - 範囲の他方の端の値
    
    関連項目:
    
    addListSelectionListener(javax.swing.event.ListSelectionListener)
  - addSelectionInterval
```
void addSelectionInterval(int index0,
                          int index1)
```
    選択範囲を、現在の選択範囲とindex0以上index1以下のインデックスの示す範囲との和集合に変更します。index0はindex1以下でなくてもかまいません。
    SINGLE_SELECTION選択モードでは、これはsetSelectionIntervalの呼び出しと同等で、2番目のインデックスだけが使用されます。SINGLE_INTERVAL_SELECTION選択モードでは、このメソッドは、指定された間隔が既存の選択範囲に隣接していたりオーバーラップしていたりしないかぎりsetSelectionIntervalと同様に動作するため、選択範囲を拡張する目的で使用できます。
    これによって現在の選択範囲が変更される場合には、各ListSelectionListenerに変更が通知されます。
    
    パラメータ:
    
    index0 - 範囲の一方の端の値。
    
    index1 - 範囲の他方の端の値
    
    関連項目:
    
    addListSelectionListener(javax.swing.event.ListSelectionListener), setSelectionInterval(int, int)
  - removeSelectionInterval
```
void removeSelectionInterval(int index0,
                             int index1)
```
    選択範囲を、現在の選択範囲とindex0以上index1以下のインデックスの示す範囲との差集合に変更します。index0はindex1以下でなくてもかまいません。
    SINGLE_INTERVAL_SELECTION選択モードでは、削除によって2つの不連続のセクションが生成される場合、削除範囲が選択範囲の末尾(値が大きいほうの端)まで拡張されます。たとえば選択範囲が0-10である場合、ユーザーが任意の順序でインデックス5,6を指定すると、結果として得られる選択範囲は0-4になります。
    これによって現在の選択範囲が変更される場合には、各ListSelectionListenerに変更が通知されます。
    
    パラメータ:
    
    index0 - 範囲の一方の端の値。
    
    index1 - 範囲の他方の端の値
    
    関連項目:
    
    addListSelectionListener(javax.swing.event.ListSelectionListener)
  - getMinSelectionIndex
```
int getMinSelectionIndex()
```
    最初に選択されたインデックスを返すか、選択範囲が空の場合に -1を返します。
  - getMaxSelectionIndex
```
int getMaxSelectionIndex()
```
    最後に選択されたインデックスを返すか、選択範囲が空の場合に -1を返します。
  - isSelectedIndex
```
boolean isSelectedIndex(int index)
```
    指定のインデックスが選択されている場合にtrueを返します。
  - getAnchorSelectionIndex
```
int getAnchorSelectionIndex()
```
    setSelectionInterval()、addSelectionInterval()、またはremoveSelectionInterval()の直前の呼び出しから、最初のインデックス引数を返します。直前のindex0が「アンカー」、直前のindex1が「リード」と見なされます。インタフェースによっては、これらのインデックスが特別な方法で表示されます。たとえばWindows95では、リード・インデックスが黄色い点線の輪郭で表示されます。
    
    関連項目:
    
    getLeadSelectionIndex(), setSelectionInterval(int, int), addSelectionInterval(int, int)
  - setAnchorSelectionIndex
```
void setAnchorSelectionIndex(int index)
```
    選択範囲のアンカー・インデックスを設定します。
    
    関連項目:
    
    getAnchorSelectionIndex()
  - getLeadSelectionIndex
```
int getLeadSelectionIndex()
```
    setSelectionInterval()、addSelectionInterval()、またはremoveSelectionInterval()の直前の呼び出しから、2番目のインデックス引数を返します。
    
    関連項目:
    
    getAnchorSelectionIndex(), setSelectionInterval(int, int), addSelectionInterval(int, int)
  - setLeadSelectionIndex
```
void setLeadSelectionIndex(int index)
```
    選択範囲のリード・インデックスを設定します。
    
    関連項目:
    
    getLeadSelectionIndex()
  - clearSelection
```
void clearSelection()
```
    選択範囲を空のセットに変更します。これによって現在の選択範囲が変更される場合には、各ListSelectionListenerに通知します。
    
    関連項目:
    
    addListSelectionListener(javax.swing.event.ListSelectionListener)
  - isSelectionEmpty
```
boolean isSelectionEmpty()
```
    インデックスが選択されていない場合にtrueを返します。
  - insertIndexInterval
```
void insertIndexInterval(int index,
                         int length,
                         boolean before)
```
    indexの前/後から始まるlengthインデックスを挿入します。通常、このメソッドは、データ・モデル内の対応する変更に選択モデルを同期させるために呼び出されます。
  - removeIndexInterval
```
void removeIndexInterval(int index0,
                         int index1)
```
    選択モデルから、index0とindex1を両端として含む区間のインデックスを削除します。通常、このメソッドは、データ・モデル内の対応する変更に選択モデルを同期させるために呼び出されます。
  - setValueIsAdjusting
```
void setValueIsAdjusting(boolean valueIsAdjusting)
```
    選択に対する複数の変更を1つの変更の一部であると見なすかどうかを指定する、valueIsAdjustingプロパティを設定します。このプロパティの値を使って、生成されたListSelectionEventのvalueIsAdjustingプロパティを初期化できます。
    たとえば、ユーザーのドラッグに応じて選択が更新される場合、このプロパティの値は、ドラッグの開始時にはtrue、終了時にはfalseに設定できます。ドラッグ中、リスナーは、valueIsAdjustingプロパティの値がtrueに設定されたイベントを受信します。ドラッグの終了時、変更がファイナライズされると、リスナーが受信するイベントのプロパティの値はfalseになります。リスナーは、変更がファイナライズされたときにだけ更新を実行する場合に、このパターンを使用できます。
    このプロパティの値をtrueに設定すると、1回の変更の一部と見なされる一連の変更がスタートします。プロパティの値をfalseに戻すと、選択全体の変更(選択があった場合)を記述する、valueIsAdjustingプロパティの値がfalseに設定されたイベントが送信されます。
    
    パラメータ:
    
    valueIsAdjusting - プロパティの新しい値
    
    関連項目:
    
    getValueIsAdjusting(), ListSelectionEvent.getValueIsAdjusting()
  - getValueIsAdjusting
```
boolean getValueIsAdjusting()
```
    選択に一連の変更を適用中である場合はtrueを返します。
    
    戻り値:
    
    選択に一連の変更を適用中である場合はtrue
    
    関連項目:
    
    setValueIsAdjusting(boolean)
  - setSelectionMode
```
void setSelectionMode(int selectionMode)
```
    選択モードを設定します。使用可能な選択モードは、次のリストのとおりです。
    - ListSelectionModel.SINGLE_SELECTION - 1回に1つのリスト・インデックスのみを選択できます。このモードでは、setSelectionIntervalメソッドとaddSelectionIntervalメソッドは同等であり、どちらも現在の選択を、2番目の引数で表されるインデックス(「リード・インデックス」)で置き換えます。
    - ListSelectionModel.SINGLE_INTERVAL_SELECTION - 1回に1つの連続区間のみを選択できます。このモードでは、addSelectionIntervalは、指定された間隔が既存の選択範囲に隣接していたりオーバーラップしていたりしないかぎりsetSelectionIntervalと同様に動作する(現在の選択を置き換える)ため、選択範囲を拡張するために使用できます。
    - ListSelectionModel.MULTIPLE_INTERVAL_SELECTION - このモードでは、選択対象に制限はありません。
    例外:
    
    IllegalArgumentException - 許可された選択モードでない場合
    
    関連項目:
    
    getSelectionMode()
  - getSelectionMode
```
int getSelectionMode()
```
    現在の選択モードを返します。
    
    戻り値:
    
    現在の選択モード
    
    関連項目:
    
    setSelectionMode(int)
  - addListSelectionListener
```
void addListSelectionListener(ListSelectionListener x)
```
    選択範囲の変更が通知されるリスナーをリストに追加します。
    
    パラメータ:
    
    x - ListSelectionListener
    
    関連項目:
    
    removeListSelectionListener(javax.swing.event.ListSelectionListener), setSelectionInterval(int, int), addSelectionInterval(int, int), removeSelectionInterval(int, int), clearSelection(), insertIndexInterval(int, int, boolean), removeIndexInterval(int, int)
  - removeListSelectionListener
```
void removeListSelectionListener(ListSelectionListener x)
```
    選択範囲の変更が通知されるリスナーをリストから削除します。
    
    パラメータ:
    
    x - ListSelectionListener
    
    関連項目:
    
    addListSelectionListener(javax.swing.event.ListSelectionListener)

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

インタフェースListSelectionModel

フィールドのサマリー

メソッドのサマリー

フィールドの詳細

SINGLE_SELECTION

SINGLE_INTERVAL_SELECTION

MULTIPLE_INTERVAL_SELECTION

メソッドの詳細

setSelectionInterval

addSelectionInterval

removeSelectionInterval

getMinSelectionIndex

getMaxSelectionIndex

isSelectedIndex

getAnchorSelectionIndex

setAnchorSelectionIndex

getLeadSelectionIndex

setLeadSelectionIndex

clearSelection

isSelectionEmpty

insertIndexInterval

removeIndexInterval

setValueIsAdjusting

getValueIsAdjusting

setSelectionMode

getSelectionMode

addListSelectionListener

removeListSelectionListener