GtkAppChooserWidget

GtkAppChooserWidget — Application chooser widget that can be embedded in other widgets

Functions

Types and Values

Includes

#include <gtk/gtk.h>

Description

GtkAppChooserWidget is a widget for selecting applications. It is the main building block for GtkAppChooserDialog. Most applications only need to use the latter; but you can use this widget as part of a larger widget if you have special needs.

GtkAppChooserWidget offers detailed control over what applications are shown, using the “show-default”, “show-recommended”, “show-fallback”, “show-other” and “show-all” properties. See the GtkAppChooser documentation for more information about these groups of applications.

To keep track of the selected application, use the “application-selected” and “application-activated” signals.

CSS nodes

GtkAppChooserWidget has a single CSS node with name appchooser.

Functions

gtk_app_chooser_widget_new ()

GtkWidget *
gtk_app_chooser_widget_new (const gchar *content_type);

Creates a new GtkAppChooserWidget for applications that can handle content of the given type.

Parameters

content_type

the content type to show applications for

 

Returns

a newly created GtkAppChooserWidget

Since: 3.0


gtk_app_chooser_widget_set_show_default ()

void
gtk_app_chooser_widget_set_show_default
                               (GtkAppChooserWidget *self,
                                gboolean setting);

Sets whether the app chooser should show the default handler for the content type in a separate section.

Parameters

self

a GtkAppChooserWidget

 

setting

the new value for “show-default”

 

Since: 3.0


gtk_app_chooser_widget_get_show_default ()

gboolean
gtk_app_chooser_widget_get_show_default
                               (GtkAppChooserWidget *self);

Returns the current value of the “show-default” property.

Parameters

Returns

the value of “show-default”

Since: 3.0


gtk_app_chooser_widget_set_show_recommended ()

void
gtk_app_chooser_widget_set_show_recommended
                               (GtkAppChooserWidget *self,
                                gboolean setting);

Sets whether the app chooser should show recommended applications for the content type in a separate section.

Parameters

self

a GtkAppChooserWidget

 

setting

the new value for “show-recommended”

 

Since: 3.0


gtk_app_chooser_widget_get_show_recommended ()

gboolean
gtk_app_chooser_widget_get_show_recommended
                               (GtkAppChooserWidget *self);

Returns the current value of the “show-recommended” property.

Parameters

Returns

the value of “show-recommended”

Since: 3.0


gtk_app_chooser_widget_set_show_fallback ()

void
gtk_app_chooser_widget_set_show_fallback
                               (GtkAppChooserWidget *self,
                                gboolean setting);

Sets whether the app chooser should show related applications for the content type in a separate section.

Parameters

self

a GtkAppChooserWidget

 

setting

the new value for “show-fallback”

 

Since: 3.0


gtk_app_chooser_widget_get_show_fallback ()

gboolean
gtk_app_chooser_widget_get_show_fallback
                               (GtkAppChooserWidget *self);

Returns the current value of the “show-fallback” property.

Parameters

Returns

the value of “show-fallback”

Since: 3.0


gtk_app_chooser_widget_set_show_other ()

void
gtk_app_chooser_widget_set_show_other (GtkAppChooserWidget *self,
                                       gboolean setting);

Sets whether the app chooser should show applications which are unrelated to the content type.

Parameters

self

a GtkAppChooserWidget

 

setting

the new value for “show-other”

 

Since: 3.0


gtk_app_chooser_widget_get_show_other ()

gboolean
gtk_app_chooser_widget_get_show_other (GtkAppChooserWidget *self);

Returns the current value of the “show-other” property.

Parameters

Returns

the value of “show-other”

Since: 3.0


gtk_app_chooser_widget_set_show_all ()

void
gtk_app_chooser_widget_set_show_all (GtkAppChooserWidget *self,
                                     gboolean setting);

Sets whether the app chooser should show all applications in a flat list.

Parameters

self

a GtkAppChooserWidget

 

setting

the new value for “show-all”

 

Since: 3.0


gtk_app_chooser_widget_get_show_all ()

gboolean
gtk_app_chooser_widget_get_show_all (GtkAppChooserWidget *self);

Returns the current value of the “show-all” property.

Parameters

Returns

the value of “show-all”

Since: 3.0


gtk_app_chooser_widget_set_default_text ()

void
gtk_app_chooser_widget_set_default_text
                               (GtkAppChooserWidget *self,
                                const gchar *text);

Sets the text that is shown if there are not applications that can handle the content type.

Parameters

self

a GtkAppChooserWidget

 

text

the new value for “default-text”

 

gtk_app_chooser_widget_get_default_text ()

const gchar *
gtk_app_chooser_widget_get_default_text
                               (GtkAppChooserWidget *self);

Returns the text that is shown if there are not applications that can handle the content type.

Parameters

Returns

the value of “default-text”

Since: 3.0

Types and Values

struct GtkAppChooserWidget

struct GtkAppChooserWidget {
  GtkWidget parent_instance;
};

struct GtkAppChooserWidgetClass

struct GtkAppChooserWidgetClass {
  GtkWidgetClass parent_class;


  void (* application_selected)  (GtkAppChooserWidget *self,
                                  GAppInfo            *app_info);

  void (* application_activated) (GtkAppChooserWidget *self,
                                  GAppInfo            *app_info);

  void (* populate_popup)        (GtkAppChooserWidget *self,
                                  GtkMenu             *menu,
                                  GAppInfo            *app_info);
};

Members

application_selected ()

Signal emitted when an application item is selected from the widget’s list.

 

application_activated ()

Signal emitted when an application item is activated from the widget’s list.

 

populate_popup ()

Signal emitted when a context menu is about to popup over an application item.