PySide6.QtGui.QScreen

class QScreen

QScreen 类用于查询屏幕属性。更多…

PySide6.QtGui.QScreen 的继承图

概要

属性

方法

信号

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

关于逻辑与物理每英寸点数（DPI）的说明：物理DPI基于实际可用的物理像素大小，适用于打印预览和其他需要了解屏幕显示内容确切物理尺寸的情况。

逻辑每英寸点数用于将字体和用户界面元素从点大小转换为像素大小，可能与物理每英寸点数不同。逻辑每英寸点数有时可以在桌面环境的设置面板中由用户设置，以便让用户全局控制不同应用程序中的用户界面和字体大小。

注意

物理和逻辑DPI都以设备无关的点表示。乘以devicePixelRatio()以获得设备相关的密度。

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property availableGeometryᅟ: QRect

此属性保存屏幕的可用几何尺寸（以像素为单位）。

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

注意，在X11上，只有在单显示器系统上且窗口管理器设置了_NET_WORKAREA原子时，此函数才会返回真实的可用几何信息。在所有其他情况下，这等同于geometry()。这是X11窗口管理器规范中的一个限制。

Access functions:
property availableSizeᅟ: QSize

此属性保存屏幕的可用大小（以像素为单位）。

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

Access functions:
property availableVirtualGeometryᅟ: QRect

此属性保存此屏幕所属的虚拟桌面的可用几何信息。

返回与此屏幕对应的虚拟桌面的可用几何信息。

这是虚拟兄弟节点的个体可用几何的联合。

Access functions:
property availableVirtualSizeᅟ: QSize

此属性保存此屏幕所属的虚拟桌面的可用大小。

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

这是虚拟兄弟节点的各个可用几何体的组合大小。

Access functions:
property depthᅟ: int

此属性保存屏幕的颜色深度。

Access functions:
property devicePixelRatioᅟ: float

此属性保存屏幕的物理像素与设备无关像素之间的比率。

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

常见值为1.0在普通显示器上，2.0在“视网膜”显示器上。也可能有更高的值。

Access functions:
property geometryᅟ: QRect

此属性保存屏幕的几何形状（以像素为单位）。

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

Access functions:
property logicalDotsPerInchᅟ: float

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

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

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

Access functions:
property logicalDotsPerInchXᅟ: float

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

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

另请参阅

logicalDotsPerInchY()

Access functions:
property logicalDotsPerInchYᅟ: float

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

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

另请参阅

logicalDotsPerInchX()

Access functions:
property manufacturerᅟ: str

此属性保存屏幕的制造商。

Access functions:
property modelᅟ: str

此属性保存屏幕的模型。

Access functions:
property nameᅟ: str

此属性保存一个用户可呈现的字符串，表示屏幕。

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

注意

用户可呈现的字符串不保证与任何原生API的结果匹配，且不应用于唯一标识屏幕。

Access functions:
property nativeOrientationᅟ: Qt.ScreenOrientation

此属性保存本机屏幕方向。

屏幕的原始方向是设备标志贴纸正确朝上的方向，如果平台不支持此功能，则为Qt::PrimaryOrientation。

原生方向是硬件的一个属性，不会改变。

Access functions:
property orientationᅟ: Qt.ScreenOrientation

此属性保存屏幕方向。

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

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

Access functions:
property physicalDotsPerInchᅟ: float

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

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

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

注意

物理DPI以设备无关的点表示。乘以devicePixelRatio()以获得设备相关的密度。

另请参阅

physicalDotsPerInchX() physicalDotsPerInchY()

Access functions:
property physicalDotsPerInchXᅟ: float

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

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

注意

物理DPI以设备无关的点表示。乘以devicePixelRatio()以获得设备相关的密度。

另请参阅

physicalDotsPerInchY()

Access functions:
property physicalDotsPerInchYᅟ: float

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

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

注意

物理DPI以设备无关的点表示。乘以devicePixelRatio()以获得设备相关的密度。

另请参阅

physicalDotsPerInchX()

Access functions:
property physicalSizeᅟ: QSizeF

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

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

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

Access functions:
property primaryOrientationᅟ: Qt.ScreenOrientation

此属性保存主屏幕方向。

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

Access functions:
property refreshRateᅟ: float

此属性保存屏幕的近似垂直刷新率，单位为Hz。

警告

避免使用屏幕的刷新率通过计时器（如QChronoTimer）来驱动动画。相反，使用requestUpdate()。

另请参阅

requestUpdate()

Access functions:
property serialNumberᅟ: str

此属性保存屏幕的序列号。

Access functions:
property sizeᅟ: QSize

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

Access functions:
property virtualGeometryᅟ: QRect

此属性保存此屏幕所属的虚拟桌面的像素几何信息。

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

这是虚拟兄弟节点的个体几何体的联合。

另请参阅

virtualSiblings()

Access functions:
property virtualSizeᅟ: QSize

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

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

这是虚拟兄弟节点的各个几何体的组合大小。

另请参阅

virtualSiblings()

Access functions:
angleBetween(a, b)
Parameters:
Return type:

整数

方便函数，用于计算从旋转a到旋转b的旋转角度。

结果将是0、90、180或270。

Qt::PrimaryOrientation 被解释为屏幕的 primaryOrientation() 。

availableGeometry()
Return type:

QRect

属性 availableGeometryᅟ 的获取器。

availableGeometryChanged(geometry)
Parameters:

几何 – QRect

属性 availableSizeᅟ 的通知信号。

availableSize()
Return type:

QSize

属性 availableSizeᅟ 的获取器。

availableVirtualGeometry()
Return type:

QRect

属性 availableVirtualGeometryᅟ 的获取器。

availableVirtualSize()
Return type:

QSize

属性 availableVirtualSizeᅟ 的获取器。

depth()
Return type:

整数

属性 depthᅟ 的获取器。

devicePixelRatio()
Return type:

浮点数

属性 devicePixelRatioᅟ 的获取器。

geometry()
Return type:

QRect

属性 geometryᅟ 的获取器。

geometryChanged(geometry)
Parameters:

几何 – QRect

属性 sizeᅟ 的通知信号。

grabWindow([window=0[, x=0[, y=0[, w=-1[, h=-1]]]]])
Parameters:

  • window – WId

  • x – 整数

  • y – 整数

  • w – 整数

  • h – 整数

Return type:

QPixmap

创建并返回一个通过抓取给定window的内容构造的pixmap，该内容受QRect(x, y, width, height)的限制。如果window为0，则将抓取整个屏幕。

参数 (x, y) 指定窗口中的偏移量，而 (width, height) 指定要复制的区域。如果 width 为负数，函数将复制所有内容到窗口的右边界。如果 height 为负数，函数将复制所有内容到窗口的底部。

偏移量和大小参数以设备无关的像素为单位指定。当从高DPI屏幕抓取时，返回的像素图可能大于请求的大小。调用devicePixelRatio()来确定是否是这种情况。

窗口系统标识符（WId）可以使用QWidget::winId()函数来获取。使用窗口标识符而不是QWidget的原因是为了能够抓取不属于应用程序的窗口、窗口系统框架等。

警告

在诸如iOS等系统上，不支持抓取不属于应用程序的窗口，因为沙盒/安全机制阻止读取不属于应用程序的窗口的像素。

grabWindow() 函数从屏幕而不是从窗口抓取像素，也就是说，如果有另一个窗口部分或完全覆盖了你抓取的窗口，你也会从覆盖的窗口中获取像素。鼠标光标通常不会被抓取。

请注意，在X11中，如果给定的window与根窗口的深度不同，并且另一个窗口部分或完全遮挡了你抓取的窗口，你将不会从覆盖的窗口获取像素。在pixmap中被遮挡区域的内容将是未定义和未初始化的。

在Windows Vista及更高版本上，抓取一个通过设置Qt::WA_TranslucentBackground属性创建的分层窗口将不起作用。相反，抓取桌面小部件应该可以工作。

警告

通常情况下，抓取屏幕外的区域是不安全的。这取决于底层的窗口系统。

isLandscape(orientation)
Parameters:

orientation – ScreenOrientation

Return type:

布尔

便捷函数，如果o是横向或反向横向，则返回true；否则返回false。

Qt::PrimaryOrientation 被解释为屏幕的 primaryOrientation() 。

isPortrait(orientation)
Parameters:

orientation – ScreenOrientation

Return type:

布尔

便利函数，如果o是纵向或倒置纵向，则返回true；否则返回false。

Qt::PrimaryOrientation 被解释为屏幕的 primaryOrientation() 。

logicalDotsPerInch()
Return type:

浮点数

属性 logicalDotsPerInchᅟ 的获取器。

logicalDotsPerInchChanged(dpi)
Parameters:

dpi – 浮点数

属性 logicalDotsPerInchXᅟ 的通知信号。

logicalDotsPerInchX()
Return type:

浮点数

属性 logicalDotsPerInchXᅟ 的获取器。

logicalDotsPerInchY()
Return type:

浮点数

属性 logicalDotsPerInchYᅟ 的获取器。

manufacturer()
Return type:

字符串

获取属性 manufacturerᅟ 的Getter。

mapBetween(a, b, rect)
Parameters:
Return type:

QRect

在两个屏幕方向之间映射矩形。

如果方向 a 是 Qt::PortraitOrientation 或 Qt::InvertedPortraitOrientation 并且方向 b 是 Qt::LandscapeOrientation 或 Qt::InvertedLandscapeOrientation，或者反之，这将翻转矩形 rect 的 x 和 y 维度。

Qt::PrimaryOrientation 被解释为屏幕的 primaryOrientation() 。

model()
Return type:

字符串

属性 modelᅟ 的获取器。

name()
Return type:

字符串

获取属性 nameᅟ 的Getter。

nativeInterface()
Return type:

对象

nativeOrientation()
Return type:

ScreenOrientation

属性 nativeOrientationᅟ 的获取器。

orientation()
Return type:

ScreenOrientation

属性 orientationᅟ 的获取器。

orientationChanged(orientation)
Parameters:

orientation – ScreenOrientation

当屏幕方向改变时，会发出此信号，并以orientation作为参数。

另请参阅

orientation()

属性 orientationᅟ 的通知信号。

physicalDotsPerInch()
Return type:

浮点数

属性 physicalDotsPerInchᅟ 的获取器。

physicalDotsPerInchChanged(dpi)
Parameters:

dpi – 浮点数

属性 physicalDotsPerInchXᅟ 的通知信号。

physicalDotsPerInchX()
Return type:

浮点数

属性 physicalDotsPerInchXᅟ 的获取器。

physicalDotsPerInchY()
Return type:

浮点数

属性 physicalDotsPerInchYᅟ 的获取器。

physicalSize()
Return type:

QSizeF

属性 physicalSizeᅟ 的获取器。

physicalSizeChanged(size)
Parameters:

大小 – QSizeF

属性 physicalSizeᅟ 的通知信号。

primaryOrientation()
Return type:

ScreenOrientation

属性 primaryOrientationᅟ 的获取器。

primaryOrientationChanged(orientation)
Parameters:

orientation – ScreenOrientation

当屏幕的主要方向发生变化时，会发出此信号，并以orientation作为参数。

另请参阅

primaryOrientation()

属性 primaryOrientationᅟ 的通知信号。

refreshRate()
Return type:

浮点数

属性 refreshRateᅟ 的获取器。

refreshRateChanged(refreshRate)
Parameters:

refreshRate – 浮点数

属性 refreshRateᅟ 的通知信号。

resolveInterface(name, revision)
Parameters:

  • name – str

  • revision – int

Return type:

void

serialNumber()
Return type:

字符串

属性 serialNumberᅟ 的获取器。

size()
Return type:

QSize

属性 sizeᅟ 的获取器。

transformBetween(a, b, target)
Parameters:
Return type:

QTransform

方便函数，用于计算一个变换，该变换将从由方向a定义的坐标系映射到由方向b和目标尺寸target定义的坐标系。

例如，a 是 Qt::Landscape，b 是 Qt::Portrait，target 是 QRect(0, 0, w, h)，生成的变换将使得点 QPoint(0, 0) 映射到 QPoint(0, w)，而 QPoint(h, w) 映射到 QPoint(0, h)。因此，横向坐标系 QRect(0, 0, h, w) 被映射（通过90度旋转）到纵向坐标系 QRect(0, 0, w, h)。

Qt::PrimaryOrientation 被解释为屏幕的 primaryOrientation() 。

virtualGeometry()
Return type:

QRect

属性 virtualGeometryᅟ 的获取器。

virtualGeometryChanged(rect)
Parameters:

rect – QRect

属性 virtualSizeᅟ 的通知信号。

virtualSiblingAt(point)
Parameters:

点 – QPoint

Return type:

QScreen

返回在virtualSiblings()集合中位于point处的屏幕，如果不在任何屏幕内则返回nullptr。

point 与每组虚拟兄弟的 virtualGeometry() 相关。

virtualSiblings()
Return type:

QScreen的列表

获取屏幕的虚拟兄弟节点。

虚拟兄弟是指共享同一虚拟桌面的屏幕实例。它们共享一个共同的坐标系，窗口可以在它们之间自由移动或定位，而无需重新创建。

virtualSize()
Return type:

QSize

属性 virtualSizeᅟ 的获取器。