~ubuntu-branches/ubuntu/trusty/glib2.0/trusty-proposed
» Revision
48
: docs/reference/gobject/html/gobject-Signals.html
« back to all changes in this revision
Viewing changes to docs/reference/gobject/html/gobject-Signals.html
- browse files at revision 48
- compare with another revision
- download diff
- download tarball
- view history from revision 48
- Committer: Bazaar Package Importer
- Author(s): Sebastien Bacher
- Date: 2010-03-09 11:28:22 UTC
- mfrom: (3.4.8 experimental)
- Revision ID: james.westby@ubuntu.com-20100309112822-j4n0v3xbtsup8s97
Tags: 2.23.5-1ubuntu1
* Resync on Debian
* debian/patches/01_gettext-desktopfiles.patch:
- updated to use gettext for X-GNOME-Fullname too
* debian/patches/71_gio_launch_handler.patch:
- new gio default launch handle feature required for wncksync
* debian/control.in,
debian/patches/80-gtester-subunit.patch:
- gtester-report subunit support
* debian/libglib2.0-0.symbols:
- updated the symbols list for the gio launcher handler
* debian/rules:
- don't break build on test suite errors, debian recently activated this but
the build breaks even when there is no error in the testsuite
* debian/patches/01_gettext-desktopfiles.patch:
- updated to use gettext for X-GNOME-Fullname too
* debian/patches/71_gio_launch_handler.patch:
- new gio default launch handle feature required for wncksync
* debian/control.in,
debian/patches/80-gtester-subunit.patch:
- gtester-report subunit support
* debian/libglib2.0-0.symbols:
- updated the symbols list for the gio launcher handler
* debian/rules:
- don't break build on test suite errors, debian recently activated this but
the build breaks even when there is no error in the testsuite
- files added:
- docs/reference/gio/html/GZlibCompressor.html
- docs/reference/gio/xml
- docs/reference/glib/xml
- docs/reference/gobject/xml
- files modified:
- ChangeLog
added
removed
docs/reference/gobject/html/gobject-Signals.html
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>Signals</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
7
7
<link rel="home" href="index.html" title="GObject Reference Manual">
8
8
<link rel="up" href="rn01.html" title="API Reference">
9
9
<link rel="prev" href="gobject-Varargs-Value-Collection.html" title="Varargs Value Collection">
10
10
<link rel="next" href="gobject-Closures.html" title="Closures">
11
<meta name="generator" content="GTK-Doc V1.13 (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
13
<link rel="preface" href="pr01.html" title="Introduction">
14
14
<link rel="part" href="pt01.html" title="Part I. Concepts">
52
52
</tr>
53
53
<tr><td colspan="5" class="shortcuts">
54
54
<a href="#gobject-Signals.synopsis" class="shortcut">Top</a>
55
|
56
<a href="#gobject-Signals.description" class="shortcut">Description</a>
55
|
56
<a href="#gobject-Signals.description" class="shortcut">Description</a>
57
57
</td></tr>
58
58
</table>
59
59
<div class="refentry" title="Signals">
69
69
<div class="refsynopsisdiv" title="Synopsis">
70
70
<a name="gobject-Signals.synopsis"></a><h2>Synopsis</h2>
71
71
<pre class="synopsis">
72
72
73
#include <glib-object.h>
73
74
74
75
<a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint">GSignalInvocationHint</a>;
75
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()">*GSignalAccumulator</a>) (<a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="returnvalue">GSignalInvocationHint</span></a> *ihint,
76
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *return_accu,
77
const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *handler_return,
78
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> data);
76
<a
77
href="./../glib/glib/glib-Basic-Types.html#gboolean"
78
>gboolean</a> (<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()">*GSignalAccumulator</a>) (<a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint">GSignalInvocationHint</a> *ihint,
79
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *return_accu,
80
const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *handler_return,
81
<a
82
href="./../glib/glib/glib-Basic-Types.html#gpointer"
83
>gpointer</a> data);
79
84
typedef <a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller">GSignalCMarshaller</a>;
80
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="gobject-Signals.html#GSignalEmissionHook" title="GSignalEmissionHook ()">*GSignalEmissionHook</a>) (<a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="returnvalue">GSignalInvocationHint</span></a> *ihint,
81
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_param_values,
82
const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *param_values,
83
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> data);
85
<a
86
href="./../glib/glib/glib-Basic-Types.html#gboolean"
87
>gboolean</a> (<a class="link" href="gobject-Signals.html#GSignalEmissionHook" title="GSignalEmissionHook ()">*GSignalEmissionHook</a>) (<a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint">GSignalInvocationHint</a> *ihint,
88
<a
89
href="./../glib/glib/glib-Basic-Types.html#guint"
90
>guint</a> n_param_values,
91
const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *param_values,
92
<a
93
href="./../glib/glib/glib-Basic-Types.html#gpointer"
94
>gpointer</a> data);
84
95
enum <a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags">GSignalFlags</a>;
85
96
enum <a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a>;
86
97
<a class="link" href="gobject-Signals.html#GSignalQuery" title="GSignalQuery">GSignalQuery</a>;
87
#define <a class="link" href="gobject-Signals.html#G-SIGNAL-TYPE-STATIC-SCOPE:CAPS" title="G_SIGNAL_TYPE_STATIC_SCOPE">G_SIGNAL_TYPE_STATIC_SCOPE</a>
88
#define <a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-MASK:CAPS" title="G_SIGNAL_MATCH_MASK">G_SIGNAL_MATCH_MASK</a>
89
#define <a class="link" href="gobject-Signals.html#G-SIGNAL-FLAGS-MASK:CAPS" title="G_SIGNAL_FLAGS_MASK">G_SIGNAL_FLAGS_MASK</a>
90
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="gobject-Signals.html#g-signal-new" title="g_signal_new ()">g_signal_new</a> (const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *signal_name,
91
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> itype,
92
<a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="returnvalue">GSignalFlags</span></a> signal_flags,
93
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> class_offset,
94
<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="returnvalue">GSignalAccumulator</span></a> accumulator,
95
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> accu_data,
96
<a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller"><span class="returnvalue">GSignalCMarshaller</span></a> c_marshaller,
97
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> return_type,
98
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_params,
99
...);
100
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="gobject-Signals.html#g-signal-newv" title="g_signal_newv ()">g_signal_newv</a> (const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *signal_name,
101
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> itype,
102
<a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="returnvalue">GSignalFlags</span></a> signal_flags,
103
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *class_closure,
104
<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="returnvalue">GSignalAccumulator</span></a> accumulator,
105
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> accu_data,
106
<a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller"><span class="returnvalue">GSignalCMarshaller</span></a> c_marshaller,
107
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> return_type,
108
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_params,
109
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> *param_types);
110
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="gobject-Signals.html#g-signal-new-valist" title="g_signal_new_valist ()">g_signal_new_valist</a> (const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *signal_name,
111
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> itype,
112
<a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="returnvalue">GSignalFlags</span></a> signal_flags,
113
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *class_closure,
114
<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="returnvalue">GSignalAccumulator</span></a> accumulator,
115
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> accu_data,
116
<a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller"><span class="returnvalue">GSignalCMarshaller</span></a> c_marshaller,
117
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> return_type,
118
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_params,
119
<span class="returnvalue">va_list</span> args);
120
<span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-query" title="g_signal_query ()">g_signal_query</a> (<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
121
<a class="link" href="gobject-Signals.html#GSignalQuery" title="GSignalQuery"><span class="returnvalue">GSignalQuery</span></a> *query);
122
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="gobject-Signals.html#g-signal-lookup" title="g_signal_lookup ()">g_signal_lookup</a> (const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *name,
123
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> itype);
124
const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="gobject-Signals.html#g-signal-name" title="g_signal_name ()">g_signal_name</a> (<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id);
125
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>* <a class="link" href="gobject-Signals.html#g-signal-list-ids" title="g_signal_list_ids ()">g_signal_list_ids</a> (<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> itype,
126
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> *n_ids);
127
<span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-emit" title="g_signal_emit ()">g_signal_emit</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
128
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
129
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
130
...);
131
<span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-emit-by-name" title="g_signal_emit_by_name ()">g_signal_emit_by_name</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
132
const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *detailed_signal,
133
...);
134
<span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-emitv" title="g_signal_emitv ()">g_signal_emitv</a> (const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *instance_and_params,
135
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
136
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
137
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *return_value);
138
<span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-emit-valist" title="g_signal_emit_valist ()">g_signal_emit_valist</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
139
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
140
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
141
<span class="returnvalue">va_list</span> var_args);
98
#define <a class="link" href="gobject-Signals.html#G-SIGNAL-TYPE-STATIC-SCOPE--CAPS" title="G_SIGNAL_TYPE_STATIC_SCOPE">G_SIGNAL_TYPE_STATIC_SCOPE</a>
99
#define <a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-MASK--CAPS" title="G_SIGNAL_MATCH_MASK">G_SIGNAL_MATCH_MASK</a>
100
#define <a class="link" href="gobject-Signals.html#G-SIGNAL-FLAGS-MASK--CAPS" title="G_SIGNAL_FLAGS_MASK">G_SIGNAL_FLAGS_MASK</a>
101
<a
102
href="./../glib/glib/glib-Basic-Types.html#guint"
103
>guint</a> <a class="link" href="gobject-Signals.html#g-signal-new" title="g_signal_new ()">g_signal_new</a> (const <a
104
href="./../glib/glib/glib-Basic-Types.html#gchar"
105
>gchar</a> *signal_name,
106
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype,
107
<a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags">GSignalFlags</a> signal_flags,
108
<a
109
href="./../glib/glib/glib-Basic-Types.html#guint"
110
>guint</a> class_offset,
111
<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()">GSignalAccumulator</a> accumulator,
112
<a
113
href="./../glib/glib/glib-Basic-Types.html#gpointer"
114
>gpointer</a> accu_data,
115
<a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller">GSignalCMarshaller</a> c_marshaller,
116
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> return_type,
117
<a
118
href="./../glib/glib/glib-Basic-Types.html#guint"
119
>guint</a> n_params,
120
...);
121
<a
122
href="./../glib/glib/glib-Basic-Types.html#guint"
123
>guint</a> <a class="link" href="gobject-Signals.html#g-signal-newv" title="g_signal_newv ()">g_signal_newv</a> (const <a
124
href="./../glib/glib/glib-Basic-Types.html#gchar"
125
>gchar</a> *signal_name,
126
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype,
127
<a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags">GSignalFlags</a> signal_flags,
128
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *class_closure,
129
<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()">GSignalAccumulator</a> accumulator,
130
<a
131
href="./../glib/glib/glib-Basic-Types.html#gpointer"
132
>gpointer</a> accu_data,
133
<a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller">GSignalCMarshaller</a> c_marshaller,
134
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> return_type,
135
<a
136
href="./../glib/glib/glib-Basic-Types.html#guint"
137
>guint</a> n_params,
138
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> *param_types);
139
<a
140
href="./../glib/glib/glib-Basic-Types.html#guint"
141
>guint</a> <a class="link" href="gobject-Signals.html#g-signal-new-valist" title="g_signal_new_valist ()">g_signal_new_valist</a> (const <a
142
href="./../glib/glib/glib-Basic-Types.html#gchar"
143
>gchar</a> *signal_name,
144
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype,
145
<a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags">GSignalFlags</a> signal_flags,
146
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *class_closure,
147
<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()">GSignalAccumulator</a> accumulator,
148
<a
149
href="./../glib/glib/glib-Basic-Types.html#gpointer"
150
>gpointer</a> accu_data,
151
<a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller">GSignalCMarshaller</a> c_marshaller,
152
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> return_type,
153
<a
154
href="./../glib/glib/glib-Basic-Types.html#guint"
155
>guint</a> n_params,
156
va_list args);
157
void <a class="link" href="gobject-Signals.html#g-signal-query" title="g_signal_query ()">g_signal_query</a> (<a
158
href="./../glib/glib/glib-Basic-Types.html#guint"
159
>guint</a> signal_id,
160
<a class="link" href="gobject-Signals.html#GSignalQuery" title="GSignalQuery">GSignalQuery</a> *query);
161
<a
162
href="./../glib/glib/glib-Basic-Types.html#guint"
163
>guint</a> <a class="link" href="gobject-Signals.html#g-signal-lookup" title="g_signal_lookup ()">g_signal_lookup</a> (const <a
164
href="./../glib/glib/glib-Basic-Types.html#gchar"
165
>gchar</a> *name,
166
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype);
167
const <a
168
href="./../glib/glib/glib-Basic-Types.html#gchar"
169
>gchar</a>* <a class="link" href="gobject-Signals.html#g-signal-name" title="g_signal_name ()">g_signal_name</a> (<a
170
href="./../glib/glib/glib-Basic-Types.html#guint"
171
>guint</a> signal_id);
172
<a
173
href="./../glib/glib/glib-Basic-Types.html#guint"
174
>guint</a>* <a class="link" href="gobject-Signals.html#g-signal-list-ids" title="g_signal_list_ids ()">g_signal_list_ids</a> (<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype,
175
<a
176
href="./../glib/glib/glib-Basic-Types.html#guint"
177
>guint</a> *n_ids);
178
void <a class="link" href="gobject-Signals.html#g-signal-emit" title="g_signal_emit ()">g_signal_emit</a> (<a
179
href="./../glib/glib/glib-Basic-Types.html#gpointer"
180
>gpointer</a> instance,
181
<a
182
href="./../glib/glib/glib-Basic-Types.html#guint"
183
>guint</a> signal_id,
184
<a
185
href="./../glib/glib/glib-Quarks.html#GQuark"
186
>GQuark</a> detail,
187
...);
188
void <a class="link" href="gobject-Signals.html#g-signal-emit-by-name" title="g_signal_emit_by_name ()">g_signal_emit_by_name</a> (<a
189
href="./../glib/glib/glib-Basic-Types.html#gpointer"
190
>gpointer</a> instance,
191
const <a
192
href="./../glib/glib/glib-Basic-Types.html#gchar"
193
>gchar</a> *detailed_signal,
194
...);
195
void <a class="link" href="gobject-Signals.html#g-signal-emitv" title="g_signal_emitv ()">g_signal_emitv</a> (const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *instance_and_params,
196
<a
197
href="./../glib/glib/glib-Basic-Types.html#guint"
198
>guint</a> signal_id,
199
<a
200
href="./../glib/glib/glib-Quarks.html#GQuark"
201
>GQuark</a> detail,
202
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *return_value);
203
void <a class="link" href="gobject-Signals.html#g-signal-emit-valist" title="g_signal_emit_valist ()">g_signal_emit_valist</a> (<a
204
href="./../glib/glib/glib-Basic-Types.html#gpointer"
205
>gpointer</a> instance,
206
<a
207
href="./../glib/glib/glib-Basic-Types.html#guint"
208
>guint</a> signal_id,
209
<a
210
href="./../glib/glib/glib-Quarks.html#GQuark"
211
>GQuark</a> detail,
212
va_list var_args);
142
213
#define <a class="link" href="gobject-Signals.html#g-signal-connect" title="g_signal_connect()">g_signal_connect</a> (instance, detailed_signal, c_handler, data)
143
214
#define <a class="link" href="gobject-Signals.html#g-signal-connect-after" title="g_signal_connect_after()">g_signal_connect_after</a> (instance, detailed_signal, c_handler, data)
144
215
#define <a class="link" href="gobject-Signals.html#g-signal-connect-swapped" title="g_signal_connect_swapped()">g_signal_connect_swapped</a> (instance, detailed_signal, c_handler, data)
145
<a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> <a class="link" href="gobject-Signals.html#g-signal-connect-object" title="g_signal_connect_object ()">g_signal_connect_object</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
146
const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *detailed_signal,
147
<a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="returnvalue">GCallback</span></a> c_handler,
148
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> gobject,
149
<a class="link" href="gobject-Signals.html#GConnectFlags" title="enum GConnectFlags"><span class="returnvalue">GConnectFlags</span></a> connect_flags);
216
<a
217
href="./../glib/glib/glib-Basic-Types.html#gulong"
218
>gulong</a> <a class="link" href="gobject-Signals.html#g-signal-connect-object" title="g_signal_connect_object ()">g_signal_connect_object</a> (<a
219
href="./../glib/glib/glib-Basic-Types.html#gpointer"
220
>gpointer</a> instance,
221
const <a
222
href="./../glib/glib/glib-Basic-Types.html#gchar"
223
>gchar</a> *detailed_signal,
224
<a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()">GCallback</a> c_handler,
225
<a
226
href="./../glib/glib/glib-Basic-Types.html#gpointer"
227
>gpointer</a> gobject,
228
<a class="link" href="gobject-Signals.html#GConnectFlags" title="enum GConnectFlags">GConnectFlags</a> connect_flags);
150
229
enum <a class="link" href="gobject-Signals.html#GConnectFlags" title="enum GConnectFlags">GConnectFlags</a>;
151
<a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> <a class="link" href="gobject-Signals.html#g-signal-connect-data" title="g_signal_connect_data ()">g_signal_connect_data</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
152
const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *detailed_signal,
153
<a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="returnvalue">GCallback</span></a> c_handler,
154
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> data,
155
<a class="link" href="gobject-Closures.html#GClosureNotify" title="GClosureNotify ()"><span class="returnvalue">GClosureNotify</span></a> destroy_data,
156
<a class="link" href="gobject-Signals.html#GConnectFlags" title="enum GConnectFlags"><span class="returnvalue">GConnectFlags</span></a> connect_flags);
157
<a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> <a class="link" href="gobject-Signals.html#g-signal-connect-closure" title="g_signal_connect_closure ()">g_signal_connect_closure</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
158
const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *detailed_signal,
159
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *closure,
160
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> after);
161
<a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> <a class="link" href="gobject-Signals.html#g-signal-connect-closure-by-id" title="g_signal_connect_closure_by_id ()">g_signal_connect_closure_by_id</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
162
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
163
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
164
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *closure,
165
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> after);
166
<span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-handler-block" title="g_signal_handler_block ()">g_signal_handler_block</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
167
<a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> handler_id);
168
<span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-handler-unblock" title="g_signal_handler_unblock ()">g_signal_handler_unblock</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
169
<a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> handler_id);
170
<span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-handler-disconnect" title="g_signal_handler_disconnect ()">g_signal_handler_disconnect</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
171
<a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> handler_id);
172
<a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> <a class="link" href="gobject-Signals.html#g-signal-handler-find" title="g_signal_handler_find ()">g_signal_handler_find</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
173
<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="returnvalue">GSignalMatchType</span></a> mask,
174
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
175
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
176
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *closure,
177
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> func,
178
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> data);
179
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="gobject-Signals.html#g-signal-handlers-block-matched" title="g_signal_handlers_block_matched ()">g_signal_handlers_block_matched</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
180
<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="returnvalue">GSignalMatchType</span></a> mask,
181
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
182
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
183
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *closure,
184
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> func,
185
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> data);
186
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="gobject-Signals.html#g-signal-handlers-unblock-matched" title="g_signal_handlers_unblock_matched ()">g_signal_handlers_unblock_matched</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
187
<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="returnvalue">GSignalMatchType</span></a> mask,
188
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
189
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
190
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *closure,
191
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> func,
192
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> data);
193
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="gobject-Signals.html#g-signal-handlers-disconnect-matched" title="g_signal_handlers_disconnect_matched ()">g_signal_handlers_disconnect_matched</a>
194
(<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
195
<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="returnvalue">GSignalMatchType</span></a> mask,
196
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
197
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
198
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *closure,
199
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> func,
200
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> data);
201
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gobject-Signals.html#g-signal-handler-is-connected" title="g_signal_handler_is_connected ()">g_signal_handler_is_connected</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
202
<a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> handler_id);
230
<a
231
href="./../glib/glib/glib-Basic-Types.html#gulong"
232
>gulong</a> <a class="link" href="gobject-Signals.html#g-signal-connect-data" title="g_signal_connect_data ()">g_signal_connect_data</a> (<a
233
href="./../glib/glib/glib-Basic-Types.html#gpointer"
234
>gpointer</a> instance,
235
const <a
236
href="./../glib/glib/glib-Basic-Types.html#gchar"
237
>gchar</a> *detailed_signal,
238
<a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()">GCallback</a> c_handler,
239
<a
240
href="./../glib/glib/glib-Basic-Types.html#gpointer"
241
>gpointer</a> data,
242
<a class="link" href="gobject-Closures.html#GClosureNotify" title="GClosureNotify ()">GClosureNotify</a> destroy_data,
243
<a class="link" href="gobject-Signals.html#GConnectFlags" title="enum GConnectFlags">GConnectFlags</a> connect_flags);
244
<a
245
href="./../glib/glib/glib-Basic-Types.html#gulong"
246
>gulong</a> <a class="link" href="gobject-Signals.html#g-signal-connect-closure" title="g_signal_connect_closure ()">g_signal_connect_closure</a> (<a
247
href="./../glib/glib/glib-Basic-Types.html#gpointer"
248
>gpointer</a> instance,
249
const <a
250
href="./../glib/glib/glib-Basic-Types.html#gchar"
251
>gchar</a> *detailed_signal,
252
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *closure,
253
<a
254
href="./../glib/glib/glib-Basic-Types.html#gboolean"
255
>gboolean</a> after);
256
<a
257
href="./../glib/glib/glib-Basic-Types.html#gulong"
258
>gulong</a> <a class="link" href="gobject-Signals.html#g-signal-connect-closure-by-id" title="g_signal_connect_closure_by_id ()">g_signal_connect_closure_by_id</a> (<a
259
href="./../glib/glib/glib-Basic-Types.html#gpointer"
260
>gpointer</a> instance,
261
<a
262
href="./../glib/glib/glib-Basic-Types.html#guint"
263
>guint</a> signal_id,
264
<a
265
href="./../glib/glib/glib-Quarks.html#GQuark"
266
>GQuark</a> detail,
267
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *closure,
268
<a
269
href="./../glib/glib/glib-Basic-Types.html#gboolean"
270
>gboolean</a> after);
271
void <a class="link" href="gobject-Signals.html#g-signal-handler-block" title="g_signal_handler_block ()">g_signal_handler_block</a> (<a
272
href="./../glib/glib/glib-Basic-Types.html#gpointer"
273
>gpointer</a> instance,
274
<a
275
href="./../glib/glib/glib-Basic-Types.html#gulong"
276
>gulong</a> handler_id);
277
void <a class="link" href="gobject-Signals.html#g-signal-handler-unblock" title="g_signal_handler_unblock ()">g_signal_handler_unblock</a> (<a
278
href="./../glib/glib/glib-Basic-Types.html#gpointer"
279
>gpointer</a> instance,
280
<a
281
href="./../glib/glib/glib-Basic-Types.html#gulong"
282
>gulong</a> handler_id);
283
void <a class="link" href="gobject-Signals.html#g-signal-handler-disconnect" title="g_signal_handler_disconnect ()">g_signal_handler_disconnect</a> (<a
284
href="./../glib/glib/glib-Basic-Types.html#gpointer"
285
>gpointer</a> instance,
286
<a
287
href="./../glib/glib/glib-Basic-Types.html#gulong"
288
>gulong</a> handler_id);
289
<a
290
href="./../glib/glib/glib-Basic-Types.html#gulong"
291
>gulong</a> <a class="link" href="gobject-Signals.html#g-signal-handler-find" title="g_signal_handler_find ()">g_signal_handler_find</a> (<a
292
href="./../glib/glib/glib-Basic-Types.html#gpointer"
293
>gpointer</a> instance,
294
<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a> mask,
295
<a
296
href="./../glib/glib/glib-Basic-Types.html#guint"
297
>guint</a> signal_id,
298
<a
299
href="./../glib/glib/glib-Quarks.html#GQuark"
300
>GQuark</a> detail,
301
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *closure,
302
<a
303
href="./../glib/glib/glib-Basic-Types.html#gpointer"
304
>gpointer</a> func,
305
<a
306
href="./../glib/glib/glib-Basic-Types.html#gpointer"
307
>gpointer</a> data);
308
<a
309
href="./../glib/glib/glib-Basic-Types.html#guint"
310
>guint</a> <a class="link" href="gobject-Signals.html#g-signal-handlers-block-matched" title="g_signal_handlers_block_matched ()">g_signal_handlers_block_matched</a> (<a
311
href="./../glib/glib/glib-Basic-Types.html#gpointer"
312
>gpointer</a> instance,
313
<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a> mask,
314
<a
315
href="./../glib/glib/glib-Basic-Types.html#guint"
316
>guint</a> signal_id,
317
<a
318
href="./../glib/glib/glib-Quarks.html#GQuark"
319
>GQuark</a> detail,
320
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *closure,
321
<a
322
href="./../glib/glib/glib-Basic-Types.html#gpointer"
323
>gpointer</a> func,
324
<a
325
href="./../glib/glib/glib-Basic-Types.html#gpointer"
326
>gpointer</a> data);
327
<a
328
href="./../glib/glib/glib-Basic-Types.html#guint"
329
>guint</a> <a class="link" href="gobject-Signals.html#g-signal-handlers-unblock-matched" title="g_signal_handlers_unblock_matched ()">g_signal_handlers_unblock_matched</a> (<a
330
href="./../glib/glib/glib-Basic-Types.html#gpointer"
331
>gpointer</a> instance,
332
<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a> mask,
333
<a
334
href="./../glib/glib/glib-Basic-Types.html#guint"
335
>guint</a> signal_id,
336
<a
337
href="./../glib/glib/glib-Quarks.html#GQuark"
338
>GQuark</a> detail,
339
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *closure,
340
<a
341
href="./../glib/glib/glib-Basic-Types.html#gpointer"
342
>gpointer</a> func,
343
<a
344
href="./../glib/glib/glib-Basic-Types.html#gpointer"
345
>gpointer</a> data);
346
<a
347
href="./../glib/glib/glib-Basic-Types.html#guint"
348
>guint</a> <a class="link" href="gobject-Signals.html#g-signal-handlers-disconnect-matched" title="g_signal_handlers_disconnect_matched ()">g_signal_handlers_disconnect_matched</a>
349
(<a
350
href="./../glib/glib/glib-Basic-Types.html#gpointer"
351
>gpointer</a> instance,
352
<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a> mask,
353
<a
354
href="./../glib/glib/glib-Basic-Types.html#guint"
355
>guint</a> signal_id,
356
<a
357
href="./../glib/glib/glib-Quarks.html#GQuark"
358
>GQuark</a> detail,
359
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *closure,
360
<a
361
href="./../glib/glib/glib-Basic-Types.html#gpointer"
362
>gpointer</a> func,
363
<a
364
href="./../glib/glib/glib-Basic-Types.html#gpointer"
365
>gpointer</a> data);
366
<a
367
href="./../glib/glib/glib-Basic-Types.html#gboolean"
368
>gboolean</a> <a class="link" href="gobject-Signals.html#g-signal-handler-is-connected" title="g_signal_handler_is_connected ()">g_signal_handler_is_connected</a> (<a
369
href="./../glib/glib/glib-Basic-Types.html#gpointer"
370
>gpointer</a> instance,
371
<a
372
href="./../glib/glib/glib-Basic-Types.html#gulong"
373
>gulong</a> handler_id);
203
374
#define <a class="link" href="gobject-Signals.html#g-signal-handlers-block-by-func" title="g_signal_handlers_block_by_func()">g_signal_handlers_block_by_func</a> (instance, func, data)
204
375
#define <a class="link" href="gobject-Signals.html#g-signal-handlers-unblock-by-func" title="g_signal_handlers_unblock_by_func()">g_signal_handlers_unblock_by_func</a> (instance, func, data)
205
376
#define <a class="link" href="gobject-Signals.html#g-signal-handlers-disconnect-by-func" title="g_signal_handlers_disconnect_by_func()">g_signal_handlers_disconnect_by_func</a>(instance, func, data)
206
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gobject-Signals.html#g-signal-has-handler-pending" title="g_signal_has_handler_pending ()">g_signal_has_handler_pending</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
207
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
208
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
209
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> may_be_blocked);
210
<span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-stop-emission" title="g_signal_stop_emission ()">g_signal_stop_emission</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
211
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
212
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail);
213
<span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-stop-emission-by-name" title="g_signal_stop_emission_by_name ()">g_signal_stop_emission_by_name</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
214
const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *detailed_signal);
215
<span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-override-class-closure" title="g_signal_override_class_closure ()">g_signal_override_class_closure</a> (<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
216
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> instance_type,
217
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *class_closure);
218
<span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-chain-from-overridden" title="g_signal_chain_from_overridden ()">g_signal_chain_from_overridden</a> (const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *instance_and_params,
219
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *return_value);
220
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="gobject-Signals.html#g-signal-new-class-handler" title="g_signal_new_class_handler ()">g_signal_new_class_handler</a> (const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *signal_name,
221
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> itype,
222
<a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="returnvalue">GSignalFlags</span></a> signal_flags,
223
<a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="returnvalue">GCallback</span></a> class_handler,
224
<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="returnvalue">GSignalAccumulator</span></a> accumulator,
225
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> accu_data,
226
<a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller"><span class="returnvalue">GSignalCMarshaller</span></a> c_marshaller,
227
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> return_type,
228
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_params,
229
...);
230
<span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-override-class-handler" title="g_signal_override_class_handler ()">g_signal_override_class_handler</a> (const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *signal_name,
231
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> instance_type,
232
<a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="returnvalue">GCallback</span></a> class_handler);
233
<span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-chain-from-overridden-handler" title="g_signal_chain_from_overridden_handler ()">g_signal_chain_from_overridden_handler</a>
234
(<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
235
...);
236
<a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> <a class="link" href="gobject-Signals.html#g-signal-add-emission-hook" title="g_signal_add_emission_hook ()">g_signal_add_emission_hook</a> (<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
237
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
238
<a class="link" href="gobject-Signals.html#GSignalEmissionHook" title="GSignalEmissionHook ()"><span class="returnvalue">GSignalEmissionHook</span></a> hook_func,
239
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> hook_data,
240
<a href="./../glib/glib/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> data_destroy);
241
<span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-remove-emission-hook" title="g_signal_remove_emission_hook ()">g_signal_remove_emission_hook</a> (<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
242
<a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> hook_id);
243
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gobject-Signals.html#g-signal-parse-name" title="g_signal_parse_name ()">g_signal_parse_name</a> (const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *detailed_signal,
244
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> itype,
245
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> *signal_id_p,
246
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> *detail_p,
247
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> force_detail_quark);
248
<a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="returnvalue">GSignalInvocationHint</span></a>* <a class="link" href="gobject-Signals.html#g-signal-get-invocation-hint" title="g_signal_get_invocation_hint ()">g_signal_get_invocation_hint</a> (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance);
249
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a>* <a class="link" href="gobject-Signals.html#g-signal-type-cclosure-new" title="g_signal_type_cclosure_new ()">g_signal_type_cclosure_new</a> (<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> itype,
250
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> struct_offset);
251
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gobject-Signals.html#g-signal-accumulator-true-handled" title="g_signal_accumulator_true_handled ()">g_signal_accumulator_true_handled</a> (<a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="returnvalue">GSignalInvocationHint</span></a> *ihint,
252
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *return_accu,
253
const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *handler_return,
254
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> dummy);
377
<a
378
href="./../glib/glib/glib-Basic-Types.html#gboolean"
379
>gboolean</a> <a class="link" href="gobject-Signals.html#g-signal-has-handler-pending" title="g_signal_has_handler_pending ()">g_signal_has_handler_pending</a> (<a
380
href="./../glib/glib/glib-Basic-Types.html#gpointer"
381
>gpointer</a> instance,
382
<a
383
href="./../glib/glib/glib-Basic-Types.html#guint"
384
>guint</a> signal_id,
385
<a
386
href="./../glib/glib/glib-Quarks.html#GQuark"
387
>GQuark</a> detail,
388
<a
389
href="./../glib/glib/glib-Basic-Types.html#gboolean"
390
>gboolean</a> may_be_blocked);
391
void <a class="link" href="gobject-Signals.html#g-signal-stop-emission" title="g_signal_stop_emission ()">g_signal_stop_emission</a> (<a
392
href="./../glib/glib/glib-Basic-Types.html#gpointer"
393
>gpointer</a> instance,
394
<a
395
href="./../glib/glib/glib-Basic-Types.html#guint"
396
>guint</a> signal_id,
397
<a
398
href="./../glib/glib/glib-Quarks.html#GQuark"
399
>GQuark</a> detail);
400
void <a class="link" href="gobject-Signals.html#g-signal-stop-emission-by-name" title="g_signal_stop_emission_by_name ()">g_signal_stop_emission_by_name</a> (<a
401
href="./../glib/glib/glib-Basic-Types.html#gpointer"
402
>gpointer</a> instance,
403
const <a
404
href="./../glib/glib/glib-Basic-Types.html#gchar"
405
>gchar</a> *detailed_signal);
406
void <a class="link" href="gobject-Signals.html#g-signal-override-class-closure" title="g_signal_override_class_closure ()">g_signal_override_class_closure</a> (<a
407
href="./../glib/glib/glib-Basic-Types.html#guint"
408
>guint</a> signal_id,
409
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> instance_type,
410
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *class_closure);
411
void <a class="link" href="gobject-Signals.html#g-signal-chain-from-overridden" title="g_signal_chain_from_overridden ()">g_signal_chain_from_overridden</a> (const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *instance_and_params,
412
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *return_value);
413
<a
414
href="./../glib/glib/glib-Basic-Types.html#guint"
415
>guint</a> <a class="link" href="gobject-Signals.html#g-signal-new-class-handler" title="g_signal_new_class_handler ()">g_signal_new_class_handler</a> (const <a
416
href="./../glib/glib/glib-Basic-Types.html#gchar"
417
>gchar</a> *signal_name,
418
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype,
419
<a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags">GSignalFlags</a> signal_flags,
420
<a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()">GCallback</a> class_handler,
421
<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()">GSignalAccumulator</a> accumulator,
422
<a
423
href="./../glib/glib/glib-Basic-Types.html#gpointer"
424
>gpointer</a> accu_data,
425
<a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller">GSignalCMarshaller</a> c_marshaller,
426
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> return_type,
427
<a
428
href="./../glib/glib/glib-Basic-Types.html#guint"
429
>guint</a> n_params,
430
...);
431
void <a class="link" href="gobject-Signals.html#g-signal-override-class-handler" title="g_signal_override_class_handler ()">g_signal_override_class_handler</a> (const <a
432
href="./../glib/glib/glib-Basic-Types.html#gchar"
433
>gchar</a> *signal_name,
434
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> instance_type,
435
<a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()">GCallback</a> class_handler);
436
void <a class="link" href="gobject-Signals.html#g-signal-chain-from-overridden-handler" title="g_signal_chain_from_overridden_handler ()">g_signal_chain_from_overridden_handler</a>
437
(<a
438
href="./../glib/glib/glib-Basic-Types.html#gpointer"
439
>gpointer</a> instance,
440
...);
441
<a
442
href="./../glib/glib/glib-Basic-Types.html#gulong"
443
>gulong</a> <a class="link" href="gobject-Signals.html#g-signal-add-emission-hook" title="g_signal_add_emission_hook ()">g_signal_add_emission_hook</a> (<a
444
href="./../glib/glib/glib-Basic-Types.html#guint"
445
>guint</a> signal_id,
446
<a
447
href="./../glib/glib/glib-Quarks.html#GQuark"
448
>GQuark</a> detail,
449
<a class="link" href="gobject-Signals.html#GSignalEmissionHook" title="GSignalEmissionHook ()">GSignalEmissionHook</a> hook_func,
450
<a
451
href="./../glib/glib/glib-Basic-Types.html#gpointer"
452
>gpointer</a> hook_data,
453
<a
454
href="./../glib/glib/glib-Datasets.html#GDestroyNotify"
455
>GDestroyNotify</a> data_destroy);
456
void <a class="link" href="gobject-Signals.html#g-signal-remove-emission-hook" title="g_signal_remove_emission_hook ()">g_signal_remove_emission_hook</a> (<a
457
href="./../glib/glib/glib-Basic-Types.html#guint"
458
>guint</a> signal_id,
459
<a
460
href="./../glib/glib/glib-Basic-Types.html#gulong"
461
>gulong</a> hook_id);
462
<a
463
href="./../glib/glib/glib-Basic-Types.html#gboolean"
464
>gboolean</a> <a class="link" href="gobject-Signals.html#g-signal-parse-name" title="g_signal_parse_name ()">g_signal_parse_name</a> (const <a
465
href="./../glib/glib/glib-Basic-Types.html#gchar"
466
>gchar</a> *detailed_signal,
467
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype,
468
<a
469
href="./../glib/glib/glib-Basic-Types.html#guint"
470
>guint</a> *signal_id_p,
471
<a
472
href="./../glib/glib/glib-Quarks.html#GQuark"
473
>GQuark</a> *detail_p,
474
<a
475
href="./../glib/glib/glib-Basic-Types.html#gboolean"
476
>gboolean</a> force_detail_quark);
477
<a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint">GSignalInvocationHint</a>* <a class="link" href="gobject-Signals.html#g-signal-get-invocation-hint" title="g_signal_get_invocation_hint ()">g_signal_get_invocation_hint</a> (<a
478
href="./../glib/glib/glib-Basic-Types.html#gpointer"
479
>gpointer</a> instance);
480
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a>* <a class="link" href="gobject-Signals.html#g-signal-type-cclosure-new" title="g_signal_type_cclosure_new ()">g_signal_type_cclosure_new</a> (<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype,
481
<a
482
href="./../glib/glib/glib-Basic-Types.html#guint"
483
>guint</a> struct_offset);
484
<a
485
href="./../glib/glib/glib-Basic-Types.html#gboolean"
486
>gboolean</a> <a class="link" href="gobject-Signals.html#g-signal-accumulator-true-handled" title="g_signal_accumulator_true_handled ()">g_signal_accumulator_true_handled</a> (<a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint">GSignalInvocationHint</a> *ihint,
487
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *return_accu,
488
const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *handler_return,
489
<a
490
href="./../glib/glib/glib-Basic-Types.html#gpointer"
491
>gpointer</a> dummy);
255
492
</pre>
256
493
</div>
257
494
<div class="refsect1" title="Description">
265
502
emission mainly involves invocation of a certain set of callbacks
266
503
in precisely defined manner. There are two main categories of such
267
504
callbacks, per-object
268
<sup>[<a name="id600720" href="#ftn.id600720" class="footnote">10</a>]</sup>
505
<sup>[<a name="id607665" href="#ftn.id607665" class="footnote">10</a>]</sup>
269
506
ones and user provided ones.
270
507
The per-object callbacks are most often referred to as "object method
271
508
handler" or "default (signal) handler", while user provided callbacks are
284
521
<tr>
285
522
<td><p><span class="term"></span></p></td>
286
523
<td><p>
287
1 - Invocation of the object method handler for <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">G_SIGNAL_RUN_FIRST</code></a> signals
288
</p></td>
289
</tr>
290
<tr>
291
<td><p><span class="term"></span></p></td>
292
<td><p>
293
2 - Invocation of normal user-provided signal handlers (<span class="emphasis"><em>after</em></span> flag <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>)
294
</p></td>
295
</tr>
296
<tr>
297
<td><p><span class="term"></span></p></td>
298
<td><p>
299
3 - Invocation of the object method handler for <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">G_SIGNAL_RUN_LAST</code></a> signals
300
</p></td>
301
</tr>
302
<tr>
303
<td><p><span class="term"></span></p></td>
304
<td><p>
305
4 - Invocation of user provided signal handlers, connected with an <span class="emphasis"><em>after</em></span> flag of <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
306
</p></td>
307
</tr>
308
<tr>
309
<td><p><span class="term"></span></p></td>
310
<td><p>
311
5 - Invocation of the object method handler for <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-CLEANUP:CAPS"><code class="literal">G_SIGNAL_RUN_CLEANUP</code></a> signals
524
1 - Invocation of the object method handler for <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-FIRST--CAPS"><code class="literal">G_SIGNAL_RUN_FIRST</code></a> signals
525
</p></td>
526
</tr>
527
<tr>
528
<td><p><span class="term"></span></p></td>
529
<td><p>
530
2 - Invocation of normal user-provided signal handlers (<span class="emphasis"><em>after</em></span> flag <a
531
href="./../glib/glib/glib-Standard-Macros.html#FALSE--CAPS"
532
><code class="literal">FALSE</code></a>)
533
</p></td>
534
</tr>
535
<tr>
536
<td><p><span class="term"></span></p></td>
537
<td><p>
538
3 - Invocation of the object method handler for <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-LAST--CAPS"><code class="literal">G_SIGNAL_RUN_LAST</code></a> signals
539
</p></td>
540
</tr>
541
<tr>
542
<td><p><span class="term"></span></p></td>
543
<td><p>
544
4 - Invocation of user provided signal handlers, connected with an <span class="emphasis"><em>after</em></span> flag of <a
545
href="./../glib/glib/glib-Standard-Macros.html#TRUE--CAPS"
546
><code class="literal">TRUE</code></a>
547
</p></td>
548
</tr>
549
<tr>
550
<td><p><span class="term"></span></p></td>
551
<td><p>
552
5 - Invocation of the object method handler for <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-CLEANUP--CAPS"><code class="literal">G_SIGNAL_RUN_CLEANUP</code></a> signals
312
553
</p></td>
313
554
</tr>
314
555
</tbody>
325
566
during callback invocation, to return from the "blocked" state, a
326
567
handler has to get unblocked exactly the same amount of times
327
568
it has been blocked before.
328
Second, upon emission of a <a class="link" href="gobject-Signals.html#G-SIGNAL-DETAILED:CAPS"><code class="literal">G_SIGNAL_DETAILED</code></a> signal, an additional
569
Second, upon emission of a <a class="link" href="gobject-Signals.html#G-SIGNAL-DETAILED--CAPS"><code class="literal">G_SIGNAL_DETAILED</code></a> signal, an additional
329
570
"detail" argument passed in to <a class="link" href="gobject-Signals.html#g-signal-emit" title="g_signal_emit ()"><code class="function">g_signal_emit()</code></a> has to match the detail
330
571
argument of the signal handler currently subject to invocation.
331
572
Specification of no detail argument for signal handlers (omission of the
332
573
detail part of the signal specification upon connection) serves as a
333
574
wildcard and matches any detail argument passed in to emission.</p>
575
<p>
576
</p>
334
577
</div>
335
578
<div class="refsect1" title="Details">
336
579
<a name="gobject-Signals.details"></a><h2>Details</h2>
338
581
<a name="GSignalInvocationHint"></a><h3>GSignalInvocationHint</h3>
339
582
<pre class="programlisting">typedef struct {
340
583
guint signal_id;
341
GQuark detail;
342
GSignalFlags run_type;
584
GQuark detail;
585
GSignalFlags run_type;
343
586
} GSignalInvocationHint;
344
587
</pre>
345
588
<p>
346
589
The <a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="type">GSignalInvocationHint</span></a> structure is used to pass on additional information
347
590
to callbacks during a signal emission.</p>
591
<p>
592
</p>
348
593
<div class="variablelist"><table border="0">
349
594
<col align="left" valign="top">
350
595
<tbody>
351
596
<tr>
352
<td><p><span class="term"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GSignalInvocationHint.signal-id"></a>signal_id</code></em>;</span></p></td>
597
<td><p><span class="term"><a
598
href="./../glib/glib/glib-Basic-Types.html#guint"
599
>guint</a> <em class="structfield"><code>signal_id</code></em>;</span></p></td>
353
600
<td> The signal id of the signal invoking the callback
354
601
</td>
355
602
</tr>
356
603
<tr>
357
<td><p><span class="term"><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> <em class="structfield"><code><a name="GSignalInvocationHint.detail"></a>detail</code></em>;</span></p></td>
604
<td><p><span class="term"><a
605
href="./../glib/glib/glib-Quarks.html#GQuark"
606
>GQuark</a> <em class="structfield"><code>detail</code></em>;</span></p></td>
358
607
<td> The detail passed on for this emission
359
608
</td>
360
609
</tr>
361
610
<tr>
362
<td><p><span class="term"><a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="type">GSignalFlags</span></a> <em class="structfield"><code><a name="GSignalInvocationHint.run-type"></a>run_type</code></em>;</span></p></td>
611
<td><p><span class="term"><a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags">GSignalFlags</a> <em class="structfield"><code>run_type</code></em>;</span></p></td>
363
612
<td> The stage the signal emission is currently in, this
364
field will contain one of <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">G_SIGNAL_RUN_FIRST</code></a>,
365
<a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">G_SIGNAL_RUN_LAST</code></a> or <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-CLEANUP:CAPS"><code class="literal">G_SIGNAL_RUN_CLEANUP</code></a>.
613
field will contain one of <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-FIRST--CAPS"><code class="literal">G_SIGNAL_RUN_FIRST</code></a>,
614
<a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-LAST--CAPS"><code class="literal">G_SIGNAL_RUN_LAST</code></a> or <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-CLEANUP--CAPS"><code class="literal">G_SIGNAL_RUN_CLEANUP</code></a>.
366
615
</td>
367
616
</tr>
368
617
</tbody>
371
620
<hr>
372
621
<div class="refsect2" title="GSignalAccumulator ()">
373
622
<a name="GSignalAccumulator"></a><h3>GSignalAccumulator ()</h3>
374
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (*GSignalAccumulator) (<a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="returnvalue">GSignalInvocationHint</span></a> *ihint,
375
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *return_accu,
376
const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *handler_return,
377
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> data);</pre>
623
<pre class="programlisting"><a
624
href="./../glib/glib/glib-Basic-Types.html#gboolean"
625
>gboolean</a> (*GSignalAccumulator) (<a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint">GSignalInvocationHint</a> *ihint,
626
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *return_accu,
627
const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *handler_return,
628
<a
629
href="./../glib/glib/glib-Basic-Types.html#gpointer"
630
>gpointer</a> data);</pre>
378
631
<p>
379
632
The signal accumulator is a special callback function that can be used
380
633
to collect return values of the various callbacks that are called
381
634
during a signal emission. The signal accumulator is specified at signal
382
creation time, if it is left <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, no accumulation of callback return
635
creation time, if it is left <a
636
href="./../glib/glib/glib-Standard-Macros.html#NULL--CAPS"
637
><code class="literal">NULL</code></a>, no accumulation of callback return
383
638
values is performed. The return value of signal emissions is then the
384
639
value returned by the last callback.</p>
640
<p>
641
</p>
385
642
<div class="variablelist"><table border="0">
386
643
<col align="left" valign="top">
387
644
<tbody>
409
666
<tr>
410
667
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
411
668
<td> The accumulator function returns whether the signal emission
412
should be aborted. Returning <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> means to abort the
413
current emission and <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned for continuation.
669
should be aborted. Returning <a
670
href="./../glib/glib/glib-Standard-Macros.html#FALSE--CAPS"
671
><code class="literal">FALSE</code></a> means to abort the
672
current emission and <a
673
href="./../glib/glib/glib-Standard-Macros.html#TRUE--CAPS"
674
><code class="literal">TRUE</code></a> is returned for continuation.
414
675
</td>
415
676
</tr>
416
677
</tbody>
427
688
invocations. It is merely an alias to <a class="link" href="gobject-Closures.html#GClosureMarshal" title="GClosureMarshal ()"><span class="type">GClosureMarshal</span></a> since the <a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a>
428
689
mechanism takes over responsibility of actual function invocation for the
429
690
signal system.</p>
691
<p>
692
</p>
430
693
</div>
431
694
<hr>
432
695
<div class="refsect2" title="GSignalEmissionHook ()">
433
696
<a name="GSignalEmissionHook"></a><h3>GSignalEmissionHook ()</h3>
434
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (*GSignalEmissionHook) (<a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="returnvalue">GSignalInvocationHint</span></a> *ihint,
435
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_param_values,
436
const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *param_values,
437
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> data);</pre>
697
<pre class="programlisting"><a
698
href="./../glib/glib/glib-Basic-Types.html#gboolean"
699
>gboolean</a> (*GSignalEmissionHook) (<a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint">GSignalInvocationHint</a> *ihint,
700
<a
701
href="./../glib/glib/glib-Basic-Types.html#guint"
702
>guint</a> n_param_values,
703
const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *param_values,
704
<a
705
href="./../glib/glib/glib-Basic-Types.html#gpointer"
706
>gpointer</a> data);</pre>
438
707
<p>
439
708
A simple function pointer to get invoked when the signal is emitted. This
440
709
allows you to tie a hook to the signal type, so that it will trap all
441
710
emissions of that signal, from any object.
442
711
</p>
443
712
<p>
444
You may not attach these to signals created with the <a class="link" href="gobject-Signals.html#G-SIGNAL-NO-HOOKS:CAPS"><span class="type">G_SIGNAL_NO_HOOKS</span></a> flag.</p>
713
You may not attach these to signals created with the <a class="link" href="gobject-Signals.html#G-SIGNAL-NO-HOOKS--CAPS"><span class="type">G_SIGNAL_NO_HOOKS</span></a> flag.</p>
714
<p>
715
</p>
445
716
<div class="variablelist"><table border="0">
446
717
<col align="left" valign="top">
447
718
<tbody>
469
740
</tr>
470
741
<tr>
471
742
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
472
<td> whether it wants to stay connected. If it returns <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, the signal
743
<td> whether it wants to stay connected. If it returns <a
744
href="./../glib/glib/glib-Standard-Macros.html#FALSE--CAPS"
745
><code class="literal">FALSE</code></a>, the signal
473
746
hook is disconnected (and destroyed).
474
747
</td>
475
748
</tr>
481
754
<a name="GSignalFlags"></a><h3>enum GSignalFlags</h3>
482
755
<pre class="programlisting">typedef enum
483
756
{
484
G_SIGNAL_RUN_FIRST = 1 << 0,
485
G_SIGNAL_RUN_LAST = 1 << 1,
486
G_SIGNAL_RUN_CLEANUP = 1 << 2,
487
G_SIGNAL_NO_RECURSE = 1 << 3,
488
G_SIGNAL_DETAILED = 1 << 4,
489
G_SIGNAL_ACTION = 1 << 5,
490
G_SIGNAL_NO_HOOKS = 1 << 6
757
G_SIGNAL_RUN_FIRST = 1 << 0,
758
G_SIGNAL_RUN_LAST = 1 << 1,
759
G_SIGNAL_RUN_CLEANUP = 1 << 2,
760
G_SIGNAL_NO_RECURSE = 1 << 3,
761
G_SIGNAL_DETAILED = 1 << 4,
762
G_SIGNAL_ACTION = 1 << 5,
763
G_SIGNAL_NO_HOOKS = 1 << 6
491
764
} GSignalFlags;
492
765
</pre>
493
766
<p>
494
767
The signal flags are used to specify a signal's behaviour, the overall
495
768
signal description outlines how especially the RUN flags control the
496
769
stages of a signal emission.</p>
770
<p>
771
</p>
497
772
<div class="variablelist"><table border="0">
498
773
<col align="left" valign="top">
499
774
<tbody>
500
775
<tr>
501
<td><p><a name="G-SIGNAL-RUN-FIRST:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_RUN_FIRST</code></span></p></td>
776
<td><p><a name="G-SIGNAL-RUN-FIRST--CAPS"></a><span class="term"><code class="literal">G_SIGNAL_RUN_FIRST</code></span></p></td>
502
777
<td> Invoke the object method handler in the first emission stage.
503
778
</td>
504
779
</tr>
505
780
<tr>
506
<td><p><a name="G-SIGNAL-RUN-LAST:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_RUN_LAST</code></span></p></td>
781
<td><p><a name="G-SIGNAL-RUN-LAST--CAPS"></a><span class="term"><code class="literal">G_SIGNAL_RUN_LAST</code></span></p></td>
507
782
<td> Invoke the object method handler in the third emission stage.
508
783
</td>
509
784
</tr>
510
785
<tr>
511
<td><p><a name="G-SIGNAL-RUN-CLEANUP:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_RUN_CLEANUP</code></span></p></td>
786
<td><p><a name="G-SIGNAL-RUN-CLEANUP--CAPS"></a><span class="term"><code class="literal">G_SIGNAL_RUN_CLEANUP</code></span></p></td>
512
787
<td> Invoke the object method handler in the last emission stage.
513
788
</td>
514
789
</tr>
515
790
<tr>
516
<td><p><a name="G-SIGNAL-NO-RECURSE:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_NO_RECURSE</code></span></p></td>
791
<td><p><a name="G-SIGNAL-NO-RECURSE--CAPS"></a><span class="term"><code class="literal">G_SIGNAL_NO_RECURSE</code></span></p></td>
517
792
<td> Signals being emitted for an object while currently being in
518
793
emission for this very object will not be emitted recursively,
519
794
but instead cause the first emission to be restarted.
520
795
</td>
521
796
</tr>
522
797
<tr>
523
<td><p><a name="G-SIGNAL-DETAILED:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_DETAILED</code></span></p></td>
798
<td><p><a name="G-SIGNAL-DETAILED--CAPS"></a><span class="term"><code class="literal">G_SIGNAL_DETAILED</code></span></p></td>
524
799
<td> This signal supports "::detail" appendices to the signal name
525
800
upon handler connections and emissions.
526
801
</td>
527
802
</tr>
528
803
<tr>
529
<td><p><a name="G-SIGNAL-ACTION:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_ACTION</code></span></p></td>
804
<td><p><a name="G-SIGNAL-ACTION--CAPS"></a><span class="term"><code class="literal">G_SIGNAL_ACTION</code></span></p></td>
530
805
<td> Action signals are signals that may freely be emitted on alive
531
806
objects from user code via <a class="link" href="gobject-Signals.html#g-signal-emit" title="g_signal_emit ()"><code class="function">g_signal_emit()</code></a> and friends, without
532
807
the need of being embedded into extra code that performs pre or
536
811
</td>
537
812
</tr>
538
813
<tr>
539
<td><p><a name="G-SIGNAL-NO-HOOKS:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_NO_HOOKS</code></span></p></td>
814
<td><p><a name="G-SIGNAL-NO-HOOKS--CAPS"></a><span class="term"><code class="literal">G_SIGNAL_NO_HOOKS</code></span></p></td>
540
815
<td> No emissions hooks are supported for this signal.
541
816
</td>
542
817
</tr>
560
835
The match types specify what <a class="link" href="gobject-Signals.html#g-signal-handlers-block-matched" title="g_signal_handlers_block_matched ()"><code class="function">g_signal_handlers_block_matched()</code></a>,
561
836
<a class="link" href="gobject-Signals.html#g-signal-handlers-unblock-matched" title="g_signal_handlers_unblock_matched ()"><code class="function">g_signal_handlers_unblock_matched()</code></a> and <a class="link" href="gobject-Signals.html#g-signal-handlers-disconnect-matched" title="g_signal_handlers_disconnect_matched ()"><code class="function">g_signal_handlers_disconnect_matched()</code></a>
562
837
match signals by.</p>
838
<p>
839
</p>
563
840
<div class="variablelist"><table border="0">
564
841
<col align="left" valign="top">
565
842
<tbody>
566
843
<tr>
567
<td><p><a name="G-SIGNAL-MATCH-ID:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_ID</code></span></p></td>
844
<td><p><a name="G-SIGNAL-MATCH-ID--CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_ID</code></span></p></td>
568
845
<td> The signal id must be equal.
569
846
</td>
570
847
</tr>
571
848
<tr>
572
<td><p><a name="G-SIGNAL-MATCH-DETAIL:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_DETAIL</code></span></p></td>
849
<td><p><a name="G-SIGNAL-MATCH-DETAIL--CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_DETAIL</code></span></p></td>
573
850
<td> The signal detail be equal.
574
851
</td>
575
852
</tr>
576
853
<tr>
577
<td><p><a name="G-SIGNAL-MATCH-CLOSURE:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_CLOSURE</code></span></p></td>
854
<td><p><a name="G-SIGNAL-MATCH-CLOSURE--CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_CLOSURE</code></span></p></td>
578
855
<td> The closure must be the same.
579
856
</td>
580
857
</tr>
581
858
<tr>
582
<td><p><a name="G-SIGNAL-MATCH-FUNC:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_FUNC</code></span></p></td>
859
<td><p><a name="G-SIGNAL-MATCH-FUNC--CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_FUNC</code></span></p></td>
583
860
<td> The C closure callback must be the same.
584
861
</td>
585
862
</tr>
586
863
<tr>
587
<td><p><a name="G-SIGNAL-MATCH-DATA:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_DATA</code></span></p></td>
864
<td><p><a name="G-SIGNAL-MATCH-DATA--CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_DATA</code></span></p></td>
588
865
<td> The closure data must be the same.
589
866
</td>
590
867
</tr>
591
868
<tr>
592
<td><p><a name="G-SIGNAL-MATCH-UNBLOCKED:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_UNBLOCKED</code></span></p></td>
869
<td><p><a name="G-SIGNAL-MATCH-UNBLOCKED--CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_UNBLOCKED</code></span></p></td>
593
870
<td> Only unblocked signals may matched.
594
871
</td>
595
872
</tr>
603
880
guint signal_id;
604
881
const gchar *signal_name;
605
882
GType itype;
606
GSignalFlags signal_flags;
883
GSignalFlags signal_flags;
607
884
GType return_type; /* mangled with G_SIGNAL_TYPE_STATIC_SCOPE flag */
608
885
guint n_params;
609
886
const GType *param_types; /* mangled with G_SIGNAL_TYPE_STATIC_SCOPE flag */
612
889
<p>
613
890
A structure holding in-depth information for a specific signal. It is
614
891
filled in by the <a class="link" href="gobject-Signals.html#g-signal-query" title="g_signal_query ()"><code class="function">g_signal_query()</code></a> function.</p>
892
<p>
893
</p>
615
894
<div class="variablelist"><table border="0">
616
895
<col align="left" valign="top">
617
896
<tbody>
618
897
<tr>
619
<td><p><span class="term"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GSignalQuery.signal-id"></a>signal_id</code></em>;</span></p></td>
898
<td><p><span class="term"><a
899
href="./../glib/glib/glib-Basic-Types.html#guint"
900
>guint</a> <em class="structfield"><code>signal_id</code></em>;</span></p></td>
620
901
<td> The signal id of the signal being queried, or 0 if the
621
902
signal to be queried was unknown.
622
903
</td>
623
904
</tr>
624
905
<tr>
625
<td><p><span class="term">const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GSignalQuery.signal-name"></a>signal_name</code></em>;</span></p></td>
906
<td><p><span class="term">const <a
907
href="./../glib/glib/glib-Basic-Types.html#gchar"
908
>gchar</a> *<em class="structfield"><code>signal_name</code></em>;</span></p></td>
626
909
<td> The signal name.
627
910
</td>
628
911
</tr>
629
912
<tr>
630
<td><p><span class="term"><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> <em class="structfield"><code><a name="GSignalQuery.itype"></a>itype</code></em>;</span></p></td>
913
<td><p><span class="term"><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> <em class="structfield"><code>itype</code></em>;</span></p></td>
631
914
<td> The interface/instance type that this signal can be emitted for.
632
915
</td>
633
916
</tr>
634
917
<tr>
635
<td><p><span class="term"><a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="type">GSignalFlags</span></a> <em class="structfield"><code><a name="GSignalQuery.signal-flags"></a>signal_flags</code></em>;</span></p></td>
918
<td><p><span class="term"><a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags">GSignalFlags</a> <em class="structfield"><code>signal_flags</code></em>;</span></p></td>
636
919
<td> The signal flags as passed in to <a class="link" href="gobject-Signals.html#g-signal-new" title="g_signal_new ()"><code class="function">g_signal_new()</code></a>.
637
920
</td>
638
921
</tr>
639
922
<tr>
640
<td><p><span class="term"><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> <em class="structfield"><code><a name="GSignalQuery.return-type"></a>return_type</code></em>;</span></p></td>
923
<td><p><span class="term"><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> <em class="structfield"><code>return_type</code></em>;</span></p></td>
641
924
<td> The return type for user callbacks.
642
925
</td>
643
926
</tr>
644
927
<tr>
645
<td><p><span class="term"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GSignalQuery.n-params"></a>n_params</code></em>;</span></p></td>
928
<td><p><span class="term"><a
929
href="./../glib/glib/glib-Basic-Types.html#guint"
930
>guint</a> <em class="structfield"><code>n_params</code></em>;</span></p></td>
646
931
<td> The number of parameters that user callbacks take.
647
932
</td>
648
933
</tr>
649
934
<tr>
650
<td><p><span class="term">const <a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> *<em class="structfield"><code><a name="GSignalQuery.param-types"></a>param_types</code></em>;</span></p></td>
935
<td><p><span class="term">const <a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> *<em class="structfield"><code>param_types</code></em>;</span></p></td>
651
936
<td> The individual parameter types for user callbacks, note that the
652
937
effective callback signature is:
653
938
<pre class="programlisting">
654
@return_type callback (<a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> data1,
939
@return_type callback (<a
940
href="./../glib/glib/glib-Basic-Types.html#gpointer"
941
>gpointer</a> data1,
655
942
[param_types param_names,]
656
<a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> data2);
943
<a
944
href="./../glib/glib/glib-Basic-Types.html#gpointer"
945
>gpointer</a> data2);
657
946
</pre>
658
947
</td>
659
948
</tr>
662
951
</div>
663
952
<hr>
664
953
<div class="refsect2" title="G_SIGNAL_TYPE_STATIC_SCOPE">
665
<a name="G-SIGNAL-TYPE-STATIC-SCOPE:CAPS"></a><h3>G_SIGNAL_TYPE_STATIC_SCOPE</h3>
666
<pre class="programlisting">#define G_SIGNAL_TYPE_STATIC_SCOPE (G_TYPE_FLAG_RESERVED_ID_BIT)
954
<a name="G-SIGNAL-TYPE-STATIC-SCOPE--CAPS"></a><h3>G_SIGNAL_TYPE_STATIC_SCOPE</h3>
955
<pre class="programlisting">#define G_SIGNAL_TYPE_STATIC_SCOPE (G_TYPE_FLAG_RESERVED_ID_BIT)
667
956
</pre>
668
957
<p>
669
958
This macro flags signal argument types for which the signal system may
685
974
G_TYPE_NONE, 1,
686
975
GTK_TYPE_REQUISITION | G_SIGNAL_TYPE_STATIC_SCOPE);
687
976
</pre></div>
977
<p>
978
</p>
688
979
</div>
689
980
<hr>
690
981
<div class="refsect2" title="G_SIGNAL_MATCH_MASK">
691
<a name="G-SIGNAL-MATCH-MASK:CAPS"></a><h3>G_SIGNAL_MATCH_MASK</h3>
982
<a name="G-SIGNAL-MATCH-MASK--CAPS"></a><h3>G_SIGNAL_MATCH_MASK</h3>
692
983
<pre class="programlisting">#define G_SIGNAL_MATCH_MASK 0x3f
693
984
</pre>
694
985
<p>
695
986
A mask for all <a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="type">GSignalMatchType</span></a> bits.</p>
987
<p>
988
</p>
696
989
</div>
697
990
<hr>
698
991
<div class="refsect2" title="G_SIGNAL_FLAGS_MASK">
699
<a name="G-SIGNAL-FLAGS-MASK:CAPS"></a><h3>G_SIGNAL_FLAGS_MASK</h3>
992
<a name="G-SIGNAL-FLAGS-MASK--CAPS"></a><h3>G_SIGNAL_FLAGS_MASK</h3>
700
993
<pre class="programlisting">#define G_SIGNAL_FLAGS_MASK 0x7f
701
994
</pre>
702
995
<p>
703
996
A mask for all <a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="type">GSignalFlags</span></a> bits.</p>
997
<p>
998
</p>
704
999
</div>
705
1000
<hr>
706
1001
<div class="refsect2" title="g_signal_new ()">
707
1002
<a name="g-signal-new"></a><h3>g_signal_new ()</h3>
708
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_signal_new (const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *signal_name,
709
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> itype,
710
<a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="returnvalue">GSignalFlags</span></a> signal_flags,
711
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> class_offset,
712
<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="returnvalue">GSignalAccumulator</span></a> accumulator,
713
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> accu_data,
714
<a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller"><span class="returnvalue">GSignalCMarshaller</span></a> c_marshaller,
715
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> return_type,
716
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_params,
1003
<pre class="programlisting"><a
1004
href="./../glib/glib/glib-Basic-Types.html#guint"
1005
>guint</a> g_signal_new (const <a
1006
href="./../glib/glib/glib-Basic-Types.html#gchar"
1007
>gchar</a> *signal_name,
1008
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype,
1009
<a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags">GSignalFlags</a> signal_flags,
1010
<a
1011
href="./../glib/glib/glib-Basic-Types.html#guint"
1012
>guint</a> class_offset,
1013
<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()">GSignalAccumulator</a> accumulator,
1014
<a
1015
href="./../glib/glib/glib-Basic-Types.html#gpointer"
1016
>gpointer</a> accu_data,
1017
<a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller">GSignalCMarshaller</a> c_marshaller,
1018
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> return_type,
1019
<a
1020
href="./../glib/glib/glib-Basic-Types.html#guint"
1021
>guint</a> n_params,
717
1022
...);</pre>
718
1023
<p>
719
1024
Creates a new signal. (This is usually done in the class initializer.)
726
1031
</p>
727
1032
<p>
728
1033
When registering a signal and looking up a signal, either separator can
729
be used, but they cannot be mixed.</p>
1034
be used, but they cannot be mixed.
1035
</p>
1036
<p>
1037
If 0 is used for <em class="parameter"><code>class_offset</code></em> subclasses cannot override the class handler
1038
in their <code class="code">class_init</code> method by doing
1039
<code class="code">super_class->signal_handler = my_signal_handler</code>. Instead they
1040
will have to use <a class="link" href="gobject-Signals.html#g-signal-override-class-handler" title="g_signal_override_class_handler ()"><code class="function">g_signal_override_class_handler()</code></a>.</p>
1041
<p>
1042
</p>
730
1043
<div class="variablelist"><table border="0">
731
1044
<col align="left" valign="top">
732
1045
<tbody>
745
1058
<td><p><span class="term"><em class="parameter"><code>signal_flags</code></em> :</span></p></td>
746
1059
<td> a combination of <a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="type">GSignalFlags</span></a> specifying detail of when
747
1060
the default handler is to be invoked. You should at least specify
748
<a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">G_SIGNAL_RUN_FIRST</code></a> or <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">G_SIGNAL_RUN_LAST</code></a>.
1061
<a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-FIRST--CAPS"><code class="literal">G_SIGNAL_RUN_FIRST</code></a> or <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-LAST--CAPS"><code class="literal">G_SIGNAL_RUN_LAST</code></a>.
749
1062
</td>
750
1063
</tr>
751
1064
<tr>
752
1065
<td><p><span class="term"><em class="parameter"><code>class_offset</code></em> :</span></p></td>
753
1066
<td> The offset of the function pointer in the class structure
754
1067
for this type. Used to invoke a class method generically. Pass 0 to
755
not associate a class method with this signal.
1068
not associate a class method slot with this signal.
756
1069
</td>
757
1070
</tr>
758
1071
<tr>
759
1072
<td><p><span class="term"><em class="parameter"><code>accumulator</code></em> :</span></p></td>
760
<td> the accumulator for this signal; may be <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
1073
<td> the accumulator for this signal; may be <a
1074
href="./../glib/glib/glib-Standard-Macros.html#NULL--CAPS"
1075
><code class="literal">NULL</code></a>.
761
1076
</td>
762
1077
</tr>
763
1078
<tr>
773
1088
</tr>
774
1089
<tr>
775
1090
<td><p><span class="term"><em class="parameter"><code>return_type</code></em> :</span></p></td>
776
<td> the type of return value, or <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE:CAPS" title="G_TYPE_NONE"><span class="type">G_TYPE_NONE</span></a> for a signal
1091
<td> the type of return value, or <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE--CAPS" title="G_TYPE_NONE"><span class="type">G_TYPE_NONE</span></a> for a signal
777
1092
without a return value.
778
1093
</td>
779
1094
</tr>
798
1113
<hr>
799
1114
<div class="refsect2" title="g_signal_newv ()">
800
1115
<a name="g-signal-newv"></a><h3>g_signal_newv ()</h3>
801
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_signal_newv (const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *signal_name,
802
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> itype,
803
<a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="returnvalue">GSignalFlags</span></a> signal_flags,
804
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *class_closure,
805
<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="returnvalue">GSignalAccumulator</span></a> accumulator,
806
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> accu_data,
807
<a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller"><span class="returnvalue">GSignalCMarshaller</span></a> c_marshaller,
808
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> return_type,
809
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_params,
810
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> *param_types);</pre>
1116
<pre class="programlisting"><a
1117
href="./../glib/glib/glib-Basic-Types.html#guint"
1118
>guint</a> g_signal_newv (const <a
1119
href="./../glib/glib/glib-Basic-Types.html#gchar"
1120
>gchar</a> *signal_name,
1121
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype,
1122
<a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags">GSignalFlags</a> signal_flags,
1123
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *class_closure,
1124
<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()">GSignalAccumulator</a> accumulator,
1125
<a
1126
href="./../glib/glib/glib-Basic-Types.html#gpointer"
1127
>gpointer</a> accu_data,
1128
<a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller">GSignalCMarshaller</a> c_marshaller,
1129
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> return_type,
1130
<a
1131
href="./../glib/glib/glib-Basic-Types.html#guint"
1132
>guint</a> n_params,
1133
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> *param_types);</pre>
811
1134
<p>
812
1135
Creates a new signal. (This is usually done in the class initializer.)
813
1136
</p>
814
1137
<p>
815
1138
See <a class="link" href="gobject-Signals.html#g-signal-new" title="g_signal_new ()"><code class="function">g_signal_new()</code></a> for details on allowed signal names.</p>
1139
<p>
1140
</p>
816
1141
<div class="variablelist"><table border="0">
817
1142
<col align="left" valign="top">
818
1143
<tbody>
831
1156
<td><p><span class="term"><em class="parameter"><code>signal_flags</code></em> :</span></p></td>
832
1157
<td> a combination of <a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="type">GSignalFlags</span></a> specifying detail of when
833
1158
the default handler is to be invoked. You should at least specify
834
<a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">G_SIGNAL_RUN_FIRST</code></a> or <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">G_SIGNAL_RUN_LAST</code></a>
1159
<a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-FIRST--CAPS"><code class="literal">G_SIGNAL_RUN_FIRST</code></a> or <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-LAST--CAPS"><code class="literal">G_SIGNAL_RUN_LAST</code></a>
835
1160
</td>
836
1161
</tr>
837
1162
<tr>
838
1163
<td><p><span class="term"><em class="parameter"><code>class_closure</code></em> :</span></p></td>
839
<td> The closure to invoke on signal emission; may be <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1164
<td> The closure to invoke on signal emission; may be <a
1165
href="./../glib/glib/glib-Standard-Macros.html#NULL--CAPS"
1166
><code class="literal">NULL</code></a>
840
1167
</td>
841
1168
</tr>
842
1169
<tr>
843
1170
<td><p><span class="term"><em class="parameter"><code>accumulator</code></em> :</span></p></td>
844
<td> the accumulator for this signal; may be <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1171
<td> the accumulator for this signal; may be <a
1172
href="./../glib/glib/glib-Standard-Macros.html#NULL--CAPS"
1173
><code class="literal">NULL</code></a>
845
1174
</td>
846
1175
</tr>
847
1176
<tr>
857
1186
</tr>
858
1187
<tr>
859
1188
<td><p><span class="term"><em class="parameter"><code>return_type</code></em> :</span></p></td>
860
<td> the type of return value, or <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE:CAPS" title="G_TYPE_NONE"><span class="type">G_TYPE_NONE</span></a> for a signal
1189
<td> the type of return value, or <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE--CAPS" title="G_TYPE_NONE"><span class="type">G_TYPE_NONE</span></a> for a signal
861
1190
without a return value
862
1191
</td>
863
1192
</tr>
882
1211
<hr>
883
1212
<div class="refsect2" title="g_signal_new_valist ()">
884
1213
<a name="g-signal-new-valist"></a><h3>g_signal_new_valist ()</h3>
885
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_signal_new_valist (const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *signal_name,
886
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> itype,
887
<a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="returnvalue">GSignalFlags</span></a> signal_flags,
888
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *class_closure,
889
<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="returnvalue">GSignalAccumulator</span></a> accumulator,
890
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> accu_data,
891
<a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller"><span class="returnvalue">GSignalCMarshaller</span></a> c_marshaller,
892
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> return_type,
893
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_params,
894
<span class="returnvalue">va_list</span> args);</pre>
1214
<pre class="programlisting"><a
1215
href="./../glib/glib/glib-Basic-Types.html#guint"
1216
>guint</a> g_signal_new_valist (const <a
1217
href="./../glib/glib/glib-Basic-Types.html#gchar"
1218
>gchar</a> *signal_name,
1219
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype,
1220
<a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags">GSignalFlags</a> signal_flags,
1221
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *class_closure,
1222
<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()">GSignalAccumulator</a> accumulator,
1223
<a
1224
href="./../glib/glib/glib-Basic-Types.html#gpointer"
1225
>gpointer</a> accu_data,
1226
<a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller">GSignalCMarshaller</a> c_marshaller,
1227
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> return_type,
1228
<a
1229
href="./../glib/glib/glib-Basic-Types.html#guint"
1230
>guint</a> n_params,
1231
va_list args);</pre>
895
1232
<p>
896
1233
Creates a new signal. (This is usually done in the class initializer.)
897
1234
</p>
898
1235
<p>
899
1236
See <a class="link" href="gobject-Signals.html#g-signal-new" title="g_signal_new ()"><code class="function">g_signal_new()</code></a> for details on allowed signal names.</p>
1237
<p>
1238
</p>
900
1239
<div class="variablelist"><table border="0">
901
1240
<col align="left" valign="top">
902
1241
<tbody>
915
1254
<td><p><span class="term"><em class="parameter"><code>signal_flags</code></em> :</span></p></td>
916
1255
<td> a combination of <a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="type">GSignalFlags</span></a> specifying detail of when
917
1256
the default handler is to be invoked. You should at least specify
918
<a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">G_SIGNAL_RUN_FIRST</code></a> or <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">G_SIGNAL_RUN_LAST</code></a>.
1257
<a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-FIRST--CAPS"><code class="literal">G_SIGNAL_RUN_FIRST</code></a> or <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-LAST--CAPS"><code class="literal">G_SIGNAL_RUN_LAST</code></a>.
919
1258
</td>
920
1259
</tr>
921
1260
<tr>
922
1261
<td><p><span class="term"><em class="parameter"><code>class_closure</code></em> :</span></p></td>
923
<td> The closure to invoke on signal emission; may be <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
1262
<td> The closure to invoke on signal emission; may be <a
1263
href="./../glib/glib/glib-Standard-Macros.html#NULL--CAPS"
1264
><code class="literal">NULL</code></a>.
924
1265
</td>
925
1266
</tr>
926
1267
<tr>
927
1268
<td><p><span class="term"><em class="parameter"><code>accumulator</code></em> :</span></p></td>
928
<td> the accumulator for this signal; may be <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
1269
<td> the accumulator for this signal; may be <a
1270
href="./../glib/glib/glib-Standard-Macros.html#NULL--CAPS"
1271
><code class="literal">NULL</code></a>.
929
1272
</td>
930
1273
</tr>
931
1274
<tr>
941
1284
</tr>
942
1285
<tr>
943
1286
<td><p><span class="term"><em class="parameter"><code>return_type</code></em> :</span></p></td>
944
<td> the type of return value, or <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE:CAPS" title="G_TYPE_NONE"><span class="type">G_TYPE_NONE</span></a> for a signal
1287
<td> the type of return value, or <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE--CAPS" title="G_TYPE_NONE"><span class="type">G_TYPE_NONE</span></a> for a signal
945
1288
without a return value.
946
1289
</td>
947
1290
</tr>
966
1309
<hr>
967
1310
<div class="refsect2" title="g_signal_query ()">
968
1311
<a name="g-signal-query"></a><h3>g_signal_query ()</h3>
969
<pre class="programlisting"><span class="returnvalue">void</span> g_signal_query (<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
970
<a class="link" href="gobject-Signals.html#GSignalQuery" title="GSignalQuery"><span class="returnvalue">GSignalQuery</span></a> *query);</pre>
1312
<pre class="programlisting">void g_signal_query (<a
1313
href="./../glib/glib/glib-Basic-Types.html#guint"
1314
>guint</a> signal_id,
1315
<a class="link" href="gobject-Signals.html#GSignalQuery" title="GSignalQuery">GSignalQuery</a> *query);</pre>
971
1316
<p>
972
1317
Queries the signal system for in-depth information about a
973
1318
specific signal. This function will fill in a user-provided
975
1320
signal id is passed in, the <em class="parameter"><code>signal_id</code></em> member of the <a class="link" href="gobject-Signals.html#GSignalQuery" title="GSignalQuery"><span class="type">GSignalQuery</span></a>
976
1321
is 0. All members filled into the <a class="link" href="gobject-Signals.html#GSignalQuery" title="GSignalQuery"><span class="type">GSignalQuery</span></a> structure should
977
1322
be considered constant and have to be left untouched.</p>
1323
<p>
1324
</p>
978
1325
<div class="variablelist"><table border="0">
979
1326
<col align="left" valign="top">
980
1327
<tbody>
995
1342
<hr>
996
1343
<div class="refsect2" title="g_signal_lookup ()">
997
1344
<a name="g-signal-lookup"></a><h3>g_signal_lookup ()</h3>
998
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_signal_lookup (const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *name,
999
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> itype);</pre>
1345
<pre class="programlisting"><a
1346
href="./../glib/glib/glib-Basic-Types.html#guint"
1347
>guint</a> g_signal_lookup (const <a
1348
href="./../glib/glib/glib-Basic-Types.html#gchar"
1349
>gchar</a> *name,
1350
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype);</pre>
1000
1351
<p>
1001
1352
Given the name of the signal and the type of object it connects to, gets
1002
1353
the signal's identifying integer. Emitting the signal by number is
1007
1358
</p>
1008
1359
<p>
1009
1360
See <a class="link" href="gobject-Signals.html#g-signal-new" title="g_signal_new ()"><code class="function">g_signal_new()</code></a> for details on allowed signal names.</p>
1361
<p>
1362
</p>
1010
1363
<div class="variablelist"><table border="0">
1011
1364
<col align="left" valign="top">
1012
1365
<tbody>
1031
1384
<hr>
1032
1385
<div class="refsect2" title="g_signal_name ()">
1033
1386
<a name="g-signal-name"></a><h3>g_signal_name ()</h3>
1034
<pre class="programlisting">const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>* g_signal_name (<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id);</pre>
1387
<pre class="programlisting">const <a
1388
href="./../glib/glib/glib-Basic-Types.html#gchar"
1389
>gchar</a>* g_signal_name (<a
1390
href="./../glib/glib/glib-Basic-Types.html#guint"
1391
>guint</a> signal_id);</pre>
1035
1392
<p>
1036
1393
Given the signal's identifier, finds its name.
1037
1394
</p>
1038
1395
<p>
1039
1396
Two different signals may have the same name, if they have differing types.</p>
1397
<p>
1398
</p>
1040
1399
<div class="variablelist"><table border="0">
1041
1400
<col align="left" valign="top">
1042
1401
<tbody>
1047
1406
</tr>
1048
1407
<tr>
1049
1408
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1050
<td> the signal name, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the signal number was invalid.
1409
<td> the signal name, or <a
1410
href="./../glib/glib/glib-Standard-Macros.html#NULL--CAPS"
1411
><code class="literal">NULL</code></a> if the signal number was invalid.
1051
1412
</td>
1052
1413
</tr>
1053
1414
</tbody>
1056
1417
<hr>
1057
1418
<div class="refsect2" title="g_signal_list_ids ()">
1058
1419
<a name="g-signal-list-ids"></a><h3>g_signal_list_ids ()</h3>
1059
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>* g_signal_list_ids (<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> itype,
1060
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> *n_ids);</pre>
1420
<pre class="programlisting"><a
1421
href="./../glib/glib/glib-Basic-Types.html#guint"
1422
>guint</a>* g_signal_list_ids (<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype,
1423
<a
1424
href="./../glib/glib/glib-Basic-Types.html#guint"
1425
>guint</a> *n_ids);</pre>
1061
1426
<p>
1062
1427
Lists the signals by id that a certain instance or interface type
1063
1428
created. Further information about the signals can be acquired through
1064
1429
<a class="link" href="gobject-Signals.html#g-signal-query" title="g_signal_query ()"><code class="function">g_signal_query()</code></a>.</p>
1430
<p>
1431
</p>
1065
1432
<div class="variablelist"><table border="0">
1066
1433
<col align="left" valign="top">
1067
1434
<tbody>
1086
1453
<hr>
1087
1454
<div class="refsect2" title="g_signal_emit ()">
1088
1455
<a name="g-signal-emit"></a><h3>g_signal_emit ()</h3>
1089
<pre class="programlisting"><span class="returnvalue">void</span> g_signal_emit (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
1090
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
1091
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
1456
<pre class="programlisting">void g_signal_emit (<a
1457
href="./../glib/glib/glib-Basic-Types.html#gpointer"
1458
>gpointer</a> instance,
1459
<a
1460
href="./../glib/glib/glib-Basic-Types.html#guint"
1461
>guint</a> signal_id,
1462
<a
1463
href="./../glib/glib/glib-Quarks.html#GQuark"
1464
>GQuark</a> detail,
1092
1465
...);</pre>
1093
1466
<p>
1094
1467
Emits a signal.
1096
1469
<p>
1097
1470
Note that <a class="link" href="gobject-Signals.html#g-signal-emit" title="g_signal_emit ()"><code class="function">g_signal_emit()</code></a> resets the return value to the default
1098
1471
if no handlers are connected, in contrast to <a class="link" href="gobject-Signals.html#g-signal-emitv" title="g_signal_emitv ()"><code class="function">g_signal_emitv()</code></a>.</p>
1472
<p>
1473
</p>
1099
1474
<div class="variablelist"><table border="0">
1100
1475
<col align="left" valign="top">
1101
1476
<tbody>
1118
1493
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1119
1494
<td> parameters to be passed to the signal, followed by a
1120
1495
location for the return value. If the return type of the signal
1121
is <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE:CAPS" title="G_TYPE_NONE"><span class="type">G_TYPE_NONE</span></a>, the return value location can be omitted.
1496
is <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE--CAPS" title="G_TYPE_NONE"><span class="type">G_TYPE_NONE</span></a>, the return value location can be omitted.
1122
1497
</td>
1123
1498
</tr>
1124
1499
</tbody>
1127
1502
<hr>
1128
1503
<div class="refsect2" title="g_signal_emit_by_name ()">
1129
1504
<a name="g-signal-emit-by-name"></a><h3>g_signal_emit_by_name ()</h3>
1130
<pre class="programlisting"><span class="returnvalue">void</span> g_signal_emit_by_name (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
1131
const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *detailed_signal,
1505
<pre class="programlisting">void g_signal_emit_by_name (<a
1506
href="./../glib/glib/glib-Basic-Types.html#gpointer"
1507
>gpointer</a> instance,
1508
const <a
1509
href="./../glib/glib/glib-Basic-Types.html#gchar"
1510
>gchar</a> *detailed_signal,
1132
1511
...);</pre>
1133
1512
<p>
1134
1513
Emits a signal.
1136
1515
<p>
1137
1516
Note that <a class="link" href="gobject-Signals.html#g-signal-emit-by-name" title="g_signal_emit_by_name ()"><code class="function">g_signal_emit_by_name()</code></a> resets the return value to the default
1138
1517
if no handlers are connected, in contrast to <a class="link" href="gobject-Signals.html#g-signal-emitv" title="g_signal_emitv ()"><code class="function">g_signal_emitv()</code></a>.</p>
1518
<p>
1519
</p>
1139
1520
<div class="variablelist"><table border="0">
1140
1521
<col align="left" valign="top">
1141
1522
<tbody>
1153
1534
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1154
1535
<td> parameters to be passed to the signal, followed by a
1155
1536
location for the return value. If the return type of the signal
1156
is <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE:CAPS" title="G_TYPE_NONE"><span class="type">G_TYPE_NONE</span></a>, the return value location can be omitted.
1537
is <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE--CAPS" title="G_TYPE_NONE"><span class="type">G_TYPE_NONE</span></a>, the return value location can be omitted.
1157
1538
</td>
1158
1539
</tr>
1159
1540
</tbody>
1162
1543
<hr>
1163
1544
<div class="refsect2" title="g_signal_emitv ()">
1164
1545
<a name="g-signal-emitv"></a><h3>g_signal_emitv ()</h3>
1165
<pre class="programlisting"><span class="returnvalue">void</span> g_signal_emitv (const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *instance_and_params,
1166
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
1167
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
1168
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *return_value);</pre>
1546
<pre class="programlisting">void g_signal_emitv (const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *instance_and_params,
1547
<a
1548
href="./../glib/glib/glib-Basic-Types.html#guint"
1549
>guint</a> signal_id,
1550
<a
1551
href="./../glib/glib/glib-Quarks.html#GQuark"
1552
>GQuark</a> detail,
1553
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *return_value);</pre>
1169
1554
<p>
1170
1555
Emits a signal.
1171
1556
</p>
1172
1557
<p>
1173
1558
Note that <a class="link" href="gobject-Signals.html#g-signal-emitv" title="g_signal_emitv ()"><code class="function">g_signal_emitv()</code></a> doesn't change <em class="parameter"><code>return_value</code></em> if no handlers are
1174
1559
connected, in contrast to <a class="link" href="gobject-Signals.html#g-signal-emit" title="g_signal_emit ()"><code class="function">g_signal_emit()</code></a> and <a class="link" href="gobject-Signals.html#g-signal-emit-valist" title="g_signal_emit_valist ()"><code class="function">g_signal_emit_valist()</code></a>.</p>
1560
<p>
1561
</p>
1175
1562
<div class="variablelist"><table border="0">
1176
1563
<col align="left" valign="top">
1177
1564
<tbody>
1204
1591
<hr>
1205
1592
<div class="refsect2" title="g_signal_emit_valist ()">
1206
1593
<a name="g-signal-emit-valist"></a><h3>g_signal_emit_valist ()</h3>
1207
<pre class="programlisting"><span class="returnvalue">void</span> g_signal_emit_valist (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
1208
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
1209
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
1210
<span class="returnvalue">va_list</span> var_args);</pre>
1594
<pre class="programlisting">void g_signal_emit_valist (<a
1595
href="./../glib/glib/glib-Basic-Types.html#gpointer"
1596
>gpointer</a> instance,
1597
<a
1598
href="./../glib/glib/glib-Basic-Types.html#guint"
1599
>guint</a> signal_id,
1600
<a
1601
href="./../glib/glib/glib-Quarks.html#GQuark"
1602
>GQuark</a> detail,
1603
va_list var_args);</pre>
1211
1604
<p>
1212
1605
Emits a signal.
1213
1606
</p>
1214
1607
<p>
1215
1608
Note that <a class="link" href="gobject-Signals.html#g-signal-emit-valist" title="g_signal_emit_valist ()"><code class="function">g_signal_emit_valist()</code></a> resets the return value to the default
1216
1609
if no handlers are connected, in contrast to <a class="link" href="gobject-Signals.html#g-signal-emitv" title="g_signal_emitv ()"><code class="function">g_signal_emitv()</code></a>.</p>
1610
<p>
1611
</p>
1217
1612
<div class="variablelist"><table border="0">
1218
1613
<col align="left" valign="top">
1219
1614
<tbody>
1236
1631
<td><p><span class="term"><em class="parameter"><code>var_args</code></em> :</span></p></td>
1237
1632
<td> a list of parameters to be passed to the signal, followed by a
1238
1633
location for the return value. If the return type of the signal
1239
is <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE:CAPS" title="G_TYPE_NONE"><span class="type">G_TYPE_NONE</span></a>, the return value location can be omitted.
1634
is <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE--CAPS" title="G_TYPE_NONE"><span class="type">G_TYPE_NONE</span></a>, the return value location can be omitted.
1240
1635
</td>
1241
1636
</tr>
1242
1637
</tbody>
1251
1646
</p>
1252
1647
<p>
1253
1648
The handler will be called before the default handler of the signal.</p>
1649
<p>
1650
</p>
1254
1651
<div class="variablelist"><table border="0">
1255
1652
<col align="left" valign="top">
1256
1653
<tbody>
1274
1671
<td> data to pass to <em class="parameter"><code>c_handler</code></em> calls.
1275
1672
</td>
1276
1673
</tr>
1277
<tr>
1278
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1279
<td> the handler id
1280
</td>
1281
</tr>
1282
1674
</tbody>
1283
1675
</table></div>
1284
1676
</div>
1291
1683
</p>
1292
1684
<p>
1293
1685
The handler will be called after the default handler of the signal.</p>
1686
<p>
1687
</p>
1294
1688
<div class="variablelist"><table border="0">
1295
1689
<col align="left" valign="top">
1296
1690
<tbody>
1314
1708
<td> data to pass to <em class="parameter"><code>c_handler</code></em> calls.
1315
1709
</td>
1316
1710
</tr>
1317
<tr>
1318
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1319
<td> the handler id
1320
</td>
1321
</tr>
1322
1711
</tbody>
1323
1712
</table></div>
1324
1713
</div>
1332
1721
<p>
1333
1722
The instance on which the signal is emitted and <em class="parameter"><code>data</code></em> will be swapped when
1334
1723
calling the handler.</p>
1724
<p>
1725
</p>
1335
1726
<div class="variablelist"><table border="0">
1336
1727
<col align="left" valign="top">
1337
1728
<tbody>
1355
1746
<td> data to pass to <em class="parameter"><code>c_handler</code></em> calls.
1356
1747
</td>
1357
1748
</tr>
1358
<tr>
1359
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1360
<td> the handler id
1361
</td>
1362
</tr>
1363
1749
</tbody>
1364
1750
</table></div>
1365
1751
</div>
1366
1752
<hr>
1367
1753
<div class="refsect2" title="g_signal_connect_object ()">
1368
1754
<a name="g-signal-connect-object"></a><h3>g_signal_connect_object ()</h3>
1369
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> g_signal_connect_object (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
1370
const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *detailed_signal,
1371
<a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="returnvalue">GCallback</span></a> c_handler,
1372
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> gobject,
1373
<a class="link" href="gobject-Signals.html#GConnectFlags" title="enum GConnectFlags"><span class="returnvalue">GConnectFlags</span></a> connect_flags);</pre>
1755
<pre class="programlisting"><a
1756
href="./../glib/glib/glib-Basic-Types.html#gulong"
1757
>gulong</a> g_signal_connect_object (<a
1758
href="./../glib/glib/glib-Basic-Types.html#gpointer"
1759
>gpointer</a> instance,
1760
const <a
1761
href="./../glib/glib/glib-Basic-Types.html#gchar"
1762
>gchar</a> *detailed_signal,
1763
<a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()">GCallback</a> c_handler,
1764
<a
1765
href="./../glib/glib/glib-Basic-Types.html#gpointer"
1766
>gpointer</a> gobject,
1767
<a class="link" href="gobject-Signals.html#GConnectFlags" title="enum GConnectFlags">GConnectFlags</a> connect_flags);</pre>
1374
1768
<p>
1375
1769
This is similar to <a class="link" href="gobject-Signals.html#g-signal-connect-data" title="g_signal_connect_data ()"><code class="function">g_signal_connect_data()</code></a>, but uses a closure which
1376
1770
ensures that the <em class="parameter"><code>gobject</code></em> stays alive during the call to <em class="parameter"><code>c_handler</code></em>
1397
1791
if (g_signal_handler_is_connected (instance, id))
1398
1792
g_signal_handler_disconnect (instance, id);
1399
1793
</pre></div>
1794
<p>
1795
</p>
1400
1796
<div class="variablelist"><table border="0">
1401
1797
<col align="left" valign="top">
1402
1798
<tbody>
1438
1834
<a name="GConnectFlags"></a><h3>enum GConnectFlags</h3>
1439
1835
<pre class="programlisting">typedef enum
1440
1836
{
1441
G_CONNECT_AFTER = 1 << 0,
1442
G_CONNECT_SWAPPED = 1 << 1
1837
G_CONNECT_AFTER = 1 << 0,
1838
G_CONNECT_SWAPPED = 1 << 1
1443
1839
} GConnectFlags;
1444
1840
</pre>
1445
1841
<p>
1446
1842
The connection flags are used to specify the behaviour of a signal's
1447
1843
connection.</p>
1844
<p>
1845
</p>
1448
1846
<div class="variablelist"><table border="0">
1449
1847
<col align="left" valign="top">
1450
1848
<tbody>
1451
1849
<tr>
1452
<td><p><a name="G-CONNECT-AFTER:CAPS"></a><span class="term"><code class="literal">G_CONNECT_AFTER</code></span></p></td>
1850
<td><p><a name="G-CONNECT-AFTER--CAPS"></a><span class="term"><code class="literal">G_CONNECT_AFTER</code></span></p></td>
1453
1851
<td> whether the handler should be called before or after the
1454
1852
default handler of the signal.
1455
1853
</td>
1456
1854
</tr>
1457
1855
<tr>
1458
<td><p><a name="G-CONNECT-SWAPPED:CAPS"></a><span class="term"><code class="literal">G_CONNECT_SWAPPED</code></span></p></td>
1856
<td><p><a name="G-CONNECT-SWAPPED--CAPS"></a><span class="term"><code class="literal">G_CONNECT_SWAPPED</code></span></p></td>
1459
1857
<td> whether the instance and data should be swapped when
1460
1858
calling the handler.
1461
1859
</td>
1466
1864
<hr>
1467
1865
<div class="refsect2" title="g_signal_connect_data ()">
1468
1866
<a name="g-signal-connect-data"></a><h3>g_signal_connect_data ()</h3>
1469
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> g_signal_connect_data (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
1470
const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *detailed_signal,
1471
<a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="returnvalue">GCallback</span></a> c_handler,
1472
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> data,
1473
<a class="link" href="gobject-Closures.html#GClosureNotify" title="GClosureNotify ()"><span class="returnvalue">GClosureNotify</span></a> destroy_data,
1474
<a class="link" href="gobject-Signals.html#GConnectFlags" title="enum GConnectFlags"><span class="returnvalue">GConnectFlags</span></a> connect_flags);</pre>
1867
<pre class="programlisting"><a
1868
href="./../glib/glib/glib-Basic-Types.html#gulong"
1869
>gulong</a> g_signal_connect_data (<a
1870
href="./../glib/glib/glib-Basic-Types.html#gpointer"
1871
>gpointer</a> instance,
1872
const <a
1873
href="./../glib/glib/glib-Basic-Types.html#gchar"
1874
>gchar</a> *detailed_signal,
1875
<a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()">GCallback</a> c_handler,
1876
<a
1877
href="./../glib/glib/glib-Basic-Types.html#gpointer"
1878
>gpointer</a> data,
1879
<a class="link" href="gobject-Closures.html#GClosureNotify" title="GClosureNotify ()">GClosureNotify</a> destroy_data,
1880
<a class="link" href="gobject-Signals.html#GConnectFlags" title="enum GConnectFlags">GConnectFlags</a> connect_flags);</pre>
1475
1881
<p>
1476
1882
Connects a <a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="type">GCallback</span></a> function to a signal for a particular object. Similar
1477
1883
to <a class="link" href="gobject-Signals.html#g-signal-connect" title="g_signal_connect()"><code class="function">g_signal_connect()</code></a>, but allows to provide a <a class="link" href="gobject-Closures.html#GClosureNotify" title="GClosureNotify ()"><span class="type">GClosureNotify</span></a> for the data
1478
1884
which will be called when the signal handler is disconnected and no longer
1479
used. Specify <em class="parameter"><code>connect_flags</code></em> if you need <code class="literal">..._after()</code> or
1480
<code class="literal">..._swapped()</code> variants of this function.</p>
1885
used. Specify <em class="parameter"><code>connect_flags</code></em> if you need <code class="literal">...<code class="function">_after()</code></code> or
1886
<code class="literal">...<code class="function">_swapped()</code></code> variants of this function.</p>
1887
<p>
1888
</p>
1481
1889
<div class="variablelist"><table border="0">
1482
1890
<col align="left" valign="top">
1483
1891
<tbody>
1522
1930
<hr>
1523
1931
<div class="refsect2" title="g_signal_connect_closure ()">
1524
1932
<a name="g-signal-connect-closure"></a><h3>g_signal_connect_closure ()</h3>
1525
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> g_signal_connect_closure (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
1526
const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *detailed_signal,
1527
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *closure,
1528
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> after);</pre>
1933
<pre class="programlisting"><a
1934
href="./../glib/glib/glib-Basic-Types.html#gulong"
1935
>gulong</a> g_signal_connect_closure (<a
1936
href="./../glib/glib/glib-Basic-Types.html#gpointer"
1937
>gpointer</a> instance,
1938
const <a
1939
href="./../glib/glib/glib-Basic-Types.html#gchar"
1940
>gchar</a> *detailed_signal,
1941
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *closure,
1942
<a
1943
href="./../glib/glib/glib-Basic-Types.html#gboolean"
1944
>gboolean</a> after);</pre>
1529
1945
<p>
1530
1946
Connects a closure to a signal for a particular object.</p>
1947
<p>
1948
</p>
1531
1949
<div class="variablelist"><table border="0">
1532
1950
<col align="left" valign="top">
1533
1951
<tbody>
1563
1981
<hr>
1564
1982
<div class="refsect2" title="g_signal_connect_closure_by_id ()">
1565
1983
<a name="g-signal-connect-closure-by-id"></a><h3>g_signal_connect_closure_by_id ()</h3>
1566
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> g_signal_connect_closure_by_id (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
1567
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
1568
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
1569
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *closure,
1570
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> after);</pre>
1984
<pre class="programlisting"><a
1985
href="./../glib/glib/glib-Basic-Types.html#gulong"
1986
>gulong</a> g_signal_connect_closure_by_id (<a
1987
href="./../glib/glib/glib-Basic-Types.html#gpointer"
1988
>gpointer</a> instance,
1989
<a
1990
href="./../glib/glib/glib-Basic-Types.html#guint"
1991
>guint</a> signal_id,
1992
<a
1993
href="./../glib/glib/glib-Quarks.html#GQuark"
1994
>GQuark</a> detail,
1995
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *closure,
1996
<a
1997
href="./../glib/glib/glib-Basic-Types.html#gboolean"
1998
>gboolean</a> after);</pre>
1571
1999
<p>
1572
2000
Connects a closure to a signal for a particular object.</p>
2001
<p>
2002
</p>
1573
2003
<div class="variablelist"><table border="0">
1574
2004
<col align="left" valign="top">
1575
2005
<tbody>
1610
2040
<hr>
1611
2041
<div class="refsect2" title="g_signal_handler_block ()">
1612
2042
<a name="g-signal-handler-block"></a><h3>g_signal_handler_block ()</h3>
1613
<pre class="programlisting"><span class="returnvalue">void</span> g_signal_handler_block (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
1614
<a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> handler_id);</pre>
2043
<pre class="programlisting">void g_signal_handler_block (<a
2044
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2045
>gpointer</a> instance,
2046
<a
2047
href="./../glib/glib/glib-Basic-Types.html#gulong"
2048
>gulong</a> handler_id);</pre>
1615
2049
<p>
1616
2050
Blocks a handler of an instance so it will not be called during any
1617
2051
signal emissions unless it is unblocked again. Thus "blocking" a
1622
2056
<p>
1623
2057
The <em class="parameter"><code>handler_id</code></em> has to be a valid signal handler id, connected to a
1624
2058
signal of <em class="parameter"><code>instance</code></em>.</p>
2059
<p>
2060
</p>
1625
2061
<div class="variablelist"><table border="0">
1626
2062
<col align="left" valign="top">
1627
2063
<tbody>
1641
2077
<hr>
1642
2078
<div class="refsect2" title="g_signal_handler_unblock ()">
1643
2079
<a name="g-signal-handler-unblock"></a><h3>g_signal_handler_unblock ()</h3>
1644
<pre class="programlisting"><span class="returnvalue">void</span> g_signal_handler_unblock (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
1645
<a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> handler_id);</pre>
2080
<pre class="programlisting">void g_signal_handler_unblock (<a
2081
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2082
>gpointer</a> instance,
2083
<a
2084
href="./../glib/glib/glib-Basic-Types.html#gulong"
2085
>gulong</a> handler_id);</pre>
1646
2086
<p>
1647
2087
Undoes the effect of a previous <a class="link" href="gobject-Signals.html#g-signal-handler-block" title="g_signal_handler_block ()"><code class="function">g_signal_handler_block()</code></a> call. A
1648
2088
blocked handler is skipped during signal emissions and will not be
1658
2098
<p>
1659
2099
The <em class="parameter"><code>handler_id</code></em> has to be a valid id of a signal handler that is
1660
2100
connected to a signal of <em class="parameter"><code>instance</code></em> and is currently blocked.</p>
2101
<p>
2102
</p>
1661
2103
<div class="variablelist"><table border="0">
1662
2104
<col align="left" valign="top">
1663
2105
<tbody>
1677
2119
<hr>
1678
2120
<div class="refsect2" title="g_signal_handler_disconnect ()">
1679
2121
<a name="g-signal-handler-disconnect"></a><h3>g_signal_handler_disconnect ()</h3>
1680
<pre class="programlisting"><span class="returnvalue">void</span> g_signal_handler_disconnect (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
1681
<a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> handler_id);</pre>
2122
<pre class="programlisting">void g_signal_handler_disconnect (<a
2123
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2124
>gpointer</a> instance,
2125
<a
2126
href="./../glib/glib/glib-Basic-Types.html#gulong"
2127
>gulong</a> handler_id);</pre>
1682
2128
<p>
1683
2129
Disconnects a handler from an instance so it will not be called during
1684
2130
any future or currently ongoing emissions of the signal it has been
1687
2133
<p>
1688
2134
The <em class="parameter"><code>handler_id</code></em> has to be a valid signal handler id, connected to a
1689
2135
signal of <em class="parameter"><code>instance</code></em>.</p>
2136
<p>
2137
</p>
1690
2138
<div class="variablelist"><table border="0">
1691
2139
<col align="left" valign="top">
1692
2140
<tbody>
1706
2154
<hr>
1707
2155
<div class="refsect2" title="g_signal_handler_find ()">
1708
2156
<a name="g-signal-handler-find"></a><h3>g_signal_handler_find ()</h3>
1709
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> g_signal_handler_find (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
1710
<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="returnvalue">GSignalMatchType</span></a> mask,
1711
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
1712
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
1713
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *closure,
1714
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> func,
1715
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> data);</pre>
2157
<pre class="programlisting"><a
2158
href="./../glib/glib/glib-Basic-Types.html#gulong"
2159
>gulong</a> g_signal_handler_find (<a
2160
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2161
>gpointer</a> instance,
2162
<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a> mask,
2163
<a
2164
href="./../glib/glib/glib-Basic-Types.html#guint"
2165
>guint</a> signal_id,
2166
<a
2167
href="./../glib/glib/glib-Quarks.html#GQuark"
2168
>GQuark</a> detail,
2169
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *closure,
2170
<a
2171
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2172
>gpointer</a> func,
2173
<a
2174
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2175
>gpointer</a> data);</pre>
1716
2176
<p>
1717
2177
Finds the first signal handler that matches certain selection criteria.
1718
2178
The criteria mask is passed as an OR-ed combination of <a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="type">GSignalMatchType</span></a>
1719
2179
flags, and the criteria values are passed as arguments.
1720
2180
The match <em class="parameter"><code>mask</code></em> has to be non-0 for successful matches.
1721
2181
If no handler was found, 0 is returned.</p>
2182
<p>
2183
</p>
1722
2184
<div class="variablelist"><table border="0">
1723
2185
<col align="left" valign="top">
1724
2186
<tbody>
1769
2231
<hr>
1770
2232
<div class="refsect2" title="g_signal_handlers_block_matched ()">
1771
2233
<a name="g-signal-handlers-block-matched"></a><h3>g_signal_handlers_block_matched ()</h3>
1772
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_signal_handlers_block_matched (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
1773
<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="returnvalue">GSignalMatchType</span></a> mask,
1774
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
1775
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
1776
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *closure,
1777
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> func,
1778
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> data);</pre>
2234
<pre class="programlisting"><a
2235
href="./../glib/glib/glib-Basic-Types.html#guint"
2236
>guint</a> g_signal_handlers_block_matched (<a
2237
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2238
>gpointer</a> instance,
2239
<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a> mask,
2240
<a
2241
href="./../glib/glib/glib-Basic-Types.html#guint"
2242
>guint</a> signal_id,
2243
<a
2244
href="./../glib/glib/glib-Quarks.html#GQuark"
2245
>GQuark</a> detail,
2246
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *closure,
2247
<a
2248
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2249
>gpointer</a> func,
2250
<a
2251
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2252
>gpointer</a> data);</pre>
1779
2253
<p>
1780
2254
Blocks all handlers on an instance that match a certain selection criteria.
1781
2255
The criteria mask is passed as an OR-ed combination of <a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="type">GSignalMatchType</span></a>
1782
2256
flags, and the criteria values are passed as arguments.
1783
Passing at least one of the <a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-CLOSURE:CAPS"><code class="literal">G_SIGNAL_MATCH_CLOSURE</code></a>, <a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-FUNC:CAPS"><code class="literal">G_SIGNAL_MATCH_FUNC</code></a>
1784
or <a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-DATA:CAPS"><code class="literal">G_SIGNAL_MATCH_DATA</code></a> match flags is required for successful matches.
2257
Passing at least one of the <a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-CLOSURE--CAPS"><code class="literal">G_SIGNAL_MATCH_CLOSURE</code></a>, <a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-FUNC--CAPS"><code class="literal">G_SIGNAL_MATCH_FUNC</code></a>
2258
or <a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-DATA--CAPS"><code class="literal">G_SIGNAL_MATCH_DATA</code></a> match flags is required for successful matches.
1785
2259
If no handlers were found, 0 is returned, the number of blocked handlers
1786
2260
otherwise.</p>
2261
<p>
2262
</p>
1787
2263
<div class="variablelist"><table border="0">
1788
2264
<col align="left" valign="top">
1789
2265
<tbody>
1834
2310
<hr>
1835
2311
<div class="refsect2" title="g_signal_handlers_unblock_matched ()">
1836
2312
<a name="g-signal-handlers-unblock-matched"></a><h3>g_signal_handlers_unblock_matched ()</h3>
1837
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_signal_handlers_unblock_matched (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
1838
<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="returnvalue">GSignalMatchType</span></a> mask,
1839
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
1840
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
1841
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *closure,
1842
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> func,
1843
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> data);</pre>
2313
<pre class="programlisting"><a
2314
href="./../glib/glib/glib-Basic-Types.html#guint"
2315
>guint</a> g_signal_handlers_unblock_matched (<a
2316
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2317
>gpointer</a> instance,
2318
<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a> mask,
2319
<a
2320
href="./../glib/glib/glib-Basic-Types.html#guint"
2321
>guint</a> signal_id,
2322
<a
2323
href="./../glib/glib/glib-Quarks.html#GQuark"
2324
>GQuark</a> detail,
2325
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *closure,
2326
<a
2327
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2328
>gpointer</a> func,
2329
<a
2330
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2331
>gpointer</a> data);</pre>
1844
2332
<p>
1845
2333
Unblocks all handlers on an instance that match a certain selection
1846
2334
criteria. The criteria mask is passed as an OR-ed combination of
1847
2335
<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="type">GSignalMatchType</span></a> flags, and the criteria values are passed as arguments.
1848
Passing at least one of the <a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-CLOSURE:CAPS"><code class="literal">G_SIGNAL_MATCH_CLOSURE</code></a>, <a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-FUNC:CAPS"><code class="literal">G_SIGNAL_MATCH_FUNC</code></a>
1849
or <a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-DATA:CAPS"><code class="literal">G_SIGNAL_MATCH_DATA</code></a> match flags is required for successful matches.
2336
Passing at least one of the <a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-CLOSURE--CAPS"><code class="literal">G_SIGNAL_MATCH_CLOSURE</code></a>, <a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-FUNC--CAPS"><code class="literal">G_SIGNAL_MATCH_FUNC</code></a>
2337
or <a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-DATA--CAPS"><code class="literal">G_SIGNAL_MATCH_DATA</code></a> match flags is required for successful matches.
1850
2338
If no handlers were found, 0 is returned, the number of unblocked handlers
1851
2339
otherwise. The match criteria should not apply to any handlers that are
1852
2340
not currently blocked.</p>
2341
<p>
2342
</p>
1853
2343
<div class="variablelist"><table border="0">
1854
2344
<col align="left" valign="top">
1855
2345
<tbody>
1900
2390
<hr>
1901
2391
<div class="refsect2" title="g_signal_handlers_disconnect_matched ()">
1902
2392
<a name="g-signal-handlers-disconnect-matched"></a><h3>g_signal_handlers_disconnect_matched ()</h3>
1903
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_signal_handlers_disconnect_matched
1904
(<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
1905
<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="returnvalue">GSignalMatchType</span></a> mask,
1906
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
1907
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
1908
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *closure,
1909
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> func,
1910
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> data);</pre>
2393
<pre class="programlisting"><a
2394
href="./../glib/glib/glib-Basic-Types.html#guint"
2395
>guint</a> g_signal_handlers_disconnect_matched
2396
(<a
2397
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2398
>gpointer</a> instance,
2399
<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a> mask,
2400
<a
2401
href="./../glib/glib/glib-Basic-Types.html#guint"
2402
>guint</a> signal_id,
2403
<a
2404
href="./../glib/glib/glib-Quarks.html#GQuark"
2405
>GQuark</a> detail,
2406
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *closure,
2407
<a
2408
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2409
>gpointer</a> func,
2410
<a
2411
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2412
>gpointer</a> data);</pre>
1911
2413
<p>
1912
2414
Disconnects all handlers on an instance that match a certain
1913
2415
selection criteria. The criteria mask is passed as an OR-ed
1914
2416
combination of <a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="type">GSignalMatchType</span></a> flags, and the criteria values are
1915
2417
passed as arguments. Passing at least one of the
1916
<a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-CLOSURE:CAPS"><code class="literal">G_SIGNAL_MATCH_CLOSURE</code></a>, <a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-FUNC:CAPS"><code class="literal">G_SIGNAL_MATCH_FUNC</code></a> or
1917
<a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-DATA:CAPS"><code class="literal">G_SIGNAL_MATCH_DATA</code></a> match flags is required for successful
2418
<a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-CLOSURE--CAPS"><code class="literal">G_SIGNAL_MATCH_CLOSURE</code></a>, <a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-FUNC--CAPS"><code class="literal">G_SIGNAL_MATCH_FUNC</code></a> or
2419
<a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-DATA--CAPS"><code class="literal">G_SIGNAL_MATCH_DATA</code></a> match flags is required for successful
1918
2420
matches. If no handlers were found, 0 is returned, the number of
1919
2421
disconnected handlers otherwise.</p>
2422
<p>
2423
</p>
1920
2424
<div class="variablelist"><table border="0">
1921
2425
<col align="left" valign="top">
1922
2426
<tbody>
1967
2471
<hr>
1968
2472
<div class="refsect2" title="g_signal_handler_is_connected ()">
1969
2473
<a name="g-signal-handler-is-connected"></a><h3>g_signal_handler_is_connected ()</h3>
1970
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_signal_handler_is_connected (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
1971
<a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> handler_id);</pre>
2474
<pre class="programlisting"><a
2475
href="./../glib/glib/glib-Basic-Types.html#gboolean"
2476
>gboolean</a> g_signal_handler_is_connected (<a
2477
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2478
>gpointer</a> instance,
2479
<a
2480
href="./../glib/glib/glib-Basic-Types.html#gulong"
2481
>gulong</a> handler_id);</pre>
1972
2482
<p>
1973
2483
Returns whether <em class="parameter"><code>handler_id</code></em> is the id of a handler connected to <em class="parameter"><code>instance</code></em>.</p>
2484
<p>
2485
</p>
1974
2486
<div class="variablelist"><table border="0">
1975
2487
<col align="left" valign="top">
1976
2488
<tbody>
1998
2510
<pre class="programlisting">#define g_signal_handlers_block_by_func(instance, func, data)</pre>
1999
2511
<p>
2000
2512
Blocks all handlers on an instance that match <em class="parameter"><code>func</code></em> and <em class="parameter"><code>data</code></em>.</p>
2513
<p>
2514
</p>
2001
2515
<div class="variablelist"><table border="0">
2002
2516
<col align="left" valign="top">
2003
2517
<tbody>
2016
2530
<td> The closure data of the handlers' closures.
2017
2531
</td>
2018
2532
</tr>
2019
<tr>
2020
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2021
<td> The number of handlers that matched.
2022
</td>
2023
</tr>
2024
2533
</tbody>
2025
2534
</table></div>
2026
2535
</div>
2030
2539
<pre class="programlisting">#define g_signal_handlers_unblock_by_func(instance, func, data)</pre>
2031
2540
<p>
2032
2541
Unblocks all handlers on an instance that match <em class="parameter"><code>func</code></em> and <em class="parameter"><code>data</code></em>.</p>
2542
<p>
2543
</p>
2033
2544
<div class="variablelist"><table border="0">
2034
2545
<col align="left" valign="top">
2035
2546
<tbody>
2048
2559
<td> The closure data of the handlers' closures.
2049
2560
</td>
2050
2561
</tr>
2051
<tr>
2052
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2053
<td> The number of handlers that matched.
2054
</td>
2055
</tr>
2056
2562
</tbody>
2057
2563
</table></div>
2058
2564
</div>
2062
2568
<pre class="programlisting">#define g_signal_handlers_disconnect_by_func(instance, func, data)</pre>
2063
2569
<p>
2064
2570
Disconnects all handlers on an instance that match <em class="parameter"><code>func</code></em> and <em class="parameter"><code>data</code></em>.</p>
2571
<p>
2572
</p>
2065
2573
<div class="variablelist"><table border="0">
2066
2574
<col align="left" valign="top">
2067
2575
<tbody>
2080
2588
<td> The closure data of the handlers' closures.
2081
2589
</td>
2082
2590
</tr>
2083
<tr>
2084
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2085
<td> The number of handlers that matched.
2086
</td>
2087
</tr>
2088
2591
</tbody>
2089
2592
</table></div>
2090
2593
</div>
2091
2594
<hr>
2092
2595
<div class="refsect2" title="g_signal_has_handler_pending ()">
2093
2596
<a name="g-signal-has-handler-pending"></a><h3>g_signal_has_handler_pending ()</h3>
2094
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_signal_has_handler_pending (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
2095
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
2096
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
2097
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> may_be_blocked);</pre>
2597
<pre class="programlisting"><a
2598
href="./../glib/glib/glib-Basic-Types.html#gboolean"
2599
>gboolean</a> g_signal_has_handler_pending (<a
2600
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2601
>gpointer</a> instance,
2602
<a
2603
href="./../glib/glib/glib-Basic-Types.html#guint"
2604
>guint</a> signal_id,
2605
<a
2606
href="./../glib/glib/glib-Quarks.html#GQuark"
2607
>GQuark</a> detail,
2608
<a
2609
href="./../glib/glib/glib-Basic-Types.html#gboolean"
2610
>gboolean</a> may_be_blocked);</pre>
2098
2611
<p>
2099
2612
Returns whether there are any handlers connected to <em class="parameter"><code>instance</code></em> for the
2100
2613
given signal id and detail.
2104
2617
signal are difficult to compute. A class implementor may opt to not
2105
2618
emit the signal if no one is attached anyway, thus saving the cost
2106
2619
of building the arguments.</p>
2620
<p>
2621
</p>
2107
2622
<div class="variablelist"><table border="0">
2108
2623
<col align="left" valign="top">
2109
2624
<tbody>
2129
2644
</tr>
2130
2645
<tr>
2131
2646
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2132
<td> <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a handler is connected to the signal, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
2647
<td> <a
2648
href="./../glib/glib/glib-Standard-Macros.html#TRUE--CAPS"
2649
><code class="literal">TRUE</code></a> if a handler is connected to the signal, <a
2650
href="./../glib/glib/glib-Standard-Macros.html#FALSE--CAPS"
2651
><code class="literal">FALSE</code></a>
2133
2652
otherwise.
2134
2653
</td>
2135
2654
</tr>
2139
2658
<hr>
2140
2659
<div class="refsect2" title="g_signal_stop_emission ()">
2141
2660
<a name="g-signal-stop-emission"></a><h3>g_signal_stop_emission ()</h3>
2142
<pre class="programlisting"><span class="returnvalue">void</span> g_signal_stop_emission (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
2143
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
2144
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail);</pre>
2661
<pre class="programlisting">void g_signal_stop_emission (<a
2662
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2663
>gpointer</a> instance,
2664
<a
2665
href="./../glib/glib/glib-Basic-Types.html#guint"
2666
>guint</a> signal_id,
2667
<a
2668
href="./../glib/glib/glib-Quarks.html#GQuark"
2669
>GQuark</a> detail);</pre>
2145
2670
<p>
2146
2671
Stops a signal's current emission.
2147
2672
</p>
2148
2673
<p>
2149
2674
This will prevent the default method from running, if the signal was
2150
<a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">G_SIGNAL_RUN_LAST</code></a> and you connected normally (i.e. without the "after"
2675
<a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-LAST--CAPS"><code class="literal">G_SIGNAL_RUN_LAST</code></a> and you connected normally (i.e. without the "after"
2151
2676
flag).
2152
2677
</p>
2153
2678
<p>
2154
2679
Prints a warning if used on a signal which isn't being emitted.</p>
2680
<p>
2681
</p>
2155
2682
<div class="variablelist"><table border="0">
2156
2683
<col align="left" valign="top">
2157
2684
<tbody>
2176
2703
<hr>
2177
2704
<div class="refsect2" title="g_signal_stop_emission_by_name ()">
2178
2705
<a name="g-signal-stop-emission-by-name"></a><h3>g_signal_stop_emission_by_name ()</h3>
2179
<pre class="programlisting"><span class="returnvalue">void</span> g_signal_stop_emission_by_name (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
2180
const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *detailed_signal);</pre>
2706
<pre class="programlisting">void g_signal_stop_emission_by_name (<a
2707
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2708
>gpointer</a> instance,
2709
const <a
2710
href="./../glib/glib/glib-Basic-Types.html#gchar"
2711
>gchar</a> *detailed_signal);</pre>
2181
2712
<p>
2182
2713
Stops a signal's current emission.
2183
2714
</p>
2184
2715
<p>
2185
2716
This is just like <a class="link" href="gobject-Signals.html#g-signal-stop-emission" title="g_signal_stop_emission ()"><code class="function">g_signal_stop_emission()</code></a> except it will look up the
2186
2717
signal id for you.</p>
2718
<p>
2719
</p>
2187
2720
<div class="variablelist"><table border="0">
2188
2721
<col align="left" valign="top">
2189
2722
<tbody>
2203
2736
<hr>
2204
2737
<div class="refsect2" title="g_signal_override_class_closure ()">
2205
2738
<a name="g-signal-override-class-closure"></a><h3>g_signal_override_class_closure ()</h3>
2206
<pre class="programlisting"><span class="returnvalue">void</span> g_signal_override_class_closure (<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
2207
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> instance_type,
2208
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> *class_closure);</pre>
2739
<pre class="programlisting">void g_signal_override_class_closure (<a
2740
href="./../glib/glib/glib-Basic-Types.html#guint"
2741
>guint</a> signal_id,
2742
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> instance_type,
2743
<a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a> *class_closure);</pre>
2209
2744
<p>
2210
2745
Overrides the class closure (i.e. the default handler) for the given signal
2211
2746
for emissions on instances of <em class="parameter"><code>instance_type</code></em>. <em class="parameter"><code>instance_type</code></em> must be derived
2215
2750
See <a class="link" href="gobject-Signals.html#g-signal-chain-from-overridden" title="g_signal_chain_from_overridden ()"><code class="function">g_signal_chain_from_overridden()</code></a> and
2216
2751
<a class="link" href="gobject-Signals.html#g-signal-chain-from-overridden-handler" title="g_signal_chain_from_overridden_handler ()"><code class="function">g_signal_chain_from_overridden_handler()</code></a> for how to chain up to the
2217
2752
parent class closure from inside the overridden one.</p>
2753
<p>
2754
</p>
2218
2755
<div class="variablelist"><table border="0">
2219
2756
<col align="left" valign="top">
2220
2757
<tbody>
2240
2777
<hr>
2241
2778
<div class="refsect2" title="g_signal_chain_from_overridden ()">
2242
2779
<a name="g-signal-chain-from-overridden"></a><h3>g_signal_chain_from_overridden ()</h3>
2243
<pre class="programlisting"><span class="returnvalue">void</span> g_signal_chain_from_overridden (const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *instance_and_params,
2244
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *return_value);</pre>
2780
<pre class="programlisting">void g_signal_chain_from_overridden (const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *instance_and_params,
2781
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *return_value);</pre>
2245
2782
<p>
2246
2783
Calls the original class closure of a signal. This function should only
2247
2784
be called from an overridden class closure; see
2248
2785
<a class="link" href="gobject-Signals.html#g-signal-override-class-closure" title="g_signal_override_class_closure ()"><code class="function">g_signal_override_class_closure()</code></a> and
2249
2786
<a class="link" href="gobject-Signals.html#g-signal-override-class-handler" title="g_signal_override_class_handler ()"><code class="function">g_signal_override_class_handler()</code></a>.</p>
2787
<p>
2788
</p>
2250
2789
<div class="variablelist"><table border="0">
2251
2790
<col align="left" valign="top">
2252
2791
<tbody>
2268
2807
<hr>
2269
2808
<div class="refsect2" title="g_signal_new_class_handler ()">
2270
2809
<a name="g-signal-new-class-handler"></a><h3>g_signal_new_class_handler ()</h3>
2271
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_signal_new_class_handler (const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *signal_name,
2272
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> itype,
2273
<a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="returnvalue">GSignalFlags</span></a> signal_flags,
2274
<a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="returnvalue">GCallback</span></a> class_handler,
2275
<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="returnvalue">GSignalAccumulator</span></a> accumulator,
2276
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> accu_data,
2277
<a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller"><span class="returnvalue">GSignalCMarshaller</span></a> c_marshaller,
2278
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> return_type,
2279
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_params,
2810
<pre class="programlisting"><a
2811
href="./../glib/glib/glib-Basic-Types.html#guint"
2812
>guint</a> g_signal_new_class_handler (const <a
2813
href="./../glib/glib/glib-Basic-Types.html#gchar"
2814
>gchar</a> *signal_name,
2815
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype,
2816
<a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags">GSignalFlags</a> signal_flags,
2817
<a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()">GCallback</a> class_handler,
2818
<a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()">GSignalAccumulator</a> accumulator,
2819
<a
2820
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2821
>gpointer</a> accu_data,
2822
<a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller">GSignalCMarshaller</a> c_marshaller,
2823
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> return_type,
2824
<a
2825
href="./../glib/glib/glib-Basic-Types.html#guint"
2826
>guint</a> n_params,
2280
2827
...);</pre>
2281
2828
<p>
2282
2829
Creates a new signal. (This is usually done in the class initializer.)
2294
2841
</p>
2295
2842
<p>
2296
2843
See <a class="link" href="gobject-Signals.html#g-signal-new" title="g_signal_new ()"><code class="function">g_signal_new()</code></a> for information about signal names.</p>
2844
<p>
2845
</p>
2297
2846
<div class="variablelist"><table border="0">
2298
2847
<col align="left" valign="top">
2299
2848
<tbody>
2312
2861
<td><p><span class="term"><em class="parameter"><code>signal_flags</code></em> :</span></p></td>
2313
2862
<td> a combination of <a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="type">GSignalFlags</span></a> specifying detail of when
2314
2863
the default handler is to be invoked. You should at least specify
2315
<a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">G_SIGNAL_RUN_FIRST</code></a> or <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">G_SIGNAL_RUN_LAST</code></a>.
2864
<a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-FIRST--CAPS"><code class="literal">G_SIGNAL_RUN_FIRST</code></a> or <a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-LAST--CAPS"><code class="literal">G_SIGNAL_RUN_LAST</code></a>.
2316
2865
</td>
2317
2866
</tr>
2318
2867
<tr>
2319
2868
<td><p><span class="term"><em class="parameter"><code>class_handler</code></em> :</span></p></td>
2320
2869
<td> a <a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="type">GCallback</span></a> which acts as class implementation of
2321
this signal. Used to invoke a class method generically. Pass <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
2870
this signal. Used to invoke a class method generically. Pass <a
2871
href="./../glib/glib/glib-Standard-Macros.html#NULL--CAPS"
2872
><code class="literal">NULL</code></a> to
2322
2873
not associate a class method with this signal.
2323
2874
</td>
2324
2875
</tr>
2325
2876
<tr>
2326
2877
<td><p><span class="term"><em class="parameter"><code>accumulator</code></em> :</span></p></td>
2327
<td> the accumulator for this signal; may be <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
2878
<td> the accumulator for this signal; may be <a
2879
href="./../glib/glib/glib-Standard-Macros.html#NULL--CAPS"
2880
><code class="literal">NULL</code></a>.
2328
2881
</td>
2329
2882
</tr>
2330
2883
<tr>
2340
2893
</tr>
2341
2894
<tr>
2342
2895
<td><p><span class="term"><em class="parameter"><code>return_type</code></em> :</span></p></td>
2343
<td> the type of return value, or <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE:CAPS" title="G_TYPE_NONE"><span class="type">G_TYPE_NONE</span></a> for a signal
2896
<td> the type of return value, or <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE--CAPS" title="G_TYPE_NONE"><span class="type">G_TYPE_NONE</span></a> for a signal
2344
2897
without a return value.
2345
2898
</td>
2346
2899
</tr>
2367
2920
<hr>
2368
2921
<div class="refsect2" title="g_signal_override_class_handler ()">
2369
2922
<a name="g-signal-override-class-handler"></a><h3>g_signal_override_class_handler ()</h3>
2370
<pre class="programlisting"><span class="returnvalue">void</span> g_signal_override_class_handler (const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *signal_name,
2371
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> instance_type,
2372
<a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="returnvalue">GCallback</span></a> class_handler);</pre>
2923
<pre class="programlisting">void g_signal_override_class_handler (const <a
2924
href="./../glib/glib/glib-Basic-Types.html#gchar"
2925
>gchar</a> *signal_name,
2926
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> instance_type,
2927
<a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()">GCallback</a> class_handler);</pre>
2373
2928
<p>
2374
2929
Overrides the class closure (i.e. the default handler) for the
2375
2930
given signal for emissions on instances of <em class="parameter"><code>instance_type</code></em> with
2380
2935
See <a class="link" href="gobject-Signals.html#g-signal-chain-from-overridden" title="g_signal_chain_from_overridden ()"><code class="function">g_signal_chain_from_overridden()</code></a> and
2381
2936
<a class="link" href="gobject-Signals.html#g-signal-chain-from-overridden-handler" title="g_signal_chain_from_overridden_handler ()"><code class="function">g_signal_chain_from_overridden_handler()</code></a> for how to chain up to the
2382
2937
parent class closure from inside the overridden one.</p>
2938
<p>
2939
</p>
2383
2940
<div class="variablelist"><table border="0">
2384
2941
<col align="left" valign="top">
2385
2942
<tbody>
2406
2963
<hr>
2407
2964
<div class="refsect2" title="g_signal_chain_from_overridden_handler ()">
2408
2965
<a name="g-signal-chain-from-overridden-handler"></a><h3>g_signal_chain_from_overridden_handler ()</h3>
2409
<pre class="programlisting"><span class="returnvalue">void</span> g_signal_chain_from_overridden_handler
2410
(<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance,
2966
<pre class="programlisting">void g_signal_chain_from_overridden_handler
2967
(<a
2968
href="./../glib/glib/glib-Basic-Types.html#gpointer"
2969
>gpointer</a> instance,
2411
2970
...);</pre>
2412
2971
<p>
2413
2972
Calls the original class closure of a signal. This function should
2414
2973
only be called from an overridden class closure; see
2415
2974
<a class="link" href="gobject-Signals.html#g-signal-override-class-closure" title="g_signal_override_class_closure ()"><code class="function">g_signal_override_class_closure()</code></a> and
2416
2975
<a class="link" href="gobject-Signals.html#g-signal-override-class-handler" title="g_signal_override_class_handler ()"><code class="function">g_signal_override_class_handler()</code></a>.</p>
2976
<p>
2977
</p>
2417
2978
<div class="variablelist"><table border="0">
2418
2979
<col align="left" valign="top">
2419
2980
<tbody>
2426
2987
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
2427
2988
<td> parameters to be passed to the parent class closure, followed by a
2428
2989
location for the return value. If the return type of the signal
2429
is <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE:CAPS" title="G_TYPE_NONE"><span class="type">G_TYPE_NONE</span></a>, the return value location can be omitted.
2990
is <a class="link" href="gobject-Type-Information.html#G-TYPE-NONE--CAPS" title="G_TYPE_NONE"><span class="type">G_TYPE_NONE</span></a>, the return value location can be omitted.
2430
2991
</td>
2431
2992
</tr>
2432
2993
</tbody>
2436
2997
<hr>
2437
2998
<div class="refsect2" title="g_signal_add_emission_hook ()">
2438
2999
<a name="g-signal-add-emission-hook"></a><h3>g_signal_add_emission_hook ()</h3>
2439
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> g_signal_add_emission_hook (<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
2440
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> detail,
2441
<a class="link" href="gobject-Signals.html#GSignalEmissionHook" title="GSignalEmissionHook ()"><span class="returnvalue">GSignalEmissionHook</span></a> hook_func,
2442
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> hook_data,
2443
<a href="./../glib/glib/glib-Datasets.html#GDestroyNotify"><span class="returnvalue">GDestroyNotify</span></a> data_destroy);</pre>
3000
<pre class="programlisting"><a
3001
href="./../glib/glib/glib-Basic-Types.html#gulong"
3002
>gulong</a> g_signal_add_emission_hook (<a
3003
href="./../glib/glib/glib-Basic-Types.html#guint"
3004
>guint</a> signal_id,
3005
<a
3006
href="./../glib/glib/glib-Quarks.html#GQuark"
3007
>GQuark</a> detail,
3008
<a class="link" href="gobject-Signals.html#GSignalEmissionHook" title="GSignalEmissionHook ()">GSignalEmissionHook</a> hook_func,
3009
<a
3010
href="./../glib/glib/glib-Basic-Types.html#gpointer"
3011
>gpointer</a> hook_data,
3012
<a
3013
href="./../glib/glib/glib-Datasets.html#GDestroyNotify"
3014
>GDestroyNotify</a> data_destroy);</pre>
2444
3015
<p>
2445
3016
Adds an emission hook for a signal, which will get called for any emission
2446
3017
of that signal, independent of the instance. This is possible only
2447
for signals which don't have <a class="link" href="gobject-Signals.html#G-SIGNAL-NO-HOOKS:CAPS"><span class="type">G_SIGNAL_NO_HOOKS</span></a> flag set.</p>
3018
for signals which don't have <a class="link" href="gobject-Signals.html#G-SIGNAL-NO-HOOKS--CAPS"><span class="type">G_SIGNAL_NO_HOOKS</span></a> flag set.</p>
3019
<p>
3020
</p>
2448
3021
<div class="variablelist"><table border="0">
2449
3022
<col align="left" valign="top">
2450
3023
<tbody>
2470
3043
</tr>
2471
3044
<tr>
2472
3045
<td><p><span class="term"><em class="parameter"><code>data_destroy</code></em> :</span></p></td>
2473
<td> a <a href="./../glib/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> for <em class="parameter"><code>hook_data</code></em>.
3046
<td> a <a
3047
href="./../glib/glib/glib-Datasets.html#GDestroyNotify"
3048
><span class="type">GDestroyNotify</span></a> for <em class="parameter"><code>hook_data</code></em>.
2474
3049
</td>
2475
3050
</tr>
2476
3051
<tr>
2484
3059
<hr>
2485
3060
<div class="refsect2" title="g_signal_remove_emission_hook ()">
2486
3061
<a name="g-signal-remove-emission-hook"></a><h3>g_signal_remove_emission_hook ()</h3>
2487
<pre class="programlisting"><span class="returnvalue">void</span> g_signal_remove_emission_hook (<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> signal_id,
2488
<a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> hook_id);</pre>
3062
<pre class="programlisting">void g_signal_remove_emission_hook (<a
3063
href="./../glib/glib/glib-Basic-Types.html#guint"
3064
>guint</a> signal_id,
3065
<a
3066
href="./../glib/glib/glib-Basic-Types.html#gulong"
3067
>gulong</a> hook_id);</pre>
2489
3068
<p>
2490
3069
Deletes an emission hook.</p>
3070
<p>
3071
</p>
2491
3072
<div class="variablelist"><table border="0">
2492
3073
<col align="left" valign="top">
2493
3074
<tbody>
2508
3089
<hr>
2509
3090
<div class="refsect2" title="g_signal_parse_name ()">
2510
3091
<a name="g-signal-parse-name"></a><h3>g_signal_parse_name ()</h3>
2511
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_signal_parse_name (const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *detailed_signal,
2512
<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> itype,
2513
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> *signal_id_p,
2514
<a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a> *detail_p,
2515
<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> force_detail_quark);</pre>
3092
<pre class="programlisting"><a
3093
href="./../glib/glib/glib-Basic-Types.html#gboolean"
3094
>gboolean</a> g_signal_parse_name (const <a
3095
href="./../glib/glib/glib-Basic-Types.html#gchar"
3096
>gchar</a> *detailed_signal,
3097
<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype,
3098
<a
3099
href="./../glib/glib/glib-Basic-Types.html#guint"
3100
>guint</a> *signal_id_p,
3101
<a
3102
href="./../glib/glib/glib-Quarks.html#GQuark"
3103
>GQuark</a> *detail_p,
3104
<a
3105
href="./../glib/glib/glib-Basic-Types.html#gboolean"
3106
>gboolean</a> force_detail_quark);</pre>
2516
3107
<p>
2517
3108
Internal function to parse a signal name into its <em class="parameter"><code>signal_id</code></em>
2518
3109
and <em class="parameter"><code>detail</code></em> quark.</p>
3110
<p>
3111
</p>
2519
3112
<div class="variablelist"><table border="0">
2520
3113
<col align="left" valign="top">
2521
3114
<tbody>
2541
3134
</tr>
2542
3135
<tr>
2543
3136
<td><p><span class="term"><em class="parameter"><code>force_detail_quark</code></em> :</span></p></td>
2544
<td> <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> forces creation of a <a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> for the detail.
3137
<td> <a
3138
href="./../glib/glib/glib-Standard-Macros.html#TRUE--CAPS"
3139
><code class="literal">TRUE</code></a> forces creation of a <a
3140
href="./../glib/glib/glib-Quarks.html#GQuark"
3141
><span class="type">GQuark</span></a> for the detail.
2545
3142
</td>
2546
3143
</tr>
2547
3144
<tr>
2555
3152
<hr>
2556
3153
<div class="refsect2" title="g_signal_get_invocation_hint ()">
2557
3154
<a name="g-signal-get-invocation-hint"></a><h3>g_signal_get_invocation_hint ()</h3>
2558
<pre class="programlisting"><a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="returnvalue">GSignalInvocationHint</span></a>* g_signal_get_invocation_hint (<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> instance);</pre>
3155
<pre class="programlisting"><a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint">GSignalInvocationHint</a>* g_signal_get_invocation_hint (<a
3156
href="./../glib/glib/glib-Basic-Types.html#gpointer"
3157
>gpointer</a> instance);</pre>
2559
3158
<p>
2560
3159
Returns the invocation hint of the innermost signal emission of instance.</p>
3160
<p>
3161
</p>
2561
3162
<div class="variablelist"><table border="0">
2562
3163
<col align="left" valign="top">
2563
3164
<tbody>
2577
3178
<hr>
2578
3179
<div class="refsect2" title="g_signal_type_cclosure_new ()">
2579
3180
<a name="g-signal-type-cclosure-new"></a><h3>g_signal_type_cclosure_new ()</h3>
2580
<pre class="programlisting"><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a>* g_signal_type_cclosure_new (<a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="returnvalue">GType</span></a> itype,
2581
<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> struct_offset);</pre>
3181
<pre class="programlisting"><a class="link" href="gobject-Closures.html#GClosure" title="GClosure">GClosure</a>* g_signal_type_cclosure_new (<a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype,
3182
<a
3183
href="./../glib/glib/glib-Basic-Types.html#guint"
3184
>guint</a> struct_offset);</pre>
2582
3185
<p>
2583
3186
Creates a new closure which invokes the function found at the offset
2584
3187
<em class="parameter"><code>struct_offset</code></em> in the class structure of the interface or classed type
2585
3188
identified by <em class="parameter"><code>itype</code></em>.</p>
3189
<p>
3190
</p>
2586
3191
<div class="variablelist"><table border="0">
2587
3192
<col align="left" valign="top">
2588
3193
<tbody>
2608
3213
<hr>
2609
3214
<div class="refsect2" title="g_signal_accumulator_true_handled ()">
2610
3215
<a name="g-signal-accumulator-true-handled"></a><h3>g_signal_accumulator_true_handled ()</h3>
2611
<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_signal_accumulator_true_handled (<a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="returnvalue">GSignalInvocationHint</span></a> *ihint,
2612
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *return_accu,
2613
const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *handler_return,
2614
<a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> dummy);</pre>
3216
<pre class="programlisting"><a
3217
href="./../glib/glib/glib-Basic-Types.html#gboolean"
3218
>gboolean</a> g_signal_accumulator_true_handled (<a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint">GSignalInvocationHint</a> *ihint,
3219
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *return_accu,
3220
const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *handler_return,
3221
<a
3222
href="./../glib/glib/glib-Basic-Types.html#gpointer"
3223
>gpointer</a> dummy);</pre>
2615
3224
<p>
2616
3225
A predefined <a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="type">GSignalAccumulator</span></a> for signals that return a
2617
3226
boolean values. The behavior that this accumulator gives is
2618
that a return of <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> stops the signal emission: no further
2619
callbacks will be invoked, while a return of <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> allows
2620
the emission to coninue. The idea here is that a <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> return
3227
that a return of <a
3228
href="./../glib/glib/glib-Standard-Macros.html#TRUE--CAPS"
3229
><code class="literal">TRUE</code></a> stops the signal emission: no further
3230
callbacks will be invoked, while a return of <a
3231
href="./../glib/glib/glib-Standard-Macros.html#FALSE--CAPS"
3232
><code class="literal">FALSE</code></a> allows
3233
the emission to coninue. The idea here is that a <a
3234
href="./../glib/glib/glib-Standard-Macros.html#TRUE--CAPS"
3235
><code class="literal">TRUE</code></a> return
2621
3236
indicates that the callback <span class="emphasis"><em>handled</em></span> the signal,
2622
3237
and no further handling is needed.</p>
3238
<p>
3239
</p>
2623
3240
<div class="variablelist"><table border="0">
2624
3241
<col align="left" valign="top">
2625
3242
<tbody>
2655
3272
</div>
2656
3273
<div class="footnotes">
2657
3274
<br><hr width="100" align="left">
2658
<div class="footnote"><p><sup>[<a name="ftn.id600720" href="#id600720" class="para">10</a>] </sup>Although signals can deal with any kind of instantiatable
3275
<div class="footnote"><p><sup>[<a name="ftn.id607665" href="#id607665" class="para">10</a>] </sup>Although signals can deal with any kind of instantiatable
2659
3276
type, i'm referring to those types as "object types" in the following,
2660
3277
simply because that is the context most users will encounter signals in.
2661
3278
</p></div>
2663
3280
</div>
2664
3281
<div class="footer">
2665
3282
<hr>
2666
Generated by GTK-Doc V1.13</div>
3283
Generated by GTK-Doc V1.11</div>
2667
3284
</body>
2668
</html>
b'\\ No newline at end of file'
3285
</html>
Loggerhead is a web-based interface for Breezy
Version: 2.0.1