Тип QML экрана

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

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

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

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

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

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

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

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

Присоединенный объект также действителен внутри Window или производных от Window типов после завершения компонента. В этом случае он ссылается на экран, где было создано окно. Обычно лучше получить доступ к Screen из соответствующего элемента 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 «retina».

Это свойство 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.width : int

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

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

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

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