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