Gio.AppLaunchContext¶

Subclasses:	None

Methods¶

Inherited:	GObject.Object (37)
Structs:	GObject.ObjectClass (5)

class	`new` ()
	`get_display` (info, files)
	`get_environment` ()
	`get_startup_notify_id` (info, files)
	`launch_failed` (startup_notify_id)
	`setenv` (variable, value)
	`unsetenv` (variable)

Virtual Methods¶

Inherited:	GObject.Object (7)

	`do_get_display` (info, files)
	`do_get_startup_notify_id` (info, files)
	`do_launch_failed` (startup_notify_id)
	`do_launched` (info, platform_data)

Properties¶

None

Signals¶

Inherited:	GObject.Object (1)

Name	Short Description
`launch-failed`	The `::launch-failed` signal is emitted when a `Gio.AppInfo` launch fails.
`launched`	The `::launched` signal is emitted when a `Gio.AppInfo` is successfully launched.

Fields¶

Inherited:	GObject.Object (1)

Name	Type	Access	Description
parent_instance	`GObject.Object`	r

Class Details¶

class Gio.AppLaunchContext(**kwargs)¶

Bases:	`GObject.Object`
Abstract:	No
Structure:	`Gio.AppLaunchContextClass`

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.

classmethod new()[source]¶

Returns:	a `Gio.AppLaunchContext`.
Return type:	`Gio.AppLaunchContext`

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

get_display(info, files)[source]¶

Parameters:	info (`Gio.AppInfo`) – a `Gio.AppInfo` files ([`Gio.File`]) – a `GLib.List` of `Gio.File` objects
Returns:	a display string for the display.
Return type:	`str`

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

get_environment()[source]¶

Returns:	the child’s environment
Return type:	[`str`]

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

New in version 2.32.

get_startup_notify_id(info, files)[source]¶

Parameters:	info (`Gio.AppInfo`) – a `Gio.AppInfo` files ([`Gio.File`]) – a `GLib.List` of of `Gio.File` objects
Returns:	a startup notification ID for the application, or `None` if not supported.
Return type:	`str`

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

Startup notification IDs are defined in the FreeDesktop.Org Startup Notifications standard.

launch_failed(startup_notify_id)[source]¶

Parameters:	startup_notify_id (`str`) – the startup notification id that was returned by `Gio.AppLaunchContext.get_startup_notify_id`().

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

setenv(variable, value)[source]¶

Parameters:	variable (`str`) – the environment variable to set value (`str`) – the value for to set the variable to.

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

New in version 2.32.

unsetenv(variable)[source]¶

Parameters:	variable (`str`) – the environment variable to remove

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

New in version 2.32.

do_get_display(info, files) virtual¶

Parameters:	info (`Gio.AppInfo`) – a `Gio.AppInfo` files ([`Gio.File`]) – a `GLib.List` of `Gio.File` objects
Returns:	a display string for the display.
Return type:	`str`

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.

do_get_startup_notify_id(info, files) virtual¶

Parameters:	info (`Gio.AppInfo`) – a `Gio.AppInfo` files ([`Gio.File`]) – a `GLib.List` of of `Gio.File` objects
Returns:	a startup notification ID for the application, or `None` if not supported.
Return type:	`str`

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

Startup notification IDs are defined in the FreeDesktop.Org Startup Notifications standard.

do_launch_failed(startup_notify_id) virtual¶

Parameters:	startup_notify_id (`str`) – the startup notification id that was returned by `Gio.AppLaunchContext.get_startup_notify_id`().

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

do_launched(info, platform_data) virtual¶

Parameters:	info (`Gio.AppInfo`) – platform_data (`GLib.Variant`) –

Signal Details¶

Gio.AppLaunchContext.signals.launch_failed(app_launch_context, startup_notify_id)¶

Signal Name:	`launch-failed`
Flags:	`RUN_LAST`
Parameters:	app_launch_context (`Gio.AppLaunchContext`) – The object which received the signal startup_notify_id (`str`) – the startup notification id for the failed launch

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

New in version 2.36.

Gio.AppLaunchContext.signals.launched(app_launch_context, info, platform_data)¶

Signal Name:	`launched`
Flags:	`RUN_LAST`
Parameters:	app_launch_context (`Gio.AppLaunchContext`) – The object which received the signal info (`Gio.AppInfo`) – the `Gio.AppInfo` that was just launched platform_data (`GLib.Variant`) – additional platform-specific data for this launch

The ::launched signal is emitted when a Gio.AppInfo is successfully launched. The platform_data is an GLib.Variant 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.

New in version 2.36.