Тип QML Screen

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

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

Свойства

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

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

import QtQuick.Window 2.2

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

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

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

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

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

y: Screen.desktopAvailableHeight - height

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

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

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

x: Screen.desktopAvailableWidth - width

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Имя экрана.

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

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

Содержит текущую ориентацию экрана с точки зрения системы окон.

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

См. также primaryOrientation и QWindow::contentOrientation().

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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