mirror of
https://github.com/qgis/QGIS.git
synced 2025-02-25 00:58:06 -05:00
5654886933
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.
39 lines
1.1 KiB
Plaintext
39 lines
1.1 KiB
Plaintext
/** \ingroup gui
|
|
* \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.
|
|
* \note added in 2.16
|
|
*/
|
|
|
|
class QgsFocusWatcher: QObject
|
|
{
|
|
%TypeHeaderCode
|
|
#include <qgsfocuswatcher.h>
|
|
%End
|
|
|
|
public:
|
|
|
|
/** Constructor for QgsFocusWatcher.
|
|
* @param parent parent widget to catch focus events for. This class will automatically be
|
|
* installed as an event filter for parent.
|
|
*/
|
|
explicit QgsFocusWatcher( QObject* parent /TransferThis/ );
|
|
|
|
virtual bool eventFilter( QObject* obj, QEvent* event );
|
|
|
|
signals:
|
|
|
|
/** Emitted when parent object's focus changes.
|
|
* @param focused true if object gained focus, false if object lost focus
|
|
*/
|
|
void focusChanged( bool focused );
|
|
|
|
//! Emitted when parent object gains focus.
|
|
void focusIn();
|
|
|
|
//! Emitted when parent object loses focus.
|
|
void focusOut();
|
|
};
|