Xfce Gdk extensions

## 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