![]() |
![]() |
![]() |
Cinnamon Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Signals |
struct CinnamonAppSystem; struct CinnamonAppSystemClass; CinnamonAppSystem * cinnamon_app_system_get_default (void
); GMenuTree * cinnamon_app_system_get_tree (CinnamonAppSystem *system
); CinnamonApp * cinnamon_app_system_lookup_app (CinnamonAppSystem *system
,const char *id
); CinnamonApp * cinnamon_app_system_lookup_settings_app (CinnamonAppSystem *system
,const char *id
); CinnamonApp * cinnamon_app_system_lookup_app_by_tree_entry (CinnamonAppSystem *system
,GMenuTreeEntry *entry
); CinnamonApp * cinnamon_app_system_lookup_settings_app_by_tree_entry (CinnamonAppSystem *system
,GMenuTreeEntry *entry
); CinnamonApp * cinnamon_app_system_lookup_app_for_path (CinnamonAppSystem *system
,const char *desktop_path
); CinnamonApp * cinnamon_app_system_lookup_heuristic_basename (CinnamonAppSystem *system
,const char *id
); CinnamonApp * cinnamon_app_system_lookup_startup_wmclass (CinnamonAppSystem *system
,const char *wmclass
); CinnamonApp * cinnamon_app_system_lookup_desktop_wmclass (CinnamonAppSystem *system
,const char *wmclass
); GSList * cinnamon_app_system_get_all (CinnamonAppSystem *system
); GSList * cinnamon_app_system_get_running (CinnamonAppSystem *self
); GSList * cinnamon_app_system_initial_search (CinnamonAppSystem *system
,GSList *terms
); GSList * cinnamon_app_system_subsearch (CinnamonAppSystem *system
,GSList *previous_results
,GSList *terms
); GMenuTree * cinnamon_app_system_get_settings_tree (CinnamonAppSystem *system
); GSList * cinnamon_app_system_search_settings (CinnamonAppSystem *system
,GSList *terms
); CinnamonApp * cinnamon_app_system_lookup_setting (CinnamonAppSystem *system
,const char *id
);
struct CinnamonAppSystemClass { GObjectClass parent_class; void (*installed_changed)(CinnamonAppSystem *appsys, gpointer user_data); void (*favorites_changed)(CinnamonAppSystem *appsys, gpointer user_data); };
CinnamonAppSystem * cinnamon_app_system_get_default (void
);
Returns : |
The global CinnamonAppSystem singleton. [transfer none] |
GMenuTree * cinnamon_app_system_get_tree (CinnamonAppSystem *system
);
Returns : |
The GMenuTree for apps. [transfer none] |
CinnamonApp * cinnamon_app_system_lookup_app (CinnamonAppSystem *system
,const char *id
);
Find a CinnamonApp corresponding to an id.
Returns : |
The CinnamonApp for id, or NULL if none. [transfer none]
|
CinnamonApp * cinnamon_app_system_lookup_settings_app (CinnamonAppSystem *system
,const char *id
);
Returns : |
The CinnamonApp for id, or NULL if none
OBSOLETE - ONLY LEFT IN FOR COMPATIBILITY
RETURNS NULL. [transfer none]
|
CinnamonApp * cinnamon_app_system_lookup_app_by_tree_entry (CinnamonAppSystem *system
,GMenuTreeEntry *entry
);
Find a CinnamonApp corresponding to a GMenuTreeEntry.
|
a CinnamonAppSystem |
|
a GMenuTreeEntry |
Returns : |
The CinnamonApp for entry , or NULL if none. [transfer none]
|
CinnamonApp * cinnamon_app_system_lookup_settings_app_by_tree_entry (CinnamonAppSystem *system
,GMenuTreeEntry *entry
);
Returns : |
The CinnamonApp for entry , or NULL if none
OBSOLETE - ONLY LEFT IN FOR COMPATIBILITY
RETURNS NULL. [transfer none]
|
CinnamonApp * cinnamon_app_system_lookup_app_for_path (CinnamonAppSystem *system
,const char *desktop_path
);
Find or create a CinnamonApp corresponding to a given absolute file
name which must be in the standard paths (XDG_DATA_DIRS). For
files outside the datadirs, this function returns NULL
.
|
a CinnamonAppSystem |
|
UTF-8 encoded absolute file name. [type utf8] |
Returns : |
The CinnamonApp for id, or NULL if none. [transfer none]
|
CinnamonApp * cinnamon_app_system_lookup_heuristic_basename (CinnamonAppSystem *system
,const char *id
);
Find a valid application corresponding to a given
heuristically determined application identifier
string, or NULL
if none.
|
a CinnamonAppSystem |
|
Probable application identifier |
Returns : |
A CinnamonApp for name . [transfer none]
|
CinnamonApp * cinnamon_app_system_lookup_startup_wmclass (CinnamonAppSystem *system
,const char *wmclass
);
Find a valid application whose .desktop file contains a
StartupWMClass entry matching wmclass
.
|
a CinnamonAppSystem |
|
A WM_CLASS value. [allow-none] |
Returns : |
A CinnamonApp for wmclass . [transfer none]
|
CinnamonApp * cinnamon_app_system_lookup_desktop_wmclass (CinnamonAppSystem *system
,const char *wmclass
);
Find a valid application whose .desktop file, without the extension
and properly canonicalized, matches wmclass
.
|
a CinnamonAppSystem |
|
A WM_CLASS value. [allow-none] |
Returns : |
A CinnamonApp for wmclass . [transfer none]
|
GSList * cinnamon_app_system_get_all (CinnamonAppSystem *system
);
Returns : |
All installed applications. [transfer container][element-type CinnamonApp] |
GSList * cinnamon_app_system_get_running (CinnamonAppSystem *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 cinnamon_app_compare()
.
|
A CinnamonAppSystem |
Returns : |
Active applications. [element-type CinnamonApp][transfer container] |
GSList * cinnamon_app_system_initial_search (CinnamonAppSystem *system
,GSList *terms
);
Search through applications for the given search terms.
|
A CinnamonAppSystem |
|
List of terms, logical AND. [element-type utf8] |
Returns : |
List of applications. [transfer container][element-type CinnamonApp] |
GSList * cinnamon_app_system_subsearch (CinnamonAppSystem *system
,GSList *previous_results
,GSList *terms
);
Search through a previous result set; for more information, see
js/ui/search.js. Note the value of prefs
must be
the same as passed to cinnamon_app_system_initial_search()
. Note that returned
strings are only valid until a return to the main loop.
|
A CinnamonAppSystem |
|
List of previous results. [element-type CinnamonApp] |
|
List of terms, logical AND. [element-type utf8] |
Returns : |
List of application identifiers. [transfer container][element-type CinnamonApp] |
GMenuTree * cinnamon_app_system_get_settings_tree
(CinnamonAppSystem *system
);
Returns : |
The GMenuTree for apps OBSOLETE - ONLY LEFT IN FOR COMPATIBILITY RETURNS EMPTY GMenuTree. [transfer none] |
GSList * cinnamon_app_system_search_settings (CinnamonAppSystem *system
,GSList *terms
);
Search through settings for the given search terms.
|
A CinnamonAppSystem |
|
List of terms, logical AND. [element-type utf8] |
Returns : |
List of setting applications. [transfer container][element-type CinnamonApp] |
CinnamonApp * cinnamon_app_system_lookup_setting (CinnamonAppSystem *system
,const char *id
);
Returns : |
Application in gnomecc.menu, or NULL if none
OBSOLETE - ONLY LEFT IN FOR COMPATIBILITY
RETURNS NULL IF NOT FOUND IN STANDARD APPS. [transfer none]
|
"app-state-changed"
signalvoid user_function (CinnamonAppSystem *cinnamonappsystem,
CinnamonApp *arg1,
gpointer user_data) : Run Last
"installed-changed"
signalvoid user_function (CinnamonAppSystem *cinnamonappsystem,
gpointer user_data) : Run Last