onLaunched

fun onLaunched(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: (info: AppInfo, <Error class: unknown class>) -> Unit): <Error class: unknown class>(source)

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().

Since

2.36

Parameters

connectFlags

a combination of ConnectFlags

handler

the Callback to connect. Params: info the #GAppInfo that was just launched; platformData additional platform-specific data for this launch