shell_app_get_id ()

const char *
shell_app_get_id (ShellApp *app);

shell_app_get_app_info ()

GDesktopAppInfo *
shell_app_get_app_info (ShellApp *app);

shell_app_create_icon_texture ()

ClutterActor *
shell_app_create_icon_texture (ShellApp *app,
                               int size);

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

shell_app_get_name ()

const char *
shell_app_get_name (ShellApp *app);

shell_app_get_description ()

const char *
shell_app_get_description (ShellApp *app);

shell_app_is_window_backed ()

gboolean
shell_app_is_window_backed (ShellApp *app);

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

shell_app_activate_window ()

void
shell_app_activate_window (ShellApp *app,
                           MetaWindow *window,
                           guint32 timestamp);

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.

This function has no effect if app is not currently running.

shell_app_activate ()

void
shell_app_activate (ShellApp *app);

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

shell_app_activate_full ()

void
shell_app_activate_full (ShellApp *app,
                         int workspace,
                         guint32 timestamp);

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_open_new_window ()

void
shell_app_open_new_window (ShellApp *app,
                           int workspace);

Request that the application create a new window.

shell_app_can_open_new_window ()

gboolean
shell_app_can_open_new_window (ShellApp *app);

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_get_state ()

ShellAppState
shell_app_get_state (ShellApp *app);

shell_app_request_quit ()

gboolean
shell_app_request_quit (ShellApp *app);

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.

This operation may not be supported for all applications.

shell_app_get_n_windows ()

guint
shell_app_get_n_windows (ShellApp *app);

shell_app_get_windows ()

GSList *
shell_app_get_windows (ShellApp *app);

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_get_pids ()

GSList *
shell_app_get_pids (ShellApp *app);

shell_app_is_on_workspace ()

gboolean
shell_app_is_on_workspace (ShellApp *app,
                           MetaWorkspace *workspace);

shell_app_launch ()

gboolean
shell_app_launch (ShellApp *app,
                  guint timestamp,
                  int workspace,
                  gboolean discrete_gpu,
                  GError **error);

shell_app_launch_action ()

void
shell_app_launch_action (ShellApp *app,
                         const char *action_name,
                         guint timestamp,
                         int workspace);

shell_app_compare_by_name ()

int
shell_app_compare_by_name (ShellApp *app,
                           ShellApp *other);

Order two applications by name.

shell_app_compare ()

int
shell_app_compare (ShellApp *app,
                   ShellApp *other);

Compare one ShellApp instance to another, in the following way:

shell_app_update_window_actions ()

void
shell_app_update_window_actions (ShellApp *app,
                                 MetaWindow *window);

shell_app_update_app_menu ()

void
shell_app_update_app_menu (ShellApp *app,
                           MetaWindow *window);

shell_app_get_busy ()

gboolean
shell_app_get_busy (ShellApp *app);

SHELL_TYPE_APP

#define SHELL_TYPE_APP (shell_app_get_type ())

enum ShellAppState

ShellApp

typedef struct _ShellApp ShellApp;

The “action-group” property

  “action-group”             GActionGroup *

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

Flags: Read

The “app-info” property

  “app-info”                 GDesktopAppInfo *

The GDesktopAppInfo associated with this ShellApp, if any.

Flags: Read / Write / Construct Only

The “busy” property

  “busy”                     gboolean

Whether the application has marked itself as busy.

Flags: Read

Default value: FALSE

The “id” property

  “id”                       gchar *

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

Flags: Read

Default value: NULL

The “menu” property

  “menu”                     GMenuModel *

The GMenuProxy associated with this ShellApp, if any. See the documentation of GMenuModel for details.

Flags: Read

The “state” property

  “state”                    ShellAppState

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

Flags: Read

Default value: SHELL_APP_STATE_STOPPED

The “windows-changed” signal

void
user_function (ShellApp *shellapp,
               gpointer  user_data)

Flags: Run Last