Gnome User Interface Library Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# 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

<<< Previous Page | Home | Up | Next Page >>>
GnomeDateEdit | GnomeDialog