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

Package: gtk

Class gtk:app-chooser-widget

Superclasses

gtk:box, gtk:container, gtk:widget, gtk:buildable, gtk:orientable, 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)
The default-text property determines the text that appears in the widget when there are no applications for the given content type. See also the gtk:app-chooser-widget-default-text function.
Default value: nil

The show-all property of type :boolean (Read / Write / Construct)
If the show-all property is 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)
The show-default property 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)
The show-fallback property 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)
The show-other property 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)
The show-recommended property 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.

Signal Details

The "application-activated" signal

lambda (widget application)    :run-first

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.

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

The "application-selected" signal

lambda (widget application)    :run-first

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

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

The "populate-popup" signal

lambda (widget menu application)    :run-first

Emitted when a context menu is about to popup over an application item. Clients can insert menu items into the provided gtk:menu object in the callback of this signal. The context menu will be shown over the item if at least one item has been added to the menu.

widget: The gtk:app-chooser-widget widget which received the signal.
menu: The gtk:menu object to populate.
application: The current g:app-info object.

#2023-2-15