Class

GdkDisplay

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.

Hierarchy

hierarchy this GdkDisplay ancestor_0 GObject ancestor_0--this

Ancestors

Functions

gdk_display_get_default

Gets the default GdkDisplay.

gdk_display_open

Opens a display.

Instance methods

gdk_display_beep

Emits a short beep on display.

gdk_display_close

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

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.

gdk_display_flush

Flushes any requests queued for the windowing system.

gdk_display_get_app_launch_context

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

gdk_display_get_clipboard

Gets the clipboard used for copy/paste operations.

gdk_display_get_default_seat

Returns the default GdkSeat for this display.

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.

gdk_display_get_monitors

Gets the list of monitors associated with this display.

gdk_display_get_name

Gets the name of the display.

gdk_display_get_primary_clipboard

Gets the clipboard used for the primary selection.

gdk_display_get_setting

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

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 

gdk_display_is_closed

Finds out if the display has been closed.

gdk_display_is_composited

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

gdk_display_is_rgba

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

gdk_display_list_seats

Returns the list of seats known to display.

gdk_display_map_keycode

Returns the keyvals bound to keycode.

gdk_display_map_keyval

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

gdk_display_notify_startup_complete

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

deprecated: 4.10 

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 

gdk_display_supports_input_shapes

Returns TRUE if the display supports input shapes.

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.

gdk_display_translate_key

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

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.

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.

Gdk.Display:rgba

TRUE if the display supports an alpha channel.

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.

Gdk.Display::opened

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

Gdk.Display::seat-added

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

Gdk.Display::seat-removed

Emitted whenever a seat is removed by the windowing system.

Gdk.Display::setting-changed

Emitted whenever a setting changes its value.

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.