## GnomeDItemEdit

GnomeDItemEdit

## Synopsis

    #include <libgnome/gnome-ditem-edit.h>

                        GnomeDItemEdit;
    GtkWidget *         gnome_ditem_edit_new                (void);
    void                gnome_ditem_edit_clear              (GnomeDItemEdit *dee);
    gboolean            gnome_ditem_edit_load_uri           (GnomeDItemEdit *dee,
                                                             const gchar *uri,
                                                             GError **error);
    void                gnome_ditem_edit_set_ditem          (GnomeDItemEdit *dee,
                                                             const GnomeDesktopItem *ditem);
    GnomeDesktopItem *  gnome_ditem_edit_get_ditem          (GnomeDItemEdit *dee);
    gchar *             gnome_ditem_edit_get_icon           (GnomeDItemEdit *dee);
    gchar *             gnome_ditem_edit_get_name           (GnomeDItemEdit *dee);
    void                gnome_ditem_edit_set_entry_type     (GnomeDItemEdit *dee,
                                                             const char *type);
    void                gnome_ditem_edit_set_directory_only (GnomeDItemEdit *dee,
                                                             gboolean directory_only);
    void                gnome_ditem_edit_grab_focus         (GnomeDItemEdit *dee);
    void                gnome_ditem_edit_set_editable       (GnomeDItemEdit *dee,
                                                             gboolean editable);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkNotebook
                                     +----GnomeDItemEdit

## Implemented Interfaces

GnomeDItemEdit implements GtkBuildable and AtkImplementorIface.

## Signals

      "changed"                                        : Run Last
      "icon-changed"                                   : Run Last
      "name-changed"                                   : Run Last

## Description

## Details

### GnomeDItemEdit

    typedef struct _GnomeDItemEdit GnomeDItemEdit;

### Warning

`GnomeDItemEdit` is deprecated and should not be used in newly-written code.

### gnome_ditem_edit_new ()

    GtkWidget *         gnome_ditem_edit_new                (void);

### Warning

`gnome_ditem_edit_new` has been deprecated since version 2.18 and should not be used in newly-written code.

Creates a new GnomeDItemEdit widget. A widget for the purpose of editing GnomeDesktopItems

Returns : | Newly-created GnomeDItemEdit widget.

### gnome_ditem_edit_clear ()

    void                gnome_ditem_edit_clear              (GnomeDItemEdit *dee);

### Warning

`gnome_ditem_edit_clear` has been deprecated since version 2.18 and should not be used in newly-written code.

Clear the editting areas. And unref any stored GnomeDesktopItem.

`dee` : | GnomeDItemEdit object to work with

### gnome_ditem_edit_load_uri ()

    gboolean            gnome_ditem_edit_load_uri           (GnomeDItemEdit *dee,
                                                             const gchar *uri,
                                                             GError **error);

### Warning

`gnome_ditem_edit_load_uri` has been deprecated since version 2.18 and should not be used in newly-written code.

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

`dee` : | GnomeDItemEdit object to work with
`uri` : | file to load into the editting areas
`error` : | location to store error, or NULL
Returns : | `TRUE` if successful, `FALSE` otherwise

### gnome_ditem_edit_set_ditem ()

    void                gnome_ditem_edit_set_ditem          (GnomeDItemEdit *dee,
                                                             const GnomeDesktopItem *ditem);

### Warning

`gnome_ditem_edit_set_ditem` has been deprecated since version 2.18 and should not be used in newly-written code.

Set the ditem edit UI to this item. This makes a copy internally so do not worry about modifying this item later yourself. Note that since the entire item is stored, any hidden fields will be preserved when you later get it with gnome_ditem_edit_get_ditem.

`dee` : | GnomeDItemEdit object to work with
`ditem` : | GnomeDesktopItem to use

### gnome_ditem_edit_get_ditem ()

    GnomeDesktopItem *  gnome_ditem_edit_get_ditem          (GnomeDItemEdit *dee);

### Warning

`gnome_ditem_edit_get_ditem` has been deprecated since version 2.18 and should not be used in newly-written code.

Get the current status of the editting areas as a GnomeDesktopItem structure. It will give you a pointer to the internal structure. If you wish to modify it, make a copy of it with gnome_desktop_item_copy

`dee` : | GnomeDItemEdit object to work with
Returns : | a pointer to the internal GnomeDesktopItem structure.

### gnome_ditem_edit_get_icon ()

    gchar *             gnome_ditem_edit_get_icon           (GnomeDItemEdit *dee);

### Warning

`gnome_ditem_edit_get_icon` has been deprecated since version 2.18 and should not be used in newly-written code.

Get the icon filename.

`dee` : | GnomeDItemEdit object to work with
Returns : | a newly allocated string with the filename of the icon

### gnome_ditem_edit_get_name ()

    gchar *             gnome_ditem_edit_get_name           (GnomeDItemEdit *dee);

### Warning

`gnome_ditem_edit_get_name` has been deprecated since version 2.18 and should not be used in newly-written code.

Get the Name field from the ditem for the current language.

`dee` : | GnomeDItemEdit object to work with
Returns : | a newly allocated string with the name of the ditem

### gnome_ditem_edit_set_entry_type ()

    void                gnome_ditem_edit_set_entry_type     (GnomeDItemEdit *dee,
                                                             const char *type);

### Warning

`gnome_ditem_edit_set_entry_type` has been deprecated since version 2.18 and should not be used in newly-written code.

Force directory only.

`dee` : | GnomeDItemEdit object to work with
`type` : |

### gnome_ditem_edit_set_directory_only ()

    void                gnome_ditem_edit_set_directory_only (GnomeDItemEdit *dee,
                                                             gboolean directory_only);

### Warning

`gnome_ditem_edit_set_directory_only` is deprecated and should not be used in newly-written code.

`dee` : |
`directory_only` : |

### gnome_ditem_edit_grab_focus ()

    void                gnome_ditem_edit_grab_focus         (GnomeDItemEdit *dee);

### Warning

`gnome_ditem_edit_grab_focus` has been deprecated since version 2.18 and should not be used in newly-written code.

Give the focus to the editor.

`dee` : | GnomeDItemEdit object to work with

### gnome_ditem_edit_set_editable ()

    void                gnome_ditem_edit_set_editable       (GnomeDItemEdit *dee,
                                                             gboolean editable);

### Warning

`gnome_ditem_edit_set_editable` has been deprecated since version 2.18 and should not be used in newly-written code.

Set the object editable.

`dee` : | GnomeDItemEdit object to work with
`editable` : | `TRUE` to set the object editable

## Signal Details

### The `"changed"` signal

    void                user_function                      (GnomeDItemEdit *ditemedit,
                                                            gpointer        user_data)      : Run Last

`ditemedit` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.

### The `"icon-changed"` signal

    void                user_function                      (GnomeDItemEdit *ditemedit,
                                                            gpointer        user_data)      : Run Last

`ditemedit` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.

### The `"name-changed"` signal

    void                user_function                      (GnomeDItemEdit *ditemedit,
                                                            gpointer        user_data)      : Run Last

`ditemedit` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.