MgSelector

typedef struct _MgSelector MgSelector;

MgSelectorPriv

typedef struct {
	MgConf       *conf;
	gulong        mode;
	gulong        columns;
	GObject      *ref_object;

	GtkTreeView  *treeview;
	gboolean      headers_visible;
	GtkTreeModel *model;   /* we pocess a reference on the object */

	GSList       *modules; /* list of Module structures */
	GObject      *selection;
} MgSelectorPriv;

enum MgSelectorMode

typedef enum {
	MG_SELECTOR_DATA_TYPES  = 1 << 0,
	MG_SELECTOR_FUNCTIONS   = 1 << 1,
	MG_SELECTOR_AGGREGATES  = 1 << 2,
	/* database structure */
	MG_SELECTOR_TABLES      = 1 << 3,
	MG_SELECTOR_FIELDS      = 1 << 5,
	/* queries */
	MG_SELECTOR_QUERIES     = 1 << 4,
	MG_SELECTOR_TARGETS     = 1 << 6,
	MG_SELECTOR_JOINS       = 1 << 7,
	MG_SELECTOR_QVIS_FIELDS = 1 << 8,
	MG_SELECTOR_QALL_FIELDS = 1 << 9,
	MG_SELECTOR_SUB_QUERIES = 1 << 10,
	MG_SELECTOR_TARGETS_CTS = 1 << 13,
	/* graphs */
	MG_SELECTOR_GRAPHS      = 1 << 11,
	/* layouts */
	MG_SELECTOR_FORMS       = 1 << 12
} MgSelectorMode;

Describes what objects the MgSelector widget will display

enum MgSelectorColumn

typedef enum {
	MG_SELECTOR_COLUMN_OWNER        = 1 << 1,
	MG_SELECTOR_COLUMN_COMMENTS     = 1 << 2,
	MG_SELECTOR_COLUMN_TYPE         = 1 << 3,
	MG_SELECTOR_COLUMN_FIELD_LENGTH = 1 << 4,
	MG_SELECTOR_COLUMN_FIELD_NNUL   = 1 << 5,
	MG_SELECTOR_COLUMN_FIELD_DEFAULT= 1 << 6,
	MG_SELECTOR_COLUMN_QFIELD_VALUE = 1 << 7,
	MG_SELECTOR_COLUMN_QFIELD_TYPE  = 1 << 8
} MgSelectorColumn;

Used to specify which columns will be present in the MgSelector widget. The column for each object name is of course always present (1st column).

mg_selector_get_type ()

guint       mg_selector_get_type            (void);

mg_selector_new ()

GtkWidget*  mg_selector_new                 (MgConf *conf,
                                             GObject *ref_object,
                                             gulong mode,
                                             gulong columns);

Creates a new MgSelector widget.

ref_object must be NULL if mode implies a list where the displayed items are all fetched from within conf (namely MG_SELECTOR_DATA_TYPES, MG_SELECTOR_FUNCTIONS, MG_SELECTOR_AGGREGATES, MG_SELECTOR_TABLES, MG_SELECTOR_QUERIES). In this case ref_object will simply be ignored.

ref_object cannot be NULL if mode implies a list where the displayed items depend on a specific object, namely MG_SELECTOR_FIELDS (when not used in conjunction with MG_SELECTOR_TABLES), MG_SELECTOR_TARGETS, MG_SELECTOR_JOINS, MG_SELECTOR_QVIS_FIELDS, MG_SELECTOR_QALL_FIELDS and MG_SELECTOR_SUB_QUERIES (when not used in conjunction with MG_SELECTOR_QUERIES).

mg_selector_set_mode_columns ()

void        mg_selector_set_mode_columns    (MgSelector *mgsel,
                                             GObject *ref_object,
                                             gulong mode,
                                             gulong columns);

Changes what data gets displayed in mgsel and which columns are displayed. The mode and columns have the same meaning as for the mg_selector_new() function.

The usage of the ref_object parameter is the same as for mg_selector_new().

mg_selector_set_selected_object ()

gboolean    mg_selector_set_selected_object (MgSelector *mgsel,
                                             GObject *selection);

Force the widget to select a given object, and to display it in its visible area (unfolding nodes on the way if necessary)

mg_selector_set_headers_visible ()

void        mg_selector_set_headers_visible (MgSelector *mgsel,
                                             gboolean visible);

Show or hide the headers.

mg_selector_set_column_label ()

void        mg_selector_set_column_label    (MgSelector *mgsel,
                                             guint column,
                                             const gchar *label);

Sets the label of a column's header.

mg_selector_get_selected_object ()

GObject*    mg_selector_get_selected_object (MgSelector *mgsel);

Get the currently selected object.

mg_selector_get_selected_object_parent ()

GObject*    mg_selector_get_selected_object_parent
                                            (MgSelector *mgsel);

FIXME

The "selection-changed" signal

void        user_function                  (MgSelector *mgselector,
                                            GObject    *arg1,
                                            gpointer    user_data)       : Run first