#include <gnome.h> struct GnomeDesktopEntry; GnomeDesktopEntry* gnome_desktop_entry_load (const char *file); GnomeDesktopEntry* gnome_desktop_entry_load_flags (const char *file, int clean_from_memory_after_load); GnomeDesktopEntry* gnome_desktop_entry_load_flags_conditional (const char *file, int clean_from_memory_after_load, int unconditional); GnomeDesktopEntry* gnome_desktop_entry_load_unconditional (const char *file); void gnome_desktop_entry_save (GnomeDesktopEntry *dentry); void gnome_desktop_entry_free (GnomeDesktopEntry *item); void gnome_desktop_entry_destroy (GnomeDesktopEntry *item); void gnome_desktop_entry_launch (GnomeDesktopEntry *item); void gnome_desktop_entry_launch_with_args (GnomeDesktopEntry *item, int the_argc, char *the_argv[]); GnomeDesktopEntry* gnome_desktop_entry_copy (GnomeDesktopEntry *source); |
The routines in this module provide a medium to load and save files in the format expected by the panel to create the menus and applet definitions.
typedef struct { char *name; /* These contain the translated name/comment */ char *comment; int exec_length; /* Length of `exec' vector. Does not include the NULL terminator. */ char **exec; /* Command to execute. Must be NULL terminated. */ char *tryexec; /* Test program to execute */ char *icon; /* Icon name */ char *docpath; /* Path to the documentation */ int terminal; /* flag: requires a terminal to run */ char *type; /* type of this dentry */ char *location; /* path of this dentry */ char *geometry; /* geometry for this icon */ /* These are computed from icon_base */ unsigned int multiple_args:1; } GnomeDesktopEntry; |
GnomeDesktopEntry* gnome_desktop_entry_load (const char *file); |
file : | a file name that contains a desktop entry. |
Returns : | a newly created desktop entry loaded from file or NULL if the file does not exist or contains stale data. |
GnomeDesktopEntry* gnome_desktop_entry_load_flags (const char *file, int clean_from_memory_after_load); |
file : | a file name that contains a desktop entry. |
clean_from_memory_after_load : | flag |
Returns : | a newly created desktop entry loaded from file or NULL if the file does not exist or contains stale data. if clean_from_memory_after_load is TRUE, then any data cached used by loading process is discarded after loading the desktop entry. |
GnomeDesktopEntry* gnome_desktop_entry_load_flags_conditional (const char *file, int clean_from_memory_after_load, int unconditional); |
file : | |
clean_from_memory_after_load : | |
unconditional : | |
Returns : |
GnomeDesktopEntry* gnome_desktop_entry_load_unconditional (const char *file); |
file : | file name where the desktop entry resides |
Returns : | a newly created GnomeDesktopEntry loaded from file even if the file does not contain a valid desktop entry or NULL if the file does not exist. |
void gnome_desktop_entry_save (GnomeDesktopEntry *dentry); |
Saves the desktop entry to disk
dentry : | A gnome desktop entry. |
void gnome_desktop_entry_free (GnomeDesktopEntry *item); |
Releases the information used by item.
item : | a gnome desktop entry. |
void gnome_desktop_entry_destroy (GnomeDesktopEntry *item); |
Erases the file that represents item and releases the memory used by item.
item : | a gnome deskop entry. |
void gnome_desktop_entry_launch (GnomeDesktopEntry *item); |
Launchs the program associated to the item desktop entry.
item : | a gnome desktop entry. |
void gnome_desktop_entry_launch_with_args (GnomeDesktopEntry *item, int the_argc, char *the_argv[]); |
Launches the program associated with item with the_argv as its arguments.
item : | a gnome desktop entry. |
the_argc : | the number of arguments to invoke the desktop entry with. |
the_argv : | a vector of arguments for calling the program in item |
GnomeDesktopEntry* gnome_desktop_entry_copy (GnomeDesktopEntry *source); |
source : | a GnomeDesktop entry. |
Returns : | a copy of the source GnomeDesktopEntry |
|
Looks for program in the PATH, if it is found, a g_strduped string with the full path name is returned.
program : | a program name. |
Returns : | NULL if program is not on the path or a string allocated with g_malloc with the full path name of the program found |