~ubuntu-branches/ubuntu/quantal/evolution-data-server/quantal

« back to all changes in this revision

Viewing changes to docs/reference/libedataserverui/html/ESourceSelector.html

  • Committer: Package Import Robot
  • Author(s): Mathieu Trudel-Lapierre
  • Date: 2012-07-03 22:41:23 UTC
  • mfrom: (1.1.100)
  • Revision ID: package-import@ubuntu.com-20120703224123-90dydkyfyvff8s0s
Tags: 3.5.3.1-0ubuntu1
* New upstream release 3.5.3.1.
* debian/control:
  - Drop libgconf2-dev from Build-Depends.
  - Bump versions for glib, goa, and libsoup in Build-Depends.
  - Add a Build-Depends on libgcr-3-dev (>= 3.4)
  - Rename packages following upstream SONAME changes.
  - Add Depends on libgnome-keyring-dev to libedataserver1.2-dev.
* debian/rules:
  - Update mkshlibs arguments for libcamel-1.2-38 instead of -33; as it was
    renamed in control due to the soname change.
  - Strip out -Bsymbolic-functions from LDFLAGS.
* Renamed install files in debian/:
  - libcamel-1.2-33.install => libcamel-1.2-38.install
  - libebackend-1.2-2.install => libebackend-1.2-4.install
  - libebook-1.2-13.install => libebook-1.2-17.install
  - libecal-1.2-11.install => libecal-1.2-15.install
  - libedata-book-1.2-13.install => libedata-book-1.2-15.install
  - libedata-cal-1.2-15.install => libedata-cal-1.2-18.install
  - libedataserver-1.2-16.install => libedataserver-1.2-17.install
  - libedataserverui-3.0-1.install => libedataserverui-3.0-4.install
* debian/patches/google_tests_fpic.patch: build tests with -fPIC; otherwise
  build fails.

Show diffs side-by-side

added added

removed removed

Lines of Context:
46
46
<div class="refsynopsisdiv">
47
47
<a name="ESourceSelector.synopsis"></a><h2>Synopsis</h2>
48
48
<pre class="synopsis">struct              <a class="link" href="ESourceSelector.html#ESourceSelector-struct" title="struct ESourceSelector">ESourceSelector</a>;
49
 
<a href="http://developer.gnome.org/devel/gtk/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="ESourceSelector.html#e-source-selector-new" title="e_source_selector_new ()">e_source_selector_new</a>               (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/libedataserver/ESourceList.html"><span class="type">ESourceList</span></a> *list</code></em>);
50
 
<a href="/usr/share/gtk-doc/html/libedataserver/ESourceList.html"><span class="returnvalue">ESourceList</span></a> *       <a class="link" href="ESourceSelector.html#e-source-selector-get-source-list" title="e_source_selector_get_source_list ()">e_source_selector_get_source_list</a>   (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);
 
49
<span class="returnvalue">GtkWidget</span> *         <a class="link" href="ESourceSelector.html#e-source-selector-new" title="e_source_selector_new ()">e_source_selector_new</a>               (<em class="parameter"><code><span class="type">ESourceRegistry</span> *registry</code></em>,
 
50
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *extension_name</code></em>);
 
51
<span class="returnvalue">ESourceRegistry</span> *   <a class="link" href="ESourceSelector.html#e-source-selector-get-registry" title="e_source_selector_get_registry ()">e_source_selector_get_registry</a>      (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);
 
52
const <span class="returnvalue">gchar</span> *       <a class="link" href="ESourceSelector.html#e-source-selector-get-extension-name" title="e_source_selector_get_extension_name ()">e_source_selector_get_extension_name</a>
 
53
                                                        (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);
 
54
<span class="returnvalue">gboolean</span>            <a class="link" href="ESourceSelector.html#e-source-selector-get-show-colors" title="e_source_selector_get_show_colors ()">e_source_selector_get_show_colors</a>   (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);
 
55
<span class="returnvalue">void</span>                <a class="link" href="ESourceSelector.html#e-source-selector-set-show-colors" title="e_source_selector_set_show_colors ()">e_source_selector_set_show_colors</a>   (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
 
56
                                                         <em class="parameter"><code><span class="type">gboolean</span> show_colors</code></em>);
 
57
<span class="returnvalue">gboolean</span>            <a class="link" href="ESourceSelector.html#e-source-selector-get-show-toggles" title="e_source_selector_get_show_toggles ()">e_source_selector_get_show_toggles</a>  (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);
 
58
<span class="returnvalue">void</span>                <a class="link" href="ESourceSelector.html#e-source-selector-set-show-toggles" title="e_source_selector_set_show_toggles ()">e_source_selector_set_show_toggles</a>  (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
 
59
                                                         <em class="parameter"><code><span class="type">gboolean</span> show_toggles</code></em>);
51
60
<span class="returnvalue">void</span>                <a class="link" href="ESourceSelector.html#e-source-selector-select-source" title="e_source_selector_select_source ()">e_source_selector_select_source</a>     (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
52
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>);
 
61
                                                         <em class="parameter"><code><span class="type">ESource</span> *source</code></em>);
53
62
<span class="returnvalue">void</span>                <a class="link" href="ESourceSelector.html#e-source-selector-unselect-source" title="e_source_selector_unselect_source ()">e_source_selector_unselect_source</a>   (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
54
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>);
 
63
                                                         <em class="parameter"><code><span class="type">ESource</span> *source</code></em>);
55
64
<span class="returnvalue">void</span>                <a class="link" href="ESourceSelector.html#e-source-selector-select-exclusive" title="e_source_selector_select_exclusive ()">e_source_selector_select_exclusive</a>  (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
56
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>);
57
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="ESourceSelector.html#e-source-selector-source-is-selected" title="e_source_selector_source_is_selected ()">e_source_selector_source_is_selected</a>
 
65
                                                         <em class="parameter"><code><span class="type">ESource</span> *source</code></em>);
 
66
<span class="returnvalue">gboolean</span>            <a class="link" href="ESourceSelector.html#e-source-selector-source-is-selected" title="e_source_selector_source_is_selected ()">e_source_selector_source_is_selected</a>
58
67
                                                        (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
59
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>);
60
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *            <a class="link" href="ESourceSelector.html#e-source-selector-get-selection" title="e_source_selector_get_selection ()">e_source_selector_get_selection</a>     (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);
61
 
<span class="returnvalue">void</span>                <a class="link" href="ESourceSelector.html#e-source-selector-free-selection" title="e_source_selector_free_selection ()">e_source_selector_free_selection</a>    (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> *list</code></em>);
62
 
<span class="returnvalue">void</span>                <a class="link" href="ESourceSelector.html#e-source-selector-show-selection" title="e_source_selector_show_selection ()">e_source_selector_show_selection</a>    (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
63
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show</code></em>);
64
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="ESourceSelector.html#e-source-selector-selection-shown" title="e_source_selector_selection_shown ()">e_source_selector_selection_shown</a>   (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);
 
68
                                                         <em class="parameter"><code><span class="type">ESource</span> *source</code></em>);
 
69
<span class="returnvalue">GSList</span> *            <a class="link" href="ESourceSelector.html#e-source-selector-get-selection" title="e_source_selector_get_selection ()">e_source_selector_get_selection</a>     (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);
 
70
<span class="returnvalue">void</span>                <a class="link" href="ESourceSelector.html#e-source-selector-free-selection" title="e_source_selector_free_selection ()">e_source_selector_free_selection</a>    (<em class="parameter"><code><span class="type">GSList</span> *list</code></em>);
65
71
<span class="returnvalue">void</span>                <a class="link" href="ESourceSelector.html#e-source-selector-set-select-new" title="e_source_selector_set_select_new ()">e_source_selector_set_select_new</a>    (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
66
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> state</code></em>);
 
72
                                                         <em class="parameter"><code><span class="type">gboolean</span> state</code></em>);
67
73
<span class="returnvalue">void</span>                <a class="link" href="ESourceSelector.html#e-source-selector-edit-primary-selection" title="e_source_selector_edit_primary_selection ()">e_source_selector_edit_primary_selection</a>
68
74
                                                        (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);
69
 
<a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="returnvalue">ESource</span></a> *           <a class="link" href="ESourceSelector.html#e-source-selector-get-primary-selection" title="e_source_selector_get_primary_selection ()">e_source_selector_get_primary_selection</a>
 
75
<span class="returnvalue">ESource</span> *           <a class="link" href="ESourceSelector.html#e-source-selector-ref-primary-selection" title="e_source_selector_ref_primary_selection ()">e_source_selector_ref_primary_selection</a>
70
76
                                                        (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);
71
77
<span class="returnvalue">void</span>                <a class="link" href="ESourceSelector.html#e-source-selector-set-primary-selection" title="e_source_selector_set_primary_selection ()">e_source_selector_set_primary_selection</a>
72
78
                                                        (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
73
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>);
74
 
<a href="/usr/share/gtk-doc/html/libedataserver/ESourceGroup.html"><span class="returnvalue">ESourceGroup</span></a> *      <a class="link" href="ESourceSelector.html#e-source-selector-get-primary-source-group" title="e_source_selector_get_primary_source_group ()">e_source_selector_get_primary_source_group</a>
75
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);
76
 
#define             <a class="link" href="ESourceSelector.html#e-source-selector-peek-primary-selection" title="e_source_selector_peek_primary_selection">e_source_selector_peek_primary_selection</a>
77
 
<a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="returnvalue">ESource</span></a> *           <a class="link" href="ESourceSelector.html#e-source-selector-get-source-by-path" title="e_source_selector_get_source_by_path ()">e_source_selector_get_source_by_path</a>
 
79
                                                         <em class="parameter"><code><span class="type">ESource</span> *source</code></em>);
 
80
<span class="returnvalue">ESource</span> *           <a class="link" href="ESourceSelector.html#e-source-selector-ref-source-by-path" title="e_source_selector_ref_source_by_path ()">e_source_selector_ref_source_by_path</a>
78
81
                                                        (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
79
 
                                                         <em class="parameter"><code><a href="http://developer.gnome.org/devel/gtk/GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>);
 
82
                                                         <em class="parameter"><code><span class="type">GtkTreePath</span> *path</code></em>);
 
83
<span class="returnvalue">void</span>                <a class="link" href="ESourceSelector.html#e-source-selector-queue-write" title="e_source_selector_queue_write ()">e_source_selector_queue_write</a>       (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
 
84
                                                         <em class="parameter"><code><span class="type">ESource</span> *source</code></em>);
80
85
</pre>
81
86
</div>
82
87
<div class="refsect1">
83
88
<a name="ESourceSelector.object-hierarchy"></a><h2>Object Hierarchy</h2>
84
89
<pre class="synopsis">
85
 
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
86
 
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
87
 
         +----<a href="http://developer.gnome.org/devel/gtk/GtkWidget.html">GtkWidget</a>
88
 
               +----<a href="http://developer.gnome.org/devel/gtk/GtkContainer.html">GtkContainer</a>
89
 
                     +----<a href="http://developer.gnome.org/devel/gtk/GtkTreeView.html">GtkTreeView</a>
 
90
  GObject
 
91
   +----GInitiallyUnowned
 
92
         +----GtkWidget
 
93
               +----GtkContainer
 
94
                     +----GtkTreeView
90
95
                           +----ESourceSelector
91
96
</pre>
92
97
</div>
94
99
<a name="ESourceSelector.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
95
100
<p>
96
101
ESourceSelector implements
97
 
 AtkImplementorIface,  <a href="http://developer.gnome.org/devel/gtk/GtkBuildable.html">GtkBuildable</a> and  <a href="http://developer.gnome.org/devel/gtk/GtkScrollable.html">GtkScrollable</a>.</p>
 
102
 AtkImplementorIface,  GtkBuildable and  GtkScrollable.</p>
98
103
</div>
99
104
<div class="refsect1">
100
105
<a name="ESourceSelector.properties"></a><h2>Properties</h2>
101
106
<pre class="synopsis">
102
 
  "<a class="link" href="ESourceSelector.html#ESourceSelector--primary-selection" title='The "primary-selection" property'>primary-selection</a>"        <a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a>*              : Read / Write
103
 
  "<a class="link" href="ESourceSelector.html#ESourceSelector--source-list" title='The "source-list" property'>source-list</a>"              <a href="/usr/share/gtk-doc/html/libedataserver/ESourceList.html"><span class="type">ESourceList</span></a>*          : Read / Write / Construct Only
 
107
  "<a class="link" href="ESourceSelector.html#ESourceSelector--extension-name" title='The "extension-name" property'>extension-name</a>"           <span class="type">gchar</span>*                : Read / Write / Construct Only
 
108
  "<a class="link" href="ESourceSelector.html#ESourceSelector--primary-selection" title='The "primary-selection" property'>primary-selection</a>"        <span class="type">ESource</span>*              : Read / Write
 
109
  "<a class="link" href="ESourceSelector.html#ESourceSelector--registry" title='The "registry" property'>registry</a>"                 <span class="type">ESourceRegistry</span>*      : Read / Write / Construct Only
 
110
  "<a class="link" href="ESourceSelector.html#ESourceSelector--show-colors" title='The "show-colors" property'>show-colors</a>"              <span class="type">gboolean</span>              : Read / Write
 
111
  "<a class="link" href="ESourceSelector.html#ESourceSelector--show-toggles" title='The "show-toggles" property'>show-toggles</a>"             <span class="type">gboolean</span>              : Read / Write
104
112
</pre>
105
113
</div>
106
114
<div class="refsect1">
107
115
<a name="ESourceSelector.signals"></a><h2>Signals</h2>
108
116
<pre class="synopsis">
109
 
  "<a class="link" href="ESourceSelector.html#ESourceSelector-data-dropped" title='The "data-dropped" signal'>data-dropped</a>"                                   : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
110
 
  "<a class="link" href="ESourceSelector.html#ESourceSelector-popup-event" title='The "popup-event" signal'>popup-event</a>"                                    : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
111
 
  "<a class="link" href="ESourceSelector.html#ESourceSelector-primary-selection-changed" title='The "primary-selection-changed" signal'>primary-selection-changed</a>"                      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
112
 
  "<a class="link" href="ESourceSelector.html#ESourceSelector-selection-changed" title='The "selection-changed" signal'>selection-changed</a>"                              : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
 
117
  "<a class="link" href="ESourceSelector.html#ESourceSelector-data-dropped" title='The "data-dropped" signal'>data-dropped</a>"                                   : <code class="literal">Run Last</code>
 
118
  "<a class="link" href="ESourceSelector.html#ESourceSelector-popup-event" title='The "popup-event" signal'>popup-event</a>"                                    : <code class="literal">Run Last</code>
 
119
  "<a class="link" href="ESourceSelector.html#ESourceSelector-primary-selection-changed" title='The "primary-selection-changed" signal'>primary-selection-changed</a>"                      : <code class="literal">Run Last</code>
 
120
  "<a class="link" href="ESourceSelector.html#ESourceSelector-selection-changed" title='The "selection-changed" signal'>selection-changed</a>"                              : <code class="literal">Run Last</code>
113
121
</pre>
114
122
</div>
115
123
<div class="refsect1">
124
132
<hr>
125
133
<div class="refsect2">
126
134
<a name="e-source-selector-new"></a><h3>e_source_selector_new ()</h3>
127
 
<pre class="programlisting"><a href="http://developer.gnome.org/devel/gtk/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> *         e_source_selector_new               (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/libedataserver/ESourceList.html"><span class="type">ESourceList</span></a> *list</code></em>);</pre>
128
 
<p>
129
 
Create a new view for <em class="parameter"><code>list</code></em>.  The view will update automatically when <em class="parameter"><code>list</code></em>
130
 
changes.
131
 
</p>
132
 
<div class="variablelist"><table border="0">
133
 
<col align="left" valign="top">
134
 
<tbody>
135
 
<tr>
136
 
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
137
 
<td>A source list.</td>
138
 
</tr>
139
 
<tr>
140
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
141
 
<td>The newly created widget.</td>
142
 
</tr>
143
 
</tbody>
144
 
</table></div>
145
 
</div>
146
 
<hr>
147
 
<div class="refsect2">
148
 
<a name="e-source-selector-get-source-list"></a><h3>e_source_selector_get_source_list ()</h3>
149
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/libedataserver/ESourceList.html"><span class="returnvalue">ESourceList</span></a> *       e_source_selector_get_source_list   (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);</pre>
150
 
<p>
151
 
Returns the <a href="/usr/share/gtk-doc/html/libedataserver/ESourceList.html"><span class="type">ESourceList</span></a> that <em class="parameter"><code>selector</code></em> is rendering.
152
 
</p>
153
 
<div class="variablelist"><table border="0">
154
 
<col align="left" valign="top">
155
 
<tbody>
156
 
<tr>
157
 
<td><p><span class="term"><em class="parameter"><code>selector</code></em> :</span></p></td>
158
 
<td>an <a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a>
159
 
</td>
160
 
</tr>
161
 
<tr>
162
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
163
 
<td>an <a href="/usr/share/gtk-doc/html/libedataserver/ESourceList.html"><span class="type">ESourceList</span></a>
164
 
</td>
165
 
</tr>
166
 
</tbody>
167
 
</table></div>
168
 
<p class="since">Since 2.24</p>
 
135
<pre class="programlisting"><span class="returnvalue">GtkWidget</span> *         e_source_selector_new               (<em class="parameter"><code><span class="type">ESourceRegistry</span> *registry</code></em>,
 
136
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *extension_name</code></em>);</pre>
 
137
<p>
 
138
Displays a list of sources from <em class="parameter"><code>registry</code></em> having an extension named
 
139
<em class="parameter"><code>extension_name</code></em>.  The sources are grouped by backend or groupware
 
140
account, which are described by the parent source.
 
141
</p>
 
142
<div class="variablelist"><table border="0">
 
143
<col align="left" valign="top">
 
144
<tbody>
 
145
<tr>
 
146
<td><p><span class="term"><em class="parameter"><code>registry</code></em> :</span></p></td>
 
147
<td>an <span class="type">ESourceRegistry</span>
 
148
</td>
 
149
</tr>
 
150
<tr>
 
151
<td><p><span class="term"><em class="parameter"><code>extension_name</code></em> :</span></p></td>
 
152
<td>the name of an <span class="type">ESource</span> extension</td>
 
153
</tr>
 
154
<tr>
 
155
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
156
<td>a new <a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a>
 
157
</td>
 
158
</tr>
 
159
</tbody>
 
160
</table></div>
 
161
</div>
 
162
<hr>
 
163
<div class="refsect2">
 
164
<a name="e-source-selector-get-registry"></a><h3>e_source_selector_get_registry ()</h3>
 
165
<pre class="programlisting"><span class="returnvalue">ESourceRegistry</span> *   e_source_selector_get_registry      (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);</pre>
 
166
<p>
 
167
Returns the <span class="type">ESourceRegistry</span> that <em class="parameter"><code>selector</code></em> is getting sources from.
 
168
</p>
 
169
<div class="variablelist"><table border="0">
 
170
<col align="left" valign="top">
 
171
<tbody>
 
172
<tr>
 
173
<td><p><span class="term"><em class="parameter"><code>selector</code></em> :</span></p></td>
 
174
<td>an <a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a>
 
175
</td>
 
176
</tr>
 
177
<tr>
 
178
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
179
<td>an <span class="type">ESourceRegistry</span>
 
180
</td>
 
181
</tr>
 
182
</tbody>
 
183
</table></div>
 
184
<p class="since">Since 3.6</p>
 
185
</div>
 
186
<hr>
 
187
<div class="refsect2">
 
188
<a name="e-source-selector-get-extension-name"></a><h3>e_source_selector_get_extension_name ()</h3>
 
189
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       e_source_selector_get_extension_name
 
190
                                                        (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);</pre>
 
191
<p>
 
192
Returns the extension name used to filter which sources are displayed.
 
193
</p>
 
194
<div class="variablelist"><table border="0">
 
195
<col align="left" valign="top">
 
196
<tbody>
 
197
<tr>
 
198
<td><p><span class="term"><em class="parameter"><code>selector</code></em> :</span></p></td>
 
199
<td>an <a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a>
 
200
</td>
 
201
</tr>
 
202
<tr>
 
203
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
204
<td>the <span class="type">ESource</span> extension name</td>
 
205
</tr>
 
206
</tbody>
 
207
</table></div>
 
208
<p class="since">Since 3.6</p>
 
209
</div>
 
210
<hr>
 
211
<div class="refsect2">
 
212
<a name="e-source-selector-get-show-colors"></a><h3>e_source_selector_get_show_colors ()</h3>
 
213
<pre class="programlisting"><span class="returnvalue">gboolean</span>            e_source_selector_get_show_colors   (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);</pre>
 
214
<p>
 
215
Returns whether colors are shown next to data sources.
 
216
</p>
 
217
<div class="variablelist"><table border="0">
 
218
<col align="left" valign="top">
 
219
<tbody>
 
220
<tr>
 
221
<td><p><span class="term"><em class="parameter"><code>selector</code></em> :</span></p></td>
 
222
<td>an <a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a>
 
223
</td>
 
224
</tr>
 
225
<tr>
 
226
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
227
<td>
 
228
<code class="literal">TRUE</code> if colors are being shown</td>
 
229
</tr>
 
230
</tbody>
 
231
</table></div>
 
232
<p class="since">Since 3.6</p>
 
233
</div>
 
234
<hr>
 
235
<div class="refsect2">
 
236
<a name="e-source-selector-set-show-colors"></a><h3>e_source_selector_set_show_colors ()</h3>
 
237
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_selector_set_show_colors   (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
 
238
                                                         <em class="parameter"><code><span class="type">gboolean</span> show_colors</code></em>);</pre>
 
239
<p>
 
240
Sets whether to show colors next to data sources.
 
241
</p>
 
242
<div class="variablelist"><table border="0">
 
243
<col align="left" valign="top">
 
244
<tbody>
 
245
<tr>
 
246
<td><p><span class="term"><em class="parameter"><code>selector</code></em> :</span></p></td>
 
247
<td>an <a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a>
 
248
</td>
 
249
</tr>
 
250
<tr>
 
251
<td><p><span class="term"><em class="parameter"><code>show_colors</code></em> :</span></p></td>
 
252
<td>whether to show colors</td>
 
253
</tr>
 
254
</tbody>
 
255
</table></div>
 
256
<p class="since">Since 3.6</p>
 
257
</div>
 
258
<hr>
 
259
<div class="refsect2">
 
260
<a name="e-source-selector-get-show-toggles"></a><h3>e_source_selector_get_show_toggles ()</h3>
 
261
<pre class="programlisting"><span class="returnvalue">gboolean</span>            e_source_selector_get_show_toggles  (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);</pre>
 
262
<p>
 
263
Returns whether toggles are shown next to data sources.
 
264
</p>
 
265
<div class="variablelist"><table border="0">
 
266
<col align="left" valign="top">
 
267
<tbody>
 
268
<tr>
 
269
<td><p><span class="term"><em class="parameter"><code>selector</code></em> :</span></p></td>
 
270
<td>an <a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a>
 
271
</td>
 
272
</tr>
 
273
<tr>
 
274
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
275
<td>
 
276
<code class="literal">TRUE</code> if toggles are being shown</td>
 
277
</tr>
 
278
</tbody>
 
279
</table></div>
 
280
<p class="since">Since 3.6</p>
 
281
</div>
 
282
<hr>
 
283
<div class="refsect2">
 
284
<a name="e-source-selector-set-show-toggles"></a><h3>e_source_selector_set_show_toggles ()</h3>
 
285
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_selector_set_show_toggles  (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
 
286
                                                         <em class="parameter"><code><span class="type">gboolean</span> show_toggles</code></em>);</pre>
 
287
<p>
 
288
Sets whether to show toggles next to data sources.
 
289
</p>
 
290
<div class="variablelist"><table border="0">
 
291
<col align="left" valign="top">
 
292
<tbody>
 
293
<tr>
 
294
<td><p><span class="term"><em class="parameter"><code>selector</code></em> :</span></p></td>
 
295
<td>an <a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a>
 
296
</td>
 
297
</tr>
 
298
<tr>
 
299
<td><p><span class="term"><em class="parameter"><code>show_toggles</code></em> :</span></p></td>
 
300
<td>whether to show toggles</td>
 
301
</tr>
 
302
</tbody>
 
303
</table></div>
 
304
<p class="since">Since 3.6</p>
169
305
</div>
170
306
<hr>
171
307
<div class="refsect2">
172
308
<a name="e-source-selector-select-source"></a><h3>e_source_selector_select_source ()</h3>
173
309
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_selector_select_source     (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
174
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>);</pre>
 
310
                                                         <em class="parameter"><code><span class="type">ESource</span> *source</code></em>);</pre>
175
311
<p>
176
312
Select <em class="parameter"><code>source</code></em> in <em class="parameter"><code>selector</code></em>.
177
313
</p>
184
320
</tr>
185
321
<tr>
186
322
<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
187
 
<td>An <a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a>.</td>
 
323
<td>An <span class="type">ESource</span>.</td>
188
324
</tr>
189
325
</tbody>
190
326
</table></div>
193
329
<div class="refsect2">
194
330
<a name="e-source-selector-unselect-source"></a><h3>e_source_selector_unselect_source ()</h3>
195
331
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_selector_unselect_source   (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
196
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>);</pre>
 
332
                                                         <em class="parameter"><code><span class="type">ESource</span> *source</code></em>);</pre>
197
333
<p>
198
334
Unselect <em class="parameter"><code>source</code></em> in <em class="parameter"><code>selector</code></em>.
199
335
</p>
206
342
</tr>
207
343
<tr>
208
344
<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
209
 
<td>An <a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a>.</td>
 
345
<td>An <span class="type">ESource</span>.</td>
210
346
</tr>
211
347
</tbody>
212
348
</table></div>
215
351
<div class="refsect2">
216
352
<a name="e-source-selector-select-exclusive"></a><h3>e_source_selector_select_exclusive ()</h3>
217
353
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_selector_select_exclusive  (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
218
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>);</pre>
 
354
                                                         <em class="parameter"><code><span class="type">ESource</span> *source</code></em>);</pre>
219
355
<p>
220
356
Select <em class="parameter"><code>source</code></em> in <em class="parameter"><code>selector</code></em> and unselect all others.
221
357
</p>
228
364
</tr>
229
365
<tr>
230
366
<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
231
 
<td>An <a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a>.</td>
 
367
<td>An <span class="type">ESource</span>.</td>
232
368
</tr>
233
369
</tbody>
234
370
</table></div>
237
373
<hr>
238
374
<div class="refsect2">
239
375
<a name="e-source-selector-source-is-selected"></a><h3>e_source_selector_source_is_selected ()</h3>
240
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            e_source_selector_source_is_selected
 
376
<pre class="programlisting"><span class="returnvalue">gboolean</span>            e_source_selector_source_is_selected
241
377
                                                        (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
242
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>);</pre>
 
378
                                                         <em class="parameter"><code><span class="type">ESource</span> *source</code></em>);</pre>
243
379
<p>
244
380
Check whether <em class="parameter"><code>source</code></em> is selected in <em class="parameter"><code>selector</code></em>.
245
381
</p>
252
388
</tr>
253
389
<tr>
254
390
<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
255
 
<td>An <a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a>.</td>
 
391
<td>An <span class="type">ESource</span>.</td>
256
392
</tr>
257
393
<tr>
258
394
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
259
395
<td>
260
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>source</code></em> is currently selected, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
 
396
<code class="literal">TRUE</code> if <em class="parameter"><code>source</code></em> is currently selected, <code class="literal">FALSE</code> otherwise.</td>
261
397
</tr>
262
398
</tbody>
263
399
</table></div>
265
401
<hr>
266
402
<div class="refsect2">
267
403
<a name="e-source-selector-get-selection"></a><h3>e_source_selector_get_selection ()</h3>
268
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *            e_source_selector_get_selection     (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);</pre>
 
404
<pre class="programlisting"><span class="returnvalue">GSList</span> *            e_source_selector_get_selection     (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);</pre>
269
405
<p>
270
406
Get the list of selected sources, i.e. those that were enabled through the
271
407
corresponding checkboxes in the tree.
290
426
<hr>
291
427
<div class="refsect2">
292
428
<a name="e-source-selector-free-selection"></a><h3>e_source_selector_free_selection ()</h3>
293
 
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_selector_free_selection    (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> *list</code></em>);</pre>
294
 
</div>
295
 
<hr>
296
 
<div class="refsect2">
297
 
<a name="e-source-selector-show-selection"></a><h3>e_source_selector_show_selection ()</h3>
298
 
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_selector_show_selection    (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
299
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show</code></em>);</pre>
300
 
<p>
301
 
Specify whether the checkboxes in the ESourceSelector should be shown or
302
 
not.
303
 
</p>
304
 
<div class="variablelist"><table border="0">
305
 
<col align="left" valign="top">
306
 
<tbody><tr>
307
 
<td><p><span class="term"><em class="parameter"><code>selector</code></em> :</span></p></td>
308
 
<td>An ESourceSelector widget</td>
309
 
</tr></tbody>
310
 
</table></div>
311
 
</div>
312
 
<hr>
313
 
<div class="refsect2">
314
 
<a name="e-source-selector-selection-shown"></a><h3>e_source_selector_selection_shown ()</h3>
315
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            e_source_selector_selection_shown   (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);</pre>
316
 
<p>
317
 
Check whether the checkboxes in the ESourceSelector are being shown or not.
318
 
</p>
319
 
<div class="variablelist"><table border="0">
320
 
<col align="left" valign="top">
321
 
<tbody>
322
 
<tr>
323
 
<td><p><span class="term"><em class="parameter"><code>selector</code></em> :</span></p></td>
324
 
<td>an <a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a>
325
 
</td>
326
 
</tr>
327
 
<tr>
328
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
329
 
<td>
330
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the checkboxes are shown, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
331
 
</tr>
332
 
</tbody>
333
 
</table></div>
 
429
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_selector_free_selection    (<em class="parameter"><code><span class="type">GSList</span> *list</code></em>);</pre>
334
430
</div>
335
431
<hr>
336
432
<div class="refsect2">
337
433
<a name="e-source-selector-set-select-new"></a><h3>e_source_selector_set_select_new ()</h3>
338
434
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_selector_set_select_new    (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
339
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> state</code></em>);</pre>
 
435
                                                         <em class="parameter"><code><span class="type">gboolean</span> state</code></em>);</pre>
340
436
<p>
341
437
Set whether or not to select new sources added to <em class="parameter"><code>selector</code></em>.
342
438
</p>
374
470
</div>
375
471
<hr>
376
472
<div class="refsect2">
377
 
<a name="e-source-selector-get-primary-selection"></a><h3>e_source_selector_get_primary_selection ()</h3>
378
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="returnvalue">ESource</span></a> *           e_source_selector_get_primary_selection
 
473
<a name="e-source-selector-ref-primary-selection"></a><h3>e_source_selector_ref_primary_selection ()</h3>
 
474
<pre class="programlisting"><span class="returnvalue">ESource</span> *           e_source_selector_ref_primary_selection
379
475
                                                        (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);</pre>
380
476
<p>
381
477
Get the primary selected source.  The primary selection is the one that is
382
 
highlighted through the normal <a href="http://developer.gnome.org/devel/gtk/GtkTreeView.html"><span class="type">GtkTreeView</span></a> selection mechanism (as opposed
 
478
highlighted through the normal <span class="type">GtkTreeView</span> selection mechanism (as opposed
383
479
to the "normal" selection, which is the set of source whose checkboxes are
384
480
checked).
385
481
</p>
 
482
<p>
 
483
The returned <span class="type">ESource</span> is referenced for thread-safety and must be
 
484
unreferenced with <code class="function">g_object_unref()</code> when finished with it.
 
485
</p>
386
486
<div class="variablelist"><table border="0">
387
487
<col align="left" valign="top">
388
488
<tbody>
396
496
</tr>
397
497
</tbody>
398
498
</table></div>
 
499
<p class="since">Since 3.6</p>
399
500
</div>
400
501
<hr>
401
502
<div class="refsect2">
402
503
<a name="e-source-selector-set-primary-selection"></a><h3>e_source_selector_set_primary_selection ()</h3>
403
504
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_selector_set_primary_selection
404
505
                                                        (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
405
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a> *source</code></em>);</pre>
 
506
                                                         <em class="parameter"><code><span class="type">ESource</span> *source</code></em>);</pre>
406
507
<p>
407
508
Set the primary selected source.
408
509
</p>
415
516
</tr>
416
517
<tr>
417
518
<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
418
 
<td>an <a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a> to select</td>
419
 
</tr>
420
 
</tbody>
421
 
</table></div>
422
 
</div>
423
 
<hr>
424
 
<div class="refsect2">
425
 
<a name="e-source-selector-get-primary-source-group"></a><h3>e_source_selector_get_primary_source_group ()</h3>
426
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/libedataserver/ESourceGroup.html"><span class="returnvalue">ESourceGroup</span></a> *      e_source_selector_get_primary_source_group
427
 
                                                        (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>);</pre>
428
 
<p>
429
 
Gets the primary source group associated with the selector.
430
 
</p>
431
 
<div class="variablelist"><table border="0">
432
 
<col align="left" valign="top">
433
 
<tbody>
434
 
<tr>
435
 
<td><p><span class="term"><em class="parameter"><code>selector</code></em> :</span></p></td>
436
 
<td>an <a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a>
437
 
</td>
438
 
</tr>
439
 
<tr>
440
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
441
 
<td>primary_source_group if selector is valid, NULL otherwise.</td>
442
 
</tr>
443
 
</tbody>
444
 
</table></div>
445
 
</div>
446
 
<hr>
447
 
<div class="refsect2">
448
 
<a name="e-source-selector-peek-primary-selection"></a><h3>e_source_selector_peek_primary_selection</h3>
449
 
<pre class="programlisting">#define             e_source_selector_peek_primary_selection</pre>
450
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
451
 
<h3 class="title">Warning</h3>
452
 
<p><code class="literal">e_source_selector_peek_primary_selection</code> is deprecated and should not be used in newly-written code.</p>
453
 
</div>
454
 
</div>
455
 
<hr>
456
 
<div class="refsect2">
457
 
<a name="e-source-selector-get-source-by-path"></a><h3>e_source_selector_get_source_by_path ()</h3>
458
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="returnvalue">ESource</span></a> *           e_source_selector_get_source_by_path
 
519
<td>an <span class="type">ESource</span> to select</td>
 
520
</tr>
 
521
</tbody>
 
522
</table></div>
 
523
</div>
 
524
<hr>
 
525
<div class="refsect2">
 
526
<a name="e-source-selector-ref-source-by-path"></a><h3>e_source_selector_ref_source_by_path ()</h3>
 
527
<pre class="programlisting"><span class="returnvalue">ESource</span> *           e_source_selector_ref_source_by_path
459
528
                                                        (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
460
 
                                                         <em class="parameter"><code><a href="http://developer.gnome.org/devel/gtk/GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>);</pre>
461
 
<p>
462
 
Returns the <a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a> object at <em class="parameter"><code>path</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>path</code></em> is invalid.
 
529
                                                         <em class="parameter"><code><span class="type">GtkTreePath</span> *path</code></em>);</pre>
 
530
<p>
 
531
Returns the <span class="type">ESource</span> object at <em class="parameter"><code>path</code></em>, or <code class="literal">NULL</code> if <em class="parameter"><code>path</code></em> is invalid.
 
532
</p>
 
533
<p>
 
534
The returned <span class="type">ESource</span> is referenced for thread-safety and must be
 
535
unreferenced with <code class="function">g_object_unref()</code> when finished with it.
463
536
</p>
464
537
<div class="variablelist"><table border="0">
465
538
<col align="left" valign="top">
471
544
</tr>
472
545
<tr>
473
546
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
474
 
<td>a <a href="http://developer.gnome.org/devel/gtk/GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a>
 
547
<td>a <span class="type">GtkTreePath</span>
475
548
</td>
476
549
</tr>
477
550
<tr>
478
551
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
479
 
<td>the <a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a> object at <em class="parameter"><code>path</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
480
 
</td>
481
 
</tr>
482
 
</tbody>
483
 
</table></div>
484
 
<p class="since">Since 3.0</p>
 
552
<td>the <span class="type">ESource</span> object at <em class="parameter"><code>path</code></em>, or <code class="literal">NULL</code>
 
553
</td>
 
554
</tr>
 
555
</tbody>
 
556
</table></div>
 
557
<p class="since">Since 3.6</p>
 
558
</div>
 
559
<hr>
 
560
<div class="refsect2">
 
561
<a name="e-source-selector-queue-write"></a><h3>e_source_selector_queue_write ()</h3>
 
562
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_selector_queue_write       (<em class="parameter"><code><a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *selector</code></em>,
 
563
                                                         <em class="parameter"><code><span class="type">ESource</span> *source</code></em>);</pre>
 
564
<p>
 
565
Queues a main loop idle callback to write changes to <em class="parameter"><code>source</code></em> back to
 
566
the D-Bus registry service.
 
567
</p>
 
568
<div class="variablelist"><table border="0">
 
569
<col align="left" valign="top">
 
570
<tbody>
 
571
<tr>
 
572
<td><p><span class="term"><em class="parameter"><code>selector</code></em> :</span></p></td>
 
573
<td>an <span class="type">ESourceSelecetor</span>
 
574
</td>
 
575
</tr>
 
576
<tr>
 
577
<td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
 
578
<td>an <span class="type">ESource</span> with changes to be written</td>
 
579
</tr>
 
580
</tbody>
 
581
</table></div>
 
582
<p class="since">Since 3.6</p>
485
583
</div>
486
584
</div>
487
585
<div class="refsect1">
488
586
<a name="ESourceSelector.property-details"></a><h2>Property Details</h2>
489
587
<div class="refsect2">
 
588
<a name="ESourceSelector--extension-name"></a><h3>The <code class="literal">"extension-name"</code> property</h3>
 
589
<pre class="programlisting">  "extension-name"           <span class="type">gchar</span>*                : Read / Write / Construct Only</pre>
 
590
<p></p>
 
591
<p>Default value: NULL</p>
 
592
</div>
 
593
<hr>
 
594
<div class="refsect2">
490
595
<a name="ESourceSelector--primary-selection"></a><h3>The <code class="literal">"primary-selection"</code> property</h3>
491
 
<pre class="programlisting">  "primary-selection"        <a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a>*              : Read / Write</pre>
492
 
<p></p>
493
 
</div>
494
 
<hr>
495
 
<div class="refsect2">
496
 
<a name="ESourceSelector--source-list"></a><h3>The <code class="literal">"source-list"</code> property</h3>
497
 
<pre class="programlisting">  "source-list"              <a href="/usr/share/gtk-doc/html/libedataserver/ESourceList.html"><span class="type">ESourceList</span></a>*          : Read / Write / Construct Only</pre>
498
 
<p></p>
 
596
<pre class="programlisting">  "primary-selection"        <span class="type">ESource</span>*              : Read / Write</pre>
 
597
<p></p>
 
598
</div>
 
599
<hr>
 
600
<div class="refsect2">
 
601
<a name="ESourceSelector--registry"></a><h3>The <code class="literal">"registry"</code> property</h3>
 
602
<pre class="programlisting">  "registry"                 <span class="type">ESourceRegistry</span>*      : Read / Write / Construct Only</pre>
 
603
<p></p>
 
604
</div>
 
605
<hr>
 
606
<div class="refsect2">
 
607
<a name="ESourceSelector--show-colors"></a><h3>The <code class="literal">"show-colors"</code> property</h3>
 
608
<pre class="programlisting">  "show-colors"              <span class="type">gboolean</span>              : Read / Write</pre>
 
609
<p></p>
 
610
<p>Default value: TRUE</p>
 
611
</div>
 
612
<hr>
 
613
<div class="refsect2">
 
614
<a name="ESourceSelector--show-toggles"></a><h3>The <code class="literal">"show-toggles"</code> property</h3>
 
615
<pre class="programlisting">  "show-toggles"             <span class="type">gboolean</span>              : Read / Write</pre>
 
616
<p></p>
 
617
<p>Default value: TRUE</p>
499
618
</div>
500
619
</div>
501
620
<div class="refsect1">
502
621
<a name="ESourceSelector.signal-details"></a><h2>Signal Details</h2>
503
622
<div class="refsect2">
504
623
<a name="ESourceSelector-data-dropped"></a><h3>The <code class="literal">"data-dropped"</code> signal</h3>
505
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            user_function                      (<a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a>  *esourceselector,
506
 
                                                        <a href="http://developer.gnome.org/devel/gtk/GtkWidget.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> *arg1,
507
 
                                                        <a href="/usr/share/gtk-doc/html/libedataserver/ESource.html"><span class="type">ESource</span></a>          *arg2,
508
 
                                                        <a href="http://developer.gnome.org/devel/gdk/gdk3-Drag-and-Drop.html#GdkDragAction"><span class="type">GdkDragAction</span></a>     arg3,
509
 
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>             arg4,
510
 
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)            : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 
624
<pre class="programlisting"><span class="returnvalue">gboolean</span>            user_function                      (<a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a>  *esourceselector,
 
625
                                                        <span class="type">GtkSelectionData</span> *arg1,
 
626
                                                        <span class="type">ESource</span>          *arg2,
 
627
                                                        <span class="type">GdkDragAction</span>     arg3,
 
628
                                                        <span class="type">guint</span>             arg4,
 
629
                                                        <span class="type">gpointer</span>          user_data)            : <code class="literal">Run Last</code></pre>
511
630
</div>
512
631
<hr>
513
632
<div class="refsect2">
514
633
<a name="ESourceSelector-popup-event"></a><h3>The <code class="literal">"popup-event"</code> signal</h3>
515
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            user_function                      (<a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *esourceselector,
516
 
                                                        <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>         *arg1,
517
 
                                                        <a href="http://developer.gnome.org/devel/gdk/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a>        *arg2,
518
 
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>         user_data)            : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 
634
<pre class="programlisting"><span class="returnvalue">gboolean</span>            user_function                      (<a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *esourceselector,
 
635
                                                        <span class="type">GObject</span>         *arg1,
 
636
                                                        <span class="type">GdkEvent</span>        *arg2,
 
637
                                                        <span class="type">gpointer</span>         user_data)            : <code class="literal">Run Last</code></pre>
519
638
</div>
520
639
<hr>
521
640
<div class="refsect2">
522
641
<a name="ESourceSelector-primary-selection-changed"></a><h3>The <code class="literal">"primary-selection-changed"</code> signal</h3>
523
642
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *esourceselector,
524
 
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>         user_data)            : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 
643
                                                        <span class="type">gpointer</span>         user_data)            : <code class="literal">Run Last</code></pre>
525
644
</div>
526
645
<hr>
527
646
<div class="refsect2">
528
647
<a name="ESourceSelector-selection-changed"></a><h3>The <code class="literal">"selection-changed"</code> signal</h3>
529
648
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="ESourceSelector.html" title="ESourceSelector"><span class="type">ESourceSelector</span></a> *esourceselector,
530
 
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>         user_data)            : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 
649
                                                        <span class="type">gpointer</span>         user_data)            : <code class="literal">Run Last</code></pre>
531
650
</div>
532
651
</div>
533
652
</div>