popup_window


Description:

[ Version ( since = "4.19.0" ) ]
public void popup_window (Window window, Widget? widget)

Pops up window at widget if widget is non-null, otherwise pops up window at this.

The user should not have to set any property of window: this function takes care of setting the necessary properties to make window appear as a menu widget.

This function tries to produce for a Window a behavior similar to that produced by popup_menu for a Menu . In particular, clicking outside the window or pressing Esc should hide it, and the function takes care to lock panel autohide when the window is shown.

However, it may be that, especially on Wayland and depending on the compositor used, hiding the window works more or less well. Also, window positioning at widget only works on Wayland if the compositor supports the layer-shell protocol, on which many of the panel features also depend.

See also: popup_menu and position_widget.

Parameters:

this

an PanelPlugin.

window

a Window.

widget

the Widget to align window with or null to use this as widget.