Method

MateDesktopDesktopItemlaunch_on_screen

Declaration [src]

int
mate_desktop_item_launch_on_screen (
  const MateDesktopItem* item,
  GList* file_list,
  MateDesktopItemLaunchFlags flags,
  GdkScreen* screen,
  int workspace,
  GError** error
)

Description [src]

See mate_desktop_item_launch for a full description. This function additionally attempts to launch the application on a given screen and workspace.

This method is not directly available to language bindings.

Parameters

file_list

Type: A list of gpointer

Files/URIs to launch this item with, can be NULL.

The data is owned by the caller of the method.
flags

Type: MateDesktopItemLaunchFlags

FIXME.

screen

Type: GdkScreen

The %GdkScreen on which the application should be launched.

The data is owned by the caller of the method.
workspace

Type: int

The workspace on which the app should be launched (-1 for current)

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 a NULL GError*.
The argument will be left initialized to NULL by 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.

Return value

Type: int

The the pid of the process spawned. If more then one process was spawned the last pid is returned. On error -1 is returned and error is set.