GdkX11.X11Screen¶

Subclasses:: None

Methods¶

Inherited:: GObject.Object (37)
Structs:: GObject.ObjectClass (5)

	`get_current_desktop` ()
	`get_monitor_output` (monitor_num)
	`get_number_of_desktops` ()
	`get_screen_number` ()
	`get_window_manager_name` ()
	`get_xscreen` ()
	`supports_net_wm_hint` (property_name)

Virtual Methods¶

Inherited:: GObject.Object (7)

Properties¶

None

Signals¶

Inherited:: GObject.Object (1)

Name	Short Description
`window-manager-changed`

Fields¶

Inherited:: GObject.Object (1)

Class Details¶

class GdkX11.X11Screen(**kwargs)¶

Bases:: GObject.Object
Abstract:: No
Structure:: GdkX11.X11ScreenClass

get_current_desktop()[source]¶

Returns:: the current workspace, or 0 if workspaces are not supported
Return type:: int

Returns the current workspace for self when running under a window manager that supports multiple workspaces, as described in the Extended Window Manager Hints specification.

get_monitor_output(monitor_num)[source]¶

Parameters:: monitor_num (int) – number of the monitor, between 0 and gdk_screen_get_n_monitors (screen)
Returns:: the XID of the monitor
Return type:: int

Gets the XID of the specified output/monitor. If the X server does not support version 1.2 of the RANDR extension, 0 is returned.

get_number_of_desktops()[source]¶

Returns:: the number of workspaces, or 0 if workspaces are not supported
Return type:: int

Returns the number of workspaces for self when running under a window manager that supports multiple workspaces, as described in the Extended Window Manager Hints specification.

get_screen_number()[source]¶

Returns:: the position of self among the screens of its display
Return type:: int

Returns the index of a GdkX11Screen.

get_window_manager_name()[source]¶

Returns:: the name of the window manager screen self, or “unknown” if the window manager is unknown. The string is owned by GDK and should not be freed.
Return type:: str

Returns the name of the window manager for self.

get_xscreen()[source]¶

Returns:: an Xlib xlib.Screen
Return type:: xlib.Screen

Returns the screen of a GdkX11Screen.

supports_net_wm_hint(property_name)[source]¶

Parameters:: property_name (str) – name of the WM property
Returns:: True if the window manager supports property
Return type:: bool

This function is specific to the X11 backend of GDK, and indicates whether the window manager supports a certain hint from the Extended Window Manager Hints specification.

When using this function, keep in mind that the window manager can change over time; so you shouldn’t use this function in a way that impacts persistent application state. A common bug is that your application can start up before the window manager does when the user logs in, and before the window manager starts GdkX11.X11Screen.supports_net_wm_hint() will return False for every property. You can monitor the window_manager_changed signal on GdkX11Screen to detect a window manager change.

Signal Details¶

GdkX11.X11Screen.signals.window_manager_changed(x11_screen)¶

Signal Name:: window-manager-changed
Flags:: RUN_LAST
Parameters:: x11_screen (GdkX11.X11Screen) – The object which received the signal