AppChooserButton

Object Hierarchy:

Description:

public class Application : Gtk.Window {
	public Application () {
		// Prepare Gtk.Window:
		this.title = "My Gtk.AppChooserButton";
		this.window_position = Gtk.WindowPosition.CENTER;
		this.destroy.connect (Gtk.main_quit);

		// The button:
		Gtk.AppChooserButton button = new Gtk.AppChooserButton ("image/png");
		this.add (button);

		// Add a separator line:
		button.append_separator ();

		// Add a custom entry:
		ThemedIcon themed_icon = new ThemedIcon ("folder-new");
		button.append_custom_item ("my-image-viewer", "My image Viewer", themed_icon);

		// Catch custom selections:
		button.custom_item_activated.connect ((item_name) => {
			print ("%s\n", item_name);
		});

		// Catch all selections:
		button.changed.connect (() => {
			AppInfo info = button.get_app_info ();
			if (info != null) {
				print ("Selection:\n");
				print (" Name: %s\n", info.get_display_name ());
				print (" Desc: %s\n", info.get_description ());
			}
		});
	}

	public static int main (string[] args) {
		Gtk.init (ref args);

		Application app = new Application ();
		app.show_all ();
		Gtk.main ();
		return 0;
	}
}

valac --pkg gtk+-3.0 Gtk.AppChooserButton.vala

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; }
  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_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_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 virtual 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: