1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
<title>EmpathyIrcNetwork</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
7
<link rel="start" href="index.html" title="libempathy Reference Manual">
8
<link rel="up" href="libempathy_api.html" title="libempathy API reference">
9
<link rel="prev" href="EmpathyIrcServer.html" title="EmpathyIrcServer">
10
<link rel="next" href="EmpathyIrcNetworkManager.html" title="EmpathyIrcNetworkManager">
11
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="part" href="pt01.html" title="Part I. libempathy Overview">
14
<link rel="part" href="pt02.html" title="Part II. API Reference">
15
<link rel="chapter" href="libempathy_api.html" title="libempathy API reference">
16
<link rel="chapter" href="libempathy-hierarchy.html" title="Object Hierarchy">
17
<link rel="index" href="ix01.html" title="Index">
19
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
20
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
22
<td><a accesskey="p" href="EmpathyIrcServer.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
23
<td><a accesskey="u" href="libempathy_api.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
24
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
25
<th width="100%" align="center">libempathy Reference Manual</th>
26
<td><a accesskey="n" href="EmpathyIrcNetworkManager.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
28
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id344954" class="shortcut">Top</a>
30
<a href="#id377469" class="shortcut">Description</a>
32
<a href="#id346095" class="shortcut">Object Hierarchy</a>
34
<a href="#id371852" class="shortcut">Properties</a>
36
<a href="#id371894" class="shortcut">Signals</a></nobr></td></tr>
38
<div class="refentry" lang="en">
39
<a name="EmpathyIrcNetwork"></a><div class="titlepage"></div>
40
<div class="refnamediv"><table width="100%"><tr>
43
<a name="id344954"></a><span class="refentrytitle">EmpathyIrcNetwork</span>
45
<p>EmpathyIrcNetwork</p>
47
<td valign="top" align="right"></td>
49
<div class="refsynopsisdiv">
51
<pre class="synopsis">
55
<a class="link" href="EmpathyIrcNetwork.html#EmpathyIrcNetwork-struct">EmpathyIrcNetwork</a>;
56
<a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork">EmpathyIrcNetwork</a>* <a class="link" href="EmpathyIrcNetwork.html#empathy-irc-network-new">empathy_irc_network_new</a> (const gchar *name);
57
GSList* <a class="link" href="EmpathyIrcNetwork.html#empathy-irc-network-get-servers">empathy_irc_network_get_servers</a> (<a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork">EmpathyIrcNetwork</a> *network);
58
void <a class="link" href="EmpathyIrcNetwork.html#empathy-irc-network-append-server">empathy_irc_network_append_server</a> (<a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork">EmpathyIrcNetwork</a> *network,
59
<a class="link" href="EmpathyIrcServer.html" title="EmpathyIrcServer">EmpathyIrcServer</a> *server);
60
void <a class="link" href="EmpathyIrcNetwork.html#empathy-irc-network-remove-server">empathy_irc_network_remove_server</a> (<a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork">EmpathyIrcNetwork</a> *network,
61
<a class="link" href="EmpathyIrcServer.html" title="EmpathyIrcServer">EmpathyIrcServer</a> *server);
62
void <a class="link" href="EmpathyIrcNetwork.html#empathy-irc-network-set-server-position">empathy_irc_network_set_server_position</a>
63
(<a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork">EmpathyIrcNetwork</a> *network,
64
<a class="link" href="EmpathyIrcServer.html" title="EmpathyIrcServer">EmpathyIrcServer</a> *server,
69
<div class="refsect1" lang="en">
70
<a name="id346095"></a><h2>Object Hierarchy</h2>
71
<pre class="synopsis">
74
+----EmpathyIrcNetwork
77
<div class="refsect1" lang="en">
78
<a name="id371852"></a><h2>Properties</h2>
79
<pre class="synopsis">
81
"<a class="link" href="EmpathyIrcNetwork.html#EmpathyIrcNetwork--charset">charset</a>" gchararray : Read / Write / Construct
82
"<a class="link" href="EmpathyIrcNetwork.html#EmpathyIrcNetwork--name">name</a>" gchararray : Read / Write
85
<div class="refsect1" lang="en">
86
<a name="id371894"></a><h2>Signals</h2>
87
<pre class="synopsis">
89
"<a class="link" href="EmpathyIrcNetwork.html#EmpathyIrcNetwork-modified">modified</a>" : Run Last / Has Details
92
<div class="refsect1" lang="en">
93
<a name="id377469"></a><h2>Description</h2>
98
<div class="refsect1" lang="en">
99
<a name="id377485"></a><h2>Details</h2>
100
<div class="refsect2" lang="en">
101
<a name="id377496"></a><h3>
102
<a name="EmpathyIrcNetwork-struct"></a>EmpathyIrcNetwork</h3>
103
<a class="indexterm" name="id377508"></a><pre class="programlisting">typedef struct _EmpathyIrcNetwork EmpathyIrcNetwork;</pre>
109
<div class="refsect2" lang="en">
110
<a name="id377523"></a><h3>
111
<a name="empathy-irc-network-new"></a>empathy_irc_network_new ()</h3>
112
<a class="indexterm" name="id377535"></a><pre class="programlisting"><a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork">EmpathyIrcNetwork</a>* empathy_irc_network_new (const gchar *name);</pre>
114
Creates a new <a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork"><span class="type">EmpathyIrcNetwork</span></a>.</p>
118
<div class="variablelist"><table border="0">
119
<col align="left" valign="top">
122
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
123
<td> the name of the network
127
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
128
<td> a new <a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork"><span class="type">EmpathyIrcNetwork</span></a>
135
<div class="refsect2" lang="en">
136
<a name="id392389"></a><h3>
137
<a name="empathy-irc-network-get-servers"></a>empathy_irc_network_get_servers ()</h3>
138
<a class="indexterm" name="id392401"></a><pre class="programlisting">GSList* empathy_irc_network_get_servers (<a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork">EmpathyIrcNetwork</a> *network);</pre>
140
Get the list of <a class="link" href="EmpathyIrcServer.html" title="EmpathyIrcServer"><span class="type">EmpathyIrcServer</span></a> that belongs to this network.
141
These servers are sorted according their priority.
142
So the first one will be the first used when trying to connect to
147
<div class="variablelist"><table border="0">
148
<col align="left" valign="top">
151
<td><p><span class="term"><em class="parameter"><code>network</code></em> :</span></p></td>
152
<td> an <a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork"><span class="type">EmpathyIrcNetwork</span></a>
156
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
157
<td> a new <span class="type">GSList</span> of refed <a class="link" href="EmpathyIrcServer.html" title="EmpathyIrcServer"><span class="type">EmpathyIrcServer</span></a>.
164
<div class="refsect2" lang="en">
165
<a name="id392490"></a><h3>
166
<a name="empathy-irc-network-append-server"></a>empathy_irc_network_append_server ()</h3>
167
<a class="indexterm" name="id392502"></a><pre class="programlisting">void empathy_irc_network_append_server (<a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork">EmpathyIrcNetwork</a> *network,
168
<a class="link" href="EmpathyIrcServer.html" title="EmpathyIrcServer">EmpathyIrcServer</a> *server);</pre>
170
Add an <a class="link" href="EmpathyIrcServer.html" title="EmpathyIrcServer"><span class="type">EmpathyIrcServer</span></a> to the given <a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork"><span class="type">EmpathyIrcNetwork</span></a>. The server
171
is added at the last position in network's servers list.</p>
175
<div class="variablelist"><table border="0">
176
<col align="left" valign="top">
179
<td><p><span class="term"><em class="parameter"><code>network</code></em> :</span></p></td>
180
<td> an <a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork"><span class="type">EmpathyIrcNetwork</span></a>
184
<td><p><span class="term"><em class="parameter"><code>server</code></em> :</span></p></td>
185
<td> the <a class="link" href="EmpathyIrcServer.html" title="EmpathyIrcServer"><span class="type">EmpathyIrcServer</span></a> to add
192
<div class="refsect2" lang="en">
193
<a name="id392599"></a><h3>
194
<a name="empathy-irc-network-remove-server"></a>empathy_irc_network_remove_server ()</h3>
195
<a class="indexterm" name="id392612"></a><pre class="programlisting">void empathy_irc_network_remove_server (<a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork">EmpathyIrcNetwork</a> *network,
196
<a class="link" href="EmpathyIrcServer.html" title="EmpathyIrcServer">EmpathyIrcServer</a> *server);</pre>
198
Remove an <a class="link" href="EmpathyIrcServer.html" title="EmpathyIrcServer"><span class="type">EmpathyIrcServer</span></a> from the servers list of the
199
given <a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork"><span class="type">EmpathyIrcNetwork</span></a>.</p>
203
<div class="variablelist"><table border="0">
204
<col align="left" valign="top">
207
<td><p><span class="term"><em class="parameter"><code>network</code></em> :</span></p></td>
208
<td> an <a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork"><span class="type">EmpathyIrcNetwork</span></a>
212
<td><p><span class="term"><em class="parameter"><code>server</code></em> :</span></p></td>
213
<td> the <a class="link" href="EmpathyIrcServer.html" title="EmpathyIrcServer"><span class="type">EmpathyIrcServer</span></a> to remove
220
<div class="refsect2" lang="en">
221
<a name="id392709"></a><h3>
222
<a name="empathy-irc-network-set-server-position"></a>empathy_irc_network_set_server_position ()</h3>
223
<a class="indexterm" name="id392721"></a><pre class="programlisting">void empathy_irc_network_set_server_position
224
(<a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork">EmpathyIrcNetwork</a> *network,
225
<a class="link" href="EmpathyIrcServer.html" title="EmpathyIrcServer">EmpathyIrcServer</a> *server,
228
Move an <a class="link" href="EmpathyIrcServer.html" title="EmpathyIrcServer"><span class="type">EmpathyIrcServer</span></a> in the servers list of the given
229
<a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork"><span class="type">EmpathyIrcNetwork</span></a>.</p>
233
<div class="variablelist"><table border="0">
234
<col align="left" valign="top">
237
<td><p><span class="term"><em class="parameter"><code>network</code></em> :</span></p></td>
238
<td> an <a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork"><span class="type">EmpathyIrcNetwork</span></a>
242
<td><p><span class="term"><em class="parameter"><code>server</code></em> :</span></p></td>
243
<td> the <a class="link" href="EmpathyIrcServer.html" title="EmpathyIrcServer"><span class="type">EmpathyIrcServer</span></a> to move
247
<td><p><span class="term"><em class="parameter"><code>pos</code></em> :</span></p></td>
248
<td> the position to move the server. If this is negative, or is larger than
249
the number of servers in the list, the server is moved to the end of the
257
<div class="refsect1" lang="en">
258
<a name="id392841"></a><h2>Property Details</h2>
259
<div class="refsect2" lang="en">
260
<a name="id392852"></a><h3>
261
<a name="EmpathyIrcNetwork--charset"></a>The <code class="literal">"charset"</code> property</h3>
262
<a class="indexterm" name="id392867"></a><pre class="programlisting"> "charset" gchararray : Read / Write / Construct</pre>
263
<p>The charset to use on this network.</p>
264
<p>Default value: "UTF-8"</p>
267
<div class="refsect2" lang="en">
268
<a name="id392892"></a><h3>
269
<a name="EmpathyIrcNetwork--name"></a>The <code class="literal">"name"</code> property</h3>
270
<a class="indexterm" name="id392907"></a><pre class="programlisting"> "name" gchararray : Read / Write</pre>
271
<p>The displayed name of this network.</p>
272
<p>Default value: NULL</p>
275
<div class="refsect1" lang="en">
276
<a name="id392934"></a><h2>Signal Details</h2>
277
<div class="refsect2" lang="en">
278
<a name="id392944"></a><h3>
279
<a name="EmpathyIrcNetwork-modified"></a>The <code class="literal">"modified"</code> signal</h3>
280
<a class="indexterm" name="id392959"></a><pre class="programlisting">void user_function (<a class="link" href="EmpathyIrcNetwork.html" title="EmpathyIrcNetwork">EmpathyIrcNetwork</a> *network,
281
gpointer user_data) : Run Last / Has Details</pre>
283
Emitted when either a property or a server of the network is modified.</p>
287
<div class="variablelist"><table border="0">
288
<col align="left" valign="top">
291
<td><p><span class="term"><em class="parameter"><code>network</code></em> :</span></p></td>
292
<td> the object that received the signal
296
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
297
<td>user data set when the signal handler was connected.</td>
303
<div class="refsect1" lang="en">
304
<a name="id393028"></a><div class="refsect2" lang="en"><a name="id393029"></a></div>
306
<div class="refsect2" lang="en"><a name="id393030"></a></div>