Gtk file launcher

## Gtk file launcher Gtk file launcher — Gtk file launcher utilities. |

## Synopsis

    gboolean            fm_launch_command_simple            (GtkWindow *parent,
                                                             GAppLaunchContext *ctx,
                                                             GAppInfoCreateFlags flags,
                                                             const char *cmd,
                                                             FmPathList *files);
    gboolean            fm_launch_desktop_entry_simple      (GtkWindow *parent,
                                                             GAppLaunchContext *ctx,
                                                             FmFileInfo *entry,
                                                             FmPathList *files);
    gboolean            fm_launch_file_simple               (GtkWindow *parent,
                                                             GAppLaunchContext *ctx,
                                                             FmFileInfo *file_info,
                                                             FmLaunchFolderFunc func,
                                                             gpointer user_data);
    gboolean            fm_launch_files_simple              (GtkWindow *parent,
                                                             GAppLaunchContext *ctx,
                                                             GList *file_infos,
                                                             FmLaunchFolderFunc func,
                                                             gpointer user_data);
    gboolean            fm_launch_path_simple               (GtkWindow *parent,
                                                             GAppLaunchContext *ctx,
                                                             FmPath *path,
                                                             FmLaunchFolderFunc func,
                                                             gpointer user_data);
    gboolean            fm_launch_paths_simple              (GtkWindow *parent,
                                                             GAppLaunchContext *ctx,
                                                             GList *paths,
                                                             FmLaunchFolderFunc func,
                                                             gpointer user_data);
    gboolean            fm_launch_search_simple             (GtkWindow *parent,
                                                             GAppLaunchContext *ctx,
                                                             const GList *paths,
                                                             FmLaunchFolderFunc func,
                                                             gpointer user_data);

## Description

`include`: libfm/fm-gtk.h

Utilities to launch files using libfm file launchers.

## Details

### fm_launch_command_simple ()

    gboolean            fm_launch_command_simple            (GtkWindow *parent,
                                                             GAppLaunchContext *ctx,
                                                             GAppInfoCreateFlags flags,
                                                             const char *cmd,
                                                             FmPathList *files);

Launches command. `files` will be supplied to launch if `cmd` accepts arguments. If `ctx` is `NULL` then new context on the same screen as `parent` will be created for launching the command.

`parent` : | window to determine launch screen. [allow-none]
`ctx` : | launch context. [allow-none]
`flags` : | flags to launch command
`cmd` : | command to launch
`files` : | files to supply launch. [allow-none]
Returns : | `TRUE` if launch was succesful.

Since 1.2.0

### fm_launch_desktop_entry_simple ()

    gboolean            fm_launch_desktop_entry_simple      (GtkWindow *parent,
                                                             GAppLaunchContext *ctx,
                                                             FmFileInfo *entry,
                                                             FmPathList *files);

Launches desktop entry. `files` will be supplied to launch if `entry` accepts arguments. If `ctx` is `NULL` then new context on the same screen as `parent` will be created for launching the application.

`parent` : | window to determine launch screen. [allow-none]
`ctx` : | launch context. [allow-none]
`entry` : | desktop entry file to launch
`files` : | files to supply launch. [allow-none]
Returns : | `TRUE` if launch was succesful.

Since 1.0.1

### fm_launch_file_simple ()

    gboolean            fm_launch_file_simple               (GtkWindow *parent,
                                                             GAppLaunchContext *ctx,
                                                             FmFileInfo *file_info,
                                                             FmLaunchFolderFunc func,
                                                             gpointer user_data);

Launches file. If `file_info` is folder then uses `func` to launch it. If `ctx` is `NULL` then new context on the same screen as `parent` will be created for launching.

`parent` : | window to determine launch screen. [allow-none]
`ctx` : | launch context. [allow-none]
`file_info` : | file to launch
`func` : | callback to launch folder
`user_data` : | data supplied for `func`
Returns : | `TRUE` if launch was succesful.

Since 0.1.0

### fm_launch_files_simple ()

    gboolean            fm_launch_files_simple              (GtkWindow *parent,
                                                             GAppLaunchContext *ctx,
                                                             GList *file_infos,
                                                             FmLaunchFolderFunc func,
                                                             gpointer user_data);

Launches files using `func` to launch folders. If `ctx` is `NULL` then new context on the same screen as `parent` will be created for launching.

`parent` : | window to determine launch screen. [allow-none]
`ctx` : | launch context. [allow-none]
`file_infos` : | files to launch. [element-type FmFileInfo]
`func` : | callback to launch folder
`user_data` : | data supplied for `func`
Returns : | `TRUE` if launch was succesful.

Since 0.1.0

### fm_launch_path_simple ()

    gboolean            fm_launch_path_simple               (GtkWindow *parent,
                                                             GAppLaunchContext *ctx,
                                                             FmPath *path,
                                                             FmLaunchFolderFunc func,
                                                             gpointer user_data);

Launches file. If `path` is folder then uses `func` to launch it. If `ctx` is `NULL` then new context on the same screen as `parent` will be created for launching.

`parent` : | window to determine launch screen. [allow-none]
`ctx` : | launch context. [allow-none]
`path` : | file to launch
`func` : | callback to launch folder
`user_data` : | data supplied for `func`
Returns : | `TRUE` if launch was succesful.

Since 0.1.0

### fm_launch_paths_simple ()

    gboolean            fm_launch_paths_simple              (GtkWindow *parent,
                                                             GAppLaunchContext *ctx,
                                                             GList *paths,
                                                             FmLaunchFolderFunc func,
                                                             gpointer user_data);

Launches files using `func` to launch folders. If `ctx` is `NULL` then new context on the same screen as `parent` will be created for launching.

`parent` : | window to determine launch screen. [allow-none]
`ctx` : | launch context. [allow-none]
`paths` : | files to launch. [element-type FmPath]
`func` : | callback to launch folder
`user_data` : | data supplied for `func`
Returns : | `TRUE` if launch was succesful.

Since 0.1.0

### fm_launch_search_simple ()

    gboolean            fm_launch_search_simple             (GtkWindow *parent,
                                                             GAppLaunchContext *ctx,
                                                             const GList *paths,
                                                             FmLaunchFolderFunc func,
                                                             gpointer user_data);

Launches filesystem search. Uses `func` to open folder with search results. If `ctx` is `NULL` then new context on the same screen as `parent` will be created for launching.

`parent` : | window to determine launch screen. [allow-none]
`ctx` : | launch context. [allow-none]
`paths` : | paths to set initial search paths list. [allow-none][element-type FmPath]
`func` : | callback to launch folder
`user_data` : | data supplied for `func`
Returns : | `TRUE` if launch was succesful.

Since 1.0.2