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 char *	gtk_app_chooser_widget_get_default_text ()

Properties

char *	default-text	Read / Write
gboolean	show-all	Read / Write / Construct
gboolean	show-default	Read / Write / Construct
gboolean	show-fallback	Read / Write / Construct
gboolean	show-other	Read / Write / Construct
gboolean	show-recommended	Read / Write / Construct

Signals

void	application-activated	Run First
void	application-selected	Run First

Types and Values

GtkAppChooserWidget

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkAppChooserWidget

Implemented Interfaces

GtkAppChooserWidget implements GtkAccessible, GtkBuildable, GtkConstraintTarget and GtkAppChooser.

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

GtkWidget *
gtk_app_chooser_widget_new (const char *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

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”

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”

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”

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”

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”

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”

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”

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”

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”

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”

void
gtk_app_chooser_widget_set_default_text
                               (GtkAppChooserWidget *self,
                                const char *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”

const char *
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”.

[nullable]

Types and Values

GtkAppChooserWidget

typedef struct _GtkAppChooserWidget GtkAppChooserWidget;

Property Details

The `“default-text”` property

  “default-text”             char *

The “default-text” property determines the text that appears in the widget when there are no applications for the given content type. See also gtk_app_chooser_widget_set_default_text().

Owner: GtkAppChooserWidget

Flags: Read / Write

Default value: NULL

The `“show-all”` property

  “show-all”                 gboolean

If the “show-all” property is TRUE, the app chooser presents all applications in a single list, without subsections for default, recommended or related applications.

Owner: GtkAppChooserWidget