### Class

# Shell App

#### Description [src]

    final class Shell.App : GObject.Object
    {
      /* No available fields */
    }

Object representing an application

This object wraps a `GDesktopAppInfo`, providing methods and signals primarily useful for running applications.

#### Ancestors

- GObject

#### Instance methods

###### shell_app_activate

Like shell_app_activate_full(), but using the default workspace and event timestamp.

###### shell_app_activate_action

This activates an action using ‘org.freedesktop.Application’ DBus interface.

###### shell_app_activate_action_finish

Finish the asynchronous operation started by `shell_app_activate_action()` and obtain its result.

###### shell_app_activate_full

Perform an appropriate default action for operating on this application, dependent on its current state. For example, if the application is not currently running, launch it. If it is running, activate the most recently used NORMAL window (or if that window has a transient, the most recently used transient for that window).

###### shell_app_activate_window

Bring all windows for the given app to the foreground, but ensure that `window` is on top. If `window` is `NULL`, the window with the most recent user time for the app will be used.

###### shell_app_can_open_new_window

Returns `TRUE` if the app supports opening a new window through `shell_app_open_new_window()` (ie, if calling that function will result in actually opening a new window and not something else, like presenting the most recently active one).

###### shell_app_compare

Compare one `ShellApp` instance to another, in the following way: - Running applications sort before not-running applications. - If one of them has non-minimized windows and the other does not, the one with visible windows is first. - Finally, the application which the user interacted with most recently compares earlier.

###### shell_app_compare_by_name

Order two applications by name.

###### shell_app_create_icon_texture

Look up the icon for this application, and create a `ClutterActor` for it at the given size.

###### shell_app_get_action_group

No description available.

###### shell_app_get_app_info

No description available.

###### shell_app_get_busy

No description available.

###### shell_app_get_description

No description available.

###### shell_app_get_icon

Look up the icon for this application.

###### shell_app_get_id

No description available.

###### shell_app_get_n_windows

No description available.

###### shell_app_get_name

No description available.

###### shell_app_get_pids

No description available.

###### shell_app_get_state

No description available.

###### shell_app_get_windows

Get the windows which are associated with this application. The returned list will be sorted first by whether they’re on the active workspace, then by whether they’re visible, and finally by the time the user last interacted with them.

###### shell_app_is_on_workspace

No description available.

###### shell_app_is_window_backed

A window backed application is one which represents just an open window, i.e. there’s no .desktop file association, so we don’t know how to launch it again.

###### shell_app_launch

No description available.

###### shell_app_launch_action

No description available.

###### shell_app_open_new_window

Request that the application create a new window.

###### shell_app_request_quit

Initiate an asynchronous request to quit this application. The application may interact with the user, and the user might cancel the quit request from the application UI.

###### shell_app_update_app_actions

No description available.

###### shell_app_update_window_actions

No description available.

##### Methods inherited from GObject (43)

Please see GObject for a full list of methods.

#### Properties

###### Shell.App:action-group

The `GDBusActionGroup` associated with this ShellApp, if any. See the documentation of `GApplication` and `GActionGroup` for details.

###### Shell.App:app-info

The `GDesktopAppInfo` associated with this ShellApp, if any.

###### Shell.App:busy

Whether the application has marked itself as busy.

###### Shell.App:icon

The `GIcon` representing this ShellApp.

###### Shell.App:id

The id of this application (a desktop filename, or a special string like window:0xabcd1234).

###### Shell.App:state

The high-level state of the application, effectively whether it’s running or not, or transitioning between those states.

#### Signals

###### Shell.App::windows-changed

No description available.

##### Signals inherited from GObject (1)

###### GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

#### Class structure

    struct ShellAppClass {
      GObjectClass parent_class;

    }

No description available.

###### Class members

`parent_class: GObjectClass`

  No description available.