组合框允许用户选择几个选项之一。用户可以滚动到下拉列表。组合框可以是可编辑和不可编辑的。

创建组合框

以下代码将选项列表包装到ObservableList中，然后使用observable列表实例化ComboBox类。

  1. ObservableList<String> options = 
  2.     FXCollections.observableArrayList(
  3.     "1",
  4.     "2",
  5.     "3"
  6. );
  7. ComboBox comboBox = new ComboBox(options);

我们还可以使用空构造函数创建一个组合框，并调用其setItems方法设置数据。

  1. ComboBox comboBox = new ComboBox(options);
  2. comboBox.setItems(options);

向具有新值的项目的组合框中添加更多项目。

  1. comboBox.getItems().addAll(
  2.     "4",
  3.     "5",
  4.     "6"
  5. );

setValue 方法设置在组合框中选择的项目。在调用setValue方法时，即使值不在组合框项目列表中，selectionModel属性的选定项也会更改为此值。
getValue方法返回所选的值。
要限制下拉列表中可见行的数量，请使用以下代码。

  1. comboBox.setVisibleRowCount(3)

可编辑的组合框

setEditable(true)方法使组合框可编辑。使用setPromptText方法，当不执行选择时，我们可以指定显示在组合框编辑区域中的文本。

  1. ComboBox myComboBox = new ComboBox();
  2. myComboBox.getItems().addAll(
  3.     "s@example.com",
  4.     "i@example.com",
  5.     "e@example.com",
  6.     "m@example.com"  
  7. );
  8. myComboBox.setPromptText("Email address");
  9. myComboBox.setEditable(true);        
  10. myComboBox.setOnAction((Event ev) -> {
  11.     address =  myComboBox.getSelectionModel().getSelectedItem().toString();    
  12. });
  13. myComboBox.setValue("s@example.com");

以下代码创建一个简单的可编辑组合框

  1. import javafx.application.Application;
  2. import javafx.scene.Group;
  3. import javafx.scene.Scene;
  4. import javafx.scene.control.ComboBox;
  5. import javafx.stage.Stage;
  7. public class Main extends Application {
  8.     public static void main(String[] args) {
  9.         launch(args);
  10.     }
  12.     @Override
  13.     public void start(Stage stage) {
  14.         Scene scene = new Scene(new Group(), 450, 250);
  16.         ComboBox<String> myComboBox = new ComboBox<String>();
  17.         myComboBox.getItems().addAll("A","B","C","D","E");
  18.         myComboBox.setEditable(true);        
  20.         Group root = (Group) scene.getRoot();
  21.         root.getChildren().add(myComboBox);
  22.         stage.setScene(scene);
  23.         stage.show();
  25.     }
  26. }

image.png

组合框单元格

我们可以使用单元格工厂来改变组合框的默认行为或外观。
以下代码创建一个单元格工厂，并将其应用到组合框。
单元格工厂生成ListCell对象。 每个单元格与一个组合框项目相关联。

  1. import javafx.application.Application;
  2. import javafx.scene.Group;
  3. import javafx.scene.Scene;
  4. import javafx.scene.control.ComboBox;
  5. import javafx.scene.control.ListCell;
  6. import javafx.scene.control.ListView;
  7. import javafx.scene.paint.Color;
  8. import javafx.stage.Stage;
  9. import javafx.util.Callback;
  11. public class Main extends Application {
  12.     public static void main(String[] args) {
  13.         launch(args);
  14.     }
  15.     @Override
  16.     public void start(Stage stage) {
  17.         Scene scene = new Scene(new Group(), 200, 200);
  18.         ComboBox<String> myComboBox = new ComboBox<String>();
  19.         myComboBox.getItems().addAll("A", "B", "C", "D", "E");
  20.         myComboBox
  21.             .setCellFactory(new Callback<ListView<String>, ListCell<String>>() {
  22.                 @Override
  23.                 public ListCell<String> call(ListView<String> param) {
  24.                     final ListCell<String> cell = new ListCell<String>() {
  25.                         {
  26.                             super.setPrefWidth(100);
  27.                         }
  29.                         @Override
  30.                         public void updateItem(String item, boolean empty) {
  31.                             super.updateItem(item, empty);
  32.                             if (item != null) {
  33.                                 setText(item);
  34.                                 if (item.contains("A")) {
  35.                                     setTextFill(Color.RED);
  36.                                 } else if (item.contains("B")) {
  37.                                     setTextFill(Color.GREEN);
  38.                                 } else {
  39.                                     setTextFill(Color.BLACK);
  40.                                 }
  41.                             } else {
  42.                                 setText(null);
  43.                             }
  44.                         }
  45.                     };
  46.                     return cell;
  47.                 }
  48.             });
  49.         Group root = (Group) scene.getRoot();
  50.         root.getChildren().add(myComboBox);
  51.         stage.setScene(scene);
  52.         stage.show();
  53.     }
  54. }

image.png

例1

将值设置为null以清除ComboBox

  1. import javafx.application.Application;
  2. import javafx.scene.Group;
  3. import javafx.scene.Scene;
  4. import javafx.scene.control.ComboBox;
  5. import javafx.stage.Stage;
  7. public class Main extends Application {
  8.     public static void main(String[] args) {
  9.         launch(args);
  10.     }
  11.     @Override
  12.     public void start(Stage stage) {
  13.         Scene scene = new Scene(new Group(), 450, 250);
  14.         ComboBox<String> myComboBox = new ComboBox<String>();
  15.         myComboBox.getItems().addAll("A","B","C","D","E");
  16.         myComboBox.setValue("A");
  17.         System.out.println(myComboBox.getValue());
  19.         myComboBox.setValue(null);
  21.         Group root = (Group) scene.getRoot();
  22.         root.getChildren().add(myComboBox);
  23.         stage.setScene(scene);
  24.         stage.show();
  25.     }
  26. }

image.png

例2

设置和获取ComboBox的值

  1. import javafx.application.Application;
  2. import javafx.scene.Group;
  3. import javafx.scene.Scene;
  4. import javafx.scene.control.ComboBox;
  5. import javafx.stage.Stage;
  7. public class Main extends Application {
  8.     public static void main(String[] args) {
  9.         launch(args);
  10.     }
  11.     @Override
  12.     public void start(Stage stage) {
  13.         Scene scene = new Scene(new Group(), 450, 250);
  14.         ComboBox<String> myComboBox = new ComboBox<String>();
  15.         myComboBox.getItems().addAll("A","B","C","D","E");
  16.         myComboBox.setValue("A");
  17.         System.out.println(myComboBox.getValue());
  20.         Group root = (Group) scene.getRoot();
  21.         root.getChildren().add(myComboBox);
  22.         stage.setScene(scene);
  23.         stage.show();
  24.     }
  25. }

image.png

例3

将更改监听器添加到ComboBox valueProperty

  1. import javafx.application.Application;
  2. import javafx.beans.value.ChangeListener;
  3. import javafx.beans.value.ObservableValue;
  4. import javafx.scene.Group;
  5. import javafx.scene.Scene;
  6. import javafx.scene.control.ComboBox;
  7. import javafx.stage.Stage;
  9. public class Main extends Application {
  10.     public static void main(String[] args) {
  11.         launch(args);
  12.     }
  13.     @Override
  14.     public void start(Stage stage) {
  15.         Scene scene = new Scene(new Group(), 450, 250);
  16.         ComboBox<String> myComboBox = new ComboBox<String>();
  17.         myComboBox.getItems().addAll("A","B","C","D","E");
  18.         myComboBox.setValue("A");
  19.         System.out.println(myComboBox.getValue());
  20.         myComboBox.valueProperty().addListener(new ChangeListener<String>() {
  21.             @Override public void changed(ObservableValue ov, String t, String t1) {
  22.                 System.out.println(ov);
  23.                 System.out.println(t);
  24.                 System.out.println(t1);
  25.             }    
  26.         });
  28.         Group root = (Group) scene.getRoot();
  29.         root.getChildren().add(myComboBox);
  30.         stage.setScene(scene);
  31.         stage.show();
  32.     }
  33. }

image.png

例4

  1. import javafx.application.Application;
  2. import javafx.scene.Group;
  3. import javafx.scene.Scene;
  4. import javafx.scene.control.ComboBox;
  5. import javafx.stage.Stage;
  7. public class Main extends Application {
  8.     public static void main(String[] args) {
  9.         launch(args);
  10.     }
  11.     @Override
  12.     public void start(Stage stage) {
  13.         Scene scene = new Scene(new Group(), 450, 250);
  14.         ComboBox<String> myComboBox = new ComboBox<String>();
  15.         myComboBox.getItems().addAll("A","B","C","D","E");
  16.         myComboBox.setEditable(true);
  17.         myComboBox.setPromptText("Email address");
  19.         Group root = (Group) scene.getRoot();
  20.         root.getChildren().add(myComboBox);
  21.         stage.setScene(scene);
  22.         stage.show();
  23.     }
  24. }

例5

在ComboBox中显示矩形

  1. import javafx.application.Application;
  2. import javafx.scene.Group;
  3. import javafx.scene.Scene;
  4. import javafx.scene.control.ComboBox;
  5. import javafx.scene.layout.GridPane;
  6. import javafx.scene.paint.Color;
  7. import javafx.scene.shape.Rectangle;
  8. import javafx.stage.Stage;
  10. public class Main extends Application {
  11.     public static void main(String[] args) {
  12.         Application.launch(args);
  13.     }
  14.     @Override
  15.     public void start(final Stage primaryStage) {
  16.         Group root = new Group();
  17.         Scene scene = new Scene(root, 400, 300, Color.WHITE);
  19.         GridPane gridpane = new GridPane();
  21.         ComboBox<Rectangle> cmb = new ComboBox<Rectangle>();
  22.         cmb.getItems().addAll(
  23.             new Rectangle(10, 10, Color.RED), 
  24.             new Rectangle(10, 10, Color.GREEN), 
  25.             new Rectangle(10, 10, Color.BLUE));
  27.         gridpane.add(cmb, 2, 0);
  29.         root.getChildren().add(gridpane);   
  30.         primaryStage.setScene(scene);
  32.         primaryStage.show();
  33.     }
  35. }

例6

以下代码显示了如何使用CellFactory显示组合框值。

  1. import javafx.application.Application;
  2. import javafx.scene.Group;
  3. import javafx.scene.Scene;
  4. import javafx.scene.control.ComboBox;
  5. import javafx.scene.control.ContentDisplay;
  6. import javafx.scene.control.ListCell;
  7. import javafx.scene.control.ListView;
  8. import javafx.scene.layout.GridPane;
  9. import javafx.scene.paint.Color;
  10. import javafx.scene.shape.Rectangle;
  11. import javafx.stage.Stage;
  12. import javafx.util.Callback;
  14. public class Main extends Application {
  15.     public static void main(String[] args) {
  16.         Application.launch(args);
  17.     }
  19.     @Override
  20.     public void start(final Stage primaryStage) {
  21.         Group root = new Group();
  22.         Scene scene = new Scene(root, 400, 300, Color.WHITE);
  23.         GridPane gridpane = new GridPane();
  24.         ComboBox<Color> cmb = new ComboBox<Color>();
  25.         cmb.getItems().addAll(Color.RED, Color.GREEN, Color.BLUE);
  26.         cmb.setCellFactory(new Callback<ListView<Color>, ListCell<Color>>() {
  27.             @Override
  28.             public ListCell<Color> call(ListView<Color> p) {
  29.                 return new ListCell<Color>() {
  30.                     private final Rectangle rectangle;
  31.                     {
  32.                         setContentDisplay(ContentDisplay.GRAPHIC_ONLY);
  33.                         rectangle = new Rectangle(10, 10);
  34.                     }
  36.                     @Override
  37.                     protected void updateItem(Color item, boolean empty) {
  38.                         super.updateItem(item, empty);
  40.                         if (item == null || empty) {
  41.                             setGraphic(null);
  42.                         } else {
  43.                             rectangle.setFill(item);
  44.                             setGraphic(rectangle);
  45.                         }
  46.                     }
  47.                 };
  48.             }
  49.         });
  51.         gridpane.add(cmb, 2, 0);
  53.         root.getChildren().add(gridpane);
  54.         primaryStage.setScene(scene);
  56.         primaryStage.show();
  57.     }
  59. }