Тип QML Screen

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

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

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

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

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