>GnomeDEntryEdit

GnomeDEntryEdit

Name

GnomeDEntryEdit -- Editing object for dentries (.desktop files)

Synopsis


#include <gnome.h>


struct      GnomeDEntryEdit;
GtkObject*  gnome_dentry_edit_new           (void);
#define     gnome_dentry_edit_child1        (d)
#define     gnome_dentry_edit_child2        (d)
GtkObject*  gnome_dentry_edit_new_notebook  (GtkNotebook *notebook);
void        gnome_dentry_edit_clear         (GnomeDEntryEdit *dee);
void        gnome_dentry_edit_load_file     (GnomeDEntryEdit *dee,
                                             const gchar *path);
void        gnome_dentry_edit_set_dentry    (GnomeDEntryEdit *dee,
                                             GnomeDesktopEntry *dentry);
GnomeDesktopEntry* gnome_dentry_get_dentry  (GnomeDEntryEdit *dee);
gchar*      gnome_dentry_edit_get_icon      (GnomeDEntryEdit *dee);
gchar*      gnome_dentry_edit_get_name      (GnomeDEntryEdit *dee);

Object Hierarchy


  GtkObject
   +----GnomeDEntryEdit

Description

GnomeDEntryEdit is a simpleobject, not a widget. It is used for adding pages to a property notebook for editing a .desktop entry (such as in the menu editor). Since it is not a widget you don't add it to the notebook, but you use the gnome_dentry_edit_new_notebook method to make a new object and automatically add it as the last page to a notebook.

Details

struct GnomeDEntryEdit

struct GnomeDEntryEdit;


gnome_dentry_edit_new ()

GtkObject*  gnome_dentry_edit_new           (void);

Creates a new GnomeDEntryEdit object. The object is not a widget, but just an object which creates some widgets which you have to add to a notebook. Use the gnome_dentry_edit_new_notebook to add pages to the notebook.

Returns : Newly-created GnomeDEntryEdit object.


gnome_dentry_edit_child1()

#define     gnome_dentry_edit_child1(d)

Get the first child widget pointer (page 1, basic), if you want to add it to a notebook yourself.

d :the GnomeDEntryEdit object to work with


gnome_dentry_edit_child2()

#define     gnome_dentry_edit_child2(d)

Get the first child widget pointer (page 2, advanced), if you want to add it to a notebook yourself.

d :the GnomeDEntryEdit object to work with


gnome_dentry_edit_new_notebook ()

GtkObject*  gnome_dentry_edit_new_notebook  (GtkNotebook *notebook);

Creates a new GnomeDEntryEdit object and adds it's pages to the notebook specified in the parameter.

notebook : notebook to add the pages to
Returns : Newly-created GnomeDEntryEdit object.


gnome_dentry_edit_clear ()

void        gnome_dentry_edit_clear         (GnomeDEntryEdit *dee);

Clear the editting areas.

dee : GnomeDEntryEdit object to work with


gnome_dentry_edit_load_file ()

void        gnome_dentry_edit_load_file     (GnomeDEntryEdit *dee,
                                             const gchar *path);

Load a .desktop file and update the editting areas of the object accordingly.

dee : GnomeDEntryEdit object to work with
path : file to load into the editting areas


gnome_dentry_edit_set_dentry ()

void        gnome_dentry_edit_set_dentry    (GnomeDEntryEdit *dee,
                                             GnomeDesktopEntry *dentry);

Destroy existing dentry and replace it with this one, updating the GnomeDEntryEdit to reflect it.

dee : GnomeDEntryEdit object to work with
dentry : GnomeDesktopEntry to use


gnome_dentry_get_dentry ()

GnomeDesktopEntry* gnome_dentry_get_dentry  (GnomeDEntryEdit *dee);

This call is actually the gnome_dentry_edit_get_dentry, it should not be used, it is left ONLY for compatibility reasons.

dee : GnomeDEntryEdit object to work with
Returns : a newly allocated GnomeDesktopEntry structure.


gnome_dentry_edit_get_icon ()

gchar*      gnome_dentry_edit_get_icon      (GnomeDEntryEdit *dee);

Get the icon filename. The icon is entered into a GnomeIconEntry, so the semantics of this call are the same as for gnome_icon_entry_get_filename

dee : GnomeDEntryEdit object to work with
Returns : a newly allocated string with the filename of the icon


gnome_dentry_edit_get_name ()

gchar*      gnome_dentry_edit_get_name      (GnomeDEntryEdit *dee);

Get the Name field from the dentry.

dee : GnomeDEntryEdit object to work with
Returns : a newly allocated string with the name of the dentry