Класс QScreen
Класс QScreen используется для запроса свойств экрана. Подробнее...
| Заголовок: | #include <QScreen> |
| qmake: | QT += gui |
| С тех пор как: | Qt 5.0 |
| Наследуется от: | QObject |
Свойства
|
|
- 1 свойство унаследовано от QObject
Открытые функции
| ~QScreen() | |
| int | angleBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b) const |
| QRect | availableGeometry() const |
| QSize | availableSize() const |
| QRect | availableVirtualGeometry() const |
| QSize | availableVirtualSize() const |
| int | depth() const |
| qreal | devicePixelRatio() const |
| QRect | geometry() const |
| QPixmap | grabWindow(WId window, int x = 0, int y = 0, int width = -1, int height = -1) |
| QPlatformScreen * | handle() const |
| bool | isLandscape(Qt::ScreenOrientation o) const |
| bool | isPortrait(Qt::ScreenOrientation o) const |
| qreal | logicalDotsPerInch() const |
| qreal | logicalDotsPerInchX() const |
| qreal | logicalDotsPerInchY() const |
| QRect | mapBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b, const QRect &rect) const |
| QString | name() const |
| Qt::ScreenOrientation | nativeOrientation() const |
| Qt::ScreenOrientation | orientation() const |
| Qt::ScreenOrientations | orientationUpdateMask() const |
| qreal | physicalDotsPerInch() const |
| qreal | physicalDotsPerInchX() const |
| qreal | physicalDotsPerInchY() const |
| QSizeF | physicalSize() const |
| Qt::ScreenOrientation | primaryOrientation() const |
| qreal | refreshRate() const |
| void | setOrientationUpdateMask(Qt::ScreenOrientations mask) |
| QSize | size() const |
| QTransform | transformBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b, const QRect &target) const |
| QRect | virtualGeometry() const |
| QList<QScreen *> | virtualSiblings() const |
| QSize | virtualSize() const |
- 31 открытая функция унаследована от QObject
Сигналы
| void | availableGeometryChanged(const QRect &geometry) |
| void | geometryChanged(const QRect &geometry) |
| void | изменённыеЛогическиеТочкиНаДюйм(qreal dpi) |
| void | изменённаяОриентация(Qt::ScreenOrientation orientation) |
| void | изменённыеФизическиеТочкиНаДюйм(qreal dpi) |
| void | изменённыйФизическийРазмер(const QSizeF &size) |
| void | изменённаяОсновнаяОриентация(Qt::ScreenOrientation orientation) |
| void | изменённаяЧастотаОбновления(qreal refreshRate) |
| void | изменённаяВиртуальнаяГеометрия(const QRect &rect) |
- 2 сигнала, унаследованные от QObject
Дополнительные унаследованные члены
- 1 открытый слот, унаследованный от QObject
- 11 статических открытых членов, унаследованных от QObject
- 9 защищённых функций, унаследованных от QObject
Подробное описание
Класс QScreen используется для запроса свойств экрана.
Примечание о логических и физических точках на дюйм: физический DPI основан на фактических физических размерах пикселей, когда они доступны, и полезен для предварительного просмотра печати и других случаев, когда желательно знать точные физические размеры отображаемого на экране содержимого.
Логические точки на дюйм используются для преобразования размеров шрифтов и элементов пользовательского интерфейса из точек в пиксели и могут отличаться от физических точек на дюйм. Логические точки на дюйм иногда могут быть заданы пользователем в настройках среды рабочего стола, чтобы пользователь мог глобально управлять размерами пользовательского интерфейса и шрифтов в разных приложениях.
Документация свойств
availableGeometry : const QRect
Это свойство содержит доступную геометрию экрана в пикселях.
Доступная геометрия — это геометрия, исключающая области, резервируемые менеджером окон, такие как панели задач и системные меню.
Функции доступа:
| QRect | availableGeometry() const |
Сигнал уведомления:
| void | availableGeometryChanged(const QRect &geometry) |
availableSize : const QSize
Это свойство содержит доступный размер экрана в пикселях.
Доступный размер — это размер, исключающий области, резервируемые менеджером окон, такие как панели задач и системные меню.
Функции доступа:
| QSize | availableSize() const |
Сигнал уведомления:
| void | availableGeometryChanged(const QRect &geometry) |
availableVirtualGeometry : const QRect
Это свойство содержит доступную геометрию виртуального рабочего стола, к которому принадлежит этот экран.
Возвращает доступную геометрию виртуального рабочего стола, соответствующего этому экрану.
Это объединение отдельных доступных геометрий виртуальных экранов.
Функции доступа:
| QRect | availableVirtualGeometry() const |
Сигнал уведомления:
| void | virtualGeometryChanged(const QRect &rect) |
См. также availableGeometry() и virtualSiblings().
availableVirtualSize : const QSize
Это свойство содержит доступный размер виртуального рабочего стола, к которому принадлежит этот экран.
Возвращает доступный размер в пикселях виртуального рабочего стола, соответствующего этому экрану.
Это объединенный размер отдельных доступных геометрий виртуальных экранов.
Функции доступа:
| QSize | availableVirtualSize() const |
Сигнал уведомления:
| void | virtualGeometryChanged(const QRect &rect) |
См. также availableSize() и virtualSiblings().
depth : const int
Это свойство содержит цветоглубину экрана.
Функции доступа:
| int | depth() const |
devicePixelRatio : const qreal
Это свойство содержит соотношение физических пикселей и пикселей независимых от устройства для экрана.
Возвращает отношение между физическими пикселями и пикселями независимыми от устройства для экрана.
Общие значения — 1.0 для обычных дисплеев и 2.0 для дисплеев «Retina». Возможны и более высокие значения.
Это свойство было введено в Qt 5.5.
Функции доступа:
| qreal | devicePixelRatio() const |
Сигнал уведомления:
| void | physicalDotsPerInchChanged(qreal dpi) |
См. также QWindow::devicePixelRatio() и QGuiApplication::devicePixelRatio().
geometry : const QRect
Это свойство содержит геометрию экрана в пикселях.
Например, может вернуть QRect(0, 0, 1280, 1024), или, в случае виртуального рабочего стола, QRect(1280, 0, 1280, 1024).
Функции доступа:
| QRect | geometry() const |
Сигнал уведомления:
| void | geometryChanged(const QRect &geometry) |
logicalDotsPerInch : const qreal
Это свойство содержит количество логических точек или пикселей на дюйм.
Это значение может использоваться для преобразования размеров шрифтов в пиксели.
Это вспомогательное свойство, которое представляет собой просто среднее значение свойств logicalDotsPerInchX и logicalDotsPerInchY.
Функции доступа:
| qreal | logicalDotsPerInch() const |
Сигнал уведомления:
| void | logicalDotsPerInchChanged(qreal dpi) |
См. также logicalDotsPerInchX() и logicalDotsPerInchY().
logicalDotsPerInchX : const qreal
Это свойство содержит количество логических точек или пикселей на дюйм в горизонтальном направлении.
Это значение используется для преобразования размеров шрифтов в пиксели.
Функции доступа:
| qreal | logicalDotsPerInchX() const |
Сигнал уведомления:
| void | logicalDotsPerInchChanged(qreal dpi) |
См. также logicalDotsPerInchY().
logicalDotsPerInchY : const qreal
Это свойство содержит количество логических точек или пикселей на дюйм в вертикальном направлении.
Это значение используется для преобразования размеров шрифтов в пиксели.
Функции доступа:
| qreal | logicalDotsPerInchY() const |
Сигнал уведомления:
| void | logicalDotsPerInchChanged(qreal dpi) |
См. также logicalDotsPerInchX().
name : const QString
Это свойство содержит строку, представляющую экран в удобном для пользователя формате.
Например, в X11 они соответствуют именам экранов XRandr, обычно «VGA1», «HDMI1» и т. д.
Функции доступа:
| QString | name() const |
nativeOrientation : const Qt::ScreenOrientation
Это свойство содержит родную ориентацию экрана.
Родная ориентация экрана — это ориентация, в которой логотип устройства отображается правильно, или Qt::PrimaryOrientation, если платформа не поддерживает эту функциональность.
Родная ориентация — свойство оборудования и не изменяется.
Это свойство было введено в Qt 5.2.
Функции доступа:
| Qt::ScreenOrientation | nativeOrientation() const |
orientation : const Qt::ScreenOrientation
Это свойство содержит ориентацию экрана.
Ориентация экрана представляет физическую ориентацию дисплея. Например, ориентация экрана мобильного устройства изменяется в зависимости от того, как он удерживается. Изменение ориентации может или не может вызвать изменение первичной ориентации экрана.
Изменения в этом свойстве будут отфильтрованы с помощью orientationUpdateMask(), поэтому для получения обновлений ориентации приложение должно сначала вызвать setOrientationUpdateMask() с маской ориентаций, которые оно хочет получить.
Qt::PrimaryOrientation никогда не возвращается.
Функции доступа:
| Qt::ScreenOrientation | orientation() const |
Сигнал уведомления:
| void | orientationChanged(Qt::ScreenOrientation orientation) |
См. также primaryOrientation().
physicalDotsPerInch : const qreal
Это свойство содержит количество физических точек или пикселей на дюйм
Это значение представляет плотность пикселей на экране. В зависимости от того, какую информацию предоставляет основная система, значение может быть не совсем точным.
Это вспомогательное свойство, представляющее собой среднее значение свойств physicalDotsPerInchX и physicalDotsPerInchY.
Функции доступа:
| qreal | physicalDotsPerInch() const |
Сигнал уведомления:
| void | physicalDotsPerInchChanged(qreal dpi) |
См. также physicalDotsPerInchX() и physicalDotsPerInchY().
physicalDotsPerInchX : const qreal
Это свойство содержит количество физических точек или пикселей на дюйм по горизонтали
Это значение представляет собой фактическую горизонтальную плотность пикселей на экране. В зависимости от информации, предоставленной основной системой, значение может быть не совсем точным.
Функции доступа:
| qreal | physicalDotsPerInchX() const |
Сигнал уведомления:
| void | physicalDotsPerInchChanged(qreal dpi) |
См. также physicalDotsPerInchY().
physicalDotsPerInchY : const qreal
Это свойство содержит количество физических точек или пикселей на дюйм по вертикали
Это значение представляет собой фактическую вертикальную плотность пикселей на экране. В зависимости от информации, предоставленной основной системой, значение может быть не совсем точным.
Функции доступа:
| qreal | physicalDotsPerInchY() const |
Сигнал уведомления:
| void | physicalDotsPerInchChanged(qreal dpi) |
См. также physicalDotsPerInchX().
physicalSize : const QSizeF
Это свойство содержит физический размер экрана (в миллиметрах)
Физический размер представляет собой фактические физические размеры экрана.
В зависимости от предоставляемой основной системой информации, значение может быть не совсем точным.
Функции доступа:
| QSizeF | physicalSize() const |
Сигнал уведомления:
| void | physicalSizeChanged(const QSizeF &size) |
primaryOrientation : const Qt::ScreenOrientation
Это свойство содержит первичную ориентацию экрана
Первичная ориентация экрана — Qt::LandscapeOrientation, если ширина геометрии экрана больше или равна высоте, или Qt::PortraitOrientation в противном случае. Это свойство может измениться при изменении ориентации экрана (например, при повороте дисплея). Однако поведение зависит от платформы и часто может быть указано в файле манифеста приложения.
Функции доступа:
| Qt::ScreenOrientation | primaryOrientation() const |
Сигнал уведомления:
| void | primaryOrientationChanged(Qt::ScreenOrientation orientation) |
refreshRate : const qreal
Это свойство содержит приблизительную вертикальную частоту обновления экрана в Гц
Функции доступа:
| qreal | refreshRate() const |
Сигнал уведомления:
| void | refreshRateChanged(qreal refreshRate) |
size : const QSize
Это свойство содержит разрешение пикселей экрана
Функции доступа:
| QSize | size() const |
Сигнал уведомления:
| void | geometryChanged(const QRect &geometry) |
virtualGeometry : const QRect
Это свойство содержит пиксельную геометрию виртуального рабочего стола, к которому принадлежит этот экран
Возвращает пиксельную геометрию виртуального рабочего стола, соответствующую этому экрану.
Это объединение отдельных геометрий виртуальных экранов.
Функции доступа:
| QRect | virtualGeometry() const |
Сигнал уведомления:
| void | virtualGeometryChanged(const QRect &rect) |
См. также virtualSiblings().
virtualSize : const QSize
Это свойство содержит пиксельный размер виртуального рабочего стола, к которому принадлежит этот экран
Возвращает пиксельный размер виртуального рабочего стола, соответствующего этому экрану.
Это объединенный размер отдельных геометрий виртуальных экранов.
Функции доступа:
| QSize | virtualSize() const |
Сигнал уведомления:
| void | virtualGeometryChanged(const QRect &rect) |
См. также virtualSiblings().
Документация по функциям-членам
QScreen::~QScreen()
Уничтожает экран.
int QScreen::angleBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b) const
Вспомогательная функция для вычисления угла поворота, необходимого для перехода от поворота a к повороту b.
Результат будет 0, 90, 180 или 270.
Qt::PrimaryOrientation интерпретируется как primaryOrientation экрана.
QPixmap QScreen::grabWindow(WId window, int x = 0, int y = 0, int width = -1, int height = -1)
Создает и возвращает пиксель, созданный захватом содержимого указанного window, ограниченного QRect(x, y, width, height).
Аргументы (x, y) задают смещение в окне, а (width, height) — область, подлежащую копированию. Если width отрицательно, функция копирует всё до правой границы окна. Если height отрицательно, функция копирует всё до нижней границы окна.
Идентификатор системы окон (WId) можно получить с помощью функции QWidget::winId(). Причина использования идентификатора окна, а не QWidget, заключается в возможности захвата окон, которые не являются частью приложения, например, рамок системы окон и т.д.
Функция grabWindow() захватывает пиксели со всего экрана, а не только из окна. То есть, если другое окно частично или полностью перекрывает то, которое вы захватываете, вы также получите пиксели из наложенного окна. Курсор мыши обычно не захватывается.
Обратите внимание, что в X11, если данное window имеет глубину, отличную от глубины корневого окна, и другое окно частично или полностью скрывает окно, которое вы захватываете, вы не получите пикселей из наложенного окна. Содержимое скрытых областей в pixmap будет неопределённым и неинициализированным.
В Windows Vista и выше захват окон с наложением, созданных с помощью атрибута Qt::WA_TranslucentBackground, не будет работать. Вместо этого следует захватить виджет рабочего стола.
Предупреждение: В общем случае захват области вне экрана небезопасен. Это зависит от используемой подсистемы окон.
QPlatformScreen *QScreen::handle() const
Получить десктопную ручку экрана.
bool QScreen::isLandscape(Qt::ScreenOrientation o) const
Функция удобства, которая возвращает true если o — ландшафтная или инвертированная ландшафтная ориентация; в противном случае возвращает false.
Qt::PrimaryOrientation интерпретируется как primaryOrientation экрана.
bool QScreen::isPortrait(Qt::ScreenOrientation o) const
Функция удобства, которая возвращает true если o — портретная или инвертированная портретная ориентация; в противном случае возвращает false.
Qt::PrimaryOrientation интерпретируется как primaryOrientation экрана.
QRect QScreen::mapBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b, const QRect &rect) const
Преобразует прямоугольник между двумя ориентациями экрана.
Это перевернёт ширину и высоту прямоугольника rect, если ориентация a — Qt::PortraitOrientation или Qt::InvertedPortraitOrientation, а ориентация b — Qt::LandscapeOrientation или Qt::InvertedLandscapeOrientation, или наоборот.
Qt::PrimaryOrientation интерпретируется как primaryOrientation экрана.
[signal] void QScreen::orientationChanged(Qt::ScreenOrientation orientation)
Этот сигнал испускается, когда ориентация экрана изменяется, с orientation в качестве аргумента.
Примечание: Сигнал-уведомление для свойства orientation.
См. также orientation().
Qt::ScreenOrientations QScreen::orientationUpdateMask() const
Возвращает текущую установленную маску обновления ориентации.
См. также setOrientationUpdateMask().
[signal] void QScreen::primaryOrientationChanged(Qt::ScreenOrientation orientation)
Этот сигнал испускается, когда первичная ориентация экрана изменяется, с orientation в качестве аргумента.
Примечание: Сигнал-уведомление для свойства primaryOrientation.
См. также primaryOrientation().
void QScreen::setOrientationUpdateMask(Qt::ScreenOrientations mask)
Устанавливает ориентации, для которых приложение интересуется получением обновлений в совокупности с этим экраном.
Например, чтобы получить обновления orientation() и таким образом, чтобы сигналы orientationChanged() испускались для LandscapeOrientation и InvertedLandscapeOrientation, вызовите setOrientationUpdateMask() с mask, установленным как Qt::LandscapeOrientation | Qt::InvertedLandscapeOrientation.
По умолчанию, 0, означает, что сигналы orientationChanged() не генерируются.
См. также orientationUpdateMask().
QTransform QScreen::transformBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b, const QRect &target) const
Функция удобства для вычисления преобразования, которое отображает систему координат, определённую ориентацией a, в систему координат, определённую ориентацией b, и целевыми размерами target.
Например, если a — Qt::Landscape, b — Qt::Portrait, а target — QRect(0, 0, w, h), результирующее преобразование будет таким, что точка QPoint(0, 0) отобразится в QPoint(0, w), а QPoint(h, w) — в QPoint(0, h). Таким образом, система координат ландшафта QRect(0, 0, h, w) отображается (с поворотом на 90 градусов) в систему координат портрета QRect(0, 0, w, h).
Qt::PrimaryOrientation интерпретируется как primaryOrientation экрана.
QList<QScreen *> QScreen::virtualSiblings() const
Получить виртуальных братьев/сестёр экрана.
Виртуальные братья/сёстры — это экземпляры экранов, которые делят один и тот же виртуальный рабочий стол. Они делят общую систему координат, и окна могут свободно перемещаться или позиционироваться между ними, не требуя повторного создания.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.6/qscreen.html