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.
| this |
an PanelPlugin. |
| window |
a Window. |
| widget |
the Widget to align |