ToplevelLayout#

The GdkToplevelLayout struct contains information that is necessary to present a sovereign window on screen.

The GdkToplevelLayout struct is necessary for using present.

Toplevel surfaces are sovereign windows that can be presented to the user in various states (maximized, on all workspaces, etc).

Constructors#

class ToplevelLayout

classmethod new() → ToplevelLayout#

Create a toplevel layout description.

Used together with present() to describe how a toplevel surface should be placed and behave on-screen.

The size is in ”application pixels”, not ”device pixels” (see get_scale_factor()).

class ToplevelLayout

equal(other: ToplevelLayout) → bool#

Check whether layout and other has identical layout properties.

get_fullscreen() → tuple[bool, bool]#: If the layout specifies whether to the toplevel should go fullscreen, the value pointed to by fullscreen is set to True if it should go fullscreen, or False, if it should go unfullscreen.

get_fullscreen_monitor() → Monitor | None#: Returns the monitor that the layout is fullscreening the surface on.

get_maximized() → tuple[bool, bool]#: If the layout specifies whether to the toplevel should go maximized, the value pointed to by maximized is set to True if it should go fullscreen, or False, if it should go unmaximized.

get_resizable() → bool#: Returns whether the layout should allow the user to resize the surface.

set_fullscreen(fullscreen: bool, monitor: Monitor | None = None) → None#

Sets whether the layout should cause the surface to be fullscreen when presented.

Parameters:

set_maximized(maximized: bool) → None#

Sets whether the layout should cause the surface to be maximized when presented.

set_resizable(resizable: bool) → None#

Sets whether the layout should allow the user to resize the surface after it has been presented.