Gio应用启动上下文

描述 [源]

class Gio.AppLaunchContext : GObject.Object
{
  /* No available fields */
}

将启动与启动的应用集成。这用于处理启动通知和在同一屏幕上启动新应用等情况。

祖先

构造函数

g_app_launch_context_new

创建一个新的应用启动上下文对象。通常不直接使用,而是实例化该类的子类,如 GdkAppLaunchContext

实例方法

g_app_launch_context_get_display

获取上下文的显示字符串。这用于确保新应用在启动时与启动应用位于同一显示,通过设置DISPLAY环境变量实现。

g_app_launch_context_get_environment

当使用上下文启动应用时,获取要传递给子进程的完整环境变量列表。这是一个以 null 结尾的字符串数组,其中每个字符串的形式为KEY=VALUE

since: 2.32

g_app_launch_context_get_startup_notify_id

启动应用的通知,并返回启动操作的XDG_ACTIVATION_TOKENDESKTOP_STARTUP_ID(如果受支持)。

g_app_launch_context_launch_failed

当应用启动失败时调用,以便它可以取消在g_app_launch_context_get_startup_notify_id()中开始的启动通知。

g_app_launch_context_setenv

当使用上下文启动应用时,安排将variable设置为value(变量)在子进程的环境中。

since: 2.32

g_app_launch_context_unsetenv

当使用上下文启动应用时,安排在子进程环境中取消variable(变量)。

since: 2.32

GObject继承的方法(43个)

请参阅GObject获取方法的全列表。

信号

Gio.AppLaunchContext::launch-failed

GAppInfo启动失败时,发出GAppLaunchContext::launch-failed信号。提供启动通知ID,以便启动器可以取消启动通知。

since: 2.36

Gio.AppLaunchContext::launch-started

GAppLaunchContext::launch-started 信号会在启动 GAppInfo 时发出。如果非空,则 platform_data 是一个 GVariant 字典,映射字符串到变体(即 a{sv}),其中包含有关此启动的附加、平台特定的数据。在 UNIX 上,至少 startup-notification-id 键将存在。

自 2.72 以来

Gio.AppLaunchContext::launched

GAppLaunchContext::launched 信号会在成功启动 GAppInfo 时发出。

since: 2.36

GObject 继承的信号(1)
GObject::notify

当对象的一个属性通过 g_object_set_property(), g_object_set() 等方式设置其值时,会发出 notify 信号。

类结构

struct GioAppLaunchContextClass {
  GObjectClass parent_class;
  char* (* get_display) (
    GAppLaunchContext* context,
    GAppInfo* info,
    GList* files
  );
  char* (* get_startup_notify_id) (
    GAppLaunchContext* context,
    GAppInfo* info,
    GList* files
  );
  void (* launch_failed) (
    GAppLaunchContext* context,
    const char* startup_notify_id
  );
  void (* launched) (
    GAppLaunchContext* context,
    GAppInfo* info,
    GVariant* platform_data
  );
  void (* launch_started) (
    GAppLaunchContext* context,
    GAppInfo* info,
    GVariant* platform_data
  );
  void (* _g_reserved1) (
void
  );
  void (* _g_reserved2) (
void
  );
  void (* _g_reserved3) (
void
  );
  
}

没有可用的描述。

类成员
parent_class: GObjectClass

没有可用的描述。

get_display: char* (* get_display) ( GAppLaunchContext* context, GAppInfo* info, GList* files )

没有可用的描述。

get_startup_notify_id: char* (* get_startup_notify_id) ( GAppLaunchContext* context, GAppInfo* info, GList* files )

没有可用的描述。

launch_failed: void (* launch_failed) ( GAppLaunchContext* context, const char* startup_notify_id )

没有可用的描述。

launched: void (* launched) ( GAppLaunchContext* context, GAppInfo* info, GVariant* platform_data )

没有可用的描述。

launch_started: void (* launch_started) ( GAppLaunchContext* context, GAppInfo* info, GVariant* platform_data )

没有可用的描述。

_g_reserved1: void (* _g_reserved1) ( void )

没有可用的描述。

_g_reserved2: void (* _g_reserved2) ( void )

没有可用的描述。

_g_reserved3: void (* _g_reserved3) ( void )

没有可用的描述。

虚拟方法

Gio.AppLaunchContextClass.get_display

获取上下文的显示字符串。这用于确保新应用在启动时与启动应用位于同一显示,通过设置DISPLAY环境变量实现。

Gio.AppLaunchContextClass.get_startup Notify_id

启动应用的通知,并返回启动操作的XDG_ACTIVATION_TOKENDESKTOP_STARTUP_ID(如果受支持)。

Gio.AppLaunchContextClass.launch_failed

当应用启动失败时调用,以便它可以取消在g_app_launch_context_get_startup_notify_id()中开始的启动通知。

Gio.AppLaunchContextClass.launch_started
没有可用的描述。

Gio.AppLaunchContextClass.launched
没有可用的描述。