Struct ApplicationFields

pub struct ApplicationFields {

    pub try_exec: Option<String>,
    pub exec: Option<String>,
    pub path: Option<String>,
    pub terminal: Option<bool>,
    pub actions: Option<Vec<String>>,
    pub mime_type: Option<Vec<String>>,
    pub categories: Option<Vec<String>>,
    pub implements: Option<Vec<String>>,
    pub keywords: Option<LocaleStringList>,
    pub startup_notify: Option<bool>,
    pub startup_wm_class: Option<String>,
    pub prefers_non_default_gpu: Option<bool>,
    pub single_main_window: Option<bool>,
}

Fields specific to Application type desktop entries. These fields are only valid when the entry type is Application.

Fields

try_exec: Option<String>

Path to an executable file on disk used to determine if the program is actually installed. If the path is not an absolute path, the file is looked up in the $PATH environment variable. If the file is not present or if it is not executable, the entry may be ignored (not be used in menus, for example).

exec: Option<String>

Program to execute, possibly with arguments. See the Exec key for details on how this key works. The Exec key is required if DBusActivatable is not set to true. Even if DBusActivatable is true, Exec should be specified for compatibility with implementations that do not understand DBusActivatable.

path: Option<String>

If entry is of type Application, the working directory to run the program in.

terminal: Option<bool>

Whether the program runs in a terminal window.

actions: Option<Vec<String>>

Identifiers for application actions. This can be used to tell the application to make a specific action, different from the default behavior. The Application actions section describes how actions work.

mime_type: Option<Vec<String>>

The MIME type(s) supported by this application.

categories: Option<Vec<String>>

Categories in which the entry should be shown in a menu (for possible values see the Desktop Menu Specification).

implements: Option<Vec<String>>

A list of interfaces that this application implements. By default, a desktop file implements no interfaces. See Interfaces for more information on how this works.

keywords: Option<LocaleStringList>

A list of strings which may be used in addition to other metadata to describe this entry. This can be useful e.g. to facilitate searching through entries. The values are not meant for display, and should not be redundant with the values of Name or GenericName.

startup_notify: Option<bool>

If true, it is KNOWN that the application will send a “remove” message when started with the DESKTOP_STARTUP_ID environment variable set. If false, it is KNOWN that the application does not work with startup notification at all (does not shown any window, breaks even when using StartupWMClass, etc.). If absent, a reasonable handling is up to implementations (assuming false, using StartupWMClass, etc.). (See the Startup Notification Protocol Specification for more details).

startup_wm_class: Option<String>

If specified, it is known that the application will map at least one window with the given string as its WM class or WM name hint (see the Startup Notification Protocol Specification for more details).

prefers_non_default_gpu: Option<bool>

If true, the application prefers to be run on a more powerful discrete GPU if available, which we describe as “a GPU other than the default one” in this spec to avoid the need to define what a discrete GPU is and in which cases it might be considered more powerful than the default GPU. This key is only a hint and support might not be present depending on the implementation.

single_main_window: Option<bool>

If true, the application has a single main window, and does not support having an additional one opened. This key is used to signal to the implementation to avoid offering a UI to launch another window of the app. This key is only a hint and support might not be present depending on the implementation.

Trait Implementations

impl Clone for ApplicationFields

fn clone(&self) -> ApplicationFields

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ApplicationFields

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

Formats the value using the given formatter.

impl Default for ApplicationFields

fn default() -> ApplicationFields

Returns the “default value” for a type.