LuaDebuggerPauseOverlay Class Reference

Translucent overlay shown over the main window while the Lua debugger is paused. More...

#include <lua_debugger_pause.h>

Inheritance diagram for LuaDebuggerPauseOverlay:

Public Member Functions
	LuaDebuggerPauseOverlay (QWidget *parent)
	Constructs a new LuaDebuggerPauseOverlay object.
	~LuaDebuggerPauseOverlay () override
	Destroys the LuaDebuggerPauseOverlay object.

Protected Member Functions
void	paintEvent (QPaintEvent *event) override
	Handles paint events to draw the overlay.
bool	eventFilter (QObject *obj, QEvent *event) override
	Filters events on the parent widget to handle resizing.

Detailed Description

Translucent overlay shown over the main window while the Lua debugger is paused.

Renders a darkening vignette plus a centered card with a pause glyph, bold title and subtext — similar visual vocabulary to the startup SplashOverlay so the "wait" state feels native, with a somewhat more opaque treatment so the pause state reads clearly.

The overlay is a plain child QWidget of the main window, intentionally not a top-level Qt::Window: a child widget has no platform-window identity of its own (no NSWindow on macOS, no X11 window on Linux), so it can never surface as an independent entry in Mission Control / Alt-Tab, never carry its own drop shadow or zoom animation, and trivially stays glued to the main window for free — exactly like SplashOverlay does on the welcome page.

The paint is static (no animation): like the splash screen, the card is drawn once and stays put. While the debugger is paused the dialog also installs a QEvent::UpdateRequest filter on the main window (see PauseInputFilter in lua_debugger_dialog.cpp) to prevent re-entrant paints of the main window's backing store.

The overlay tracks its parent's size itself: the constructor installs an event filter on the parent and sets the initial geometry to the parent's rect. On QEvent::Resize the overlay resizes to the new parent rect and calls repaint() synchronously — required because an update() would post a QEvent::UpdateRequest to the top-level main window, which PauseInputFilter swallows. QEvent::Resize itself is not filtered, so the WM's resize is delivered to the main window and we see it here as well.

Constructor & Destructor Documentation

LuaDebuggerPauseOverlay()

LuaDebuggerPauseOverlay::LuaDebuggerPauseOverlay ( QWidget *  parent )

explicit

Constructs a new LuaDebuggerPauseOverlay object.

Parameters

parent

The parent widget to overlay.

Member Function Documentation

eventFilter()

bool LuaDebuggerPauseOverlay::eventFilter ( QObject *  obj, QEvent *  event  )

overrideprotected

Filters events on the parent widget to handle resizing.

Parameters

obj	The watched object.
event	The event being filtered.

Returns

True if the event is handled, false otherwise.

paintEvent()

void LuaDebuggerPauseOverlay::paintEvent ( QPaintEvent *  event )

overrideprotected

Handles paint events to draw the overlay.

Parameters

event

The paint event.

---

The documentation for this class was generated from the following files:

• /builds/wireshark/wireshark/ui/qt/lua_debugger/lua_debugger_pause.h
• /builds/wireshark/wireshark/ui/qt/lua_debugger/lua_debugger_pause.cpp