![]() |
![]() |
![]() |
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. |