Struct gtk4::AppChooserWidget[][src]

pub struct AppChooserWidget(_);
Expand description

AppChooserWidget 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.

AppChooserWidget offers detailed control over what applications are shown, using the property::AppChooserWidget::show-default, property::AppChooserWidget::show-recommended, property::AppChooserWidget::show-fallback, property::AppChooserWidget::show-other and property::AppChooserWidget::show-all properties. See the AppChooser documentation for more information about these groups of applications.

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

CSS nodes

AppChooserWidget has a single CSS node with name appchooser.

Implements

WidgetExt, glib::ObjectExt, AccessibleExt, BuildableExt, ConstraintTargetExt, AppChooserExt, WidgetExtManual, AccessibleExtManual

Implementations

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

content_type

the content type to show applications for

Returns

a newly created AppChooserWidget

Creates a new builder-pattern struct instance to construct AppChooserWidget objects.

This method returns an instance of AppChooserWidgetBuilder which can be used to create AppChooserWidget objects.

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

Returns

the value of property::AppChooserWidget::default-text

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

Returns

the value of property::AppChooserWidget::show-all

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

Returns

the value of property::AppChooserWidget::show-default

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

Returns

the value of property::AppChooserWidget::show-fallback

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

Returns

the value of property::AppChooserWidget::show-other

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

Returns

the value of property::AppChooserWidget::show-recommended

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

text

the new value for property::AppChooserWidget::default-text

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

setting

the new value for property::AppChooserWidget::show-all

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

setting

the new value for property::AppChooserWidget::show-default

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

setting

the new value for property::AppChooserWidget::show-fallback

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

setting

the new value for property::AppChooserWidget::show-other

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

setting

the new value for property::AppChooserWidget::show-recommended

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.

application

the activated gio::AppInfo

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

application

the selected gio::AppInfo

Trait Implementations

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

Formats the value using the given formatter. Read more

Feeds this value into the given Hasher. Read more

Feeds a slice of this type into the given Hasher. Read more

This method returns an Ordering between self and other. Read more

Compares and returns the maximum of two values. Read more

Compares and returns the minimum of two values. Read more

Restrict a value to a certain interval. Read more

This method tests for self and other values to be equal, and is used by ==. Read more

This method tests for !=.

This method returns an ordering between self and other values if one exists. Read more

This method tests less than (for self and other) and is used by the < operator. Read more

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more

This method tests greater than (for self and other) and is used by the > operator. Read more

This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more

Returns the type identifier of Self.

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Upcasts an object to a superclass or interface T. Read more

Upcasts an object to a reference of its superclass or interface T. Read more

Tries to downcast to a subclass or interface implementor T. Read more

Tries to downcast to a reference of its subclass or interface implementor T. Read more

Tries to cast to an object of type T. This handles upcasting, downcasting and casting between interface and interface implementors. All checks are performed at runtime, while downcast and upcast will do many checks at compile-time already. Read more

Tries to cast to reference to an object of type T. This handles upcasting, downcasting and casting between interface and interface implementors. All checks are performed at runtime, while downcast and upcast will do many checks at compile-time already. Read more

Casts to T unconditionally. Read more

Casts to &T unconditionally. Read more

Performs the conversion.

Performs the conversion.

Returns true if the object is an instance of (can be cast to) T.

Safety Read more

Safety Read more

Safety Read more

Safety Read more

Safety Read more

Safety Read more

Same as connect but takes a SignalId instead of a signal name.

Same as connect_local but takes a SignalId instead of a signal name.

Same as connect_unsafe but takes a SignalId instead of a signal name.

Emit signal by signal id.

Same as emit but takes Value for the arguments.

Emit signal by its name.

Same as emit_by_name but takes Value for the arguments.

Emit signal with details by signal id.

Same as emit_with_details but takes Value for the arguments.

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

🔬 This is a nightly-only experimental API. (toowned_clone_into)

recently added

Uses borrowed data to replace owned data, usually by cloning. Read more

Returns a SendValue clone of self.

Converts the given value to a String. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.