モジュール javafx.controls
パッケージ javafx.scene.control

クラスSingleSelectionModel<T>

  • 型パラメータ:
    T - 選択できるコントロールに含まれているアイテムのタイプ。

    public abstract class SingleSelectionModel<T>
extends SelectionModel<T>
    常に単一のインデックスのみが選択されるという要件を適用するSelectionModel。 このクラスは、プラガブル選択モデルを許可し、複数選択を許可しないコントロールのために存在します。 例として、ChoiceBoxコントロールがあげられます。 逆に、他のほとんどのコントロール(ListView、TreeView、TableViewなど)では、MultipleSelectionModelの実装が必要です(ただし、MultipleSelectionModelでも、selectionModeプロパティで単一選択を設定できます)。
    導入されたバージョン:
    JavaFX 2.0
    関連項目:
    SelectionModel、MultipleSelectionModel、SelectionMode

    • コンストラクタのサマリー

      コンストラクタ 
      コンストラクタ 説明
      SingleSelectionModel​()
      デフォルトのSingleSelectionModelインスタンスを作成します。

    • メソッドのサマリー

      すべてのメソッド インスタンス・メソッド 抽象メソッド 具象メソッド 
      修飾子と型 メソッド 説明
      void clearAndSelect​(int index)
      SingleSelectionModelでは、一度に1つの選択のみ許可されるため、このメソッドは機能的にはselect(index)の呼出しと同等です。
      void clearSelection​()
      すべての選択されたインデックスの選択モデルをクリアします。
      void clearSelection​(int index)
      指定されたインデックスの選択をクリアします(現在選択されている場合)。
      protected abstract int getItemCount​()
      選択モデルで使用可能なアイテムの数を取得します。
      protected abstract T getModelItem​(int index)
      特定のインデックスに関連付けられているデータ・モデル・アイテムを取得します。
      boolean isEmpty​()
      このメソッドは、選択されているインデックス/アイテムがあるかどうかをテストするために使用できます。
      boolean isSelected​(int index)
      このメソッドは、指定されたインデックスがこのSingleSelectionModelで現在選択されているインデックスである場合にtrueを返します
      void select​(int index)
      指定されたインデックスを選択します。
      void select​(T obj)
      基礎となるデータ・モデルにおける指定されたオブジェクトの最初のインスタンスのインデックスを選択します。
      void selectFirst​()
      最初のインデックスを選択します。
      void selectLast​()
      最後のインデックスを選択します。
      void selectNext​()
      次のインデックスを選択します。
      void selectPrevious​()
      前のインデックスを選択します。

    • コンストラクタの詳細

      • SingleSelectionModel

        public SingleSelectionModel​()
        デフォルトのSingleSelectionModelインスタンスを作成します。

    • メソッドの詳細

      • clearSelection

        public void clearSelection​()

        すべての選択されたインデックスの選択モデルをクリアします。

        定義:
        clearSelection 、クラス: SelectionModel<T>

      • clearSelection

        public void clearSelection​(int index)
        指定されたインデックスの選択をクリアします(現在選択されている場合)。
        定義:
        clearSelection 、クラス: SelectionModel<T>
        パラメータ:
        index - 選択を解除する選択されたアイテム。

      • isEmpty

        public boolean isEmpty​()
        このメソッドは、選択されているインデックス/アイテムがあるかどうかをテストするために使用できます。 選択されたアイテムがない場合はtrueを返し、ある場合はfalseを返します。
        定義:
        isEmpty 、クラス: SelectionModel<T>
        戻り値:
        選択されたアイテムがない場合はtrueを返し、ある場合はfalseを返します。

      • isSelected

        public boolean isSelected​(int index)

        このメソッドは、指定されたインデックスがこのSingleSelectionModelで現在選択されているインデックスである場合にtrueを返します

        定義:
        isSelected 、クラス: SelectionModel<T>
        パラメータ:
        index - 現在選択されているかどうかをチェックするインデックス。
        戻り値:
        指定されたインデックスが選択されている場合はtrue、それ以外の場合はfalse。

      • clearAndSelect

        public void clearAndSelect​(int index)
        SingleSelectionModelでは、一度に1つの選択のみ許可されるため、このメソッドは機能的にはselect(index)の呼出しと同等です。
        定義:
        clearAndSelect 、クラス: SelectionModel<T>
        パラメータ:
        index - この選択モデルで唯一選択されたインデックスにする必要があるインデックス。

      • select

        public void select​(T obj)
        基礎となるデータ・モデルにおける指定されたオブジェクトの最初のインスタンスのインデックスを選択します。 SingleSelectionModelでサポートされるのは、一度に1つのインデックスの選択のみであるため、これにより、前に選択したインデックスが選択解除されます。
        定義:
        select 、クラス: SelectionModel<T>
        パラメータ:
        obj - 基礎となるデータ・モデルで選択を試みるオブジェクト。

      • select

        public void select​(int index)
        指定されたインデックスを選択します。 SingleSelectionModelでサポートされるのは、一度に1つのインデックスの選択のみであるため、これにより、前に選択したインデックスが選択解除されます。
        定義:
        select 、クラス: SelectionModel<T>
        パラメータ:
        index - 選択モデルで選択するアイテムの位置。

      • selectPrevious

        public void selectPrevious​()
        前のインデックスを選択します。 SingleSelectionModelでサポートされるのは、一度に1つのインデックスの選択のみであるため、これにより、前に選択したインデックスが選択解除されます。
        定義:
        selectPrevious 、クラス: SelectionModel<T>

      • selectNext

        public void selectNext​()
        次のインデックスを選択します。 SingleSelectionModelでサポートされるのは、一度に1つのインデックスの選択のみであるため、これにより、前に選択したインデックスが選択解除されます。
        定義:
        selectNext 、クラス: SelectionModel<T>

      • selectFirst

        public void selectFirst​()
        最初のインデックスを選択します。 SingleSelectionModelでサポートされるのは、一度に1つのインデックスの選択のみであるため、これにより、前に選択したインデックスが選択解除されます。
        定義:
        selectFirst 、クラス: SelectionModel<T>

      • selectLast

        public void selectLast​()
        最後のインデックスを選択します。 SingleSelectionModelでサポートされるのは、一度に1つのインデックスの選択のみであるため、これにより、前に選択したインデックスが選択解除されます。
        定義:
        selectLast 、クラス: SelectionModel<T>

      • getModelItem

        protected abstract T getModelItem​(int index)
        特定のインデックスに関連付けられているデータ・モデル・アイテムを取得します。
        パラメータ:
        index - 基礎となるデータ・モデルにおけるアイテムの位置。
        戻り値:
        指定されたインデックスに存在するアイテム。

      • getItemCount

        protected abstract int getItemCount​()
        選択モデルで使用可能なアイテムの数を取得します。 アイテムの数が動的に変化する可能性がある場合、アイテムの変化に応じてアイテムを選択または選択解除する処理は、SingleSelectionModelの具象実装で行う必要があります。
        戻り値:
        0以上の数。