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 AtkImplementorIface and GtkBuildable.

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.