GtkUndo

struct GtkUndo

struct GtkUndo;

This structure is an opaque structure and its fields should never be accessed directly.

gtk_undo_initialize ()

void        gtk_undo_initialize             (void);

Initializes GtkUndo library.

gtk_undo_register_action_type ()

gint        gtk_undo_register_action_type   (GUndoActionType type);

Adds an action type to the GtkUndo supported action types. See GtkUndo-custom for more details.

gtk_undo_new ()

GtkUndo*    gtk_undo_new                    (void);

Creates a new GtkUndo.

gtk_undo_set_maxlen ()

void        gtk_undo_set_maxlen             (GtkUndo *undo,
                                             gint maxlen);

Sets the maximum length of the Undo list. 0 means infinite.

gtk_undo_add_widget ()

gboolean    gtk_undo_add_widget             (GtkUndo *undo,
                                             GtkWidget *widget,
                                             gint type);

Registers a widget for undo operations. If the widget's type is not supported and no custom action type is provided, gtk_undo_add_widget() returns FALSE. The predefined types are listed in GtkUndoAction.

If the type is -1, then the default action for the widget is assumed. If the type is provided, the custom action type is used, even if a default action is defined for that kinda widget.

When a widget has a grouping capacity (especially GtkRadioButton), passing one element will set up the whole group for undo/redo facilities.

gtk_undo_add_glade_built_widget ()

gboolean    gtk_undo_add_glade_built_widget (GtkUndo *undo,
                                             GtkWidget *parent,
                                             gchar *widget_name,
                                             gint type);

This is a convenience function for <ulink url="http://glade.gnome.org/">Glade (http://glade.gnome.org/)</ulink> users. In a Glade generated source tree, a function wraps all the widget's creation, and it is quite boring to use "lookup_widget" all the time to set up the GtkUndo object. So, This function is a shortcut.

If @ conception time, you've added a GtkEntry named "entry1" in a window "window1", after calling from your main() window1=create_window1(), you can simply register your entry1 in a GtkUndo undo list with gtk_undo_add_glade_built_widget(undo,window1,"entry1",-1);

Please check gtk_undo_add_widget.

enum GtkUndoTriggerType

typedef enum {
  GTK_UNDO_TRIGGER_UNDO=0,
  GTK_UNDO_TRIGGER_REDO
}GtkUndoTriggerType;

gtk_undo_add_trigger ()

void        gtk_undo_add_trigger            (GtkUndo *undo,
                                             GtkWidget *trigger,
                                             GtkUndoTriggerType trigger_type);

Associates trigger with undo so when trigger is activated, the action defined by trigger_type. You can connect signals to trigger anyway but it is strongly discouraged as it may disturb the GtkUndo work. Once a GtkButton or GtkMenuItem is associated with a GtkUndo object, everything is performed automagicaly.

gtk_undo_add_trigger_pair ()

void        gtk_undo_add_trigger_pair       (GtkUndo *undo,
                                             GtkWidget *undo_trigger,
                                             GtkWidget *redo_trigger);

This function is a wrapper for gtk_undo_add_trigger() which is called twice.

gtk_undo_add_glade_built_trigger_pair ()

void        gtk_undo_add_glade_built_trigger_pair
                                            (GtkUndo *undo,
                                             GtkWidget *parent,
                                             gchar *undo_trigger_name,
                                             gchar *redo_trigger_name);

Please check gtk_undo_add_trigger_pair.

The "redone" signal

void        user_function                  (GtkUndo *undo,
                                            GObject *arg1,
                                            gpointer user_data);

Emitted when an action was redone.

The "undone" signal

void        user_function                  (GtkUndo *undo,
                                            GObject *arg1,
                                            gpointer user_data);

Emitted when an action was undone.