gtk.app_chooser_widget

Module for [AppChooserWidget] class

class AppChooserWidget AppChooserWidgetGidBuilder AppChooserWidgetGidBuilderImpl

Types 3

classAppChooserWidget : gtk.widget.Widget, gtk.app_chooser.AppChooser

[gtk.app_chooser_widget.AppChooserWidget] is a widget for selecting applications.

It is the main building block for [gtk.app_chooser_dialog.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.

[gtk.app_chooser_widget.AppChooserWidget] 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 [gtk.app_chooser.AppChooser] documentation for more information about these groups of applications.

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

CSS nodes

[gtk.app_chooser_widget.AppChooserWidget] has a single CSS node with name appchooser.

Deprecated

The application selection widgets should be

implemented according to the design of each platform and/or application requiring them.

Methods

GType _getGType()

GType _gType() @property

AppChooserWidget self()Returns `this`, for use in `with` statements.

AppChooserWidgetGidBuilder builder()Get builder for [gtk.appchooserwidget.AppChooserWidget] Returns: New builder object

string defaultText() @propertyGet `defaultText` property. Returns: The text that appears in the widget when there are no applications for the given content type.

void defaultText(string propval) @propertySet `defaultText` property. Params: propval = The text that appears in the widget when there are no applications for the given content type.

bool showAll() @propertyGet `showAll` property. Returns: If true, the app chooser presents all applications in a single list, without subsections for default, recommended or related applications.

void showAll(bool propval) @propertySet `showAll` property. Params: propval = If true, the app chooser presents all applications in a single list, without subsections for default, recommended or related applications.

bool showDefault() @propertyGet `showDefault` property. Returns: Determines whether the app chooser should show the default handler for the content type in a separate section.

void showDefault(bool propval) @propertySet `showDefault` property. Params: propval = Determines whether the app chooser should show the default handler for the content type in a separate section.

bool showFallback() @propertyGet `showFallback` property. Returns: Determines whether the app chooser should show a section for fallback applications.

void showFallback(bool propval) @propertySet `showFallback` property. Params: propval = Determines whether the app chooser should show a section for fallback applications.

bool showOther() @propertyGet `showOther` property. Returns: Determines whether the app chooser should show a section for other applications.

void showOther(bool propval) @propertySet `showOther` property. Params: propval = Determines whether the app chooser should show a section for other applications.

bool showRecommended() @propertyGet `showRecommended` property. Returns: Determines whether the app chooser should show a section for recommended applications.

void showRecommended(bool propval) @propertySet `showRecommended` property. Params: propval = Determines whether the app chooser should show a section for recommended applications.

string getDefaultText()Returns the text that is shown if there are not applications that can handle the content type. Returns: the value of `propertyGtk.AppChooserWidget:default-text`

bool getShowAll()Gets whether the app chooser should show all applications in a flat list. Returns: the value of `propertyGtk.AppChooserWidget:show-all`

bool getShowDefault()Gets whether the app chooser should show the default handler for the content type in a separate section. Returns: the value of `propertyGtk.AppChooserWidget:show-default`

bool getShowFallback()Gets whether the app chooser should show related applications for the content type in a separate section. Returns: the value of `propertyGtk.AppChooserWidget:show-fallback`

bool getShowOther()Gets whether the app chooser should show applications which are unrelated to the content type. Returns: the value of `propertyGtk.AppChooserWidget:show-other`

bool getShowRecommended()Gets whether the app chooser should show recommended applications for the content type in a separate section. Returns: the value of `propertyGtk.AppChooserWidget:show-recommended`

void setDefaultText(string text)Sets the text that is shown if there are not applications that can handle the content type.

void setShowAll(bool setting)Sets whether the app chooser should show all applications in a flat list.

void setShowDefault(bool setting)Sets whether the app chooser should show the default handler for the content type in a separate section.

void setShowFallback(bool setting)Sets whether the app chooser should show related applications for the content type in a separate section.

void setShowOther(bool setting)Sets whether the app chooser should show applications which are unrelated to the content type.

void setShowRecommended(bool setting)Sets whether the app chooser should show recommended applications for the content type in a separate section.

gulong connectApplicationActivated(T)(T callback,  Flag!"After" after =  No.After) if (isCallable!T
    &&  is(ReturnType!T ==  void)
   && (Parameters!T.length <  1 || (ParameterStorageClassTuple!T[0]  ==  ParameterStorageClass.none &&  is(Parameters!T[0] :  gio.app_info.AppInfo)))
   && (Parameters!T.length <  2 || (ParameterStorageClassTuple!T[1]  ==  ParameterStorageClass.none &&  is(Parameters!T[1] :  gtk.app_chooser_widget.AppChooserWidget)))
   &&  Parameters!T.length <  3)

Connect to `ApplicationActivated` signal.

gulong connectApplicationSelected(T)(T callback,  Flag!"After" after =  No.After) if (isCallable!T
    &&  is(ReturnType!T ==  void)
   && (Parameters!T.length <  1 || (ParameterStorageClassTuple!T[0]  ==  ParameterStorageClass.none &&  is(Parameters!T[0] :  gio.app_info.AppInfo)))
   && (Parameters!T.length <  2 || (ParameterStorageClassTuple!T[1]  ==  ParameterStorageClass.none &&  is(Parameters!T[1] :  gtk.app_chooser_widget.AppChooserWidget)))
   &&  Parameters!T.length <  3)

Connect to `ApplicationSelected` signal.

Constructors

this(void * ptr, Flag!"Take" take)

this(string contentType)Creates a new [gtk.appchooserwidget.AppChooserWidget] for applications that can handle content of the given type.

classAppChooserWidgetGidBuilderImpl(T) : gtk.widget.WidgetGidBuilderImpl!T, gtk.app_chooser.AppChooserGidBuilderImpl!T

Methods

T defaultText(string propval)Set `defaultText` property. Params: propval = The text that appears in the widget when there are no applications for the given content type. Returns: Builder instance for fluent chaining

T showAll(bool propval)Set `showAll` property. Params: propval = If true, the app chooser presents all applications in a single list, without subsections for default, recommended or related applications. Returns: Builder...

T showDefault(bool propval)Set `showDefault` property. Params: propval = Determines whether the app chooser should show the default handler for the content type in a separate section.

T showFallback(bool propval)Set `showFallback` property. Params: propval = Determines whether the app chooser should show a section for fallback applications.

T showOther(bool propval)Set `showOther` property. Params: propval = Determines whether the app chooser should show a section for other applications. Returns: Builder instance for fluent chaining

T showRecommended(bool propval)Set `showRecommended` property. Params: propval = Determines whether the app chooser should show a section for recommended applications.

classAppChooserWidgetGidBuilder : AppChooserWidgetGidBuilderImpl!AppChooserWidgetGidBuilder

Fluent builder for [gtk.app_chooser_widget.AppChooserWidget]

Methods

AppChooserWidget build()