<!-- ##### SECTION Title ##### -->
GnomeDbDataWidget

<!-- ##### SECTION Short_Description ##### -->
Interface to control data bound widgets

<!-- ##### SECTION Long_Description ##### -->
<para>
The #GnomeDbDataWidget is a common interface implemented by some data bound widgets which have the following in
common:
<itemizedlist>
  <listitem><para>The data to display in the widget is contained in a #GdaDataModel object (a "source" of data)
    </para>
  </listitem>
  <listitem><para>If the "source" GdaDataModel allows it, modifications can be made (modifying existing rows,
    adding new rows, or removing some rows). Those modifications are internally stored in a #GdaDataProxy object.
    (note that a #GdaDataProxy object is always created, except if the "source" data model is itself a GdaDataProxy
    object)</para>
  </listitem>
  <listitem><para>The widget also internally uses a #GdaDataModelIter object which represents the current "selected"
    row (the selected row, or the one displayed).</para>
  </listitem>
  <listitem><para>Writing back the modifications stored in the GdaDataProxy to the "source" data model is by default
      done only when requested, but can be specified otherwise (see gnome_db_data_widget_set_write_mode())</para>
  </listitem>
</itemizedlist>
</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### SECTION Stability_Level ##### -->


<!-- ##### STRUCT GnomeDbDataWidget ##### -->
<para>

</para>


<!-- ##### SIGNAL GnomeDbDataWidget::iter-changed ##### -->
<para>

</para>

@dbdatawidget: the object which received the signal.
@arg1: 

<!-- ##### SIGNAL GnomeDbDataWidget::proxy-changed ##### -->
<para>

</para>

@dbdatawidget: the object which received the signal.
@arg1: 

<!-- ##### ENUM GnomeDbDataWidgetWriteMode ##### -->
<para>
Determines how modified data (stored in the #GdaDataProxy object used internally by each
#GnomeDbDataWidget) is written back to the #GdaDataModel which contains data to be displayed.
</para>

@GNOME_DB_DATA_WIDGET_WRITE_ON_DEMAND: Modifications are written back on explicit demand (in this case all the modifications made to any row is written back)
@GNOME_DB_DATA_WIDGET_WRITE_ON_ROW_CHANGE: Modifications are written back when the currently selected row changes (as when selecting another row), in this case only the modifications on the current row are written back
@GNOME_DB_DATA_WIDGET_WRITE_ON_VALUE_ACTIVATED: Modifications are written back when the user "activates" the data entry (for example by pressing ENTER in a single line data entry), in this case only the modifications on the current row are written back
@GNOME_DB_DATA_WIDGET_WRITE_ON_VALUE_CHANGE: Modifications are written back everytime a value changes (for instance everytime a letter is types when entering text); in this case only the modifications on the current row are written back (this option should only be used if the "source" data model accepts modifications without any test and without processing delays).

<!-- ##### FUNCTION gnome_db_data_widget_get_proxy ##### -->
<para>

</para>

@iface: 
@Returns: 


<!-- ##### FUNCTION gnome_db_data_widget_get_actions_group ##### -->
<para>

</para>

@iface: 
@Returns: 


<!-- ##### FUNCTION gnome_db_data_widget_perform_action ##### -->
<para>

</para>

@iface: 
@action: 


<!-- ##### FUNCTION gnome_db_data_widget_column_show ##### -->
<para>

</para>

@iface: 
@column: 


<!-- ##### FUNCTION gnome_db_data_widget_column_hide ##### -->
<para>

</para>

@iface: 
@column: 


<!-- ##### FUNCTION gnome_db_data_widget_column_set_editable ##### -->
<para>

</para>

@iface: 
@column: 
@editable: 


<!-- ##### FUNCTION gnome_db_data_widget_column_show_actions ##### -->
<para>

</para>

@iface: 
@column: 
@show_actions: 


<!-- ##### FUNCTION gnome_db_data_widget_get_current_data ##### -->
<para>

</para>

@iface: 
@Returns: 


<!-- ##### FUNCTION gnome_db_data_widget_get_gda_model ##### -->
<para>

</para>

@iface: 
@Returns: 


<!-- ##### FUNCTION gnome_db_data_widget_set_gda_model ##### -->
<para>

</para>

@iface: 
@model: 


<!-- ##### FUNCTION gnome_db_data_widget_set_write_mode ##### -->
<para>

</para>

@iface: 
@mode: 
@Returns: 


<!-- ##### FUNCTION gnome_db_data_widget_get_write_mode ##### -->
<para>

</para>

@iface: 
@Returns: 


