AppChooserButton

Object Hierarchy:

Object hierarchy for AppChooserButton

Description:

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

The `GtkAppChooserButton` lets the user select an application.

![An example GtkAppChooserButton](appchooserbutton.png)

Initially, a `GtkAppChooserButton` selects the first application in its list, which will either be the most-recently used application or, if [ property@Gtk.AppChooserButton:show-default-item] is true, the default application.

The list of applications shown in a `GtkAppChooserButton` includes the recommended applications for the given content type. When [ property@Gtk.AppChooserButton:show-default-item] is set, the default application is also included. To let the user chooser other applications, you can set the [property@Gtk.AppChooserButton:show-dialog-item] property, which allows to open a full [class@Gtk.AppChooserDialog].

It is possible to add custom items to the list, using [method@Gtk.AppChooserButton.append_custom_item]. These items cause the [ signal@Gtk.AppChooserButton:GtkAppChooserButton:custom-item-activated] signal to be emitted when they are selected.

To track changes in the selected application, use the [signal@Gtk.AppChooserButton:GtkAppChooserButton: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; }
    Whether the app chooser dialog should be modal.
  • public bool show_default_item { get; set construct; }
    Determines whether the dropdown menu shows the default application on top for the provided content type.
  • public bool show_dialog_item { get; set construct; }
    Determines whether the dropdown menu shows an item to open a `GtkAppChooserDialog`.

Creation methods:

  • public AppChooserButton (string content_type)
    Creates a new `GtkAppChooserButton` 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.
  • 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 whether the dropdown menu should show the default application at the top.
  • public bool get_show_dialog_item ()
    Returns whether the dropdown menu shows an item for a `GtkAppChooserDialog`.
  • public void set_active_custom_item (string name)
    Selects a 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 `GtkAppChooserDialog`.

Signals:

  • public signal void activate ()
    Emitted to when the button is activated.
  • public signal void changed ()
    Emitted when the active application changes.
  • public signal void custom_item_activated (string item_name)
    Emitted when a custom item is activated.

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
All known members inherited from interface Gtk.Buildable