## GladeEditor

GladeEditor — A Widget to edit a GladeWidget.

## Synopsis

    #define             GLADE_EDITOR_TABLE                  (t)
    #define             GLADE_IS_EDITOR_TABLE               (t)
                        GladeEditorTable;
    enum                GladeEditorTableType;
                        GladeEditor;
    GladeEditor*        glade_editor_new                    (void);
    void                glade_editor_load_widget            (GladeEditor *editor,
                                                             GladeWidget *widget);
    void                glade_editor_refresh                (GladeEditor *editor);
    void                glade_editor_update_widget_name     (GladeEditor *editor);
    gboolean            glade_editor_query_dialog           (GladeEditor *editor,
                                                             GladeWidget *widget);
    void                glade_editor_show_info              (GladeEditor *editor);
    void                glade_editor_show_context_info      (GladeEditor *editor);
    void                glade_editor_hide_info              (GladeEditor *editor);
    void                glade_editor_hide_context_info      (GladeEditor *editor);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBox
                                     +----GtkVBox
                                           +----GladeEditor

## Implemented Interfaces

GladeEditor implements AtkImplementorIface and GtkBuildable.

## Properties

      "show-context-info"        gboolean              : Read
      "show-info"                gboolean              : Read

## Signals

      "gtk-doc-search"                                 : Run Last

## Description

This is the Glade Notebook containing all the controls needed to configure a GladeWidget.

## Details

### GLADE_EDITOR_TABLE()

    #define GLADE_EDITOR_TABLE(t)       ((GladeEditorTable *)t)

`t` : |

### GLADE_IS_EDITOR_TABLE()

    #define GLADE_IS_EDITOR_TABLE(t)    (t != NULL)

`t` : |

### GladeEditorTable

    typedef struct {
    	GladeEditor *editor; /* Handy pointer that avoids havving to pass the
    			      * editor arround.
    			      */

    	GladeWidgetAdaptor *adaptor; /* The GladeWidgetAdaptor this
    				      * table belongs to.
    				      */

    	GtkWidget *table_widget; /* This widget is a gtk_vbox that is displayed
    				  * in the glade-editor when a widget of this
    				  * class is selected. It is hiden when another
    				  * type is selected. When we select a widget
    				  * we load into the inputs inside this table
    				  * the information about the selected widget.
    				  */

    	GtkWidget *name_entry; /* A pointer to the gtk_entry that holds
    				* the name of the widget. This is the
    				* first item _pack'ed to the table_widget.
    				* We have a pointer here because it is an
    				* entry which will not be created from a
    				* GladeProperty but rather from code.
    				*/

    	GList *properties; /* A list of GladeEditorPropery items.
    			    * For each row in the gtk_table, there is a
    			    * corrsponding GladeEditorProperty struct.
    			    */

    	GladeEditorTableType type; /* Is this table to be used in the common tab, ?
    				    * the general tab, a packing tab or the query popup ?
    				    */

    	gint  rows;
    } GladeEditorTable;

### enum GladeEditorTableType

    typedef enum _GladeEditorTableType
    {
    	TABLE_TYPE_GENERAL,
    	TABLE_TYPE_COMMON,
    	TABLE_TYPE_PACKING,
    	TABLE_TYPE_ATK,
    	TABLE_TYPE_QUERY
    } GladeEditorTableType;

### GladeEditor

    typedef struct _GladeEditor GladeEditor;

### glade_editor_new ()

    GladeEditor*        glade_editor_new                    (void);

Returns : | a new GladeEditor

### glade_editor_load_widget ()

    void                glade_editor_load_widget            (GladeEditor *editor,
                                                             GladeWidget *widget);

Load `widget` into `editor`. If `widget` is `NULL`, clear the editor.

`editor` : | a GladeEditor
`widget` : | a GladeWidget

### glade_editor_refresh ()

    void                glade_editor_refresh                (GladeEditor *editor);

Synchronize `editor` with the currently loaded widget.

`editor` : | a GladeEditor

### glade_editor_update_widget_name ()

    void                glade_editor_update_widget_name     (GladeEditor *editor);

TODO: write me

`editor` : | a GladeEditor

### glade_editor_query_dialog ()

    gboolean            glade_editor_query_dialog           (GladeEditor *editor,
                                                             GladeWidget *widget);

`editor` : |
`widget` : |
Returns : |

### glade_editor_show_info ()

    void                glade_editor_show_info              (GladeEditor *editor);

`editor` : |

### glade_editor_show_context_info ()

    void                glade_editor_show_context_info      (GladeEditor *editor);

`editor` : |

### glade_editor_hide_info ()

    void                glade_editor_hide_info              (GladeEditor *editor);

`editor` : |

### glade_editor_hide_context_info ()

    void                glade_editor_hide_context_info      (GladeEditor *editor);

`editor` : |

## Property Details

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

      "show-context-info"        gboolean              : Read

Whether to show an informational button for each property and signal in the editor.

Default value: FALSE

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

      "show-info"                gboolean              : Read

Whether to show an informational button for the loaded widget.

Default value: FALSE

## Signal Details

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

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

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

`gladeeditor` : | the GladeEditor 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.