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

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