![]() |
![]() |
![]() |
Libgnomedb Reference Manual | ![]() |
---|
GnomeDbDataEntryGnomeDbDataEntry — Interface which provides the user with specific widgets to manipulate data |
GnomeDbDataEntry; 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); void gnome_db_data_entry_set_current_as_orig (GnomeDbDataEntry *de); const GdaValue* gnome_db_data_entry_get_value_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); GdaDataHandler* 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, GnomeDbEntryFilesel, GnomeDbEntryTime, GnomeDbEntryCombo, GnomeDbEntryString, GnomeDbEntryCidr and GnomeDbEntryText.
"contents-modified" void user_function (GnomeDbDataEntry *dbdataentry, gpointer user_data); "status-changed" void user_function (GnomeDbDataEntry *dbdataentry, gpointer user_data);
This interface is implemented by widgets to enable users to manipulate data of different types. Such widgets are created by objects implementing the GdaDataHandler interface.
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 : |
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 |
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_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. |
GdaDataHandler* gnome_db_data_entry_get_handler (GnomeDbDataEntry *de);
Fetch the GdaDataHandler the GnomeDbDataEntry is using
de : |
a GtkWidget object which implements the GnomeDbDataEntry interface |
Returns : | the GdaDataHandler 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);
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);
dbdataentry : |
the object which received the signal. |
user_data : |
user data set when the signal handler was connected. |
<< Individual data entry widgets | GnomeDbEntryString >> |