Struct gtk4::AppChooserWidget
source · #[repr(transparent)]pub struct AppChooserWidget { /* private fields */ }Expand description
The application selection widgets should be
implemented according to the design of each platform and/or
application requiring them.
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§
source§impl AppChooserWidget
impl AppChooserWidget
sourcepub fn new(content_type: &str) -> AppChooserWidget
pub fn new(content_type: &str) -> AppChooserWidget
Creates a new AppChooserWidget for applications
that can handle content of the given type.
Deprecated since 4.10
This widget will be removed in GTK 5
content_type
the content type to show applications for
Returns
a newly created AppChooserWidget
sourcepub fn builder() -> AppChooserWidgetBuilder
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.
sourcepub fn default_text(&self) -> Option<GString>
pub fn default_text(&self) -> Option<GString>
Returns the text that is shown if there are not applications that can handle the content type.
Deprecated since 4.10
This widget will be removed in GTK 5
Returns
the value of property::AppChooserWidget::default-text
sourcepub fn shows_all(&self) -> bool
pub fn shows_all(&self) -> bool
Gets whether the app chooser should show all applications in a flat list.
Deprecated since 4.10
This widget will be removed in GTK 5
Returns
the value of property::AppChooserWidget::show-all
sourcepub fn shows_default(&self) -> bool
pub fn shows_default(&self) -> bool
Gets whether the app chooser should show the default handler for the content type in a separate section.
Deprecated since 4.10
This widget will be removed in GTK 5
Returns
the value of property::AppChooserWidget::show-default
sourcepub fn shows_fallback(&self) -> bool
pub fn shows_fallback(&self) -> bool
Gets whether the app chooser should show related applications for the content type in a separate section.
Deprecated since 4.10
This widget will be removed in GTK 5
Returns
the value of property::AppChooserWidget::show-fallback
sourcepub fn shows_other(&self) -> bool
pub fn shows_other(&self) -> bool
Gets whether the app chooser should show applications which are unrelated to the content type.
Deprecated since 4.10
This widget will be removed in GTK 5
Returns
the value of property::AppChooserWidget::show-other
sourcepub fn shows_recommended(&self) -> bool
pub fn shows_recommended(&self) -> bool
Gets whether the app chooser should show recommended applications for the content type in a separate section.
Deprecated since 4.10
This widget will be removed in GTK 5
Returns
the value of property::AppChooserWidget::show-recommended
sourcepub fn set_default_text(&self, text: &str)
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.
Deprecated since 4.10
This widget will be removed in GTK 5
text
the new value for property::AppChooserWidget::default-text
sourcepub fn set_show_all(&self, setting: bool)
pub fn set_show_all(&self, setting: bool)
Sets whether the app chooser should show all applications in a flat list.
Deprecated since 4.10
This widget will be removed in GTK 5
setting
the new value for property::AppChooserWidget::show-all
sourcepub fn set_show_default(&self, setting: bool)
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.
Deprecated since 4.10
This widget will be removed in GTK 5
setting
the new value for property::AppChooserWidget::show-default
sourcepub fn set_show_fallback(&self, setting: bool)
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.
Deprecated since 4.10
This widget will be removed in GTK 5
setting
the new value for property::AppChooserWidget::show-fallback
sourcepub fn set_show_other(&self, setting: bool)
pub fn set_show_other(&self, setting: bool)
Sets whether the app chooser should show applications which are unrelated to the content type.
Deprecated since 4.10
This widget will be removed in GTK 5
setting
the new value for property::AppChooserWidget::show-other
sourcepub fn set_show_recommended(&self, setting: bool)
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.
Deprecated since 4.10
This widget will be removed in GTK 5
setting
the new value for property::AppChooserWidget::show-recommended
sourcepub fn connect_application_activated<F: Fn(&Self, &AppInfo) + 'static>(
&self,
f: F
) -> SignalHandlerId
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
sourcepub fn connect_application_selected<F: Fn(&Self, &AppInfo) + 'static>(
&self,
f: F
) -> SignalHandlerId
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§
source§impl Clone for AppChooserWidget
impl Clone for AppChooserWidget
source§impl Debug for AppChooserWidget
impl Debug for AppChooserWidget
source§impl Default for AppChooserWidget
impl Default for AppChooserWidget
source§impl Display for AppChooserWidget
impl Display for AppChooserWidget
source§impl Hash for AppChooserWidget
impl Hash for AppChooserWidget
source§impl Ord for AppChooserWidget
impl Ord for AppChooserWidget
source§impl ParentClassIs for AppChooserWidget
impl ParentClassIs for AppChooserWidget
source§impl<OT: ObjectType> PartialEq<OT> for AppChooserWidget
impl<OT: ObjectType> PartialEq<OT> for AppChooserWidget
source§impl<OT: ObjectType> PartialOrd<OT> for AppChooserWidget
impl<OT: ObjectType> PartialOrd<OT> for AppChooserWidget
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self and other) and is used by the <=
operator. Read moresource§impl StaticType for AppChooserWidget
impl StaticType for AppChooserWidget
source§fn static_type() -> Type
fn static_type() -> Type
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
Auto Trait Implementations§
impl RefUnwindSafe for AppChooserWidget
impl !Send for AppChooserWidget
impl !Sync for AppChooserWidget
impl Unpin for AppChooserWidget
impl UnwindSafe for AppChooserWidget
Blanket Implementations§
source§impl<O> AccessibleExtManual for Owhere
O: IsA<Accessible>,
impl<O> AccessibleExtManual for Owhere
O: IsA<Accessible>,
source§fn update_property(&self, properties: &[Property<'_>])
fn update_property(&self, properties: &[Property<'_>])
source§fn update_relation(&self, relations: &[Relation<'_>])
fn update_relation(&self, relations: &[Relation<'_>])
source§fn update_state(&self, states: &[State])
fn update_state(&self, states: &[State])
source§impl<T> Cast for Twhere
T: ObjectType,
impl<T> Cast for Twhere
T: ObjectType,
source§fn upcast<T>(self) -> Twhere
T: ObjectType,
Self: IsA<T>,
fn upcast<T>(self) -> Twhere
T: ObjectType,
Self: IsA<T>,
T. Read moresource§fn upcast_ref<T>(&self) -> &Twhere
T: ObjectType,
Self: IsA<T>,
fn upcast_ref<T>(&self) -> &Twhere
T: ObjectType,
Self: IsA<T>,
T. Read moresource§fn downcast<T>(self) -> Result<T, Self>where
T: ObjectType,
Self: CanDowncast<T>,
fn downcast<T>(self) -> Result<T, Self>where
T: ObjectType,
Self: CanDowncast<T>,
T. Read moresource§fn downcast_ref<T>(&self) -> Option<&T>where
T: ObjectType,
Self: CanDowncast<T>,
fn downcast_ref<T>(&self) -> Option<&T>where
T: ObjectType,
Self: CanDowncast<T>,
T. Read moresource§fn dynamic_cast<T>(self) -> Result<T, Self>where
T: ObjectType,
fn dynamic_cast<T>(self) -> Result<T, Self>where
T: ObjectType,
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 moresource§fn dynamic_cast_ref<T>(&self) -> Option<&T>where
T: ObjectType,
fn dynamic_cast_ref<T>(&self) -> Option<&T>where
T: ObjectType,
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 moresource§unsafe fn unsafe_cast<T>(self) -> Twhere
T: ObjectType,
unsafe fn unsafe_cast<T>(self) -> Twhere
T: ObjectType,
T unconditionally. Read moresource§unsafe fn unsafe_cast_ref<T>(&self) -> &Twhere
T: ObjectType,
unsafe fn unsafe_cast_ref<T>(&self) -> &Twhere
T: ObjectType,
&T unconditionally. Read moresource§impl<U> IsSubclassableExt for Uwhere
U: IsClass + ParentClassIs,
impl<U> IsSubclassableExt for Uwhere
U: IsClass + ParentClassIs,
fn parent_class_init<T>(class: &mut Class<U>)where
T: ObjectSubclass,
<U as ParentClassIs>::Parent: IsSubclassable<T>,
fn parent_instance_init<T>(instance: &mut InitializingObject<T>)where
T: ObjectSubclass,
<U as ParentClassIs>::Parent: IsSubclassable<T>,
source§impl<T> ObjectExt for Twhere
T: ObjectType,
impl<T> ObjectExt for Twhere
T: ObjectType,
source§fn is<U>(&self) -> boolwhere
U: StaticType,
fn is<U>(&self) -> boolwhere
U: StaticType,
true if the object is an instance of (can be cast to) T.source§fn object_class(&self) -> &Class<Object>
fn object_class(&self) -> &Class<Object>
ObjectClass of the object. Read moresource§fn class_of<U>(&self) -> Option<&Class<U>>where
U: IsClass,
fn class_of<U>(&self) -> Option<&Class<U>>where
U: IsClass,
T. Read moresource§fn interface<U>(&self) -> Option<InterfaceRef<'_, U>>where
U: IsInterface,
fn interface<U>(&self) -> Option<InterfaceRef<'_, U>>where
U: IsInterface,
T of the object. Read moresource§fn set_property<V>(&self, property_name: &str, value: V)where
V: ToValue,
fn set_property<V>(&self, property_name: &str, value: V)where
V: ToValue,
source§fn set_property_from_value(&self, property_name: &str, value: &Value)
fn set_property_from_value(&self, property_name: &str, value: &Value)
source§fn set_properties(&self, property_values: &[(&str, &dyn ToValue)])
fn set_properties(&self, property_values: &[(&str, &dyn ToValue)])
source§fn set_properties_from_value(&self, property_values: &[(&str, Value)])
fn set_properties_from_value(&self, property_values: &[(&str, Value)])
source§fn property<V>(&self, property_name: &str) -> Vwhere
V: 'static + for<'b> FromValue<'b>,
fn property<V>(&self, property_name: &str) -> Vwhere
V: 'static + for<'b> FromValue<'b>,
property_name of the object and cast it to the type V. Read moresource§fn property_value(&self, property_name: &str) -> Value
fn property_value(&self, property_name: &str) -> Value
property_name of the object. Read moresource§fn property_type(&self, property_name: &str) -> Option<Type>
fn property_type(&self, property_name: &str) -> Option<Type>
property_name of this object. Read moresource§fn find_property(&self, property_name: &str) -> Option<ParamSpec>
fn find_property(&self, property_name: &str) -> Option<ParamSpec>
ParamSpec of the property property_name of this object.source§fn list_properties(&self) -> PtrSlice<ParamSpec>
fn list_properties(&self) -> PtrSlice<ParamSpec>
ParamSpec of the properties of this object.source§fn freeze_notify(&self) -> PropertyNotificationFreezeGuard
fn freeze_notify(&self) -> PropertyNotificationFreezeGuard
source§unsafe fn set_qdata<QD>(&self, key: Quark, value: QD)where
QD: 'static,
unsafe fn set_qdata<QD>(&self, key: Quark, value: QD)where
QD: 'static,
key. Read moresource§unsafe fn qdata<QD>(&self, key: Quark) -> Option<NonNull<QD>>where
QD: 'static,
unsafe fn qdata<QD>(&self, key: Quark) -> Option<NonNull<QD>>where
QD: 'static,
key. Read moresource§unsafe fn steal_qdata<QD>(&self, key: Quark) -> Option<QD>where
QD: 'static,
unsafe fn steal_qdata<QD>(&self, key: Quark) -> Option<QD>where
QD: 'static,
key. Read moresource§unsafe fn set_data<QD>(&self, key: &str, value: QD)where
QD: 'static,
unsafe fn set_data<QD>(&self, key: &str, value: QD)where
QD: 'static,
key. Read moresource§unsafe fn data<QD>(&self, key: &str) -> Option<NonNull<QD>>where
QD: 'static,
unsafe fn data<QD>(&self, key: &str) -> Option<NonNull<QD>>where
QD: 'static,
key. Read moresource§unsafe fn steal_data<QD>(&self, key: &str) -> Option<QD>where
QD: 'static,
unsafe fn steal_data<QD>(&self, key: &str) -> Option<QD>where
QD: 'static,
key. Read moresource§fn block_signal(&self, handler_id: &SignalHandlerId)
fn block_signal(&self, handler_id: &SignalHandlerId)
source§fn unblock_signal(&self, handler_id: &SignalHandlerId)
fn unblock_signal(&self, handler_id: &SignalHandlerId)
source§fn stop_signal_emission(&self, signal_id: SignalId, detail: Option<Quark>)
fn stop_signal_emission(&self, signal_id: SignalId, detail: Option<Quark>)
source§fn stop_signal_emission_by_name(&self, signal_name: &str)
fn stop_signal_emission_by_name(&self, signal_name: &str)
source§fn connect<F>(
&self,
signal_name: &str,
after: bool,
callback: F
) -> SignalHandlerIdwhere
F: 'static + Fn(&[Value]) -> Option<Value> + Send + Sync,
fn connect<F>(
&self,
signal_name: &str,
after: bool,
callback: F
) -> SignalHandlerIdwhere
F: 'static + Fn(&[Value]) -> Option<Value> + Send + Sync,
signal_name on this object. Read moresource§fn connect_id<F>(
&self,
signal_id: SignalId,
details: Option<Quark>,
after: bool,
callback: F
) -> SignalHandlerIdwhere
F: 'static + Fn(&[Value]) -> Option<Value> + Send + Sync,
fn connect_id<F>(
&self,
signal_id: SignalId,
details: Option<Quark>,
after: bool,
callback: F
) -> SignalHandlerIdwhere
F: 'static + Fn(&[Value]) -> Option<Value> + Send + Sync,
signal_id on this object. Read moresource§fn connect_local<F>(
&self,
signal_name: &str,
after: bool,
callback: F
) -> SignalHandlerIdwhere
F: 'static + Fn(&[Value]) -> Option<Value>,
fn connect_local<F>(
&self,
signal_name: &str,
after: bool,
callback: F
) -> SignalHandlerIdwhere
F: 'static + Fn(&[Value]) -> Option<Value>,
signal_name on this object. Read moresource§fn connect_local_id<F>(
&self,
signal_id: SignalId,
details: Option<Quark>,
after: bool,
callback: F
) -> SignalHandlerIdwhere
F: 'static + Fn(&[Value]) -> Option<Value>,
fn connect_local_id<F>(
&self,
signal_id: SignalId,
details: Option<Quark>,
after: bool,
callback: F
) -> SignalHandlerIdwhere
F: 'static + Fn(&[Value]) -> Option<Value>,
signal_id on this object. Read moresource§unsafe fn connect_unsafe<F>(
&self,
signal_name: &str,
after: bool,
callback: F
) -> SignalHandlerIdwhere
F: Fn(&[Value]) -> Option<Value>,
unsafe fn connect_unsafe<F>(
&self,
signal_name: &str,
after: bool,
callback: F
) -> SignalHandlerIdwhere
F: Fn(&[Value]) -> Option<Value>,
signal_name on this object. Read moresource§unsafe fn connect_unsafe_id<F>(
&self,
signal_id: SignalId,
details: Option<Quark>,
after: bool,
callback: F
) -> SignalHandlerIdwhere
F: Fn(&[Value]) -> Option<Value>,
unsafe fn connect_unsafe_id<F>(
&self,
signal_id: SignalId,
details: Option<Quark>,
after: bool,
callback: F
) -> SignalHandlerIdwhere
F: Fn(&[Value]) -> Option<Value>,
signal_id on this object. Read moresource§fn connect_closure(
&self,
signal_name: &str,
after: bool,
closure: RustClosure
) -> SignalHandlerId
fn connect_closure(
&self,
signal_name: &str,
after: bool,
closure: RustClosure
) -> SignalHandlerId
signal_name on this object. Read moresource§fn connect_closure_id(
&self,
signal_id: SignalId,
details: Option<Quark>,
after: bool,
closure: RustClosure
) -> SignalHandlerId
fn connect_closure_id(
&self,
signal_id: SignalId,
details: Option<Quark>,
after: bool,
closure: RustClosure
) -> SignalHandlerId
signal_id on this object. Read moresource§fn watch_closure(&self, closure: &impl AsRef<Closure>)
fn watch_closure(&self, closure: &impl AsRef<Closure>)
closure to the lifetime of the object. When
the object’s reference count drops to zero, the closure will be
invalidated. An invalidated closure will ignore any calls to
invoke_with_values, or
invoke when using Rust closures.source§fn emit<R>(&self, signal_id: SignalId, args: &[&dyn ToValue]) -> Rwhere
R: TryFromClosureReturnValue,
fn emit<R>(&self, signal_id: SignalId, args: &[&dyn ToValue]) -> Rwhere
R: TryFromClosureReturnValue,
source§fn emit_with_values(&self, signal_id: SignalId, args: &[Value]) -> Option<Value>
fn emit_with_values(&self, signal_id: SignalId, args: &[Value]) -> Option<Value>
Self::emit but takes Value for the arguments.source§fn emit_by_name<R>(&self, signal_name: &str, args: &[&dyn ToValue]) -> Rwhere
R: TryFromClosureReturnValue,
fn emit_by_name<R>(&self, signal_name: &str, args: &[&dyn ToValue]) -> Rwhere
R: TryFromClosureReturnValue,
source§fn emit_by_name_with_values(
&self,
signal_name: &str,
args: &[Value]
) -> Option<Value>
fn emit_by_name_with_values(
&self,
signal_name: &str,
args: &[Value]
) -> Option<Value>
source§fn emit_by_name_with_details<R>(
&self,
signal_name: &str,
details: Quark,
args: &[&dyn ToValue]
) -> Rwhere
R: TryFromClosureReturnValue,
fn emit_by_name_with_details<R>(
&self,
signal_name: &str,
details: Quark,
args: &[&dyn ToValue]
) -> Rwhere
R: TryFromClosureReturnValue,
source§fn emit_by_name_with_details_and_values(
&self,
signal_name: &str,
details: Quark,
args: &[Value]
) -> Option<Value>
fn emit_by_name_with_details_and_values(
&self,
signal_name: &str,
details: Quark,
args: &[Value]
) -> Option<Value>
source§fn emit_with_details<R>(
&self,
signal_id: SignalId,
details: Quark,
args: &[&dyn ToValue]
) -> Rwhere
R: TryFromClosureReturnValue,
fn emit_with_details<R>(
&self,
signal_id: SignalId,
details: Quark,
args: &[&dyn ToValue]
) -> Rwhere
R: TryFromClosureReturnValue,
source§fn emit_with_details_and_values(
&self,
signal_id: SignalId,
details: Quark,
args: &[Value]
) -> Option<Value>
fn emit_with_details_and_values(
&self,
signal_id: SignalId,
details: Quark,
args: &[Value]
) -> Option<Value>
source§fn disconnect(&self, handler_id: SignalHandlerId)
fn disconnect(&self, handler_id: SignalHandlerId)
source§fn connect_notify<F>(&self, name: Option<&str>, f: F) -> SignalHandlerIdwhere
F: 'static + Fn(&T, &ParamSpec) + Send + Sync,
fn connect_notify<F>(&self, name: Option<&str>, f: F) -> SignalHandlerIdwhere
F: 'static + Fn(&T, &ParamSpec) + Send + Sync,
notify signal of the object. Read moresource§fn connect_notify_local<F>(&self, name: Option<&str>, f: F) -> SignalHandlerIdwhere
F: 'static + Fn(&T, &ParamSpec),
fn connect_notify_local<F>(&self, name: Option<&str>, f: F) -> SignalHandlerIdwhere
F: 'static + Fn(&T, &ParamSpec),
notify signal of the object. Read moresource§unsafe fn connect_notify_unsafe<F>(
&self,
name: Option<&str>,
f: F
) -> SignalHandlerIdwhere
F: Fn(&T, &ParamSpec),
unsafe fn connect_notify_unsafe<F>(
&self,
name: Option<&str>,
f: F
) -> SignalHandlerIdwhere
F: Fn(&T, &ParamSpec),
notify signal of the object. Read more