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

クラスComboBoxBase<T>

  • 型パラメータ:
    T - T - このComboBoxに対して選択されているか、その他の方法で入力されている値の型。
    すべての実装されたインタフェース:
    Styleable, EventTarget, Skinnable
    直系の既知のサブクラス:
    ColorPicker, ComboBox, DatePicker

    public abstract class ComboBoxBase<T>
extends Control
    ComboBox形式のコントロールの抽象ベース・クラス。 通常、ComboBoxにはボタンがあり、クリックすると、(実装に応じて)ユーザーが1つ以上の値を選択できるなんらかの手段がポップアップします。 このベース・クラスでは、show()メソッドおよびhide()メソッドが呼び出されたときの動作に関して何も想定しませんが、一般的に、この結果、ポップアップまたはダイアログが表示され、ユーザーが要求された情報を指定できるようになります。

    ComboBoxには、現在のユーザー入力を表すvalueプロパティがあります。 これはドロップダウン・リストからの選択に基づく場合や、ComboBoxがeditableであるときにはユーザー入力からのものである場合があります。

    editableであるComboBoxは、他に使用できるオプションがない場合に、エンド・ユーザーが値を入力できるなんらかの手段を提供します。 たとえば、ComboBoxの実装において、編集可能なComboBoxでTextFieldを提供して値を入力できるようにします。 前述のように、ユーザーが(一般的には[Enter]キーボード・キーを押して)テキスト入力をテキスト・フィールドでコミットすると、valueプロパティが更新されます。

    このクラスと、たとえばComboBoxとを分離する目的は、アイテムのリストを必ずしもポップアップしないComboBoxに似たコントロールを使用できるようにすることです。 その他の実装の例として、カラー・ピッカーやカレンダ・ピッカーなどがあります。ComboBoxクラスでは、デフォルトの最も想定される実装を提供します。 詳細は、そのクラスのjavadocを参照してください。

    導入されたバージョン:
    JavaFX 2.1
    関連項目:
    ComboBox

    • プロパティの詳細

      • value

        public ObjectProperty<T> valueProperty
        このComboBoxの値は、入力が編集可能でない場合は選択項目として、編集可能な場合は最近のユーザー・アクション(ユーザーが入力した値または最後の選択項目)として定義されます。
        関連項目:
        getValue()、setValue(T)

      • editable

        public BooleanProperty editableProperty
        ComboBoxでユーザー入力を許可するかどうかを指定します。 editableがtrueの場合、ComboBoxにはユーザーが入力できるテキスト入力領域が用意されます。 この入力はその後、valueプロパティを介して使用できます。

        editableプロパティを変更すると、valueプロパティがその他の関連する状態とともにリセットされることに注意してください。

        関連項目:
        isEditable()、setEditable(boolean)

      • showing

        public ReadOnlyBooleanProperty showingProperty
        ComboBoxポップアップの現在の状態および現在画面に表示されているかどうか(ただし、他のウィンドウの後ろに隠れている可能性があります)を表します。
        関連項目:
        isShowing()

      • promptText

        public final StringProperty promptTextProperty
        表示するComboBoxプロンプト・テキスト、またはプロンプト・テキストを表示しない場合はnull。 プロンプト・テキストは、どのような状況でも表示されるわけではなく、いつpromptTextが表示されるかを明確にするComboBoxBaseのサブクラスに依存します。 たとえば、ほとんどの場合、コンボ・ボックスが編集不可のときにプロンプト・テキストが表示されることはありません(つまり、プロンプト・テキストは、ユーザー入力がテキスト入力によって許可されているときにのみ表示されます)。
        関連項目:
        getPromptText()、setPromptText(String)

      • armed

        public BooleanProperty armedProperty
        マウスを放すとComboBox show()メソッドが起動するように、ComboBoxが作動準備完了していることを示します。 これは、押下とは微妙に異なります。 押下は、ノード上でマウスが押され、まだ放されていないことを示します。一方、armでは、マウスが実際にComboBox上に置かれて押されているかどうかも考慮されます。
        関連項目:
        isArmed()

      • onAction

        public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty
        ComboBoxのvalueプロパティが変更されると常に起動されるComboBoxアクション。 これは、ユーザーがポップアップ・リストまたはダイアログでアイテムを選択したときや、editableであるComboBoxの場合にはユーザー自身が(TextFieldまたは他の入力メカニズムを使用して)入力を提供したときに、valueプロパティがプログラムで変更される場合があるためです。
        関連項目:
        getOnAction()、setOnAction(EventHandler)

    • フィールドの詳細

      • ON_SHOWING

        public static final EventType<Event> ON_SHOWING

        ユーザーがComboBoxをクリックするか、または対話した後、ComboBoxがポップアップ/表示を表示する前に呼び出されます。

        導入されたバージョン:
        JavaFX 2.2

      • ON_SHOWN

        public static final EventType<Event> ON_SHOWN

        ComboBoxがポップアップ/表示を表示した後に呼び出されます。

        導入されたバージョン:
        JavaFX 2.2

      • ON_HIDING

        public static final EventType<Event> ON_HIDING

        ComboBoxポップアップ/表示が非表示になると呼び出されます。

        導入されたバージョン:
        JavaFX 2.2

      • ON_HIDDEN

        public static final EventType<Event> ON_HIDDEN

        ComboBoxポップアップ/表示が非表示になったときに呼び出されます。

        導入されたバージョン:
        JavaFX 2.2

    • コンストラクタの詳細

      • ComboBoxBase

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

    • メソッドの詳細

      • valueProperty

        public ObjectProperty<T> valueProperty​()
        このComboBoxの値は、入力が編集可能でない場合は選択項目として、編集可能な場合は最近のユーザー・アクション(ユーザーが入力した値または最後の選択項目)として定義されます。
        関連項目:
        getValue()、setValue(T)

      • setValue

        public final void setValue​(T value)
        プロパティvalueの値を設定します。
        プロパティの説明:
        このComboBoxの値は、入力が編集可能でない場合は選択項目として、編集可能な場合は最近のユーザー・アクション(ユーザーが入力した値または最後の選択項目)として定義されます。

      • getValue

        public final T getValue​()
        プロパティvalueの値を取得します。
        プロパティの説明:
        このComboBoxの値は、入力が編集可能でない場合は選択項目として、編集可能な場合は最近のユーザー・アクション(ユーザーが入力した値または最後の選択項目)として定義されます。

      • editableProperty

        public BooleanProperty editableProperty​()
        ComboBoxでユーザー入力を許可するかどうかを指定します。 editableがtrueの場合、ComboBoxにはユーザーが入力できるテキスト入力領域が用意されます。 この入力はその後、valueプロパティを介して使用できます。

        editableプロパティを変更すると、valueプロパティがその他の関連する状態とともにリセットされることに注意してください。

        関連項目:
        isEditable()、setEditable(boolean)

      • setEditable

        public final void setEditable​(boolean value)
        プロパティeditableの値を設定します。
        プロパティの説明:
        ComboBoxでユーザー入力を許可するかどうかを指定します。 editableがtrueの場合、ComboBoxにはユーザーが入力できるテキスト入力領域が用意されます。 この入力はその後、valueプロパティを介して使用できます。

        editableプロパティを変更すると、valueプロパティがその他の関連する状態とともにリセットされることに注意してください。

      • isEditable

        public final boolean isEditable​()
        プロパティeditableの値を取得します。
        プロパティの説明:
        ComboBoxでユーザー入力を許可するかどうかを指定します。 editableがtrueの場合、ComboBoxにはユーザーが入力できるテキスト入力領域が用意されます。 この入力はその後、valueプロパティを介して使用できます。

        editableプロパティを変更すると、valueプロパティがその他の関連する状態とともにリセットされることに注意してください。

      • showingProperty

        public ReadOnlyBooleanProperty showingProperty​()
        ComboBoxポップアップの現在の状態および現在画面に表示されているかどうか(ただし、他のウィンドウの後ろに隠れている可能性があります)を表します。
        関連項目:
        isShowing()

      • isShowing

        public final boolean isShowing​()
        プロパティshowingの値を取得します。
        プロパティの説明:
        ComboBoxポップアップの現在の状態および現在画面に表示されているかどうか(ただし、他のウィンドウの後ろに隠れている可能性があります)を表します。

      • promptTextProperty

        public final StringProperty promptTextProperty​()
        表示するComboBoxプロンプト・テキスト、またはプロンプト・テキストを表示しない場合はnull。 プロンプト・テキストは、どのような状況でも表示されるわけではなく、いつpromptTextが表示されるかを明確にするComboBoxBaseのサブクラスに依存します。 たとえば、ほとんどの場合、コンボ・ボックスが編集不可のときにプロンプト・テキストが表示されることはありません(つまり、プロンプト・テキストは、ユーザー入力がテキスト入力によって許可されているときにのみ表示されます)。
        関連項目:
        getPromptText()、setPromptText(String)

      • getPromptText

        public final String getPromptText​()
        プロパティpromptTextの値を取得します。
        プロパティの説明:
        表示するComboBoxプロンプト・テキスト、またはプロンプト・テキストを表示しない場合はnull。 プロンプト・テキストは、どのような状況でも表示されるわけではなく、いつpromptTextが表示されるかを明確にするComboBoxBaseのサブクラスに依存します。 たとえば、ほとんどの場合、コンボ・ボックスが編集不可のときにプロンプト・テキストが表示されることはありません(つまり、プロンプト・テキストは、ユーザー入力がテキスト入力によって許可されているときにのみ表示されます)。

      • setPromptText

        public final void setPromptText​(String value)
        プロパティpromptTextの値を設定します。
        プロパティの説明:
        表示するComboBoxプロンプト・テキスト、またはプロンプト・テキストを表示しない場合はnull。 プロンプト・テキストは、どのような状況でも表示されるわけではなく、いつpromptTextが表示されるかを明確にするComboBoxBaseのサブクラスに依存します。 たとえば、ほとんどの場合、コンボ・ボックスが編集不可のときにプロンプト・テキストが表示されることはありません(つまり、プロンプト・テキストは、ユーザー入力がテキスト入力によって許可されているときにのみ表示されます)。

      • armedProperty

        public BooleanProperty armedProperty​()
        マウスを放すとComboBox show()メソッドが起動するように、ComboBoxが作動準備完了していることを示します。 これは、押下とは微妙に異なります。 押下は、ノード上でマウスが押され、まだ放されていないことを示します。一方、armでは、マウスが実際にComboBox上に置かれて押されているかどうかも考慮されます。
        関連項目:
        isArmed()

      • isArmed

        public final boolean isArmed​()
        プロパティarmedの値を取得します。
        プロパティの説明:
        マウスを放すとComboBox show()メソッドが起動するように、ComboBoxが作動準備完了していることを示します。 これは、押下とは微妙に異なります。 押下は、ノード上でマウスが押され、まだ放されていないことを示します。一方、armでは、マウスが実際にComboBox上に置かれて押されているかどうかも考慮されます。

      • onActionProperty

        public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty​()
        ComboBoxのvalueプロパティが変更されると常に起動されるComboBoxアクション。 これは、ユーザーがポップアップ・リストまたはダイアログでアイテムを選択したときや、editableであるComboBoxの場合にはユーザー自身が(TextFieldまたは他の入力メカニズムを使用して)入力を提供したときに、valueプロパティがプログラムで変更される場合があるためです。
        関連項目:
        getOnAction()、setOnAction(EventHandler)

      • setOnAction

        public final void setOnAction​(EventHandler<ActionEvent> value)
        プロパティonActionの値を設定します。
        プロパティの説明:
        ComboBoxのvalueプロパティが変更されると常に起動されるComboBoxアクション。 これは、ユーザーがポップアップ・リストまたはダイアログでアイテムを選択したときや、editableであるComboBoxの場合にはユーザー自身が(TextFieldまたは他の入力メカニズムを使用して)入力を提供したときに、valueプロパティがプログラムで変更される場合があるためです。

      • getOnAction

        public final EventHandler<ActionEvent> getOnAction​()
        プロパティonActionの値を取得します。
        プロパティの説明:
        ComboBoxのvalueプロパティが変更されると常に起動されるComboBoxアクション。 これは、ユーザーがポップアップ・リストまたはダイアログでアイテムを選択したときや、editableであるComboBoxの場合にはユーザー自身が(TextFieldまたは他の入力メカニズムを使用して)入力を提供したときに、valueプロパティがプログラムで変更される場合があるためです。

      • setOnShowing

        public final void setOnShowing​(EventHandler<Event> value)
        プロパティonShowingの値を設定します。
        プロパティの説明:
        ComboBoxBaseポップアップ/表示が表示される直前に呼び出されます。
        導入されたバージョン:
        JavaFX 2.2

      • getOnShowing

        public final EventHandler<Event> getOnShowing​()
        プロパティonShowingの値を取得します。
        プロパティの説明:
        ComboBoxBaseポップアップ/表示が表示される直前に呼び出されます。
        導入されたバージョン:
        JavaFX 2.2

      • setOnShown

        public final void setOnShown​(EventHandler<Event> value)
        プロパティonShownの値を設定します。
        プロパティの説明:
        ComboBoxBaseポップアップ/表示が表示される直後に呼び出されます。
        導入されたバージョン:
        JavaFX 2.2

      • getOnShown

        public final EventHandler<Event> getOnShown​()
        プロパティonShownの値を取得します。
        プロパティの説明:
        ComboBoxBaseポップアップ/表示が表示される直後に呼び出されます。
        導入されたバージョン:
        JavaFX 2.2

      • setOnHiding

        public final void setOnHiding​(EventHandler<Event> value)
        プロパティonHidingの値を設定します。
        プロパティの説明:
        ComboBoxポップアップ/表示が非表示になる直前に呼び出されます。
        導入されたバージョン:
        JavaFX 2.2

      • getOnHiding

        public final EventHandler<Event> getOnHiding​()
        プロパティonHidingの値を取得します。
        プロパティの説明:
        ComboBoxポップアップ/表示が非表示になる直前に呼び出されます。
        導入されたバージョン:
        JavaFX 2.2

      • setOnHidden

        public final void setOnHidden​(EventHandler<Event> value)
        プロパティonHiddenの値を設定します。
        プロパティの説明:
        ComboBoxBaseポップアップ/表示が非表示になった直後に呼び出されます。
        導入されたバージョン:
        JavaFX 2.2

      • getOnHidden

        public final EventHandler<Event> getOnHidden​()
        プロパティonHiddenの値を取得します。
        プロパティの説明:
        ComboBoxBaseポップアップ/表示が非表示になった直後に呼び出されます。
        導入されたバージョン:
        JavaFX 2.2

      • show

        public void show​()
        ComboBoxにユーザー・インタフェースのポップアップ要素を表示するようにリクエストします。 ComboBoxBaseクラスのjavadocで説明しているように、このメソッドを呼び出したときに実際に何が表示されるかは未定義ですが、一般的にはなんらかの形式のポップアップまたはダイアログ・ウィンドウになります。

      • hide

        public void hide​()
        show()を呼び出したときに表示されたポップアップ/ダイアログを閉じます。

      • arm

        public void arm​()
        ComboBoxを作動準備します。 作動準備完了しているComboBoxでは、次に想定されるUIジェスチャに関するポップアップ・リストが表示されます。 ノート: この機能は、主に新しいスキンまたはビヘイビアを実装する者が専門家によって使用されることを意図しています。 開発者や設計者がこの機能に直接アクセスするのは一般的ではありません。

      • disarm

        public void disarm​()
        ComboBoxの作動準備を解除します。 arm()を参照してください。 ノート: この機能は、主に新しいスキンまたはビヘイビアを実装する者が専門家によって使用されることを意図しています。 開発者や設計者がこの機能に直接アクセスするのは一般的ではありません。

      • queryAccessibleAttribute

        public Object queryAccessibleAttribute​(AccessibleAttribute attribute,
                                       Object... parameters)
        このメソッドは、属性の値をリクエストするためにアシスティブ・テクノロジによって呼び出されます。

        このメソッドは一般に、特定の役割に必要な属性を実装するためにサブクラスによってオーバーライドされます。
        特定の属性が処理されない場合は、スーパークラスの実装を呼び出す必要があります。

        オーバーライド:
        queryAccessibleAttribute、クラス: Control
        パラメータ:
        attribute - リクエストされた属性
        parameters - オプションのパラメータ・リスト
        戻り値:
        リクエストされた属性の値
        関連項目:
        AccessibleAttribute

      • executeAccessibleAction

        public void executeAccessibleAction​(AccessibleAction action,
                                    Object... parameters)
        このメソッドは、引数で指定されたアクションの実行をリクエストするためにアシスティブ・テクノロジによって呼び出されます。

        このメソッドは一般に、特定の役割に必要なアクションを実装するためにサブクラスによってオーバーライドされます。
        特定のアクションが処理されない場合は、スーパークラスの実装を呼び出す必要があります。

        オーバーライド:
        executeAccessibleAction、クラス: Control
        パラメータ:
        action - 実行するアクション
        parameters - オプションのパラメータ・リスト
        関連項目:
        「AccessibleAction」