Gtk.AppChooserButton – gtk+-3.0 – Vala Binding Reference

Description:

[ CCode ( type_id = "gtk_app_chooser_button_get_type ()" ) ]
public class AppChooserButton : ComboBox, Implementor, AppChooser, Buildable, CellEditable, CellLayout

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: gtk+-3.0

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 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_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_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 virtual signal void custom_item_activated (string item_name)

Emitted when a custom item is activated.

Inherited Members:

All known members inherited from class Gtk.Bin

get_child

All known members inherited from interface Atk.Implementor

ref_accessible

AppChooserButton

Object Hierarchy: