QScreen Class

属性文档

[read-only] availableGeometry : QRect

该属性以像素为单位存储屏幕的可用几何尺寸

可用几何尺寸是指排除窗口管理器预留区域（如任务栏和系统菜单）后的几何尺寸。

请注意，在 X11 环境中，此函数仅在单显示器系统上，且当窗口管理器已设置 _NET_WORKAREA 原子时，才会返回真正的可用几何尺寸。在所有其他情况下，其返回值等于 `geometry()`。这是 X11 窗口管理器规范中的一个限制。

访问函数：

通知器信号：

[read-only] availableSize : QSize

该属性存储屏幕的可用尺寸（以像素为单位）

可用尺寸是指不包括窗口管理器预留区域（如任务栏和系统菜单）的尺寸。

访问函数：

通知信号：

[read-only] availableVirtualGeometry : QRect

该属性存储了此屏幕所属的虚拟桌面的可用几何信息

返回与该屏幕对应的虚拟桌面的可用几何参数。

这是该屏幕所属的虚拟兄弟窗口各自可用几何属性的并集。

访问函数：

通知信号：

另请参见 availableGeometry() 和virtualSiblings()。

[read-only] availableVirtualSize : QSize

该属性存储了此屏幕所属的虚拟桌面的可用大小

返回与该屏幕对应的虚拟桌面的可用像素尺寸。

这是虚拟兄弟窗口各自可用几何尺寸的总和。

访问函数：

通知信号：

另请参阅 availableSize() 和virtualSiblings()。

[read-only] depth : const int

该属性存储屏幕的色深

访问函数：

[read-only] devicePixelRatio : qreal

该属性存储屏幕中物理像素与设备独立像素之间的比例

返回屏幕上物理像素与设备独立像素之间的比例。

该函数返回的值可能与 `QWindow::devicePixelRatio()` 不同，例如在 Wayland 上使用分数缩放时，或者当设置了影响表面分辨率的窗口属性时。建议优先使用 `QWindow::devicePixelRatio()`。

访问函数：

通知信号：

另请参阅 QWindow::devicePixelRatio() 和QGuiApplication::devicePixelRatio()。

[read-only] geometry : QRect

该属性以像素为单位存储屏幕的几何参数

例如，该属性可能返回QRect （0, 0, 1280, 1024），或者在虚拟桌面环境中返回QRect （1280, 0, 1280, 1024）。

访问函数：

通知信号：

[read-only] logicalDotsPerInch : qreal

该属性表示每英寸的逻辑点数或像素数

该值可用于将字体点大小转换为像素大小。

这是一个便捷属性，仅为logicalDotsPerInchX 和logicalDotsPerInchY 属性的平均值。

访问函数：

通知信号：

另请参阅 logicalDotsPerInchX() 和logicalDotsPerInchY()。

[read-only] logicalDotsPerInchX : qreal

该属性存储水平方向上每英寸的逻辑点数或像素数

该值用于将字体点大小转换为像素大小。

访问函数：

通知信号：

另请参阅 logicalDotsPerInchY()。

[read-only] logicalDotsPerInchY : qreal

该属性表示垂直方向上每英寸的逻辑点数或像素数

该值用于将字体点大小转换为像素大小。

访问函数：

通知信号：

另请参阅 logicalDotsPerInchX()。

[read-only] manufacturer : const QString

该属性存储屏幕的制造商

访问功能：

[read-only] model : const QString

该属性保存了屏幕的模型

访问函数：

[read-only] name : const QString

该属性存储一个可由用户显示的字符串，用于表示屏幕

例如，在 X11 环境中，这些名称对应于 XRandr 屏幕名称，通常为“VGA1”、“HDMI1”等。

访问函数：

[read-only] nativeOrientation : Qt::ScreenOrientation

该属性保存原生屏幕方向

屏幕的原生方向是指设备上的徽标贴纸呈现正向的方向；如果平台不支持此功能，则为Qt::PrimaryOrientation 。

原生方向是硬件的属性，不会发生变化。

访问函数：

[read-only] orientation : Qt::ScreenOrientation

该属性表示屏幕的朝向

orientation 属性从窗口系统的角度反映屏幕的朝向。

大多数移动设备和平板电脑都配备了加速度计传感器。Qt Sensors 模块提供了直接读取该传感器数据的功能。但是，窗口系统可能会根据设备持握方式自动旋转整个屏幕；在这种情况下，orientation 属性将会发生变化。

访问函数：

通知器信号：

另请参阅 primaryOrientation() 和QWindow::contentOrientation()。

[read-only] physicalDotsPerInch : qreal

该属性表示每英寸的物理点数或像素数

该值代表屏幕显示的像素密度。根据底层系统提供的信息不同，该值可能并非完全准确。

这是一个便利属性，仅为physicalDotsPerInchX 和physicalDotsPerInchY 属性的平均值。

访问函数：

通知信号：

另请参阅 physicalDotsPerInchX() 和physicalDotsPerInchY()。

[read-only] physicalDotsPerInchX : qreal

该属性表示水平方向上每英寸的物理点数或像素数

该值代表屏幕显示上的实际水平像素密度。根据底层系统提供的信息不同，该值可能并不完全准确。

访问函数：

通知信号：

另请参阅 physicalDotsPerInchY()。

[read-only] physicalDotsPerInchY : qreal

该属性表示垂直方向上每英寸的物理点数或像素数

该值表示屏幕显示的实际垂直像素密度。根据底层系统提供的信息不同，该值可能并非完全准确。

访问函数：

通知信号：

另请参阅 physicalDotsPerInchX()。

[read-only] physicalSize : QSizeF

该属性存储屏幕的物理尺寸（以毫米为单位）

物理尺寸代表屏幕显示区域的实际物理尺寸。

根据底层系统提供的信息不同，该值可能并非完全准确。

访问函数：

通知器信号：

[read-only] primaryOrientation : Qt::ScreenOrientation

该属性存储主屏幕方向

如果屏幕几何形状的宽度大于或等于其高度，则主屏幕方向为Qt::LandscapeOrientation ；否则为Qt::PortraitOrientation 。当屏幕方向发生变化（即显示器旋转时），此属性可能会发生变化。不过，该行为取决于平台，通常可在应用程序清单文件中进行指定。

访问函数：

通知器信号：

[read-only] refreshRate : qreal

该属性表示屏幕的大致垂直刷新率（单位：赫兹）

访问函数：

通知器信号：

另请参阅 QWindow::requestUpdate()。

[read-only] serialNumber : const QString

该属性存储屏幕的序列号

访问函数：

[read-only] size : QSize

该属性存储屏幕的像素分辨率

访问函数：

通知信号：

[read-only] virtualGeometry : QRect

该属性存储了该屏幕所属的虚拟桌面的像素几何信息

返回与该屏幕对应的虚拟桌面的像素几何信息。

这是虚拟同级窗口各自几何信息的并集。

访问函数：

通知信号：

另请参阅 ` virtualSiblings()`。

[read-only] virtualSize : QSize

该属性存储了该屏幕所属的虚拟桌面的像素尺寸

返回与该屏幕对应的虚拟桌面的像素尺寸。

这是虚拟兄弟窗口各自几何参数的总和。

访问函数：

通知信号：

另请参阅 virtualSiblings()。