GtkAppChooserWidget: GTK+ 4 Reference Manual

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

## Functions

GtkWidget * | gtk_app_chooser_widget_new ()
void | gtk_app_chooser_widget_set_show_default ()
gboolean | gtk_app_chooser_widget_get_show_default ()
void | gtk_app_chooser_widget_set_show_recommended ()
gboolean | gtk_app_chooser_widget_get_show_recommended ()
void | gtk_app_chooser_widget_set_show_fallback ()
gboolean | gtk_app_chooser_widget_get_show_fallback ()
void | gtk_app_chooser_widget_set_show_other ()
gboolean | gtk_app_chooser_widget_get_show_other ()
void | gtk_app_chooser_widget_set_show_all ()
gboolean | gtk_app_chooser_widget_get_show_all ()
void | gtk_app_chooser_widget_set_default_text ()
const gchar * | gtk_app_chooser_widget_get_default_text ()

## Types and Values

struct | GtkAppChooserWidget
struct | GtkAppChooserWidgetClass

## 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

self | a GtkAppChooserWidget |

#### 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

self | a GtkAppChooserWidget |

#### 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

self | a GtkAppChooserWidget |

#### 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

self | a GtkAppChooserWidget |

#### 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

self | a GtkAppChooserWidget |

#### 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

self | a GtkAppChooserWidget |

#### 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. |