The QFocusEvent class contains event parameters for widget focus events. More...

#include <qevent.h>

Inheritance diagram for QFocusEvent:

Collaboration diagram for QFocusEvent:

Public Member Functions
	QFocusEvent (Type type, Qt::FocusReason reason=Qt::OtherFocusReason)
	Constructs a focus event object.

bool	gotFocus () const
	Returns `true` if type() is QEvent::FocusIn; otherwise returns false.

bool	lostFocus () const
	Returns `true` if type() is QEvent::FocusOut; otherwise returns false.

Qt::FocusReason	reason () const
	Returns the reason for this focus event.

Public Member Functions inherited from QEvent
	QEvent (Type type)
	Constructs an event object of type type.

virtual	~QEvent ()
	Destroys the event.

Type	type () const
	Returns the event type.

bool	spontaneous () const
	Returns `true` if the event originated outside the application (a system event); otherwise returns `false`.

virtual void	setAccepted (bool accepted)

bool	isAccepted () const

void	accept ()
	Sets the accept flag of the event object, the equivalent of calling setAccepted(true).

void	ignore ()
	Clears the accept flag parameter of the event object, the equivalent of calling setAccepted(false).

bool	isInputEvent () const noexcept

bool	isPointerEvent () const noexcept

bool	isSinglePointEvent () const noexcept

virtual QEvent *	clone () const
	Creates and returns an identical copy of this event.

Additional Inherited Members
Public Types inherited from QEvent
enum	Type { None = 0 , Timer = 1 , MouseButtonPress = 2 , MouseButtonRelease = 3 , MouseButtonDblClick = 4 , MouseMove = 5 , KeyPress = 6 , KeyRelease = 7 , FocusIn = 8 , FocusOut = 9 , FocusAboutToChange = 23 , Enter = 10 , Leave = 11 , Paint = 12 , Move = 13 , Resize = 14 , Create = 15 , Destroy = 16 , Show = 17 , Hide = 18 , Close = 19 , Quit = 20 , ParentChange = 21 , ParentAboutToChange = 131 , ThreadChange = 22 , WindowActivate = 24 , WindowDeactivate = 25 , ShowToParent = 26 , HideToParent = 27 , Wheel = 31 , WindowTitleChange = 33 , WindowIconChange = 34 , ApplicationWindowIconChange = 35 , ApplicationFontChange = 36 , ApplicationLayoutDirectionChange = 37 , ApplicationPaletteChange = 38 , PaletteChange = 39 , Clipboard = 40 , Speech = 42 , MetaCall = 43 , SockAct = 50 , WinEventAct = 132 , DeferredDelete = 52 , DragEnter = 60 , DragMove = 61 , DragLeave = 62 , Drop = 63 , DragResponse = 64 , ChildAdded = 68 , ChildPolished = 69 , ChildRemoved = 71 , ShowWindowRequest = 73 , PolishRequest = 74 , Polish = 75 , LayoutRequest = 76 , UpdateRequest = 77 , UpdateLater = 78 , EmbeddingControl = 79 , ActivateControl = 80 , DeactivateControl = 81 , ContextMenu = 82 , InputMethod = 83 , TabletMove = 87 , LocaleChange = 88 , LanguageChange = 89 , LayoutDirectionChange = 90 , Style = 91 , TabletPress = 92 , TabletRelease = 93 , OkRequest = 94 , HelpRequest = 95 , IconDrag = 96 , FontChange = 97 , EnabledChange = 98 , ActivationChange = 99 , StyleChange = 100 , IconTextChange = 101 , ModifiedChange = 102 , MouseTrackingChange = 109 , WindowBlocked = 103 , WindowUnblocked = 104 , WindowStateChange = 105 , ReadOnlyChange = 106 , ToolTip = 110 , WhatsThis = 111 , StatusTip = 112 , ActionChanged = 113 , ActionAdded = 114 , ActionRemoved = 115 , FileOpen = 116 , Shortcut = 117 , ShortcutOverride = 51 , WhatsThisClicked = 118 , ToolBarChange = 120 , ApplicationActivate = 121 , ApplicationActivated = ApplicationActivate , ApplicationDeactivate = 122 , ApplicationDeactivated = ApplicationDeactivate , QueryWhatsThis = 123 , EnterWhatsThisMode = 124 , LeaveWhatsThisMode = 125 , ZOrderChange = 126 , HoverEnter = 127 , HoverLeave = 128 , HoverMove = 129 , AcceptDropsChange = 152 , ZeroTimerEvent = 154 , GraphicsSceneMouseMove = 155 , GraphicsSceneMousePress = 156 , GraphicsSceneMouseRelease = 157 , GraphicsSceneMouseDoubleClick = 158 , GraphicsSceneContextMenu = 159 , GraphicsSceneHoverEnter = 160 , GraphicsSceneHoverMove = 161 , GraphicsSceneHoverLeave = 162 , GraphicsSceneHelp = 163 , GraphicsSceneDragEnter = 164 , GraphicsSceneDragMove = 165 , GraphicsSceneDragLeave = 166 , GraphicsSceneDrop = 167 , GraphicsSceneWheel = 168 , GraphicsSceneLeave = 220 , KeyboardLayoutChange = 169 , DynamicPropertyChange = 170 , TabletEnterProximity = 171 , TabletLeaveProximity = 172 , NonClientAreaMouseMove = 173 , NonClientAreaMouseButtonPress = 174 , NonClientAreaMouseButtonRelease = 175 , NonClientAreaMouseButtonDblClick = 176 , MacSizeChange = 177 , ContentsRectChange = 178 , MacGLWindowChange = 179 , FutureCallOut = 180 , GraphicsSceneResize = 181 , GraphicsSceneMove = 182 , CursorChange = 183 , ToolTipChange = 184 , NetworkReplyUpdated = 185 , GrabMouse = 186 , UngrabMouse = 187 , GrabKeyboard = 188 , UngrabKeyboard = 189 , StateMachineSignal = 192 , StateMachineWrapped = 193 , TouchBegin = 194 , TouchUpdate = 195 , TouchEnd = 196 , NativeGesture = 197 , RequestSoftwareInputPanel = 199 , CloseSoftwareInputPanel = 200 , WinIdChange = 203 , Gesture = 198 , GestureOverride = 202 , ScrollPrepare = 204 , Scroll = 205 , Expose = 206 , InputMethodQuery = 207 , OrientationChange = 208 , TouchCancel = 209 , ThemeChange = 210 , SockClose = 211 , PlatformPanel = 212 , StyleAnimationUpdate = 213 , ApplicationStateChange = 214 , WindowChangeInternal = 215 , ScreenChangeInternal = 216 , PlatformSurface = 217 , Pointer = 218 , TabletTrackingChange = 219 , WindowAboutToChangeInternal = 221 , DevicePixelRatioChange = 222 , ChildWindowAdded = 223 , ChildWindowRemoved = 224 , ParentWindowAboutToChange = 225 , ParentWindowChange = 226 , User = 1000 , MaxUser = 65535 }
	This enum type defines the valid event types in Qt. More...

Static Public Member Functions inherited from QEvent
static int	registerEventType (int hint=-1) noexcept

Protected Member Functions inherited from QEvent
	QEvent (Type type, InputEventTag)

	QEvent (Type type, PointerEventTag)

	QEvent (Type type, SinglePointEventTag)

Protected Attributes inherited from QEvent
quint16	t

Detailed Description

The QFocusEvent class contains event parameters for widget focus events.

\inmodule QtGui

Focus events are sent to widgets when the keyboard input focus changes. Focus events occur due to mouse actions, key presses (such as \uicontrol{Tab} or \uicontrol{Backtab}), the window system, popup menus, keyboard shortcuts, or other application-specific reasons. The reason for a particular focus event is returned by reason() in the appropriate event handler.

The event handlers QWidget::focusInEvent(), QWidget::focusOutEvent(), QGraphicsItem::focusInEvent and QGraphicsItem::focusOutEvent() receive focus events.

See also: QWidget::setFocus(), QWidget::setFocusPolicy(), {Keyboard Focus in Widgets}

Definition at line 469 of file qevent.h.

Constructor & Destructor Documentation

◆ QFocusEvent()

QFocusEvent::QFocusEvent	(	Type	type,
		Qt::FocusReason	reason = Qt::OtherFocusReason )

explicit

Constructs a focus event object.

The type parameter must be either QEvent::FocusIn or QEvent::FocusOut. The reason describes the cause of the change in focus.

Definition at line 1560 of file qevent.cpp.

Member Function Documentation

◆ gotFocus()

bool QFocusEvent::gotFocus ( ) const

inline

Returns true if type() is QEvent::FocusIn; otherwise returns false.

Definition at line 475 of file qevent.h.

Referenced by QWidgetTextControlPrivate::focusEvent(), and QQuickTextControlPrivate::focusEvent().

Here is the caller graph for this function:

◆ lostFocus()

bool QFocusEvent::lostFocus ( ) const

inline

Returns true if type() is QEvent::FocusOut; otherwise returns false.

Definition at line 476 of file qevent.h.

◆ reason()

Qt::FocusReason QFocusEvent::reason ( ) const

Returns the reason for this focus event.

Definition at line 1569 of file qevent.cpp.

Referenced by QWindowContainer::event(), QWidgetTextControlPrivate::focusEvent(), QQuickTextControlPrivate::focusEvent(), QLineEdit::focusInEvent(), QPushButton::focusInEvent(), QPlainTextEdit::focusInEvent(), QTextEdit::focusInEvent(), QGraphicsScene::focusInEvent(), QKeySequenceEdit::focusOutEvent(), QLineEdit::focusOutEvent(), QPushButton::focusOutEvent(), QAbstractButton::focusOutEvent(), QGraphicsScene::focusOutEvent(), QWidgetWindow::handleFocusInEvent(), and QXcbWindow::windowEvent().