Class
GdkAppLaunchContext
Description [src]
final class Gdk.AppLaunchContext : Gio.AppLaunchContext {
/* No available fields */
}
GdkAppLaunchContext handles launching an application in a graphical context.
It is an implementation of GAppLaunchContext that 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_display (display);
gdk_app_launch_context_set_timestamp (gdk_event_get_time (event));
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);
Instance methods
gdk_app_launch_context_get_display
Gets the GdkDisplay that context is for.
gdk_app_launch_context_set_desktop
Sets the workspace on which applications will be launched.
gdk_app_launch_context_set_icon
Sets the icon for applications that are launched with this context.
gdk_app_launch_context_set_icon_name
Sets the icon for applications that are launched with this context.
gdk_app_launch_context_set_timestamp
Sets the timestamp of context.
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
Properties
Gdk.AppLaunchContext:display
The display that the GdkAppLaunchContext is on.
Signals
Signals inherited from GAppLaunchContext (2)
Gio.AppLaunchContext::launch-failed
The ::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::launched
The ::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.