## GladeEditorProperty

GladeEditorProperty — A generic widget to edit a GladeProperty.

## Synopsis

                        GladeEditorProperty;
    GladeEditorProperty* glade_editor_property_new          (GladePropertyClass *klass,
                                                             gboolean use_command);
    GladeEditorProperty* glade_editor_property_new_from_widget
                                                            (GladeWidget *widget,
                                                             const gchar *property,
                                                             gboolean packing,
                                                             gboolean use_command);
    void                glade_editor_property_load          (GladeEditorProperty *eprop,
                                                             GladeProperty *property);
    void                glade_editor_property_load_by_widget
                                                            (GladeEditorProperty *eprop,
                                                             GladeWidget *widget);
    gboolean            glade_editor_property_supported     (GParamSpec *pspec);
    void                glade_editor_property_show_info     (GladeEditorProperty *eprop);
    void                glade_editor_property_hide_info     (GladeEditorProperty *eprop);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBox
                                     +----GtkHBox
                                           +----GladeEditorProperty

## Implemented Interfaces

GladeEditorProperty implements AtkImplementorIface and GtkBuildable.

## Properties

      "property-class"           gpointer              : Read / Write / Construct Only
      "show-info"                gboolean              : Read / Write
      "use-command"              gboolean              : Read / Write

## Signals

      "gtk-doc-search"                                 : Run Last

## Description

The GladeEditorProperty is a factory that will create the correct control for the GladePropertyClass it was created for and provides a simple unified api to them.

## Details

### GladeEditorProperty

    typedef struct _GladeEditorProperty GladeEditorProperty;

### glade_editor_property_new ()

    GladeEditorProperty* glade_editor_property_new          (GladePropertyClass *klass,
                                                             gboolean use_command);

This is a factory function to create the correct type of editor property that can edit the said type of GladePropertyClass

`klass` : | A GladePropertyClass
`use_command` : | Whether the undo/redo stack applies here.
Returns : | A newly created GladeEditorProperty of the correct type

### glade_editor_property_new_from_widget ()

    GladeEditorProperty* glade_editor_property_new_from_widget
                                                            (GladeWidget *widget,
                                                             const gchar *property,
                                                             gboolean packing,
                                                             gboolean use_command);

This is a convenience function to create a GladeEditorProperty corresponding to `property`

`widget` : | A GladeWidget
`property` : | The widget's property
`packing` : | whether `property` indicates a packing property or not.
`use_command` : | Whether the undo/redo stack applies here.
Returns : | A newly created and connected GladeEditorProperty

### glade_editor_property_load ()

    void                glade_editor_property_load          (GladeEditorProperty *eprop,
                                                             GladeProperty *property);

Loads `property` values into `eprop` and connects.

`eprop` : | A GladeEditorProperty
`property` : | A GladeProperty

### glade_editor_property_load_by_widget ()

    void                glade_editor_property_load_by_widget
                                                            (GladeEditorProperty *eprop,
                                                             GladeWidget *widget);

Convenience function to load the appropriate GladeProperty into `eprop` from `widget`

`eprop` : | A GladeEditorProperty
`widget` : | A GladeWidget

### glade_editor_property_supported ()

    gboolean            glade_editor_property_supported     (GParamSpec *pspec);

`pspec` : | A GParamSpec
Returns : | whether this pspec is supported by GladeEditorProperties.

### glade_editor_property_show_info ()

    void                glade_editor_property_show_info     (GladeEditorProperty *eprop);

Show the control widget to access help for `eprop`

`eprop` : | A GladeEditorProperty

### glade_editor_property_hide_info ()

    void                glade_editor_property_hide_info     (GladeEditorProperty *eprop);

Hide the control widget to access help for `eprop`

`eprop` : | A GladeEditorProperty

## Property Details

### The `"property-class"` property

      "property-class"           gpointer              : Read / Write / Construct Only

The GladePropertyClass this GladeEditorProperty was created for.

### The `"show-info"` property

      "show-info"                gboolean              : Read / Write

Whether we should show an informational button.

Default value: FALSE

### The `"use-command"` property

      "use-command"              gboolean              : Read / Write

Whether we should use the command API for the undo/redo stack.

Default value: FALSE

## Signal Details

### The `"gtk-doc-search"` signal

    void                user_function                      (GladeEditorProperty *gladeeditor,
                                                            gchar               *arg1,
                                                            gchar               *arg2,
                                                            gchar               *arg3,
                                                            gpointer             user_data)        : Run Last

Emitted when the editor property requests that a doc-search be performed.

`gladeeditor` : | the GladeEditorProperty which received the signal.
`arg1` : | the (gchar *) book to search or `NULL`
`arg2` : | the (gchar *) page to search or `NULL`
`arg3` : | the (gchar *) search string or `NULL`
`user_data` : | user data set when the signal handler was connected.