Тип 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(a, Qt::ScreenOrientation b)

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

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

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

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

import QtQuick.Window 2.2

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

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

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

[только для чтения] 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(a, Qt::ScreenOrientation b)

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