136
148
char *supinfo[]);</pre>
138
The signature of a function that can used as a target for <a class="link" href="libgnome-gnome-triggers.html#GTRIG-FUNCTION:CAPS"><span class="type">GTRIG_FUNCTION</span></a>
139
types of <span class="type">GnomeTrigger</span> instances.
150
The signature of a function that can used as a target for <a class="link" href="libgnome-gnome-triggers.html#GTRIG-FUNCTION--CAPS"><span class="type">GTRIG_FUNCTION</span></a>
151
types of <a class="link" href="libgnome-gnome-triggers.html#GnomeTrigger" title="GnomeTrigger"><span class="type">GnomeTrigger</span></a> instances.
141
153
<div class="variablelist"><table border="0">
142
154
<col align="left" valign="top">
145
157
<td><p><span class="term"><em class="parameter"><code>msg</code></em> :</span></p></td>
146
<td>The human-readable message that was passed to <code class="function">gnome_triggers_do()</code>. May be
158
<td>The human-readable message that was passed to <a class="link" href="libgnome-gnome-triggers.html#gnome-triggers-do" title="gnome_triggers_do ()"><code class="function">gnome_triggers_do()</code></a>. May be
148
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
160
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
149
161
><code class="literal">NULL</code></a>.
153
165
<td><p><span class="term"><em class="parameter"><code>level</code></em> :</span></p></td>
154
166
<td>The severity level of the event. May be <a
155
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
167
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
156
168
><code class="literal">NULL</code></a>.
160
172
<td><p><span class="term"><em class="parameter"><code>supinfo</code></em> :</span></p></td>
161
173
<td>The section in which the event belongs. This is a <a
162
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
174
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
163
175
><code class="literal">NULL</code></a> terminated
183
<div class="refsect2" lang="en">
184
<a name="GnomeTrigger"></a><h3>GnomeTrigger</h3>
185
<pre class="programlisting">typedef struct {
186
GnomeTriggerType type;
189
* These will be passed the same info as
190
* gnome_triggers_do was given.
192
GnomeTriggerActionFunction function;
203
This structure stores the information about an action that is triggered for
204
a particular event. A filled in instance of this structure is passed to
205
<a class="link" href="libgnome-gnome-triggers.html#gnome-triggers-add-trigger" title="gnome_triggers_add_trigger ()"><code class="function">gnome_triggers_add_trigger()</code></a> and <a class="link" href="libgnome-gnome-triggers.html#gnome-triggers-vadd-trigger" title="gnome_triggers_vadd_trigger ()"><code class="function">gnome_triggers_vadd_trigger()</code></a>.
209
<div class="refsect2" lang="en">
210
<a name="gnome-triggers-add-trigger"></a><h3>gnome_triggers_add_trigger ()</h3>
211
<pre class="programlisting">void gnome_triggers_add_trigger (<a class="link" href="libgnome-gnome-triggers.html#GnomeTrigger" title="GnomeTrigger">GnomeTrigger</a> *nt,
214
Adds a new <a class="link" href="libgnome-gnome-triggers.html#GnomeTrigger" title="GnomeTrigger"><span class="type">GnomeTrigger</span></a> instance to the event hierarchy.</p>
217
<div class="variablelist"><table border="0">
218
<col align="left" valign="top">
221
<td><p><span class="term"><em class="parameter"><code>nt</code></em> :</span></p></td>
222
<td> Information on the new trigger to be added.
226
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
227
<td> The section to add the trigger under.
234
<div class="refsect2" lang="en">
235
<a name="gnome-triggers-vadd-trigger"></a><h3>gnome_triggers_vadd_trigger ()</h3>
236
<pre class="programlisting">void gnome_triggers_vadd_trigger (<a class="link" href="libgnome-gnome-triggers.html#GnomeTrigger" title="GnomeTrigger">GnomeTrigger</a> *nt,
237
char *supinfo[]);</pre>
239
This does the same as <a class="link" href="libgnome-gnome-triggers.html#gnome-triggers-add-trigger" title="gnome_triggers_add_trigger ()"><code class="function">gnome_triggers_add_trigger()</code></a>, except the section is
241
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
242
><code class="literal">NULL</code></a> terminated array <em class="parameter"><code>supinfo</code></em> instead of as a variable
243
length argument list.</p>
246
<div class="variablelist"><table border="0">
247
<col align="left" valign="top">
250
<td><p><span class="term"><em class="parameter"><code>nt</code></em> :</span></p></td>
251
<td> Information on the new trigger to be added.
255
<td><p><span class="term"><em class="parameter"><code>supinfo</code></em> :</span></p></td>
256
<td> The section to add the trigger under.
263
<div class="refsect2" lang="en">
264
<a name="gnome-triggers-do"></a><h3>gnome_triggers_do ()</h3>
265
<pre class="programlisting">void gnome_triggers_do (const char *msg,
269
Notifies GNOME about an event happening, so that any appropriate handlers
273
<div class="variablelist"><table border="0">
274
<col align="left" valign="top">
277
<td><p><span class="term"><em class="parameter"><code>msg</code></em> :</span></p></td>
278
<td> The human-readable message describing the event (can be <a
279
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
280
><code class="literal">NULL</code></a>).
284
<td><p><span class="term"><em class="parameter"><code>level</code></em> :</span></p></td>
285
<td> The level of severity of the event, or <a
286
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
287
><code class="literal">NULL</code></a>.
291
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
292
<td> The classification of the event.
299
<div class="refsect2" lang="en">
300
<a name="gnome-triggers-vdo"></a><h3>gnome_triggers_vdo ()</h3>
301
<pre class="programlisting">void gnome_triggers_vdo (const char *msg,
303
const char *supinfo[]);</pre>
305
Notifies GNOME about an event happening, so that any appropriate handlers
306
can be run. This does the same as <code class="function">gnome_trigger_do()</code> except that it takes a
308
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
309
><code class="literal">NULL</code></a> terminated array instead of a varargs list.</p>
312
<div class="variablelist"><table border="0">
313
<col align="left" valign="top">
316
<td><p><span class="term"><em class="parameter"><code>msg</code></em> :</span></p></td>
317
<td> The human-readable message describing the event (can be <a
318
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
319
><code class="literal">NULL</code></a>).
323
<td><p><span class="term"><em class="parameter"><code>level</code></em> :</span></p></td>
324
<td> The level of severity of the event, or <a
325
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
326
><code class="literal">NULL</code></a>.
330
<td><p><span class="term"><em class="parameter"><code>supinfo</code></em> :</span></p></td>
331
<td> The classification of the event (<a
332
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
333
><code class="literal">NULL</code></a> terminated array).