Struct gio::DesktopAppInfo

source · [−]

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

Expand description

DesktopAppInfo is an implementation of AppInfo based on desktop files.

Note that <gio/gdesktopappinfo.h> belongs to the UNIX-specific GIO interfaces, thus you have to use the gio-unix-2.0.pc pkg-config file when using it.

Implements

glib::ObjectExt, AppInfoExt, AppInfoExtManual

Implementations

source

impl DesktopAppInfo

source

pub fn search(search_string: &str) -> Vec<Vec<GString>>

Searches desktop files for ones that match search_string.

The return value is an array of strvs. Each strv contains a list of applications that matched search_string with an equal score. The outer list is sorted by score so that the first strv contains the best-matching applications, and so on. The algorithm for determining matches is undefined and may change at any time.

None of the search results are subjected to the normal validation checks performed by new() (for example, checking that the executable referenced by a result exists), and so it is possible for new() to return None when passed an app ID returned by this function. It is expected that calling code will do this when subsequently creating a DesktopAppInfo for each result.

`search_string`

the search string to use

Returns

a list of strvs. Free each item with g_strfreev() and free the outer list with g_free().

source

impl DesktopAppInfo

source

pub fn new(desktop_id: &str) -> Option<DesktopAppInfo>

Available on non-Windows and non-macOS only.

Creates a new DesktopAppInfo based on a desktop file id.

A desktop file id is the basename of the desktop file, including the .desktop extension. GIO is looking for a desktop file with this name in the applications subdirectories of the XDG data directories (i.e. the directories specified in the XDG_DATA_HOME and XDG_DATA_DIRS environment variables). GIO also supports the prefix-to-subdirectory mapping that is described in the Menu Spec (i.e. a desktop id of kde-foo.desktop will match /usr/share/applications/kde/foo.desktop).

`desktop_id`

the desktop file id

Returns

a new DesktopAppInfo, or None if no desktop file with that id exists.

source

pub fn from_filename(filename: impl AsRef<Path>) -> Option<DesktopAppInfo>

Available on non-Windows and non-macOS only.

Creates a new DesktopAppInfo.

`filename`

the path of a desktop file, in the GLib filename encoding

Returns

a new DesktopAppInfo or None on error.

source

pub fn from_keyfile(key_file: &KeyFile) -> Option<DesktopAppInfo>

Available on non-Windows and non-macOS only.

Creates a new DesktopAppInfo.

`key_file`

an opened glib::KeyFile

Returns

a new DesktopAppInfo or None on error.

source

pub fn action_name(&self, action_name: &str) -> GString

Available on non-Windows and non-macOS only.

Gets the user-visible display name of the “additional application action” specified by action_name.

This corresponds to the “Name” key within the keyfile group for the action.

`action_name`

the name of the action as from list_actions()

Returns

the locale-specific action name

source

pub fn boolean(&self, key: &str) -> bool

Available on non-Windows and non-macOS only.

Looks up a boolean value in the keyfile backing self.

The key is looked up in the “Desktop Entry” group.

`key`

the key to look up

Returns

the boolean value, or false if the key is not found

source

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

Available on non-Windows and non-macOS only.

Gets the categories from the desktop file.

Returns

The unparsed Categories key from the desktop file; i.e. no attempt is made to split it by ‘;’ or validate it.

source

pub fn filename(&self) -> Option<PathBuf>

Available on non-Windows and non-macOS only.

When self was created from a known filename, return it. In some situations such as the DesktopAppInfo returned from from_keyfile(), this function will return None.

Returns

The full path to the file for self, or None if not known.

source

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

Available on non-Windows and non-macOS only.

Gets the generic name from the desktop file.

Returns

The value of the GenericName key

source

pub fn is_hidden(&self) -> bool

Available on non-Windows and non-macOS only.

A desktop file is hidden if the Hidden key in it is set to True.

Returns

true if hidden, false otherwise.

source

pub fn keywords(&self) -> Vec<GString>

Available on non-Windows and non-macOS only.

Gets the keywords from the desktop file.

Returns

The value of the Keywords key

source

pub fn locale_string(&self, key: &str) -> Option<GString>

Available on non-Windows and non-macOS only.

Looks up a localized string value in the keyfile backing self translated to the current locale.

The key is looked up in the “Desktop Entry” group.

`key`

the key to look up

Returns

a newly allocated string, or None if the key is not found

source

pub fn is_nodisplay(&self) -> bool

Available on non-Windows and non-macOS only.

Gets the value of the NoDisplay key, which helps determine if the application info should be shown in menus. See G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY and AppInfoExt::should_show().

Returns

The value of the NoDisplay key

source

pub fn shows_in(&self, desktop_env: Option<&str>) -> bool

Available on non-Windows and non-macOS only.

Checks if the application info should be shown in menus that list available applications for a specific name of the desktop, based on the OnlyShowIn and NotShowIn keys.

desktop_env should typically be given as None, in which case the XDG_CURRENT_DESKTOP environment variable is consulted. If you want to override the default mechanism then you may specify desktop_env, but this is not recommended.

Note that AppInfoExt::should_show() for self will include this check (with None for desktop_env) as well as additional checks.

`desktop_env`

a string specifying a desktop name

Returns

true if the self should be shown in desktop_env according to the OnlyShowIn and NotShowIn keys, false otherwise.

source

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

Available on non-Windows and non-macOS only.

Retrieves the StartupWMClass field from self. This represents the WM_CLASS property of the main window of the application, if launched through self.

Returns

the startup WM class, or None if none is set in the desktop file.

source

pub fn string(&self, key: &str) -> Option<GString>

Available on non-Windows and non-macOS only.

Looks up a string value in the keyfile backing self.

The key is looked up in the “Desktop Entry” group.

`key`

the key to look up

Returns

a newly allocated string, or None if the key is not found

source

pub fn string_list(&self, key: &str) -> Vec<GString>

Available on non-Windows and non-macOS and crate feature v2_60 only.

Looks up a string list value in the keyfile backing self.

The key is looked up in the “Desktop Entry” group.

`key`

the key to look up

Returns

a None-terminated string array or None if the specified key cannot be found. The array should be freed with g_strfreev().

source

pub fn has_key(&self, key: &str) -> bool

Available on non-Windows and non-macOS only.

Returns whether key exists in the “Desktop Entry” group of the keyfile backing self.

`key`

the key to look up

Returns

true if the key exists

source

pub fn launch_action(
 &self,
 action_name: &str,
 launch_context: Option<&impl IsA<AppLaunchContext>>
)

Available on non-Windows and non-macOS only.

Activates the named application action.

You may only call this function on action names that were returned from list_actions().

Note that if the main entry of the desktop file indicates that the application supports startup notification, and launch_context is non-None, then startup notification will be used when activating the action (and as such, invocation of the action on the receiving side must signal the end of startup notification when it is completed). This is the expected behaviour of applications declaring additional actions, as per the desktop file specification.

As with AppInfoExt::launch() there is no way to detect failures that occur while using this function.

`action_name`

the name of the action as from list_actions()

`launch_context`

a AppLaunchContext

source

pub fn launch_uris_as_manager(
 &self,
 uris: &[&str ],
 launch_context: Option<&impl IsA<AppLaunchContext>>,
 spawn_flags: SpawnFlags,
 user_setup: Option<Box_<dyn FnOnce() + 'static>>,
 pid_callback: Option<&mut dyn FnMut(&DesktopAppInfo, Pid)>
) -> Result<(), Error>

Available on non-Windows and non-macOS only.

This function performs the equivalent of AppInfoExt::launch_uris(), but is intended primarily for operating system components that launch applications. Ordinary applications should use AppInfoExt::launch_uris().

If the application is launched via GSpawn, then spawn_flags, user_setup and user_setup_data are used for the call to g_spawn_async(). Additionally, pid_callback (with pid_callback_data) will be called to inform about the PID of the created process. See g_spawn_async_with_pipes() for information on certain parameter conditions that can enable an optimized posix_spawn() codepath to be used.

If application launching occurs via some other mechanism (eg: D-Bus activation) then spawn_flags, user_setup, user_setup_data, pid_callback and pid_callback_data are ignored.

`uris`

List of URIs

`launch_context`

a AppLaunchContext

`spawn_flags`

glib::SpawnFlags, used for each process

`user_setup`

a GSpawnChildSetupFunc, used once for each process.

`user_setup_data`

User data for user_setup

`pid_callback`

Callback for child processes

`pid_callback_data`

User data for callback

Returns

true on successful launch, false otherwise.

source

pub fn list_actions(&self) -> Vec<GString>

Available on non-Windows and non-macOS only.

Returns the list of “additional application actions” supported on the desktop file, as per the desktop file specification.

As per the specification, this is the list of actions that are explicitly listed in the “Actions” key of the [Desktop Entry] group.

Returns

a list of strings, always non-None

source

pub fn implementations(interface: &str) -> Vec<DesktopAppInfo>

Available on non-Windows and non-macOS only.

Gets all applications that implement interface.

An application implements an interface if that interface is listed in the Implements= line of the desktop file of the application.

`interface`

the name of the interface

Returns

a list of DesktopAppInfo objects.

Trait Implementations

source

impl Clone for DesktopAppInfo

Available on non-Windows and non-macOS only.

source

fn clone(&self) -> Self

Returns a copy of the value. Read more

1.0.0 · source

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

Performs copy-assignment from source. Read more

source

impl Debug for DesktopAppInfo

Available on non-Windows and non-macOS only.

source

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

Formats the value using the given formatter. Read more

source

impl Display for DesktopAppInfo

Available on non-Windows and non-macOS only.

source

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

Formats the value using the given formatter. Read more

source

impl Hash for DesktopAppInfo

Available on non-Windows and non-macOS only.

source

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

Feeds this value into the given Hasher. Read more

1.3.0 · source

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

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

source

impl Ord for DesktopAppInfo

Available on non-Windows and non-macOS only.

source

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

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

1.21.0 · source

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

Compares and returns the maximum of two values. Read more

1.21.0 · source

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

Compares and returns the minimum of two values. Read more

1.50.0 · source

fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval. Read more

source

impl ParentClassIs for DesktopAppInfo

Available on non-Windows and non-macOS only.

type Parent = Object

source

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

Available on non-Windows and non-macOS only.

source

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

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

1.0.0 · source

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

This method tests for !=.

source

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

Available on non-Windows and non-macOS only.

source

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

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

1.0.0 · source

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

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

1.0.0 · source

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

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

1.0.0 · source

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

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

1.0.0 · source

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

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

source

impl StaticType for DesktopAppInfo

Available on non-Windows and non-macOS only.

source

fn static_type() -> Type

Returns the type identifier of Self.

source

impl Eq for DesktopAppInfo

Available on non-Windows and non-macOS only.

source

impl IsA<AppInfo> for DesktopAppInfo

Available on non-Windows and non-macOS only.

Auto Trait Implementations

impl RefUnwindSafe for DesktopAppInfo

impl !Send for DesktopAppInfo

impl !Sync for DesktopAppInfo

impl Unpin for DesktopAppInfo

impl UnwindSafe for DesktopAppInfo

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> Cast for T where
T: ObjectType,

source

fn upcast<T>(self) -> T where
T: ObjectType,
Self: IsA<T>,

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

source

fn upcast_ref<T>(&self) -> &T where
T: ObjectType,
Self: IsA<T>,

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

source

fn downcast<T>(self) -> Result<T, Self> where
T: ObjectType,
Self: CanDowncast<T>,

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

source

fn downcast_ref<T>(&self) -> Option<&T> where
T: ObjectType,
Self: CanDowncast<T>,

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

source

fn dynamic_cast<T>(self) -> Result<T, Self> where
T: ObjectType,

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

source

fn dynamic_cast_ref<T>(&self) -> Option<&T> where
T: ObjectType,

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

source

unsafe fn unsafe_cast<T>(self) -> T where
T: ObjectType,

Casts to T unconditionally. Read more

source

unsafe fn unsafe_cast_ref<T>(&self) -> &T where
T: ObjectType,

Casts to &T unconditionally. Read more

source

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source

impl IsSubclassableExt for U where
U: IsClass + ParentClassIs,

source

fn parent_class_init<T>(class: &mut Class) where
T: ObjectSubclass,
::Parent: IsSubclassable<T>,

source

fn parent_instance_init<T>(instance: &mut InitializingObject<T>) where
T: ObjectSubclass,
::Parent: IsSubclassable<T>,

source

impl<T> ObjectExt for T where
T: ObjectType,

source

fn is(&self) -> bool where
U: StaticType,

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

source

fn type_(&self) -> Type

Returns the type of the object.

source

fn object_class(&self) -> &Class<Object>

Returns the ObjectClass of the object. Read more

source

fn class(&self) -> &Class<T> where
T: IsClass,

Returns the class of the object.

source

fn class_of(&self) -> Option<&Class> where
U: IsClass,

Returns the class of the object in the given type T. Read more

source

fn interface(&self) -> Option<InterfaceRef<'_, U>> where
U: IsInterface,

Returns the interface T of the object. Read more

source

fn try_set_property<V>(
 &self,
 property_name: &str,
 value: V
) -> Result<(), BoolError> where
 V: ToValue,

Similar to Self::set_property but fails instead of panicking.

source

fn set_property<V>(&self, property_name: &str, value: V) where
V: ToValue,

Sets the property property_name of the object to value value. Read more

source

fn try_set_property_from_value(
 &self,
 property_name: &str,
 value: &Value
) -> Result<(), BoolError>

Similar to Self::set_property but fails instead of panicking.

source

fn set_property_from_value(&self, property_name: &str, value: &Value)

Sets the property property_name of the object to value value. Read more

source

fn try_set_properties(
&self,
property_values: &[(&str, &dyn ToValue )]
) -> Result<(), BoolError>

Similar to Self::set_properties but fails instead of panicking.

source

fn set_properties(&self, property_values: &[(&str, &dyn ToValue )])

Sets multiple properties of the object at once. Read more

source

fn try_set_properties_from_value(
&self,
property_values: &[(&str, Value )]
) -> Result<(), BoolError>

Similar to Self::set_properties_from_value but fails instead of panicking.

source

fn set_properties_from_value(&self, property_values: &[(&str, Value )])

Sets multiple properties of the object at once. Read more

source

fn try_property<V>(&self, property_name: &str) -> Result<V, BoolError> where
V: 'static + for<'b> FromValue<'b>,

Similar to Self::property but fails instead of panicking.

source

fn property<V>(&self, property_name: &str) -> V where
V: 'static + for<'b> FromValue<'b>,

Gets the property property_name of the object and cast it to the type V. Read more

source

fn try_property_value(&self, property_name: &str) -> Result<Value, BoolError>

Similar to Self::property_value but fails instead of panicking.

source

fn property_value(&self, property_name: &str) -> Value

Gets the property property_name of the object. Read more

source

fn has_property(&self, property_name: &str, type_: Option<Type>) -> bool

Check if the object has a property property_name of the given type_. Read more

source

fn property_type(&self, property_name: &str) -> Option<Type>

Get the type of the property property_name of this object. Read more

source

fn find_property(&self, property_name: &str) -> Option<ParamSpec>

Get the ParamSpec of the property property_name of this object.

source

fn list_properties(&self) -> PtrSlice<ParamSpec>

Return all ParamSpec of the properties of this object.

source

fn freeze_notify(&self) -> PropertyNotificationFreezeGuard

Freeze all property notifications until the return guard object is dropped. Read more

source

unsafe fn set_qdata<QD>(&self, key: Quark, value: QD) where
QD: 'static,

Set arbitrary data on this object with the given key. Read more

source

unsafe fn qdata<QD>(&self, key: Quark) -> Option<NonNull<QD>> where
QD: 'static,

Return previously set arbitrary data of this object with the given key. Read more

source

unsafe fn steal_qdata<QD>(&self, key: Quark) -> Option<QD> where
QD: 'static,

Retrieve previously set arbitrary data of this object with the given key. Read more

source

unsafe fn set_data<QD>(&self, key: &str, value: QD) where
QD: 'static,

Set arbitrary data on this object with the given key. Read more

source

unsafe fn data<QD>(&self, key: &str) -> Option<NonNull<QD>> where
QD: 'static,

Return previously set arbitrary data of this object with the given key. Read more

source

unsafe fn steal_data<QD>(&self, key: &str) -> Option<QD> where
QD: 'static,

Retrieve previously set arbitrary data of this object with the given key. Read more

source

fn block_signal(&self, handler_id: &SignalHandlerId)

Block a given signal handler. Read more

source

fn unblock_signal(&self, handler_id: &SignalHandlerId)

Unblock a given signal handler.

source

fn stop_signal_emission(&self, signal_id: SignalId, detail: Option<Quark>)

Stop emission of the currently emitted signal.

source

fn stop_signal_emission_by_name(&self, signal_name: &str)

Stop emission of the currently emitted signal by the (possibly detailed) signal name.

source

fn try_connect<F>(
 &self,
 signal_name: &str,
 after: bool,
 callback: F
) -> Result<SignalHandlerId, BoolError> where
 F: 'static + Fn(&[Value ]) -> Option<Value> + Send + Sync,

Similar to Self::connect but fails instead of panicking.

source

fn connect<F>(
 &self,
 signal_name: &str,
 after: bool,
 callback: F
) -> SignalHandlerId where
 F: 'static + Fn(&[Value ]) -> Option<Value> + Send + Sync,

Connect to the signal signal_name on this object. Read more

source

fn try_connect_id<F>(
 &self,
 signal_id: SignalId,
 details: Option<Quark>,
 after: bool,
 callback: F
) -> Result<SignalHandlerId, BoolError> where
 F: 'static + Fn(&[Value ]) -> Option<Value> + Send + Sync,

Similar to Self::connect_id but fails instead of panicking.

source

fn connect_id<F>(
 &self,
 signal_id: SignalId,
 details: Option<Quark>,
 after: bool,
 callback: F
) -> SignalHandlerId where
 F: 'static + Fn(&[Value ]) -> Option<Value> + Send + Sync,

Connect to the signal signal_id on this object. Read more

source

fn try_connect_local<F>(
 &self,
 signal_name: &str,
 after: bool,
 callback: F
) -> Result<SignalHandlerId, BoolError> where
 F: 'static + Fn(&[Value ]) -> Option<Value>,

Similar to Self::connect_local but fails instead of panicking.

source

fn connect_local<F>(
 &self,
 signal_name: &str,
 after: bool,
 callback: F
) -> SignalHandlerId where
 F: 'static + Fn(&[Value ]) -> Option<Value>,

Connect to the signal signal_name on this object. Read more

source

fn try_connect_local_id<F>(
 &self,
 signal_id: SignalId,
 details: Option<Quark>,
 after: bool,
 callback: F
) -> Result<SignalHandlerId, BoolError> where
 F: 'static + Fn(&[Value ]) -> Option<Value>,

Similar to Self::connect_local_id but fails instead of panicking.

source

fn connect_local_id<F>(
 &self,
 signal_id: SignalId,
 details: Option<Quark>,
 after: bool,
 callback: F
) -> SignalHandlerId where
 F: 'static + Fn(&[Value ]) -> Option<Value>,

Connect to the signal signal_id on this object. Read more

source

unsafe fn try_connect_unsafe<F>(
 &self,
 signal_name: &str,
 after: bool,
 callback: F
) -> Result<SignalHandlerId, BoolError> where
 F: Fn(&[Value ]) -> Option<Value>,

Similar to Self::connect_unsafe but fails instead of panicking.

source

unsafe fn connect_unsafe<F>(
 &self,
 signal_name: &str,
 after: bool,
 callback: F
) -> SignalHandlerId where
 F: Fn(&[Value ]) -> Option<Value>,

Connect to the signal signal_name on this object. Read more

source

unsafe fn try_connect_unsafe_id<F>(
 &self,
 signal_id: SignalId,
 details: Option<Quark>,
 after: bool,
 callback: F
) -> Result<SignalHandlerId, BoolError> where
 F: Fn(&[Value ]) -> Option<Value>,

Similar to Self::connect_unsafe_id but fails instead of panicking.

source

fn try_connect_closure(
 &self,
 signal_name: &str,
 after: bool,
 closure: RustClosure
) -> Result<SignalHandlerId, BoolError>

Similar to Self::connect_closure but fails instead of panicking.

source

fn connect_closure(
    &self,
    signal_name: &str,
    after: bool,
    closure: RustClosure
) -> SignalHandlerId

Connect a closure to the signal signal_name on this object. Read more

source

fn try_connect_closure_id(
 &self,
 signal_id: SignalId,
 details: Option<Quark>,
 after: bool,
 closure: RustClosure
) -> Result<SignalHandlerId, BoolError>

Similar to Self::connect_closure_id but fails instead of panicking.

source

fn connect_closure_id(
 &self,
 signal_id: SignalId,
 details: Option<Quark>,
 after: bool,
 closure: RustClosure
) -> SignalHandlerId

Connect a closure to the signal signal_id on this object. Read more

source

fn watch_closure(&self, closure: &impl AsRef<Closure>)

Limits the lifetime of 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. Read more

source

unsafe fn connect_unsafe_id<F>(
 &self,
 signal_id: SignalId,
 details: Option<Quark>,
 after: bool,
 callback: F
) -> SignalHandlerId where
 F: Fn(&[Value ]) -> Option<Value>,

Connect to the signal signal_id on this object. Read more

source

fn try_emit<R>(
 &self,
 signal_id: SignalId,
 args: &[&dyn ToValue ]
) -> Result<R, BoolError> where
 R: TryFromClosureReturnValue,

Similar to Self::emit but fails instead of panicking.

source

fn emit<R>(&self, signal_id: SignalId, args: &[&dyn ToValue ]) -> R where
R: TryFromClosureReturnValue,

Emit signal by signal id. Read more

source

fn try_emit_with_values(
 &self,
 signal_id: SignalId,
 args: &[Value ]
) -> Result<Option<Value>, BoolError>

Similar to Self::emit_with_values but fails instead of panicking.

source

fn emit_with_values(&self, signal_id: SignalId, args: &[Value ]) -> Option<Value>

Same as Self::emit but takes Value for the arguments.

source

fn try_emit_by_name<R>(
 &self,
 signal_name: &str,
 args: &[&dyn ToValue ]
) -> Result<R, BoolError> where
 R: TryFromClosureReturnValue,

Similar to Self::emit_by_name but fails instead of panicking.

source

fn emit_by_name<R>(&self, signal_name: &str, args: &[&dyn ToValue ]) -> R where
R: TryFromClosureReturnValue,

Emit signal by its name. Read more

source

fn try_emit_by_name_with_values(
 &self,
 signal_name: &str,
 args: &[Value ]
) -> Result<Option<Value>, BoolError>

Similar to Self::emit_by_name_with_values but fails instead of panicking.

source

fn emit_by_name_with_values(
 &self,
 signal_name: &str,
 args: &[Value ]
) -> Option<Value>

Emit signal by its name. Read more

source

fn try_emit_with_details<R>(
 &self,
 signal_id: SignalId,
 details: Quark,
 args: &[&dyn ToValue ]
) -> Result<R, BoolError> where
 R: TryFromClosureReturnValue,

Similar to Self::emit_with_details but fails instead of panicking.

source

fn emit_with_details<R>(
 &self,
 signal_id: SignalId,
 details: Quark,
 args: &[&dyn ToValue ]
) -> R where
 R: TryFromClosureReturnValue,

Emit signal by signal id with details. Read more

source

fn try_emit_with_details_and_values(
 &self,
 signal_id: SignalId,
 details: Quark,
 args: &[Value ]
) -> Result<Option<Value>, BoolError>

Similar to Self::emit_with_details_and_values but fails instead of panicking.

source

fn emit_with_details_and_values(
 &self,
 signal_id: SignalId,
 details: Quark,
 args: &[Value ]
) -> Option<Value>

Emit signal by signal id with details. Read more

source

fn disconnect(&self, handler_id: SignalHandlerId)

Disconnect a previously connected signal handler.

source

fn connect_notify<F>(&self, name: Option<&str>, f: F) -> SignalHandlerId where
F: 'static + Fn(&T, &ParamSpec) + Send + Sync,

Connect to the notify signal of the object. Read more

source

fn connect_notify_local<F>(&self, name: Option<&str>, f: F) -> SignalHandlerId where
F: 'static + Fn(&T, &ParamSpec),

Connect to the notify signal of the object. Read more

source

unsafe fn connect_notify_unsafe<F>(
 &self,
 name: Option<&str>,
 f: F
) -> SignalHandlerId where
 F: Fn(&T, &ParamSpec),

Connect to the notify signal of the object. Read more

source

fn notify(&self, property_name: &str)

Notify that the given property has changed its value. Read more

source

fn notify_by_pspec(&self, pspec: &ParamSpec)

Notify that the given property has changed its value. Read more

source

fn downgrade(&self) -> WeakRef<T>

Downgrade this object to a weak reference.

source

fn add_weak_ref_notify<F>(&self, f: F) -> WeakRefNotify<T> where
F: 'static + FnOnce() + Send,

Add a callback to be notified when the Object is disposed.

source

fn add_weak_ref_notify_local<F>(&self, f: F) -> WeakRefNotify<T> where
F: 'static + FnOnce(),

Add a callback to be notified when the Object is disposed. Read more

source

fn bind_property<O>(
 &'a self,
 source_property: &'a str,
 target: &'a O,
 target_property: &'a str
) -> BindingBuilder<'a> where
 O: ObjectType,

Bind property source_property on this object to the target_property on the target object. Read more

source

fn ref_count(&self) -> u32

Returns the strong reference count of this object.

source

impl<T> StaticTypeExt for T where
T: StaticType,

source

fn ensure_type()

Ensures that the type has been registered with the type system.

source

impl<T> ToClosureReturnValue for T where
T: ToValue,

source

fn to_closure_return_value(&self) -> Option<Value>

source

impl<T> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

source

fn to_owned(&self) -> T

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

source

fn clone_into(&self, target: &mut T)

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

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

source

impl<T> ToString for T where
T: Display + ?Sized,

source

default fn to_string(&self) -> String

Converts the given value to a String. Read more

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T> TryFromClosureReturnValue for T where
T: 'static + for<'a> FromValue<'a> + StaticType,

source

fn try_from_closure_return_value(v: Option<Value>) -> Result<T, BoolError>

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

source

impl<Super, Sub> CanDowncast for Super where
Super: IsA<Super>,
Sub: IsA<Super>,

source

impl<'a, T, C, E> FromValueOptional<'a> for T where
 T: FromValue<'a, Checker = C>,
 C: ValueTypeChecker<Error = ValueTypeMismatchOrNoneError<E>>,
 E: 'static + Error + Send,

Struct gio::DesktopAppInfo

Implementations

impl DesktopAppInfo

pub fn search(search_string: &str) -> Vec<Vec<GString>>

impl DesktopAppInfo

pub fn new(desktop_id: &str) -> Option<DesktopAppInfo>

pub fn from_filename(filename: impl AsRef<Path>) -> Option<DesktopAppInfo>

pub fn from_keyfile(key_file: &KeyFile) -> Option<DesktopAppInfo>

pub fn action_name(&self, action_name: &str) -> GString

pub fn boolean(&self, key: &str) -> bool

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

pub fn filename(&self) -> Option<PathBuf>

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

pub fn is_hidden(&self) -> bool

pub fn keywords(&self) -> Vec<GString>

pub fn locale_string(&self, key: &str) -> Option<GString>

pub fn is_nodisplay(&self) -> bool

pub fn shows_in(&self, desktop_env: Option<&str>) -> bool

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

pub fn string(&self, key: &str) -> Option<GString>

pub fn string_list(&self, key: &str) -> Vec<GString>

pub fn has_key(&self, key: &str) -> bool

pub fn launch_action( &self, action_name: &str, launch_context: Option<&impl IsA<AppLaunchContext>>)

pub fn launch_uris_as_manager( &self, uris: &[&str], launch_context: Option<&impl IsA<AppLaunchContext>>, spawn_flags: SpawnFlags, user_setup: Option<Box_<dyn FnOnce() + 'static>>, pid_callback: Option<&mut dyn FnMut(&DesktopAppInfo, Pid)>) -> Result<(), Error>

pub fn list_actions(&self) -> Vec<GString>

pub fn implementations(interface: &str) -> Vec<DesktopAppInfo>

Trait Implementations

impl Clone for DesktopAppInfo

fn clone(&self) -> Self

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

impl Debug for DesktopAppInfo

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

impl Display for DesktopAppInfo

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

impl Hash for DesktopAppInfo

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

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

impl Ord for DesktopAppInfo

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

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

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

fn clamp(self, min: Self, max: Self) -> Self

impl ParentClassIs for DesktopAppInfo

type Parent = Object

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

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

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

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

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

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

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

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

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

impl StaticType for DesktopAppInfo

fn static_type() -> Type

impl Eq for DesktopAppInfo

impl IsA<AppInfo> for DesktopAppInfo

Auto Trait Implementations

impl RefUnwindSafe for DesktopAppInfo

impl !Send for DesktopAppInfo

impl !Sync for DesktopAppInfo

impl Unpin for DesktopAppInfo

impl UnwindSafe for DesktopAppInfo

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for T where T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T> Cast for T where T: ObjectType,

fn upcast<T>(self) -> T where T: ObjectType, Self: IsA<T>,

fn upcast_ref<T>(&self) -> &T where T: ObjectType, Self: IsA<T>,

fn downcast<T>(self) -> Result<T, Self> where T: ObjectType, Self: CanDowncast<T>,

fn downcast_ref<T>(&self) -> Option<&T> where T: ObjectType, Self: CanDowncast<T>,

fn dynamic_cast<T>(self) -> Result<T, Self> where T: ObjectType,

fn dynamic_cast_ref<T>(&self) -> Option<&T> where T: ObjectType,

unsafe fn unsafe_cast<T>(self) -> T where T: ObjectType,

unsafe fn unsafe_cast_ref<T>(&self) -> &T where T: ObjectType,

impl<T> From<T> for T

pub fn launch_action(
&self,
action_name: &str,
launch_context: Option<&impl IsA<AppLaunchContext>>
)

pub fn launch_uris_as_manager(
&self,
uris: &[&str ],
launch_context: Option<&impl IsA<AppLaunchContext>>,
spawn_flags: SpawnFlags,
user_setup: Option<Box_<dyn FnOnce() + 'static>>,
pid_callback: Option<&mut dyn FnMut(&DesktopAppInfo, Pid)>
) -> Result<(), Error>

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

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

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T> Cast for T where
T: ObjectType,

fn upcast<T>(self) -> T where
T: ObjectType,
Self: IsA<T>,

fn upcast_ref<T>(&self) -> &T where
T: ObjectType,
Self: IsA<T>,

fn downcast<T>(self) -> Result<T, Self> where
T: ObjectType,
Self: CanDowncast<T>,

fn downcast_ref<T>(&self) -> Option<&T> where
T: ObjectType,
Self: CanDowncast<T>,

fn dynamic_cast<T>(self) -> Result<T, Self> where
T: ObjectType,

fn dynamic_cast_ref<T>(&self) -> Option<&T> where
T: ObjectType,

unsafe fn unsafe_cast<T>(self) -> T where
T: ObjectType,

unsafe fn unsafe_cast_ref<T>(&self) -> &T where
T: ObjectType,

impl<T, U> Into<U> for T where
U: From<T>,

impl<U> IsSubclassableExt for U where
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>,

impl<T> ObjectExt for T where
T: ObjectType,

fn is<U>(&self) -> bool where
U: StaticType,

fn class(&self) -> &Class<T> where
T: IsClass,

fn class_of<U>(&self) -> Option<&Class<U>> where
U: IsClass,

fn interface<U>(&self) -> Option<InterfaceRef<'_, U>> where
U: IsInterface,

fn try_set_property<V>(
&self,
property_name: &str,
value: V
) -> Result<(), BoolError> where
V: ToValue,

fn set_property<V>(&self, property_name: &str, value: V) where
V: ToValue,

fn try_set_property_from_value(
&self,
property_name: &str,
value: &Value
) -> Result<(), BoolError>

fn try_set_properties(
&self,
property_values: &[(&str, &dyn ToValue )]
) -> Result<(), BoolError>

fn set_properties(&self, property_values: &[(&str, &dyn ToValue )])

fn try_set_properties_from_value(
&self,
property_values: &[(&str, Value )]
) -> Result<(), BoolError>