![]() |
![]() |
![]() |
GNOME Data Access 4 manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Signals |
GdauiDataEntry; void gdaui_data_entry_set_value_type (GdauiDataEntry *de, GType type); GType gdaui_data_entry_get_value_type (GdauiDataEntry *de); void gdaui_data_entry_set_value (GdauiDataEntry *de, const GValue *value); GValue * gdaui_data_entry_get_value (GdauiDataEntry *de); gboolean gdaui_data_entry_content_is_valid (GdauiDataEntry *de, GError **error); void gdaui_data_entry_set_original_value (GdauiDataEntry *de, const GValue *value); const GValue * gdaui_data_entry_get_original_value (GdauiDataEntry *de); void gdaui_data_entry_reset (GdauiDataEntry *de); void gdaui_data_entry_set_value_default (GdauiDataEntry *de, const GValue *value); void gdaui_data_entry_set_attributes (GdauiDataEntry *de, GdaValueAttribute attrs, GdaValueAttribute mask); GdaValueAttribute gdaui_data_entry_get_attributes (GdauiDataEntry *de); GdaDataHandler * gdaui_data_entry_get_handler (GdauiDataEntry *de); gboolean gdaui_data_entry_expand_in_layout (GdauiDataEntry *de); void gdaui_data_entry_set_editable (GdauiDataEntry *de, gboolean editable); void gdaui_data_entry_grab_focus (GdauiDataEntry *de);
"contents-activated" : Run First "contents-modified" : Run First "contents-valid" : Run Last "status-changed" : Run First
The GdaUiDataEntry is an interface for widgets (simple or complex) which lets the user view and/or modify a GValue.
GdaUiDataEntry widgets are normally created using the gdaui_new_data_entry()
function.
void gdaui_data_entry_set_value_type (GdauiDataEntry *de, GType type);
Sets the type of value the GdauiDataEntry will handle. The type must be compatible with what the widget can handle.
|
a GtkWidget object which implements the GdauiDataEntry interface |
|
GType gdaui_data_entry_get_value_type (GdauiDataEntry *de);
Fetch the type of data the GdauiDataEntry handles
|
a GtkWidget object which implements the GdauiDataEntry interface |
Returns : |
the GType type |
void gdaui_data_entry_set_value (GdauiDataEntry *de, const GValue *value);
Push a value into the GdauiDataEntry. The value parameter must either be: - NULL or of type GDA_TYPE_NULL, or - of type specified using gdaui_data_entry_set_value_type.
|
a GtkWidget object which implements the GdauiDataEntry interface |
|
GValue * gdaui_data_entry_get_value (GdauiDataEntry *de);
Fetch the value held in the GdauiDataEntry 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 GdauiDataEntry interface |
Returns : |
a new GValue |
gboolean gdaui_data_entry_content_is_valid (GdauiDataEntry *de, GError **error);
Tests the validity of de
's contents. The validity is a determined from:
the de
widget itself if it is capable of doing it (depending on the implementation)
the results of the "contents_valid" signal which can be connected from
|
a GtkWidget object which implements the GdauiDataEntry interface |
|
a place to store an error, or NULL
|
Returns : |
TRUE if de 's contents is valid
|
void gdaui_data_entry_set_original_value (GdauiDataEntry *de, const GValue *value);
Push a value into the GdauiDataEntry in the same way as gdaui_data_entry_set_value()
but
also sets this value as the original value.
|
a GtkWidget object which implements the GdauiDataEntry interface |
|
const GValue * gdaui_data_entry_get_original_value (GdauiDataEntry *de);
Fetch the original value held in the GdauiDataEntry widget
|
a GtkWidget object which implements the GdauiDataEntry interface |
Returns : |
the GValue |
void gdaui_data_entry_reset (GdauiDataEntry *de);
Tells that the current value in de
is to be considered as the original value
|
a GtkWidget object which implements the GdauiDataEntry interface |
void gdaui_data_entry_set_value_default (GdauiDataEntry *de, const GValue *value);
Sets the default value for the GdauiDataEntry 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 gdaui_data_entry_set_value_type.
|
a GtkWidget object which implements the GdauiDataEntry interface |
|
void gdaui_data_entry_set_attributes (GdauiDataEntry *de, GdaValueAttribute attrs, GdaValueAttribute mask);
Sets the parameters of the GdauiDataEntry. Only the attributes corresponding to the mask are set, the other ones are ignored.
|
a GtkWidget object which implements the GdauiDataEntry interface |
|
the attributes to set (OR'ed between them) |
|
the mask corresponding to the considered attributes |
GdaValueAttribute gdaui_data_entry_get_attributes (GdauiDataEntry *de);
Retrieves the parameters of the GdauiDataEntry widget.
|
a GtkWidget object which implements the GdauiDataEntry interface |
Returns : |
the OR'ed bits corresponding to the attributes. |
GdaDataHandler * gdaui_data_entry_get_handler (GdauiDataEntry *de);
Fetch the GdaDataHandler the GdauiDataEntry is using
|
a GtkWidget object which implements the GdauiDataEntry interface |
Returns : |
the GdaDataHandler object |
gboolean gdaui_data_entry_expand_in_layout (GdauiDataEntry *de);
Used for the layout of the widget in containers.
|
a GtkWidget object which implements the GdauiDataEntry interface |
Returns : |
TRUE if the widget should expand |
void gdaui_data_entry_set_editable (GdauiDataEntry *de, gboolean editable);
Set if de
can be modified or not by the user
|
a GtkWidget object which implements the GdauiDataEntry interface |
|
void gdaui_data_entry_grab_focus (GdauiDataEntry *de);
Makes de
grab the focus for the window it's in
|
a GtkWidget object which implements the GdauiDataEntry interface |
"contents-activated"
signalvoid user_function (GdauiDataEntry *gdauidataentry, gpointer user_data) : Run First
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
"contents-modified"
signalvoid user_function (GdauiDataEntry *gdauidataentry, gpointer user_data) : Run First
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
"contents-valid"
signalgboolean user_function (GdauiDataEntry *gdauidataentry, gpointer arg1, gpointer user_data) : Run Last
|
the object which received the signal. |
|
|
|
user data set when the signal handler was connected. |
Returns : |
"status-changed"
signalvoid user_function (GdauiDataEntry *gdauidataentry, gpointer user_data) : Run First
|
the object which received the signal. |
|
user data set when the signal handler was connected. |