QFocusEvent(3qt)

📦 version 3.3.8b, in fedora 43, fedora 44

💖 QFocusEvent — a lil manual page, but make it a vibe 💖

okay so bestie, you're reading the QFocusEvent(3qt) man page and honestly? slay. it's a Qt 3 thing, it's from Trolltech, and it's all about focus events for widgets. let's get into it fr fr 🦋

✨ NAME ✨

QFocusEvent — event parameters for widget focus events 👑

so basically: when the keyboard focus moves around, this is the lil object that carries the tea about why. 💅

🌸 SYNOPSIS 🌸

#include <qevent.h>

Inherits QEvent.

🎀 Public Members

QFocusEvent ( Type type )
bool gotFocus () const
bool lostFocus () const
enum Reason { Mouse, Tab, Backtab, ActiveWindow, Popup, Shortcut, Other
    }

⭐ Static Public Members

Reason reason ()
void setReason ( Reason reason )
void resetReason ()

💜 DESCRIPTION 💜

The QFocusEvent class contains event parameters for widget focus events. that's the whole gig, no cap.

Focus events get sent to widgets whenever the keyboard input focus changes. like, focus be moving and the widget needs to know about it. 🫶

and why does focus move?? so many reasons bestie:

  • mouse actions 🖱️
  • keypresses (e.g. Tab or 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. so when you're chilling inside your handler, that's where you ask "okay but why tho".

The event handlers that receive focus events are QWidget::focusInEvent() and QWidget::focusOutEvent(). those two are the ones holding the door. 🚪

Use setReason() to set the reason for all focus events, and resetReason() to set the reason for all focus events to the reason that was in force before the last setReason() call. it's giving undo button, honestly. 🙈

See also QWidget::setFocus(), QWidget::focusPolicy, and Event Classes.

🧚 Member Type Documentation — QFocusEvent::Reason 🧚

This enum specifies why the focus changed. it's the receipts, basically. 🧾

  • QFocusEvent::Mouse — because of a mouse action. 🖱️
  • QFocusEvent::Tab — because of a Tab press. ⌨️
  • QFocusEvent::Backtab — because of a Backtab press (possibly including Shift/Control, e.g. Shift+Tab). 🔁
  • QFocusEvent::ActiveWindow — because the window system made this window (in)active. 🪟
  • QFocusEvent::Popup — because the application opened/closed a popup that grabbed/released focus. 🍓
  • QFocusEvent::Shortcut — because of a keyboard shortcut. ⚡
  • QFocusEvent::Other — any other reason, usually application-specific. 🌈

See the keyboard focus overview for more about focus. iykyk.

👑 MEMBER FUNCTION DOCUMENTATION 👑

💫 QFocusEvent::QFocusEvent ( Type type )

Constructs a focus event object. baby's first focus event, iconic. ✨

The type parameter must be either QEvent::FocusIn or QEvent::FocusOut. those are the only two options, no substitutes, periodt.

💖 bool QFocusEvent::gotFocus () const

Returns TRUE if the widget received the text input focus; otherwise returns FALSE. did you get the focus?? yes or no bestie, no in-between. 🫶

😭 bool QFocusEvent::lostFocus () const

Returns TRUE if the widget lost the text input focus; otherwise returns FALSE. and if it's TRUE... we mourn. 💀

⭐ Reason QFocusEvent::reason () [static]

Returns the reason for this focus event. the why. the lore. 👀

See also setReason().

🦋 void QFocusEvent::resetReason () [static]

Resets the reason for all future focus events to the value before the last setReason() call. take it back to how it was, we love a rewind. 🎀

See also reason() and setReason().

🔥 void QFocusEvent::setReason ( Reason reason ) [static]

Sets the reason for all future focus events to reason. boom, declared. 📢

See also reason() and resetReason().

🌈 SEE ALSO 🌈

Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the license file included in the distribution for a complete license statement. read it, bestie, it's the rules. 📜

🧚 AUTHOR 🧚

Generated automatically from the source code. not a human, just a machine doing its lil thing. 🤖✨

💀 BUGS 💀

If you find a bug in Qt, please report it as described in http://doc.trolltech.com/bughowto.html. Good bug reports help us to help you. Thank you. 🫶 (we literally mean it, good bug reports are a love language.)

The definitive Qt documentation is provided in HTML format; it is located at $QTDIR/doc/html and can be read using Qt Assistant or with a web browser. This man page is provided as a convenience for those users who prefer man pages, although this format is not officially supported by Trolltech. so like... it's a gift, not an official channel. 🙈

If you find errors in this manual page, please report them to qt-bugs@trolltech.com. Please include the name of the manual page (qfocusevent.3qt) and the Qt version (3.3.8). pleaseeee include both, otherwise the bug report is giving lost puppy. 😭

okay that's the whole page, you ate it up. 🍽️💅 this was Trolltech AS, dated 2 February 2007, and you just finished reading QFocusEvent(3qt). mwah. 💖 go forth and know your focus reasons, bestie. 🌸🦋✨

📦 where this page comes from