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

クラスColorPicker

  • すべての実装されたインタフェース:
    Styleable, EventTarget, Skinnable
    public class ColorPicker
extends ComboBoxBase<Color>

    ColorPickerコントロールを使用すると、ユーザーが標準のカラー・パレットで1回クリックするだけで色を選択したり、独自のカスタム色を定義できるようになります。

    valueは、現在選択されているColorです。 最初の色は、setColorを呼び出すか、コンストラクタを使用して設定できます。 何も指定しない場合は、デフォルトの最初の色が使用されます。

    ColorPickerコントロールは、一連の色が事前定義されたカラー・パレットを提供します。 ユーザーは、必要に応じて、事前定義された一連の色から選択するのではなく、カスタム・カラーのダイアログと対話してカスタム・カラーを作成できます。 このダイアログでは、RGB、HSB、Webの各対話モードで新しい色を作成できます。 また、色の不透明度を変更することもできます。

    新しい色を定義した後、ユーザーはそれを保存するか、使用するのみかを選択できます。 新しい色を保存すると、この色はカラー・パレットのカスタム・カラー領域に表示されるようになります。 また、getCustomColorsは保存済のカスタム・カラーのリストを返します。

    promptTextは、サポートされていないため、操作なしとなります。 ただし、今後サポートされる可能性があります。 

    
 final ColorPicker colorPicker = new ColorPicker();
 colorPicker.setOnAction(new EventHandler() {
     public void handle(Event t) {
         Color c = colorPicker.getValue();
         System.out.println("New Color's RGB = "+c.getRed()+" "+c.getGreen()+" "+c.getBlue());
     }
 });

    ColorPickerコントロールの外観は、単純なButtonモード、MenuButtonモード、SplitMenuButtonモードの3つの方法でスタイル設定できます。 デフォルトはMenuButtonモードです。 ボタンのような外観に使用するスタイル・クラスはSTYLE_CLASS_BUTTONで、SplitMenuButtonの外観と動作に使用するスタイル・クラスはSTYLE_CLASS_SPLIT_BUTTONです。 

    
 colorPicker.getStyleClass().add("button");
    または 
    
 colorPicker.getStyleClass().add("split-button");
    導入されたバージョン:
    JavaFX 2.2

    • フィールドの詳細

      • STYLE_CLASS_BUTTON

        public static final String STYLE_CLASS_BUTTON
        ColorPickerコントロールのボタンのような外観を指定するためのスタイル・クラス。
        関連項目:
        定数フィールド値

      • STYLE_CLASS_SPLIT_BUTTON

        public static final String STYLE_CLASS_SPLIT_BUTTON
        ColorPickerコントロールのSplitMenuButtonのような外観を指定するためのスタイル・クラス。
        関連項目:
        定数フィールド値

    • コンストラクタの詳細

      • ColorPicker

        public ColorPicker()
        選択された色を白に設定したデフォルトのColorPickerインスタンスを作成します。

      • ColorPicker

        public ColorPicker​(Color color)
        ColorPickerインスタンスを作成し、選択された色を特定の色に設定します。
        パラメータ:
        color - ColorPickerの現在選択されている色として設定されます。

    • メソッドの詳細

      • getCustomColors

        public final ObservableList<Color> getCustomColors()
        ユーザーがカラー・パレットに追加したカスタム・カラーのリストを取得します。
        戻り値:
        カスタム・カラーのリスト