### ----------------------------------------------------
### -- Gnome::Gtk3
### -- Licenses: Artistic-2.0
### -- Authors: Marcel Timmerman
### -- File: docs/content-docs/reference/Gtk3/AppChooser.md
### ----------------------------------------------------
Gnome::Gtk3::AppChooser
=======================

Interface implemented by widgets for choosing an application

Description
===========

**Gnome::Gtk3::AppChooser** 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 **Gnome::Gtk3::AppChooserWidget**, **Gnome::Gtk3::AppChooserDialog** and **Gnome::Gtk3::AppChooserButton**.

Applications are represented by **Gnome::Gio::AppInfo** 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 **Gnome::Gtk3::AppChooserWidget** 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 **Gnome::Gtk3::AppChooser**, use `get-app-info()`.

See Also
--------

**Gnome::Gio::AppInfo**

Synopsis
========

Declaration
-----------

    unit role Gnome::Gtk3::AppChooser;

Uml
---

![](plantuml/AppChooser.svg)

Methods
=======

get-app-info
------------

Returns the currently selected application.

Returns: a (native **Gnome::Gio::AppInfo** for the currently selected application, or `undefined` if none is selected. Free with `clear-object()`

    method get-app-info ( --> N-GObject )

get-content-type
----------------

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

    method get-content-type ( --> Str )

refresh
-------

Reloads the list of applications.

    method refresh ( )

Properties
==========

content-type
------------

The content type of the **Gnome::Gtk3::AppChooser** object.

The **Gnome::GObject::Value** type of property *content-type* is `G_TYPE_STRING`.

  * Parameter is set on construction of object.

  * Parameter is readable and writable.

  * Default value is undefined.



