HdyWindow: Handy Reference Manual

## HdyWindow HdyWindow — A freeform window. |

## Functions

GtkWidget * | hdy_window_new ()

## Types and Values

#define | HDY_TYPE_WINDOW
struct | HdyWindowClass
| HdyWindow

## Object Hierarchy

        GObject
        ╰── GInitiallyUnowned
            ╰── GtkWidget
                ╰── GtkContainer
                    ╰── GtkBin
                        ╰── GtkWindow
                            ╰── HdyWindow
                                ╰── HdyPreferencesWindow

## Implemented Interfaces

HdyWindow implements AtkImplementorIface and GtkBuildable.

## Description

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:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    <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.

## Functions

### hdy_window_new ()

    GtkWidget *
    hdy_window_new (void);

Creates a new HdyWindow.

#### Returns

a newly created HdyWindow.

[transfer full]

Since: 1.0

## Types and Values

### HDY_TYPE_WINDOW

    #define HDY_TYPE_WINDOW (hdy_window_get_type())

### struct HdyWindowClass

    struct HdyWindowClass {
      GtkWindowClass parent_class;
    };

### HdyWindow

    typedef struct _HdyWindow HdyWindow;

## See Also

HdyApplicationWindow, HdyHeaderBar, HdyWindowHandle