Handy.Window
Description: Reference for Handy.Window

### 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

#### Ancestors

- GtkWindow
- GtkBin
- GtkContainer
- GtkWidget
- GInitiallyUnowned
- GObject

#### Implements

- AtkImplementorIface
- GtkBuildable

#### Constructors

###### hdy_window_new

Creates a new `HdyWindow`.

Available since: 1.0

#### Class structure

    struct HandyWindowClass {
      GtkWindowClass parent_class;

    }

###### Class members

`parent_class` |
    GtkWindowClass
| No description available.