Тип QML Screen

Присоединённый объект Screen предоставляет информацию о экране, на котором отображается элемент Item или Window. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Присоединённые свойства

• 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 действителен внутри элементов Item или производных от Item, после завершения компоновки. Внутри этих элементов он ссылается на экран, на котором в данный момент отображается элемент.

Присоединённый объект также действителен внутри элементов Window или производных от Window, после завершения компоновки. В этом случае он ссылается на экран, на котором был создан Window. В общем случае лучше получать доступ к Screen из соответствующего элемента Item, так как на компьютере с несколькими мониторами пользователь может перетащить окно так, чтобы оно занимало несколько экранов. В этом случае некоторые элементы Item будут на одном экране, а другие — на другом экране.

Чтобы использовать этот тип, необходимо импортировать модуль с помощью следующей строки:

import QtQuick.Window 2.2

Это отдельный импорт, чтобы вы могли иметь среду QML без доступа к функциям системы окон.

Обратите внимание, что тип Screen не действителен в Component.onCompleted, так как элемент Item или Window ещё не отображён на экране.

Документация по присоединённым свойствам

[только для чтения, начиная с 5.1] Screen.desktopAvailableHeight : int

Содержит доступную высоту коллекции экранов, составляющих виртуальный рабочий стол, в пикселях, за исключением зарезервированных областей менеджера окон, таких как панели задач и системные меню. Если вы хотите расположить окно в нижней части рабочего стола, вы можете связать его с ним следующим образом:

y: Screen.desktopAvailableHeight - height

Это свойство было введено в Qt 5.1.

[только для чтения, начиная с 5.1] Screen.desktopAvailableWidth : int

Содержит доступную ширину коллекции экранов, составляющих виртуальный рабочий стол, в пикселях, за исключением зарезервированных областей менеджера окон, таких как панели задач и системные меню. Если вы хотите расположить окно справа от рабочего стола, вы можете связать его с ним следующим образом:

x: Screen.desktopAvailableWidth - width

Это свойство было введено в Qt 5.1.

[только для чтения, начиная с 5.4] Screen.devicePixelRatio : real

Соотношение между физическими пикселями и пикселями, независимыми от устройства, для экрана.

Общие значения — 1,0 для обычных экранов и 2,0 для экранов Apple «Retina».

Это свойство было введено в Qt 5.4.

[только для чтения] Screen.height : int

Содержит высоту экрана в пикселях.

[только для чтения, начиная с 5.10] Screen.manufacturer : string

Производитель экрана.

Это свойство было введено в Qt 5.10.

[только для чтения, начиная с 5.10] Screen.model : string

Модель экрана.

Это свойство было введено в Qt 5.10.

[только для чтения, начиная с 5.1] Screen.name : string

Имя экрана.

Это свойство было введено в Qt 5.1.

[только для чтения] Screen.orientation : Qt::ScreenOrientation

Содержит текущую ориентацию экрана с точки зрения системы окон.

Большинство мобильных устройств и планшетных компьютеров содержат датчики акселерометра. Система окон может автоматически поворачивать весь экран в зависимости от того, как он удерживается, или вручную через настройки для поворота монитора рабочего стола; в этом случае свойство orientation изменится.

См. также primaryOrientation и QWindow::contentOrientation().

[только для чтения, начиная с 5.2] Screen.pixelDensity : real

Количество физических пикселей на миллиметр.

Это свойство было введено в Qt 5.2.

[только для чтения] Screen.primaryOrientation : Qt::ScreenOrientation

Содержит основную ориентацию экрана. Если высота экрана больше его ширины, то ориентация — Qt.PortraitOrientation; в противном случае — Qt.LandscapeOrientation.

Если вы разрабатываете приложение, которое изменяет свой макет в зависимости от ориентации устройства, вам, вероятно, следует использовать primaryOrientation для определения макета. Это связано с тем, что на настольном компьютере вы можете ожидать изменения primaryOrientation при повороте экрана пользователем через панель управления операционной системы, даже если компьютер не содержит акселерометра. Аналогично на большинстве портативных компьютеров, которые имеют акселерометры, операционная система автоматически будет поворачивать весь экран, поэтому вы снова увидите изменение primaryOrientation.

[только для чтения, начиная с 5.10] Screen.serialNumber : string

Серийный номер экрана.

Это свойство было введено в Qt 5.10.

[только для чтения, начиная с 5.9] Screen.virtualX : int

Координата x экрана на виртуальном рабочем столе.

Это свойство было введено в Qt 5.9.

[только для чтения, начиная с 5.9] Screen.virtualY : int

Координата y экрана на виртуальном рабочем столе.

Это свойство было введено в Qt 5.9.

[только для чтения] Screen.width : int

Содержит ширину экрана в пикселях.

Документация по присоединённым методам

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

Возвращает угол поворота в градусах между указанными ориентациями экрана a и b.