| GNOME Data Access 5 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_reference_value (GdauiDataEntry *de,const GValue *value); const GValue * gdaui_data_entry_get_reference_value (GdauiDataEntry *de); void gdaui_data_entry_set_reference_current (GdauiDataEntry *de); void gdaui_data_entry_set_default_value (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_can_expand (GdauiDataEntry *de,gboolean horiz); void gdaui_data_entry_set_editable (GdauiDataEntry *de,gboolean editable); gboolean gdaui_data_entry_get_editable (GdauiDataEntry *de); void gdaui_data_entry_grab_focus (GdauiDataEntry *de);
"contents-activated" :Run First"contents-modified" :Run First"contents-valid" :Run Last"expand-changed" :Run First"status-changed" :Run First
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 |
|
the GType of the data to be displayed |
Since 4.2
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 |
Since 4.2
void gdaui_data_entry_set_value (GdauiDataEntry *de,const GValue *value);
Push a value into the GdauiDataEntry. The value parameter must either be:
of type GDA_TYPE_NULL (may be created using gda_value_new_null()) to
represent a NULL value (SQL NULL), or
of type specified using gdaui_data_entry_set_value_type(), or
NULL to represent an undetermined value (usually an error)
|
a GtkWidget object which implements the GdauiDataEntry interface |
|
a GValue, or NULL. [allow-none]
|
Since 4.2
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. [transfer none] |
Since 4.2
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. [allow-none]
|
Returns : |
TRUE if de's contents is valid |
Since 4.2
void gdaui_data_entry_set_reference_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 reference value.
|
a GtkWidget object which implements the GdauiDataEntry interface |
|
a GValue, or NULL. [allow-none]
|
Since 4.2
const GValue * gdaui_data_entry_get_reference_value
(GdauiDataEntry *de);
Fetch the reference value held in the GdauiDataEntry widget
|
a GtkWidget object which implements the GdauiDataEntry interface |
Returns : |
the GValue (not modifiable). [transfer none] |
Since 4.2
void gdaui_data_entry_set_reference_current
(GdauiDataEntry *de);
Tells that the current value in de is to be considered as the reference value
|
a GtkWidget object which implements the GdauiDataEntry interface |
Since 4.2
void gdaui_data_entry_set_default_value (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 |
|
a GValue, or NULL. [allow-none]
|
Since 4.2
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 |
Since 4.2
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. |
Since 4.2
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. [transfer none] |
Since 4.2
gboolean gdaui_data_entry_can_expand (GdauiDataEntry *de,gboolean horiz);
Used for the layout of GdaDataEntry widgets in containers: queries if de requires
horizontal or vertical expansion, depending on horiz
|
a GtkWidget object which implements the GdauiDataEntry interface |
|
TRUE to query horizontal expansion requirements, or FALSE for vertical |
Returns : |
TRUE if the widget requires expansion |
Since 4.2
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 |
|
set to TRUE to have an editable data entry |
Since 4.2
gboolean gdaui_data_entry_get_editable (GdauiDataEntry *de);
Tells if de can be edited by the user
|
a GtkWidget object which implements the GdauiDataEntry interface |
Returns : |
TRUE if de is editable |
Since 4.2
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 |
Since 4.2
"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. |
"expand-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. |
"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. |