Package: gio

Class gio:app-launch-context

Superclasses

gobject:object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

Direct Slots

None

Details

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.

Signal Details

The "launch-failed" signal
lambda (context startup-notify-id)    :run-last      
context
The g:app-launch-context object emitting the signal.
startup-notify-id
The string with the startup notification ID for the failed launch.
The signal is emitted when a g:app-info launch fails. The startup notification ID is provided, so that the launcher can cancel the startup notification.
The "launch-started" signal
lambda (context appinfo platform-data)    :run-first     
context
The g:app-launch-context object emitting the signal.
appinfo
The g:app-info instance that is about to be launched.
platform-data
The g:variant parameter with additional platform specific data for this launch. The argument can be NULL.
The signal is emitted when a g:app-info instance is about to be launched. If non-null the platform-data is a g:variant dictionary mapping strings to variants, that is a{sv}, which contains additional, platform specific data about this launch. On UNIX, at least the startup-notification-id keys will be present.

The value of the startup-notification-id key (type s) is a startup notification ID corresponding to the format from the startup notification specification. It allows tracking the progress of the launchee through startup.

It is guaranteed that this signal is followed by either a "launched" or "launch-failed" signal.

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

The default handler is called after the handlers added via the g:signal-connect function.

Since 2.72
The "launched" signal
lambda (context appinfo platform-data)    :run-last      
context
The g:app-launch-context object emitting the signal.
appinfo
The g:app-info object that was just launched.
platform-data
The g:variant parameter with additional platform specific data for this launch.
The signal is emitted when a g:app-info object is successfully launched. The argument platform-data is a g:variant dictionary mapping strings to variants, that is 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. g:app-launch-context-new
 

Inherited Slot Access Functions

See also

2025-05-01