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.