xdg_dialog_v1¤
Dialog object
A xdg_dialog_v1 object is an ancillary object tied to a xdg_toplevel. Its purpose is hinting the compositor that the toplevel is a "dialog" (e.g. a temporary window) relative to another toplevel (see xdg_toplevel.set_parent). If the xdg_toplevel is destroyed, the xdg_dialog_v1 becomes inert.
Through this object, the client may provide additional hints about the purpose of the secondary toplevel. This interface has no effect on toplevels that are not attached to a parent toplevel.
Methods:
-
destroy–Destroy the dialog object
-
set_modal–Mark dialog as modal
-
unset_modal–Mark dialog as not modal
destroy() -> None
Destroy the dialog object
Destroys the xdg_dialog_v1 object. If this object is destroyed before the related xdg_toplevel, the compositor should unapply its effects.
set_modal() -> None
Mark dialog as modal
Hints that the dialog has "modal" behavior. Modal dialogs typically require to be fully addressed by the user (i.e. closed) before resuming interaction with the parent toplevel, and may require a distinct presentation.
Clients must implement the logic to filter events in the parent toplevel on their own.
Compositors may choose any policy in event delivery to the parent toplevel, from delivering all events unfiltered to using them for internal consumption.
unset_modal() -> None
Mark dialog as not modal
Drops the hint that this dialog has "modal" behavior. See xdg_dialog_v1.set_modal for more details.