JavaFX按住按键同时点击Checkbox无法切换状态问题求助

问题根因 #

这是JavaFX 15版本的已知内置BUG，Checkbox默认的鼠标点击事件处理逻辑错误将按住Ctrl、Shift、Alt等修饰键的点击判定为无效操作，因此不会触发状态切换。

无侵入修复方案 #

无需修改原有业务逻辑，可选择全局统一适配或者单个控件适配两种方式：

方案1：全局适配（推荐） #

在应用初始化时给场景添加全局事件过滤器，统一处理所有Checkbox的点击逻辑，一次修改全量生效，以下是适配你提供的示例的完整修改：

package checkboxkeypressed;

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.CheckBox;
import javafx.scene.input.MouseButton;
import javafx.scene.input.MouseEvent;
import javafx.stage.Stage;

public class CheckboxWhileKeyPressedNotWorking extends Application {

    private CheckBox checkbox = new CheckBox();

    @Override
    public void start(Stage primaryStage) {
        checkbox.setText("Click me while pressing a key...");
        Scene scene = new Scene(checkbox, 200, 50);
        
        // 新增全局修复逻辑
        scene.addEventFilter(MouseEvent.MOUSE_CLICKED, event -> {
            // 仅处理Checkbox的左键点击事件
            if (event.getTarget() instanceof CheckBox targetCheckBox 
                && event.getButton() == MouseButton.PRIMARY) {
                targetCheckBox.setSelected(!targetCheckBox.isSelected());
                event.consume();
            }
        });

        primaryStage.setTitle("Checkbox cannot be ticked while a key is pressed !!");
        primaryStage.setScene(scene);
        primaryStage.show();
    }

    public static void main(String[] args) {
        launch(args);
    }
}

方案2：单个Checkbox适配 #

如果不需要全局修改，仅给指定Checkbox添加事件过滤器即可：

checkBox.addEventFilter(MouseEvent.MOUSE_CLICKED, event -> {
    if (event.getButton() == MouseButton.PRIMARY) {
        checkBox.setSelected(!checkBox.isSelected());
        event.consume();
    }
});

注意：如果你的项目中用到了开启三态模式（allowIndeterminate = true）的Checkbox，可以将上述状态切换逻辑替换为三态循环切换的版本，适配更全面：

if (checkBox.isAllowIndeterminate()) {
    if (checkBox.isIndeterminate()) {
        checkBox.setIndeterminate(false);
        checkBox.setSelected(true);
    } else if (checkBox.isSelected()) {
        checkBox.setSelected(false);
    } else {
        checkBox.setIndeterminate(true);
    }
} else {
    checkBox.setSelected(!checkBox.isSelected());
}

验证效果 #

修改后运行项目，按住Ctrl/Shift/Alt等修饰键点击Checkbox，状态即可正常切换，原有业务逻辑不受影响。

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