launch


Description:

public abstract bool launch (List<File>? files, AppLaunchContext? context) throws Error

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, throws 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 launch_uris instead.

The launched application inherits the environment of the launching process, but it can be modified with setenv and 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` and `DESKTOP_STARTUP_ID` environment variables are also set, based on information provided in context.

Parameters:

this

a AppInfo

files

a List of File objects

context

a AppLaunchContext or null

Returns:

true on successful launch, false otherwise.




2022 vala-language.org