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

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

import QtQuick.Window 2.2

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

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

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

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

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

y: Screen.desktopAvailableHeight - height

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

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

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

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)

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