GladeCommand

## GladeCommand GladeCommand — An event filter to implement the Undo/Redo stack. |

## Synopsis

                        GCSetPropData;
                        GladeCommand;
    void                glade_command_push_group            (const gchar *fmt,
                                                             ...);
    void                glade_command_pop_group             (void);
    gboolean            glade_command_execute               (GladeCommand *command);
    gboolean            glade_command_undo                  (GladeCommand *command);
    gboolean            glade_command_unifies               (GladeCommand *command,
                                                             GladeCommand *other);
    void                glade_command_collapse              (GladeCommand *command,
                                                             GladeCommand *other);
    void                glade_command_set_property          (GladeProperty *property,
                                                             ...);
    void                glade_command_set_property_value    (GladeProperty *property,
                                                             const GValue *value);
    void                glade_command_set_properties        (GladeProperty *property,
                                                             const GValue *old_value,
                                                             const GValue *new_value,
                                                             ...);
    void                glade_command_set_properties_list   (GladeProject *project,
                                                             GList *props);
    void                glade_command_set_name              (GladeWidget *glade_widget,
                                                             const gchar *name);
    void                glade_command_delete                (GList *widgets);
    GladeWidget*        glade_command_create                (GladeWidgetAdaptor *adaptor,
                                                             GladeWidget *parent,
                                                             GladePlaceholder *placeholder,
                                                             GladeProject *project);
    void                glade_command_cut                   (GList *widgets);
    void                glade_command_copy                  (GList *widgets);
    void                glade_command_paste                 (GList *widgets,
                                                             GladeWidget *parent,
                                                             GladePlaceholder *placeholder);
    void                glade_command_dnd                   (GList *widgets,
                                                             GladeWidget *parent,
                                                             GladePlaceholder *placeholder);
    void                glade_command_add_signal            (GladeWidget *glade_widget,
                                                             const GladeSignal *signal);
    void                glade_command_remove_signal         (GladeWidget *glade_widget,
                                                             const GladeSignal *signal);
    void                glade_command_change_signal         (GladeWidget *glade_widget,
                                                             const GladeSignal *old_signal,
                                                             const GladeSignal *new_signal);
    void                glade_command_set_i18n              (GladeProperty *property,
                                                             gboolean translatable,
                                                             gboolean has_context,
                                                             const gchar *comment);

## Object Hierarchy

      GObject
       +----GladeCommand

## Description

The Glade Command api allows us to view user actions as items and execute and undo those items; each GladeProject has its own Undo/Redo stack.

## Details

### GCSetPropData

    typedef struct {
    	GladeProperty *property;
    	GValue        *new_value;
    	GValue        *old_value;
    } GCSetPropData;

GladeProperties can be set in a list as one command, for Undo purposes; we store the list of GCSetPropData with their old and new GValue.

GladeProperty *`property`; | A GladeProperty to set
GValue *`new_value`; | The new GValue to assign to `property`
GValue *`old_value`; | The old GValue of `property`

### GladeCommand

    typedef struct _GladeCommand GladeCommand;

### glade_command_push_group ()

    void                glade_command_push_group            (const gchar *fmt,
                                                             ...);

Marks the begining of a group.

`fmt` : | The collective desctiption of the command group. only the description of the first group on the stack is used when embedding groups.
`...` : | args to the format string.

### glade_command_pop_group ()

    void                glade_command_pop_group             (void);

Mark the end of a command group.

### glade_command_execute ()

    gboolean            glade_command_execute               (GladeCommand *command);

Executes `command`

`command` : | A GladeCommand
Returns : | whether the command was successfully executed

### glade_command_undo ()

    gboolean            glade_command_undo                  (GladeCommand *command);

Undo the effects of `command`

`command` : | A GladeCommand
Returns : | whether the command was successfully reversed

### glade_command_unifies ()

    gboolean            glade_command_unifies               (GladeCommand *command,
                                                             GladeCommand *other);

Checks whether `command` and `other` can be unified to make one single command.

`command` : | A GladeCommand
`other` : | another GladeCommand
Returns : | whether they can be unified.

### glade_command_collapse ()

    void                glade_command_collapse              (GladeCommand *command,
                                                             GladeCommand *other);

Merges `other` into `command`, so that `command` now covers both commands and `other` can be dispensed with.

`command` : | A GladeCommand
`other` : | another GladeCommand

### glade_command_set_property ()

    void                glade_command_set_property          (GladeProperty *property,
                                                             ...);

`property` : |
`...` : |

### glade_command_set_property_value ()

    void                glade_command_set_property_value    (GladeProperty *property,
                                                             const GValue *value);

`property` : |
`value` : |

### glade_command_set_properties ()

    void                glade_command_set_properties        (GladeProperty *property,
                                                             const GValue *old_value,
                                                             const GValue *new_value,
                                                             ...);

`property` : |
`old_value` : |
`new_value` : |
`...` : |

### glade_command_set_properties_list ()

    void                glade_command_set_properties_list   (GladeProject *project,
                                                             GList *props);

`project` : |
`props` : |

### glade_command_set_name ()

    void                glade_command_set_name              (GladeWidget *glade_widget,
                                                             const gchar *name);

`glade_widget` : |
`name` : |

### glade_command_delete ()

    void                glade_command_delete                (GList *widgets);

Performs a delete command on the list of widgets.

`widgets` : | a GList of GladeWidgets

### glade_command_create ()

    GladeWidget*        glade_command_create                (GladeWidgetAdaptor *adaptor,
                                                             GladeWidget *parent,
                                                             GladePlaceholder *placeholder,
                                                             GladeProject *project);

Creates a new widget using `adaptor` and put in place of the `placeholder` in the `project`

`adaptor` : | A GladeWidgetAdaptor
`parent` : |
`placeholder` : | the placeholder which will be substituted by the widget
`project` : | the project his widget belongs to.
Returns : | the newly created widget.

### glade_command_cut ()

    void                glade_command_cut                   (GList *widgets);

Removes the list of widgets and adds them to the clipboard.

`widgets` : | a GList of GladeWidgets

### glade_command_copy ()

    void                glade_command_copy                  (GList *widgets);

Copies the list of widgets and adds them to the clipboard.

`widgets` : | a GList of GladeWidgets

### glade_command_paste ()

    void                glade_command_paste                 (GList *widgets,
                                                             GladeWidget *parent,
                                                             GladePlaceholder *placeholder);

Performs a paste command on all widgets in `widgets` to `parent`, possibly replacing `placeholder` (note toplevels dont need a parent; the active project will be used when pasting toplevel objects).

`widgets` : | a GList of GladeWidget
`parent` : | a GladeWidget
`placeholder` : | a GladePlaceholder

### glade_command_dnd ()

    void                glade_command_dnd                   (GList *widgets,
                                                             GladeWidget *parent,
                                                             GladePlaceholder *placeholder);

Performs a drag-n-drop command, i.e. removes the list of widgets and adds them to the new parent, possibly replacing `placeholder` (note toplevels dont need a parent; the active project will be used when pasting toplevel objects).

`widgets` : | a GList of GladeWidget
`parent` : | a GladeWidget
`placeholder` : | a GladePlaceholder

### glade_command_add_signal ()

    void                glade_command_add_signal            (GladeWidget *glade_widget,
                                                             const GladeSignal *signal);

TODO: write me

`glade_widget` : | a GladeWidget
`signal` : | a GladeSignal

### glade_command_remove_signal ()

    void                glade_command_remove_signal         (GladeWidget *glade_widget,
                                                             const GladeSignal *signal);

TODO: write me

`glade_widget` : | a GladeWidget
`signal` : | a GladeSignal

### glade_command_change_signal ()

    void                glade_command_change_signal         (GladeWidget *glade_widget,
                                                             const GladeSignal *old_signal,
                                                             const GladeSignal *new_signal);

TODO: write me

`glade_widget` : | a GladeWidget
`old_signal` : | a GladeSignal
`new_signal` : | a GladeSignal

### glade_command_set_i18n ()

    void                glade_command_set_i18n              (GladeProperty *property,
                                                             gboolean translatable,
                                                             gboolean has_context,
                                                             const gchar *comment);

Sets the i18n data on the property.

`property` : | a GladeProperty
`translatable` : | a gboolean
`has_context` : | a gboolean
`comment` : | a const gchar *