### Interface

# Gdk Toplevel

since: 4.0

#### Description [src]

    interface Gdk.Toplevel : Gdk.Surface

A `GdkToplevel` is a freestanding toplevel surface.

The `GdkToplevel` interface provides useful APIs for interacting with the windowing system, such as controlling maximization and size of the surface, setting icons and transient parents for dialogs.

Available since: 4.0

#### Prerequisite

In order to implement Toplevel, your type must inherit from`GdkSurface`.

#### Instance methods

###### gdk_toplevel_begin_move

Begins an interactive move operation.

since: 4.0

###### gdk_toplevel_begin_resize

Begins an interactive resize operation.

since: 4.0

###### gdk_toplevel_focus

Sets keyboard focus to `surface`.

since: 4.0

###### gdk_toplevel_get_state

Gets the bitwise or of the currently active surface state flags, from the `GdkToplevelState` enumeration.

since: 4.0

###### gdk_toplevel_inhibit_system_shortcuts

Requests that the `toplevel` inhibit the system shortcuts.

since: 4.0

###### gdk_toplevel_lower

Asks to lower the `toplevel` below other windows.

since: 4.0

###### gdk_toplevel_minimize

Asks to minimize the `toplevel`.

since: 4.0

###### gdk_toplevel_present

Present `toplevel` after having processed the `GdkToplevelLayout` rules.

since: 4.0

###### gdk_toplevel_restore_system_shortcuts

Restore default system keyboard shortcuts which were previously inhibited.

since: 4.0

###### gdk_toplevel_set_decorated

Sets the toplevel to be decorated.

since: 4.0

###### gdk_toplevel_set_deletable

Sets the toplevel to be deletable.

since: 4.0

###### gdk_toplevel_set_icon_list

Sets a list of icons for the surface.

since: 4.0

###### gdk_toplevel_set_modal

Sets the toplevel to be modal.

since: 4.0

###### gdk_toplevel_set_startup_id

Sets the startup notification ID.

since: 4.0

###### gdk_toplevel_set_title

Sets the title of a toplevel surface.

since: 4.0

###### gdk_toplevel_set_transient_for

Sets a transient-for parent.

since: 4.0

###### gdk_toplevel_show_window_menu

Asks the windowing system to show the window menu.

since: 4.0

###### gdk_toplevel_supports_edge_constraints

Returns whether the desktop environment supports tiled window states.

since: 4.0

###### gdk_toplevel_titlebar_gesture

No description available.

since: 4.4

#### Properties

###### Gdk.Toplevel:decorated

Whether the window manager should add decorations.

since: 4.0

###### Gdk.Toplevel:deletable

Whether the window manager should allow to close the surface.

since: 4.0

###### Gdk.Toplevel:fullscreen-mode

The fullscreen mode of the surface.

since: 4.0

###### Gdk.Toplevel:icon-list

A list of textures to use as icon.

since: 4.0

###### Gdk.Toplevel:modal

Whether the surface is modal.

since: 4.0

###### Gdk.Toplevel:shortcuts-inhibited

Whether the surface should inhibit keyboard shortcuts.

since: 4.0

###### Gdk.Toplevel:startup-id

The startup ID of the surface.

since: 4.0

###### Gdk.Toplevel:state

The state of the toplevel.

since: 4.0

###### Gdk.Toplevel:title

The title of the surface.

since: 4.0

###### Gdk.Toplevel:transient-for

The transient parent of the surface.

since: 4.0

#### Signals

###### Gdk.Toplevel::compute-size

Emitted when the size for the surface needs to be computed, when it is present.

since: 4.0

#### Interface structure

    struct GdkToplevelInterface {
      /* no available fields */
    }

No description available.