Struct gtk4::AppChooserWidget

#[repr(transparent)]
pub struct AppChooserWidget { /* private fields */ }

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

impl AppChooserWidget

pub fn new(content_type: &str) -> AppChooserWidget

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

pub fn builder() -> AppChooserWidgetBuilder

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.

pub fn default_text(&self) -> Option<GString>

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

pub fn shows_all(&self) -> bool

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

Returns

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

pub fn shows_default(&self) -> bool

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

pub fn shows_fallback(&self) -> bool

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

pub fn shows_other(&self) -> bool

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

Returns

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

pub fn shows_recommended(&self) -> bool

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

pub fn set_default_text(&self, text: &str)

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

pub fn set_show_all(&self, setting: bool)

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

setting

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

pub fn set_show_default(&self, setting: bool)

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

pub fn set_show_fallback(&self, setting: bool)

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

pub fn set_show_other(&self, setting: bool)

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

setting

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

pub fn set_show_recommended(&self, setting: bool)

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

pub fn connect_application_activated<F: Fn(&Self, &AppInfo) + 'static>( &self, f: F ) -> SignalHandlerId

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 GAppInfo

pub fn connect_application_selected<F: Fn(&Self, &AppInfo) + 'static>( &self, f: F ) -> SignalHandlerId

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

application

the selected GAppInfo

pub fn connect_default_text_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_show_all_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_show_default_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_show_fallback_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_show_other_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_show_recommended_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

Trait Implementations

impl Clone for AppChooserWidget

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AppChooserWidget

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AppChooserWidget

fn default() -> Self

Returns the “default value” for a type.

impl Display for AppChooserWidget

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for AppChooserWidget

fn hash<H>(&self, state: &mut H)where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for AppChooserWidget

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl ParentClassIs for AppChooserWidget

type Parent = Widget

impl<OT: ObjectType> PartialEq<OT> for AppChooserWidget

fn eq(&self, other: &OT) -> bool

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

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for AppChooserWidget

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

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

fn lt(&self, other: &Rhs) -> bool

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

fn le(&self, other: &Rhs) -> bool

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

fn gt(&self, other: &Rhs) -> bool

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

fn ge(&self, other: &Rhs) -> bool

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

impl StaticType for AppChooserWidget

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for AppChooserWidget

impl IsA<Accessible> for AppChooserWidget

impl IsA<AppChooser> for AppChooserWidget

impl IsA<Buildable> for AppChooserWidget

impl IsA<ConstraintTarget> for AppChooserWidget

impl IsA<Widget> for AppChooserWidget