Back to Seed Clases

Gdk

Classes

Interfaces

Structs

Unions

Event

Enums

GObject.Object
parent-child marker Gdk.Display

Class Gdk.Display

Import line:	Gdk = imports.gi.Gdk;
GIR File:	Gdk-3.0.gir
C documentation:	GdkDisplay
Class :	Display
Extends:	GObject.Object

GdkDisplay objects purpose are two fold:

To manage and provide information about input devices (pointers
and keyboards)

To manage and provide information about the available GdkScreens

GdkDisplay objects are the GDK representation of an X Display,
which can be described as a workstation consisting of
a keyboard, a pointing device (such as a mouse) and one or more
screens.
It is used to open and keep track of various GdkScreen objects
currently instantiated by the application. It is also used to
access the keyboard(s) and mouse pointer(s) of the display.
Most of the input device handling has been factored out into
the separate GdkDeviceManager object. Every display has a
device manager, which you can obtain using
gdk_display_get_device_manager().

Properties
None

Methods / Constructors
Method / Constructor		Defined By
	new Gdk.Display () Create a new Gdk.Display Create a new Gdk.Display
	Gdk.Display.get_default () : Gdk.Display Gets the default GdkDisplay. Gets the default GdkDisplay. This is a convenience function for gdk_display_manager_get_default_display (gdk_display_manager_get ()). display. Returns: Gdk.Display a GdkDisplay, or NULL if there is no default	Gdk.Display
	Gdk.Display.open (String *display_name) : Gdk.Display Opens a display. Opens a display. if the display could not be opened Parameters: String display_name* Required (not null) the name of the display to open Returns: Gdk.Display a GdkDisplay, or NULL	Gdk.Display
	Gdk.Display.open_default_libgtk_only () : Gdk.Display Opens the default display specified by command line arguments or environment variables, sets it as the default display, and returns it. Opens the default display specified by command line arguments or environment variables, sets it as the default display, and returns it. gdk_parse_args must have been called first. If the default display has previously been set, simply returns that. An internal function that should not be used by applications. opened, otherwise NULL. Returns: Gdk.Display the default display, if it could be	Gdk.Display
	beep () : none Emits a short beep on display Emits a short beep on display Returns: none	Gdk.Display
	close () : none Closes the connection to the windowing system for the given display, and cleans up associated resources. Closes the connection to the windowing system for the given display, and cleans up associated resources. Returns: none	Gdk.Display
	device_is_grabbed (Device *device) : gboolean Returns TRUE* if there is an ongoing grab on device for display. Returns TRUE if there is an ongoing grab on device for display. Parameters: Gdk.Device device Required (not null) a GdkDevice Returns: gboolean TRUE if there is a grab in effect for device.	Gdk.Display
	flush () : none Flushes any requests queued for the windowing system; this happens automatically when the main loop blocks waiting for new events, but if your application is drawing without returning control to the main loop, you may need to call this function explicitely. Flushes any requests queued for the windowing system; this happens automatically when the main loop blocks waiting for new events, but if your application is drawing without returning control to the main loop, you may need to call this function explicitely. A common case where this function needs to be called is when an application is executing drawing commands from a thread other than the thread where the main loop is running. This is most useful for X11. On windowing systems where requests are handled synchronously, this function will do nothing. Returns: none	Gdk.Display
	get_app_launch_context () : Gdk.AppLaunchContext Returns a GdkAppLaunchContext suitable for launching applications on the given display. Returns a GdkAppLaunchContext suitable for launching applications on the given display. Free with g_object_unref() when done Returns: Gdk.AppLaunchContext a new GdkAppLaunchContext for display.	Gdk.Display
	get_default_cursor_size () : guint32 Returns the default size to use for cursors on display. Returns the default size to use for cursors on display. Returns: guint32 the default cursor size.	Gdk.Display
	get_default_group () : Gdk.Window Returns the default group leader window for all toplevel windows on display. Returns the default group leader window for all toplevel windows on display. This window is implicitly created by GDK. See gdk_window_set_group(). for display Returns: Gdk.Window The default group leader window	Gdk.Display
	get_default_screen () : Gdk.Screen Get the default GdkScreen for display. Get the default GdkScreen for display. Returns: Gdk.Screen the default GdkScreen object for display	Gdk.Display
	get_device_manager () : Gdk.DeviceManager Returns the GdkDeviceManager associated to display. Returns the GdkDeviceManager associated to display. owned by GDK and must not be freed or unreferenced. Returns: Gdk.DeviceManager A GdkDeviceManager, or NULL. This memory is	Gdk.Display
	get_event () : Gdk.Event Gets the next GdkEvent to be processed for display, fetching events from the windowing system if necessary. Gets the next GdkEvent to be processed for display, fetching events from the windowing system if necessary. are pending. The returned GdkEvent should be freed with gdk_event_free(). Returns: Gdk.Event the next GdkEvent to be processed, or NULL if no events	Gdk.Display
	get_maximal_cursor_size () : Object Gets the maximal size to use for cursors on display. Gets the maximal size to use for cursors on display. Returns: width: guint32 height: guint32	Gdk.Display
	get_n_screens () : gint32 Gets the number of screen managed by the display. Gets the number of screen managed by the display. Returns: gint32 number of screens.	Gdk.Display
	get_name () : String Gets the name of the display. Gets the name of the display. by GDK and should not be modified or freed. Returns: String a string representing the display name. This string is owned	Gdk.Display
	get_pointer () : Object Gets the current location of the pointer and the current modifier mask for a given display. Gets the current location of the pointer and the current modifier mask for a given display. Returns: screen: Gdk.Screen x: gint32 y: gint32 mask: Gdk.ModifierType	Gdk.Display
	get_screen (gint32 *screen_num) : Gdk.Screen Returns a screen object for one of the screens of the display. Returns a screen object for one of the screens of the display. Parameters: gint32 screen_num* Required (not null) the screen number Returns: Gdk.Screen the GdkScreen object	Gdk.Display
	get_window_at_pointer (Object *out_values) : Gdk.Window Obtains the window underneath the mouse pointer, returning the location of the pointer in that window in win_x, win_y* for screen. Obtains the window underneath the mouse pointer, returning the location of the pointer in that window in win_x, win_y for screen. Returns NULL if the window under the mouse pointer is not known to GDK (for example, belongs to another application). Parameters: Object out_values gint32 win_x gint32 win_y Returns: Gdk.Window the window under the mouse pointer, or NULL	Gdk.Display
	has_pending () : gboolean Returns whether the display has events that are waiting to be processed. Returns whether the display has events that are waiting to be processed. Returns: gboolean TRUE if there are events ready to be processed.	Gdk.Display
	is_closed () : gboolean Finds out if the display has been closed. Finds out if the display has been closed. Returns: gboolean TRUE if the display is closed.	Gdk.Display
	keyboard_ungrab (guint32 *time_) : none Release any keyboard grab instead. Release any keyboard grab instead. Parameters: guint32 time_* Required (not null) a timestap (e.g GDK_CURRENT_TIME). Returns: none	Gdk.Display
	list_devices () : Array Returns the list of available input devices attached to display. Returns the list of available input devices attached to display. The list is statically allocated and should not be freed. a list of GdkDevice Returns: Array	Gdk.Display
	notify_startup_complete (String *startup_id) : none Indicates to the GUI environment that the application has finished loading, using a given identifier. Indicates to the GUI environment that the application has finished loading, using a given identifier. GTK+ will call this function automatically for GtkWindow* with custom startup-notification identifier unless gtk_window_set_auto_startup_notification() is called to disable that feature. Parameters: String startup_id Required (not null) a startup-notification identifier, for which notification process should be completed Returns: none	Gdk.Display
	peek_event () : Gdk.Event Gets a copy of the first GdkEvent in the display's event queue, without removing the event from the queue. Gets a copy of the first GdkEvent in the display's event queue, without removing the event from the queue. (Note that this function will not get more events from the windowing system. It only checks the events that have already been moved to the GDK event queue.) if no events are in the queue. The returned GdkEvent should be freed with gdk_event_free(). Returns: Gdk.Event a copy of the first GdkEvent on the event queue, or NULL	Gdk.Display
	pointer_is_grabbed () : gboolean Test if the pointer is grabbed. Test if the pointer is grabbed. Returns: gboolean TRUE if an active X pointer grab is in effect	Gdk.Display
	pointer_ungrab (guint32 *time_) : none Release any pointer grab. Release any pointer grab. instead. Parameters: guint32 time_* Required (not null) a timestap (e.g. GDK_CURRENT_TIME). Returns: none	Gdk.Display
	put_event (Event *event) : none Appends a copy of the given event onto the front of the event queue for display. Appends a copy of the given event onto the front of the event queue for display. Parameters: Gdk.Event event* Required (not null) a GdkEvent. Returns: none	Gdk.Display
	request_selection_notification (Atom *selection) : gboolean Request GdkEventOwnerChange* events for ownership changes of the selection named by the given atom. Request GdkEventOwnerChange events for ownership changes of the selection named by the given atom. be sent. Parameters: Gdk.Atom selection Required (not null) the GdkAtom naming the selection for which ownership change notification is requested Returns: gboolean whether GdkEventOwnerChange events will	Gdk.Display
	set_double_click_distance (guint32 *distance) : none Sets the double click distance (two clicks within this distance count as a double click and result in a GDK_2BUTTON_PRESS event). Sets the double click distance (two clicks within this distance count as a double click and result in a GDK_2BUTTON_PRESS event). See also gdk_display_set_double_click_time(). Applications should not set this, it is a global user-configured setting. Parameters: guint32 distance* Required (not null) distance in pixels Returns: none	Gdk.Display
	set_double_click_time (guint32 *msec) : none Sets the double click time (two clicks within this time interval count as a double click and result in a GDK_2BUTTON_PRESS event). Sets the double click time (two clicks within this time interval count as a double click and result in a GDK_2BUTTON_PRESS event). Applications should not set this, it is a global user-configured setting. Parameters: guint32 msec* Required (not null) double click time in milliseconds (thousandths of a second) Returns: none	Gdk.Display
	store_clipboard (Window *clipboard_window, guint32 time_, Array targets, gint32 n_targets) : none Issues a request to the clipboard manager to store the clipboard data. Issues a request to the clipboard manager to store the clipboard data. On X11, this is a special program that works according to the freedesktop clipboard specification, available at http://www.freedesktop.org/Standards/clipboard-manager-spec. Parameters: Gdk.Window clipboard_window* Required (not null) a GdkWindow belonging to the clipboard owner guint32 time_ Required (not null) a timestamp Array targets Required (not null) an array of targets that should be saved, or NULL if all available targets should be saved. gint32 n_targets Required (not null) length of the targets array Returns: none	Gdk.Display
	supports_clipboard_persistence () : gboolean Returns whether the speicifed display supports clipboard persistance; i.e. Returns whether the speicifed display supports clipboard persistance; i.e. if it's possible to store the clipboard data after an application has quit. On X11 this checks if a clipboard daemon is running. Returns: gboolean TRUE if the display supports clipboard persistance.	Gdk.Display
	supports_composite () : gboolean Returns TRUE if gdk_window_set_composited() can be used to redirect drawing on the window using compositing. Returns TRUE if gdk_window_set_composited() can be used to redirect drawing on the window using compositing. Currently this only works on X11 with XComposite and XDamage extensions available. Returns: gboolean TRUE if windows may be composited.	Gdk.Display
	supports_cursor_alpha () : gboolean Returns TRUE if cursors can use an 8bit alpha channel on display. Returns TRUE if cursors can use an 8bit alpha channel on display. Otherwise, cursors are restricted to bilevel alpha (i.e. a mask). Returns: gboolean whether cursors can have alpha channels.	Gdk.Display
	supports_cursor_color () : gboolean Returns TRUE if multicolored cursors are supported on display. Returns TRUE if multicolored cursors are supported on display. Otherwise, cursors have only a forground and a background color. Returns: gboolean whether cursors can have multiple colors.	Gdk.Display
	supports_input_shapes () : gboolean Returns TRUE if gdk_window_input_shape_combine_mask() can be used to modify the input shape of windows on display. Returns TRUE if gdk_window_input_shape_combine_mask() can be used to modify the input shape of windows on display. Returns: gboolean TRUE if windows with modified input shape are supported	Gdk.Display
	supports_selection_notification () : gboolean Returns whether GdkEventOwnerChange events will be sent when the owner of a selection changes. Returns whether GdkEventOwnerChange events will be sent when the owner of a selection changes. be sent. Returns: gboolean whether GdkEventOwnerChange events will	Gdk.Display
	supports_shapes () : gboolean Returns TRUE if gdk_window_shape_combine_mask() can be used to create shaped windows on display. Returns TRUE if gdk_window_shape_combine_mask() can be used to create shaped windows on display. Returns: gboolean TRUE if shaped windows are supported	Gdk.Display
	sync () : none Flushes any requests queued for the windowing system and waits until all requests have been handled. Flushes any requests queued for the windowing system and waits until all requests have been handled. This is often used for making sure that the display is synchronized with the current state of the program. Calling gdk_display_sync() before gdk_error_trap_pop() makes sure that any errors generated from earlier requests are handled before the error trap is removed. This is most useful for X11. On windowing systems where requests are handled synchronously, this function will do nothing. Returns: none	Gdk.Display
	warp_pointer (Screen *screen, gint32 x, gint32 y) : none Warps the pointer of display* to the point x,y on the screen screen, unless the pointer is confined to a window by a grab, in which case it will be moved as far as allowed by the grab. Warps the pointer of display to the point x,y on the screen screen, unless the pointer is confined to a window by a grab, in which case it will be moved as far as allowed by the grab. Warping the pointer creates events as if the user had moved the mouse instantaneously to the destination. Note that the pointer should normally be under the control of the user. This function was added to cover some rare use cases like keyboard navigation support for the color picker in the GtkColorSelectionDialog. Parameters: Gdk.Screen screen Required (not null) the screen of display to warp the pointer to gint32 x Required (not null) the x coordinate of the destination gint32 y Required (not null) the y coordinate of the destination Returns: none	Gdk.Display

Events - usage syntax: this.signals.EVENTNAME.connect( Function )
Event		Defined By
	closed (Display *self, gboolean is_error) : none The ::closed signal is emitted when the connection to the windowing system for display* is closed. The ::closed signal is emitted when the connection to the windowing system for display is closed. Parameters: Gdk.Display self gboolean is_error Returns: {none}	Gdk.Display
	opened (Display *self) : none The ::opened signal is emitted when the connection to the windowing system for display* is opened. The ::opened signal is emitted when the connection to the windowing system for display is opened. Parameters: Gdk.Display self Returns: {none}	Gdk.Display

Used by These Methods / Signals / Properties
Class / Namespace	Method / Signal / Properties
Gdk Method	Gdk.selection_owner_get_for_display (Display *display, Atom selection*) : Gdk.Window Determine the owner of the given selection.
Gdk Method	Gdk.selection_owner_set_for_display (Display *display, Window owner, Atom selection, guint32 time_, gboolean send_event) : gboolean Sets the GdkWindow* owner as the current owner of the selection selection.
Gdk Method	Gdk.selection_send_notify_for_display (Display *display, Window requestor, Atom selection, Atom target, Atom property, guint32 time_*) : none Send a response to SelectionRequest event.
Gdk Method	Gdk.text_property_to_utf8_list_for_display (Display *display, Atom encoding, gint32 format, String text, gint32 length, Object out_values*) : gint32 Converts a text property in the given encoding to a list of UTF-8 strings.
Gdk.AppLaunchContext Property	display : Gdk.Display
Gdk.AppLaunchContext Method	set_display (Display *display*) : none Sets the display on which applications will be launched when using this context.
Gdk.Cursor Property	display : Gdk.Display
Gdk.Cursor Method	new Gdk.Cursor.for_display (Display *display, CursorType cursor_type*) : Gdk.Cursor Create a new Gdk.Cursor
Gdk.Cursor Method	new Gdk.Cursor.from_name (Display *display, String name*) : Gdk.Cursor Create a new Gdk.Cursor
Gdk.Cursor Method	new Gdk.Cursor.from_pixbuf (Display *display, Pixbuf pixbuf*, gint32 x, gint32 y) : Gdk.Cursor Create a new Gdk.Cursor
Gdk.Cursor Method	get_display () : Gdk.Display Returns the display on which the GdkCursor is defined.
Gdk.Device Property	display : Gdk.Display The GdkDisplay the GdkDevice pertains to.
Gdk.Device Method	Gdk.Device.grab_info_libgtk_only (Display *display, Device device, Object out_values*) : gboolean Determines information about the current keyboard grab.
Gdk.Device Method	get_display () : Gdk.Display Returns the GdkDisplay to which device pertains.
Gdk.DeviceManager Property	display : Gdk.Display
Gdk.DeviceManager Method	get_display () : Gdk.Display Gets the GdkDisplay associated to device_manager.
Gdk.DisplayManager Property	default_display : Gdk.Display
Gdk.DisplayManager Signal	display_opened (DisplayManager *self, Display display*) : none The ::display-opened signal is emitted when a display is opened.
Gdk.DisplayManager Method	get_default_display () : Gdk.Display Gets the default GdkDisplay.
Gdk.DisplayManager Method	open_display (String *name*) : Gdk.Display Opens a display.
Gdk.DisplayManager Method	set_default_display (Display *display) : none Sets display* as the default display.
Gdk.Keymap Method	Gdk.Keymap.get_for_display (Display *display) : Gdk.Keymap Returns the GdkKeymap* attached to display.
Gdk.Screen Method	get_display () : Gdk.Display Gets the display to which the screen belongs.
Gdk.Window Method	get_display () : Gdk.Display Gets the GdkDisplay associated with a GdkWindow.
GdkX11 Method	GdkX11.x11_get_xatom_name_for_display (Display *display, Atom xatom*) : String Returns the name of an X atom for its display.
GdkX11 Method	GdkX11.x11_lookup_xdisplay (Display *xdisplay) : Gdk.Display Find the GdkDisplay* corresponding to display, if any exists.
GdkX11 Method	GdkX11.x11_register_standard_event_type (Display *display, gint32 event_base, gint32 n_events) : none Registers interest in receiving extension events with type codes between event_base* and event_base + n_events - 1.
GdkX11.X11Display Method	GdkX11.X11Display.error_trap_pop (Display *display*) : gint32 Pops the error trap pushed by gdk_x11_display_error_trap_push().
GdkX11.X11Display Method	GdkX11.X11Display.error_trap_pop_ignored (Display *display*) : none Pops the error trap pushed by gdk_x11_display_error_trap_push().
GdkX11.X11Display Method	GdkX11.X11Display.error_trap_push (Display *display) : none Begins a range of X requests on display* for which X error events will be ignored.
GdkX11.X11Display Method	GdkX11.X11Display.get_startup_notification_id (Display *display*) : String Gets the startup notification ID for a display.
GdkX11.X11Display Method	GdkX11.X11Display.get_user_time (Display *display*) : guint32 Returns the timestamp of the last user interaction on by user interaction such as key presses or pointer movements.
GdkX11.X11Display Method	GdkX11.X11Display.grab (Display *display) : none Call XGrabServer() on display*.
GdkX11.X11Display Method	GdkX11.X11Display.set_cursor_theme (Display *display, String theme, gint32 size*) : none Sets the cursor theme from which the images for cursor should be taken.
GdkX11.X11Display Method	GdkX11.X11Display.set_startup_notification_id (Display *display, String startup_id*) : none Sets the startup notification ID for a display.
GdkX11.X11Display Method	GdkX11.X11Display.string_to_compound_text (Display *display, String str, Object out_values*) : gint32 Convert a string from the encoding of the current locale into a form suitable for storing in a window property.
GdkX11.X11Display Method	GdkX11.X11Display.text_property_to_text_list (Display *display, Atom encoding, gint32 format, guint8 text, gint32 length, String list*) : gint32 Convert a text string from the encoding as it is stored in a property into an array of strings in the encoding of the current locale.
GdkX11.X11Display Method	GdkX11.X11Display.ungrab (Display *display) : none Ungrab display* after it has been grabbed with gdk_x11_display_grab().
GdkX11.X11Display Method	GdkX11.X11Display.utf8_to_compound_text (Display *display, String str, Object out_values*) : gboolean Converts from UTF-8 to compound text.
GdkX11.X11Window Method	new GdkX11.X11Window.foreign_new_for_display (Display *display, Window window*) : Gdk.Window Create a new GdkX11.X11Window
GdkX11.X11Window Method	GdkX11.X11Window.lookup_for_display (Display *display, Window window) : Gdk.Window Looks up the GdkWindow* that wraps the given native window handle.
Gtk Method	Gtk.selection_owner_set_for_display (Display *display, Widget widget, Atom selection, guint32 time_) : gboolean Claim ownership of a given selection for a particular widget, or, if widget* is NULL, release ownership of the selection.
Gtk.Clipboard Method	Gtk.Clipboard.get_for_display (Display *display, Atom selection*) : Gtk.Clipboard Returns the clipboard object for the given selection.
Gtk.Clipboard Method	get_display () : Gdk.Display Gets the GdkDisplay associated with clipboard
Gtk.SelectionData Method	get_display () : Gdk.Display Retrieves the display of the selection.
Gtk.Tooltip Method	Gtk.Tooltip.trigger_tooltip_query (Display *display) : none Triggers a new tooltip query on display*, in order to update the current visible tooltip, or to show/hide the current tooltip.
Gtk.Widget Method	get_display () : Gdk.Display Get the GdkDisplay for the toplevel window associated with this widget.