Xfce Gdk extensions

Xfce Gdk extensions — Additional Gdk related functions.

Synopsis

#include <libxfcegui4/libxfcegui4.h>

gchar*              xfce_gdk_display_get_fullname       (GdkDisplay *display);
GdkScreen*          xfce_gdk_display_locate_monitor_with_pointer
                                                        (GdkDisplay *display,
                                                         gint *monitor_return);
gchar *             xfce_gdk_screen_get_fullname        (GdkScreen *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);
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);
gboolean            xfce_gdk_spawn_command_line_on_screen
                                                        (GdkScreen *screen,
                                                         const gchar *command_line,
                                                         GError **error);

Description

Details

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.

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.

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.

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.

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.

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.

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

See Also

Gdk reference manual