Application launching

## Application launching Application launching |

## Synopsis

    #include <gdk/gdk.h>

    typedef             GdkAppLaunchContext;
    GdkAppLaunchContext* gdk_app_launch_context_new         (void);
    void                gdk_app_launch_context_set_display  (GdkAppLaunchContext *context,
                                                             GdkDisplay *display);
    void                gdk_app_launch_context_set_screen   (GdkAppLaunchContext *context,
                                                             GdkScreen *screen);
    void                gdk_app_launch_context_set_desktop  (GdkAppLaunchContext *context,
                                                             gint desktop);
    void                gdk_app_launch_context_set_timestamp
                                                            (GdkAppLaunchContext *context,
                                                             guint32 timestamp);
    void                gdk_app_launch_context_set_icon     (GdkAppLaunchContext *context,
                                                             GIcon *icon);
    void                gdk_app_launch_context_set_icon_name
                                                            (GdkAppLaunchContext *context,
                                                             const char *icon_name);

## Description

## Details

### GdkAppLaunchContext

    typedef struct GdkAppLaunchContext	      GdkAppLaunchContext;

### gdk_app_launch_context_new ()

    GdkAppLaunchContext* gdk_app_launch_context_new         (void);

Creates a new GdkAppLaunchContext.

Returns : | a new GdkAppLaunchContext

Since 2.14

### gdk_app_launch_context_set_display ()

    void                gdk_app_launch_context_set_display  (GdkAppLaunchContext *context,
                                                             GdkDisplay *display);

Sets the display on which applications will be launched when using this context. See also `gdk_app_launch_context_set_screen()`.

`context` : | a GdkAppLaunchContext
`display` : | a GdkDisplay

Since 2.14

### gdk_app_launch_context_set_screen ()

    void                gdk_app_launch_context_set_screen   (GdkAppLaunchContext *context,
                                                             GdkScreen *screen);

Sets the screen on which applications will be launched when using this context. See also `gdk_app_launch_context_set_display()`. If both `screen` and `display` are set, the `screen` takes priority.

`context` : | a GdkAppLaunchContext
`screen` : | a GdkScreen

Since 2.14

### gdk_app_launch_context_set_desktop ()

    void                gdk_app_launch_context_set_desktop  (GdkAppLaunchContext *context,
                                                             gint desktop);

Sets the workspace on which applications will be launched when using this context when running under a window manager that supports multiple workspaces, as described in the Extended Window Manager Hints.

`context` : | a GdkAppLaunchContext
`desktop` : | the number of a workspace, or -1

Since 2.14

### gdk_app_launch_context_set_timestamp ()

    void                gdk_app_launch_context_set_timestamp
                                                            (GdkAppLaunchContext *context,
                                                             guint32 timestamp);

Sets the timestamp of `context`. The timestamp should ideally be taken from the event that triggered the launch.

`context` : | a GdkAppLaunchContext
`timestamp` : | a timestamp

Since 2.14

### gdk_app_launch_context_set_icon ()

    void                gdk_app_launch_context_set_icon     (GdkAppLaunchContext *context,
                                                             GIcon *icon);

Sets the icon for applications that are launched with this context. See also `gdk_app_launch_context_set_icon_name()`.

`context` : | a GdkAppLaunchContext
`icon` : | a GIcon, or `NULL`

Since 2.14

### gdk_app_launch_context_set_icon_name ()

    void                gdk_app_launch_context_set_icon_name
                                                            (GdkAppLaunchContext *context,
                                                             const char *icon_name);

Sets the icon for applications that are launched with this context. The `icon_name` will be interpreted in the same way as the Icon field in desktop files. See also `gdk_app_launch_context_set_icon()`. If both `icon` and `icon_name` are set, the `icon_name` takes priority.

`context` : | a GdkAppLaunchContext
`icon_name` : | an icon name, or `NULL`

Since 2.14