### Class

# Gio AppLaunchContext

since: 2.0

#### Description

    class Gio.AppLaunchContext : GObject.Object
    {
      /* No available fields */
    }

Integrating the launch with the launching application. This is used to handle for instance startup notification and launching the new application on the same screen as the launching window.

Available since: 2.0

#### Ancestors

- GObject

#### Constructors

###### g_app_launch_context_new

Creates a new application launch context. This is not normally used, instead you instantiate a subclass of this, such as `GdkAppLaunchContext`.

since: 2.0

#### Instance methods

###### g_app_launch_context_get_display

Gets the display string for the `context`. This is used to ensure new applications are started on the same display as the launching application, by setting the `DISPLAY` environment variable.

since: 2.0

###### g_app_launch_context_get_environment

Gets the complete environment variable list to be passed to the child process when `context` is used to launch an application. This is a `NULL`-terminated array of strings, where each string has the form `KEY=VALUE`.

since: 2.32

###### g_app_launch_context_get_startup_notify_id

Initiates startup notification for the application and returns the `XDG_ACTIVATION_TOKEN` or `DESKTOP_STARTUP_ID` for the launched operation, if supported.

since: 2.0

###### g_app_launch_context_launch_failed

Called when an application has failed to launch, so that it can cancel the application startup notification started in g_app_launch_context_get_startup_notify_id().

since: 2.0

###### g_app_launch_context_setenv

Arranges for `variable` to be set to `value` in the child’s environment when `context` is used to launch an application.

since: 2.32

###### g_app_launch_context_unsetenv

Arranges for `variable` to be unset in the child’s environment when `context` is used to launch an application.

since: 2.32

##### Methods inherited from GObject (43)

Please see GObject for a full list of methods.

#### Signals

###### Gio.AppLaunchContext::launch-failed

The `GAppLaunchContext::launch-failed` signal is emitted when a `GAppInfo` launch fails. The startup notification id is provided, so that the launcher can cancel the startup notification.

since: 2.36

###### Gio.AppLaunchContext::launch-started

The `GAppLaunchContext::launch-started` signal is emitted when a `GAppInfo` is about to be launched. If non-null the `platform_data` is an GVariant dictionary mapping strings to variants (ie `a{sv}`), which contains additional, platform-specific data about this launch. On UNIX, at least the `startup-notification-id` keys will be present.

since: 2.72

###### Gio.AppLaunchContext::launched

The `GAppLaunchContext::launched` signal is emitted when a `GAppInfo` is successfully launched.

since: 2.36

##### Signals inherited from GObject (1)

###### GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

since: 2.0

#### Class structure

    struct GioAppLaunchContextClass {
      GObjectClass parent_class;
      char* (* get_display) (
        GAppLaunchContext* context,
        GAppInfo* info,
        GList* files
      );
      char* (* get_startup_notify_id) (
        GAppLaunchContext* context,
        GAppInfo* info,
        GList* files
      );
      void (* launch_failed) (
        GAppLaunchContext* context,
        const char* startup_notify_id
      );
      void (* launched) (
        GAppLaunchContext* context,
        GAppInfo* info,
        GVariant* platform_data
      );
      void (* launch_started) (
        GAppLaunchContext* context,
        GAppInfo* info,
        GVariant* platform_data
      );
      void (* _g_reserved1) (
    void
      );
      void (* _g_reserved2) (
    void
      );
      void (* _g_reserved3) (
    void
      );

    }

No description available.

###### Class members

`parent_class: GObjectClass`
  No description available.
`get_display: char* (* get_display) ( GAppLaunchContext* context, GAppInfo* info, GList* files )`
  No description available.
`get_startup_notify_id: char* (* get_startup_notify_id) ( GAppLaunchContext* context, GAppInfo* info, GList* files )`
  No description available.
`launch_failed: void (* launch_failed) ( GAppLaunchContext* context, const char* startup_notify_id )`
  No description available.
`launched: void (* launched) ( GAppLaunchContext* context, GAppInfo* info, GVariant* platform_data )`
  No description available.
`launch_started: void (* launch_started) ( GAppLaunchContext* context, GAppInfo* info, GVariant* platform_data )`
  No description available.
`_g_reserved1: void (* _g_reserved1) ( void )`
  No description available.
`_g_reserved2: void (* _g_reserved2) ( void )`
  No description available.
`_g_reserved3: void (* _g_reserved3) ( void )`
  No description available.

#### Virtual methods

###### Gio.AppLaunchContextClass.get_display

Gets the display string for the `context`. This is used to ensure new applications are started on the same display as the launching application, by setting the `DISPLAY` environment variable.

since: 2.0

###### Gio.AppLaunchContextClass.get_startup_notify_id

Initiates startup notification for the application and returns the `XDG_ACTIVATION_TOKEN` or `DESKTOP_STARTUP_ID` for the launched operation, if supported.

since: 2.0

###### Gio.AppLaunchContextClass.launch_failed

Called when an application has failed to launch, so that it can cancel the application startup notification started in g_app_launch_context_get_startup_notify_id().

since: 2.0

###### Gio.AppLaunchContextClass.launch_started

No description available.

since: 2.0

###### Gio.AppLaunchContextClass.launched

No description available.

since: 2.0