Тип QML экрана

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

• Список всех членов, включая унаследованные
• Заменённые члены

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

• desktopAvailableHeight : int
• desktopAvailableWidth : int
• devicePixelRatio : real
• height : int
• manufacturer : string
• model : string
• name : string
• orientation : Qt::ScreenOrientation
• orientationUpdateMask : Qt::ScreenOrientations
• 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, после завершения компонента. В этом случае он ссылается на экран, на котором было создано окно. В целом лучше получать доступ к экрану из соответствующего элемента Item, потому что на компьютере с несколькими экранами пользователь может перетащить окно в положение, занимающее несколько экранов. В этом случае некоторые элементы будут на одном экране, а другие — на другом.

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

import QtQuick.Window 2.2

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

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

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

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

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

y: Screen.desktopAvailableHeight - height

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

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

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

x: Screen.desktopAvailableWidth - width

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

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

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

Общие значения — 1.0 для обычных дисплеев и 2.0 для дисплеев Apple «retina».

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

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

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

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

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

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

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

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

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

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

Имя экрана.

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

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

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

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

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

Screen.orientationUpdateMask : Qt::ScreenOrientations

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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