Class: QgsScreenHelper

A utility class for dynamic handling of changes to screen properties.

Added in version 3.28.

Class Hierarchy

Base classes

QObject

Methods

availableGeometry	Returns the current screen available geometry in pixels.
screen	Returns the screen that the parent widget appears on, or None.
screenDpi	Returns the current screen DPI for the screen that the parent widget appears on.
windowHandle	Returns the window handle for the window the parent widget is associated with, or None.

Signals

availableGeometryChanged	Emitted whenever the available geometry of the screen associated with the widget is changed.
screenDpiChanged	Emitted whenever the screen dpi associated with the widget is changed.

class qgis.gui.QgsScreenHelper

Bases: QObject

__init__(parent: QWidget | None)

Constructor for QgsScreenHelper for the specified parent widget.

Parameters:

parent (Optional[QWidget])

availableGeometry(self) → QRect

Returns the current screen available geometry in pixels.

The available geometry is the geometry excluding window manager reserved areas such as task bars and system menus.

See also

availableGeometryChanged()

Return type:

QRect

signal availableGeometryChanged(geometry: QRect)

Emitted whenever the available geometry of the screen associated with the widget is changed.

See also

availableGeometry()

Parameters:

geometry (QRect)

screen(self) → QScreen | None

Returns the screen that the parent widget appears on, or None.

Return type:

Optional[QScreen]

screenDpi(self) → float

Returns the current screen DPI for the screen that the parent widget appears on.

See also

screenDpiChanged()

Return type:

float

signal screenDpiChanged(dpi: float)

Emitted whenever the screen dpi associated with the widget is changed.

See also

screenDpi()

Parameters:

dpi (float)

windowHandle(self) → QWindow | None

Returns the window handle for the window the parent widget is associated with, or None.

Return type:

Optional[QWindow]