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