JavaFX 中测量尺寸的单位是什么（setWidth 和 setHeight）？

Question

我正在使用 JavaFX 创建应用程序。在我的代码中，我使用 setWidth() 和 setHeight() 方法设置窗口或元素的大小。例如：

stage.setWidth(400);
stage.setHeight(400);

传递给这些方法的值使用什么单位？它们是像素还是其他单位？如果它们是像素，官方文档或其他可靠来源中在哪里提到了这一点？

我在 JavaFX 代码中使用了 setWidth() 和 setHeight() 方法，并期望以像素为单位设置大小。但是，我在官方文档中找不到确认单位的明确声明。我正在寻找权威来源来验证单位是否确实是像素或其他东西。

Answer 1

据我了解，舞台的宽度和高度（以及 x 和 y 坐标）位于屏幕的坐标中。 （请注意，如果有多个物理显示器，这些显示器将布置在包含所有屏幕的虚拟坐标系中，

Screen

API 使您可以访问此内容。）

屏幕坐标可能对应也可能不对应于实际像素：这种关系由

outputScaleX

和

outputScaleY

属性指定。这些属性是各个屏幕的属性；它们也是

Window

的属性，并且窗口属性将使用显示窗口的当前屏幕的屏幕属性进行更新。

窗口实际上按照

renderScaleX

和

renderScaleY

属性定义的比例进行渲染。默认情况下，这会跟踪

outputScale

属性，但可以在代码中更改。

这是一个快速测试工具。

import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Scene;
import javafx.scene.layout.BorderPane;
import javafx.stage.Screen;
import javafx.stage.Stage;

import java.io.IOException;

public class ScaleTest extends Application {
    @Override
    public void start(Stage stage) throws IOException {

        for (Screen screen : Screen.getScreens()) {
            System.out.printf("""
                    Screen: %s%n
                    dpi: %s%n
                    outputScaleX/Y: %.3f x %.3f%n
                    Bounds: %s%n%n
                    """, screen, screen.getDpi(), screen.getOutputScaleX(), screen.getOutputScaleY(),
                    screen.getBounds());
        }

        stage.outputScaleXProperty().subscribe(x -> System.out.printf("Output scale x: %.3f%n", x));
        stage.outputScaleYProperty().subscribe(y -> System.out.printf("Output scale y: %.3f%n", y));
        stage.renderScaleXProperty().subscribe(x -> System.out.printf("Render scale x: %.3f%n", x));
        stage.renderScaleYProperty().subscribe(y -> System.out.printf("Render scale y: %.3f%n", y));

        Scene scene = new Scene(new BorderPane(), 400, 400);
        stage.setScene(scene);
        stage.show();
    }

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

我在 MacBookPro 上运行，除了默认的 MacBook 显示屏之外，还附加了外部显示屏。外部显示器是 DPI 108 的“主”屏幕，内置“视网膜”显示器的 DPI 为 151。当我将舞台从视网膜显示器移至时，由于输出比例不同，它的“物理”尺寸会缩小，如输出中所示：

Screen: javafx.stage.Screen@18f04d17 bounds:Rectangle2D [minX=0.0, minY=0.0, maxX=5120.0, maxY=1440.0, width=5120.0, height=1440.0] visualBounds:Rectangle2D [minX=0.0, minY=25.0, maxX=5120.0, maxY=1355.0, width=5120.0, height=1330.0] dpi:108.0 outputScale:(1.0,1.0)

dpi: 108.0

outputScaleX/Y: 1.000 x 1.000

Bounds: Rectangle2D [minX=0.0, minY=0.0, maxX=5120.0, maxY=1440.0, width=5120.0, height=1440.0]


Screen: javafx.stage.Screen@cc4571c0 bounds:Rectangle2D [minX=-1800.0, minY=0.0, maxX=0.0, maxY=1169.0, width=1800.0, height=1169.0] visualBounds:Rectangle2D [minX=-1800.0, minY=44.0, maxX=0.0, maxY=1169.0, width=1800.0, height=1125.0] dpi:151.0 outputScale:(2.0,2.0)

dpi: 151.0

outputScaleX/Y: 2.000 x 2.000

Bounds: Rectangle2D [minX=-1800.0, minY=0.0, maxX=0.0, maxY=1169.0, width=1800.0, height=1169.0]


Output scale x: 1.000
Output scale y: 1.000
Render scale x: 1.000
Render scale y: 1.000
2025-01-22 11:53:06.057 java[19226:140296023] +[IMKClient subclass]: chose IMKClient_Legacy
2025-01-22 11:53:06.057 java[19226:140296023] +[IMKInputSession subclass]: chose IMKInputSession_Legacy
Render scale x: 2.000
Render scale y: 2.000
Output scale x: 2.000
Output scale y: 2.000