AppChooserButton

Object Hierarchy:

Description:

[ CCode ( type_id = "gtk_app_chooser_button_get_type ()" ) ]
[ Version ( deprecated = true , deprecated_since = "4.10" ) ]
public sealed class AppChooserButton : Widget, Accessible, AppChooser, Buildable, ConstraintTarget

Warning: AppChooserButton is deprecated since 4.10.

The `GtkAppChooserButton` lets the user select an application.

Note:

The application selection widgets should be implemented according to the design of each platform and/or application requiring them.

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

get_content_type

refresh

All known members inherited from interface Gtk.Buildable