Method
GioAppInfolaunch
Declaration
gboolean
g_app_info_launch (
GAppInfo* appinfo,
GList* files,
GAppLaunchContext* context,
GError** error
)
Description
Launches the application. Passes files to the launched application
as arguments, using the optional context to get information
about the details of the launcher (like what screen it is on).
On error, error will be set accordingly.
To launch the application without arguments pass a NULL files list.
Note that even if the launch is successful the application launched can fail to start if it runs into problems during startup. There is no way to detect this.
Some URIs can be changed when passed through a GFile (for instance
unsupported URIs with strange formats like mailto:), so if you have
a textual URI you want to pass in as argument, consider using
g_app_info_launch_uris() instead.
The launched application inherits the environment of the launching
process, but it can be modified with g_app_launch_context_setenv()
and g_app_launch_context_unsetenv().
On UNIX, this function sets the GIO_LAUNCHED_DESKTOP_FILE
environment variable with the path of the launched desktop file and
GIO_LAUNCHED_DESKTOP_FILE_PID to the process id of the launched
process. This can be used to ignore GIO_LAUNCHED_DESKTOP_FILE,
should it be inherited by further processes. The DISPLAY,
XDG_ACTIVATION_TOKEN and DESKTOP_STARTUP_ID environment
variables are also set, based on information provided in context.
Parameters
files-
Type: A list of
NoneA
GListofGFileobjects.The argument can be NULL.The data is owned by the caller of the function. context-
Type:
GAppLaunchContextA
GAppLaunchContextorNULL.The argument can be NULL.The data is owned by the caller of the function. error-
Type:
GError **The return location for a recoverable error.
The argument can be NULL.If the return location is not NULL, then you must initialize it to aNULLGError*.The argument will left initialized to NULLby the method if there are no errors.In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.