Object Hierarchy:

Description:

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

`GtkAppChooserWidget` is a widget for selecting applications.

It is the main building block for [[email protected]]. 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 [[email protected]:show-default], [ [email protected]:show-recommended], [[email protected]:show-fallback], [[email protected]:show-other] and [[email protected]:show-all] properties. See the [[email protected]] documentation for more information about these groups of applications.

To keep track of the selected application, use the [[email protected]:GtkAppChooserWidget:application-selected] and [[email protected]: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 GLib.Object

@get
@new
@ref
@set
add_toggle_ref
add_weak_pointer
bind_property
connect
constructed
disconnect
dispose
dup_data
dup_qdata
force_floating
freeze_notify
get_class
get_data

get_property
get_qdata
get_type
getv
interface_find_property
interface_install_property
interface_list_properties
is_floating
new_valist
new_with_properties
newv
notify
notify_property
ref_count
ref_sink
remove_toggle_ref
remove_weak_pointer

replace_data
replace_qdata
set_data
set_data_full
set_property
set_qdata
set_qdata_full
set_valist
setv
steal_data
steal_qdata
thaw_notify
unref
watch_closure
weak_ref
weak_unref