ListSelectionModel (Java 2 プラットフォーム SE v1.4.0)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2
Platform
Std. Ed. v1.4.0

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

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

public static final int SINGLE_SELECTION

selectionMode プロパティの値です。リストインデックスを 1 回に 1 つ選択します。

関連項目:: setSelectionMode(int), 定数フィールド値

SINGLE_INTERVAL_SELECTION

public static final int SINGLE_INTERVAL_SELECTION

selectionMode プロパティの値です。インデックスの連続範囲を 1 回に 1 つ選択します。

関連項目:: setSelectionMode(int), 定数フィールド値

MULTIPLE_INTERVAL_SELECTION

public static final int MULTIPLE_INTERVAL_SELECTION

selectionMode プロパティの値です。インデックスの連続範囲を 1 回に 1 つ以上選択します。

関連項目:: setSelectionMode(int), 定数フィールド値

メソッドの詳細

setSelectionInterval

public void setSelectionInterval(int index0,
                                 int index1)

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

パラメータ:: index0 - 区間の一方の端の値; index1 - 区間の他方の端の値
関連項目:: addListSelectionListener(javax.swing.event.ListSelectionListener)

addSelectionInterval

public void addSelectionInterval(int index0,
                                 int index1)

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

パラメータ:: index0 - 区間の一方の端の値; index1 - 区間の他方の端の値
関連項目:: addListSelectionListener(javax.swing.event.ListSelectionListener)

removeSelectionInterval

public void removeSelectionInterval(int index0,
                                    int index1)

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

パラメータ:: index0 - 区間の一方の端の値; index1 - 区間の他方の端の値
関連項目:: addListSelectionListener(javax.swing.event.ListSelectionListener)

getMinSelectionIndex

public int getMinSelectionIndex()

最初に選択されたインデックスを返すか、選択範囲が空の場合に -1 を返します。

getMaxSelectionIndex

public int getMaxSelectionIndex()

最後に選択されたインデックスを返すか、選択範囲が空の場合に -1 を返します。

isSelectedIndex

public boolean isSelectedIndex(int index)

指定のインデックスが選択されている場合に true を返します。

getAnchorSelectionIndex

public int getAnchorSelectionIndex()

setSelectionInterval()、addSelectionInterval()、または removeSelectionInterval() の直前の呼び出しから、最初のインデックス引数を返します。直前の index0 が「アンカー」、直前の index1 が「リード」と見なされます。インタフェースによっては、これらのインデックスが特別に表示されます。たとえば Windows95 では、リードインデックスが黄色い点線の輪郭で表示されます。

関連項目:: getLeadSelectionIndex(), setSelectionInterval(int, int), addSelectionInterval(int, int)

setAnchorSelectionIndex

public void setAnchorSelectionIndex(int index)

選択範囲のアンカーインデックスを設定します。

関連項目:: getAnchorSelectionIndex()

getLeadSelectionIndex

public int getLeadSelectionIndex()

setSelectionInterval()、addSelectionInterval()、または removeSelectionInterval() の直前の呼び出しから、2 番目のインデックス引数を返します。

関連項目:: getAnchorSelectionIndex(), setSelectionInterval(int, int), addSelectionInterval(int, int)

setLeadSelectionIndex

public void setLeadSelectionIndex(int index)

選択範囲のリードインデックスを設定します。

関連項目:: getLeadSelectionIndex()

clearSelection

public void clearSelection()

選択範囲を空のセットに変更します。これによって現在の選択範囲が変更される場合には、各 ListSelectionListener に通知します。

関連項目:: addListSelectionListener(javax.swing.event.ListSelectionListener)

isSelectionEmpty

public boolean isSelectionEmpty()

インデックスが選択されていない場合に true を返します。

insertIndexInterval

public void insertIndexInterval(int index,
                                int length,
                                boolean before)

index の前/後から始まる length インデックスを挿入します。通常、このメソッドは、データモデル内の対応する変更に選択モデルを同期させるために呼び出されます。

removeIndexInterval

public void removeIndexInterval(int index0,
                                int index1)

選択モデルから、index0 と index1 を両端として含む区間のインデックスを削除します。通常、このメソッドは、データモデル内の対応する変更に選択モデルを同期させるために呼び出されます。

setValueIsAdjusting

public void setValueIsAdjusting(boolean valueIsAdjusting)

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

パラメータ:: valueIsAdjusting - プロパティの新しい値
関連項目:: getValueIsAdjusting()

getValueIsAdjusting

public boolean getValueIsAdjusting()

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

戻り値:: 値が現在調整されている場合は true
関連項目:: setValueIsAdjusting(boolean)

setSelectionMode

public void setSelectionMode(int selectionMode)

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

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

関連項目:: getSelectionMode()

getSelectionMode

public int getSelectionMode()

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

戻り値:: selectionMode プロパティの値
関連項目:: setSelectionMode(int)

addListSelectionListener

public void addListSelectionListener(ListSelectionListener x)

選択範囲の変更が通知されるリスナーをリストに追加します。

関連項目:: removeListSelectionListener(javax.swing.event.ListSelectionListener), setSelectionInterval(int, int), addSelectionInterval(int, int), removeSelectionInterval(int, int), clearSelection(), insertIndexInterval(int, int, boolean), removeIndexInterval(int, int)

removeListSelectionListener

public void removeListSelectionListener(ListSelectionListener x)

選択範囲の変更が通知されるリスナーをリストから削除します。

関連項目:: addListSelectionListener(javax.swing.event.ListSelectionListener)

概要