AppChooserWidget

Object Hierarchy:

Description:

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

Warning: AppChooserWidget is deprecated since 4.10.

`GtkAppChooserWidget` is a widget for selecting applications.

Note:

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

It is the main building block for [class@Gtk.AppChooserDialog]. Most applications only need to use the latter; but you can use this widget as part of a larger widget if you have special needs.

`GtkAppChooserWidget` offers detailed control over what applications are shown, using the [property@Gtk.AppChooserWidget:show-default], [ property@Gtk.AppChooserWidget:show-recommended], [property@Gtk.AppChooserWidget:show-fallback], [property@Gtk.AppChooserWidget:show-other] and [ property@Gtk.AppChooserWidget:show-all] properties. See the [iface@Gtk.AppChooser] documentation for more information about these groups of applications.

To keep track of the selected application, use the [signal@Gtk.AppChooserWidget:GtkAppChooserWidget:application-selected] and [ signal@Gtk.AppChooserWidget:GtkAppChooserWidget:application-activated] signals.

CSS nodes

`GtkAppChooserWidget` has a single CSS node with name appchooser.

Namespace: Gtk

Package: gtk4

Content:

Properties:

public string default_text { get; set; }
The text that appears in the widget when there are no applications for the given content type.
public bool show_all { get; set construct; }
If true, the app chooser presents all applications in a single list, without subsections for default, recommended or related applications.
public bool show_default { get; set construct; }
Determines whether the app chooser should show the default handler for the content type in a separate section.
public bool show_fallback { get; set construct; }
Determines whether the app chooser should show a section for fallback applications.
public bool show_other { get; set construct; }
Determines whether the app chooser should show a section for other applications.
public bool show_recommended { get; set construct; }
Determines whether the app chooser should show a section for recommended applications.

Creation methods:

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

Methods:

public unowned string? get_default_text ()
Returns the text that is shown if there are not applications that can handle the content type.
public bool get_show_all ()
Gets whether the app chooser should show all applications in a flat list.
public bool get_show_default ()
Gets whether the app chooser should show the default handler for the content type in a separate section.
public bool get_show_fallback ()
Gets whether the app chooser should show related applications for the content type in a separate section.
public bool get_show_other ()
Gets whether the app chooser should show applications which are unrelated to the content type.
public bool get_show_recommended ()
Gets whether the app chooser should show recommended applications for the content type in a separate section.
public void set_default_text (string text)
Sets the text that is shown if there are not applications that can handle the content type.
public void set_show_all (bool setting)
Sets whether the app chooser should show all applications in a flat list.
public void set_show_default (bool setting)
Sets whether the app chooser should show the default handler for the content type in a separate section.
public void set_show_fallback (bool setting)
Sets whether the app chooser should show related applications for the content type in a separate section.
public void set_show_other (bool setting)
Sets whether the app chooser should show applications which are unrelated to the content type.
public void set_show_recommended (bool setting)
Sets whether the app chooser should show recommended applications for the content type in a separate section.

Signals:

public signal void application_activated (AppInfo application)
Emitted when an application item is activated from the widget's list.
public signal void application_selected (AppInfo application)
Emitted when an application item is selected from the widget's list.

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