Тип QML экрана

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

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

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

• desktopAvailableHeight : int
• desktopAvailableWidth : int
• devicePixelRatio : real
• height : int
• name : string
• orientation : Qt::ScreenOrientation
• orientationUpdateMask : Qt::ScreenOrientations
• pixelDensity : real
• primaryOrientation : Qt::ScreenOrientation
• virtualX : int
• virtualY : int
• width : int

Присоединённые методы

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

Подробное описание

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

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

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

import QtQuick.Window 2.2

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

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

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

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

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

y: Screen.desktopAvailableHeight - height

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

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

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

x: Screen.desktopAvailableWidth - width

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

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

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

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

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

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

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

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

Имя экрана.

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

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

Содержит текущую ориентацию экрана с акселерометра (если таковой имеется). На настольном компьютере это значение обычно не изменяется.

Если primaryOrientation == orientation, это означает, что экран автоматически вращает всё содержимое, отображаемое на нём, в зависимости от того, как вы его держите. Но если ориентация меняется, а primaryOrientation НЕ меняется, то, вероятно, вы используете устройство, которое не вращает собственный дисплей. В этом случае может потребоваться использовать Item.rotation или Item.transform для поворота содержимого.

Примечание: Это свойство не обновляется, если Screen::orientationUpdateMask не установлено в значение, отличное от 0.

Screen.orientationUpdateMask : Qt::ScreenOrientations

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

По умолчанию оно устанавливается в значение QScreen, используемого окном.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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