Class: GdkX11::X11Surface

Inherits:
Gdk::Surface show all
Defined in:
(unknown)

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Gdk::Surface

#beep, #create_cairo_context, #create_gl_context, #create_similar_surface, #create_vulkan_context, #cursor, #cursor=, #destroy, #display, #display=, #frame_clock, #frame_clock=, #get_device_cursor, #get_device_position, #height, #height=, #hide, #initialize, #input_region=, #is_destroyed, #mapped, #mapped=, #mapped?, #opaque_region=, #queue_render, #request_layout, #scale, #scale=, #scale_factor, #scale_factor=, #set_device_cursor, #translate_coordinates, #width, #width=

Constructor Details

This class inherits a constructor from Gdk::Surface

Class Method Details

.lookup_for_display(display, window) ⇒ GdkX11::X11Surface

Looks up the GdkSurface that wraps the given native window handle.

Parameters:

  • display (GdkX11::X11Display) —

    the GdkDisplay corresponding to the window handle

  • window (xlib::Window) —

    an Xlib Window

Returns:

Instance Method Details

#desktop ⇒ Integer

Gets the number of the workspace surface is on.

Returns:

  • (Integer) —

    the current workspace of surface

#frame_sync_enabled=(frame_sync_enabled) ⇒ nil

This function can be used to disable frame synchronization for a surface. Normally frame synchronziation will be enabled or disabled based on whether the system has a compositor that supports frame synchronization, but if the surface is not directly managed by the window manager, then frame synchronziation may need to be disabled. This is the case for a surface embedded via the XEMBED protocol.

Parameters:

  • frame_sync_enabled (Boolean) —

    whether frame-synchronization should be enabled

Returns:

  • (nil)

#group ⇒ Gdk::Surface

Returns the group this surface belongs to.

Returns:

#group=(leader) ⇒ nil

Sets the group leader of surface to be leader. See the ICCCM for details.

Parameters:

Returns:

  • (nil)

#move_to_current_desktop ⇒ nil

Moves the surface to the correct workspace when running under a window manager that supports multiple workspaces, as described in the Extended Window Manager Hints specification. Will not do anything if the surface is already on all workspaces.

Returns:

  • (nil)

#move_to_desktop(desktop) ⇒ nil

Moves the surface to the given workspace when running unde a window manager that supports multiple workspaces, as described in the Extended Window Manager Hints specification.

Parameters:

  • desktop (Integer) —

    the number of the workspace to move the surface to

Returns:

  • (nil)

#set_utf8_property(name, value) ⇒ nil

This function modifies or removes an arbitrary X11 window property of type UTF8_STRING. If the given surface is not a toplevel surface, it is ignored.

Parameters:

  • name (String) —

    Property name, will be interned as an X atom

  • value (String) —

    Property value, or nil to delete

Returns:

  • (nil)

#skip_pager_hint=(skips_pager) ⇒ nil

Sets a hint on surface that pagers should not display it. See the EWMH for details.

Parameters:

  • skips_pager (Boolean) —

    true to skip pagers

Returns:

  • (nil)

#skip_taskbar_hint=(skips_taskbar) ⇒ nil

Sets a hint on surface that taskbars should not display it. See the EWMH for details.

Parameters:

  • skips_taskbar (Boolean) —

    true to skip taskbars

Returns:

  • (nil)

#theme_variant=(variant) ⇒ nil

GTK applications can request a dark theme variant. In order to make other applications - namely window managers using GTK for themeing - aware of this choice, GTK uses this function to export the requested theme variant as _GTK_THEME_VARIANT property on toplevel surfaces.

Note that this property is automatically updated by GTK, so this function should only be used by applications which do not use GTK to create toplevel surfaces.

Parameters:

  • variant (String) —

    the theme variant to export

Returns:

  • (nil)

#urgency_hint=(urgent) ⇒ nil

Sets a hint on surface that it needs user attention. See the ICCCM for details.

Parameters:

  • urgent (Boolean) —

    true to indicate urgenct attention needed

Returns:

  • (nil)

#user_time=(timestamp) ⇒ nil

The application can use this call to update the _NET_WM_USER_TIME property on a toplevel surface. This property stores an Xserver time which represents the time of the last user input event received for this surface. This property may be used by the window manager to alter the focus, stacking, and/or placement behavior of surfaces when they are mapped depending on whether the new surface was created by a user action or is a "pop-up" surface activated by a timer or some other event.

Note that this property is automatically updated by GDK, so this function should only be used by applications which handle input events bypassing GDK.

Parameters:

  • timestamp (Integer) —

    An XServer timestamp to which the property should be set

Returns:

  • (nil)

#xid ⇒ xlib::Window

Returns the X resource (surface) belonging to a GdkSurface.

Returns:

  • (xlib::Window) —

    the ID of drawable’s X resource.