JavaFX ComboBox按住Ctrl键选择同一项时选中值为Null问题求助

问题现象 #

正常切换ComboBox选中项时功能正常，但按住Ctrl键选择当前已选中的条目时，选中值会变为Null，演示如下：

环境信息 #

• 系统：Linux Ubuntu Mate 24.04
• JDK：OpenJDK 23.0.1（Amazon Corretto）
• JavaFX版本：23

最小复现代码 #

public class App extends Application {
    public static void main(String[] args) {
        launch();
    }

    @Override
    public void start(Stage stage) throws IOException {
        
        ComboBox<String> comboBox = new ComboBox<>();
        
        comboBox.getItems().setAll("one", "two");
        comboBox.getSelectionModel().selectFirst();
        Scene scene = new Scene(new StackPane(comboBox), 320, 240);
        String title = null;
        scene.setOnKeyPressed(
                keyEvent -> stage.setTitle(keyEvent.isControlDown() ? "Control down" : ""));
        scene.setOnKeyReleased(e -> stage.setTitle(""));
        stage.setTitle(title);
        stage.setScene(scene);
        stage.show();
    }
}

解决方案 #

该问题源于Linux平台下JavaFX对Ctrl键点击的默认处理：即使在单选模式下，按住Ctrl点击已选中项会触发取消选中逻辑，导致值变为Null。以下两种方案可修复：

方案1：自定义SingleSelectionModel，拦截无效操作 #

继承SingleSelectionModel，覆盖select方法，当Ctrl按下且选中项未变化时，阻止取消选中的动作：

comboBox.setSelectionModel(new SingleSelectionModel<String>() {
    private final ObservableList<String> items = comboBox.getItems();

    @Override
    protected int getItemCount() {
        return items.size();
    }

    @Override
    protected String getModelItem(int index) {
        return items.get(index);
    }

    @Override
    public void select(String obj) {
        if (obj != null && obj.equals(getSelectedItem()) && KeyboardShortcuts.isControlDown()) {
            return;
        }
        super.select(obj);
    }
});

方案2：监听选中项变化，自动恢复异常Null值 #

监听selectedItemProperty，当检测到Ctrl按下且选中项变为Null时，恢复到之前的选中值：

comboBox.getSelectionModel().selectedItemProperty().addListener((obs, oldVal, newVal) -> {
    if (newVal == null && KeyboardShortcuts.isControlDown()) {
        comboBox.getSelectionModel().select(oldVal);
    }
});

补充说明：KeyboardShortcuts.isControlDown()是JavaFX 23提供的工具方法，若使用旧版本，可通过监听键盘事件记录Ctrl键状态，或通过comboBox.getScene().getInputMap()相关逻辑替代判断。

内容的提问来源于stack exchange，提问作者Giovanni Contreras