Package org.gnome.gtk

Class Window

java.lang.Object
io.github.jwharm.javagi.base.ProxyInstance
org.gnome.gobject.TypeInstance
org.gnome.gobject.GObject
org.gnome.gobject.InitiallyUnowned
org.gnome.gtk.Widget
org.gnome.gtk.Window
All Implemented Interfaces:
Proxy, Accessible, Buildable, ConstraintTarget, Native, Root, ShortcutManager
Direct Known Subclasses:
AboutDialog, ApplicationWindow, Assistant, Dialog, MessageDialog, ShortcutsWindow, Window
@Generated("io.github.jwharm.JavaGI") public class Window extends Widget implements Accessible, Buildable, ConstraintTarget, Native, Root, ShortcutManager
A GtkWindow is a toplevel window which can contain other widgets.

An example GtkWindow

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 GtkWindow implementation of the Buildable interface supports setting a child as the titlebar by specifying “titlebar” as the “type” attribute of a <child> element.

Shortcuts and Gestures
GtkWindow supports the following keyboard shortcuts:

  • F10 activates the menubar, if present.
  • Alt makes the mnemonics visible while pressed.

The following signals have default keybindings:

  • Gtk.Window::activate-default
  • Gtk.Window::activate-focus
  • Gtk.Window::enable-debugging

Actions
GtkWindow defines a set of built-in actions:

  • default.activate activates the default widget.
  • window.minimize minimizes the window.
  • window.toggle-maximized maximizes or restores the window.
  • window.close closes the window.

CSS nodes


 window.background [.csd / .solid-csd / .ssd] [.maximized / .fullscreen / .tiled]
 ├── <child>
 ╰── <titlebar child>.titlebar [.default-decoration]

GtkWindow 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).

GtkWindow 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.

GtkWindow adds the .titlebar and .default-decoration style classes to the widget that is added as a titlebar child.

Accessibility
Until GTK 4.10, GtkWindow used the GTK_ACCESSIBLE_ROLE_WINDOW role.

Since GTK 4.12, GtkWindow uses the GTK_ACCESSIBLE_ROLE_APPLICATION role.