Тип QML экрана

Присоединенный объект 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, поскольку на многоэкранном компьютере пользователь может перетащить окно в позицию, где оно занимает несколько экранов. В этом случае некоторые элементы будут на одном экране, а другие — на другом.

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

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.