A gtk.window.Window is a toplevel window which can contain other widgets.
Windows normally have decorations that are under the control
of the windowing system and allow the user to manipulate the window
(resize it, move it, close it,...).
GtkWindow as GtkBuildable
The gtk.window.Window implementation of the gtk.buildable.Buildable interface supports
setting a child as the titlebar by specifying “titlebar” as the “type”
attribute of a <child> element.
gtk.window.Window has a main CSS node with name window and style class .background.
Style classes that are typically used with the main CSS node are .csd (when
client-side decorations are in use), .solid-csd (for client-side decorations
without invisible borders), .ssd (used by mutter when rendering server-side
decorations). GtkWindow also represents window states with the following
style classes on the main node: .maximized, .fullscreen, .tiled (when supported,
also .tiled-top, .tiled-left, .tiled-right, .tiled-bottom).
gtk.window.Window subclasses often add their own discriminating style classes,
such as .dialog, .popup or .tooltip.
Generally, some CSS properties don't make sense on the toplevel window node,
such as margins or padding. When client-side decorations without invisible
borders are in use (i.e. the .solid-csd style class is added to the
main window node), the CSS border of the toplevel window is used for
resize drags. In the .csd case, the shadow area outside of the window
can be used to resize it.
gtk.window.Window adds the .titlebar and .default-decoration style classes to the
widget that is added as a titlebar child.
A gtk.window.Window is a toplevel window which can contain other widgets.
Windows normally have decorations that are under the control of the windowing system and allow the user to manipulate the window (resize it, move it, close it,...).
GtkWindow as GtkBuildable
The gtk.window.Window implementation of the gtk.buildable.Buildable interface supports setting a child as the titlebar by specifying “titlebar” as the “type” attribute of a <child> element.
CSS nodes
gtk.window.Window has a main CSS node with name window and style class .background.
Style classes that are typically used with the main CSS node are .csd (when client-side decorations are in use), .solid-csd (for client-side decorations without invisible borders), .ssd (used by mutter when rendering server-side decorations). GtkWindow also represents window states with the following style classes on the main node: .maximized, .fullscreen, .tiled (when supported, also .tiled-top, .tiled-left, .tiled-right, .tiled-bottom).
gtk.window.Window subclasses often add their own discriminating style classes, such as .dialog, .popup or .tooltip.
Generally, some CSS properties don't make sense on the toplevel window node, such as margins or padding. When client-side decorations without invisible borders are in use (i.e. the .solid-csd style class is added to the main window node), the CSS border of the toplevel window is used for resize drags. In the .csd case, the shadow area outside of the window can be used to resize it.
gtk.window.Window adds the .titlebar and .default-decoration style classes to the widget that is added as a titlebar child.
Accessibility
Until GTK 4.10, gtk.window.Window used the gtk.types.AccessibleRole.Window role.
Since GTK 4.12, gtk.window.Window uses the gtk.types.AccessibleRole.Application role.
Actions
gtk.window.Window defines a set of built-in actions: