<refentry id="GnomeDbSelectorPart">
<refmeta>
<refentrytitle>GnomeDbSelectorPart</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>LIBGNOMEDB-4.0 Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GnomeDbSelectorPart</refname><refpurpose></refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>

<synopsis>



struct      <link linkend="GnomeDbSelectorPart-struct">GnomeDbSelectorPart</link>;
<link linkend="void">void</link>        <link linkend="gnome-db-selector-part-set-name">gnome_db_selector_part_set_name</link> (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part,
                                             const <link linkend="gchar">gchar</link> *name);
const <link linkend="gchar">gchar</link>* <link linkend="gnome-db-selector-part-get-name">gnome_db_selector_part_get_name</link>
                                            (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part);
<link linkend="void">void</link>        <link linkend="gnome-db-selector-part-set-parent-part">gnome_db_selector_part_set_parent_part</link>
                                            (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part,
                                             <link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *parent_part);
<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link>* <link linkend="gnome-db-selector-part-get-parent-part">gnome_db_selector_part_get_parent_part</link>
                                            (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part);
<link linkend="GdkPixbuf">GdkPixbuf</link>*  <link linkend="gnome-db-selector-part-get-pixbuf">gnome_db_selector_part_get_pixbuf</link>
                                            (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part);
<link linkend="void">void</link>        <link linkend="gnome-db-selector-part-fill-tree-store">gnome_db_selector_part_fill_tree_store</link>
                                            (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part,
                                             <link linkend="GtkTreeStore">GtkTreeStore</link> *store,
                                             <link linkend="GtkTreeIter">GtkTreeIter</link> *parent);
<link linkend="GdaSet">GdaSet</link>*     <link linkend="gnome-db-selector-part-get-params">gnome_db_selector_part_get_params</link>
                                            (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part,
                                             <link linkend="GtkTreeStore">GtkTreeStore</link> *store,
                                             <link linkend="GtkTreeIter">GtkTreeIter</link> *at_iter);
<link linkend="GdaSet">GdaSet</link>*     <link linkend="gnome-db-selector-part-get-data">gnome_db_selector_part_get_data</link> (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part,
                                             <link linkend="GtkTreeStore">GtkTreeStore</link> *store,
                                             <link linkend="GtkTreeIter">GtkTreeIter</link> *at_iter);
const <link linkend="GValue">GValue</link>* <link linkend="gnome-db-selector-part-get-value">gnome_db_selector_part_get_value</link>
                                            (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part,
                                             const <link linkend="gchar">gchar</link> *id,
                                             <link linkend="GtkTreeStore">GtkTreeStore</link> *store,
                                             <link linkend="GtkTreeIter">GtkTreeIter</link> *at_iter);

enum        <link linkend="GnomeDbSelectorPartFillMode">GnomeDbSelectorPartFillMode</link>;
<link linkend="void">void</link>        <link linkend="gnome-db-selector-part-obtain-new-store-row">gnome_db_selector_part_obtain_new_store_row</link>
                                            (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part,
                                             <link linkend="GnomeDbSelectorPartFillMode">GnomeDbSelectorPartFillMode</link> *in_out_mode,
                                             <link linkend="GtkTreeStore">GtkTreeStore</link> *store,
                                             <link linkend="GtkTreeIter">GtkTreeIter</link> *iter,
                                             <link linkend="GtkTreeIter">GtkTreeIter</link> *parent_iter);

</synopsis>
</refsynopsisdiv>

<refsect1>
<title>Object Hierarchy</title>
<synopsis>

  <link linkend="GInterface">GInterface</link>
   +----GnomeDbSelectorPart
</synopsis>

</refsect1>

<refsect1>
<title>Prerequisites</title>
<para>
GnomeDbSelectorPart requires
 <link linkend="GObject">GObject</link>.</para>

</refsect1>



<refsect1>
<title>Known Implementations</title>
<para>
GnomeDbSelectorPart is implemented by
 <link linkend="GnomeDbSelectorSchema">GnomeDbSelectorSchema</link>,  <link linkend="GnomeDbSelectorView">GnomeDbSelectorView</link>,  <link linkend="GnomeDbSelectorMeta">GnomeDbSelectorMeta</link> and  <link linkend="GnomeDbSelectorTable">GnomeDbSelectorTable</link>.</para>

</refsect1>




<refsect1>
<title>Description</title>
<para>

</para>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="GnomeDbSelectorPart-struct"/>struct GnomeDbSelectorPart</title>
<indexterm><primary>GnomeDbSelectorPart</primary></indexterm><programlisting>struct GnomeDbSelectorPart;</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="gnome-db-selector-part-set-name"/>gnome_db_selector_part_set_name ()</title>
<indexterm><primary>gnome_db_selector_part_set_name</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_selector_part_set_name (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part,
                                             const <link linkend="gchar">gchar</link> *name);</programlisting>
<para>
Set <parameter>part</parameter>'s name to make it easy to identify</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>part</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbSelectorPart"><type>GnomeDbSelectorPart</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>name</parameter>&nbsp;:</term>
<listitem><simpara> a name for <parameter>part</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-selector-part-get-name"/>gnome_db_selector_part_get_name ()</title>
<indexterm><primary>gnome_db_selector_part_get_name</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* gnome_db_selector_part_get_name
                                            (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part);</programlisting>
<para>
Retreive <parameter>part</parameter>'s name.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>part</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbSelectorPart"><type>GnomeDbSelectorPart</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> <parameter>part</parameter>'s name
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-selector-part-set-parent-part"/>gnome_db_selector_part_set_parent_part ()</title>
<indexterm><primary>gnome_db_selector_part_set_parent_part</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_selector_part_set_parent_part
                                            (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part,
                                             <link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *parent_part);</programlisting>
<para>
Declares to <parameter>part</parameter> that its part parent is <parameter>parent_part</parameter></para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>part</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbSelectorPart"><type>GnomeDbSelectorPart</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>parent_part</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbSelectorPart"><type>GnomeDbSelectorPart</type></link> object, or <literal>NULL</literal>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-selector-part-get-parent-part"/>gnome_db_selector_part_get_parent_part ()</title>
<indexterm><primary>gnome_db_selector_part_get_parent_part</primary></indexterm><programlisting><link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link>* gnome_db_selector_part_get_parent_part
                                            (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part);</programlisting>
<para>
Get the parent of <parameter>part</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>part</parameter>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDbSelectorPart"><type>GnomeDbSelectorPart</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the parent part, or <literal>NULL</literal> if there is none
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-selector-part-get-pixbuf"/>gnome_db_selector_part_get_pixbuf ()</title>
<indexterm><primary>gnome_db_selector_part_get_pixbuf</primary></indexterm><programlisting><link linkend="GdkPixbuf">GdkPixbuf</link>*  gnome_db_selector_part_get_pixbuf
                                            (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part);</programlisting>
<para>
Get the preferred pixbug to be used when representing <parameter>part</parameter></para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>part</parameter>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDbSelectorPart"><type>GnomeDbSelectorPart</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a new <link linkend="GdkPixbuf"><type>GdkPixbuf</type></link> (or <literal>NULL</literal>). The caller must call <link linkend="g-object-unref"><function>g_object_unref()</function></link> on it when finished
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-selector-part-fill-tree-store"/>gnome_db_selector_part_fill_tree_store ()</title>
<indexterm><primary>gnome_db_selector_part_fill_tree_store</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_selector_part_fill_tree_store
                                            (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part,
                                             <link linkend="GtkTreeStore">GtkTreeStore</link> *store,
                                             <link linkend="GtkTreeIter">GtkTreeIter</link> *parent);</programlisting>
<para>
Make <parameter>part</parameter> populate (or refresh) the contents of <parameter>store</parameter>, under the <parameter>parent</parameter> node</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>part</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbSelectorPart"><type>GnomeDbSelectorPart</type></link> object.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>store</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkTreeStore"><type>GtkTreeStore</type></link> 
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>parent</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-selector-part-get-params"/>gnome_db_selector_part_get_params ()</title>
<indexterm><primary>gnome_db_selector_part_get_params</primary></indexterm><programlisting><link linkend="GdaSet">GdaSet</link>*     gnome_db_selector_part_get_params
                                            (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part,
                                             <link linkend="GtkTreeStore">GtkTreeStore</link> *store,
                                             <link linkend="GtkTreeIter">GtkTreeIter</link> *at_iter);</programlisting>
<para>
The caller does not own the returned <link linkend="GdaSet"><type>GdaSet</type></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>part</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbSelectorPart"><type>GnomeDbSelectorPart</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>store</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkTreeStore"><type>GtkTreeStore</type></link>, or <literal>NULL</literal>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>at_iter</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkTreeIter"><type>GtkTreeIter</type></link>, or <literal>NULL</literal>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-selector-part-get-data"/>gnome_db_selector_part_get_data ()</title>
<indexterm><primary>gnome_db_selector_part_get_data</primary></indexterm><programlisting><link linkend="GdaSet">GdaSet</link>*     gnome_db_selector_part_get_data (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part,
                                             <link linkend="GtkTreeStore">GtkTreeStore</link> *store,
                                             <link linkend="GtkTreeIter">GtkTreeIter</link> *at_iter);</programlisting>
<para>
The caller does not own the returned <link linkend="GdaSet"><type>GdaSet</type></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>part</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbSelectorPart"><type>GnomeDbSelectorPart</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>store</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkTreeStore"><type>GtkTreeStore</type></link>, or <literal>NULL</literal>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>at_iter</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkTreeIter"><type>GtkTreeIter</type></link>, or <literal>NULL</literal>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-selector-part-get-value"/>gnome_db_selector_part_get_value ()</title>
<indexterm><primary>gnome_db_selector_part_get_value</primary></indexterm><programlisting>const <link linkend="GValue">GValue</link>* gnome_db_selector_part_get_value
                                            (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part,
                                             const <link linkend="gchar">gchar</link> *id,
                                             <link linkend="GtkTreeStore">GtkTreeStore</link> *store,
                                             <link linkend="GtkTreeIter">GtkTreeIter</link> *at_iter);</programlisting>
<para>
Looks for a value which id is <parameter>id</parameter> in <parameter>part</parameter> (also looks in its parent hierarchy)</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>part</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbSelectorPart"><type>GnomeDbSelectorPart</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>id</parameter>&nbsp;:</term>
<listitem><simpara> the ID of the requested value
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>store</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkTreeStore"><type>GtkTreeStore</type></link>, or <literal>NULL</literal>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>at_iter</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkTreeIter"><type>GtkTreeIter</type></link>, or <literal>NULL</literal>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the (non modifiable) <link linkend="GValue"><type>GValue</type></link>, or <literal>NULL</literal> if not found
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="GnomeDbSelectorPartFillMode"/>enum GnomeDbSelectorPartFillMode</title>
<indexterm><primary>GnomeDbSelectorPartFillMode</primary></indexterm><programlisting>typedef enum {
	GNOME_DB_SELECTOR_PART_FILL_MODE_FIRST_FILL,
	GNOME_DB_SELECTOR_PART_FILL_MODE_OVW_FIRST,
	GNOME_DB_SELECTOR_PART_FILL_MODE_OVW_NEXT
} GnomeDbSelectorPartFillMode;
</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="gnome-db-selector-part-obtain-new-store-row"/>gnome_db_selector_part_obtain_new_store_row ()</title>
<indexterm><primary>gnome_db_selector_part_obtain_new_store_row</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_selector_part_obtain_new_store_row
                                            (<link linkend="GnomeDbSelectorPart">GnomeDbSelectorPart</link> *part,
                                             <link linkend="GnomeDbSelectorPartFillMode">GnomeDbSelectorPartFillMode</link> *in_out_mode,
                                             <link linkend="GtkTreeStore">GtkTreeStore</link> *store,
                                             <link linkend="GtkTreeIter">GtkTreeIter</link> *iter,
                                             <link linkend="GtkTreeIter">GtkTreeIter</link> *parent_iter);</programlisting>
<para>
Reserved for <link linkend="GnomeDbSelectorPart"><type>GnomeDbSelectorPart</type></link> implementations</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>part</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>in_out_mode</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>store</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>iter</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>parent_iter</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>




</refentry>
