QScreen Class

属性文档

[read-only] availableGeometry : const QRect

此属性以像素为单位保存屏幕的可用几何图形

可用几何图形是不包括窗口管理器保留区域（如任务栏和系统菜单）的几何图形。

注意，在 X11 系统上，只有在有一个显示器且窗口管理器设置了 _NET_WORKAREA 原子的情况下，才会返回真正的可用几何图形。在所有其他情况下，该值等于geometry()。这是 X11 窗口管理器规范的限制。

访问功能：

Notifier 信号：

[read-only] availableSize : const QSize

该属性表示屏幕的可用尺寸，单位为像素

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

访问功能：

通知信号：

[read-only] availableVirtualGeometry : const QRect

此属性保存此屏幕所属虚拟桌面的可用几何图形

返回此屏幕对应的虚拟桌面的可用几何图形。

这是虚拟兄弟姐妹的单个可用几何图形的组合。

访问功能：

通知信号：

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

[read-only] availableVirtualSize : const QSize

此属性保存此屏幕所属虚拟桌面的可用尺寸

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

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

访问功能：

通知信号：

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

[read-only] depth : const int

此属性保存屏幕的色彩深度

访问功能

[read-only] devicePixelRatio : const qreal

此属性表示屏幕的物理像素与设备无关像素的比例

返回屏幕的物理像素与设备无关像素之间的比例。

普通显示屏的常用值为 1.0，"视网膜 "显示屏的常用值为 2.0。也可以使用更高的值。

访问函数：

通知信号：

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

[read-only] geometry : const QRect

该属性以像素为单位显示屏幕的几何尺寸。

例如，它可能返回QRect(0, 0, 1280, 1024)，或者在虚拟桌面设置中返回QRect(1280, 0, 1280, 1024)。

访问功能：

通知信号：

[read-only] logicalDotsPerInch : const qreal

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

该值可用于将字体点尺寸转换为像素尺寸。

这是一个方便的属性，只是logicalDotsPerInchX 和logicalDotsPerInchY 属性的平均值。

访问功能：

Notifier 信号：

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

[read-only] logicalDotsPerInchX : const qreal

该属性表示水平方向上每英寸的逻辑点数或像素数。

该值用于将字体点尺寸转换为像素尺寸。

访问功能：

Notifier 信号：

另请参阅 logicalDotsPerInchY().

[read-only] logicalDotsPerInchY : const qreal

该属性保存垂直方向上每英寸的逻辑点数或像素数。

该值用于将字体点尺寸转换为像素尺寸。

访问功能：

Notifier 信号：

另请参阅 logicalDotsPerInchX().

[read-only] manufacturer : const QString

此属性保存屏幕的制造商

访问功能：

[read-only] model : const QString

此属性保存屏幕的模型

访问功能：

[read-only] name : const QString

该属性包含代表屏幕的用户可显示字符串

例如，在 X11 上，这些字符串与 XRandr 屏幕名称相对应，通常为 "VGA1"、"HDMI1 "等。

访问功能：

[read-only] nativeOrientation : const Qt::ScreenOrientation

该属性用于保存原生屏幕方向

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

本机方向是硬件的属性，不会改变。

访问功能：

[read-only] orientation : const Qt::ScreenOrientation

该属性显示屏幕方向

orientation 属性从窗口系统的角度显示屏幕的方向。

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

访问功能：

通知信号：

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

[read-only] physicalDotsPerInch : const qreal

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

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

这是一个方便的属性，只是physicalDotsPerInchX 和physicalDotsPerInchY 属性的平均值。

访问功能：

通知信号：

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

[read-only] physicalDotsPerInchX : const qreal

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

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

访问功能：

Notifier 信号：

另请参见 physicalDotsPerInchY()。

[read-only] physicalDotsPerInchY : const qreal

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

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

访问功能：

Notifier 信号：

另请参见 physicalDotsPerInchX()。

[read-only] physicalSize : const QSizeF

此属性保存屏幕的物理尺寸（单位：毫米）

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

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

访问功能：

通知信号：

[read-only] primaryOrientation : const Qt::ScreenOrientation

该属性用于保存主屏幕方向

如果屏幕几何体的宽度大于或等于高度，则主屏幕方向为Qt::LandscapeOrientation ，否则为Qt::PortraitOrientation 。当屏幕方向改变时（即旋转显示屏时），该属性可能会改变。不过，该行为与平台有关，通常可在应用程序清单文件中指定。

访问功能：

通知信号：

[read-only] refreshRate : const qreal

该属性保存屏幕的大致垂直刷新率（单位 Hz

访问功能：

Notifier 信号：

另请参见 QWindow::requestUpdate().

[read-only] serialNumber : const QString

该属性保存屏幕的序列号

访问功能：

[read-only] size : const QSize

此属性保存屏幕的像素分辨率

访问功能：

通知信号

[read-only] virtualGeometry : const QRect

此属性保存此屏幕所属虚拟桌面的像素几何图形

返回此屏幕对应的虚拟桌面的像素几何图形。

这是虚拟兄弟姐妹各自几何图形的组合。

访问功能：

通知信号：

另请参阅 virtualSiblings().

[read-only] virtualSize : const QSize

此属性保存此屏幕所属虚拟桌面的像素大小

返回此屏幕对应的虚拟桌面的像素大小。

这是虚拟兄弟姐妹各自几何尺寸的总和。

访问功能：

通知信号：

另请参阅 virtualSiblings().