wxEraseEvent(3)

📦
version 29.0.6 · 3 versions
, in ubuntu stonking

💅 wxEraseEvent

okay so bestie, this is the Erlang module definition for wxEraseEvent, straight outta the wx world ✨

🌸 NAME 🌸

wxEraseEvent — an erase event gets sent when a window's background needs to be repainted. that's it, that's the vibe 🎨

🦋 DESCRIPTION 🦋

so here's the tea, and it's important tea: on some platforms — GTK+ being the main character here 👑 — this event is simulated. like, it's just generated right before the paint event, and it may cause flicker 😭

so the recommendation is: set the text background colour explicitly to prevent that flicker. no cap. also, the default background colour under GTK+ is grey. remember that. 🩶

to intercept this event, use the EVT_ERASE_BACKGROUND macro in an event table definition. periodt.

⚠️ read this twice, bestie: you must use the device context returned by getDC/1 to draw on. do not create a wxPaintDC in the event handler. like, don't. i'm serious. 💀

see: Overview events

this class is derived from — and can use functions from — this absolute legend:

  • wxEvent 🫶

wxWidgets docs: wxEraseEvent

✨ Events ✨

use wxEvtHandler:connect/3 with wxEraseEventType to subscribe to events of this type. slay, you're subscribed 💖

🎀 DATA TYPES 🎀

  • wxErase() :: #wxErase{}.
  • wxEraseEvent() :: wx:wx_object().
  • wxEraseEventType() :: erase_background.

💜 FUNCTIONS 💜

  • getDC(This) -> wxDC:wxDC() when This :: wxEraseEvent(). — returns the device context associated with the erase event, so you can draw on it. 🖌️

the returned pointer is never NULL. iconic behaviour, honestly. ✨

Ericsson AB · wx 2.6 — mwah, that's the whole page bestie, go forth and erase those backgrounds responsibly 🦋💅🌈

📦 where this page comes from