Application chooser combobox: Libfm Reference Manual

## Application chooser combobox Application chooser combobox — Combo box for application selection dialogs. |

## Functions

GAppInfo * | fm_app_chooser_combo_box_dup_selected_app ()
const GList * | fm_app_chooser_combo_box_get_custom_apps ()
void | fm_app_chooser_combo_box_setup ()
#define | fm_app_chooser_combo_box_setup_custom()
#define | fm_app_chooser_combo_box_setup_for_mime_type()

## Description

`include` : libfm/fm-gtk.h

The `fm_app_chooser_combo_box_setup()` allows to create a widget where applications are represented as a tree to choose from it. The dialog itself is represented by `fm_app_chooser_dlg_new()`.

## Functions

### fm_app_chooser_combo_box_dup_selected_app ()

    GAppInfo *
    fm_app_chooser_combo_box_dup_selected_app
                                   (GtkComboBox *combo,
                                    gboolean *is_sel_changed);

Retrieves the currently selected app. `is_sel_changed` (can be `NULL`) will get a boolean value which tells you if the currently selected app is different from the one initially selected in the combobox. The returned GAppInfo needs to be freed with `g_object_unref()`

Before 1.0.0 this call had name fm_app_chooser_combo_box_get_selected.

#### Parameters

combo | a GtkComboBox |
is_sel_changed | location to store `TRUE` if selection was changed. | [out][allow-none]

#### Returns

selected application.

Since: 0.1.5

### fm_app_chooser_combo_box_get_custom_apps ()

    const GList *
    fm_app_chooser_combo_box_get_custom_apps
                                   (GtkComboBox *combo);

Retrieves a list of custom apps added with app-chooser. The returned GList is owned by the combo box and shouldn't be freed.

#### Parameters

combo | a GtkComboBox |

#### Returns

list of applications.

[transfer none][element-type GAppInfo]

Since: 0.1.5

### fm_app_chooser_combo_box_setup ()

    void
    fm_app_chooser_combo_box_setup (GtkComboBox *combo,
                                    FmMimeType *mime_type,
                                    GList *apps,
                                    GAppInfo *sel);

Setups a combobox for selecting default application either for specified mime-type or from a list of pre-defined applications. If `mime_type` is `NULL`, and `sel` is provided and found in the `apps` , then it will be selected. If `mime_type` is not `NULL` then default application for the `mime_type` will be selected. When set up, the combobox will contain a list of available applications.

#### Parameters

combo | a GtkComboBox |
mime_type | a FmMimeType to select application. | [allow-none]
apps | custom list of applications. | [allow-none][element-type GAppInfo]
sel | a selected application in `apps` . | [allow-none]

Since: 0.1.5

### fm_app_chooser_combo_box_setup_custom()

    #define             fm_app_chooser_combo_box_setup_custom(combo, apps, sel)

Setups a combobox for selecting from a list of pre-defined applications. after set up, the combobox will contain a list of available applications the caller provides, and if `sel` if found in the list, it will be selected.

#### Parameters

combo | a GtkComboBox |
apps | custom GList of applications. | [element-type GAppInfo]
sel | a selected application in `apps` . | [allow-none]

Since: 0.1.5

### fm_app_chooser_combo_box_setup_for_mime_type()

    #define             fm_app_chooser_combo_box_setup_for_mime_type(combo, mime_type)

Setups a combobox for selecting default application for specified mime-type. after set up, the combobox will contain a list of available applications for this mime-type, and the default application of the mime-type will get selected.

#### Parameters

combo | a GtkComboBox |
mime_type | a FmMimeType to select application |

Since: 0.1.5