AppChooserButton

Object Hierarchy:

Description:

[ CCode ( type_id = "gtk_app_chooser_button_get_type ()" ) ]
public class AppChooserButton : Widget, Accessible, AppChooser, Buildable, ConstraintTarget

The AppChooserButton is a widget that lets the user select an application.

It implements the AppChooser interface.

Initially, a AppChooserButton selects the first application in its list, which will either be the most-recently used application or, if show_default_item is true, the default application.

The list of applications shown in a AppChooserButton includes the recommended applications for the given content type. When show_default_item is set, the default application is also included. To let the user chooser other applications, you can set the show_dialog_item property, which allows to open a full AppChooserDialog.

It is possible to add custom items to the list, using append_custom_item. These items cause the custom_item_activated signal to be emitted when they are selected.

To track changes in the selected application, use the changed signal.

CSS nodes

GtkAppChooserButton has a single CSS node with the name “appchooserbutton”.

Namespace: Gtk

Package: gtk4

Content:

Properties:

public string heading { get; set; }
The text to show at the top of the dialog that can be opened from the button.
public bool modal { get; set construct; }
public bool show_default_item { get; set construct; }
The show_default_item property determines whether the dropdown menu should show the default application on top for the provided content type.
public bool show_dialog_item { get; set construct; }
The show_dialog_item property determines whether the dropdown menu should show an item that triggers a AppChooserDialog when clicked.

Creation methods:

public AppChooserButton (string content_type)
Creates a new AppChooserButton for applications that can handle content of the given type.

Methods:

public void append_custom_item (string name, string label, Icon icon)
Appends a custom item to the list of applications that is shown in the popup; the item name must be unique per-widget.
public void append_separator ()
Appends a separator to the list of applications that is shown in the popup.
public unowned string? get_heading ()
Returns the text to display at the top of the dialog.
public bool get_modal ()
Gets whether the dialog is modal.
public bool get_show_default_item ()
Returns the current value of the show_default_item property.
public bool get_show_dialog_item ()
Returns the current value of the show_dialog_item property.
public void set_active_custom_item (string name)
Selects a custom item previously added with append_custom_item.
public void set_heading (string heading)
Sets the text to display at the top of the dialog.
public void set_modal (bool modal)
Sets whether the dialog should be modal.
public void set_show_default_item (bool setting)
Sets whether the dropdown menu of this button should show the default application for the given content type at top.
public void set_show_dialog_item (bool setting)
Sets whether the dropdown menu of this button should show an entry to trigger a AppChooserDialog.

Signals:

public signal void changed ()
Emitted when the active application on the AppChooserButton changes.
public signal void custom_item_activated (string item_name)
Emitted when a custom item, previously added with append_custom_item, is activated from the dropdown menu.

Inherited Members:

All known members inherited from class Gtk.Widget

All known members inherited from class GLib.Object

All known members inherited from interface Gtk.Accessible

All known members inherited from interface Gtk.AppChooser

get_content_type

refresh

All known members inherited from interface Gtk.Buildable