Класс QDesktopWidget

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

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

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

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

• 214 открытых функций унаследовано от QWidget
• 34 открытых функций унаследовано от QObject
• 14 открытых функций унаследовано от QPaintDevice

Дополнительные унаследованные члены

• 59 свойств унаследовано от QWidget
• 1 свойство унаследовано от QObject
• 19 открытых слотов унаследовано от QWidget
• 1 открытый слот унаследовано от QObject
• 3 сигналов унаследовано от QWidget
• 2 сигнала унаследовано от QObject
• 1 открытой переменной унаследовано от QObject
• 5 статических открытых членов унаследовано от QWidget
• 10 статических открытых членов унаследовано от QObject
• 35 защищенных функций унаследовано от QWidget
• 9 защищенных функций унаследовано от QObject
• 1 защищенная функция унаследовано от QPaintDevice
• 1 защищенный слот унаследовано от QWidget
• 2 защищенных переменных унаследовано от QObject
• 1 защищенный тип унаследовано от QPaintDevice

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

Класс 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.