Класс QDesktopWidget

Класс QDesktopWidget предоставляет доступ к информации о экранах в многоэкранных системах. Подробнее...

Этот класс устарел. Он предоставляется для поддержки старого исходного кода. Мы настоятельно рекомендуем не использовать его в новом коде.

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

Открытые функции

Подробное описание

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

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

Виджеты, предоставляемые Qt, используют этот класс для размещения всплывающих подсказок, меню и диалоговых окон на правильном экране для своих родительских или прикладных виджетов. Приложения могут использовать этот класс для получения информации, которая может использоваться для сохранения позиций окон или для размещения дочерних виджетов и диалоговых окон на определенном экране.

Получение виджета рабочего стола

Функция QApplication::desktop() используется для получения экземпляра QDesktopWidget.

Функция screenGeometry() виджета предоставляет информацию о геометрии доступных экранов. Количество доступных экранов возвращается функцией screenCount, а сигнал screenCountChanged() генерируется при добавлении или удалении экранов. Номер экрана, в котором находится определенная точка или виджет, возвращается функцией screenNumber().

Геометрия экрана

Для получения размеров определенного экрана вызовите функцию screenGeometry(). В некоторых средах рабочего стола не все пространство экрана доступно для использования приложениями; например, панель задач или панель меню приложения могут занимать некоторое место. Используйте функцию availableGeometry() для получения доступной области для приложений.

QDesktopWidget также наследует свойства QWidget, width() и height(), которые указывают размер рабочего стола. Однако для рабочих столов с несколькими экранами размер рабочего стола является объединением размеров всех экранов, поэтому width() и height() не должны использоваться для вычисления размера виджета, который будет размещен на одном из экранов.

В системах, сконфигурированных для использования доступных экранов как единого большого виртуального рабочего стола, свойство virtualDesktop будет установлено в true. В этом случае размер виджета обычно равен размеру ограничивающего прямоугольника всех экранов.

Использование основного экрана

Для приложения экраном, на котором находится главный виджет, является основной экран. Это хранится в свойстве primaryScreen. Все окна, открытые в контексте приложения, должны быть ограничены границами основного экрана; например, неудобно, если диалоговое окно появляется на другом экране или разделено на два экрана.

На иллюстрации выше, основной экран для Приложения Один — экран 0, а для Приложения Два — экран 1.

См. также QApplication и QApplication::desktop().

Документация по членам функций

const QRect QDesktopWidget::availableGeometry(const QWidget *widget) const

Это перегруженная функция.

Возвращает доступную геометрию экрана, содержащего widget.

См. также screenGeometry().

const QRect QDesktopWidget::screenGeometry(const QWidget *widget) const

Это перегруженная функция.

Возвращает геометрию экрана, содержащего widget.

int QDesktopWidget::screenNumber(const QWidget *widget = nullptr) const

Возвращает индекс экрана, содержащего большую часть widget, или -1, если виджет не находится на экране.

См. также primaryScreen.