![]() |
![]() |
![]() |
Libgnomedb Reference Manual | ![]() |
---|---|---|---|---|
GnomeDbDataEntryGnomeDbDataEntry — Interface which provides the user with specific widgets to manipulate data |
GnomeDbDataEntry; GnomeDbDataEntryIface; GType gnome_db_data_entry_get_type (void); void gnome_db_data_entry_set_value_type (GnomeDbDataEntry *de, GdaValueType type); GdaValueType gnome_db_data_entry_get_value_type (GnomeDbDataEntry *de); void gnome_db_data_entry_set_value (GnomeDbDataEntry *de, const GdaValue *value); GdaValue* gnome_db_data_entry_get_value (GnomeDbDataEntry *de); void gnome_db_data_entry_set_value_orig (GnomeDbDataEntry *de, const GdaValue *value); const GdaValue* gnome_db_data_entry_get_value_orig (GnomeDbDataEntry *de); void gnome_db_data_entry_set_current_as_orig (GnomeDbDataEntry *de); void gnome_db_data_entry_set_value_default (GnomeDbDataEntry *de, const GdaValue *value); void gnome_db_data_entry_set_attributes (GnomeDbDataEntry *de, guint attrs, guint mask); guint gnome_db_data_entry_get_attributes (GnomeDbDataEntry *de); GnomeDbDataHandler* gnome_db_data_entry_get_handler (GnomeDbDataEntry *de); gboolean gnome_db_data_entry_expand_in_layout (GnomeDbDataEntry *de);
GnomeDbDataEntry is implemented by GnomeDbEntryPassmd5, GnomeDbEntryNone, GnomeDbEntryWrapper, GnomeDbEntryBoolean, GnomeDbEntryTime, GnomeDbEntryCombo, GnomeDbEntryString and GnomeDbEntryCidr.
"contents-modified" void user_function (GnomeDbDataEntry *dbdataentry, gpointer user_data) : Run first "status-changed" void user_function (GnomeDbDataEntry *dbdataentry, gpointer user_data) : Run first
This interface is implemented by widgets to enable users to manipulate data of different types. Such widgets are created by objects implementing the GnomeDbDataHandler interface.
typedef struct { GTypeInterface g_iface; /* signals */ void (* contents_modified) (GnomeDbDataEntry *de); void (* status_changed) (GnomeDbDataEntry *de); /* virtual table */ void ( *set_value_type) (GnomeDbDataEntry *de, GdaValueType type); GdaValueType ( *get_value_type) (GnomeDbDataEntry *de); void ( *set_value) (GnomeDbDataEntry *de, const GdaValue * value); GdaValue *( *get_value) (GnomeDbDataEntry *de); void ( *set_value_orig) (GnomeDbDataEntry *de, const GdaValue * value); const GdaValue *( *get_value_orig) (GnomeDbDataEntry *de); void ( *set_value_default) (GnomeDbDataEntry *de, const GdaValue * value); void ( *set_attributes) (GnomeDbDataEntry *de, guint attrs, guint mask); guint ( *get_attributes) (GnomeDbDataEntry *de); GnomeDbDataHandler *( *get_handler) (GnomeDbDataEntry *de); gboolean ( *expand_in_layout) (GnomeDbDataEntry *de); } GnomeDbDataEntryIface;
void gnome_db_data_entry_set_value_type (GnomeDbDataEntry *de, GdaValueType type);
Sets the type of value the GnomeDbDataEntry will handle. The type must be compatible with what the widget can handle.
de : |
a GtkWidget object which implements the GnomeDbDataEntry interface |
type : |
GdaValueType gnome_db_data_entry_get_value_type (GnomeDbDataEntry *de);
Fetch the type of data the GnomeDbDataEntry handles
de : |
a GtkWidget object which implements the GnomeDbDataEntry interface |
Returns : | the GdaValueType type |
void gnome_db_data_entry_set_value (GnomeDbDataEntry *de, const GdaValue *value);
Push a value into the GnomeDbDataEntry. The value parameter must either be: - NULL or of type GDA_VALUE_TYPE_NULL, or - of type specified using gnome_db_data_entry_set_value_type.
de : |
a GtkWidget object which implements the GnomeDbDataEntry interface |
value : |
GdaValue* gnome_db_data_entry_get_value (GnomeDbDataEntry *de);
Fetch the value held in the GnomeDbDataEntry widget. If the value is set to NULL,
the returned value is of type GDA_VALUE_TYPE_NULL. If the value is set to default,
then the returned value is of type GDA_VALUE_TYPE_NULL or is the default value if it
has been provided to the widget (and is of the same type as the one provided by de
).
de : |
a GtkWidget object which implements the GnomeDbDataEntry interface |
Returns : | a new GdaValue |
void gnome_db_data_entry_set_value_orig (GnomeDbDataEntry *de, const GdaValue *value);
Push a value into the GnomeDbDataEntry in the same way as gnome_db_data_entry_set_value()
but
also sets this value as the original value.
de : |
a GtkWidget object which implements the GnomeDbDataEntry interface |
value : |
const GdaValue* gnome_db_data_entry_get_value_orig (GnomeDbDataEntry *de);
Fetch the original value held in the GnomeDbDataEntry widget
de : |
a GtkWidget object which implements the GnomeDbDataEntry interface |
Returns : | the GdaValue |
void gnome_db_data_entry_set_current_as_orig (GnomeDbDataEntry *de);
Tells that the current value in de
is to be considered as the original value
de : |
a GtkWidget object which implements the GnomeDbDataEntry interface |
void gnome_db_data_entry_set_value_default (GnomeDbDataEntry *de, const GdaValue *value);
Sets the default value for the GnomeDbDataEntry which gets displayed when the user forces the default value. If it is not set then it is set to type GDA_VALUE_TYPE_NULL. The value parameter must either be: - NULL or of type GDA_VALUE_TYPE_NULL, or - of type specified using gnome_db_data_entry_set_value_type.
de : |
a GtkWidget object which implements the GnomeDbDataEntry interface |
value : |
void gnome_db_data_entry_set_attributes (GnomeDbDataEntry *de, guint attrs, guint mask);
Sets the parameters of the GnomeDbDataEntry. Only the attributes corresponding to the mask are set, the other ones are ignored.
de : |
a GtkWidget object which implements the GnomeDbDataEntry interface |
attrs : |
the attributes to set (OR'ed between them) |
mask : |
the mask corresponding to the considered attributes |
guint gnome_db_data_entry_get_attributes (GnomeDbDataEntry *de);
Retreives the parameters of the GnomeDbDataEntry widget.
de : |
a GtkWidget object which implements the GnomeDbDataEntry interface |
Returns : | the OR'ed bits corresponding to the attributes. |
GnomeDbDataHandler* gnome_db_data_entry_get_handler (GnomeDbDataEntry *de);
Fetch the GnomeDbDataHandler the GnomeDbDataEntry is using
de : |
a GtkWidget object which implements the GnomeDbDataEntry interface |
Returns : | the GnomeDbDataHandler object |
gboolean gnome_db_data_entry_expand_in_layout (GnomeDbDataEntry *de);
Used for the layout of the widget in containers.
de : |
a GtkWidget object which implements the GnomeDbDataEntry interface |
Returns : | TRUE if the widget should expand |
void user_function (GnomeDbDataEntry *dbdataentry, gpointer user_data) : Run first
dbdataentry : |
the object which received the signal. |
user_data : |
user data set when the signal handler was connected. |
void user_function (GnomeDbDataEntry *dbdataentry, gpointer user_data) : Run first
dbdataentry : |
the object which received the signal. |
user_data : |
user data set when the signal handler was connected. |