Class app-chooser-widget - cl-cffi-gtk4 API documentation

Package: gtk

Class gtk:app-chooser-widget

Superclasses

gtk:widget, gobject:initially-unowned, gtk:accessible, gtk:buildable, gtk:constraint-target, gtk:app-chooser, gobject:object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

None

Direct Slots

The default-text property of type :string (Read / Write)
Determines the text that appears in the widget when there are no applications for the given content type.
Default value: nil

The show-all property of type :boolean (Read / Write / Construct)
If true, the application chooser presents all applications in a single list, without subsections for default, recommended or related applications.
Default value: false

The show-default property of type :boolean (Read / Write / Construct)
Determines whether the application chooser should show the default handler for the content type in a separate section. If false, the default handler is listed among the recommended applications.
Default value: false

The show-fallback property of type :boolean (Read / Write / Construct)
Determines whether the application chooser should show a section for fallback applications. If false, the fallback applications are listed among the other applications.
Default value: false

The show-other property of type :boolean (Read / Write / Construct)
Determines whether the application chooser should show a section for other applications.
Default value: false

The show-recommended property of type :boolean (Read / Write / Construct)
Determines whether the application chooser should show a section for recommended applications. If false, the recommended applications are listed among the other applications.
Default value: true

Details

The gtk:app-chooser-widget widget is a widget for selecting applications. It is the main building block for the gtk:app-chooser-dialog widget. 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.

The gtk:app-chooser-widget widget offers detailed control over what applications are shown, using the show-default, show-recommended, show-fallback, show-other and show-all properties. See the gtk:app-chooser documentation for more information about these groups of applications.

To keep track of the selected application, use the "application-selected" and "application-activated" signals.

CSS nodes

The gtk:app-chooser-widget implementation has a single CSS node with name appchooser.

Warning

The gtk:app-chooser-widget implementation is deprecated since 4.10. The application selection widgets should be implemented according to the design of each platform and/or application requiring them.

Signal Details

The "application-activated" signal

lambda (widget application)    :run-first

widget: The gtk:app-chooser-widget widget which received the signal.
application: The activated g:app-info object.

Emitted when an application item is activated from the list of the widget. This usually happens when the user double clicks an item, or an item is selected and the user presses one of the Space, Shift+Space, Return or Enter keys.

The "application-selected" signal

lambda (widget application)    :run-first

widget: The gtk:app-chooser-widget widget which received the signal.
application: The selected g:app-info object.

Emitted when an application item is selected from the widget's list.

Returned by

gtk:app-chooser-widget-new

Slot Access Functions

gtk:app-chooser-widget-default-text

gtk:app-chooser-widget-show-all

gtk:app-chooser-widget-show-default

gtk:app-chooser-widget-show-fallback

gtk:app-chooser-widget-show-other

gtk:app-chooser-widget-show-recommended