Xfce Gdk extensions

Xfce Gdk extensions — Additional Gdk related functions.

Functions

Includes

#include <libxfcegui4/libxfcegui4.h>

Description

Functions

xfce_gdk_display_get_fullname ()

gchar *
xfce_gdk_display_get_fullname (GdkDisplay *display);

Determines the full qualified name of display . The full name includes both the hostname of the Xserver node and the display number of the Xserver.

Parameters

display

A valid Gdk display.

 

Returns

The full qualified name of display .

Since 4.2


xfce_gdk_display_locate_monitor_with_pointer ()

GdkScreen *
xfce_gdk_display_locate_monitor_with_pointer
                               (GdkDisplay *display,
                                gint *monitor_return);

Locates the monitor and the screen which contains the pointer. If it is not possible to determine the current pointer position, NULL is returned.

Parameters

display

A Gdk display or NULL to choose the default display.

 

monitor_return

Address to store the monitor number to or NULL.

 

Returns

The screen that contains the pointer.

Since 4.2


xfce_gdk_screen_get_fullname ()

gchar *
xfce_gdk_screen_get_fullname (GdkScreen *screen);

Like xfce_gdk_display_get_fullname(), but also includes the screen number.

Parameters

screen

A Gdk screen.

 

Returns

The full qualified name of screen .

Since 4.2


xfce_gdk_spawn_on_screen ()

gboolean
xfce_gdk_spawn_on_screen (GdkScreen *screen,
                          const gchar *working_directory,
                          gchar **argv,
                          gchar **envp,
                          GSpawnFlags flags,
                          GSpawnChildSetupFunc child_setup,
                          gpointer user_data,
                          gint *child_pid,
                          GError **error);

Like g_spawn_async(), except the child process is spawned in such an environment that on calling gdk_display_open() it would be returned a GdkDisplay with screen as the default screen.

This is useful for applications which wish to launch an application on a specific screen.

Parameters

screen

a GdkScreen

 

working_directory

child's current working directory, or NULL to inherit parent's

 

argv

child's argument vector

 

envp

child's environment, or NULL to inherit parent's

 

flags

flags from GSpawnFlags

 

child_setup

function to run in the child just before exec()

 

user_data

user data for child_setup

 

child_pid

return location for child process ID, or NULL

 

error

return location for error

 

Returns

TRUE on success, FALSE if error is set

Since 4.2


xfce_gdk_spawn_on_screen_with_pipes ()

gboolean
xfce_gdk_spawn_on_screen_with_pipes (GdkScreen *screen,
                                     const gchar *working_directory,
                                     gchar **argv,
                                     gchar **envp,
                                     GSpawnFlags flags,
                                     GSpawnChildSetupFunc child_setup,
                                     gpointer user_data,
                                     gint *child_pid,
                                     gint *standard_input,
                                     gint *standard_output,
                                     gint *standard_error,
                                     GError **error);

Like g_spawn_async_with_pipes(), except the child process is spawned in such an environment that on calling gdk_display_open() it would be returned a GdkDisplay with screen as the default screen.

This is useful for applications which wish to launch an application on a specific screen.

Parameters

screen

a GdkScreen

 

working_directory

child's current working directory, or NULL to inherit parent's

 

argv

child's argument vector

 

envp

child's environment, or NULL to inherit parent's

 

flags

flags from GSpawnFlags

 

child_setup

function to run in the child just before exec()

 

user_data

user data for child_setup

 

child_pid

return location for child process ID, or NULL

 

standard_input

return location for file descriptor to write to child's stdin, or NULL

 

standard_output

return location for file descriptor to read child's stdout, or NULL

 

standard_error

return location for file descriptor to read child's stderr, or NULL

 

error

return location for error

 

Returns

TRUE on success, FALSE if an error was set

Since 4.2


xfce_gdk_spawn_command_line_on_screen ()

gboolean
xfce_gdk_spawn_command_line_on_screen (GdkScreen *screen,
                                       const gchar *command_line,
                                       GError **error);

Like g_spawn_command_line_async(), except the child process is spawned in such an environment that on calling gdk_display_open() it would be returned a GdkDisplay with screen as the default screen.

This is useful for applications which wish to launch an application on a specific screen.

Parameters

screen

a GdkScreen

 

command_line

a command line

 

error

return location for errors

 

Returns

TRUE on success, FALSE if error is set.

Since 4.2

Types and Values

See Also

Gdk reference manual