|
mate-desktop 1.29.2
Library with common API for various MATE modules
|
#include <glib.h>#include <glib-object.h>#include <gdk/gdk.h>#include <gtk/gtk.h>Macros | |
| #define | MATE_TYPE_DESKTOP_ITEM (mate_desktop_item_get_type ()) |
| #define | MATE_DESKTOP_ITEM_ENCODING "Encoding" /* string */ |
| #define | MATE_DESKTOP_ITEM_VERSION "Version" /* numeric */ |
| #define | MATE_DESKTOP_ITEM_NAME "Name" /* localestring */ |
| #define | MATE_DESKTOP_ITEM_GENERIC_NAME "GenericName" /* localestring */ |
| #define | MATE_DESKTOP_ITEM_TYPE "Type" /* string */ |
| #define | MATE_DESKTOP_ITEM_FILE_PATTERN "FilePattern" /* regexp(s) */ |
| #define | MATE_DESKTOP_ITEM_TRY_EXEC "TryExec" /* string */ |
| #define | MATE_DESKTOP_ITEM_NO_DISPLAY "NoDisplay" /* boolean */ |
| #define | MATE_DESKTOP_ITEM_COMMENT "Comment" /* localestring */ |
| #define | MATE_DESKTOP_ITEM_EXEC "Exec" /* string */ |
| #define | MATE_DESKTOP_ITEM_ACTIONS "Actions" /* strings */ |
| #define | MATE_DESKTOP_ITEM_ICON "Icon" /* string */ |
| #define | MATE_DESKTOP_ITEM_MINI_ICON "MiniIcon" /* string */ |
| #define | MATE_DESKTOP_ITEM_HIDDEN "Hidden" /* boolean */ |
| #define | MATE_DESKTOP_ITEM_PATH "Path" /* string */ |
| #define | MATE_DESKTOP_ITEM_TERMINAL "Terminal" /* boolean */ |
| #define | MATE_DESKTOP_ITEM_TERMINAL_OPTIONS "TerminalOptions" /* string */ |
| #define | MATE_DESKTOP_ITEM_SWALLOW_TITLE "SwallowTitle" /* string */ |
| #define | MATE_DESKTOP_ITEM_SWALLOW_EXEC "SwallowExec" /* string */ |
| #define | MATE_DESKTOP_ITEM_MIME_TYPE "MimeType" /* regexp(s) */ |
| #define | MATE_DESKTOP_ITEM_PATTERNS "Patterns" /* regexp(s) */ |
| #define | MATE_DESKTOP_ITEM_DEFAULT_APP "DefaultApp" /* string */ |
| #define | MATE_DESKTOP_ITEM_DEV "Dev" /* string */ |
| #define | MATE_DESKTOP_ITEM_FS_TYPE "FSType" /* string */ |
| #define | MATE_DESKTOP_ITEM_MOUNT_POINT "MountPoint" /* string */ |
| #define | MATE_DESKTOP_ITEM_READ_ONLY "ReadOnly" /* boolean */ |
| #define | MATE_DESKTOP_ITEM_UNMOUNT_ICON "UnmountIcon" /* string */ |
| #define | MATE_DESKTOP_ITEM_SORT_ORDER "SortOrder" /* strings */ |
| #define | MATE_DESKTOP_ITEM_URL "URL" /* string */ |
| #define | MATE_DESKTOP_ITEM_DOC_PATH "X-MATE-DocPath" /* string */ |
| #define | MATE_DESKTOP_ITEM_CATEGORIES "Categories" /* string */ |
| #define | MATE_DESKTOP_ITEM_ONLY_SHOW_IN "OnlyShowIn" /* string */ |
| #define | MATE_DESKTOP_ITEM_ERROR mate_desktop_item_error_quark () |
| #define | mate_desktop_item_clear_attr(item, attr) mate_desktop_item_set_string(item,attr,NULL) |
Typedefs | |
| typedef struct _MateDesktopItem | MateDesktopItem |
Functions | |
| GType | mate_desktop_item_get_type (void) |
| GQuark | mate_desktop_item_error_quark (void) |
| MateDesktopItem * | mate_desktop_item_new (void) |
| mate_desktop_item_new: | |
| MateDesktopItem * | mate_desktop_item_new_from_file (const char *file, MateDesktopItemLoadFlags flags, GError **error) |
| MateDesktopItem * | mate_desktop_item_new_from_uri (const char *uri, MateDesktopItemLoadFlags flags, GError **error) |
| mate_desktop_item_new_from_uri: @uri: URI to load the MateDesktopItem from @flags: Flags to influence the loading process | |
| MateDesktopItem * | mate_desktop_item_new_from_string (const char *uri, const char *string, gssize length, MateDesktopItemLoadFlags flags, GError **error) |
| mate_desktop_item_new_from_string: @string: string to load the MateDesktopItem from @length: length of string, or -1 to use strlen @flags: Flags to influence the loading process @error: place to put errors | |
| MateDesktopItem * | mate_desktop_item_new_from_basename (const char *basename, MateDesktopItemLoadFlags flags, GError **error) |
| mate_desktop_item_new_from_basename: @basename: The basename of the MateDesktopItem to load. | |
| MateDesktopItem * | mate_desktop_item_copy (const MateDesktopItem *item) |
| mate_desktop_item_copy: @item: The item to be copied | |
| gboolean | mate_desktop_item_save (MateDesktopItem *item, const char *under, gboolean force, GError **error) |
| mate_desktop_item_save: @item: A desktop item @under: A new uri (location) for this MateDesktopItem @force: Save even if it wasn't modified @error: #GError return | |
| MateDesktopItem * | mate_desktop_item_ref (MateDesktopItem *item) |
| mate_desktop_item_ref: @item: A desktop item | |
| void | mate_desktop_item_unref (MateDesktopItem *item) |
| mate_desktop_item_unref: @item: A desktop item | |
| int | mate_desktop_item_launch (const MateDesktopItem *item, GList *file_list, MateDesktopItemLaunchFlags flags, GError **error) |
| mate_desktop_item_launch: @item: A desktop item @file_list: Files/URIs to launch this item with, can be NULL @flags: FIXME @error: FIXME | |
| int | mate_desktop_item_launch_with_env (const MateDesktopItem *item, GList *file_list, MateDesktopItemLaunchFlags flags, char **envp, GError **error) |
| mate_desktop_item_launch_with_env: @item: A desktop item @file_list: Files/URIs to launch this item with, can be NULL @flags: FIXME @envp: child's environment, or NULL to inherit parent's @error: FIXME | |
| int | mate_desktop_item_launch_on_screen (const MateDesktopItem *item, GList *file_list, MateDesktopItemLaunchFlags flags, GdkScreen *screen, int workspace, GError **error) |
| mate_desktop_item_launch_on_screen: @item: A desktop item @file_list: Files/URIs to launch this item with, can be NULL @flags: FIXME @screen: the GdkScreen on which the application should be launched @workspace: the workspace on which the app should be launched (-1 for current) @error: FIXME | |
| int | mate_desktop_item_drop_uri_list (const MateDesktopItem *item, const char *uri_list, MateDesktopItemLaunchFlags flags, GError **error) |
| mate_desktop_item_drop_uri_list: @item: A desktop item @uri_list: text as gotten from a text/uri-list @flags: FIXME @error: FIXME | |
| int | mate_desktop_item_drop_uri_list_with_env (const MateDesktopItem *item, const char *uri_list, MateDesktopItemLaunchFlags flags, char **envp, GError **error) |
| mate_desktop_item_drop_uri_list_with_env: @item: A desktop item @uri_list: text as gotten from a text/uri-list @flags: FIXME @envp: child's environment @error: FIXME | |
| gboolean | mate_desktop_item_exists (const MateDesktopItem *item) |
| mate_desktop_item_exists: @item: A desktop item | |
| MateDesktopItemType | mate_desktop_item_get_entry_type (const MateDesktopItem *item) |
| mate_desktop_item_get_entry_type: @item: A desktop item | |
| void | mate_desktop_item_set_entry_type (MateDesktopItem *item, MateDesktopItemType type) |
| const char * | mate_desktop_item_get_location (const MateDesktopItem *item) |
| mate_desktop_item_get_location: @item: A desktop item | |
| void | mate_desktop_item_set_location (MateDesktopItem *item, const char *location) |
| mate_desktop_item_set_location: @item: A desktop item @location: A uri string specifying the file location of this particular item. | |
| void | mate_desktop_item_set_location_file (MateDesktopItem *item, const char *file) |
| MateDesktopItemStatus | mate_desktop_item_get_file_status (const MateDesktopItem *item) |
| mate_desktop_item_get_file_status: @item: A desktop item | |
| char * | mate_desktop_item_get_icon (const MateDesktopItem *item, GtkIconTheme *icon_theme) |
| mate_desktop_item_get_icon: @icon_theme: a #GtkIconTheme @item: A desktop item | |
| char * | mate_desktop_item_find_icon (GtkIconTheme *icon_theme, const char *icon, int desired_size, int flags) |
| mate_desktop_item_find_icon: @icon_theme: a #GtkIconTheme @icon: icon name, something you'd get out of the Icon key @desired_size: FIXME @flags: FIXME | |
| gboolean | mate_desktop_item_attr_exists (const MateDesktopItem *item, const char *attr) |
| const char * | mate_desktop_item_get_string (const MateDesktopItem *item, const char *attr) |
| void | mate_desktop_item_set_string (MateDesktopItem *item, const char *attr, const char *value) |
| const char * | mate_desktop_item_get_attr_locale (const MateDesktopItem *item, const char *attr) |
| mate_desktop_item_get_string_locale: @item: A desktop item @attr: An attribute name | |
| const char * | mate_desktop_item_get_localestring (const MateDesktopItem *item, const char *attr) |
| const char * | mate_desktop_item_get_localestring_lang (const MateDesktopItem *item, const char *attr, const char *language) |
| GList * | mate_desktop_item_get_languages (const MateDesktopItem *item, const char *attr) |
| void | mate_desktop_item_set_localestring (MateDesktopItem *item, const char *attr, const char *value) |
| void | mate_desktop_item_set_localestring_lang (MateDesktopItem *item, const char *attr, const char *language, const char *value) |
| void | mate_desktop_item_clear_localestring (MateDesktopItem *item, const char *attr) |
| char ** | mate_desktop_item_get_strings (const MateDesktopItem *item, const char *attr) |
| void | mate_desktop_item_set_strings (MateDesktopItem *item, const char *attr, char **strings) |
| gboolean | mate_desktop_item_get_boolean (const MateDesktopItem *item, const char *attr) |
| void | mate_desktop_item_set_boolean (MateDesktopItem *item, const char *attr, gboolean value) |
| void | mate_desktop_item_set_launch_time (MateDesktopItem *item, guint32 timestamp) |
| void | mate_desktop_item_clear_section (MateDesktopItem *item, const char *section) |
| #define MATE_DESKTOP_ITEM_ACTIONS "Actions" /* strings */ |
| #define MATE_DESKTOP_ITEM_CATEGORIES "Categories" /* string */ |
| #define mate_desktop_item_clear_attr | ( | item, | |
| attr | |||
| ) | mate_desktop_item_set_string(item,attr,NULL) |
| #define MATE_DESKTOP_ITEM_COMMENT "Comment" /* localestring */ |
| #define MATE_DESKTOP_ITEM_DEFAULT_APP "DefaultApp" /* string */ |
| #define MATE_DESKTOP_ITEM_DEV "Dev" /* string */ |
| #define MATE_DESKTOP_ITEM_DOC_PATH "X-MATE-DocPath" /* string */ |
| #define MATE_DESKTOP_ITEM_ENCODING "Encoding" /* string */ |
| #define MATE_DESKTOP_ITEM_ERROR mate_desktop_item_error_quark () |
| #define MATE_DESKTOP_ITEM_EXEC "Exec" /* string */ |
| #define MATE_DESKTOP_ITEM_FILE_PATTERN "FilePattern" /* regexp(s) */ |
| #define MATE_DESKTOP_ITEM_FS_TYPE "FSType" /* string */ |
| #define MATE_DESKTOP_ITEM_GENERIC_NAME "GenericName" /* localestring */ |
| #define MATE_DESKTOP_ITEM_HIDDEN "Hidden" /* boolean */ |
| #define MATE_DESKTOP_ITEM_ICON "Icon" /* string */ |
| #define MATE_DESKTOP_ITEM_MIME_TYPE "MimeType" /* regexp(s) */ |
| #define MATE_DESKTOP_ITEM_MINI_ICON "MiniIcon" /* string */ |
| #define MATE_DESKTOP_ITEM_MOUNT_POINT "MountPoint" /* string */ |
| #define MATE_DESKTOP_ITEM_NAME "Name" /* localestring */ |
| #define MATE_DESKTOP_ITEM_NO_DISPLAY "NoDisplay" /* boolean */ |
| #define MATE_DESKTOP_ITEM_ONLY_SHOW_IN "OnlyShowIn" /* string */ |
| #define MATE_DESKTOP_ITEM_PATH "Path" /* string */ |
| #define MATE_DESKTOP_ITEM_PATTERNS "Patterns" /* regexp(s) */ |
| #define MATE_DESKTOP_ITEM_READ_ONLY "ReadOnly" /* boolean */ |
| #define MATE_DESKTOP_ITEM_SORT_ORDER "SortOrder" /* strings */ |
| #define MATE_DESKTOP_ITEM_SWALLOW_EXEC "SwallowExec" /* string */ |
| #define MATE_DESKTOP_ITEM_SWALLOW_TITLE "SwallowTitle" /* string */ |
| #define MATE_DESKTOP_ITEM_TERMINAL "Terminal" /* boolean */ |
| #define MATE_DESKTOP_ITEM_TERMINAL_OPTIONS "TerminalOptions" /* string */ |
| #define MATE_DESKTOP_ITEM_TRY_EXEC "TryExec" /* string */ |
| #define MATE_DESKTOP_ITEM_TYPE "Type" /* string */ |
| #define MATE_DESKTOP_ITEM_UNMOUNT_ICON "UnmountIcon" /* string */ |
| #define MATE_DESKTOP_ITEM_URL "URL" /* string */ |
| #define MATE_DESKTOP_ITEM_VERSION "Version" /* numeric */ |
| #define MATE_TYPE_DESKTOP_ITEM (mate_desktop_item_get_type ()) |
| typedef struct _MateDesktopItem MateDesktopItem |
| enum MateDesktopItemError |
| enum MateDesktopItemType |
| gboolean mate_desktop_item_attr_exists | ( | const MateDesktopItem * | item, |
| const char * | attr | ||
| ) |
| void mate_desktop_item_clear_localestring | ( | MateDesktopItem * | item, |
| const char * | attr | ||
| ) |
References _MateDesktopItem::languages, _MateDesktopItem::refcount, set(), and set_locale().
| void mate_desktop_item_clear_section | ( | MateDesktopItem * | item, |
| const char * | section | ||
| ) |
References find_section(), _MateDesktopItem::keys, Section::keys, _MateDesktopItem::main_hash, _MateDesktopItem::modified, Section::name, and _MateDesktopItem::refcount.
| MateDesktopItem * mate_desktop_item_copy | ( | const MateDesktopItem * | item | ) |
mate_desktop_item_copy: @item: The item to be copied
Creates a copy of a MateDesktopItem. The new copy has a refcount of 1. Note: Section stack is NOT copied.
Returns: The new copy
References copy_string_hash(), dup_section(), _MateDesktopItem::keys, _MateDesktopItem::languages, _MateDesktopItem::launch_time, _MateDesktopItem::location, _MateDesktopItem::main_hash, mate_desktop_item_new(), _MateDesktopItem::modified, _MateDesktopItem::mtime, _MateDesktopItem::refcount, _MateDesktopItem::sections, and _MateDesktopItem::type.
Referenced by _mate_desktop_item_copy().
| int mate_desktop_item_drop_uri_list | ( | const MateDesktopItem * | item, |
| const char * | uri_list, | ||
| MateDesktopItemLaunchFlags | flags, | ||
| GError ** | error | ||
| ) |
mate_desktop_item_drop_uri_list: @item: A desktop item @uri_list: text as gotten from a text/uri-list @flags: FIXME @error: FIXME
A list of files or urls dropped onto an icon, the proper (Url or File) exec is run you can pass directly string that you got as the text/uri-list. This just parses the list and calls
Returns: The value returned by #mate_execute_async() upon execution of the specified item or -1 on error. If multiple instances are run, the return of the last one is returned.
References mate_desktop_item_drop_uri_list_with_env().
| int mate_desktop_item_drop_uri_list_with_env | ( | const MateDesktopItem * | item, |
| const char * | uri_list, | ||
| MateDesktopItemLaunchFlags | flags, | ||
| char ** | envp, | ||
| GError ** | error | ||
| ) |
mate_desktop_item_drop_uri_list_with_env: @item: A desktop item @uri_list: text as gotten from a text/uri-list @flags: FIXME @envp: child's environment @error: FIXME
See mate_desktop_item_drop_uri_list for a full description. This function additionally passes an environment vector for the child process which is to be launched.
Returns: The value returned by #mate_execute_async() upon execution of the specified item or -1 on error. If multiple instances are run, the return of the last one is returned.
References mate_desktop_item_launch_with_env().
Referenced by mate_desktop_item_drop_uri_list().
| GQuark mate_desktop_item_error_quark | ( | void | ) |
| gboolean mate_desktop_item_exists | ( | const MateDesktopItem * | item | ) |
mate_desktop_item_exists: @item: A desktop item
Attempt to figure out if the program that can be executed by this item actually exists. First it tries the TryExec attribute to see if that contains a program that is in the path. Then if there is no such attribute, it tries the first word of the Exec attribute.
Returns: A boolean, TRUE if it exists, FALSE otherwise.
References exec_exists(), lookup(), MATE_DESKTOP_ITEM_EXEC, MATE_DESKTOP_ITEM_TRY_EXEC, MATE_DESKTOP_ITEM_TYPE_APPLICATION, and _MateDesktopItem::type.
Referenced by mate_desktop_item_new_from_gfile().
| char * mate_desktop_item_find_icon | ( | GtkIconTheme * | icon_theme, |
| const char * | icon, | ||
| int | desired_size, | ||
| int | flags | ||
| ) |
mate_desktop_item_find_icon: @icon_theme: a #GtkIconTheme @icon: icon name, something you'd get out of the Icon key @desired_size: FIXME @flags: FIXME
Description: This function goes and looks for the icon file. If the icon is not an absolute filename, this will look for it in the standard places. If it can't find the icon, it will return NULL
Returns: A newly allocated string
Referenced by mate_desktop_item_get_icon().
| const char * mate_desktop_item_get_attr_locale | ( | const MateDesktopItem * | item, |
| const char * | attr | ||
| ) |
mate_desktop_item_get_string_locale: @item: A desktop item @attr: An attribute name
Returns the current locale that is used for the given attribute. This might not be the same for all attributes. For example, if your locale is "en_US.ISO8859-1" but attribute FOO only has "en_US" then that would be returned for attr = "FOO". If attribute BAR has "en_US.ISO8859-1" then that would be returned for "BAR".
Returns: a string equal to the current locale or NULL if the attribute is invalid or there is no matching locale.
References lookup_locale().
| gboolean mate_desktop_item_get_boolean | ( | const MateDesktopItem * | item, |
| const char * | attr | ||
| ) |
References lookup(), and _MateDesktopItem::refcount.
Referenced by ditem_execute().
| MateDesktopItemType mate_desktop_item_get_entry_type | ( | const MateDesktopItem * | item | ) |
mate_desktop_item_get_entry_type: @item: A desktop item
Gets the type attribute (the 'Type' field) of the item. This should usually be 'Application' for an application, but it can be 'Directory' for a directory description. There are other types available as well. The type usually indicates how the desktop item should be handeled and how the 'Exec' field should be handeled.
Returns: The type of the specified 'item'. The returned memory remains owned by the MateDesktopItem and should not be freed.
References _MateDesktopItem::refcount, and _MateDesktopItem::type.
Referenced by test_ditem().
| MateDesktopItemStatus mate_desktop_item_get_file_status | ( | const MateDesktopItem * | item | ) |
mate_desktop_item_get_file_status: @item: A desktop item
This function checks the modification time of the on-disk file to see if it is more recent than the in-memory data.
Returns: An enum value that specifies whether the item has changed since being loaded.
References _MateDesktopItem::location, MATE_DESKTOP_ITEM_CHANGED, MATE_DESKTOP_ITEM_DISAPPEARED, MATE_DESKTOP_ITEM_UNCHANGED, _MateDesktopItem::mtime, and _MateDesktopItem::refcount.
| char * mate_desktop_item_get_icon | ( | const MateDesktopItem * | item, |
| GtkIconTheme * | icon_theme | ||
| ) |
mate_desktop_item_get_icon: @icon_theme: a #GtkIconTheme @item: A desktop item
Description: This function goes and looks for the icon file. If the icon is not set as an absolute filename, this will look for it in the standard places. If it can't find the icon, it will return NULL
Returns: A newly allocated string
References mate_desktop_item_find_icon(), mate_desktop_item_get_string(), MATE_DESKTOP_ITEM_ICON, and _MateDesktopItem::refcount.
| GList * mate_desktop_item_get_languages | ( | const MateDesktopItem * | item, |
| const char * | attr | ||
| ) |
References _MateDesktopItem::languages, lookup_locale(), and _MateDesktopItem::refcount.
| const char * mate_desktop_item_get_localestring | ( | const MateDesktopItem * | item, |
| const char * | attr | ||
| ) |
References lookup_best_locale(), and _MateDesktopItem::refcount.
Referenced by ditem_execute(), do_percent_subst(), and test_ditem().
| const char * mate_desktop_item_get_localestring_lang | ( | const MateDesktopItem * | item, |
| const char * | attr, | ||
| const char * | language | ||
| ) |
References lookup_locale(), and _MateDesktopItem::refcount.
Referenced by test_ditem().
| const char * mate_desktop_item_get_location | ( | const MateDesktopItem * | item | ) |
mate_desktop_item_get_location: @item: A desktop item
Returns: The file location associated with 'item'.
References _MateDesktopItem::location, and _MateDesktopItem::refcount.
Referenced by test_ditem().
| const char * mate_desktop_item_get_string | ( | const MateDesktopItem * | item, |
| const char * | attr | ||
| ) |
References lookup(), and _MateDesktopItem::refcount.
Referenced by ditem_execute(), do_percent_subst(), mate_desktop_item_get_icon(), mate_desktop_item_launch_on_screen_with_env(), and test_ditem().
| char ** mate_desktop_item_get_strings | ( | const MateDesktopItem * | item, |
| const char * | attr | ||
| ) |
| GType mate_desktop_item_get_type | ( | void | ) |
References _mate_desktop_item_copy(), and _mate_desktop_item_free().
| int mate_desktop_item_launch | ( | const MateDesktopItem * | item, |
| GList * | file_list, | ||
| MateDesktopItemLaunchFlags | flags, | ||
| GError ** | error | ||
| ) |
mate_desktop_item_launch: @item: A desktop item @file_list: Files/URIs to launch this item with, can be NULL @flags: FIXME @error: FIXME
This function runs the program listed in the specified 'item', optionally appending additional arguments to its command line. It uses #g_shell_parse_argv to parse the the exec string into a vector which is then passed to #g_spawn_async for execution. This can return all the errors from MateURL, #g_shell_parse_argv and #g_spawn_async, in addition to it's own. The files are only added if the entry defines one of the standard % strings in it's Exec field.
Returns: The the pid of the process spawned. If more then one process was spawned the last pid is returned. On error -1 is returned and @error is set.
References mate_desktop_item_launch_on_screen_with_env().
Referenced by launch_item().
| int mate_desktop_item_launch_on_screen | ( | const MateDesktopItem * | item, |
| GList * | file_list, | ||
| MateDesktopItemLaunchFlags | flags, | ||
| GdkScreen * | screen, | ||
| int | workspace, | ||
| GError ** | error | ||
| ) |
mate_desktop_item_launch_on_screen: @item: A desktop item @file_list: Files/URIs to launch this item with, can be NULL @flags: FIXME @screen: the GdkScreen on which the application should be launched @workspace: the workspace on which the app should be launched (-1 for current) @error: FIXME
See mate_desktop_item_launch for a full description. This function additionally attempts to launch the application on a given screen and workspace.
Returns: The the pid of the process spawned. If more then one process was spawned the last pid is returned. On error -1 is returned and @error is set.
References mate_desktop_item_launch_on_screen_with_env().
| int mate_desktop_item_launch_with_env | ( | const MateDesktopItem * | item, |
| GList * | file_list, | ||
| MateDesktopItemLaunchFlags | flags, | ||
| char ** | envp, | ||
| GError ** | error | ||
| ) |
mate_desktop_item_launch_with_env: @item: A desktop item @file_list: Files/URIs to launch this item with, can be NULL @flags: FIXME @envp: child's environment, or NULL to inherit parent's @error: FIXME
See mate_desktop_item_launch for a full description. This function additionally passes an environment vector for the child process which is to be launched.
Returns: The the pid of the process spawned. If more then one process was spawned the last pid is returned. On error -1 is returned and @error is set.
References mate_desktop_item_launch_on_screen_with_env().
Referenced by mate_desktop_item_drop_uri_list_with_env().
| MateDesktopItem * mate_desktop_item_new | ( | void | ) |
mate_desktop_item_new:
Creates a MateDesktopItem object. The reference count on the returned value is set to '1'.
Returns: The new MateDesktopItem
References _mate_desktop_init_i18n(), _MateDesktopItem::launch_time, _MateDesktopItem::main_hash, MATE_DESKTOP_ITEM_ENCODING, MATE_DESKTOP_ITEM_NAME, mate_desktop_item_set_string(), MATE_DESKTOP_ITEM_VERSION, and _MateDesktopItem::refcount.
Referenced by ditem_load(), make_fake_directory(), and mate_desktop_item_copy().
| MateDesktopItem * mate_desktop_item_new_from_basename | ( | const char * | basename, |
| MateDesktopItemLoadFlags | flags, | ||
| GError ** | error | ||
| ) |
mate_desktop_item_new_from_basename: @basename: The basename of the MateDesktopItem to load.
@flags: Flags to influence the loading process
This function loads 'basename' from a system data directory and returns its MateDesktopItem.
Returns: The newly loaded item.
References file_from_basename(), MATE_DESKTOP_ITEM_ERROR, MATE_DESKTOP_ITEM_ERROR_CANNOT_OPEN, and mate_desktop_item_new_from_file().
| MateDesktopItem * mate_desktop_item_new_from_file | ( | const char * | file, |
| MateDesktopItemLoadFlags | flags, | ||
| GError ** | error | ||
| ) |
References mate_desktop_item_new_from_gfile().
Referenced by launch_item(), mate_desktop_item_new_from_basename(), and test_ditem().
| MateDesktopItem * mate_desktop_item_new_from_string | ( | const char * | uri, |
| const char * | string, | ||
| gssize | length, | ||
| MateDesktopItemLoadFlags | flags, | ||
| GError ** | error | ||
| ) |
mate_desktop_item_new_from_string: @string: string to load the MateDesktopItem from @length: length of string, or -1 to use strlen @flags: Flags to influence the loading process @error: place to put errors
This function turns the contents of the string into a MateDesktopItem.
Returns: The newly loaded item.
References ditem_load(), MATE_DESKTOP_ITEM_LOAD_NO_TRANSLATIONS, and readbuf_new_from_string().
| MateDesktopItem * mate_desktop_item_new_from_uri | ( | const char * | uri, |
| MateDesktopItemLoadFlags | flags, | ||
| GError ** | error | ||
| ) |
mate_desktop_item_new_from_uri: @uri: URI to load the MateDesktopItem from @flags: Flags to influence the loading process
This function loads 'uri' and turns it into a MateDesktopItem.
Returns: The newly loaded item.
References mate_desktop_item_new_from_gfile().
| MateDesktopItem * mate_desktop_item_ref | ( | MateDesktopItem * | item | ) |
mate_desktop_item_ref: @item: A desktop item
Description: Increases the reference count of the specified item.
Returns: the newly referenced @item
References _MateDesktopItem::refcount.
| gboolean mate_desktop_item_save | ( | MateDesktopItem * | item, |
| const char * | under, | ||
| gboolean | force, | ||
| GError ** | error | ||
| ) |
mate_desktop_item_save: @item: A desktop item @under: A new uri (location) for this MateDesktopItem @force: Save even if it wasn't modified @error: #GError return
Writes the specified item to disk. If the 'under' is NULL, the original location is used. It sets the location of this entry to point to the new location.
Returns: boolean. TRUE if the file was saved, FALSE otherwise
References ditem_save(), _MateDesktopItem::location, MATE_DESKTOP_ITEM_ERROR, MATE_DESKTOP_ITEM_ERROR_NO_FILENAME, _MateDesktopItem::modified, and _MateDesktopItem::mtime.
Referenced by test_ditem().
| void mate_desktop_item_set_boolean | ( | MateDesktopItem * | item, |
| const char * | attr, | ||
| gboolean | value | ||
| ) |
| void mate_desktop_item_set_entry_type | ( | MateDesktopItem * | item, |
| MateDesktopItemType | type | ||
| ) |
References MATE_DESKTOP_ITEM_TYPE, MATE_DESKTOP_ITEM_TYPE_APPLICATION, MATE_DESKTOP_ITEM_TYPE_DIRECTORY, MATE_DESKTOP_ITEM_TYPE_FSDEVICE, MATE_DESKTOP_ITEM_TYPE_LINK, MATE_DESKTOP_ITEM_TYPE_MIME_TYPE, MATE_DESKTOP_ITEM_TYPE_NULL, MATE_DESKTOP_ITEM_TYPE_SERVICE, MATE_DESKTOP_ITEM_TYPE_SERVICE_TYPE, _MateDesktopItem::refcount, set(), and _MateDesktopItem::type.
Referenced by make_fake_directory().
| void mate_desktop_item_set_launch_time | ( | MateDesktopItem * | item, |
| guint32 | timestamp | ||
| ) |
References _MateDesktopItem::launch_time.
| void mate_desktop_item_set_localestring | ( | MateDesktopItem * | item, |
| const char * | attr, | ||
| const char * | value | ||
| ) |
References get_language(), _MateDesktopItem::refcount, and set_locale().
Referenced by test_ditem().
| void mate_desktop_item_set_localestring_lang | ( | MateDesktopItem * | item, |
| const char * | attr, | ||
| const char * | language, | ||
| const char * | value | ||
| ) |
| void mate_desktop_item_set_location | ( | MateDesktopItem * | item, |
| const char * | location | ||
| ) |
mate_desktop_item_set_location: @item: A desktop item @location: A uri string specifying the file location of this particular item.
Set's the 'location' uri of this item.
References DONT_UPDATE_MTIME, _MateDesktopItem::location, _MateDesktopItem::modified, _MateDesktopItem::mtime, and _MateDesktopItem::refcount.
Referenced by mate_desktop_item_set_location_file(), and mate_desktop_item_set_location_gfile().
| void mate_desktop_item_set_location_file | ( | MateDesktopItem * | item, |
| const char * | file | ||
| ) |
References mate_desktop_item_set_location(), mate_desktop_item_set_location_gfile(), and _MateDesktopItem::refcount.
| void mate_desktop_item_set_string | ( | MateDesktopItem * | item, |
| const char * | attr, | ||
| const char * | value | ||
| ) |
References MATE_DESKTOP_ITEM_TYPE, _MateDesktopItem::refcount, set(), _MateDesktopItem::type, and type_from_string().
Referenced by mate_desktop_item_new(), and read_sort_order().
| void mate_desktop_item_set_strings | ( | MateDesktopItem * | item, |
| const char * | attr, | ||
| char ** | strings | ||
| ) |
| void mate_desktop_item_unref | ( | MateDesktopItem * | item | ) |
mate_desktop_item_unref: @item: A desktop item
Decreases the reference count of the specified item, and destroys the item if there are no more references left.
References free_section(), _MateDesktopItem::keys, _MateDesktopItem::languages, _MateDesktopItem::location, _MateDesktopItem::main_hash, _MateDesktopItem::refcount, and _MateDesktopItem::sections.
Referenced by _mate_desktop_item_free(), and mate_desktop_item_new_from_gfile().