内容表

上一话题

QDateTimeEdit

下一话题

QDial

QDesktopWidget

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

Inheritance diagram of PySide2.QtWidgets.QDesktopWidget

概要

函数

信号

详细描述

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

This class provides information about the user’s desktop, such as its total size, number of screens, the geometry of each screen, and whether they are configured as separate desktops or a single virtual desktop.

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

获得桌面 Widget

desktop() function is used to get an instance of QDesktopWidget .

The widget’s screenGeometry() function provides information about the geometry of the available screens with. The number of screens available is returned by screenCount ,和 screenCountChanged() signal is emitted when screens are added or removed. The screen number that a particular point or widget is located in is returned by screenNumber() .

屏幕几何体

要获得特定屏幕的尺度,调用 screenGeometry() function. On some desktop environments, not all of the screen is available for applications to use; for example, an application dock or menu bar may take up some space. Use the availableGeometry() function to obtain the available area for applications.

QDesktopWidget also inherits the QWidget 特性, width() and height() , which specify the size of the desktop. However, for desktops with multiple screens, the size of the desktop is the union of all the screen sizes, so width() and height() should not 用于计算,要被放置在某一屏幕上的 Widget 尺寸。

在将可用屏幕配置成单个大型虚拟桌面的系统中, virtualDesktop property will be set to true. In this case, the widget’s size is usually the size of the bounding rectangle of all the screens.

首要屏幕的使用

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

../../_images/qdesktopwidget.png

In the illustration above, Application One’s primary screen is screen 0, and App Two’s primary screen is screen 1.

class QDesktopWidget
PySide2.QtWidgets.QDesktopWidget. availableGeometry ( point )
参数

point QPoint

返回类型

QRect

注意

此函数被弃用。

PySide2.QtWidgets.QDesktopWidget. availableGeometry ( widget )
参数

widget QWidget

返回类型

QRect

这是重载函数。

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

另请参阅

screenGeometry()

PySide2.QtWidgets.QDesktopWidget. availableGeometry ( [ screen=-1 ] )
参数

screen int

返回类型

QRect

注意

此函数被弃用。

Returns the available geometry of the screen with index screen . What is available will be subrect of screenGeometry() based on what the platform decides is available (for example excludes the dock and menu bar on macOS, or the task bar on Windows). The default screen is used if screen is -1.

使用 screens() 代替。

另请参阅

screenNumber() screenGeometry() availableGeometry()

PySide2.QtWidgets.QDesktopWidget. isVirtualDesktop ( )
返回类型

bool

注意

此函数被弃用。

PySide2.QtWidgets.QDesktopWidget. numScreens ( )
返回类型

int

注意

此函数被弃用。

返回可用屏幕的编号。

使用 screens() 代替。

另请参阅

primaryScreen

PySide2.QtWidgets.QDesktopWidget. primaryScreen ( )
返回类型

int

注意

此函数被弃用。

PySide2.QtWidgets.QDesktopWidget. primaryScreenChanged ( )

注意

此函数被弃用。

PySide2.QtWidgets.QDesktopWidget. resized ( arg__1 )
参数

arg__1 int

注意

此函数被弃用。

PySide2.QtWidgets.QDesktopWidget. screen ( [ screen=-1 ] )
参数

screen int

返回类型

QWidget

注意

此函数被弃用。

Returns a widget that represents the screen with index screen (a value of -1 means the default screen).

If the system uses a virtual desktop, the returned widget will have the geometry of the entire virtual desktop; i.e., bounding every screen .

使用 QScreen 代替。

另请参阅

primaryScreen screenCount virtualDesktop

PySide2.QtWidgets.QDesktopWidget. screenCount ( )
返回类型

int

注意

此函数被弃用。

PySide2.QtWidgets.QDesktopWidget. screenCountChanged ( arg__1 )
参数

arg__1 int

注意

此函数被弃用。

PySide2.QtWidgets.QDesktopWidget. screenGeometry ( point )
参数

point QPoint

返回类型

QRect

注意

此函数被弃用。

PySide2.QtWidgets.QDesktopWidget. screenGeometry ( widget )
参数

widget QWidget

返回类型

QRect

这是重载函数。

返回屏幕的几何体,其包含 widget .

PySide2.QtWidgets.QDesktopWidget. screenGeometry ( [ screen=-1 ] )
参数

screen int

返回类型

QRect

注意

此函数被弃用。

Returns the geometry of the screen with index screen . The default screen is used if screen is -1.

使用 screens() 代替。

另请参阅

screenNumber()

PySide2.QtWidgets.QDesktopWidget. screenNumber ( [ widget=None ] )
参数

widget QWidget

返回类型

int

返回屏幕的索引,包含最大部分的 widget ,或 -1 若 Widget 不在屏幕上。

另请参阅

primaryScreen

PySide2.QtWidgets.QDesktopWidget. screenNumber ( arg__1 )
参数

arg__1 QPoint

返回类型

int

注意

此函数被弃用。

PySide2.QtWidgets.QDesktopWidget. workAreaResized ( arg__1 )
参数

arg__1 int

注意

此函数被弃用。