wxMouseCaptureLostEvent(3)

📦
version 29.0.6 · 3 versions
, in ubuntu stonking

✨ wxMouseCaptureLostEvent ✨

okay bestie, welcome to the Erlang module definition for wxMouseCaptureLostEvent 💅 no cap, this one's a lil niche but it's lowkey important so let's get into it 🫶

🌸 NAME 🌸

wxMouseCaptureLostEvent — a mouse capture lost event is sent to a window that had obtained mouse capture, which was subsequently lost due to an "external" event. (like… for real for real, think of when a dialog box pops up 💀 or when another application just snatches the mouse entirely. rude.)

🦋 DESCRIPTION 🦋

So here's the tea ☕ when that happens, this event gets sent to all the windows that are on the capture stack — meaning every window that called CaptureMouse but hasn't called ReleaseMouse yet. iykyk 👑

but WAIT — the event is not sent if the capture changes because of a call to CaptureMouse or ReleaseMouse. those are the normal paths, this event is specifically for the external chaos 💀

also, major vibe check: this event is currently emitted under Windows only. periodt.

See also, bestie, go look at these:

  • wxMouseCaptureChangedEvent
  • Overview events
  • wxWindow:captureMouse/1
  • wxWindow:releaseMouse/1
  • wxWindow:getCapture/0

This class is derived, and can use functions, from:

  • wxEvent

wxWidgets docs: wxMouseCaptureLostEvent

🎀 Events 🎀

Use wxEvtHandler:connect/3 with wxMouseCaptureLostEventType to subscribe to events of this type. literal main character move ✨

💖 DATA TYPES 💖

here's the squad, all typed out and cute 🧚

  • wxMouseCaptureLost() :: #wxMouseCaptureLost{}.
  • wxMouseCaptureLostEvent() :: wx:wx_object().
  • wxMouseCaptureLostEventType() :: mouse_capture_lost.

👑 FUNCTIONS 👑

okay so… this section is genuinely empty in the source. like, not a single function listed. it's giving minimalist, it's giving set-the-stage energy 🌈 consider it a vibe, not a void. no cap.

🌟 little recap before you go: event goes to every window on the capture stack, it doesn't fire for CaptureMouse/ReleaseMouse-triggered changes, and it's Windows-only right now. slay responsibly 💅

Ericsson AB · wx 2.6 · wxMouseCaptureLostEvent(3) — mwah, tysm for reading bestie, you ate that whole page fr fr 💖✨🎀🦋🌸🫶

📦 where this page comes from