Class

GdkAppLaunchContext

Description [src]

final class Gdk.AppLaunchContext : Gio.AppLaunchContext {
  /* No available fields */
}

GdkAppLaunchContext is an implementation of GAppLaunchContext that handles launching an application in a graphical context. It provides startup notification and allows to launch applications on a specific screen or workspace.

Launching an application

GdkAppLaunchContext *context;

context = gdk_display_get_app_launch_context (display);

gdk_app_launch_context_set_screen (screen);
gdk_app_launch_context_set_timestamp (event->time);

if (!g_app_info_launch_default_for_uri ("http://www.gtk.org", context, &error))
  g_warning ("Launching failed: %s\n", error->message);

g_object_unref (context);

Hierarchy

hierarchy this GdkAppLaunchContext ancestor_0 GAppLaunchContext ancestor_0--this ancestor_1 GObject ancestor_1--ancestor_0

Constructors

gdk_app_launch_context_new

Creates a new GdkAppLaunchContext.

Available since: 2.14

Deprecated since: 3.0

Instance methods

gdk_app_launch_context_set_desktop

Sets the workspace on which applications will be launched when using this context when running under a window manager that supports multiple workspaces, as described in the Extended Window Manager Hints.

Available since: 2.14

gdk_app_launch_context_set_display

Sets the display on which applications will be launched when using this context. See also gdk_app_launch_context_set_screen().

Available since: 2.14

Deprecated since: 3.0

gdk_app_launch_context_set_icon

Sets the icon for applications that are launched with this context.

Available since: 2.14

gdk_app_launch_context_set_icon_name

Sets the icon for applications that are launched with this context. The icon_name will be interpreted in the same way as the Icon field in desktop files. See also gdk_app_launch_context_set_icon().

Available since: 2.14

gdk_app_launch_context_set_screen

Sets the screen on which applications will be launched when using this context. See also gdk_app_launch_context_set_display().

Available since: 2.14

gdk_app_launch_context_set_timestamp

Sets the timestamp of context. The timestamp should ideally be taken from the event that triggered the launch.

Available since: 2.14

Methods inherited from GAppLaunchContext (6)
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.

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.

Available since: 2.32

g_app_launch_context_get_startup_notify_id

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

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

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.

Available 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.

Available since: 2.32

Methods inherited from GObject (43)

Please see GObject for a full list of methods.

Properties

Gdk.AppLaunchContext:display
No description available.

Signals

Signals inherited from GAppLaunchContext (3)
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.

Available 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.

Available since: 2.72

Gio.AppLaunchContext::launched

The GAppLaunchContext::launched signal is emitted when a GAppInfo is successfully launched. 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.

Available since: 2.36

Signals inherited from GObject (1)
GObject.Object::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.