javax.swing
インタフェース ListSelectionModel

既知の実装クラスの一覧:

DefaultListSelectionModel

public interface ListSelectionModel

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

関連項目:

DefaultListSelectionModel

フィールドの概要

static int	MULTIPLE_INTERVAL_SELECTION selectionMode プロパティの値です。
static int	SINGLE_INTERVAL_SELECTION selectionMode プロパティの値です。
static int	SINGLE_SELECTION selectionMode プロパティの値です。

メソッドの概要

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) このプロパティは、モデルの値に適用されつつある変更が単一のイベントと考えられる場合に true になります。

フィールドの詳細

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 以下に変更します。これによって現在の選択範囲が変更される場合には、各 ListSelectionListener に通知します。ただし、index0 は index1 以下でなくてもかまいません。

パラメータ:

index0 - 区間の一方の端の値

index1 - 区間の他方の端の値

関連項目:

addListSelectionListener(javax.swing.event.ListSelectionListener)

addSelectionInterval

void addSelectionInterval(int index0,
                          int index1)

選択範囲を、現在の選択範囲と index0 以上 index1 以下のインデックスの示す範囲との和集合に変更します。これによって現在の選択範囲が変更される場合には、各 ListSelectionListener に通知します。ただし、index0 は index1 以下でなくてもかまいません。

パラメータ:

index0 - 区間の一方の端の値

index1 - 区間の他方の端の値

関連項目:

addListSelectionListener(javax.swing.event.ListSelectionListener)

removeSelectionInterval

void removeSelectionInterval(int index0,
                             int index1)

選択範囲を、現在の選択範囲と index0 以上 index1 以下のインデックスの示す範囲との差集合に変更します。これによって現在の選択範囲が変更される場合には、各 ListSelectionListener に通知します。ただし、index0 は index1 以下でなくてもかまいません。

パラメータ:

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)

このプロパティは、モデルの値に適用されつつある変更が単一のイベントと考えられる場合に true になります。たとえば、モデルがユーザのドラッグに応じて更新されている場合、valueIsAdjusting プロパティの値は、ドラッグが開始されたときに true、ドラッグが終了したときに false に設定されます。常に中間の値をすべて処理するのではなく、変更がファイナライズされた場合にだけ、このプロパティによってリスナーの更新が可能になります。

パラメータ:

valueIsAdjusting - プロパティの新しい値

関連項目:

getValueIsAdjusting()

getValueIsAdjusting

boolean getValueIsAdjusting()

値が一連の変更を受けている場合に true を返します。

戻り値:

値が現在調整されている場合は true

関連項目:

setValueIsAdjusting(boolean)

setSelectionMode

void setSelectionMode(int selectionMode)

選択モードを設定します。selectionMode の値は次のとおりです。

• SINGLE_SELECTION リストインデックスを 1 回に 1 つだけ選択できる。このモードでは、setSelectionInterval メソッドと addSelectionInterval メソッドは同等で、2 番目のインデックス引数 (「リードインデックス」) だけが使用される。
• SINGLE_INTERVAL_SELECTION 連続するインデックス区間を 1 回に 1 つ選択できる。このモードでは、setSelectionInterval メソッドと addSelectionInterval メソッドは同等。
• MULTIPLE_INTERVAL_SELECTION このモードでは、選択対象に制限はない。

関連項目:

getSelectionMode()

getSelectionMode

int getSelectionMode()

現在の選択モードを返します。

戻り値:

selectionMode プロパティの値

関連項目:

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)