Interface AppLaunchContext.OnLaunched

Enclosing class:
AppLaunchContext
Functional Interface:
This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface public static interface AppLaunchContext.OnLaunched
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    onLaunched(AppInfo info, Variant platform_data)
    The #GAppLaunchContext::launched signal is emitted when a #GAppInfo is successfully
    launched.
  • Method Details

    • onLaunched

      void onLaunched(@Nonnull AppInfo info, @Nonnull Variant platform_data)
      The #GAppLaunchContext::launched signal is emitted when a #GAppInfo is successfully
      launched.

      Because a launch operation may involve spawning multiple instances of the
      target application, you should expect this signal to be emitted multiple
      times, one time for each spawned instance.

      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
      `pid` and `startup-notification-id` keys will be present.

      Since 2.72 the `pid` may be 0 if the process id wasn't known (for
      example if the process was launched via D-Bus). The `pid` may not be
      set at all in subsequent releases.

      On Windows, `pid` is guaranteed to be valid only for the duration of the
      #GAppLaunchContext::launched signal emission; after the signal is emitted,
      GLib will call g_spawn_close_pid(). If you need to keep the #GPid after the
      signal has been emitted, then you can duplicate `pid` using `DuplicateHandle()`.
      Parameters:
      info - the #GAppInfo that was just launched
      platform_data - additional platform-specific data for this launch