![]() |
![]() |
![]() |
Libgnomedb Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Known Implementations | Signals |
GnomeDbDataEntryGnomeDbDataEntry — Interface which provides the user with specific widgets to manipulate data |
GnomeDbDataEntry; void gnome_db_data_entry_set_value_type (GnomeDbDataEntry *de, GType type); GType gnome_db_data_entry_get_value_type (GnomeDbDataEntry *de); void gnome_db_data_entry_set_value (GnomeDbDataEntry *de, const GValue *value); GValue * gnome_db_data_entry_get_value (GnomeDbDataEntry *de); void gnome_db_data_entry_set_value_orig (GnomeDbDataEntry *de, const GValue *value); void gnome_db_data_entry_set_current_as_orig (GnomeDbDataEntry *de); const GValue * gnome_db_data_entry_get_value_orig (GnomeDbDataEntry *de); void gnome_db_data_entry_set_value_default (GnomeDbDataEntry *de, const GValue *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); void gnome_db_data_entry_set_editable (GnomeDbDataEntry *de, gboolean editable);
GnomeDbDataEntry is implemented by GnomeDbEntryTimestamp, GnomeDbEntryDate, GnomeDbEntryPassmd5, GnomeDbEntryNone, GnomeDbEntryCommonTime, GnomeDbEntryWrapper, GnomeDbEntryBoolean, GnomeDbEntryFilesel, GnomeDbEntryTime, GnomeDbEntryCombo, GnomeDbEntryString, GnomeDbEntryCidr and GnomeDbEntryText.
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, GType type);
Sets the type of value the GnomeDbDataEntry will handle. The type must be compatible with what the widget can handle.
|
a GtkWidget object which implements the GnomeDbDataEntry interface |
|
GType gnome_db_data_entry_get_value_type (GnomeDbDataEntry *de);
Fetch the type of data the GnomeDbDataEntry handles
|
a GtkWidget object which implements the GnomeDbDataEntry interface |
Returns : |
the GType type |
void gnome_db_data_entry_set_value (GnomeDbDataEntry *de, const GValue *value);
Push a value into the GnomeDbDataEntry. The value parameter must either be: - NULL or of type GDA_TYPE_NULL, or - of type specified using gnome_db_data_entry_set_value_type.
|
a GtkWidget object which implements the GnomeDbDataEntry interface |
|
GValue * 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_TYPE_NULL. If the value is set to default,
then the returned value is of type GDA_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
).
|
a GtkWidget object which implements the GnomeDbDataEntry interface |
Returns : |
a new GValue |
void gnome_db_data_entry_set_value_orig (GnomeDbDataEntry *de, const GValue *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.
|
a GtkWidget object which implements the GnomeDbDataEntry interface |
|
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
|
a GtkWidget object which implements the GnomeDbDataEntry interface |
const GValue * gnome_db_data_entry_get_value_orig (GnomeDbDataEntry *de);
Fetch the original value held in the GnomeDbDataEntry widget
|
a GtkWidget object which implements the GnomeDbDataEntry interface |
Returns : |
the GValue |
void gnome_db_data_entry_set_value_default (GnomeDbDataEntry *de, const GValue *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_TYPE_NULL. The value parameter must either be: - NULL or of type GDA_TYPE_NULL, or - of type specified using gnome_db_data_entry_set_value_type.
|
a GtkWidget object which implements the GnomeDbDataEntry interface |
|
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.
|
a GtkWidget object which implements the GnomeDbDataEntry interface |
|
the attributes to set (OR'ed between them) |
|
the mask corresponding to the considered attributes |
guint gnome_db_data_entry_get_attributes (GnomeDbDataEntry *de);
Retreives the parameters of the GnomeDbDataEntry widget.
|
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
|
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.
|
a GtkWidget object which implements the GnomeDbDataEntry interface |
Returns : |
TRUE if the widget should expand |
void gnome_db_data_entry_set_editable (GnomeDbDataEntry *de, gboolean editable);
Set if de
can be modified or not by the user
|
a GtkWidget object which implements the GnomeDbDataEntry interface |
|
"contents-modified"
signalvoid user_function (GnomeDbDataEntry *dbdataentry, gpointer user_data) : Run First
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
"status-changed"
signalvoid user_function (GnomeDbDataEntry *dbdataentry, gpointer user_data) : Run First
|
the object which received the signal. |
|
user data set when the signal handler was connected. |