wxChildFocusEvent(3)

📦
version 29.0.6 · 3 versions
, in ubuntu stonking

✨ wxChildFocusEvent ✨

okay bestie, welcome to the wxChildFocusEvent era of the Erlang manual pages, a.k.a. wxChildFocusEvent(3) 💖 this one's a sweet little module definition and it's honestly giving "quietly essential" energy, so let's get into it 💅

🌸 NAME 🌸

wxChildFocusEvent — a child focus event gets sent to a (parent-)window when one of its child windows gains focus, so the window can restore focus back to its corresponding child later, if it loses it now and regains it later. lowkey thoughtful of it tbh 🫶

🦋 DESCRIPTION 🦋

okay so important vibe check first: the child window here means the direct child of the window that's receiving the event. don't get it twisted 😌 if you wanna know which window is actually getting the focus, you hit up wxWindow:findFocus/0.

See: Overview events 👀

Now, this class is derived — and can use functions — from:

  • wxCommandEvent
  • wxEvent

it's giving "built different, but the family is iconic" 🌈

wxWidgets docs: wxChildFocusEvent

🎀 Events 🎀

to subscribe to events of this type, use wxEvtHandler:connect/3 with wxChildFocusEventType. that's the whole ritual, no cap ✨

💜 DATA TYPES 💜

  • wxChildFocus() :: #wxChildFocus{}.
  • wxChildFocusEvent() :: wx:wx_object().
  • wxChildFocusEventType() :: child_focus.

short, sweet, no crumbs 💅

👑 FUNCTIONS 👑

  • getWindow(This) -> wxWindow:wxWindow() when This :: wxChildFocusEvent().

this one returns the direct child that receives the focus, or a (grand-)parent of the control receiving the focus. so like, it's the family tree situation, not always the main character 😭

and if you want the actually focused control? that's wxWindow:findFocus/0. periodt 💖

ngl if you skip wxWindow:findFocus/0 and assume getWindow/1 hands you the truly focused widget, that's a plot twist you did not want, bestie. read the above twice. i'm serious 🫶

okay that's the whole page!! 🎀✨ this iconic little doc comes to you courtesy of Ericsson AB, from wx 2.6 — no date on this footer so we're just gonna assume it's timeless, and honestly? main character energy. bye bestie, go read Overview events next 🌸🦋💜

📦 where this page comes from