AppChooserWidget#

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

class AppChooserWidget(**properties: Any)#

Superclasses: Widget, InitiallyUnowned, Object

Implemented Interfaces: Accessible, AppChooser, Buildable, ConstraintTarget

GtkAppChooserWidget is a widget for selecting applications.

It is the main building block for 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 show_default, show_recommended, show_fallback, show_other and show_all properties. See the AppChooser 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#

GtkAppChooserWidget has a single CSS node with name appchooser.

Constructors#

class AppChooserWidget

classmethod new(content_type: str) → Widget#

Creates a new GtkAppChooserWidget for applications that can handle content of the given type.

Deprecated since version 4.10: This widget will be removed in GTK 5

Parameters:: content_type – the content type to show applications for

Methods#

class AppChooserWidget

get_default_text() → str | None#: Returns the text that is shown if there are not applications that can handle the content type.

Deprecated since version 4.10: This widget will be removed in GTK 5

get_show_all() → bool#: Gets whether the app chooser should show all applications in a flat list.

Deprecated since version 4.10: This widget will be removed in GTK 5

get_show_default() → bool#: Gets whether the app chooser should show the default handler for the content type in a separate section.

Deprecated since version 4.10: This widget will be removed in GTK 5

get_show_fallback() → bool#: Gets whether the app chooser should show related applications for the content type in a separate section.

Deprecated since version 4.10: This widget will be removed in GTK 5

get_show_other() → bool#: Gets whether the app chooser should show applications which are unrelated to the content type.

Deprecated since version 4.10: This widget will be removed in GTK 5

get_show_recommended() → bool#: Gets whether the app chooser should show recommended applications for the content type in a separate section.

Deprecated since version 4.10: This widget will be removed in GTK 5

set_default_text(text: str) → None#

Sets the text that is shown if there are not applications that can handle the content type.

Deprecated since version 4.10: This widget will be removed in GTK 5

Parameters:: text – the new value for default_text

set_show_all(setting: bool) → None#

Sets whether the app chooser should show all applications in a flat list.

Deprecated since version 4.10: This widget will be removed in GTK 5

Parameters:: setting – the new value for show_all

set_show_default(setting: bool) → None#

Sets whether the app chooser should show the default handler for the content type in a separate section.

Deprecated since version 4.10: This widget will be removed in GTK 5

Parameters:: setting – the new value for show_default

set_show_fallback(setting: bool) → None#

Sets whether the app chooser should show related applications for the content type in a separate section.

Deprecated since version 4.10: This widget will be removed in GTK 5

Parameters:: setting – the new value for show_fallback

set_show_other(setting: bool) → None#

Sets whether the app chooser should show applications which are unrelated to the content type.

Deprecated since version 4.10: This widget will be removed in GTK 5

Parameters:: setting – the new value for show_other

set_show_recommended(setting: bool) → None#

Sets whether the app chooser should show recommended applications for the content type in a separate section.

Deprecated since version 4.10: This widget will be removed in GTK 5

Parameters:: setting – the new value for show_recommended

Properties#

class AppChooserWidget

props.default_text: str#: The text that appears in the widget when there are no applications for the given content type.

props.show_all: bool#: If True, the app chooser presents all applications in a single list, without subsections for default, recommended or related applications.

props.show_default: bool#

Determines whether the app 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.

props.show_fallback: bool#

Determines whether the app chooser should show a section for fallback applications.

If False, the fallback applications are listed among the other applications.

props.show_other: bool#: Determines whether the app chooser should show a section for other applications.

props.show_recommended: bool#

Determines whether the app chooser should show a section for recommended applications.

If False, the recommended applications are listed among the other applications.

Signals#

class AppChooserWidget.signals

application_activated(application: AppInfo) → None#

Emitted when an application item is activated from the widget’s list.

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

Parameters:: application – the activated GAppInfo

application_selected(application: AppInfo) → None#

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

Parameters:: application – the selected GAppInfo