类
GdkAppLaunchContext
描述 [src]
final class Gdk.AppLaunchContext : Gio.AppLaunchContext
{
/* No available fields */
}
GdkAppLaunchContext
处理在图形 context 中启动应用程序。
它是 GAppLaunchContext
的实现,它提供启动通知并允许在特定 工作区上启动应用程序。
启动应用程序
GdkAppLaunchContext *context;
context = gdk_display_get_app_launch_context (display);
gdk_app_launch_context_set_timestamp (gdk_event_get_time (event));
if (!g_app_info_launch_default_for_uri ("https://gtk.org.cn", context, &error))
g_warning ("Launching failed: %s\n", error->message);
g_object_unref (context);
实例方法
从 GAppLaunchContext (6)继承的方法
g_app_launch_context_get_display
获取 context
的显示字符串。这用于确保新应用程序在与启动应用程序相同的显示器上启动,方法是设置 DISPLAY
环境 变量。
g_app_launch_context_get_environment
获取在使用 context
启动应用程序时要传递给子进程的全部环境变量列表。这是一个以 NULL
结尾的字符串数组,其中每个字符串都具有 KEY=VALUE
格式。
g_app_launch_context_get_startup_notify_id
启动应用程序并返回 XDG_ACTIVATION_TOKEN
或 DESKTOP_STARTUP_ID
进行启动操作,如果 支持。
g_app_launch_context_launch_failed
在应用程序启动失败时调用,以便该调用可以取消在 g_app_launch_context_get_startup_notify_id() 中启动的应用程序启动通知。
g_app_launch_context_setenv
安排在 context
用于启动 应用程序时,在子项的环境中将 variable
设置为 value
。
g_app_launch_context_unsetenv
安排在 context
用于启动 应用程序时,在子项的环境中取消设置 variable
。
信号
从 GAppLaunchContext (3)继承的信号
GAppLaunchContext::launch-failed
当 GAppInfo
启动失败时会发出 GAppLaunchContext::launch-failed
信号。提供了启动通知 id,以便启动器可以取消启动 通知。
GAppLaunchContext::launch-started
当即将启动 GAppInfo
时会发出 GAppLaunchContext::launch-started
信号。如果非 null
,则 platform_data
是 GVariant 词典,将字符串映射到变体(即 a{sv}
),其中包含有关此启动的其他特定于平台的数据。在 UNIX 上,至少会 出现 startup-notification-id
键。
GAppLaunchContext::launched
成功启动 GAppInfo
时,会发出 GAppLaunchContext::launched
信号。
从 GObject 继承的信号 (1)
GObject::notify
当通过 g_object_set_property()、g_object_set() 等途径设置其属性的值时,会对对象发出 notify 信号。