虚方法

GioAppInfolaunch

声明 [源]

gboolean
launch (
  GAppInfo* appinfo,
  GList* files,
  GAppLaunchContext* context,
  GError** error
)

描述 [源]

启动应用程序。将 files 作为参数传递给启动的应用程序,使用可选的 context 来获取有关启动器详细信息的信息(如它所在的屏幕)。如果出错,则相应地设置 error

要无参数启动应用程序,请传递一个 NULLfiles 列表。

请注意,即使启动成功,启动的应用程序也可能在启动过程中遇到问题而无法启动。无法检测到这种情况。

某些 URI 在通过 GFile 传递时可能会更改(例如,具有类似 mailto: 的奇怪格式的不受支持的 URI),因此如果您要以参数的形式传递文本 URI,请考虑使用 g_app_info_launch_uris() 代替。

启动的应用程序继承启动进程的环境,但可以使用 g_app_launch_context_setenv()g_app_launch_context_unsetenv() 进行修改。

UNIX 上,此函数将 GIO_LAUNCHED_DESKTOP_FILE 环境变量设置为启动的桌面文件的路径,并将 GIO_LAUNCHED_DESKTOP_FILE_PID 设置为启动进程的进程 ID。这可以用于忽略继承的 GIO_LAUNCHED_DESKTOP_FILE。在 context 中提供的信息的基础上,还设置了 DISPLAYXDG_ACTIVATION_TOKENDESKTOP_STARTUP_ID 环境变量。

参数

files

类型: 一个空列表

一组 GFile 对象。

参数可以是 NULL
数据由方法调用者拥有。
context

类型: GAppLaunchContext

启动上下文。

参数可以是 NULL
数据由方法调用者拥有。
错误

类型: GError **

可恢复错误的返回位置。

参数可以是 NULL
如果返回位置不是NULL,则必须将其初始化为NULLGError*
如果没有错误,虚拟函数将会将参数初始化为NULL
在出现错误的情况下,参数将被设置为一个新分配的GError;调用者将负责该数据的使用,并负责释放它。

返回值

类型: gboolean

成功启动时返回TRUE,否则返回FALSE