## GtkAppChooser

GtkAppChooser — Interface implemented by widgets for choosing an application

## Synopsis

    #include <gtk/gtk.h>

                        GtkAppChooser;
    GAppInfo *          gtk_app_chooser_get_app_info        (GtkAppChooser *self);
    gchar *             gtk_app_chooser_get_content_type    (GtkAppChooser *self);
    void                gtk_app_chooser_refresh             (GtkAppChooser *self);

## Object Hierarchy

      GInterface
       +----GtkAppChooser

## Prerequisites

GtkAppChooser requires GtkWidget.

## Known Implementations

GtkAppChooser is implemented by GtkAppChooserButton, GtkAppChooserDialog and GtkAppChooserWidget.

## Properties

      "content-type"             gchar*                : Read / Write / Construct Only

## Description

GtkAppChooser is an interface that can be implemented by widgets which allow the user to choose an application (typically for the purpose of opening a file). The main objects that implement this interface are GtkAppChooserWidget, GtkAppChooserDialog and GtkAppChooserButton.

Applications are represented by GIO GAppInfo objects here. GIO has a concept of recommended and fallback applications for a given content type. Recommended applications are those that claim to handle the content type itself, while fallback also includes applications that handle a more generic content type. GIO also knows the default and last-used application for a given content type. The GtkAppChooserWidget provides detailed control over whether the shown list of applications should include default, recommended or fallback applications.

To obtain the application that has been selected in a GtkAppChooser, use `gtk_app_chooser_get_app_info()`.

## Details

### GtkAppChooser

    typedef struct _GtkAppChooser GtkAppChooser;

### gtk_app_chooser_get_app_info ()

    GAppInfo *          gtk_app_chooser_get_app_info        (GtkAppChooser *self);

Returns the currently selected application.

`self` : | a GtkAppChooser
Returns : | a GAppInfo for the currently selected application, or `NULL` if none is selected. Free with `g_object_unref()`. [transfer full]

Since 3.0

### gtk_app_chooser_get_content_type ()

    gchar *             gtk_app_chooser_get_content_type    (GtkAppChooser *self);

Returns the current value of the "content-type" property.

`self` : | a GtkAppChooser
Returns : | the content type of `self`. Free with `g_free()`

Since 3.0

### gtk_app_chooser_refresh ()

    void                gtk_app_chooser_refresh             (GtkAppChooser *self);

Reloads the list of applications.

`self` : | a GtkAppChooser

Since 3.0

## Property Details

### The `"content-type"` property

      "content-type"             gchar*                : Read / Write / Construct Only

The content type of the GtkAppChooser object.

See GContentType for more information about content types.

Default value: NULL

## See Also

GAppInfo