struct GtkAppChooserButton

struct GtkAppChooserButton;

gtk_app_chooser_button_new ()

GtkWidget *         gtk_app_chooser_button_new          (const gchar *content_type);

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

Since 3.0

gtk_app_chooser_button_append_custom_item ()

void                gtk_app_chooser_button_append_custom_item
                                                        (GtkAppChooserButton *self,
                                                         const gchar *name,
                                                         const gchar *label,
                                                         GIcon *icon);

Appends a custom item to the list of applications that is shown in the popup; the item name must be unique per-widget. Clients can use the provided name as a detail for the ::custom-item-activated signal, to add a callback for the activation of a particular custom item in the list. See also gtk_app_chooser_button_append_separator().

Since 3.0

gtk_app_chooser_button_append_separator ()

void                gtk_app_chooser_button_append_separator
                                                        (GtkAppChooserButton *self);

Appends a separator to the list of applications that is shown in the popup.

Since 3.0

gtk_app_chooser_button_set_active_custom_item ()

void                gtk_app_chooser_button_set_active_custom_item
                                                        (GtkAppChooserButton *self,
                                                         const gchar *name);

Selects a custom item previously added with gtk_app_chooser_button_append_custom_item().

Use gtk_app_chooser_refresh() to bring the selection to its initial state.

Since 3.0

gtk_app_chooser_button_get_show_dialog_item ()

gboolean            gtk_app_chooser_button_get_show_dialog_item
                                                        (GtkAppChooserButton *self);

Returns the current value of the "show-dialog-item" property.

Since 3.0

gtk_app_chooser_button_set_show_dialog_item ()

void                gtk_app_chooser_button_set_show_dialog_item
                                                        (GtkAppChooserButton *self,
                                                         gboolean setting);

Sets whether the dropdown menu of this button should show an entry to trigger a GtkAppChooserDialog.

Since 3.0

gtk_app_chooser_button_get_heading ()

const gchar *       gtk_app_chooser_button_get_heading  (GtkAppChooserButton *self);

Returns the text to display at the top of the dialog.

gtk_app_chooser_button_set_heading ()

void                gtk_app_chooser_button_set_heading  (GtkAppChooserButton *self,
                                                         const gchar *heading);

Sets the text to display at the top of the dialog. If the heading is not set, the dialog displays a default text.

The "heading" property

  "heading"                  gchar*                : Read / Write

The text to show at the top of the dialog that can be opened from the button. The string may contain Pango markup.

Default value: NULL

The "show-dialog-item" property

  "show-dialog-item"         gboolean              : Read / Write / Construct

The "show-dialog-item" property determines whether the dropdown menu should show an item that triggers a GtkAppChooserDialog when clicked.

Default value: FALSE

The "custom-item-activated" signal

void                user_function                      (GtkAppChooserButton *self,
                                                        gchar               *item_name,
                                                        gpointer             user_data)      : Has Details

Emitted when a custom item, previously added with gtk_app_chooser_button_append_custom_item(), is activated from the dropdown menu.