1
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
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 I. 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 II. 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 III. 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">
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>
43
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2755792" class="shortcut">Top</a>
45
<a href="#id2814984" class="shortcut">Description</a>
47
<a href="#id2814894" class="shortcut">Object Hierarchy</a>
49
<a href="#id2814918" class="shortcut">Properties</a>
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>
47
<a href="#GFileMonitor.description" class="shortcut">Description</a>
49
<a href="#GFileMonitor.object-hierarchy" class="shortcut">Object Hierarchy</a>
51
<a href="#GFileMonitor.properties" class="shortcut">Properties</a>
53
<a href="#GFileMonitor.signals" class="shortcut">Signals</a>
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>
58
<a name="id2755792"></a><span class="refentrytitle">GFileMonitor</span>
60
<p>GFileMonitor — File Monitor</p>
60
<h2><span class="refentrytitle"><a name="GFileMonitor.top_of_page"></a>GFileMonitor</span></h2>
61
<p>GFileMonitor — File Monitor</p>
62
63
<td valign="top" align="right"></td>
63
64
</tr></table></div>
64
65
<div class="refsynopsisdiv">
66
<a name="GFileMonitor.synopsis"></a><h2>Synopsis</h2>
66
67
<pre class="synopsis">
68
69
#include <gio/gio.h>
71
enum <a class="link" href="GFileMonitor.html#GFileMonitorEvent">GFileMonitorEvent</a>;
72
<a class="link" href="GFileMonitor.html#GFileMonitor-struct">GFileMonitor</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);
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>;
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);
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,
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);
84
<a class="link" href="GFileMonitor.html#GFileMonitorEvent" title="enum GFileMonitorEvent">GFileMonitorEvent</a> event_type);
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">
94
91
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
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">
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
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">
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
118
113
<div class="refsect1" lang="en">
119
<a name="id2814984"></a><h2>Description</h2>
114
<a name="GFileMonitor.description"></a><h2>Description</h2>
121
116
Monitors a file or directory for changes.
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>.
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>
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,
150
144
Specifies what type of event a monitor event is.</p>
154
147
<div class="variablelist"><table border="0">
155
148
<col align="left" valign="top">
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.
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.
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.
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.
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.
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.
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.
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>
201
193
Watches for changes to a file.</p>
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>
214
204
Cancels a file monitor.</p>
218
207
<div class="variablelist"><table border="0">
219
208
<col align="left" valign="top">
222
<td><p><span class="term"><em class="parameter"><code>monitor</code></em> :</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>.
227
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
216
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
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.
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>
244
232
Returns whether the monitor is canceled.</p>
248
235
<div class="variablelist"><table border="0">
249
236
<col align="left" valign="top">
252
<td><p><span class="term"><em class="parameter"><code>monitor</code></em> :</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>
257
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
244
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
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.
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>
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>
280
265
<div class="variablelist"><table border="0">
281
266
<col align="left" valign="top">
284
<td><p><span class="term"><em class="parameter"><code>monitor</code></em> :</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>.
289
<td><p><span class="term"><em class="parameter"><code>limit_msecs</code></em> :</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.
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>
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.
311
295
The signal will be emitted from an idle handler.</p>
315
298
<div class="variablelist"><table border="0">
316
299
<col align="left" valign="top">
319
<td><p><span class="term"><em class="parameter"><code>monitor</code></em> :</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>.
324
<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
325
<td> a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
329
<td><p><span class="term"><em class="parameter"><code>other_file</code></em> :</span></p></td>
330
<td> a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
334
<td><p><span class="term"><em class="parameter"><code>event_type</code></em> :</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>.
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>.
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.
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>
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>
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,
375
355
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
376
356
>gpointer</a> user_data) : Run Last</pre>
378
358
Emitted when a file has been changed.</p>
382
361
<div class="variablelist"><table border="0">
383
362
<col align="left" valign="top">
386
<td><p><span class="term"><em class="parameter"><code>monitor</code></em> :</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>.
391
<td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
392
<td> a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
396
<td><p><span class="term"><em class="parameter"><code>other_file</code></em> :</span></p></td>
397
<td> a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
401
<td><p><span class="term"><em class="parameter"><code>event_type</code></em> :</span></p></td>
402
<td> a <a class="link" href="GFileMonitor.html#GFileMonitorEvent"><span class="type">GFileMonitorEvent</span></a>.
406
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</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>.
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>.
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>.
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>
413
<div class="refsect1" lang="en">
414
<a name="id2808554"></a><div class="refsect2" lang="en"><a name="id2808555"></a></div>
416
<div class="refsect2" lang="en"><a name="id2808556"></a></div>
395
Generated by GTK-Doc V1.11</div>