~ubuntu-branches/debian/squeeze/glib2.0/squeeze

« back to all changes in this revision

Viewing changes to docs/reference/gio/html/GFileMonitor.html

  • Committer: Bazaar Package Importer
  • Author(s): Gustavo Noronha Silva
  • Date: 2009-02-15 13:00:43 UTC
  • mfrom: (1.3.1 upstream) (69.1.10 intrepid)
  • Revision ID: james.westby@ubuntu.com-20090215130043-q47fbt3owmt42m2f
Tags: 2.18.4-2
* Release to unstable
* debian/rules:
- bump SHVER, since we are already forcing a 2.18.0 dependecy on the
  symbols introduced in the development versions
* debian/control.in:
- added Homepage and Vcs-* control fields

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
2
<html>
3
3
<head>
4
 
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>GFileMonitor</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
7
 
<link rel="start" href="index.html" title="GIO Reference Manual">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
 
7
<link rel="home" href="index.html" title="GIO Reference Manual">
8
8
<link rel="up" href="file_mon.html" title="File System Monitoring">
9
9
<link rel="prev" href="file_mon.html" title="File System Monitoring">
10
10
<link rel="next" href="async.html" title="Asynchronous I/O">
11
 
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
 
<link rel="part" href="pt01.html" title="Part&#160;I.&#160;GIO Overview">
 
13
<link rel="part" href="pt01.html" title="Part I. GIO Overview">
14
14
<link rel="chapter" href="ch01.html" title="Introduction">
15
15
<link rel="chapter" href="ch02.html" title="Compiling GIO applications">
16
16
<link rel="chapter" href="ch03.html" title="Running GIO applications">
17
 
<link rel="chapter" href="gio-extension-points.html" title="Extending GIO">
18
 
<link rel="part" href="pt02.html" title="Part&#160;II.&#160;API Reference">
 
17
<link rel="chapter" href="extending-gio.html" title="Extending GIO">
 
18
<link rel="part" href="pt02.html" title="Part II. API Reference">
19
19
<link rel="chapter" href="file_ops.html" title="File Operations">
20
20
<link rel="chapter" href="file_mon.html" title="File System Monitoring">
21
21
<link rel="chapter" href="async.html" title="Asynchronous I/O">
25
25
<link rel="chapter" href="icons.html" title="Icons">
26
26
<link rel="chapter" href="utils.html" title="Utilities">
27
27
<link rel="chapter" href="extending.html" title="Extending GIO">
28
 
<link rel="part" href="migrating.html" title="Part&#160;III.&#160;Migrating to GIO">
 
28
<link rel="part" href="migrating.html" title="Part III. Migrating to GIO">
29
29
<link rel="chapter" href="ch14.html" title="Migrating from POSIX to GIO">
30
30
<link rel="chapter" href="ch15.html" title="Migrating from GnomeVFS to GIO">
31
31
<link rel="chapter" href="gio-hierarchy.html" title="Object Hierarchy">
32
32
<link rel="index" href="ix01.html" title="Index">
 
33
<link rel="index" href="ix02.html" title="Index of new symbols in 2.18">
33
34
</head>
34
35
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
35
36
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
40
41
<th width="100%" align="center">GIO Reference Manual</th>
41
42
<td><a accesskey="n" href="async.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
42
43
</tr>
43
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2755792" class="shortcut">Top</a>
44
 
                  &#160;|&#160;
45
 
                  <a href="#id2814984" class="shortcut">Description</a>
46
 
                  &#160;|&#160;
47
 
                  <a href="#id2814894" class="shortcut">Object Hierarchy</a>
48
 
                  &#160;|&#160;
49
 
                  <a href="#id2814918" class="shortcut">Properties</a>
50
 
                  &#160;|&#160;
51
 
                  <a href="#id2814959" class="shortcut">Signals</a></nobr></td></tr>
 
44
<tr><td colspan="5" class="shortcuts">
 
45
<a href="#GFileMonitor.synopsis" class="shortcut">Top</a>
 
46
                 | 
 
47
                <a href="#GFileMonitor.description" class="shortcut">Description</a>
 
48
                 | 
 
49
                <a href="#GFileMonitor.object-hierarchy" class="shortcut">Object Hierarchy</a>
 
50
                 | 
 
51
                <a href="#GFileMonitor.properties" class="shortcut">Properties</a>
 
52
                 | 
 
53
                <a href="#GFileMonitor.signals" class="shortcut">Signals</a>
 
54
</td></tr>
52
55
</table>
53
56
<div class="refentry" lang="en">
54
57
<a name="GFileMonitor"></a><div class="titlepage"></div>
55
58
<div class="refnamediv"><table width="100%"><tr>
56
59
<td valign="top">
57
 
<h2>
58
 
<a name="id2755792"></a><span class="refentrytitle">GFileMonitor</span>
59
 
</h2>
60
 
<p>GFileMonitor &#8212; File Monitor</p>
 
60
<h2><span class="refentrytitle"><a name="GFileMonitor.top_of_page"></a>GFileMonitor</span></h2>
 
61
<p>GFileMonitor — File Monitor</p>
61
62
</td>
62
63
<td valign="top" align="right"></td>
63
64
</tr></table></div>
64
65
<div class="refsynopsisdiv">
65
 
<h2>Synopsis</h2>
 
66
<a name="GFileMonitor.synopsis"></a><h2>Synopsis</h2>
66
67
<pre class="synopsis">
67
68
 
68
69
#include &lt;gio/gio.h&gt;
69
70
 
70
 
 
71
 
enum                <a class="link" href="GFileMonitor.html#GFileMonitorEvent">GFileMonitorEvent</a>;
72
 
                    <a class="link" href="GFileMonitor.html#GFileMonitor-struct">GFileMonitor</a>;
73
 
<a
74
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
75
 
>gboolean</a>            <a class="link" href="GFileMonitor.html#g-file-monitor-cancel">g_file_monitor_cancel</a>               (<a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a> *monitor);
76
 
<a
77
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
78
 
>gboolean</a>            <a class="link" href="GFileMonitor.html#g-file-monitor-is-cancelled">g_file_monitor_is_cancelled</a>         (<a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a> *monitor);
79
 
void                <a class="link" href="GFileMonitor.html#g-file-monitor-set-rate-limit">g_file_monitor_set_rate_limit</a>       (<a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a> *monitor,
 
71
enum                <a class="link" href="GFileMonitor.html#GFileMonitorEvent" title="enum GFileMonitorEvent">GFileMonitorEvent</a>;
 
72
                    <a class="link" href="GFileMonitor.html#GFileMonitor-struct" title="GFileMonitor">GFileMonitor</a>;
 
73
<a
 
74
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
75
>gboolean</a>            <a class="link" href="GFileMonitor.html#g-file-monitor-cancel" title="g_file_monitor_cancel ()">g_file_monitor_cancel</a>               (<a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a> *monitor);
 
76
<a
 
77
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
78
>gboolean</a>            <a class="link" href="GFileMonitor.html#g-file-monitor-is-cancelled" title="g_file_monitor_is_cancelled ()">g_file_monitor_is_cancelled</a>         (<a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a> *monitor);
 
79
void                <a class="link" href="GFileMonitor.html#g-file-monitor-set-rate-limit" title="g_file_monitor_set_rate_limit ()">g_file_monitor_set_rate_limit</a>       (<a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a> *monitor,
80
80
                                                         int limit_msecs);
81
 
void                <a class="link" href="GFileMonitor.html#g-file-monitor-emit-event">g_file_monitor_emit_event</a>           (<a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a> *monitor,
 
81
void                <a class="link" href="GFileMonitor.html#g-file-monitor-emit-event" title="g_file_monitor_emit_event ()">g_file_monitor_emit_event</a>           (<a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a> *monitor,
82
82
                                                         <a class="link" href="GFile.html" title="GFile">GFile</a> *child,
83
83
                                                         <a class="link" href="GFile.html" title="GFile">GFile</a> *other_file,
84
 
                                                         <a class="link" href="GFileMonitor.html#GFileMonitorEvent">GFileMonitorEvent</a> event_type);
85
 
 
86
 
 
 
84
                                                         <a class="link" href="GFileMonitor.html#GFileMonitorEvent" title="enum GFileMonitorEvent">GFileMonitorEvent</a> event_type);
87
85
</pre>
88
86
</div>
89
87
<div class="refsect1" lang="en">
90
 
<a name="id2814894"></a><h2>Object Hierarchy</h2>
 
88
<a name="GFileMonitor.object-hierarchy"></a><h2>Object Hierarchy</h2>
91
89
<pre class="synopsis">
92
 
 
93
90
  <a
94
91
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
95
92
>GObject</a>
97
94
</pre>
98
95
</div>
99
96
<div class="refsect1" lang="en">
100
 
<a name="id2814918"></a><h2>Properties</h2>
 
97
<a name="GFileMonitor.properties"></a><h2>Properties</h2>
101
98
<pre class="synopsis">
102
 
 
103
 
  "<a class="link" href="GFileMonitor.html#GFileMonitor--cancelled">cancelled</a>"                <a
 
99
  "<a class="link" href="GFileMonitor.html#GFileMonitor--cancelled" title='The "cancelled" property'>cancelled</a>"                <a
104
100
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
105
101
>gboolean</a>              : Read
106
 
  "<a class="link" href="GFileMonitor.html#GFileMonitor--rate-limit">rate-limit</a>"               <a
 
102
  "<a class="link" href="GFileMonitor.html#GFileMonitor--rate-limit" title='The "rate-limit" property'>rate-limit</a>"               <a
107
103
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
108
104
>gint</a>                  : Read / Write
109
105
</pre>
110
106
</div>
111
107
<div class="refsect1" lang="en">
112
 
<a name="id2814959"></a><h2>Signals</h2>
 
108
<a name="GFileMonitor.signals"></a><h2>Signals</h2>
113
109
<pre class="synopsis">
114
 
 
115
 
  "<a class="link" href="GFileMonitor.html#GFileMonitor-changed">changed</a>"                                        : Run Last
 
110
  "<a class="link" href="GFileMonitor.html#GFileMonitor-changed" title='The "changed" signal'>changed</a>"                                        : Run Last
116
111
</pre>
117
112
</div>
118
113
<div class="refsect1" lang="en">
119
 
<a name="id2814984"></a><h2>Description</h2>
 
114
<a name="GFileMonitor.description"></a><h2>Description</h2>
120
115
<p>
121
116
Monitors a file or directory for changes.
122
117
</p>
123
118
<p>
124
119
To obtain a <a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="type">GFileMonitor</span></a> for a file or directory, use
125
 
<a class="link" href="GFile.html#g-file-monitor-file"><code class="function">g_file_monitor_file()</code></a> or <a class="link" href="GFile.html#g-file-monitor-directory"><code class="function">g_file_monitor_directory()</code></a>.
 
120
<a class="link" href="GFile.html#g-file-monitor" title="g_file_monitor ()"><code class="function">g_file_monitor()</code></a>, <a class="link" href="GFile.html#g-file-monitor-file" title="g_file_monitor_file ()"><code class="function">g_file_monitor_file()</code></a>, or
 
121
<a class="link" href="GFile.html#g-file-monitor-directory" title="g_file_monitor_directory ()"><code class="function">g_file_monitor_directory()</code></a>.
126
122
</p>
127
123
<p>
128
124
To get informed about changes to the file or directory you
129
 
are monitoring, connect to the <a class="link" href="GFileMonitor.html#GFileMonitor-changed"><span class="type">"changed"</span></a> signal.</p>
 
125
are monitoring, connect to the <a class="link" href="GFileMonitor.html#GFileMonitor-changed" title='The "changed" signal'><span class="type">"changed"</span></a> signal.</p>
130
126
<p>
131
 
 
132
127
</p>
133
128
</div>
134
129
<div class="refsect1" lang="en">
135
 
<a name="id2815044"></a><h2>Details</h2>
 
130
<a name="GFileMonitor.details"></a><h2>Details</h2>
136
131
<div class="refsect2" lang="en">
137
 
<a name="id2815055"></a><h3>
138
 
<a name="GFileMonitorEvent"></a>enum GFileMonitorEvent</h3>
139
 
<a class="indexterm" name="id2815067"></a><pre class="programlisting">typedef enum {
 
132
<a name="GFileMonitorEvent"></a><h3>enum GFileMonitorEvent</h3>
 
133
<pre class="programlisting">typedef enum {
140
134
  G_FILE_MONITOR_EVENT_CHANGED,
141
135
  G_FILE_MONITOR_EVENT_CHANGES_DONE_HINT,
142
136
  G_FILE_MONITOR_EVENT_DELETED,
149
143
<p>
150
144
Specifies what type of event a monitor event is.</p>
151
145
<p>
152
 
 
153
146
</p>
154
147
<div class="variablelist"><table border="0">
155
148
<col align="left" valign="top">
156
149
<tbody>
157
150
<tr>
158
 
<td><p><span class="term"><a name="G-FILE-MONITOR-EVENT-CHANGED:CAPS"></a><code class="literal">G_FILE_MONITOR_EVENT_CHANGED</code></span></p></td>
 
151
<td><p><a name="G-FILE-MONITOR-EVENT-CHANGED--CAPS"></a><span class="term"><code class="literal">G_FILE_MONITOR_EVENT_CHANGED</code></span></p></td>
159
152
<td> a file changed.
160
153
</td>
161
154
</tr>
162
155
<tr>
163
 
<td><p><span class="term"><a name="G-FILE-MONITOR-EVENT-CHANGES-DONE-HINT:CAPS"></a><code class="literal">G_FILE_MONITOR_EVENT_CHANGES_DONE_HINT</code></span></p></td>
 
156
<td><p><a name="G-FILE-MONITOR-EVENT-CHANGES-DONE-HINT--CAPS"></a><span class="term"><code class="literal">G_FILE_MONITOR_EVENT_CHANGES_DONE_HINT</code></span></p></td>
164
157
<td> a hint that this was probably the last change in a set of changes.
165
158
</td>
166
159
</tr>
167
160
<tr>
168
 
<td><p><span class="term"><a name="G-FILE-MONITOR-EVENT-DELETED:CAPS"></a><code class="literal">G_FILE_MONITOR_EVENT_DELETED</code></span></p></td>
 
161
<td><p><a name="G-FILE-MONITOR-EVENT-DELETED--CAPS"></a><span class="term"><code class="literal">G_FILE_MONITOR_EVENT_DELETED</code></span></p></td>
169
162
<td> a file was deleted.
170
163
</td>
171
164
</tr>
172
165
<tr>
173
 
<td><p><span class="term"><a name="G-FILE-MONITOR-EVENT-CREATED:CAPS"></a><code class="literal">G_FILE_MONITOR_EVENT_CREATED</code></span></p></td>
 
166
<td><p><a name="G-FILE-MONITOR-EVENT-CREATED--CAPS"></a><span class="term"><code class="literal">G_FILE_MONITOR_EVENT_CREATED</code></span></p></td>
174
167
<td> a file was created.
175
168
</td>
176
169
</tr>
177
170
<tr>
178
 
<td><p><span class="term"><a name="G-FILE-MONITOR-EVENT-ATTRIBUTE-CHANGED:CAPS"></a><code class="literal">G_FILE_MONITOR_EVENT_ATTRIBUTE_CHANGED</code></span></p></td>
 
171
<td><p><a name="G-FILE-MONITOR-EVENT-ATTRIBUTE-CHANGED--CAPS"></a><span class="term"><code class="literal">G_FILE_MONITOR_EVENT_ATTRIBUTE_CHANGED</code></span></p></td>
179
172
<td> a file attribute was changed.
180
173
</td>
181
174
</tr>
182
175
<tr>
183
 
<td><p><span class="term"><a name="G-FILE-MONITOR-EVENT-PRE-UNMOUNT:CAPS"></a><code class="literal">G_FILE_MONITOR_EVENT_PRE_UNMOUNT</code></span></p></td>
 
176
<td><p><a name="G-FILE-MONITOR-EVENT-PRE-UNMOUNT--CAPS"></a><span class="term"><code class="literal">G_FILE_MONITOR_EVENT_PRE_UNMOUNT</code></span></p></td>
184
177
<td> the file location will soon be unmounted.
185
178
</td>
186
179
</tr>
187
180
<tr>
188
 
<td><p><span class="term"><a name="G-FILE-MONITOR-EVENT-UNMOUNTED:CAPS"></a><code class="literal">G_FILE_MONITOR_EVENT_UNMOUNTED</code></span></p></td>
 
181
<td><p><a name="G-FILE-MONITOR-EVENT-UNMOUNTED--CAPS"></a><span class="term"><code class="literal">G_FILE_MONITOR_EVENT_UNMOUNTED</code></span></p></td>
189
182
<td> the file location was unmounted.
190
183
</td>
191
184
</tr>
194
187
</div>
195
188
<hr>
196
189
<div class="refsect2" lang="en">
197
 
<a name="id2805334"></a><h3>
198
 
<a name="GFileMonitor-struct"></a>GFileMonitor</h3>
199
 
<a class="indexterm" name="id2805347"></a><pre class="programlisting">typedef struct _GFileMonitor GFileMonitor;</pre>
 
190
<a name="GFileMonitor-struct"></a><h3>GFileMonitor</h3>
 
191
<pre class="programlisting">typedef struct _GFileMonitor GFileMonitor;</pre>
200
192
<p>
201
193
Watches for changes to a file.</p>
202
194
<p>
203
 
 
204
195
</p>
205
196
</div>
206
197
<hr>
207
198
<div class="refsect2" lang="en">
208
 
<a name="id2805366"></a><h3>
209
 
<a name="g-file-monitor-cancel"></a>g_file_monitor_cancel ()</h3>
210
 
<a class="indexterm" name="id2805377"></a><pre class="programlisting"><a
 
199
<a name="g-file-monitor-cancel"></a><h3>g_file_monitor_cancel ()</h3>
 
200
<pre class="programlisting"><a
211
201
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
212
202
>gboolean</a>            g_file_monitor_cancel               (<a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a> *monitor);</pre>
213
203
<p>
214
204
Cancels a file monitor.</p>
215
205
<p>
216
 
 
217
206
</p>
218
207
<div class="variablelist"><table border="0">
219
208
<col align="left" valign="top">
220
209
<tbody>
221
210
<tr>
222
 
<td><p><span class="term"><em class="parameter"><code>monitor</code></em>&#160;:</span></p></td>
 
211
<td><p><span class="term"><em class="parameter"><code>monitor</code></em> :</span></p></td>
223
212
<td> a <a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="type">GFileMonitor</span></a>.
224
213
</td>
225
214
</tr>
226
215
<tr>
227
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
216
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
228
217
<td> <a
229
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
 
218
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
230
219
><code class="literal">TRUE</code></a> if monitor was cancelled.
231
220
</td>
232
221
</tr>
235
224
</div>
236
225
<hr>
237
226
<div class="refsect2" lang="en">
238
 
<a name="id2805454"></a><h3>
239
 
<a name="g-file-monitor-is-cancelled"></a>g_file_monitor_is_cancelled ()</h3>
240
 
<a class="indexterm" name="id2805466"></a><pre class="programlisting"><a
 
227
<a name="g-file-monitor-is-cancelled"></a><h3>g_file_monitor_is_cancelled ()</h3>
 
228
<pre class="programlisting"><a
241
229
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
242
230
>gboolean</a>            g_file_monitor_is_cancelled         (<a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a> *monitor);</pre>
243
231
<p>
244
232
Returns whether the monitor is canceled.</p>
245
233
<p>
246
 
 
247
234
</p>
248
235
<div class="variablelist"><table border="0">
249
236
<col align="left" valign="top">
250
237
<tbody>
251
238
<tr>
252
 
<td><p><span class="term"><em class="parameter"><code>monitor</code></em>&#160;:</span></p></td>
 
239
<td><p><span class="term"><em class="parameter"><code>monitor</code></em> :</span></p></td>
253
240
<td> a <a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="type">GFileMonitor</span></a>
254
241
</td>
255
242
</tr>
256
243
<tr>
257
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
244
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
258
245
<td> <a
259
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
 
246
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
260
247
><code class="literal">TRUE</code></a> if monitor is canceled. <a
261
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
 
248
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
262
249
><code class="literal">FALSE</code></a> otherwise.
263
250
</td>
264
251
</tr>
267
254
</div>
268
255
<hr>
269
256
<div class="refsect2" lang="en">
270
 
<a name="id2807998"></a><h3>
271
 
<a name="g-file-monitor-set-rate-limit"></a>g_file_monitor_set_rate_limit ()</h3>
272
 
<a class="indexterm" name="id2808011"></a><pre class="programlisting">void                g_file_monitor_set_rate_limit       (<a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a> *monitor,
 
257
<a name="g-file-monitor-set-rate-limit"></a><h3>g_file_monitor_set_rate_limit ()</h3>
 
258
<pre class="programlisting">void                g_file_monitor_set_rate_limit       (<a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a> *monitor,
273
259
                                                         int limit_msecs);</pre>
274
260
<p>
275
261
Sets the rate limit to which the <em class="parameter"><code>monitor</code></em> will report
276
262
consecutive change events to the same file.</p>
277
263
<p>
278
 
 
279
264
</p>
280
265
<div class="variablelist"><table border="0">
281
266
<col align="left" valign="top">
282
267
<tbody>
283
268
<tr>
284
 
<td><p><span class="term"><em class="parameter"><code>monitor</code></em>&#160;:</span></p></td>
 
269
<td><p><span class="term"><em class="parameter"><code>monitor</code></em> :</span></p></td>
285
270
<td> a <a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="type">GFileMonitor</span></a>.
286
271
</td>
287
272
</tr>
288
273
<tr>
289
 
<td><p><span class="term"><em class="parameter"><code>limit_msecs</code></em>&#160;:</span></p></td>
 
274
<td><p><span class="term"><em class="parameter"><code>limit_msecs</code></em> :</span></p></td>
290
275
<td> a integer with the limit in milliseconds to 
291
276
poll for changes.
292
277
</td>
296
281
</div>
297
282
<hr>
298
283
<div class="refsect2" lang="en">
299
 
<a name="id2808098"></a><h3>
300
 
<a name="g-file-monitor-emit-event"></a>g_file_monitor_emit_event ()</h3>
301
 
<a class="indexterm" name="id2808110"></a><pre class="programlisting">void                g_file_monitor_emit_event           (<a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a> *monitor,
 
284
<a name="g-file-monitor-emit-event"></a><h3>g_file_monitor_emit_event ()</h3>
 
285
<pre class="programlisting">void                g_file_monitor_emit_event           (<a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a> *monitor,
302
286
                                                         <a class="link" href="GFile.html" title="GFile">GFile</a> *child,
303
287
                                                         <a class="link" href="GFile.html" title="GFile">GFile</a> *other_file,
304
 
                                                         <a class="link" href="GFileMonitor.html#GFileMonitorEvent">GFileMonitorEvent</a> event_type);</pre>
 
288
                                                         <a class="link" href="GFileMonitor.html#GFileMonitorEvent" title="enum GFileMonitorEvent">GFileMonitorEvent</a> event_type);</pre>
305
289
<p>
306
 
Emits the <a class="link" href="GFileMonitor.html#GFileMonitor-changed"><span class="type">"changed"</span></a> signal if a change
 
290
Emits the <a class="link" href="GFileMonitor.html#GFileMonitor-changed" title='The "changed" signal'><span class="type">"changed"</span></a> signal if a change
307
291
has taken place. Should be called from file monitor 
308
292
implementations only.
309
293
</p>
310
294
<p>
311
295
The signal will be emitted from an idle handler.</p>
312
296
<p>
313
 
 
314
297
</p>
315
298
<div class="variablelist"><table border="0">
316
299
<col align="left" valign="top">
317
300
<tbody>
318
301
<tr>
319
 
<td><p><span class="term"><em class="parameter"><code>monitor</code></em>&#160;:</span></p></td>
 
302
<td><p><span class="term"><em class="parameter"><code>monitor</code></em> :</span></p></td>
320
303
<td> a <a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="type">GFileMonitor</span></a>.
321
304
</td>
322
305
</tr>
323
306
<tr>
324
 
<td><p><span class="term"><em class="parameter"><code>child</code></em>&#160;:</span></p></td>
325
 
<td> a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
326
 
</td>
327
 
</tr>
328
 
<tr>
329
 
<td><p><span class="term"><em class="parameter"><code>other_file</code></em>&#160;:</span></p></td>
330
 
<td> a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
331
 
</td>
332
 
</tr>
333
 
<tr>
334
 
<td><p><span class="term"><em class="parameter"><code>event_type</code></em>&#160;:</span></p></td>
335
 
<td> a set of <a class="link" href="GFileMonitor.html#GFileMonitorEvent"><span class="type">GFileMonitorEvent</span></a> flags.
 
307
<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
 
308
<td> a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
 
309
</td>
 
310
</tr>
 
311
<tr>
 
312
<td><p><span class="term"><em class="parameter"><code>other_file</code></em> :</span></p></td>
 
313
<td> a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
 
314
</td>
 
315
</tr>
 
316
<tr>
 
317
<td><p><span class="term"><em class="parameter"><code>event_type</code></em> :</span></p></td>
 
318
<td> a set of <a class="link" href="GFileMonitor.html#GFileMonitorEvent" title="enum GFileMonitorEvent"><span class="type">GFileMonitorEvent</span></a> flags.
336
319
</td>
337
320
</tr>
338
321
</tbody>
340
323
</div>
341
324
</div>
342
325
<div class="refsect1" lang="en">
343
 
<a name="id2808267"></a><h2>Property Details</h2>
 
326
<a name="GFileMonitor.property-details"></a><h2>Property Details</h2>
344
327
<div class="refsect2" lang="en">
345
 
<a name="id2808278"></a><h3>
346
 
<a name="GFileMonitor--cancelled"></a>The <code class="literal">"cancelled"</code> property</h3>
347
 
<a class="indexterm" name="id2808292"></a><pre class="programlisting">  "cancelled"                <a
 
328
<a name="GFileMonitor--cancelled"></a><h3>The <code class="literal">"cancelled"</code> property</h3>
 
329
<pre class="programlisting">  "cancelled"                <a
348
330
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
349
331
>gboolean</a>              : Read</pre>
350
332
<p>Whether the monitor has been cancelled.</p>
352
334
</div>
353
335
<hr>
354
336
<div class="refsect2" lang="en">
355
 
<a name="id2808316"></a><h3>
356
 
<a name="GFileMonitor--rate-limit"></a>The <code class="literal">"rate-limit"</code> property</h3>
357
 
<a class="indexterm" name="id2808330"></a><pre class="programlisting">  "rate-limit"               <a
 
337
<a name="GFileMonitor--rate-limit"></a><h3>The <code class="literal">"rate-limit"</code> property</h3>
 
338
<pre class="programlisting">  "rate-limit"               <a
358
339
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
359
340
>gint</a>                  : Read / Write</pre>
360
341
<p>The limit of the monitor to watch for changes, in milliseconds.</p>
363
344
</div>
364
345
</div>
365
346
<div class="refsect1" lang="en">
366
 
<a name="id2808362"></a><h2>Signal Details</h2>
 
347
<a name="GFileMonitor.signal-details"></a><h2>Signal Details</h2>
367
348
<div class="refsect2" lang="en">
368
 
<a name="id2808373"></a><h3>
369
 
<a name="GFileMonitor-changed"></a>The <code class="literal">"changed"</code> signal</h3>
370
 
<a class="indexterm" name="id2808387"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a>     *monitor,
 
349
<a name="GFileMonitor-changed"></a><h3>The <code class="literal">"changed"</code> signal</h3>
 
350
<pre class="programlisting">void                user_function                      (<a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a>     *monitor,
371
351
                                                        <a class="link" href="GFile.html" title="GFile">GFile</a>            *file,
372
352
                                                        <a class="link" href="GFile.html" title="GFile">GFile</a>            *other_file,
373
 
                                                        <a class="link" href="GFileMonitor.html#GFileMonitorEvent">GFileMonitorEvent</a> event_type,
 
353
                                                        <a class="link" href="GFileMonitor.html#GFileMonitorEvent" title="enum GFileMonitorEvent">GFileMonitorEvent</a> event_type,
374
354
                                                        <a
375
355
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
376
356
>gpointer</a>          user_data)       : Run Last</pre>
377
357
<p>
378
358
Emitted when a file has been changed.</p>
379
359
<p>
380
 
 
381
360
</p>
382
361
<div class="variablelist"><table border="0">
383
362
<col align="left" valign="top">
384
363
<tbody>
385
364
<tr>
386
 
<td><p><span class="term"><em class="parameter"><code>monitor</code></em>&#160;:</span></p></td>
 
365
<td><p><span class="term"><em class="parameter"><code>monitor</code></em> :</span></p></td>
387
366
<td> a <a class="link" href="GFileMonitor.html" title="GFileMonitor"><span class="type">GFileMonitor</span></a>.
388
367
</td>
389
368
</tr>
390
369
<tr>
391
 
<td><p><span class="term"><em class="parameter"><code>file</code></em>&#160;:</span></p></td>
392
 
<td> a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
393
 
</td>
394
 
</tr>
395
 
<tr>
396
 
<td><p><span class="term"><em class="parameter"><code>other_file</code></em>&#160;:</span></p></td>
397
 
<td> a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
398
 
</td>
399
 
</tr>
400
 
<tr>
401
 
<td><p><span class="term"><em class="parameter"><code>event_type</code></em>&#160;:</span></p></td>
402
 
<td> a <a class="link" href="GFileMonitor.html#GFileMonitorEvent"><span class="type">GFileMonitorEvent</span></a>.
403
 
</td>
404
 
</tr>
405
 
<tr>
406
 
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
 
370
<td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
 
371
<td> a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
 
372
</td>
 
373
</tr>
 
374
<tr>
 
375
<td><p><span class="term"><em class="parameter"><code>other_file</code></em> :</span></p></td>
 
376
<td> a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
 
377
</td>
 
378
</tr>
 
379
<tr>
 
380
<td><p><span class="term"><em class="parameter"><code>event_type</code></em> :</span></p></td>
 
381
<td> a <a class="link" href="GFileMonitor.html#GFileMonitorEvent" title="enum GFileMonitorEvent"><span class="type">GFileMonitorEvent</span></a>.
 
382
</td>
 
383
</tr>
 
384
<tr>
 
385
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
407
386
<td>user data set when the signal handler was connected.</td>
408
387
</tr>
409
388
</tbody>
410
389
</table></div>
411
390
</div>
412
391
</div>
413
 
<div class="refsect1" lang="en">
414
 
<a name="id2808554"></a><div class="refsect2" lang="en"><a name="id2808555"></a></div>
 
392
</div>
 
393
<div class="footer">
415
394
<hr>
416
 
<div class="refsect2" lang="en"><a name="id2808556"></a></div>
417
 
</div>
418
 
</div>
 
395
          Generated by GTK-Doc V1.11</div>
419
396
</body>
420
397
</html>