Functions

Types and Values

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

Functions

GtkWidget *
hdy_window_new (void);

Types and Values

#define HDY_TYPE_WINDOW (hdy_window_get_type())

struct HdyWindowClass {
  GtkWindowClass parent_class;
};

typedef struct _HdyWindow HdyWindow;

See Also

HdyApplicationWindow, HdyHeaderBar, HdyWindowHandle