屏幕 QML 类型

Screen 连接对象提供了有关项或窗口当前显示在哪个屏幕的信息。更多...

导入语句	import QtQuick

附加属性

desktopAvailableHeight : int
desktopAvailableWidth : int
devicePixelRatio : real
height : int
manufacturer : string
model : string
name : string
orientation : Qt::ScreenOrientation
pixelDensity : real
primaryOrientation : Qt::ScreenOrientation
serialNumber : string
virtualX : int
virtualY : int
width : int

附加方法

int angleBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b)

详细描述

Screen 连接对象在元素或从元素派生出的类型中有效，组件完成后。在这些元素中，它指的是元素当前显示在的屏幕。

在 Window 或从 Window 派生出的类型中，连接对象也有效，组件完成后。在这种情况下，它指的是 Window 创建的屏幕。通常，最好从相关的元素访问 Screen，因为在多屏桌面计算机上，用户可以拖动窗口到跨越多个屏幕的位置。在这种情况下，一些元素将位于一个屏幕上，而另一些元素则位于不同的屏幕上。

要使用此类型，您需要使用以下行导入模块

import QtQuick.Window 2.2

这是单独导入，以便您可以在没有访问窗口系统功能的环境中拥有 QML 环境。

请注意，在 Component.onCompleted 时 Screen 类型无效，因为此时元素或窗口尚未在屏幕上显示。

另请参阅Qt Quick 示例 - 窗口和屏幕.

附加属性文档

Screen.desktopAvailableHeight : int [只读]

这包含了组成虚拟桌面的所有屏幕的可用高度，以像素为单位，不包括窗口管理器保留区域，例如任务栏和系统菜单。如果您想将窗口置于桌面底部，可以绑定如下

y: Screen.desktopAvailableHeight - height

Screen.desktopAvailableWidth : int [只读]

这包含了组成虚拟桌面的所有屏幕的可用宽度，以像素为单位，不包括窗口管理器保留区域，例如任务栏和系统菜单。如果您想将窗口置于桌面右侧，可以绑定如下

x: Screen.desktopAvailableWidth - width

Screen.devicePixelRatio : real [只读]

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

常见值是正常显示器上的1.0和Apple "视网膜"显示器上的2.0。

Screen.height : int [只读]

这包含了屏幕的高度，以像素为单位。

Screen.manufacturer : string [只读]

屏幕的制造商。

Screen.model : string [只读]

屏幕的型号。

Screen.name : string [只读]

屏幕的名称。

Screen.orientation : Qt::ScreenOrientation [只读]

这包含了屏幕从窗口系统角度来看的当前方向。

大多数移动设备和平板电脑都包含加速度计传感器。窗口系统可能会根据屏幕的持握方式自动旋转整个屏幕，或者通过设置手动旋转桌面显示器；在这种情况下，这个orientation属性将改变。

另请参见 primaryOrientation 和 QWindow::contentOrientation。

Screen.pixelDensity : real [只读]

每毫米的物理像素数。

Screen.primaryOrientation : Qt::ScreenOrientation [只读]

这包含了屏幕的主要方向。如果屏幕的高度大于宽度，则方向为Qt.PortraitOrientation；否则为Qt.LandscapeOrientation。

如果您设计的是一个根据设备方向改变布局的应用程序，您可能想使用primaryOrientation来决定布局。这是因为即使在计算机中没有加速度计的桌面计算机上，您也可以期望在用户通过操作系统的控制面板旋转屏幕时primaryOrientation会改变。同样，在大多数带有加速度计的手持计算机上，操作系统也会自动旋转整个屏幕，因此您将再次看到primaryOrientation的改变。

Screen.serialNumber : string [只读]

屏幕的序列号。

Screen.virtualX : int [只读]

屏幕在虚拟桌面中的x坐标。

Screen.virtualY : int [只读]

虚拟桌面内屏幕的y坐标。

Screen.width : int [只读]

该值包含屏幕的像素宽度。

附加方法文档

int angleBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b)

返回指定屏幕方向a和b之间的旋转角度（以度为单位）。