Class
HandyWindow
Description [src]
class Handy.Window : Gtk.Window {
parent_instance: GtkWindow
}
A freeform window.
The HdyWindow
widget is a subclass of GtkWindow
which has no
titlebar area and provides rounded corners on all sides, ensuring they can
never be overlapped by the content. This makes it safe to use headerbars in
the content area as follows:
<object class="HdyWindow"/>
<child>
<object class="GtkBox">
<property name="visible">True</property>
<property name="orientation">vertical</property>
<child>
<object class="HdyHeaderBar">
<property name="visible">True</property>
<property name="show-close-button">True</property>
</object>
</child>
<child>
<!-- ... -->
</child>
</object>
</child>
</object>
It’s recommended to use HdyHeaderBar
with HdyWindow
, as unlike
GtkHeaderBar
it remains draggable inside the window. Otherwise,
HdyWindowHandle
can be used.
HdyWindow
allows to easily implement titlebar autohiding by putting the
headerbar inside a GtkRevealer
, and to show titlebar above content
by putting it into a GtkOverlay
instead of GtkBox
.
If the window has a GtkGLArea
, it may bring a slight performance
regression when the window is not fullscreen, tiled or maximized.
Using gtk_window_get_titlebar()
and gtk_window_set_titlebar()
is not supported and will result in a crash.
CSS nodes
HdyWindow
has a main CSS node with the name window
and style classes
.background
, .csd
and .unified
.
The .solid-csd
style class on the main node is used for client-side
decorations without invisible borders.
HdyWindow
also represents window states with the following style classes on
the main node: .tiled
, .maximized
, .fullscreen
.
It contains the subnodes decoration for window shadow and/or border,
decoration-overlay for the sheen on top of the window, widget.titlebar
, and
deck, which contains the child inside the window.
Available since: | 1.0 |