ShellAppSystem: Shell Reference Manual

## ShellAppSystem ShellAppSystem |

## Functions

ShellAppSystem * | shell_app_system_get_default ()
ShellApp * | shell_app_system_lookup_app ()
ShellApp * | shell_app_system_lookup_heuristic_basename ()
ShellApp * | shell_app_system_lookup_startup_wmclass ()
ShellApp * | shell_app_system_lookup_desktop_wmclass ()
GSList * | shell_app_system_get_running ()

## Signals

void | app-state-changed | Run Last
void | installed-changed | Run Last

## Object Hierarchy

        GObject
        ╰── ShellAppSystem

## Description

## Functions

### shell_app_system_get_default ()

    ShellAppSystem *
    shell_app_system_get_default (void);

#### Returns

The global ShellAppSystem singleton.

[transfer none]

### shell_app_system_lookup_app ()

    ShellApp *
    shell_app_system_lookup_app (ShellAppSystem *system,
                                 const char *id);

Find a ShellApp corresponding to an id.

#### Returns

The ShellApp for id, or `NULL` if none.

[transfer none]

### shell_app_system_lookup_heuristic_basename ()

    ShellApp *
    shell_app_system_lookup_heuristic_basename
                                   (ShellAppSystem *system,
                                    const char *id);

Find a valid application corresponding to a given heuristically determined application identifier string, or `NULL` if none.

#### Parameters

system | a ShellAppSystem |
id | Probable application identifier |

#### Returns

A ShellApp for `name` .

[transfer none]

### shell_app_system_lookup_startup_wmclass ()

    ShellApp *
    shell_app_system_lookup_startup_wmclass
                                   (ShellAppSystem *system,
                                    const char *wmclass);

Find a valid application whose .desktop file contains a StartupWMClass entry matching `wmclass` .

#### Parameters

system | a ShellAppSystem |
wmclass | A WM_CLASS value. | [nullable]

#### Returns

A ShellApp for `wmclass` .

[transfer none]

### shell_app_system_lookup_desktop_wmclass ()

    ShellApp *
    shell_app_system_lookup_desktop_wmclass
                                   (ShellAppSystem *system,
                                    const char *wmclass);

Find a valid application whose .desktop file, without the extension and properly canonicalized, matches `wmclass` .

#### Parameters

system | a ShellAppSystem |
wmclass | A WM_CLASS value. | [nullable]

#### Returns

A ShellApp for `wmclass` .

[transfer none]

### shell_app_system_get_running ()

    GSList *
    shell_app_system_get_running (ShellAppSystem *self);

Returns the set of applications which currently have at least one open window in the given context. The returned list will be sorted by `shell_app_compare()`.

#### Parameters

self | A ShellAppSystem |

#### Returns

Active applications.

[element-type ShellApp][transfer container]

## Types and Values

## Signal Details

### The `“app-state-changed”` signal

    void
    user_function (ShellAppSystem *shellappsystem,
                   ShellApp       *arg1,
                   gpointer        user_data)

Flags: Run Last

### The `“installed-changed”` signal

    void
    user_function (ShellAppSystem *shellappsystem,
                   gpointer        user_data)

Flags: Run Last