QDesktopWidget 类

The QDesktopWidget 类提供对多头系统屏幕信息的访问。更多...

头：	#include <QDesktopWidget>
qmake:	QT += widgets
继承：	QWidget

该类已过时。 提供它是为使旧源代码能继续工作。强烈建议不要在新代码中使用它。

公共函数

const QRect	availableGeometry (const QWidget * widget ) const
const QRect	screenGeometry (const QWidget * widget ) const
int	screenNumber (const QWidget * widget = nullptr) const

214 公共函数继承自 QWidget
31 公共函数继承自 QObject
14 公共函数继承自 QPaintDevice

静态公共成员

const QMetaObject

staticMetaObject

5 静态公共成员继承自 QWidget
9 静态公共成员继承自 QObject

额外继承成员

59 特性继承自 QWidget
1 特性继承自 QObject
19 公共槽继承自 QWidget
1 公共槽继承自 QObject
3 信号继承自 QWidget
2 信号继承自 QObject
35 保护函数继承自 QWidget
9 保护函数继承自 QObject
1 保护函数继承自 QPaintDevice
1 保护槽继承自 QWidget

详细描述

The QDesktopWidget 类提供对多头系统屏幕信息的访问。

具有多个图形卡和显示器的系统，可以管理作为多个桌面或大型虚拟桌面的可用物理屏幕空间。

此类提供有关用户桌面的信息，如总尺寸、屏幕数、每个屏幕的几何体及把它们配置成单独桌面或单个虚拟桌面。

由 Qt 提供的 Widget 使用此类把工具提示、菜单及对话框放置在其父级 (或应用程序 Widget) 的正确屏幕上。应用程序可以使用此类，以获得可用于保存窗口位置的信息，或在一特定屏幕上放置子级 Widget 和对话框。

The QApplication::desktop () 函数用于获取实例化的 QDesktopWidget .

Widget 的 screenGeometry () 函数，提供有关可用屏幕几何体的信息。返回可用屏幕数，通过 screenCount ，和 screenCountChanged () 信号被发射，当屏幕被添加或移除时。返回特定点或 Widget 所在的屏幕号，通过 screenNumber ().

屏幕几何体

要获得特定屏幕的尺度，调用 screenGeometry () 函数。在某些桌面环境，并非所有屏幕都可供应用程序使用；例如，应用程序 Dock 停靠 (或菜单栏) 可能占用一些空间。使用 availableGeometry () 函数，以获得应用程序的可用区域。

QDesktopWidget 还继承了 QWidget 特性， width () 和 height () 指定桌面尺寸。但是，对于具有多个屏幕的桌面，桌面尺寸是所有屏幕大小的 Union (并集)，因此 width () 和 height () 应该 not 用于计算，要被放置在某一屏幕上的 Widget 尺寸。

在将可用屏幕配置成单个大型虚拟桌面的系统中， virtualDesktop 特性会被设为 true。在这种情况下，Widget 的尺寸通常是所有屏幕的边界矩形尺寸。

首要屏幕的使用

对于应用程序，主 Widget 所在的屏幕是首要屏幕。这被存储在 primaryScreen 特性。打开于应用程序上下文的所有窗口，都应该被约束到首要屏幕边界；例如：它会很不方便，若对话框在不同屏幕中弹出，或分割于 2 屏幕上。

Managing Multiple Screens

在以上插图中，Application One 的首要屏幕是 screen 0，而 App Two 的首要屏幕是 screen 1。

另请参阅 QApplication and QApplication::desktop ().

成员函数文档编制

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

这是重载函数。

返回屏幕的可用几何体，其包含 widget .

另请参阅 screenGeometry ().

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