Class: QgsFocusWatcher

A event filter for watching for focus events on a parent object. Usually QObjects must subclass and override methods like focusOutEvent to handle focus events. Using this class as an event filter avoids the need to subclass objects and the focus events can be directly caught using the emitted signals.

Class Hierarchy

Base classes

QObject

Signals

focusChanged	Emitted when parent object's focus changes.
focusIn	Emitted when parent object gains focus.
focusOut	Emitted when parent object loses focus.

class qgis.gui.QgsFocusWatcher

Bases: QObject

__init__(parent: QObject | None)

Constructor for QgsFocusWatcher.

Parameters:

parent (Optional[QObject]) – parent widget to catch focus events for. This class will automatically be installed as an event filter for parent.

signal focusChanged(focused: bool)

Emitted when parent object’s focus changes.

Parameters:

focused (bool) – True if object gained focus, False if object lost focus

signal focusIn

Emitted when parent object gains focus.

signal focusOut

Emitted when parent object loses focus.