<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="ESource">
<refmeta>
<refentrytitle role="top_of_page" id="ESource.top_of_page">ESource</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>LIBEDATASERVER Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>ESource</refname>
<refpurpose></refpurpose>
</refnamediv>

<refsynopsisdiv id="ESource.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>
                    <link linkend="ESource-struct">ESource</link>;
<link linkend="ESource">ESource</link> *           <link linkend="e-source-new">e_source_new</link>                        (const <link linkend="char">char</link> *name,
                                                         const <link linkend="char">char</link> *relative_uri);
<link linkend="ESource">ESource</link> *           <link linkend="e-source-new-with-absolute-uri">e_source_new_with_absolute_uri</link>      (const <link linkend="char">char</link> *name,
                                                         const <link linkend="char">char</link> *absolute_uri);
<link linkend="ESource">ESource</link> *           <link linkend="e-source-new-from-xml-node">e_source_new_from_xml_node</link>          (<link linkend="xmlNodePtr">xmlNodePtr</link> node);
<link linkend="ESource">ESource</link> *           <link linkend="e-source-new-from-standalone-xml">e_source_new_from_standalone_xml</link>    (const <link linkend="char">char</link> *xml);
<link linkend="ESource">ESource</link> *           <link linkend="e-source-copy">e_source_copy</link>                       (<link linkend="ESource">ESource</link> *source);
<link linkend="gboolean">gboolean</link>            <link linkend="e-source-equal">e_source_equal</link>                      (<link linkend="ESource">ESource</link> *a,
                                                         <link linkend="ESource">ESource</link> *b);
<link linkend="gboolean">gboolean</link>            <link linkend="e-source-update-from-xml-node">e_source_update_from_xml_node</link>       (<link linkend="ESource">ESource</link> *source,
                                                         <link linkend="xmlNodePtr">xmlNodePtr</link> node,
                                                         <link linkend="gboolean">gboolean</link> *changed_return);
<link linkend="char">char</link> *              <link linkend="e-source-uid-from-xml-node">e_source_uid_from_xml_node</link>          (<link linkend="xmlNodePtr">xmlNodePtr</link> node);
<link linkend="void">void</link>                <link linkend="e-source-set-group">e_source_set_group</link>                  (<link linkend="ESource">ESource</link> *source,
                                                         <link linkend="ESourceGroup">ESourceGroup</link> *group);
<link linkend="void">void</link>                <link linkend="e-source-set-name">e_source_set_name</link>                   (<link linkend="ESource">ESource</link> *source,
                                                         const <link linkend="char">char</link> *name);
<link linkend="void">void</link>                <link linkend="e-source-set-relative-uri">e_source_set_relative_uri</link>           (<link linkend="ESource">ESource</link> *source,
                                                         const <link linkend="char">char</link> *relative_uri);
<link linkend="void">void</link>                <link linkend="e-source-set-absolute-uri">e_source_set_absolute_uri</link>           (<link linkend="ESource">ESource</link> *source,
                                                         const <link linkend="char">char</link> *absolute_uri);
<link linkend="void">void</link>                <link linkend="e-source-set-color-spec">e_source_set_color_spec</link>             (<link linkend="ESource">ESource</link> *source,
                                                         const <link linkend="gchar">gchar</link> *color_spec);
<link linkend="void">void</link>                <link linkend="e-source-set-readonly">e_source_set_readonly</link>               (<link linkend="ESource">ESource</link> *source,
                                                         <link linkend="gboolean">gboolean</link> readonly);
<link linkend="void">void</link>                <link linkend="e-source-set-color">e_source_set_color</link>                  (<link linkend="ESource">ESource</link> *source,
                                                         <link linkend="guint32">guint32</link> color);
<link linkend="void">void</link>                <link linkend="e-source-unset-color">e_source_unset_color</link>                (<link linkend="ESource">ESource</link> *source);
<link linkend="ESourceGroup">ESourceGroup</link> *      <link linkend="e-source-peek-group">e_source_peek_group</link>                 (<link linkend="ESource">ESource</link> *source);
const <link linkend="char">char</link> *        <link linkend="e-source-peek-uid">e_source_peek_uid</link>                   (<link linkend="ESource">ESource</link> *source);
const <link linkend="char">char</link> *        <link linkend="e-source-peek-name">e_source_peek_name</link>                  (<link linkend="ESource">ESource</link> *source);
const <link linkend="char">char</link> *        <link linkend="e-source-peek-relative-uri">e_source_peek_relative_uri</link>          (<link linkend="ESource">ESource</link> *source);
const <link linkend="char">char</link> *        <link linkend="e-source-peek-absolute-uri">e_source_peek_absolute_uri</link>          (<link linkend="ESource">ESource</link> *source);
const <link linkend="char">char</link> *        <link linkend="e-source-peek-color-spec">e_source_peek_color_spec</link>            (<link linkend="ESource">ESource</link> *source);
<link linkend="gboolean">gboolean</link>            <link linkend="e-source-get-readonly">e_source_get_readonly</link>               (<link linkend="ESource">ESource</link> *source);
<link linkend="gboolean">gboolean</link>            <link linkend="e-source-get-color">e_source_get_color</link>                  (<link linkend="ESource">ESource</link> *source,
                                                         <link linkend="guint32">guint32</link> *color_return);
<link linkend="char">char</link> *              <link linkend="e-source-get-uri">e_source_get_uri</link>                    (<link linkend="ESource">ESource</link> *source);
<link linkend="void">void</link>                <link linkend="e-source-dump-to-xml-node">e_source_dump_to_xml_node</link>           (<link linkend="ESource">ESource</link> *source,
                                                         <link linkend="xmlNodePtr">xmlNodePtr</link> parent_node);
<link linkend="char">char</link> *              <link linkend="e-source-to-standalone-xml">e_source_to_standalone_xml</link>          (<link linkend="ESource">ESource</link> *source);
const <link linkend="gchar">gchar</link> *       <link linkend="e-source-get-property">e_source_get_property</link>               (<link linkend="ESource">ESource</link> *source,
                                                         const <link linkend="gchar">gchar</link> *property);
<link linkend="void">void</link>                <link linkend="e-source-set-property">e_source_set_property</link>               (<link linkend="ESource">ESource</link> *source,
                                                         const <link linkend="gchar">gchar</link> *property,
                                                         const <link linkend="gchar">gchar</link> *value);
<link linkend="void">void</link>                <link linkend="e-source-foreach-property">e_source_foreach_property</link>           (<link linkend="ESource">ESource</link> *source,
                                                         <link linkend="GHFunc">GHFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> data);
<link linkend="char">char</link> *              <link linkend="e-source-get-duped-property">e_source_get_duped_property</link>         (<link linkend="ESource">ESource</link> *source,
                                                         const <link linkend="char">char</link> *property);
<link linkend="char">char</link> *              <link linkend="e-source-build-absolute-uri">e_source_build_absolute_uri</link>         (<link linkend="ESource">ESource</link> *source);
</synopsis>
</refsynopsisdiv>

<refsect1 id="ESource.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----ESource
</synopsis>
</refsect1>






<refsect1 id="ESource.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<synopsis>
  &quot;<link linkend="ESource-changed">changed</link>&quot;                                        : Run Last
</synopsis>
</refsect1>


<refsect1 id="ESource.description" role="desc">
<title role="desc.title">Description</title>
<para>
</para>
</refsect1>

<refsect1 id="ESource.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="ESource-struct" role="struct">
<title>ESource</title>
<indexterm zone="ESource-struct"><primary sortas="ESource">ESource</primary></indexterm><programlisting>typedef struct _ESource ESource;</programlisting>
<para>
</para></refsect2>
<refsect2 id="e-source-new" role="function">
<title>e_source_new ()</title>
<indexterm zone="e-source-new"><primary sortas="e_source_new">e_source_new</primary></indexterm><programlisting><link linkend="ESource">ESource</link> *           e_source_new                        (const <link linkend="char">char</link> *name,
                                                         const <link linkend="char">char</link> *relative_uri);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>relative_uri</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-new-with-absolute-uri" role="function">
<title>e_source_new_with_absolute_uri ()</title>
<indexterm zone="e-source-new-with-absolute-uri"><primary sortas="e_source_new_with_absolute_uri">e_source_new_with_absolute_uri</primary></indexterm><programlisting><link linkend="ESource">ESource</link> *           e_source_new_with_absolute_uri      (const <link linkend="char">char</link> *name,
                                                         const <link linkend="char">char</link> *absolute_uri);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>absolute_uri</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-new-from-xml-node" role="function">
<title>e_source_new_from_xml_node ()</title>
<indexterm zone="e-source-new-from-xml-node"><primary sortas="e_source_new_from_xml_node">e_source_new_from_xml_node</primary></indexterm><programlisting><link linkend="ESource">ESource</link> *           e_source_new_from_xml_node          (<link linkend="xmlNodePtr">xmlNodePtr</link> node);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>node</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-new-from-standalone-xml" role="function">
<title>e_source_new_from_standalone_xml ()</title>
<indexterm zone="e-source-new-from-standalone-xml"><primary sortas="e_source_new_from_standalone_xml">e_source_new_from_standalone_xml</primary></indexterm><programlisting><link linkend="ESource">ESource</link> *           e_source_new_from_standalone_xml    (const <link linkend="char">char</link> *xml);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>xml</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-copy" role="function">
<title>e_source_copy ()</title>
<indexterm zone="e-source-copy"><primary sortas="e_source_copy">e_source_copy</primary></indexterm><programlisting><link linkend="ESource">ESource</link> *           e_source_copy                       (<link linkend="ESource">ESource</link> *source);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-equal" role="function">
<title>e_source_equal ()</title>
<indexterm zone="e-source-equal"><primary sortas="e_source_equal">e_source_equal</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            e_source_equal                      (<link linkend="ESource">ESource</link> *a,
                                                         <link linkend="ESource">ESource</link> *b);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>a</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>b</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-update-from-xml-node" role="function">
<title>e_source_update_from_xml_node ()</title>
<indexterm zone="e-source-update-from-xml-node"><primary sortas="e_source_update_from_xml_node">e_source_update_from_xml_node</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            e_source_update_from_xml_node       (<link linkend="ESource">ESource</link> *source,
                                                         <link linkend="xmlNodePtr">xmlNodePtr</link> node,
                                                         <link linkend="gboolean">gboolean</link> *changed_return);</programlisting>
<para>
Update the ESource properties from <parameter>node</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara> An ESource.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>node</parameter>&#160;:</term>
<listitem><simpara> A pointer to the node to parse.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>changed_return</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the data in <parameter>node</parameter> was recognized and parsed into
acceptable values for <parameter>source</parameter>, <link linkend="FALSE--CAPS"><literal>FALSE</literal></link> otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-uid-from-xml-node" role="function">
<title>e_source_uid_from_xml_node ()</title>
<indexterm zone="e-source-uid-from-xml-node"><primary sortas="e_source_uid_from_xml_node">e_source_uid_from_xml_node</primary></indexterm><programlisting><link linkend="char">char</link> *              e_source_uid_from_xml_node          (<link linkend="xmlNodePtr">xmlNodePtr</link> node);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>node</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-set-group" role="function">
<title>e_source_set_group ()</title>
<indexterm zone="e-source-set-group"><primary sortas="e_source_set_group">e_source_set_group</primary></indexterm><programlisting><link linkend="void">void</link>                e_source_set_group                  (<link linkend="ESource">ESource</link> *source,
                                                         <link linkend="ESourceGroup">ESourceGroup</link> *group);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>group</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-set-name" role="function">
<title>e_source_set_name ()</title>
<indexterm zone="e-source-set-name"><primary sortas="e_source_set_name">e_source_set_name</primary></indexterm><programlisting><link linkend="void">void</link>                e_source_set_name                   (<link linkend="ESource">ESource</link> *source,
                                                         const <link linkend="char">char</link> *name);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-set-relative-uri" role="function">
<title>e_source_set_relative_uri ()</title>
<indexterm zone="e-source-set-relative-uri"><primary sortas="e_source_set_relative_uri">e_source_set_relative_uri</primary></indexterm><programlisting><link linkend="void">void</link>                e_source_set_relative_uri           (<link linkend="ESource">ESource</link> *source,
                                                         const <link linkend="char">char</link> *relative_uri);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>relative_uri</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-set-absolute-uri" role="function">
<title>e_source_set_absolute_uri ()</title>
<indexterm zone="e-source-set-absolute-uri"><primary sortas="e_source_set_absolute_uri">e_source_set_absolute_uri</primary></indexterm><programlisting><link linkend="void">void</link>                e_source_set_absolute_uri           (<link linkend="ESource">ESource</link> *source,
                                                         const <link linkend="char">char</link> *absolute_uri);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>absolute_uri</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-set-color-spec" role="function" condition="since:1.10">
<title>e_source_set_color_spec ()</title>
<indexterm zone="e-source-set-color-spec" role="1.10"><primary sortas="e_source_set_color_spec">e_source_set_color_spec</primary></indexterm><programlisting><link linkend="void">void</link>                e_source_set_color_spec             (<link linkend="ESource">ESource</link> *source,
                                                         const <link linkend="gchar">gchar</link> *color_spec);</programlisting>
<para>
Store a textual representation of a color in <parameter>source</parameter>.  The <parameter>color_spec</parameter>
string should be parsable by #<link linkend="gdk-color-parse"><function>gdk_color_parse()</function></link>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> to unset the
color in <parameter>source</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara> an ESource
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>color_spec</parameter>&#160;:</term>
<listitem><simpara> a string specifying the color
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.10</para></refsect2>
<refsect2 id="e-source-set-readonly" role="function">
<title>e_source_set_readonly ()</title>
<indexterm zone="e-source-set-readonly"><primary sortas="e_source_set_readonly">e_source_set_readonly</primary></indexterm><programlisting><link linkend="void">void</link>                e_source_set_readonly               (<link linkend="ESource">ESource</link> *source,
                                                         <link linkend="gboolean">gboolean</link> readonly);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>readonly</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-set-color" role="function" condition="deprecated:">
<title>e_source_set_color ()</title>
<indexterm zone="e-source-set-color" role="deprecated"><primary sortas="e_source_set_color">e_source_set_color</primary></indexterm><programlisting><link linkend="void">void</link>                e_source_set_color                  (<link linkend="ESource">ESource</link> *source,
                                                         <link linkend="guint32">guint32</link> color);</programlisting>
<warning><para><literal>e_source_set_color</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>color</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-unset-color" role="function" condition="deprecated:">
<title>e_source_unset_color ()</title>
<indexterm zone="e-source-unset-color" role="deprecated"><primary sortas="e_source_unset_color">e_source_unset_color</primary></indexterm><programlisting><link linkend="void">void</link>                e_source_unset_color                (<link linkend="ESource">ESource</link> *source);</programlisting>
<warning><para><literal>e_source_unset_color</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-peek-group" role="function">
<title>e_source_peek_group ()</title>
<indexterm zone="e-source-peek-group"><primary sortas="e_source_peek_group">e_source_peek_group</primary></indexterm><programlisting><link linkend="ESourceGroup">ESourceGroup</link> *      e_source_peek_group                 (<link linkend="ESource">ESource</link> *source);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-peek-uid" role="function">
<title>e_source_peek_uid ()</title>
<indexterm zone="e-source-peek-uid"><primary sortas="e_source_peek_uid">e_source_peek_uid</primary></indexterm><programlisting>const <link linkend="char">char</link> *        e_source_peek_uid                   (<link linkend="ESource">ESource</link> *source);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-peek-name" role="function">
<title>e_source_peek_name ()</title>
<indexterm zone="e-source-peek-name"><primary sortas="e_source_peek_name">e_source_peek_name</primary></indexterm><programlisting>const <link linkend="char">char</link> *        e_source_peek_name                  (<link linkend="ESource">ESource</link> *source);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-peek-relative-uri" role="function">
<title>e_source_peek_relative_uri ()</title>
<indexterm zone="e-source-peek-relative-uri"><primary sortas="e_source_peek_relative_uri">e_source_peek_relative_uri</primary></indexterm><programlisting>const <link linkend="char">char</link> *        e_source_peek_relative_uri          (<link linkend="ESource">ESource</link> *source);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-peek-absolute-uri" role="function">
<title>e_source_peek_absolute_uri ()</title>
<indexterm zone="e-source-peek-absolute-uri"><primary sortas="e_source_peek_absolute_uri">e_source_peek_absolute_uri</primary></indexterm><programlisting>const <link linkend="char">char</link> *        e_source_peek_absolute_uri          (<link linkend="ESource">ESource</link> *source);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-peek-color-spec" role="function" condition="since:1.10">
<title>e_source_peek_color_spec ()</title>
<indexterm zone="e-source-peek-color-spec" role="1.10"><primary sortas="e_source_peek_color_spec">e_source_peek_color_spec</primary></indexterm><programlisting>const <link linkend="char">char</link> *        e_source_peek_color_spec            (<link linkend="ESource">ESource</link> *source);</programlisting>
<para>
Return the textual representation of the color for <parameter>source</parameter>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if it
has none.  The returned string should be parsable by #<link linkend="gdk-color-parse"><function>gdk_color_parse()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara> an ESource
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a string specifying the color

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.10</para></refsect2>
<refsect2 id="e-source-get-readonly" role="function">
<title>e_source_get_readonly ()</title>
<indexterm zone="e-source-get-readonly"><primary sortas="e_source_get_readonly">e_source_get_readonly</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            e_source_get_readonly               (<link linkend="ESource">ESource</link> *source);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-get-color" role="function" condition="deprecated:">
<title>e_source_get_color ()</title>
<indexterm zone="e-source-get-color" role="deprecated"><primary sortas="e_source_get_color">e_source_get_color</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            e_source_get_color                  (<link linkend="ESource">ESource</link> *source,
                                                         <link linkend="guint32">guint32</link> *color_return);</programlisting>
<warning><para><literal>e_source_get_color</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
If <parameter>source</parameter> has an associated color, return it in *<parameter>color_return</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara> An ESource
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>color_return</parameter>&#160;:</term>
<listitem><simpara> Pointer to a variable where the returned color will be
stored.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the <parameter>source</parameter> has a defined color (and hence
*<parameter>color_return</parameter> was set), <link linkend="FALSE--CAPS"><literal>FALSE</literal></link> otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-get-uri" role="function">
<title>e_source_get_uri ()</title>
<indexterm zone="e-source-get-uri"><primary sortas="e_source_get_uri">e_source_get_uri</primary></indexterm><programlisting><link linkend="char">char</link> *              e_source_get_uri                    (<link linkend="ESource">ESource</link> *source);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-dump-to-xml-node" role="function">
<title>e_source_dump_to_xml_node ()</title>
<indexterm zone="e-source-dump-to-xml-node"><primary sortas="e_source_dump_to_xml_node">e_source_dump_to_xml_node</primary></indexterm><programlisting><link linkend="void">void</link>                e_source_dump_to_xml_node           (<link linkend="ESource">ESource</link> *source,
                                                         <link linkend="xmlNodePtr">xmlNodePtr</link> parent_node);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>parent_node</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-to-standalone-xml" role="function">
<title>e_source_to_standalone_xml ()</title>
<indexterm zone="e-source-to-standalone-xml"><primary sortas="e_source_to_standalone_xml">e_source_to_standalone_xml</primary></indexterm><programlisting><link linkend="char">char</link> *              e_source_to_standalone_xml          (<link linkend="ESource">ESource</link> *source);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-get-property" role="function">
<title>e_source_get_property ()</title>
<indexterm zone="e-source-get-property"><primary sortas="e_source_get_property">e_source_get_property</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> *       e_source_get_property               (<link linkend="ESource">ESource</link> *source,
                                                         const <link linkend="gchar">gchar</link> *property);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>property</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-set-property" role="function">
<title>e_source_set_property ()</title>
<indexterm zone="e-source-set-property"><primary sortas="e_source_set_property">e_source_set_property</primary></indexterm><programlisting><link linkend="void">void</link>                e_source_set_property               (<link linkend="ESource">ESource</link> *source,
                                                         const <link linkend="gchar">gchar</link> *property,
                                                         const <link linkend="gchar">gchar</link> *value);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>property</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-foreach-property" role="function">
<title>e_source_foreach_property ()</title>
<indexterm zone="e-source-foreach-property"><primary sortas="e_source_foreach_property">e_source_foreach_property</primary></indexterm><programlisting><link linkend="void">void</link>                e_source_foreach_property           (<link linkend="ESource">ESource</link> *source,
                                                         <link linkend="GHFunc">GHFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-get-duped-property" role="function">
<title>e_source_get_duped_property ()</title>
<indexterm zone="e-source-get-duped-property"><primary sortas="e_source_get_duped_property">e_source_get_duped_property</primary></indexterm><programlisting><link linkend="char">char</link> *              e_source_get_duped_property         (<link linkend="ESource">ESource</link> *source,
                                                         const <link linkend="char">char</link> *property);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>property</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="e-source-build-absolute-uri" role="function">
<title>e_source_build_absolute_uri ()</title>
<indexterm zone="e-source-build-absolute-uri"><primary sortas="e_source_build_absolute_uri">e_source_build_absolute_uri</primary></indexterm><programlisting><link linkend="char">char</link> *              e_source_build_absolute_uri         (<link linkend="ESource">ESource</link> *source);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>source</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>

<refsect1 id="ESource.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="ESource-changed"><title>The <literal>&quot;changed&quot;</literal> signal</title>
<indexterm zone="ESource-changed"><primary sortas="ESource::changed">ESource::changed</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="ESource">ESource</link> *esource,
                                                        <link linkend="gpointer">gpointer</link> user_data)      : Run Last</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>esource</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2>
</refsect1>



</refentry>
