### Class

# Gdk Display

since: 4.0

#### Description [src]

    final class Gdk.Display : GObject.Object
    {
      /* No available fields */
    }

`GdkDisplay` objects are the GDK representation of a workstation.

Their purpose are two-fold:

- To manage and provide information about input devices (pointers, keyboards, etc)
- To manage and provide information about output devices (monitors, projectors, etc)

Most of the input device handling has been factored out into separate `GdkSeat` objects. Every display has a one or more seats, which can be accessed with `gdk_display_get_default_seat()` and `gdk_display_list_seats()`.

Output devices are represented by `GdkMonitor` objects, which can be accessed with `gdk_display_get_monitor_at_surface()` and similar APIs.

Available since: 4.0

#### Ancestors

- GObject

#### Functions

###### gdk_display_get_default

Gets the default `GdkDisplay`.

since: 4.0

###### gdk_display_open

Opens a display.

since: 4.0

#### Instance methods

###### gdk_display_beep

Emits a short beep on `display`.

since: 4.0

###### gdk_display_close

Closes the connection to the windowing system for the given display.

since: 4.0

###### gdk_display_create_gl_context

Creates a new `GdkGLContext` for the `GdkDisplay`.

since: 4.6

###### gdk_display_device_is_grabbed

Returns `TRUE` if there is an ongoing grab on `device` for `display`.

since: 4.0

###### gdk_display_flush

Flushes any requests queued for the windowing system.

since: 4.0

###### gdk_display_get_app_launch_context

Returns a `GdkAppLaunchContext` suitable for launching applications on the given display.

since: 4.0

###### gdk_display_get_clipboard

Gets the clipboard used for copy/paste operations.

since: 4.0

###### gdk_display_get_default_seat

Returns the default `GdkSeat` for this display.

since: 4.0

###### gdk_display_get_dmabuf_formats

Returns the dma-buf formats that are supported on this display.

since: 4.14

###### gdk_display_get_monitor_at_surface

Gets the monitor in which the largest area of `surface` resides.

since: 4.0

###### gdk_display_get_monitors

Gets the list of monitors associated with this display.

since: 4.0

###### gdk_display_get_name

Gets the name of the display.

since: 4.0

###### gdk_display_get_primary_clipboard

Gets the clipboard used for the primary selection.

since: 4.0

###### gdk_display_get_setting

Retrieves a desktop-wide setting such as double-click time for the `display`.

since: 4.0

###### gdk_display_get_startup_notification_id

Gets the startup notification ID for a Wayland display, or `NULL` if no ID has been defined.

deprecated: 4.10 since: 4.0

###### gdk_display_is_closed

Finds out if the display has been closed.

since: 4.0

###### gdk_display_is_composited

Returns whether surfaces can reasonably be expected to have their alpha channel drawn correctly on the screen.

since: 4.0

###### gdk_display_is_rgba

Returns whether surfaces on this `display` are created with an alpha channel.

since: 4.0

###### gdk_display_list_seats

Returns the list of seats known to `display`.

since: 4.0

###### gdk_display_map_keycode

Returns the keyvals bound to `keycode`.

since: 4.0

###### gdk_display_map_keyval

Obtains a list of keycode/group/level combinations that will generate `keyval`.

since: 4.0

###### gdk_display_notify_startup_complete

Indicates to the GUI environment that the application has finished loading, using a given identifier.

deprecated: 4.10 since: 4.0

###### gdk_display_prepare_gl

Checks that OpenGL is available for `self` and ensures that it is properly initialized. When this fails, an `error` will be set describing the error and this function returns `FALSE`.

since: 4.4

###### gdk_display_put_event

Adds the given event to the event queue for `display`.

deprecated: 4.10 since: 4.0

###### gdk_display_supports_input_shapes

Returns `TRUE` if the display supports input shapes.

since: 4.0

###### gdk_display_supports_shadow_width

Returns whether it’s possible for a surface to draw outside of the window area.

since: 4.14

###### gdk_display_sync

Flushes any requests queued for the windowing system and waits until all requests have been handled.

since: 4.0

###### gdk_display_translate_key

Translates the contents of a `GdkEventKey` into a keyval, effective group, and level.

since: 4.0

##### Methods inherited from GObject (43)

Please see GObject for a full list of methods.

#### Properties

###### Gdk.Display:composited

`TRUE` if the display properly composites the alpha channel.

since: 4.0

###### Gdk.Display:dmabuf-formats

The dma-buf formats that are supported on this display.

since: 4.14

###### Gdk.Display:input-shapes

`TRUE` if the display supports input shapes.

since: 4.0

###### Gdk.Display:rgba

`TRUE` if the display supports an alpha channel.

since: 4.0

###### Gdk.Display:shadow-width

`TRUE` if the display supports extensible frames.

since: 4.14

#### Signals

###### Gdk.Display::closed

Emitted when the connection to the windowing system for `display` is closed.

since: 4.0

###### Gdk.Display::opened

Emitted when the connection to the windowing system for `display` is opened.

since: 4.0

###### Gdk.Display::seat-added

Emitted whenever a new seat is made known to the windowing system.

since: 4.0

###### Gdk.Display::seat-removed

Emitted whenever a seat is removed by the windowing system.

since: 4.0

###### Gdk.Display::setting-changed

Emitted whenever a setting changes its value.

since: 4.0

##### Signals inherited from GObject (1)

###### GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

since: 2.0