:right-sidebar: True

AppChooser
===================================================================

.. currentmodule:: gi.repository.Gtk





.. deprecated:: 4.10

   The application selection widgets should be
     implemented according to the design of each platform and/or
     application requiring them.


.. class:: AppChooser(*args, **kwargs)
   :no-contents-entry:





Implementations: :class:`~gi.repository.Gtk.AppChooserButton`, :class:`~gi.repository.Gtk.AppChooserDialog`, :class:`~gi.repository.Gtk.AppChooserWidget`


``GtkAppChooser`` is an interface for widgets which allow the user to
choose an application.

The main objects that implement this interface are
:obj:`~gi.repository.Gtk.AppChooserWidget`\,
:obj:`~gi.repository.Gtk.AppChooserDialog` and :obj:`~gi.repository.Gtk.AppChooserButton`\.

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 :obj:`~gi.repository.Gtk.AppChooser.get_app_info`\.




Methods
-------

.. rst-class:: interim-class

.. class:: AppChooser
   :no-index:


   .. method:: get_app_info() -> ~gi.repository.Gio.AppInfo | None

      Returns the currently selected application.





      .. deprecated:: 4.10

         This widget will be removed in GTK 5






   .. method:: get_content_type() -> str

      Returns the content type for which the ``GtkAppChooser``
      shows applications.





      .. deprecated:: 4.10

         This widget will be removed in GTK 5






   .. method:: refresh() -> None

      Reloads the list of applications.





      .. deprecated:: 4.10

         This widget will be removed in GTK 5










Properties
----------

.. rst-class:: interim-class

.. class:: AppChooser
   :no-index:
   

   .. attribute:: props.content_type
      :type: str

      The type of the None singleton.