Skip to main content

DesktopEntries

Struct DesktopEntries 

Source
pub struct DesktopEntries { /* private fields */ }
Expand description

The installed applications, from cx.desktop_entries(). Cloning it is cheap.

Implementations§

Source§

impl DesktopEntries

Source

pub fn applications(&self) -> ReadSignal<Vec<DesktopEntry>>

Every application, sorted by name ignoring case, then by ID. Empty until the loop’s next turn after the first cx.desktop_entries().

Source

pub fn lookup(&self, app_id: &str) -> Option<DesktopEntry>

The application a window’s app id names, as a task bar finds the window’s icon: the one with that ID, else one whose ID differs only in case, else one whose StartupWMClass matches ignoring case, else one whose ID ends in that part after a dot, as org.gnome.Nautilus does for nautilus. It reads the list as get does, so a binding that calls it runs again when the list changes.

Source

pub fn launch(&self, id: &str)

Starts the application with ID id, on its own: in a process group of its own, with no input or output, and in its working_dir if it has one. A terminal app runs through xdg-terminal-exec. One that is dbus_activatable is called with org.freedesktop.Application.Activate on the session bus, which starts it if it isn’t running, and runs its Exec if that fails. What can’t start is logged: an unknown ID, a malformed Exec, a terminal app without xdg-terminal-exec on PATH, and a D-Bus app that didn’t start with no Exec to fall back on.

When the compositor hands out activation tokens, the shell asks for one first, with the app’s ID and the last click or key press on its windows, and starts the app once it comes, or after 100 ms without one. The token goes in XDG_ACTIVATION_TOKEN and DESKTOP_STARTUP_ID for Exec, and in the platform data’s activation-token and desktop-startup-id over D-Bus, so the compositor may focus the app’s window.

Source

pub fn launch_action(&self, id: &str, action: &str)

Starts one of an application’s actions, named by its DesktopAction::id, as launch does, a D-Bus app’s with ActivateAction.

Trait Implementations§

Source§

impl Clone for DesktopEntries

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more

Auto Trait Implementations§

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,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

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

Source§

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

Mutably borrows from an owned value. Read more
Source§

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

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

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

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<T> ToOwned for T
where T: Clone,

Source§

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)

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

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

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

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

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

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

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more