方法

GioAppInfolaunch

声明 [src]

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

描述 [src]

启动应用程序。将 files 作为参数传递给启动的应用程序,使用可选的 context 查询启动器的详细信息(如位于哪个屏幕)。如有错误,则会相应地将 error 设置。

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

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

某些 URI 在通过 GFile 传递时可能会更改(例如不支持的具有奇怪格式的 URI,如 mailto:),因此如果您要将文本 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
该数据由方法的调用者拥有。
上下文

类型: GAppLaunchContext

启动上下文。

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

类型: GError **

用于可恢复错误的返回位置。

参数可以 NULL
如果返回位置不是NULL,则您必须将其初始化为NULLGError*
如果没有错误,方法将保留默认的NULL初始化。
在出错情况下,参数将设置为一个新的GError分配;调用者将负责对数据的所有权,并负责释放它。

返回值

类型: gboolean

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