如何阻止用户操作，保持 JavaFX 应用程序全屏？

windows

2024-03-27 07:33:35

阻止用户操作，保持应用程序全屏

问题

在 JavaFX 应用程序中，当用户打开外部文件（如 Microsoft Word 文档）时，应用程序会最小化，允许用户访问操作系统。对于需要防止用户交互并保持应用程序全屏的特定用例，这是不理想的。

解决方案方法

为了解决这个问题，我们可以采用一种巧妙的方法，将一个透明覆盖层添加到应用程序全屏视图中，有效地阻止用户与底层操作系统交互。

具体步骤

要实现这一解决方案，我们可以遵循以下步骤：

创建自定义 Stage: 创建一个自定义的 Stage 类并覆盖其 initStyle() 方法以禁用窗口装饰（如标题栏和关闭按钮）。
设置全屏模式: 设置自定义 Stage 为全屏模式并调用 setAlwaysOnTop(true) 方法将其置于其他窗口之上。
处理文件打开: 在通过 Desktop.getDesktop().open(file) 打开文件后，创建一个透明的 BorderPane 并将其添加到自定义 Stage。
调整覆盖层大小: 侦听主 Stage 的 sizeChanged 事件并相应调整覆盖层的大小，以确保其覆盖整个应用程序窗口。
阻止用户输入: 为覆盖层添加事件处理程序，以拦截鼠标和键盘事件，从而防止用户与应用程序或操作系统交互。

示例代码

以下示例代码展示了如何实现此解决方案：

import javafx.application.Application;
import javafx.event.EventHandler;
import javafx.scene.Scene;
import javafx.scene.control.BorderPane;
import javafx.scene.input.KeyEvent;
import javafx.scene.input.MouseEvent;
import javafx.stage.Stage;
import javafx.stage.StageStyle;

public class BlockingUserActions extends Application {

    @Override
    public void start(Stage primaryStage) {
        // 创建自定义 Stage
        Stage customStage = new Stage() {
            @Override
            public void initStyle(StageStyle style) {
                super.initStyle(StageStyle.UNDECORATED);
            }
        };

        // 设置全屏模式和置顶
        customStage.setFullScreen(true);
        customStage.setAlwaysOnTop(true);

        // 创建覆盖层
        BorderPane overlay = new BorderPane();
        overlay.setStyle("-fx-background-color: transparent;");

        // 添加事件处理程序以阻止用户输入
        overlay.addEventFilter(MouseEvent.ANY, new EventHandler<MouseEvent>() {
            @Override
            public void handle(MouseEvent event) {
                event.consume();
            }
        });
        overlay.addEventFilter(KeyEvent.ANY, new EventHandler<KeyEvent>() {
            @Override
            public void handle(KeyEvent event) {
                event.consume();
            }
        });

        // 处理文件打开
        primaryStage.setOnShown(event -> {
            File file = new File("path/to/file.docx");
            Desktop.getDesktop().open(file);
            customStage.getScene().getRoot().getChildren().add(overlay);
        });

        // 侦听大小变化事件并调整覆盖层大小
        primaryStage.widthProperty().addListener((observable, oldValue, newValue) -> overlay.setPrefWidth(newValue.doubleValue()));
        primaryStage.heightProperty().addListener((observable, oldValue, newValue) -> overlay.setPrefHeight(newValue.doubleValue()));

        // 显示自定义 Stage
        customStage.setScene(new Scene(new BorderPane(), 0, 0));
        customStage.show();
    }

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