gdaui_basic_form_new ()

GtkWidget *
gdaui_basic_form_new (GdaSet *data_set);

Creates a new GdauiBasicForm widget using all the GdaHolder objects provided in data_set .

The global layout is rendered using a table (a GtkTable), and an entry is created for each node of data_set .

Since: 4.2

gdaui_basic_form_new_in_dialog ()

GtkWidget *
gdaui_basic_form_new_in_dialog (GdaSet *data_set,
                                GtkWindow *parent,
                                const gchar *title,
                                const gchar *header);

Creates a new GdauiBasicForm widget in the same way as gdaui_basic_form_new() and puts it into a GtkDialog widget. The returned dialog has the "Ok" and "Cancel" buttons which respectively return GTK_RESPONSE_ACCEPT and GTK_RESPONSE_REJECT.

The GdauiBasicForm widget is attached to the dialog using the user property "form".

Since: 4.2

gdaui_basic_form_get_data_set ()

GdaSet *
gdaui_basic_form_get_data_set (GdauiBasicForm *form);

Get a pointer to the GdaSet object which is modified by form

Since: 4.2

gdaui_basic_form_is_valid ()

gboolean
gdaui_basic_form_is_valid (GdauiBasicForm *form);

Tells if the form can be used as-is (if all the parameters do have some valid values)

Since: 4.2

gdaui_basic_form_has_changed ()

gboolean
gdaui_basic_form_has_changed (GdauiBasicForm *form);

Tells if the form has had at least on entry changed since form was created or gdaui_basic_form_set_as_reference() has been called.

Since: 4.2

gdaui_basic_form_reset ()

void
gdaui_basic_form_reset (GdauiBasicForm *form);

Resets all the entries in the form to their original values

Since: 4.2

gdaui_basic_form_set_as_reference ()

void
gdaui_basic_form_set_as_reference (GdauiBasicForm *form);

Tells form that the current values in the different entries are to be considered as the original values for all the entries; the immediate consequence is that any sub-sequent call to gdaui_basic_form_has_changed() will return FALSE (of course until any entry is changed).

Since: 4.2

gdaui_basic_form_entry_set_visible ()

void
gdaui_basic_form_entry_set_visible (GdauiBasicForm *form,
                                    GdaHolder *holder,
                                    gboolean show);

Shows or hides the GdauiDataEntry in form which corresponds to the holder data holder

Since: 4.2

gdaui_basic_form_entry_grab_focus ()

void
gdaui_basic_form_entry_grab_focus (GdauiBasicForm *form,
                                   GdaHolder *holder);

Makes the data entry corresponding to holder grab the focus for the window it's in. If holder is NULL, then the focus is on the first entry which needs attention.

Since: 4.2

gdaui_basic_form_entry_set_editable ()

void
gdaui_basic_form_entry_set_editable (GdauiBasicForm *form,
                                     GdaHolder *holder,
                                     gboolean editable);

Sets the GdauiDataEntry in form which corresponds to the holder parameter editable or not. If holder is NULL, then all the parameters are concerned.

Since: 4.2

gdaui_basic_form_set_entries_to_default ()

void
gdaui_basic_form_set_entries_to_default
                               (GdauiBasicForm *form);

For each entry in the form, sets it to a default value if it is possible to do so.

Since: 4.2

gdaui_basic_form_get_entry_widget ()

GtkWidget *
gdaui_basic_form_get_entry_widget (GdauiBasicForm *form,
                                   GdaHolder *holder);

Get the GdauiDataEntry in form which corresponds to the holder place.

Since: 4.2

gdaui_basic_form_get_label_widget ()

GtkWidget *
gdaui_basic_form_get_label_widget (GdauiBasicForm *form,
                                   GdaHolder *holder);

Get the label in form which corresponds to the holder holder.

Since: 4.2

gdaui_basic_form_set_layout_from_file ()

void
gdaui_basic_form_set_layout_from_file (GdauiBasicForm *form,
                                       const gchar *file_name,
                                       const gchar *form_name);

Sets a form layout according an XML description contained in file_name , for the form identified by the form_name name (as an XML layout file can contain the descriptions of several forms and grids).

Since: 4.2

gdaui_basic_form_get_place_holder ()

GtkWidget *
gdaui_basic_form_get_place_holder (GdauiBasicForm *form,
                                   const gchar *placeholder_id);

Retreives a pointer to a place holder widget. This feature is only available if a specific layout has been defined for form using gdaui_basic_form_set_layout_from_file().

Since: 4.2

gdaui_basic_form_add_to_size_group ()

void
gdaui_basic_form_add_to_size_group (GdauiBasicForm *form,
                                    GtkSizeGroup *size_group,
                                    GdauiBasicFormPart part);

Add form 's widgets specified by part to size_group (the widgets can then be removed using gdaui_basic_form_remove_from_size_group()).

Since: 4.2

gdaui_basic_form_remove_from_size_group ()

void
gdaui_basic_form_remove_from_size_group
                               (GdauiBasicForm *form,
                                GtkSizeGroup *size_group,
                                GdauiBasicFormPart part);

Removes form 's widgets specified by part from size_group (the widgets must have been added using gdaui_basic_form_add_to_size_group()).

Since: 4.2

gdaui_basic_form_set_unknown_color ()

void
gdaui_basic_form_set_unknown_color (GdauiBasicForm *form,
                                    gdouble red,
                                    gdouble green,
                                    gdouble blue,
                                    gdouble alpha);

Defines the color to be used when form displays an invalid value. Any value not between 0. and 1. will result in the default hard coded values to be used (grayish).

Since: 5.0.3

struct GdauiBasicForm

struct GdauiBasicForm {
	GtkBox             object;

	GdauiBasicFormPriv *priv;
};

enum GdauiBasicFormPart