QEvent¶

Description¶

The QEvent class is the base class of all event classes. Event objects contain event parameters.

Qt’s main event loop (exec()) fetches native window system events from the event queue, translates them into QEvents, and sends the translated events to QObjects.

In general, events come from the underlying window system (spontaneous() returns true), but it is also possible to manually send events using sendEvent() and postEvent() (spontaneous() returns false).

QObject receive events by having their event() function called. The function can be reimplemented in subclasses to customize event handling and add additional event types; event() is a notable example. By default, events are dispatched to event handlers like timerEvent() and mouseMoveEvent(). installEventFilter() allows an object to intercept events destined for another object.

The basic QEvent contains only an event type parameter and an “accept” flag. The accept flag set with accept(), and cleared with ignore(). It is set by default, but don’t rely on this as subclasses may choose to clear it in their constructor.

Subclasses of QEvent contain additional parameters that describe the particular event.

Enums¶

Type

This enum type defines the valid event types in Qt. The event types and the specialized classes for each type are as follows:

User events should have values between User and MaxUser:

For convenience, you can use the registerEventType() function to register and reserve a custom event type for your application. Doing so will allow you to avoid accidentally re-using a custom event type already in use elsewhere in your application.

Member	Value	Description
ActionAdded	114	A new action has been added (QActionEvent).
ActionChanged	113	An action has been changed (QActionEvent).
ActionRemoved	115	An action has been removed (QActionEvent).
ActivationChange	99	A widget’s top-level window activation state has changed.
ApplicationActivate	121	This enum has been deprecated. Use ApplicationStateChange instead.
ApplicationActivated	ApplicationActivate	This enum has been deprecated. Use ApplicationStateChange instead.
ApplicationDeactivate	122	This enum has been deprecated. Use ApplicationStateChange instead.
ApplicationDeactivated	TODO	TODO
ApplicationFontChange	36	The default application font has changed.
ApplicationLayoutDirectionChange	37	The default application layout direction has changed.
ApplicationPaletteChange	38	The default application palette has changed.
ApplicationStateChange	TODO	The state of the application has changed.
ApplicationWindowIconChange	35	The application’s icon has changed.
ChildAdded	68	An object gets a child (QChildEvent).
ChildPolished	69	A widget child gets polished (QChildEvent).
ChildRemoved	71	An object loses a child (QChildEvent).
Clipboard	40	The clipboard contents have changed.
Close	19	Widget was closed (QCloseEvent).
CloseSoftwareInputPanel	200	A widget wants to close the software input panel (SIP).
ContentsRectChange	178	The margins of the widget’s content rect changed.
ContextMenu	82	Context popup menu (QContextMenuEvent).
CursorChange	183	The widget’s cursor has changed.
DeferredDelete	52	The object will be deleted after it has cleaned up (QDeferredDeleteEvent)
DragEnter	60	The cursor enters a widget during a drag and drop operation (QDragEnterEvent).
DragLeave	62	The cursor leaves a widget during a drag and drop operation (QDragLeaveEvent).
DragMove	61	A drag and drop operation is in progress (QDragMoveEvent).
Drop	63	A drag and drop operation is completed (QDropEvent).
DynamicPropertyChange	170	A dynamic property was added, changed, or removed from the object.
EnabledChange	98	Widget’s enabled state has changed.
Enter	10	Mouse enters widget’s boundaries (QEnterEvent).
EnterWhatsThisMode	124	Send to toplevel widgets when the application enters “What’s This?” mode.
Expose	TODO	Sent to a window when its on-screen contents are invalidated and need to be flushed from the backing store.
FileOpen	116	File open request (QFileOpenEvent).
FocusAboutToChange	TODO	Widget or Window focus is about to change (QFocusEvent)
FocusIn	8	Widget or Window gains keyboard focus (QFocusEvent).
FocusOut	9	Widget or Window loses keyboard focus (QFocusEvent).
FontChange	97	Widget’s font has changed.
Gesture	198	A gesture was triggered (QGestureEvent).
GestureOverride	202	A gesture override was triggered (QGestureEvent).
GrabKeyboard	188	Item gains keyboard grab (QGraphicsItem only).
GrabMouse	186	Item gains mouse grab (QGraphicsItem only).
GraphicsSceneContextMenu	159	Context popup menu over a graphics scene (QGraphicsSceneContextMenuEvent).
GraphicsSceneDragEnter	164	The cursor enters a graphics scene during a drag and drop operation (QGraphicsSceneDragDropEvent).
GraphicsSceneDragLeave	166	The cursor leaves a graphics scene during a drag and drop operation (QGraphicsSceneDragDropEvent).
GraphicsSceneDragMove	165	A drag and drop operation is in progress over a scene (QGraphicsSceneDragDropEvent).
GraphicsSceneDrop	167	A drag and drop operation is completed over a scene (QGraphicsSceneDragDropEvent).
GraphicsSceneHelp	163	The user requests help for a graphics scene (QHelpEvent).
GraphicsSceneHoverEnter	160	The mouse cursor enters a hover item in a graphics scene (QGraphicsSceneHoverEvent).
GraphicsSceneHoverLeave	162	The mouse cursor leaves a hover item in a graphics scene (QGraphicsSceneHoverEvent).
GraphicsSceneHoverMove	161	The mouse cursor moves inside a hover item in a graphics scene (QGraphicsSceneHoverEvent).
GraphicsSceneMouseDoubleClick	158	Mouse press again (double click) in a graphics scene (QGraphicsSceneMouseEvent).
GraphicsSceneMouseMove	155	Move mouse in a graphics scene (QGraphicsSceneMouseEvent).
GraphicsSceneMousePress	156	Mouse press in a graphics scene (QGraphicsSceneMouseEvent).
GraphicsSceneMouseRelease	157	Mouse release in a graphics scene (QGraphicsSceneMouseEvent).
GraphicsSceneMove	182	Widget was moved (QGraphicsSceneMoveEvent).
GraphicsSceneResize	181	Widget was resized (QGraphicsSceneResizeEvent).
GraphicsSceneWheel	168	Mouse wheel rolled in a graphics scene (QGraphicsSceneWheelEvent).
Hide	18	Widget was hidden (QHideEvent).
HideToParent	27	A child widget has been hidden.
HoverEnter	127	The mouse cursor enters a hover widget (QHoverEvent).
HoverLeave	128	The mouse cursor leaves a hover widget (QHoverEvent).
HoverMove	129	The mouse cursor moves inside a hover widget (QHoverEvent).
IconDrag	96	The main icon of a window has been dragged away (QIconDragEvent).
IconTextChange	101	Widget’s icon text has been changed. (Deprecated)
InputMethod	83	An input method is being used (QInputMethodEvent).
InputMethodQuery	TODO	A input method query event (QInputMethodQueryEvent)
KeyboardLayoutChange	169	The keyboard layout has changed.
KeyPress	6	Key press (QKeyEvent).
KeyRelease	7	Key release (QKeyEvent).
LanguageChange	89	The application translation changed.
LayoutDirectionChange	90	The direction of layouts changed.
LayoutRequest	76	Widget layout needs to be redone.
Leave	11	Mouse leaves widget’s boundaries.
LeaveWhatsThisMode	125	Send to toplevel widgets when the application leaves “What’s This?” mode.
LocaleChange	88	The system locale has changed.
MacSizeChange	177	The user changed his widget sizes (macOS only).
MaxUser	65535	Last user event ID.
MetaCall	43	An asynchronous method invocation via invokeMethod().
ModifiedChange	102	Widgets modification state has been changed.
MouseButtonDblClick	4	Mouse press again (QMouseEvent).
MouseButtonPress	2	Mouse press (QMouseEvent).
MouseButtonRelease	3	Mouse release (QMouseEvent).
MouseMove	5	Mouse move (QMouseEvent).
MouseTrackingChange	109	The mouse tracking state has changed.
Move	13	Widget’s position changed (QMoveEvent).
NonClientAreaMouseButtonDblClick	176	A mouse double click occurred outside the client area (QMouseEvent).
NonClientAreaMouseButtonPress	174	A mouse button press occurred outside the client area (QMouseEvent).
NonClientAreaMouseButtonRelease	175	A mouse button release occurred outside the client area (QMouseEvent).
NonClientAreaMouseMove	173	A mouse move occurred outside the client area (QMouseEvent).
None_	0	Not an event.
OkRequest	TODO	TODO
OrientationChange	TODO	The screens orientation has changes (QScreenOrientationChangeEvent).
Paint	12	Screen update necessary (QPaintEvent).
PaletteChange	39	Palette of the widget changed.
ParentAboutToChange	131	The widget parent is about to change.
ParentChange	21	The widget parent has changed.
PlatformPanel	212	A platform specific panel has been requested.
PlatformSurface	TODO	A native platform surface has been created or is about to be destroyed (QPlatformSurfaceEvent).
Polish	75	The widget is polished.
PolishRequest	74	The widget should be polished.
QueryWhatsThis	123	The widget should accept the event if it has “What’s This?” help (QHelpEvent).
ReadOnlyChange	TODO	Widget’s read-only state has changed (since Qt 5.4).
RequestSoftwareInputPanel	199	A widget wants to open a software input panel (SIP).
Resize	14	Widget’s size changed (QResizeEvent).
Scroll	TODO	The object needs to scroll to the supplied position (QScrollEvent).
ScrollPrepare	TODO	The object needs to fill in its geometry information (QScrollPrepareEvent).
Shortcut	117	Key press in child for shortcut key handling (QShortcutEvent).
ShortcutOverride	51	Key press in child, for overriding shortcut key handling (QKeyEvent). When a shortcut is about to trigger, `ShortcutOverride` is sent to the active window. This allows clients (e.g. widgets) to signal that they will handle the shortcut themselves, by accepting the event. If the shortcut override is accepted, the event is delivered as a normal key press to the focus widget. Otherwise, it triggers the shortcut action, if one exists.
Show	17	Widget was shown on screen (QShowEvent).
ShowToParent	26	A child widget has been shown.
SockAct	50	Socket activated, used to implement QSocketNotifier.
StateMachineSignal	192	A signal delivered to a state machine (SignalEvent).
StateMachineWrapped	193	The event is a wrapper for, i.e., contains, another event (WrappedEvent).
StatusTip	112	A status tip is requested (QStatusTipEvent).
StyleChange	100	Widget’s style has been changed.
TabletEnterProximity	171	Wacom tablet enter proximity event (QTabletEvent), sent to QApplication.
TabletLeaveProximity	172	Wacom tablet leave proximity event (QTabletEvent), sent to QApplication.
TabletMove	87	Wacom tablet move (QTabletEvent).
TabletPress	92	Wacom tablet press (QTabletEvent).
TabletRelease	93	Wacom tablet release (QTabletEvent).
TabletTrackingChange	TODO	The Wacom tablet tracking state has changed (since Qt 5.9).
ThreadChange	22	The object is moved to another thread. This is the last event sent to this object in the previous thread. See moveToThread().
Timer	1	Regular timer events (QTimerEvent).
ToolBarChange	120	The toolbar button is toggled on macOS.
ToolTip	110	A tooltip was requested (QHelpEvent).
ToolTipChange	184	The widget’s tooltip has changed.
TouchBegin	194	Beginning of a sequence of touch-screen or track-pad events (QTouchEvent).
TouchCancel	TODO	Cancellation of touch-event sequence (QTouchEvent).
TouchEnd	196	End of touch-event sequence (QTouchEvent).
TouchUpdate	195	Touch-screen event (QTouchEvent).
UngrabKeyboard	189	Item loses keyboard grab (QGraphicsItem only).
UngrabMouse	187	Item loses mouse grab (QGraphicsItem, QQuickItem).
UpdateLater	78	The widget should be queued to be repainted at a later time.
UpdateRequest	77	The widget should be repainted.
User	1000	User-defined event.
WhatsThis	111	The widget should reveal “What’s This?” help (QHelpEvent).
WhatsThisClicked	118	A link in a widget’s “What’s This?” help was clicked.
Wheel	31	Mouse wheel rolled (QWheelEvent).
WindowActivate	24	Window was activated.
WindowBlocked	103	The window is blocked by a modal dialog.
WindowDeactivate	25	Window was deactivated.
WindowIconChange	34	The window’s icon has changed.
WindowStateChange	105	The windowState() (minimized, maximized or full-screen) has changed (QWindowStateChangeEvent).
WindowTitleChange	33	The window title has changed.
WindowUnblocked	104	The window is unblocked after a modal dialog exited.
WinEventAct	132	A Windows-specific activation event has occurred.
WinIdChange	203	The window system identifer for this native widget has changed.
ZOrderChange	126	The widget’s z-order has changed. This event is never sent to top level windows.

Methods¶

__init__(Type): Contructs an event object of type type.

__init__(QEvent): TODO

accept(): TODO

ignore(): TODO

isAccepted() → bool: TODO

@staticmethod registerEventType(hint: int = -1) → int: TODO

setAccepted(bool): See also

isAccepted().

spontaneous() → bool: TODO

type() → Type: TODO