atk 0.90.5-x86-mingw32 → 0.90.6-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (765) hide show
  1. data/ChangeLog +9 -0
  2. data/Rakefile +8 -70
  3. data/ext/atk/Makefile +160 -0
  4. data/ext/atk/extconf.rb +9 -9
  5. data/ext/atk/rbatkversion.h +24 -0
  6. data/lib/1.8/atk.so +0 -0
  7. data/lib/1.9/atk.so +0 -0
  8. data/vendor/local/lib/pkgconfig/atk.pc +1 -1
  9. metadata +150 -902
  10. data/vendor/local/bin/envsubst.exe +0 -0
  11. data/vendor/local/bin/gettext.exe +0 -0
  12. data/vendor/local/bin/gettext.sh +0 -123
  13. data/vendor/local/bin/glib-genmarshal.exe +0 -0
  14. data/vendor/local/bin/glib-gettextize +0 -188
  15. data/vendor/local/bin/glib-mkenums +0 -537
  16. data/vendor/local/bin/gobject-query.exe +0 -0
  17. data/vendor/local/bin/gspawn-win32-helper-console.exe +0 -0
  18. data/vendor/local/bin/gspawn-win32-helper.exe +0 -0
  19. data/vendor/local/bin/intl.dll +0 -0
  20. data/vendor/local/bin/libasprintf-0.dll +0 -0
  21. data/vendor/local/bin/libgcc_s_dw2-1.dll +0 -0
  22. data/vendor/local/bin/libgio-2.0-0.dll +0 -0
  23. data/vendor/local/bin/libglib-2.0-0.dll +0 -0
  24. data/vendor/local/bin/libgmodule-2.0-0.dll +0 -0
  25. data/vendor/local/bin/libgobject-2.0-0.dll +0 -0
  26. data/vendor/local/bin/libgthread-2.0-0.dll +0 -0
  27. data/vendor/local/bin/ngettext.exe +0 -0
  28. data/vendor/local/include/autosprintf.h +0 -66
  29. data/vendor/local/include/glib-2.0/gio/gappinfo.h +0 -236
  30. data/vendor/local/include/glib-2.0/gio/gasyncinitable.h +0 -119
  31. data/vendor/local/include/glib-2.0/gio/gasyncresult.h +0 -73
  32. data/vendor/local/include/glib-2.0/gio/gbufferedinputstream.h +0 -123
  33. data/vendor/local/include/glib-2.0/gio/gbufferedoutputstream.h +0 -81
  34. data/vendor/local/include/glib-2.0/gio/gcancellable.h +0 -103
  35. data/vendor/local/include/glib-2.0/gio/gcharsetconverter.h +0 -60
  36. data/vendor/local/include/glib-2.0/gio/gcontenttype.h +0 -57
  37. data/vendor/local/include/glib-2.0/gio/gconverter.h +0 -95
  38. data/vendor/local/include/glib-2.0/gio/gconverterinputstream.h +0 -79
  39. data/vendor/local/include/glib-2.0/gio/gconverteroutputstream.h +0 -79
  40. data/vendor/local/include/glib-2.0/gio/gcredentials.h +0 -76
  41. data/vendor/local/include/glib-2.0/gio/gdatainputstream.h +0 -150
  42. data/vendor/local/include/glib-2.0/gio/gdataoutputstream.h +0 -115
  43. data/vendor/local/include/glib-2.0/gio/gdbusaddress.h +0 -58
  44. data/vendor/local/include/glib-2.0/gio/gdbusauthobserver.h +0 -46
  45. data/vendor/local/include/glib-2.0/gio/gdbusconnection.h +0 -562
  46. data/vendor/local/include/glib-2.0/gio/gdbuserror.h +0 -100
  47. data/vendor/local/include/glib-2.0/gio/gdbusintrospection.h +0 -286
  48. data/vendor/local/include/glib-2.0/gio/gdbusmessage.h +0 -149
  49. data/vendor/local/include/glib-2.0/gio/gdbusmethodinvocation.h +0 -73
  50. data/vendor/local/include/glib-2.0/gio/gdbusnameowning.h +0 -112
  51. data/vendor/local/include/glib-2.0/gio/gdbusnamewatching.h +0 -94
  52. data/vendor/local/include/glib-2.0/gio/gdbusproxy.h +0 -167
  53. data/vendor/local/include/glib-2.0/gio/gdbusserver.h +0 -54
  54. data/vendor/local/include/glib-2.0/gio/gdbusutils.h +0 -44
  55. data/vendor/local/include/glib-2.0/gio/gdrive.h +0 -225
  56. data/vendor/local/include/glib-2.0/gio/gemblem.h +0 -58
  57. data/vendor/local/include/glib-2.0/gio/gemblemedicon.h +0 -62
  58. data/vendor/local/include/glib-2.0/gio/gfile.h +0 -1017
  59. data/vendor/local/include/glib-2.0/gio/gfileattribute.h +0 -77
  60. data/vendor/local/include/glib-2.0/gio/gfileenumerator.h +0 -132
  61. data/vendor/local/include/glib-2.0/gio/gfileicon.h +0 -56
  62. data/vendor/local/include/glib-2.0/gio/gfileinfo.h +0 -952
  63. data/vendor/local/include/glib-2.0/gio/gfileinputstream.h +0 -112
  64. data/vendor/local/include/glib-2.0/gio/gfileiostream.h +0 -118
  65. data/vendor/local/include/glib-2.0/gio/gfilemonitor.h +0 -95
  66. data/vendor/local/include/glib-2.0/gio/gfilenamecompleter.h +0 -76
  67. data/vendor/local/include/glib-2.0/gio/gfileoutputstream.h +0 -119
  68. data/vendor/local/include/glib-2.0/gio/gfilterinputstream.h +0 -76
  69. data/vendor/local/include/glib-2.0/gio/gfilteroutputstream.h +0 -76
  70. data/vendor/local/include/glib-2.0/gio/gicon.h +0 -91
  71. data/vendor/local/include/glib-2.0/gio/ginetaddress.h +0 -103
  72. data/vendor/local/include/glib-2.0/gio/ginetsocketaddress.h +0 -69
  73. data/vendor/local/include/glib-2.0/gio/ginitable.h +0 -96
  74. data/vendor/local/include/glib-2.0/gio/ginputstream.h +0 -172
  75. data/vendor/local/include/glib-2.0/gio/gio.h +0 -122
  76. data/vendor/local/include/glib-2.0/gio/gioenums.h +0 -1221
  77. data/vendor/local/include/glib-2.0/gio/gioenumtypes.h +0 -121
  78. data/vendor/local/include/glib-2.0/gio/gioerror.h +0 -52
  79. data/vendor/local/include/glib-2.0/gio/giomodule.h +0 -132
  80. data/vendor/local/include/glib-2.0/gio/gioscheduler.h +0 -52
  81. data/vendor/local/include/glib-2.0/gio/giostream.h +0 -112
  82. data/vendor/local/include/glib-2.0/gio/giotypes.h +0 -375
  83. data/vendor/local/include/glib-2.0/gio/gloadableicon.h +0 -97
  84. data/vendor/local/include/glib-2.0/gio/gmemoryinputstream.h +0 -82
  85. data/vendor/local/include/glib-2.0/gio/gmemoryoutputstream.h +0 -98
  86. data/vendor/local/include/glib-2.0/gio/gmount.h +0 -242
  87. data/vendor/local/include/glib-2.0/gio/gmountoperation.h +0 -123
  88. data/vendor/local/include/glib-2.0/gio/gnativevolumemonitor.h +0 -62
  89. data/vendor/local/include/glib-2.0/gio/gnetworkaddress.h +0 -73
  90. data/vendor/local/include/glib-2.0/gio/gnetworkservice.h +0 -71
  91. data/vendor/local/include/glib-2.0/gio/goutputstream.h +0 -207
  92. data/vendor/local/include/glib-2.0/gio/gpermission.h +0 -118
  93. data/vendor/local/include/glib-2.0/gio/gproxy.h +0 -123
  94. data/vendor/local/include/glib-2.0/gio/gproxyaddress.h +0 -76
  95. data/vendor/local/include/glib-2.0/gio/gproxyaddressenumerator.h +0 -75
  96. data/vendor/local/include/glib-2.0/gio/gproxyresolver.h +0 -96
  97. data/vendor/local/include/glib-2.0/gio/gresolver.h +0 -167
  98. data/vendor/local/include/glib-2.0/gio/gseekable.h +0 -99
  99. data/vendor/local/include/glib-2.0/gio/gsettings.h +0 -258
  100. data/vendor/local/include/glib-2.0/gio/gsettingsbackend.h +0 -138
  101. data/vendor/local/include/glib-2.0/gio/gsimpleasyncresult.h +0 -125
  102. data/vendor/local/include/glib-2.0/gio/gsimplepermission.h +0 -45
  103. data/vendor/local/include/glib-2.0/gio/gsocket.h +0 -194
  104. data/vendor/local/include/glib-2.0/gio/gsocketaddress.h +0 -79
  105. data/vendor/local/include/glib-2.0/gio/gsocketaddressenumerator.h +0 -89
  106. data/vendor/local/include/glib-2.0/gio/gsocketclient.h +0 -152
  107. data/vendor/local/include/glib-2.0/gio/gsocketconnectable.h +0 -74
  108. data/vendor/local/include/glib-2.0/gio/gsocketconnection.h +0 -91
  109. data/vendor/local/include/glib-2.0/gio/gsocketcontrolmessage.h +0 -105
  110. data/vendor/local/include/glib-2.0/gio/gsocketlistener.h +0 -138
  111. data/vendor/local/include/glib-2.0/gio/gsocketservice.h +0 -88
  112. data/vendor/local/include/glib-2.0/gio/gsrvtarget.h +0 -52
  113. data/vendor/local/include/glib-2.0/gio/gtcpconnection.h +0 -68
  114. data/vendor/local/include/glib-2.0/gio/gthemedicon.h +0 -63
  115. data/vendor/local/include/glib-2.0/gio/gthreadedsocketservice.h +0 -81
  116. data/vendor/local/include/glib-2.0/gio/gvfs.h +0 -125
  117. data/vendor/local/include/glib-2.0/gio/gvolume.h +0 -211
  118. data/vendor/local/include/glib-2.0/gio/gvolumemonitor.h +0 -150
  119. data/vendor/local/include/glib-2.0/gio/gzlibcompressor.h +0 -60
  120. data/vendor/local/include/glib-2.0/gio/gzlibdecompressor.h +0 -57
  121. data/vendor/local/include/glib-2.0/glib-object.h +0 -42
  122. data/vendor/local/include/glib-2.0/glib.h +0 -99
  123. data/vendor/local/include/glib-2.0/glib/galloca.h +0 -110
  124. data/vendor/local/include/glib-2.0/glib/garray.h +0 -179
  125. data/vendor/local/include/glib-2.0/glib/gasyncqueue.h +0 -120
  126. data/vendor/local/include/glib-2.0/glib/gatomic.h +0 -105
  127. data/vendor/local/include/glib-2.0/glib/gbacktrace.h +0 -68
  128. data/vendor/local/include/glib-2.0/glib/gbase64.h +0 -57
  129. data/vendor/local/include/glib-2.0/glib/gbitlock.h +0 -43
  130. data/vendor/local/include/glib-2.0/glib/gbookmarkfile.h +0 -215
  131. data/vendor/local/include/glib-2.0/glib/gcache.h +0 -69
  132. data/vendor/local/include/glib-2.0/glib/gchecksum.h +0 -86
  133. data/vendor/local/include/glib-2.0/glib/gcompletion.h +0 -81
  134. data/vendor/local/include/glib-2.0/glib/gconvert.h +0 -162
  135. data/vendor/local/include/glib-2.0/glib/gdataset.h +0 -122
  136. data/vendor/local/include/glib-2.0/glib/gdate.h +0 -263
  137. data/vendor/local/include/glib-2.0/glib/gdatetime.h +0 -217
  138. data/vendor/local/include/glib-2.0/glib/gdir.h +0 -52
  139. data/vendor/local/include/glib-2.0/glib/gerror.h +0 -98
  140. data/vendor/local/include/glib-2.0/glib/gfileutils.h +0 -128
  141. data/vendor/local/include/glib-2.0/glib/ghash.h +0 -166
  142. data/vendor/local/include/glib-2.0/glib/ghook.h +0 -181
  143. data/vendor/local/include/glib-2.0/glib/ghostutils.h +0 -40
  144. data/vendor/local/include/glib-2.0/glib/gi18n-lib.h +0 -38
  145. data/vendor/local/include/glib-2.0/glib/gi18n.h +0 -34
  146. data/vendor/local/include/glib-2.0/glib/giochannel.h +0 -366
  147. data/vendor/local/include/glib-2.0/glib/gkeyfile.h +0 -266
  148. data/vendor/local/include/glib-2.0/glib/glist.h +0 -120
  149. data/vendor/local/include/glib-2.0/glib/gmacros.h +0 -284
  150. data/vendor/local/include/glib-2.0/glib/gmain.h +0 -531
  151. data/vendor/local/include/glib-2.0/glib/gmappedfile.h +0 -49
  152. data/vendor/local/include/glib-2.0/glib/gmarkup.h +0 -163
  153. data/vendor/local/include/glib-2.0/glib/gmem.h +0 -309
  154. data/vendor/local/include/glib-2.0/glib/gmessages.h +0 -343
  155. data/vendor/local/include/glib-2.0/glib/gnode.h +0 -290
  156. data/vendor/local/include/glib-2.0/glib/goption.h +0 -370
  157. data/vendor/local/include/glib-2.0/glib/gpattern.h +0 -49
  158. data/vendor/local/include/glib-2.0/glib/gpoll.h +0 -117
  159. data/vendor/local/include/glib-2.0/glib/gprimes.h +0 -51
  160. data/vendor/local/include/glib-2.0/glib/gprintf.h +0 -52
  161. data/vendor/local/include/glib-2.0/glib/gqsort.h +0 -46
  162. data/vendor/local/include/glib-2.0/glib/gquark.h +0 -52
  163. data/vendor/local/include/glib-2.0/glib/gqueue.h +0 -127
  164. data/vendor/local/include/glib-2.0/glib/grand.h +0 -85
  165. data/vendor/local/include/glib-2.0/glib/gregex.h +0 -471
  166. data/vendor/local/include/glib-2.0/glib/grel.h +0 -101
  167. data/vendor/local/include/glib-2.0/glib/gscanner.h +0 -278
  168. data/vendor/local/include/glib-2.0/glib/gsequence.h +0 -128
  169. data/vendor/local/include/glib-2.0/glib/gshell.h +0 -55
  170. data/vendor/local/include/glib-2.0/glib/gslice.h +0 -86
  171. data/vendor/local/include/glib-2.0/glib/gslist.h +0 -114
  172. data/vendor/local/include/glib-2.0/glib/gspawn.h +0 -139
  173. data/vendor/local/include/glib-2.0/glib/gstdio.h +0 -147
  174. data/vendor/local/include/glib-2.0/glib/gstrfuncs.h +0 -269
  175. data/vendor/local/include/glib-2.0/glib/gstring.h +0 -178
  176. data/vendor/local/include/glib-2.0/glib/gtestutils.h +0 -297
  177. data/vendor/local/include/glib-2.0/glib/gthread.h +0 -407
  178. data/vendor/local/include/glib-2.0/glib/gthreadpool.h +0 -114
  179. data/vendor/local/include/glib-2.0/glib/gtimer.h +0 -65
  180. data/vendor/local/include/glib-2.0/glib/gtimezone.h +0 -44
  181. data/vendor/local/include/glib-2.0/glib/gtree.h +0 -91
  182. data/vendor/local/include/glib-2.0/glib/gtypes.h +0 -451
  183. data/vendor/local/include/glib-2.0/glib/gunicode.h +0 -421
  184. data/vendor/local/include/glib-2.0/glib/gurifuncs.h +0 -81
  185. data/vendor/local/include/glib-2.0/glib/gutils.h +0 -490
  186. data/vendor/local/include/glib-2.0/glib/gvariant.h +0 -248
  187. data/vendor/local/include/glib-2.0/glib/gvarianttype.h +0 -334
  188. data/vendor/local/include/glib-2.0/glib/gwin32.h +0 -114
  189. data/vendor/local/include/glib-2.0/gmodule.h +0 -101
  190. data/vendor/local/include/glib-2.0/gobject/gbinding.h +0 -136
  191. data/vendor/local/include/glib-2.0/gobject/gboxed.h +0 -248
  192. data/vendor/local/include/glib-2.0/gobject/gclosure.h +0 -251
  193. data/vendor/local/include/glib-2.0/gobject/genums.h +0 -261
  194. data/vendor/local/include/glib-2.0/gobject/gmarshal.h +0 -186
  195. data/vendor/local/include/glib-2.0/gobject/gobject.h +0 -567
  196. data/vendor/local/include/glib-2.0/gobject/gobjectnotifyqueue.c +0 -193
  197. data/vendor/local/include/glib-2.0/gobject/gparam.h +0 -415
  198. data/vendor/local/include/glib-2.0/gobject/gparamspecs.h +0 -1137
  199. data/vendor/local/include/glib-2.0/gobject/gsignal.h +0 -509
  200. data/vendor/local/include/glib-2.0/gobject/gsourceclosure.h +0 -51
  201. data/vendor/local/include/glib-2.0/gobject/gtype.h +0 -1736
  202. data/vendor/local/include/glib-2.0/gobject/gtypemodule.h +0 -263
  203. data/vendor/local/include/glib-2.0/gobject/gtypeplugin.h +0 -134
  204. data/vendor/local/include/glib-2.0/gobject/gvalue.h +0 -159
  205. data/vendor/local/include/glib-2.0/gobject/gvaluearray.h +0 -77
  206. data/vendor/local/include/glib-2.0/gobject/gvaluecollector.h +0 -227
  207. data/vendor/local/include/glib-2.0/gobject/gvaluetypes.h +0 -260
  208. data/vendor/local/include/libintl.h +0 -464
  209. data/vendor/local/lib/GNU.Gettext.dll +0 -0
  210. data/vendor/local/lib/gio-2.0.def +0 -1143
  211. data/vendor/local/lib/gio-2.0.lib +0 -0
  212. data/vendor/local/lib/glib-2.0.def +0 -1452
  213. data/vendor/local/lib/glib-2.0.lib +0 -0
  214. data/vendor/local/lib/glib-2.0/include/glibconfig.h +0 -284
  215. data/vendor/local/lib/gmodule-2.0.def +0 -11
  216. data/vendor/local/lib/gmodule-2.0.lib +0 -0
  217. data/vendor/local/lib/gobject-2.0.def +0 -370
  218. data/vendor/local/lib/gobject-2.0.lib +0 -0
  219. data/vendor/local/lib/gthread-2.0.def +0 -3
  220. data/vendor/local/lib/gthread-2.0.lib +0 -0
  221. data/vendor/local/lib/intl.lib +0 -0
  222. data/vendor/local/lib/libasprintf.dll.a +0 -0
  223. data/vendor/local/lib/libgio-2.0.dll.a +0 -0
  224. data/vendor/local/lib/libglib-2.0.dll.a +0 -0
  225. data/vendor/local/lib/libgmodule-2.0.dll.a +0 -0
  226. data/vendor/local/lib/libgobject-2.0.dll.a +0 -0
  227. data/vendor/local/lib/libgthread-2.0.dll.a +0 -0
  228. data/vendor/local/lib/libintl.def +0 -31
  229. data/vendor/local/lib/libintl.dll.a +0 -0
  230. data/vendor/local/lib/pkgconfig/gio-2.0.pc +0 -15
  231. data/vendor/local/lib/pkgconfig/gio-windows-2.0.pc +0 -11
  232. data/vendor/local/lib/pkgconfig/glib-2.0.pc +0 -15
  233. data/vendor/local/lib/pkgconfig/gmodule-2.0.pc +0 -14
  234. data/vendor/local/lib/pkgconfig/gmodule-no-export-2.0.pc +0 -14
  235. data/vendor/local/lib/pkgconfig/gobject-2.0.pc +0 -11
  236. data/vendor/local/lib/pkgconfig/gthread-2.0.pc +0 -11
  237. data/vendor/local/manifest/gettext-runtime-dev_0.18.1.1-2_win32.mft +0 -81
  238. data/vendor/local/manifest/gettext-runtime_0.18.1.1-2_win32.mft +0 -3
  239. data/vendor/local/manifest/glib-dev_2.26.0-2_win32.mft +0 -570
  240. data/vendor/local/manifest/glib_2.26.0-2_win32.mft +0 -102
  241. data/vendor/local/share/aclocal/glib-2.0.m4 +0 -211
  242. data/vendor/local/share/aclocal/glib-gettext.m4 +0 -432
  243. data/vendor/local/share/doc/gettext/bind_textdomain_codeset.3.html +0 -165
  244. data/vendor/local/share/doc/gettext/bindtextdomain.3.html +0 -160
  245. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext.html +0 -8
  246. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext_GettextResourceManager.html +0 -305
  247. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext_GettextResourceSet.html +0 -356
  248. data/vendor/local/share/doc/gettext/csharpdoc/begin.html +0 -11
  249. data/vendor/local/share/doc/gettext/csharpdoc/index.html +0 -10
  250. data/vendor/local/share/doc/gettext/csharpdoc/namespaces.html +0 -6
  251. data/vendor/local/share/doc/gettext/envsubst.1.html +0 -213
  252. data/vendor/local/share/doc/gettext/gettext.1.html +0 -266
  253. data/vendor/local/share/doc/gettext/gettext.3.html +0 -186
  254. data/vendor/local/share/doc/gettext/ngettext.1.html +0 -280
  255. data/vendor/local/share/doc/gettext/ngettext.3.html +0 -143
  256. data/vendor/local/share/doc/gettext/textdomain.3.html +0 -150
  257. data/vendor/local/share/doc/glib-2.26.0/COPYING +0 -482
  258. data/vendor/local/share/doc/glib-dev-2.26.0/COPYING +0 -482
  259. data/vendor/local/share/doc/libasprintf/autosprintf_all.html +0 -174
  260. data/vendor/local/share/glib-2.0/gdb/glib.py +0 -249
  261. data/vendor/local/share/glib-2.0/gdb/gobject.py +0 -305
  262. data/vendor/local/share/glib-2.0/gettext/mkinstalldirs +0 -111
  263. data/vendor/local/share/glib-2.0/gettext/po/Makefile.in.in +0 -279
  264. data/vendor/local/share/glib-2.0/schemas/gschema.dtd +0 -60
  265. data/vendor/local/share/gtk-doc/html/gio/GAppInfo.html +0 -1403
  266. data/vendor/local/share/gtk-doc/html/gio/GAsyncInitable.html +0 -733
  267. data/vendor/local/share/gtk-doc/html/gio/GAsyncResult.html +0 -343
  268. data/vendor/local/share/gtk-doc/html/gio/GBufferedInputStream.html +0 -563
  269. data/vendor/local/share/gtk-doc/html/gio/GBufferedOutputStream.html +0 -291
  270. data/vendor/local/share/gtk-doc/html/gio/GCancellable.html +0 -620
  271. data/vendor/local/share/gtk-doc/html/gio/GCharsetConverter.html +0 -245
  272. data/vendor/local/share/gtk-doc/html/gio/GConverter.html +0 -423
  273. data/vendor/local/share/gtk-doc/html/gio/GCredentials.html +0 -398
  274. data/vendor/local/share/gtk-doc/html/gio/GDBusAuthObserver.html +0 -254
  275. data/vendor/local/share/gtk-doc/html/gio/GDBusConnection.html +0 -6211
  276. data/vendor/local/share/gtk-doc/html/gio/GDBusMessage.html +0 -1833
  277. data/vendor/local/share/gtk-doc/html/gio/GDBusMethodInvocation.html +0 -618
  278. data/vendor/local/share/gtk-doc/html/gio/GDBusProxy.html +0 -2050
  279. data/vendor/local/share/gtk-doc/html/gio/GDBusServer.html +0 -1124
  280. data/vendor/local/share/gtk-doc/html/gio/GDataInputStream.html +0 -1215
  281. data/vendor/local/share/gtk-doc/html/gio/GDataOutputStream.html +0 -540
  282. data/vendor/local/share/gtk-doc/html/gio/GDrive.html +0 -1416
  283. data/vendor/local/share/gtk-doc/html/gio/GEmblem.html +0 -272
  284. data/vendor/local/share/gtk-doc/html/gio/GEmblemedIcon.html +0 -206
  285. data/vendor/local/share/gtk-doc/html/gio/GFile.html +0 -7462
  286. data/vendor/local/share/gtk-doc/html/gio/GFileDescriptorBased.html +0 -120
  287. data/vendor/local/share/gtk-doc/html/gio/GFileEnumerator.html +0 -516
  288. data/vendor/local/share/gtk-doc/html/gio/GFileIOStream.html +0 -312
  289. data/vendor/local/share/gtk-doc/html/gio/GFileIcon.html +0 -155
  290. data/vendor/local/share/gtk-doc/html/gio/GFileInfo.html +0 -3144
  291. data/vendor/local/share/gtk-doc/html/gio/GFileInputStream.html +0 -262
  292. data/vendor/local/share/gtk-doc/html/gio/GFileMonitor.html +0 -353
  293. data/vendor/local/share/gtk-doc/html/gio/GFileOutputStream.html +0 -301
  294. data/vendor/local/share/gtk-doc/html/gio/GFilenameCompleter.html +0 -217
  295. data/vendor/local/share/gtk-doc/html/gio/GFilterInputStream.html +0 -188
  296. data/vendor/local/share/gtk-doc/html/gio/GFilterOutputStream.html +0 -189
  297. data/vendor/local/share/gtk-doc/html/gio/GIOModule.html +0 -261
  298. data/vendor/local/share/gtk-doc/html/gio/GIOStream.html +0 -479
  299. data/vendor/local/share/gtk-doc/html/gio/GIcon.html +0 -331
  300. data/vendor/local/share/gtk-doc/html/gio/GInetAddress.html +0 -717
  301. data/vendor/local/share/gtk-doc/html/gio/GInetSocketAddress.html +0 -196
  302. data/vendor/local/share/gtk-doc/html/gio/GInitable.html +0 -388
  303. data/vendor/local/share/gtk-doc/html/gio/GInputStream.html +0 -808
  304. data/vendor/local/share/gtk-doc/html/gio/GLoadableIcon.html +0 -301
  305. data/vendor/local/share/gtk-doc/html/gio/GMemoryInputStream.html +0 -185
  306. data/vendor/local/share/gtk-doc/html/gio/GMemoryOutputStream.html +0 -393
  307. data/vendor/local/share/gtk-doc/html/gio/GMount.html +0 -1465
  308. data/vendor/local/share/gtk-doc/html/gio/GMountOperation.html +0 -848
  309. data/vendor/local/share/gtk-doc/html/gio/GNetworkAddress.html +0 -343
  310. data/vendor/local/share/gtk-doc/html/gio/GNetworkService.html +0 -311
  311. data/vendor/local/share/gtk-doc/html/gio/GOutputStream.html +0 -1012
  312. data/vendor/local/share/gtk-doc/html/gio/GPermission.html +0 -560
  313. data/vendor/local/share/gtk-doc/html/gio/GProxy.html +0 -312
  314. data/vendor/local/share/gtk-doc/html/gio/GProxyAddress.html +0 -348
  315. data/vendor/local/share/gtk-doc/html/gio/GProxyResolver.html +0 -301
  316. data/vendor/local/share/gtk-doc/html/gio/GResolver.html +0 -787
  317. data/vendor/local/share/gtk-doc/html/gio/GSeekable.html +0 -350
  318. data/vendor/local/share/gtk-doc/html/gio/GSettings.html +0 -2424
  319. data/vendor/local/share/gtk-doc/html/gio/GSettingsBackend.html +0 -609
  320. data/vendor/local/share/gtk-doc/html/gio/GSimpleAsyncResult.html +0 -1193
  321. data/vendor/local/share/gtk-doc/html/gio/GSimplePermission.html +0 -107
  322. data/vendor/local/share/gtk-doc/html/gio/GSocket.html +0 -2438
  323. data/vendor/local/share/gtk-doc/html/gio/GSocketAddress.html +0 -297
  324. data/vendor/local/share/gtk-doc/html/gio/GSocketClient.html +0 -1292
  325. data/vendor/local/share/gtk-doc/html/gio/GSocketConnectable.html +0 -513
  326. data/vendor/local/share/gtk-doc/html/gio/GSocketConnection.html +0 -337
  327. data/vendor/local/share/gtk-doc/html/gio/GSocketControlMessage.html +0 -275
  328. data/vendor/local/share/gtk-doc/html/gio/GSocketListener.html +0 -745
  329. data/vendor/local/share/gtk-doc/html/gio/GSocketService.html +0 -258
  330. data/vendor/local/share/gtk-doc/html/gio/GTcpConnection.html +0 -165
  331. data/vendor/local/share/gtk-doc/html/gio/GThemedIcon.html +0 -377
  332. data/vendor/local/share/gtk-doc/html/gio/GThreadedSocketService.html +0 -197
  333. data/vendor/local/share/gtk-doc/html/gio/GUnixConnection.html +0 -298
  334. data/vendor/local/share/gtk-doc/html/gio/GUnixCredentialsMessage.html +0 -222
  335. data/vendor/local/share/gtk-doc/html/gio/GUnixFDList.html +0 -389
  336. data/vendor/local/share/gtk-doc/html/gio/GUnixFDMessage.html +0 -288
  337. data/vendor/local/share/gtk-doc/html/gio/GUnixInputStream.html +0 -237
  338. data/vendor/local/share/gtk-doc/html/gio/GUnixOutputStream.html +0 -237
  339. data/vendor/local/share/gtk-doc/html/gio/GUnixSocketAddress.html +0 -491
  340. data/vendor/local/share/gtk-doc/html/gio/GVfs.html +0 -274
  341. data/vendor/local/share/gtk-doc/html/gio/GVolume.html +0 -1028
  342. data/vendor/local/share/gtk-doc/html/gio/GVolumeMonitor.html +0 -705
  343. data/vendor/local/share/gtk-doc/html/gio/GZlibCompressor.html +0 -252
  344. data/vendor/local/share/gtk-doc/html/gio/GZlibDecompressor.html +0 -170
  345. data/vendor/local/share/gtk-doc/html/gio/annotation-glossary.html +0 -65
  346. data/vendor/local/share/gtk-doc/html/gio/api-index-2-18.html +0 -153
  347. data/vendor/local/share/gtk-doc/html/gio/api-index-2-20.html +0 -155
  348. data/vendor/local/share/gtk-doc/html/gio/api-index-2-22.html +0 -1084
  349. data/vendor/local/share/gtk-doc/html/gio/api-index-2-24.html +0 -223
  350. data/vendor/local/share/gtk-doc/html/gio/api-index-2-26.html +0 -1598
  351. data/vendor/local/share/gtk-doc/html/gio/api-index-deprecated.html +0 -112
  352. data/vendor/local/share/gtk-doc/html/gio/api-index-full.html +0 -6250
  353. data/vendor/local/share/gtk-doc/html/gio/async.html +0 -44
  354. data/vendor/local/share/gtk-doc/html/gio/ch01.html +0 -207
  355. data/vendor/local/share/gtk-doc/html/gio/ch02.html +0 -50
  356. data/vendor/local/share/gtk-doc/html/gio/ch03.html +0 -180
  357. data/vendor/local/share/gtk-doc/html/gio/ch24.html +0 -75
  358. data/vendor/local/share/gtk-doc/html/gio/ch25.html +0 -217
  359. data/vendor/local/share/gtk-doc/html/gio/ch25s02.html +0 -41
  360. data/vendor/local/share/gtk-doc/html/gio/ch25s03.html +0 -39
  361. data/vendor/local/share/gtk-doc/html/gio/ch26.html +0 -57
  362. data/vendor/local/share/gtk-doc/html/gio/ch26s02.html +0 -59
  363. data/vendor/local/share/gtk-doc/html/gio/ch26s03.html +0 -159
  364. data/vendor/local/share/gtk-doc/html/gio/ch26s04.html +0 -46
  365. data/vendor/local/share/gtk-doc/html/gio/ch26s05.html +0 -48
  366. data/vendor/local/share/gtk-doc/html/gio/ch26s06.html +0 -277
  367. data/vendor/local/share/gtk-doc/html/gio/ch26s07.html +0 -95
  368. data/vendor/local/share/gtk-doc/html/gio/ch27.html +0 -70
  369. data/vendor/local/share/gtk-doc/html/gio/ch27s02.html +0 -130
  370. data/vendor/local/share/gtk-doc/html/gio/ch27s03.html +0 -202
  371. data/vendor/local/share/gtk-doc/html/gio/ch27s04.html +0 -96
  372. data/vendor/local/share/gtk-doc/html/gio/ch27s05.html +0 -823
  373. data/vendor/local/share/gtk-doc/html/gio/ch27s06.html +0 -828
  374. data/vendor/local/share/gtk-doc/html/gio/conversion.html +0 -44
  375. data/vendor/local/share/gtk-doc/html/gio/extending-gio.html +0 -109
  376. data/vendor/local/share/gtk-doc/html/gio/extending.html +0 -41
  377. data/vendor/local/share/gtk-doc/html/gio/failable_initialization.html +0 -38
  378. data/vendor/local/share/gtk-doc/html/gio/file_mon.html +0 -33
  379. data/vendor/local/share/gtk-doc/html/gio/file_ops.html +0 -50
  380. data/vendor/local/share/gtk-doc/html/gio/gdbus-convenience.html +0 -41
  381. data/vendor/local/share/gtk-doc/html/gio/gdbus-lowlevel.html +0 -59
  382. data/vendor/local/share/gtk-doc/html/gio/gdbus.html +0 -243
  383. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Addresses.html +0 -316
  384. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Introspection-Data.html +0 -1117
  385. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Utilities.html +0 -216
  386. data/vendor/local/share/gtk-doc/html/gio/gio-Desktop-file-based-GAppInfo.html +0 -339
  387. data/vendor/local/share/gtk-doc/html/gio/gio-Extension-Points.html +0 -473
  388. data/vendor/local/share/gtk-doc/html/gio/gio-GContentType.html +0 -391
  389. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterInputstream.html +0 -159
  390. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterOutputstream.html +0 -159
  391. data/vendor/local/share/gtk-doc/html/gio/gio-GDBusError.html +0 -908
  392. data/vendor/local/share/gtk-doc/html/gio/gio-GFileAttribute.html +0 -933
  393. data/vendor/local/share/gtk-doc/html/gio/gio-GIOError.html +0 -409
  394. data/vendor/local/share/gtk-doc/html/gio/gio-GIOScheduler.html +0 -297
  395. data/vendor/local/share/gtk-doc/html/gio/gio-GSrvTarget.html +0 -313
  396. data/vendor/local/share/gtk-doc/html/gio/gio-Owning-Bus-Names.html +0 -736
  397. data/vendor/local/share/gtk-doc/html/gio/gio-Unix-Mounts.html +0 -909
  398. data/vendor/local/share/gtk-doc/html/gio/gio-Watching-Bus-Names.html +0 -666
  399. data/vendor/local/share/gtk-doc/html/gio/gio-hierarchy.html +0 -123
  400. data/vendor/local/share/gtk-doc/html/gio/gio-querymodules.html +0 -53
  401. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp +0 -1736
  402. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp2 +0 -2006
  403. data/vendor/local/share/gtk-doc/html/gio/glib-compile-schemas.html +0 -102
  404. data/vendor/local/share/gtk-doc/html/gio/gvfs-overview.png +0 -0
  405. data/vendor/local/share/gtk-doc/html/gio/highlevel-socket.html +0 -53
  406. data/vendor/local/share/gtk-doc/html/gio/home.png +0 -0
  407. data/vendor/local/share/gtk-doc/html/gio/icons.html +0 -50
  408. data/vendor/local/share/gtk-doc/html/gio/index.html +0 -435
  409. data/vendor/local/share/gtk-doc/html/gio/index.sgml +0 -2513
  410. data/vendor/local/share/gtk-doc/html/gio/left.png +0 -0
  411. data/vendor/local/share/gtk-doc/html/gio/migrating.html +0 -62
  412. data/vendor/local/share/gtk-doc/html/gio/networking.html +0 -69
  413. data/vendor/local/share/gtk-doc/html/gio/permissions.html +0 -39
  414. data/vendor/local/share/gtk-doc/html/gio/pt01.html +0 -39
  415. data/vendor/local/share/gtk-doc/html/gio/pt02.html +0 -390
  416. data/vendor/local/share/gtk-doc/html/gio/resolver.html +0 -50
  417. data/vendor/local/share/gtk-doc/html/gio/right.png +0 -0
  418. data/vendor/local/share/gtk-doc/html/gio/settings.html +0 -38
  419. data/vendor/local/share/gtk-doc/html/gio/streaming.html +0 -92
  420. data/vendor/local/share/gtk-doc/html/gio/style.css +0 -265
  421. data/vendor/local/share/gtk-doc/html/gio/tools.html +0 -44
  422. data/vendor/local/share/gtk-doc/html/gio/types.html +0 -41
  423. data/vendor/local/share/gtk-doc/html/gio/up.png +0 -0
  424. data/vendor/local/share/gtk-doc/html/gio/utils.html +0 -33
  425. data/vendor/local/share/gtk-doc/html/gio/volume_mon.html +0 -47
  426. data/vendor/local/share/gtk-doc/html/glib/annotation-glossary.html +0 -77
  427. data/vendor/local/share/gtk-doc/html/glib/api-index-2-10.html +0 -180
  428. data/vendor/local/share/gtk-doc/html/glib/api-index-2-12.html +0 -312
  429. data/vendor/local/share/gtk-doc/html/glib/api-index-2-14.html +0 -559
  430. data/vendor/local/share/gtk-doc/html/glib/api-index-2-16.html +0 -362
  431. data/vendor/local/share/gtk-doc/html/glib/api-index-2-18.html +0 -102
  432. data/vendor/local/share/gtk-doc/html/glib/api-index-2-2.html +0 -124
  433. data/vendor/local/share/gtk-doc/html/glib/api-index-2-20.html +0 -83
  434. data/vendor/local/share/gtk-doc/html/glib/api-index-2-22.html +0 -194
  435. data/vendor/local/share/gtk-doc/html/glib/api-index-2-24.html +0 -420
  436. data/vendor/local/share/gtk-doc/html/glib/api-index-2-26.html +0 -359
  437. data/vendor/local/share/gtk-doc/html/glib/api-index-2-4.html +0 -396
  438. data/vendor/local/share/gtk-doc/html/glib/api-index-2-6.html +0 -417
  439. data/vendor/local/share/gtk-doc/html/glib/api-index-2-8.html +0 -158
  440. data/vendor/local/share/gtk-doc/html/glib/api-index-deprecated.html +0 -419
  441. data/vendor/local/share/gtk-doc/html/glib/api-index-full.html +0 -8214
  442. data/vendor/local/share/gtk-doc/html/glib/file-name-encodings.png +0 -0
  443. data/vendor/local/share/gtk-doc/html/glib/glib-Arrays.html +0 -893
  444. data/vendor/local/share/gtk-doc/html/glib/glib-Asynchronous-Queues.html +0 -818
  445. data/vendor/local/share/gtk-doc/html/glib/glib-Atomic-Operations.html +0 -414
  446. data/vendor/local/share/gtk-doc/html/glib/glib-Automatic-String-Completion.html +0 -466
  447. data/vendor/local/share/gtk-doc/html/glib/glib-Balanced-Binary-Trees.html +0 -802
  448. data/vendor/local/share/gtk-doc/html/glib/glib-Base64-Encoding.html +0 -372
  449. data/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html +0 -500
  450. data/vendor/local/share/gtk-doc/html/glib/glib-Bookmark-file-parser.html +0 -2056
  451. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Arrays.html +0 -560
  452. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Order-Macros.html +0 -1686
  453. data/vendor/local/share/gtk-doc/html/glib/glib-Caches.html +0 -398
  454. data/vendor/local/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html +0 -1094
  455. data/vendor/local/share/gtk-doc/html/glib/glib-Commandline-option-parser.html +0 -1671
  456. data/vendor/local/share/gtk-doc/html/glib/glib-Data-Checksums.html +0 -460
  457. data/vendor/local/share/gtk-doc/html/glib/glib-Datasets.html +0 -528
  458. data/vendor/local/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html +0 -2045
  459. data/vendor/local/share/gtk-doc/html/glib/glib-Double-ended-Queues.html +0 -1278
  460. data/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html +0 -1406
  461. data/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html +0 -548
  462. data/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html +0 -1026
  463. data/vendor/local/share/gtk-doc/html/glib/glib-File-Utilities.html +0 -1852
  464. data/vendor/local/share/gtk-doc/html/glib/glib-GDateTime.html +0 -2201
  465. data/vendor/local/share/gtk-doc/html/glib/glib-GTimeZone.html +0 -239
  466. data/vendor/local/share/gtk-doc/html/glib/glib-GVariant.html +0 -4278
  467. data/vendor/local/share/gtk-doc/html/glib/glib-GVariantType.html +0 -1864
  468. data/vendor/local/share/gtk-doc/html/glib/glib-Glob-style-pattern-matching.html +0 -295
  469. data/vendor/local/share/gtk-doc/html/glib/glib-Hash-Tables.html +0 -1512
  470. data/vendor/local/share/gtk-doc/html/glib/glib-Hook-Functions.html +0 -1367
  471. data/vendor/local/share/gtk-doc/html/glib/glib-Hostname-Utilities.html +0 -229
  472. data/vendor/local/share/gtk-doc/html/glib/glib-I18N.html +0 -692
  473. data/vendor/local/share/gtk-doc/html/glib/glib-IO-Channels.html +0 -2196
  474. data/vendor/local/share/gtk-doc/html/glib/glib-Key-value-file-parser.html +0 -2740
  475. data/vendor/local/share/gtk-doc/html/glib/glib-Keyed-Data-Lists.html +0 -612
  476. data/vendor/local/share/gtk-doc/html/glib/glib-Lexical-Scanner.html +0 -1451
  477. data/vendor/local/share/gtk-doc/html/glib/glib-Limits-of-Basic-Types.html +0 -389
  478. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html +0 -1033
  479. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocators.html +0 -141
  480. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Chunks.html +0 -706
  481. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Slices.html +0 -510
  482. data/vendor/local/share/gtk-doc/html/glib/glib-Message-Logging.html +0 -748
  483. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Macros.html +0 -1105
  484. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html +0 -1552
  485. data/vendor/local/share/gtk-doc/html/glib/glib-N-ary-Trees.html +0 -1468
  486. data/vendor/local/share/gtk-doc/html/glib/glib-Numerical-Definitions.html +0 -194
  487. data/vendor/local/share/gtk-doc/html/glib/glib-Perl-compatible-regular-expressions.html +0 -2745
  488. data/vendor/local/share/gtk-doc/html/glib/glib-Pointer-Arrays.html +0 -752
  489. data/vendor/local/share/gtk-doc/html/glib/glib-Quarks.html +0 -269
  490. data/vendor/local/share/gtk-doc/html/glib/glib-Random-Numbers.html +0 -578
  491. data/vendor/local/share/gtk-doc/html/glib/glib-Relations-and-Tuples.html +0 -532
  492. data/vendor/local/share/gtk-doc/html/glib/glib-Sequences.html +0 -1353
  493. data/vendor/local/share/gtk-doc/html/glib/glib-Shell-related-Utilities.html +0 -238
  494. data/vendor/local/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html +0 -1282
  495. data/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html +0 -1213
  496. data/vendor/local/share/gtk-doc/html/glib/glib-Spawning-Processes.html +0 -924
  497. data/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html +0 -470
  498. data/vendor/local/share/gtk-doc/html/glib/glib-String-Chunks.html +0 -301
  499. data/vendor/local/share/gtk-doc/html/glib/glib-String-Utility-Functions.html +0 -2960
  500. data/vendor/local/share/gtk-doc/html/glib/glib-Strings.html +0 -1291
  501. data/vendor/local/share/gtk-doc/html/glib/glib-Testing.html +0 -1805
  502. data/vendor/local/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html +0 -3478
  503. data/vendor/local/share/gtk-doc/html/glib/glib-Thread-Pools.html +0 -606
  504. data/vendor/local/share/gtk-doc/html/glib/glib-Threads.html +0 -3411
  505. data/vendor/local/share/gtk-doc/html/glib/glib-Timers.html +0 -245
  506. data/vendor/local/share/gtk-doc/html/glib/glib-Trash-Stacks.html +0 -188
  507. data/vendor/local/share/gtk-doc/html/glib/glib-Type-Conversion-Macros.html +0 -263
  508. data/vendor/local/share/gtk-doc/html/glib/glib-URI-Functions.html +0 -400
  509. data/vendor/local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html +0 -3448
  510. data/vendor/local/share/gtk-doc/html/glib/glib-Version-Information.html +0 -253
  511. data/vendor/local/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html +0 -438
  512. data/vendor/local/share/gtk-doc/html/glib/glib-Windows-Compatibility-Functions.html +0 -476
  513. data/vendor/local/share/gtk-doc/html/glib/glib-building.html +0 -466
  514. data/vendor/local/share/gtk-doc/html/glib/glib-changes.html +0 -159
  515. data/vendor/local/share/gtk-doc/html/glib/glib-compiling.html +0 -118
  516. data/vendor/local/share/gtk-doc/html/glib/glib-core.html +0 -64
  517. data/vendor/local/share/gtk-doc/html/glib/glib-cross-compiling.html +0 -160
  518. data/vendor/local/share/gtk-doc/html/glib/glib-data-types.html +0 -120
  519. data/vendor/local/share/gtk-doc/html/glib/glib-fundamentals.html +0 -59
  520. data/vendor/local/share/gtk-doc/html/glib/glib-gettextize.html +0 -93
  521. data/vendor/local/share/gtk-doc/html/glib/glib-regex-syntax.html +0 -2217
  522. data/vendor/local/share/gtk-doc/html/glib/glib-resources.html +0 -121
  523. data/vendor/local/share/gtk-doc/html/glib/glib-running.html +0 -319
  524. data/vendor/local/share/gtk-doc/html/glib/glib-utilities.html +0 -118
  525. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp +0 -2183
  526. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp2 +0 -2671
  527. data/vendor/local/share/gtk-doc/html/glib/glib.html +0 -80
  528. data/vendor/local/share/gtk-doc/html/glib/gtester-report.html +0 -72
  529. data/vendor/local/share/gtk-doc/html/glib/gtester.html +0 -131
  530. data/vendor/local/share/gtk-doc/html/glib/gvariant-format-strings.html +0 -1288
  531. data/vendor/local/share/gtk-doc/html/glib/home.png +0 -0
  532. data/vendor/local/share/gtk-doc/html/glib/index.html +0 -344
  533. data/vendor/local/share/gtk-doc/html/glib/index.sgml +0 -2846
  534. data/vendor/local/share/gtk-doc/html/glib/left.png +0 -0
  535. data/vendor/local/share/gtk-doc/html/glib/mainloop-states.gif +0 -0
  536. data/vendor/local/share/gtk-doc/html/glib/right.png +0 -0
  537. data/vendor/local/share/gtk-doc/html/glib/style.css +0 -265
  538. data/vendor/local/share/gtk-doc/html/glib/tools.html +0 -41
  539. data/vendor/local/share/gtk-doc/html/glib/up.png +0 -0
  540. data/vendor/local/share/gtk-doc/html/gobject/GBinding.html +0 -803
  541. data/vendor/local/share/gtk-doc/html/gobject/GTypeModule.html +0 -710
  542. data/vendor/local/share/gtk-doc/html/gobject/GTypePlugin.html +0 -453
  543. data/vendor/local/share/gtk-doc/html/gobject/annotation-glossary.html +0 -47
  544. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-10.html +0 -85
  545. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-12.html +0 -55
  546. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-14.html +0 -51
  547. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-18.html +0 -46
  548. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-2.html +0 -38
  549. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-22.html +0 -46
  550. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-24.html +0 -73
  551. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-26.html +0 -201
  552. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-4.html +0 -178
  553. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-6.html +0 -42
  554. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-8.html +0 -42
  555. data/vendor/local/share/gtk-doc/html/gobject/api-index-deprecated.html +0 -50
  556. data/vendor/local/share/gtk-doc/html/gobject/api-index-full.html +0 -2721
  557. data/vendor/local/share/gtk-doc/html/gobject/ch01s02.html +0 -136
  558. data/vendor/local/share/gtk-doc/html/gobject/ch06s03.html +0 -113
  559. data/vendor/local/share/gtk-doc/html/gobject/chapter-gobject.html +0 -293
  560. data/vendor/local/share/gtk-doc/html/gobject/chapter-gtype.html +0 -263
  561. data/vendor/local/share/gtk-doc/html/gobject/chapter-intro.html +0 -92
  562. data/vendor/local/share/gtk-doc/html/gobject/chapter-signal.html +0 -214
  563. data/vendor/local/share/gtk-doc/html/gobject/glib-genmarshal.html +0 -361
  564. data/vendor/local/share/gtk-doc/html/gobject/glib-mkenums.html +0 -307
  565. data/vendor/local/share/gtk-doc/html/gobject/glue.png +0 -0
  566. data/vendor/local/share/gtk-doc/html/gobject/gobject-Boxed-Types.html +0 -417
  567. data/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html +0 -2412
  568. data/vendor/local/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html +0 -847
  569. data/vendor/local/share/gtk-doc/html/gobject/gobject-GParamSpec.html +0 -1433
  570. data/vendor/local/share/gtk-doc/html/gobject/gobject-Generic-values.html +0 -776
  571. data/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html +0 -2741
  572. data/vendor/local/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html +0 -5555
  573. data/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html +0 -2875
  574. data/vendor/local/share/gtk-doc/html/gobject/gobject-Type-Information.html +0 -4460
  575. data/vendor/local/share/gtk-doc/html/gobject/gobject-Value-arrays.html +0 -416
  576. data/vendor/local/share/gtk-doc/html/gobject/gobject-Varargs-Value-Collection.html +0 -260
  577. data/vendor/local/share/gtk-doc/html/gobject/gobject-memory.html +0 -234
  578. data/vendor/local/share/gtk-doc/html/gobject/gobject-properties.html +0 -270
  579. data/vendor/local/share/gtk-doc/html/gobject/gobject-query.html +0 -117
  580. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp +0 -762
  581. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp2 +0 -801
  582. data/vendor/local/share/gtk-doc/html/gobject/gtype-conventions.html +0 -143
  583. data/vendor/local/share/gtk-doc/html/gobject/gtype-instantiable-classed.html +0 -287
  584. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable-classed.html +0 -316
  585. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable.html +0 -76
  586. data/vendor/local/share/gtk-doc/html/gobject/home.png +0 -0
  587. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-chainup.html +0 -100
  588. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-code.html +0 -86
  589. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-construction.html +0 -113
  590. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-destruction.html +0 -122
  591. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-methods.html +0 -257
  592. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject.html +0 -283
  593. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-implement.html +0 -125
  594. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-properties.html +0 -167
  595. data/vendor/local/share/gtk-doc/html/gobject/howto-interface.html +0 -160
  596. data/vendor/local/share/gtk-doc/html/gobject/howto-signals.html +0 -121
  597. data/vendor/local/share/gtk-doc/html/gobject/index.html +0 -192
  598. data/vendor/local/share/gtk-doc/html/gobject/index.sgml +0 -786
  599. data/vendor/local/share/gtk-doc/html/gobject/left.png +0 -0
  600. data/vendor/local/share/gtk-doc/html/gobject/pr01.html +0 -72
  601. data/vendor/local/share/gtk-doc/html/gobject/pt01.html +0 -80
  602. data/vendor/local/share/gtk-doc/html/gobject/pt02.html +0 -66
  603. data/vendor/local/share/gtk-doc/html/gobject/pt03.html +0 -55
  604. data/vendor/local/share/gtk-doc/html/gobject/right.png +0 -0
  605. data/vendor/local/share/gtk-doc/html/gobject/rn01.html +0 -85
  606. data/vendor/local/share/gtk-doc/html/gobject/rn02.html +0 -47
  607. data/vendor/local/share/gtk-doc/html/gobject/signal.html +0 -377
  608. data/vendor/local/share/gtk-doc/html/gobject/style.css +0 -265
  609. data/vendor/local/share/gtk-doc/html/gobject/tools-ginspector.html +0 -35
  610. data/vendor/local/share/gtk-doc/html/gobject/tools-gob.html +0 -40
  611. data/vendor/local/share/gtk-doc/html/gobject/tools-gtkdoc.html +0 -63
  612. data/vendor/local/share/gtk-doc/html/gobject/tools-refdb.html +0 -55
  613. data/vendor/local/share/gtk-doc/html/gobject/tools-vala.html +0 -43
  614. data/vendor/local/share/gtk-doc/html/gobject/up.png +0 -0
  615. data/vendor/local/share/locale/af/LC_MESSAGES/glib20.mo +0 -0
  616. data/vendor/local/share/locale/am/LC_MESSAGES/glib20.mo +0 -0
  617. data/vendor/local/share/locale/ar/LC_MESSAGES/glib20.mo +0 -0
  618. data/vendor/local/share/locale/as/LC_MESSAGES/glib20.mo +0 -0
  619. data/vendor/local/share/locale/ast/LC_MESSAGES/glib20.mo +0 -0
  620. data/vendor/local/share/locale/az/LC_MESSAGES/glib20.mo +0 -0
  621. data/vendor/local/share/locale/be/LC_MESSAGES/gettext-runtime.mo +0 -0
  622. data/vendor/local/share/locale/be/LC_MESSAGES/glib20.mo +0 -0
  623. data/vendor/local/share/locale/be@latin/LC_MESSAGES/glib20.mo +0 -0
  624. data/vendor/local/share/locale/bg/LC_MESSAGES/gettext-runtime.mo +0 -0
  625. data/vendor/local/share/locale/bg/LC_MESSAGES/glib20.mo +0 -0
  626. data/vendor/local/share/locale/bn/LC_MESSAGES/glib20.mo +0 -0
  627. data/vendor/local/share/locale/bn_IN/LC_MESSAGES/glib20.mo +0 -0
  628. data/vendor/local/share/locale/bs/LC_MESSAGES/glib20.mo +0 -0
  629. data/vendor/local/share/locale/ca/LC_MESSAGES/gettext-runtime.mo +0 -0
  630. data/vendor/local/share/locale/ca/LC_MESSAGES/glib20.mo +0 -0
  631. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/glib20.mo +0 -0
  632. data/vendor/local/share/locale/cs/LC_MESSAGES/gettext-runtime.mo +0 -0
  633. data/vendor/local/share/locale/cs/LC_MESSAGES/glib20.mo +0 -0
  634. data/vendor/local/share/locale/cy/LC_MESSAGES/glib20.mo +0 -0
  635. data/vendor/local/share/locale/da/LC_MESSAGES/gettext-runtime.mo +0 -0
  636. data/vendor/local/share/locale/da/LC_MESSAGES/glib20.mo +0 -0
  637. data/vendor/local/share/locale/de/LC_MESSAGES/gettext-runtime.mo +0 -0
  638. data/vendor/local/share/locale/de/LC_MESSAGES/glib20.mo +0 -0
  639. data/vendor/local/share/locale/dz/LC_MESSAGES/glib20.mo +0 -0
  640. data/vendor/local/share/locale/el/LC_MESSAGES/gettext-runtime.mo +0 -0
  641. data/vendor/local/share/locale/el/LC_MESSAGES/glib20.mo +0 -0
  642. data/vendor/local/share/locale/en@boldquot/LC_MESSAGES/gettext-runtime.mo +0 -0
  643. data/vendor/local/share/locale/en@quot/LC_MESSAGES/gettext-runtime.mo +0 -0
  644. data/vendor/local/share/locale/en@shaw/LC_MESSAGES/glib20.mo +0 -0
  645. data/vendor/local/share/locale/en_CA/LC_MESSAGES/glib20.mo +0 -0
  646. data/vendor/local/share/locale/en_GB/LC_MESSAGES/glib20.mo +0 -0
  647. data/vendor/local/share/locale/eo/LC_MESSAGES/gettext-runtime.mo +0 -0
  648. data/vendor/local/share/locale/eo/LC_MESSAGES/glib20.mo +0 -0
  649. data/vendor/local/share/locale/es/LC_MESSAGES/gettext-runtime.mo +0 -0
  650. data/vendor/local/share/locale/es/LC_MESSAGES/glib20.mo +0 -0
  651. data/vendor/local/share/locale/et/LC_MESSAGES/gettext-runtime.mo +0 -0
  652. data/vendor/local/share/locale/et/LC_MESSAGES/glib20.mo +0 -0
  653. data/vendor/local/share/locale/eu/LC_MESSAGES/glib20.mo +0 -0
  654. data/vendor/local/share/locale/fa/LC_MESSAGES/glib20.mo +0 -0
  655. data/vendor/local/share/locale/fi/LC_MESSAGES/gettext-runtime.mo +0 -0
  656. data/vendor/local/share/locale/fi/LC_MESSAGES/glib20.mo +0 -0
  657. data/vendor/local/share/locale/fr/LC_MESSAGES/gettext-runtime.mo +0 -0
  658. data/vendor/local/share/locale/fr/LC_MESSAGES/glib20.mo +0 -0
  659. data/vendor/local/share/locale/ga/LC_MESSAGES/gettext-runtime.mo +0 -0
  660. data/vendor/local/share/locale/ga/LC_MESSAGES/glib20.mo +0 -0
  661. data/vendor/local/share/locale/gl/LC_MESSAGES/gettext-runtime.mo +0 -0
  662. data/vendor/local/share/locale/gl/LC_MESSAGES/glib20.mo +0 -0
  663. data/vendor/local/share/locale/gu/LC_MESSAGES/glib20.mo +0 -0
  664. data/vendor/local/share/locale/he/LC_MESSAGES/glib20.mo +0 -0
  665. data/vendor/local/share/locale/hi/LC_MESSAGES/glib20.mo +0 -0
  666. data/vendor/local/share/locale/hr/LC_MESSAGES/glib20.mo +0 -0
  667. data/vendor/local/share/locale/hu/LC_MESSAGES/glib20.mo +0 -0
  668. data/vendor/local/share/locale/hy/LC_MESSAGES/glib20.mo +0 -0
  669. data/vendor/local/share/locale/id/LC_MESSAGES/gettext-runtime.mo +0 -0
  670. data/vendor/local/share/locale/id/LC_MESSAGES/glib20.mo +0 -0
  671. data/vendor/local/share/locale/is/LC_MESSAGES/glib20.mo +0 -0
  672. data/vendor/local/share/locale/it/LC_MESSAGES/gettext-runtime.mo +0 -0
  673. data/vendor/local/share/locale/it/LC_MESSAGES/glib20.mo +0 -0
  674. data/vendor/local/share/locale/ja/LC_MESSAGES/gettext-runtime.mo +0 -0
  675. data/vendor/local/share/locale/ja/LC_MESSAGES/glib20.mo +0 -0
  676. data/vendor/local/share/locale/ka/LC_MESSAGES/glib20.mo +0 -0
  677. data/vendor/local/share/locale/kk/LC_MESSAGES/glib20.mo +0 -0
  678. data/vendor/local/share/locale/kn/LC_MESSAGES/glib20.mo +0 -0
  679. data/vendor/local/share/locale/ko/LC_MESSAGES/gettext-runtime.mo +0 -0
  680. data/vendor/local/share/locale/ko/LC_MESSAGES/glib20.mo +0 -0
  681. data/vendor/local/share/locale/ku/LC_MESSAGES/glib20.mo +0 -0
  682. data/vendor/local/share/locale/locale.alias +0 -77
  683. data/vendor/local/share/locale/lt/LC_MESSAGES/glib20.mo +0 -0
  684. data/vendor/local/share/locale/lv/LC_MESSAGES/glib20.mo +0 -0
  685. data/vendor/local/share/locale/mai/LC_MESSAGES/glib20.mo +0 -0
  686. data/vendor/local/share/locale/mg/LC_MESSAGES/glib20.mo +0 -0
  687. data/vendor/local/share/locale/mk/LC_MESSAGES/glib20.mo +0 -0
  688. data/vendor/local/share/locale/ml/LC_MESSAGES/glib20.mo +0 -0
  689. data/vendor/local/share/locale/mn/LC_MESSAGES/glib20.mo +0 -0
  690. data/vendor/local/share/locale/mr/LC_MESSAGES/glib20.mo +0 -0
  691. data/vendor/local/share/locale/ms/LC_MESSAGES/glib20.mo +0 -0
  692. data/vendor/local/share/locale/nb/LC_MESSAGES/gettext-runtime.mo +0 -0
  693. data/vendor/local/share/locale/nb/LC_MESSAGES/glib20.mo +0 -0
  694. data/vendor/local/share/locale/nds/LC_MESSAGES/glib20.mo +0 -0
  695. data/vendor/local/share/locale/ne/LC_MESSAGES/glib20.mo +0 -0
  696. data/vendor/local/share/locale/nl/LC_MESSAGES/gettext-runtime.mo +0 -0
  697. data/vendor/local/share/locale/nl/LC_MESSAGES/glib20.mo +0 -0
  698. data/vendor/local/share/locale/nn/LC_MESSAGES/gettext-runtime.mo +0 -0
  699. data/vendor/local/share/locale/nn/LC_MESSAGES/glib20.mo +0 -0
  700. data/vendor/local/share/locale/oc/LC_MESSAGES/glib20.mo +0 -0
  701. data/vendor/local/share/locale/or/LC_MESSAGES/glib20.mo +0 -0
  702. data/vendor/local/share/locale/pa/LC_MESSAGES/glib20.mo +0 -0
  703. data/vendor/local/share/locale/pl/LC_MESSAGES/gettext-runtime.mo +0 -0
  704. data/vendor/local/share/locale/pl/LC_MESSAGES/glib20.mo +0 -0
  705. data/vendor/local/share/locale/ps/LC_MESSAGES/glib20.mo +0 -0
  706. data/vendor/local/share/locale/pt/LC_MESSAGES/gettext-runtime.mo +0 -0
  707. data/vendor/local/share/locale/pt/LC_MESSAGES/glib20.mo +0 -0
  708. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gettext-runtime.mo +0 -0
  709. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/glib20.mo +0 -0
  710. data/vendor/local/share/locale/ro/LC_MESSAGES/gettext-runtime.mo +0 -0
  711. data/vendor/local/share/locale/ro/LC_MESSAGES/glib20.mo +0 -0
  712. data/vendor/local/share/locale/ru/LC_MESSAGES/gettext-runtime.mo +0 -0
  713. data/vendor/local/share/locale/ru/LC_MESSAGES/glib20.mo +0 -0
  714. data/vendor/local/share/locale/rw/LC_MESSAGES/glib20.mo +0 -0
  715. data/vendor/local/share/locale/si/LC_MESSAGES/glib20.mo +0 -0
  716. data/vendor/local/share/locale/sk/LC_MESSAGES/gettext-runtime.mo +0 -0
  717. data/vendor/local/share/locale/sk/LC_MESSAGES/glib20.mo +0 -0
  718. data/vendor/local/share/locale/sl/LC_MESSAGES/gettext-runtime.mo +0 -0
  719. data/vendor/local/share/locale/sl/LC_MESSAGES/glib20.mo +0 -0
  720. data/vendor/local/share/locale/sq/LC_MESSAGES/glib20.mo +0 -0
  721. data/vendor/local/share/locale/sr/LC_MESSAGES/gettext-runtime.mo +0 -0
  722. data/vendor/local/share/locale/sr/LC_MESSAGES/glib20.mo +0 -0
  723. data/vendor/local/share/locale/sr@ije/LC_MESSAGES/glib20.mo +0 -0
  724. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/glib20.mo +0 -0
  725. data/vendor/local/share/locale/sv/LC_MESSAGES/gettext-runtime.mo +0 -0
  726. data/vendor/local/share/locale/sv/LC_MESSAGES/glib20.mo +0 -0
  727. data/vendor/local/share/locale/ta/LC_MESSAGES/glib20.mo +0 -0
  728. data/vendor/local/share/locale/te/LC_MESSAGES/glib20.mo +0 -0
  729. data/vendor/local/share/locale/th/LC_MESSAGES/glib20.mo +0 -0
  730. data/vendor/local/share/locale/tl/LC_MESSAGES/glib20.mo +0 -0
  731. data/vendor/local/share/locale/tr/LC_MESSAGES/gettext-runtime.mo +0 -0
  732. data/vendor/local/share/locale/tr/LC_MESSAGES/glib20.mo +0 -0
  733. data/vendor/local/share/locale/tt/LC_MESSAGES/glib20.mo +0 -0
  734. data/vendor/local/share/locale/uk/LC_MESSAGES/gettext-runtime.mo +0 -0
  735. data/vendor/local/share/locale/uk/LC_MESSAGES/glib20.mo +0 -0
  736. data/vendor/local/share/locale/vi/LC_MESSAGES/gettext-runtime.mo +0 -0
  737. data/vendor/local/share/locale/vi/LC_MESSAGES/glib20.mo +0 -0
  738. data/vendor/local/share/locale/wa/LC_MESSAGES/glib20.mo +0 -0
  739. data/vendor/local/share/locale/xh/LC_MESSAGES/glib20.mo +0 -0
  740. data/vendor/local/share/locale/yi/LC_MESSAGES/glib20.mo +0 -0
  741. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/gettext-runtime.mo +0 -0
  742. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/glib20.mo +0 -0
  743. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gettext-runtime.mo +0 -0
  744. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/glib20.mo +0 -0
  745. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/gettext-runtime.mo +0 -0
  746. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/glib20.mo +0 -0
  747. data/vendor/local/share/man/man1/envsubst.1 +0 -54
  748. data/vendor/local/share/man/man1/gettext.1 +0 -69
  749. data/vendor/local/share/man/man1/glib-genmarshal.1 +0 -312
  750. data/vendor/local/share/man/man1/glib-mkenums.1 +0 -246
  751. data/vendor/local/share/man/man1/gobject-query.1 +0 -83
  752. data/vendor/local/share/man/man1/ngettext.1 +0 -68
  753. data/vendor/local/share/man/man3/bind_textdomain_codeset.3 +0 -72
  754. data/vendor/local/share/man/man3/bindtextdomain.3 +0 -69
  755. data/vendor/local/share/man/man3/dcgettext.3 +0 -1
  756. data/vendor/local/share/man/man3/dcngettext.3 +0 -1
  757. data/vendor/local/share/man/man3/dgettext.3 +0 -1
  758. data/vendor/local/share/man/man3/dngettext.3 +0 -1
  759. data/vendor/local/share/man/man3/gettext.3 +0 -99
  760. data/vendor/local/share/man/man3/ngettext.3 +0 -60
  761. data/vendor/local/share/man/man3/textdomain.3 +0 -57
  762. data/vendor/local/src/tml/packaging/gettext_0.18.1.1-2_win32.log +0 -10423
  763. data/vendor/local/src/tml/packaging/gettext_0.18.1.1-2_win32.sh +0 -457
  764. data/vendor/local/src/tml/packaging/glib_2.26.0-2_win32.log +0 -2867
  765. data/vendor/local/src/tml/packaging/glib_2.26.0-2_win32.sh +0 -64
data/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html DELETED
@@ -1,2741 +0,0 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
- <html>
3
- <head>
4
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
- <title>Signals</title>
6
- <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
- <link rel="home" href="index.html" title="GObject Reference Manual">
8
- <link rel="up" href="rn01.html" title="API Reference">
9
- <link rel="prev" href="gobject-Varargs-Value-Collection.html" title="Varargs Value Collection">
10
- <link rel="next" href="gobject-Closures.html" title="Closures">
11
- <meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
12
- <link rel="stylesheet" href="style.css" type="text/css">
13
- </head>
14
- <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
- <tr valign="middle">
17
- <td><a accesskey="p" href="gobject-Varargs-Value-Collection.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
- <td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
- <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
- <th width="100%" align="center">GObject Reference Manual</th>
21
- <td><a accesskey="n" href="gobject-Closures.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
- </tr>
23
- <tr><td colspan="5" class="shortcuts">
24
- <a href="#gobject-Signals.synopsis" class="shortcut">Top</a>
25
-  | 
26
- <a href="#gobject-Signals.description" class="shortcut">Description</a>
27
- </td></tr>
28
- </table>
29
- <div class="refentry">
30
- <a name="gobject-Signals"></a><div class="titlepage"></div>
31
- <div class="refnamediv"><table width="100%"><tr>
32
- <td valign="top">
33
- <h2><span class="refentrytitle"><a name="gobject-Signals.top_of_page"></a>Signals</span></h2>
34
- <p>Signals — A means for customization of object behaviour
35
- and a general purpose notification mechanism</p>
36
- </td>
37
- <td valign="top" align="right"></td>
38
- </tr></table></div>
39
- <div class="refsynopsisdiv">
40
- <a name="gobject-Signals.synopsis"></a><h2>Synopsis</h2>
41
- <pre class="synopsis">
42
- #include &lt;glib-object.h&gt;
43
-
44
- <a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint">GSignalInvocationHint</a>;
45
- <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>) (<em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="type">GSignalInvocationHint</span></a> *ihint</code></em>,
46
- <em class="parameter"><code><a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *return_accu</code></em>,
47
- <em class="parameter"><code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *handler_return</code></em>,
48
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
49
- typedef <a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller">GSignalCMarshaller</a>;
50
- <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>) (<em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="type">GSignalInvocationHint</span></a> *ihint</code></em>,
51
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_param_values</code></em>,
52
- <em class="parameter"><code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *param_values</code></em>,
53
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
54
- enum <a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags">GSignalFlags</a>;
55
- enum <a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a>;
56
- <a class="link" href="gobject-Signals.html#GSignalQuery" title="GSignalQuery">GSignalQuery</a>;
57
- #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>
58
- #define <a class="link" href="gobject-Signals.html#G-SIGNAL-MATCH-MASK:CAPS" title="G_SIGNAL_MATCH_MASK">G_SIGNAL_MATCH_MASK</a>
59
- #define <a class="link" href="gobject-Signals.html#G-SIGNAL-FLAGS-MASK:CAPS" title="G_SIGNAL_FLAGS_MASK">G_SIGNAL_FLAGS_MASK</a>
60
- <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> (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_name</code></em>,
61
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> itype</code></em>,
62
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="type">GSignalFlags</span></a> signal_flags</code></em>,
63
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> class_offset</code></em>,
64
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="type">GSignalAccumulator</span></a> accumulator</code></em>,
65
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> accu_data</code></em>,
66
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller"><span class="type">GSignalCMarshaller</span></a> c_marshaller</code></em>,
67
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> return_type</code></em>,
68
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_params</code></em>,
69
- <em class="parameter"><code>...</code></em>);
70
- <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> (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_name</code></em>,
71
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> itype</code></em>,
72
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="type">GSignalFlags</span></a> signal_flags</code></em>,
73
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *class_closure</code></em>,
74
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="type">GSignalAccumulator</span></a> accumulator</code></em>,
75
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> accu_data</code></em>,
76
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller"><span class="type">GSignalCMarshaller</span></a> c_marshaller</code></em>,
77
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> return_type</code></em>,
78
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_params</code></em>,
79
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> *param_types</code></em>);
80
- <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> (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_name</code></em>,
81
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> itype</code></em>,
82
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="type">GSignalFlags</span></a> signal_flags</code></em>,
83
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *class_closure</code></em>,
84
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="type">GSignalAccumulator</span></a> accumulator</code></em>,
85
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> accu_data</code></em>,
86
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller"><span class="type">GSignalCMarshaller</span></a> c_marshaller</code></em>,
87
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> return_type</code></em>,
88
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_params</code></em>,
89
- <em class="parameter"><code><span class="type">va_list</span> args</code></em>);
90
- <span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-query" title="g_signal_query ()">g_signal_query</a> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
91
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalQuery" title="GSignalQuery"><span class="type">GSignalQuery</span></a> *query</code></em>);
92
- <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> (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
93
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> itype</code></em>);
94
- 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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>);
95
- <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> (<em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> itype</code></em>,
96
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *n_ids</code></em>);
97
- <span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-emit" title="g_signal_emit ()">g_signal_emit</a> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
98
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
99
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
100
- <em class="parameter"><code>...</code></em>);
101
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
102
- <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_signal</code></em>,
103
- <em class="parameter"><code>...</code></em>);
104
- <span class="returnvalue">void</span> <a class="link" href="gobject-Signals.html#g-signal-emitv" title="g_signal_emitv ()">g_signal_emitv</a> (<em class="parameter"><code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *instance_and_params</code></em>,
105
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
106
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
107
- <em class="parameter"><code><a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *return_value</code></em>);
108
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
109
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
110
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
111
- <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);
112
- #define <a class="link" href="gobject-Signals.html#g-signal-connect" title="g_signal_connect()">g_signal_connect</a> (instance,
113
- detailed_signal,
114
- c_handler,
115
- data)
116
- #define <a class="link" href="gobject-Signals.html#g-signal-connect-after" title="g_signal_connect_after()">g_signal_connect_after</a> (instance,
117
- detailed_signal,
118
- c_handler,
119
- data)
120
- #define <a class="link" href="gobject-Signals.html#g-signal-connect-swapped" title="g_signal_connect_swapped()">g_signal_connect_swapped</a> (instance,
121
- detailed_signal,
122
- c_handler,
123
- data)
124
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
125
- <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_signal</code></em>,
126
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="type">GCallback</span></a> c_handler</code></em>,
127
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> gobject</code></em>,
128
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GConnectFlags" title="enum GConnectFlags"><span class="type">GConnectFlags</span></a> connect_flags</code></em>);
129
- enum <a class="link" href="gobject-Signals.html#GConnectFlags" title="enum GConnectFlags">GConnectFlags</a>;
130
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
131
- <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_signal</code></em>,
132
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="type">GCallback</span></a> c_handler</code></em>,
133
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
134
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosureNotify" title="GClosureNotify ()"><span class="type">GClosureNotify</span></a> destroy_data</code></em>,
135
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GConnectFlags" title="enum GConnectFlags"><span class="type">GConnectFlags</span></a> connect_flags</code></em>);
136
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
137
- <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_signal</code></em>,
138
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *closure</code></em>,
139
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> after</code></em>);
140
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
141
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
142
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
143
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *closure</code></em>,
144
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> after</code></em>);
145
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
146
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> handler_id</code></em>);
147
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
148
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> handler_id</code></em>);
149
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
150
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> handler_id</code></em>);
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-handler-find" title="g_signal_handler_find ()">g_signal_handler_find</a> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
152
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="type">GSignalMatchType</span></a> mask</code></em>,
153
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
154
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
155
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *closure</code></em>,
156
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> func</code></em>,
157
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
158
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
159
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="type">GSignalMatchType</span></a> mask</code></em>,
160
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
161
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
162
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *closure</code></em>,
163
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> func</code></em>,
164
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
165
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
166
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="type">GSignalMatchType</span></a> mask</code></em>,
167
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
168
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
169
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *closure</code></em>,
170
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> func</code></em>,
171
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
172
- <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>
173
- (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
174
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="type">GSignalMatchType</span></a> mask</code></em>,
175
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
176
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
177
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *closure</code></em>,
178
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> func</code></em>,
179
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
180
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
181
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> handler_id</code></em>);
182
- #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,
183
- func,
184
- data)
185
- #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,
186
- func,
187
- data)
188
- #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,
189
- func,
190
- data)
191
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
192
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
193
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
194
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> may_be_blocked</code></em>);
195
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
196
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
197
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>);
198
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
199
- <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_signal</code></em>);
200
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
201
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> instance_type</code></em>,
202
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *class_closure</code></em>);
203
- <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> (<em class="parameter"><code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *instance_and_params</code></em>,
204
- <em class="parameter"><code><a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *return_value</code></em>);
205
- <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> (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_name</code></em>,
206
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> itype</code></em>,
207
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="type">GSignalFlags</span></a> signal_flags</code></em>,
208
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="type">GCallback</span></a> class_handler</code></em>,
209
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="type">GSignalAccumulator</span></a> accumulator</code></em>,
210
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> accu_data</code></em>,
211
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller"><span class="type">GSignalCMarshaller</span></a> c_marshaller</code></em>,
212
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> return_type</code></em>,
213
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_params</code></em>,
214
- <em class="parameter"><code>...</code></em>);
215
- <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> (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_name</code></em>,
216
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> instance_type</code></em>,
217
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="type">GCallback</span></a> class_handler</code></em>);
218
- <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>
219
- (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
220
- <em class="parameter"><code>...</code></em>);
221
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
222
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
223
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalEmissionHook" title="GSignalEmissionHook ()"><span class="type">GSignalEmissionHook</span></a> hook_func</code></em>,
224
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> hook_data</code></em>,
225
- <em class="parameter"><code><a href="./../glib/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> data_destroy</code></em>);
226
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
227
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> hook_id</code></em>);
228
- <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> (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_signal</code></em>,
229
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> itype</code></em>,
230
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *signal_id_p</code></em>,
231
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> *detail_p</code></em>,
232
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> force_detail_quark</code></em>);
233
- <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> (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>);
234
- <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> (<em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> itype</code></em>,
235
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> struct_offset</code></em>);
236
- <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> (<em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="type">GSignalInvocationHint</span></a> *ihint</code></em>,
237
- <em class="parameter"><code><a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *return_accu</code></em>,
238
- <em class="parameter"><code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *handler_return</code></em>,
239
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> dummy</code></em>);
240
- </pre>
241
- </div>
242
- <div class="refsect1">
243
- <a name="gobject-Signals.description"></a><h2>Description</h2>
244
- <p>
245
- The basic concept of the signal system is that of the
246
- <span class="emphasis"><em>emission</em></span> of a signal. Signals are introduced
247
- per-type and are identified through strings. Signals introduced
248
- for a parent type are available in derived types as well, so
249
- basically they are a per-type facility that is inherited. A signal
250
- emission mainly involves invocation of a certain set of callbacks
251
- in precisely defined manner. There are two main categories of such
252
- callbacks, per-object
253
- <sup>[<a name="id467280" href="#ftn.id467280" class="footnote">10</a>]</sup>
254
- ones and user provided ones.
255
- The per-object callbacks are most often referred to as "object method
256
- handler" or "default (signal) handler", while user provided callbacks are
257
- usually just called "signal handler".
258
- The object method handler is provided at signal creation time (this most
259
- frequently happens at the end of an object class' creation), while user
260
- provided handlers are frequently connected and disconnected to/from a certain
261
- signal on certain object instances.
262
- </p>
263
- <p>
264
- A signal emission consists of five stages, unless prematurely stopped:
265
- </p>
266
- <div class="variablelist"><table border="0">
267
- <col align="left" valign="top">
268
- <tbody>
269
- <tr>
270
- <td><p><span class="term"></span></p></td>
271
- <td><p>
272
- 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
273
- </p></td>
274
- </tr>
275
- <tr>
276
- <td><p><span class="term"></span></p></td>
277
- <td><p>
278
- 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>)
279
- </p></td>
280
- </tr>
281
- <tr>
282
- <td><p><span class="term"></span></p></td>
283
- <td><p>
284
- 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
285
- </p></td>
286
- </tr>
287
- <tr>
288
- <td><p><span class="term"></span></p></td>
289
- <td><p>
290
- 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>
291
- </p></td>
292
- </tr>
293
- <tr>
294
- <td><p><span class="term"></span></p></td>
295
- <td><p>
296
- 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
297
- </p></td>
298
- </tr>
299
- </tbody>
300
- </table></div>
301
- <p>
302
- The user-provided signal handlers are called in the order they were
303
- connected in.
304
- All handlers may prematurely stop a signal emission, and any number of
305
- handlers may be connected, disconnected, blocked or unblocked during
306
- a signal emission.
307
- There are certain criteria for skipping user handlers in stages 2 and 4
308
- of a signal emission.
309
- First, user handlers may be <span class="emphasis"><em>blocked</em></span>, blocked handlers are omitted
310
- during callback invocation, to return from the "blocked" state, a
311
- handler has to get unblocked exactly the same amount of times
312
- it has been blocked before.
313
- 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
314
- "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
315
- argument of the signal handler currently subject to invocation.
316
- Specification of no detail argument for signal handlers (omission of the
317
- detail part of the signal specification upon connection) serves as a
318
- wildcard and matches any detail argument passed in to emission.
319
- </p>
320
- </div>
321
- <div class="refsect1">
322
- <a name="gobject-Signals.details"></a><h2>Details</h2>
323
- <div class="refsect2">
324
- <a name="GSignalInvocationHint"></a><h3>GSignalInvocationHint</h3>
325
- <pre class="programlisting">typedef struct {
326
- guint signal_id;
327
- GQuark detail;
328
- GSignalFlags run_type;
329
- } GSignalInvocationHint;
330
- </pre>
331
- <p>
332
- 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
333
- to callbacks during a signal emission.
334
- </p>
335
- <div class="variablelist"><table border="0">
336
- <col align="left" valign="top">
337
- <tbody>
338
- <tr>
339
- <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>
340
- <td>The signal id of the signal invoking the callback
341
- </td>
342
- </tr>
343
- <tr>
344
- <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>
345
- <td>The detail passed on for this emission
346
- </td>
347
- </tr>
348
- <tr>
349
- <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>
350
- <td>The stage the signal emission is currently in, this
351
- 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>,
352
- <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>.
353
- </td>
354
- </tr>
355
- </tbody>
356
- </table></div>
357
- </div>
358
- <hr>
359
- <div class="refsect2">
360
- <a name="GSignalAccumulator"></a><h3>GSignalAccumulator ()</h3>
361
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (*GSignalAccumulator) (<em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="type">GSignalInvocationHint</span></a> *ihint</code></em>,
362
- <em class="parameter"><code><a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *return_accu</code></em>,
363
- <em class="parameter"><code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *handler_return</code></em>,
364
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
365
- <p>
366
- The signal accumulator is a special callback function that can be used
367
- to collect return values of the various callbacks that are called
368
- during a signal emission. The signal accumulator is specified at signal
369
- 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
370
- values is performed. The return value of signal emissions is then the
371
- value returned by the last callback.
372
- </p>
373
- <div class="variablelist"><table border="0">
374
- <col align="left" valign="top">
375
- <tbody>
376
- <tr>
377
- <td><p><span class="term"><em class="parameter"><code>ihint</code></em> :</span></p></td>
378
- <td>Signal invocation hint, see <a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="type">GSignalInvocationHint</span></a>.
379
- </td>
380
- </tr>
381
- <tr>
382
- <td><p><span class="term"><em class="parameter"><code>return_accu</code></em> :</span></p></td>
383
- <td>Accumulator to collect callback return values in, this
384
- is the return value of the current signal emission.
385
- </td>
386
- </tr>
387
- <tr>
388
- <td><p><span class="term"><em class="parameter"><code>handler_return</code></em> :</span></p></td>
389
- <td>A <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> holding the return value of the signal handler.
390
- </td>
391
- </tr>
392
- <tr>
393
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
394
- <td>Callback data that was specified when creating the signal.
395
- </td>
396
- </tr>
397
- <tr>
398
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
399
- <td> The accumulator function returns whether the signal emission
400
- should be aborted. Returning <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> means to abort the
401
- current emission and <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned for continuation.
402
- </td>
403
- </tr>
404
- </tbody>
405
- </table></div>
406
- </div>
407
- <hr>
408
- <div class="refsect2">
409
- <a name="GSignalCMarshaller"></a><h3>GSignalCMarshaller</h3>
410
- <pre class="programlisting">typedef GClosureMarshal GSignalCMarshaller;
411
- </pre>
412
- <p>
413
- This is the signature of marshaller functions, required to marshall
414
- arrays of parameter values to signal emissions into C language callback
415
- 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>
416
- mechanism takes over responsibility of actual function invocation for the
417
- signal system.
418
- </p>
419
- </div>
420
- <hr>
421
- <div class="refsect2">
422
- <a name="GSignalEmissionHook"></a><h3>GSignalEmissionHook ()</h3>
423
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (*GSignalEmissionHook) (<em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="type">GSignalInvocationHint</span></a> *ihint</code></em>,
424
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_param_values</code></em>,
425
- <em class="parameter"><code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *param_values</code></em>,
426
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
427
- <p>
428
- A simple function pointer to get invoked when the signal is emitted. This
429
- allows you to tie a hook to the signal type, so that it will trap all
430
- emissions of that signal, from any object.
431
- </p>
432
- <p>
433
- 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.
434
- </p>
435
- <div class="variablelist"><table border="0">
436
- <col align="left" valign="top">
437
- <tbody>
438
- <tr>
439
- <td><p><span class="term"><em class="parameter"><code>ihint</code></em> :</span></p></td>
440
- <td>Signal invocation hint, see <a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="type">GSignalInvocationHint</span></a>.
441
- </td>
442
- </tr>
443
- <tr>
444
- <td><p><span class="term"><em class="parameter"><code>n_param_values</code></em> :</span></p></td>
445
- <td>the number of parameters to the function, including
446
- the instance on which the signal was emitted.
447
- </td>
448
- </tr>
449
- <tr>
450
- <td><p><span class="term"><em class="parameter"><code>param_values</code></em> :</span></p></td>
451
- <td>the instance on which the signal was emitted, followed by the
452
- parameters of the emission.
453
- </td>
454
- </tr>
455
- <tr>
456
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
457
- <td>user data associated with the hook.
458
- </td>
459
- </tr>
460
- <tr>
461
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
462
- <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
463
- hook is disconnected (and destroyed).
464
- </td>
465
- </tr>
466
- </tbody>
467
- </table></div>
468
- </div>
469
- <hr>
470
- <div class="refsect2">
471
- <a name="GSignalFlags"></a><h3>enum GSignalFlags</h3>
472
- <pre class="programlisting">typedef enum
473
- {
474
- G_SIGNAL_RUN_FIRST = 1 &lt;&lt; 0,
475
- G_SIGNAL_RUN_LAST = 1 &lt;&lt; 1,
476
- G_SIGNAL_RUN_CLEANUP = 1 &lt;&lt; 2,
477
- G_SIGNAL_NO_RECURSE = 1 &lt;&lt; 3,
478
- G_SIGNAL_DETAILED = 1 &lt;&lt; 4,
479
- G_SIGNAL_ACTION = 1 &lt;&lt; 5,
480
- G_SIGNAL_NO_HOOKS = 1 &lt;&lt; 6
481
- } GSignalFlags;
482
- </pre>
483
- <p>
484
- The signal flags are used to specify a signal's behaviour, the overall
485
- signal description outlines how especially the RUN flags control the
486
- stages of a signal emission.
487
- </p>
488
- <div class="variablelist"><table border="0">
489
- <col align="left" valign="top">
490
- <tbody>
491
- <tr>
492
- <td><p><a name="G-SIGNAL-RUN-FIRST:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_RUN_FIRST</code></span></p></td>
493
- <td>Invoke the object method handler in the first emission stage.
494
- </td>
495
- </tr>
496
- <tr>
497
- <td><p><a name="G-SIGNAL-RUN-LAST:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_RUN_LAST</code></span></p></td>
498
- <td>Invoke the object method handler in the third emission stage.
499
- </td>
500
- </tr>
501
- <tr>
502
- <td><p><a name="G-SIGNAL-RUN-CLEANUP:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_RUN_CLEANUP</code></span></p></td>
503
- <td>Invoke the object method handler in the last emission stage.
504
- </td>
505
- </tr>
506
- <tr>
507
- <td><p><a name="G-SIGNAL-NO-RECURSE:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_NO_RECURSE</code></span></p></td>
508
- <td>Signals being emitted for an object while currently being in
509
- emission for this very object will not be emitted recursively,
510
- but instead cause the first emission to be restarted.
511
- </td>
512
- </tr>
513
- <tr>
514
- <td><p><a name="G-SIGNAL-DETAILED:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_DETAILED</code></span></p></td>
515
- <td>This signal supports "::detail" appendices to the signal name
516
- upon handler connections and emissions.
517
- </td>
518
- </tr>
519
- <tr>
520
- <td><p><a name="G-SIGNAL-ACTION:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_ACTION</code></span></p></td>
521
- <td>Action signals are signals that may freely be emitted on alive
522
- 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
523
- the need of being embedded into extra code that performs pre or
524
- post emission adjustments on the object. They can also be thought
525
- of as object methods which can be called generically by
526
- third-party code.
527
- </td>
528
- </tr>
529
- <tr>
530
- <td><p><a name="G-SIGNAL-NO-HOOKS:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_NO_HOOKS</code></span></p></td>
531
- <td>No emissions hooks are supported for this signal.
532
- </td>
533
- </tr>
534
- </tbody>
535
- </table></div>
536
- </div>
537
- <hr>
538
- <div class="refsect2">
539
- <a name="GSignalMatchType"></a><h3>enum GSignalMatchType</h3>
540
- <pre class="programlisting">typedef enum
541
- {
542
- G_SIGNAL_MATCH_ID = 1 &lt;&lt; 0,
543
- G_SIGNAL_MATCH_DETAIL = 1 &lt;&lt; 1,
544
- G_SIGNAL_MATCH_CLOSURE = 1 &lt;&lt; 2,
545
- G_SIGNAL_MATCH_FUNC = 1 &lt;&lt; 3,
546
- G_SIGNAL_MATCH_DATA = 1 &lt;&lt; 4,
547
- G_SIGNAL_MATCH_UNBLOCKED = 1 &lt;&lt; 5
548
- } GSignalMatchType;
549
- </pre>
550
- <p>
551
- 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>,
552
- <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>
553
- match signals by.
554
- </p>
555
- <div class="variablelist"><table border="0">
556
- <col align="left" valign="top">
557
- <tbody>
558
- <tr>
559
- <td><p><a name="G-SIGNAL-MATCH-ID:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_ID</code></span></p></td>
560
- <td>The signal id must be equal.
561
- </td>
562
- </tr>
563
- <tr>
564
- <td><p><a name="G-SIGNAL-MATCH-DETAIL:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_DETAIL</code></span></p></td>
565
- <td>The signal detail be equal.
566
- </td>
567
- </tr>
568
- <tr>
569
- <td><p><a name="G-SIGNAL-MATCH-CLOSURE:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_CLOSURE</code></span></p></td>
570
- <td>The closure must be the same.
571
- </td>
572
- </tr>
573
- <tr>
574
- <td><p><a name="G-SIGNAL-MATCH-FUNC:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_FUNC</code></span></p></td>
575
- <td>The C closure callback must be the same.
576
- </td>
577
- </tr>
578
- <tr>
579
- <td><p><a name="G-SIGNAL-MATCH-DATA:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_DATA</code></span></p></td>
580
- <td>The closure data must be the same.
581
- </td>
582
- </tr>
583
- <tr>
584
- <td><p><a name="G-SIGNAL-MATCH-UNBLOCKED:CAPS"></a><span class="term"><code class="literal">G_SIGNAL_MATCH_UNBLOCKED</code></span></p></td>
585
- <td>Only unblocked signals may matched.
586
- </td>
587
- </tr>
588
- </tbody>
589
- </table></div>
590
- </div>
591
- <hr>
592
- <div class="refsect2">
593
- <a name="GSignalQuery"></a><h3>GSignalQuery</h3>
594
- <pre class="programlisting">typedef struct {
595
- guint signal_id;
596
- const gchar *signal_name;
597
- GType itype;
598
- GSignalFlags signal_flags;
599
- GType return_type; /* mangled with G_SIGNAL_TYPE_STATIC_SCOPE flag */
600
- guint n_params;
601
- const GType *param_types; /* mangled with G_SIGNAL_TYPE_STATIC_SCOPE flag */
602
- } GSignalQuery;
603
- </pre>
604
- <p>
605
- A structure holding in-depth information for a specific signal. It is
606
- 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.
607
- </p>
608
- <div class="variablelist"><table border="0">
609
- <col align="left" valign="top">
610
- <tbody>
611
- <tr>
612
- <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>
613
- <td>The signal id of the signal being queried, or 0 if the
614
- signal to be queried was unknown.
615
- </td>
616
- </tr>
617
- <tr>
618
- <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>
619
- <td>The signal name.
620
- </td>
621
- </tr>
622
- <tr>
623
- <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>
624
- <td>The interface/instance type that this signal can be emitted for.
625
- </td>
626
- </tr>
627
- <tr>
628
- <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>
629
- <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>.
630
- </td>
631
- </tr>
632
- <tr>
633
- <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>
634
- <td>The return type for user callbacks.
635
- </td>
636
- </tr>
637
- <tr>
638
- <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>
639
- <td>The number of parameters that user callbacks take.
640
- </td>
641
- </tr>
642
- <tr>
643
- <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>
644
- <td>The individual parameter types for user callbacks, note that the
645
- effective callback signature is:
646
- <pre class="programlisting">
647
- @return_type callback (<a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> data1,
648
- [param_types param_names,]
649
- <a href="./../glib/glib/glib-Basic-Types.html#gpointer">gpointer</a> data2);
650
- </pre>
651
- </td>
652
- </tr>
653
- </tbody>
654
- </table></div>
655
- </div>
656
- <hr>
657
- <div class="refsect2">
658
- <a name="G-SIGNAL-TYPE-STATIC-SCOPE:CAPS"></a><h3>G_SIGNAL_TYPE_STATIC_SCOPE</h3>
659
- <pre class="programlisting">#define G_SIGNAL_TYPE_STATIC_SCOPE (G_TYPE_FLAG_RESERVED_ID_BIT)
660
- </pre>
661
- <p>
662
- This macro flags signal argument types for which the signal system may
663
- assume that instances thereof remain persistent across all signal emissions
664
- they are used in. This is only useful for non ref-counted, value-copy types.
665
- </p>
666
- <p>
667
- To flag a signal argument in this way, add
668
- <code class="literal">| G_SIGNAL_TYPE_STATIC_SCOPE</code> to the corresponding argument
669
- of <a class="link" href="gobject-Signals.html#g-signal-new" title="g_signal_new ()"><code class="function">g_signal_new()</code></a>.
670
- </p>
671
- <div class="informalexample">
672
- <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
673
- <tbody>
674
- <tr>
675
- <td class="listing_lines" align="right"><pre>1
676
- 2
677
- 3
678
- 4
679
- 5
680
- 6
681
- 7
682
- 8</pre></td>
683
- <td class="listing_code"><pre class="programlisting"><span class="function"><a href="gobject-Signals.html#g-signal-new">g_signal_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"size_request"</span><span class="symbol">,</span>
684
- <span class="normal"> </span><span class="function"><a href="gobject-Type-Information.html#G-TYPE-FROM-CLASS:CAPS">G_TYPE_FROM_CLASS</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">gobject_class</span><span class="symbol">),</span>
685
- <span class="normal"> <a href="gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">G_SIGNAL_RUN_FIRST</a></span><span class="symbol">,</span>
686
- <span class="normal"> </span><span class="function"><a href="./../glib/glib/glib-Standard-Macros.html#G-STRUCT-OFFSET:CAPS">G_STRUCT_OFFSET</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html#GtkWidgetClass">GtkWidgetClass</a></span><span class="symbol">,</span><span class="normal"> size_request</span><span class="symbol">),</span>
687
- <span class="normal"> <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span>
688
- <span class="normal"> _gtk_marshal_VOID__BOXED</span><span class="symbol">,</span>
689
- <span class="normal"> <a href="gobject-Type-Information.html#G-TYPE-NONE:CAPS">G_TYPE_NONE</a></span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">,</span>
690
- <span class="normal"> GTK_TYPE_REQUISITION </span><span class="symbol">|</span><span class="normal"> <a href="gobject-Signals.html#G-SIGNAL-TYPE-STATIC-SCOPE:CAPS">G_SIGNAL_TYPE_STATIC_SCOPE</a></span><span class="symbol">);</span></pre></td>
691
- </tr>
692
- </tbody>
693
- </table>
694
- </div>
695
-
696
- <p>
697
- </p>
698
- </div>
699
- <hr>
700
- <div class="refsect2">
701
- <a name="G-SIGNAL-MATCH-MASK:CAPS"></a><h3>G_SIGNAL_MATCH_MASK</h3>
702
- <pre class="programlisting">#define G_SIGNAL_MATCH_MASK 0x3f
703
- </pre>
704
- <p>
705
- A mask for all <a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="type">GSignalMatchType</span></a> bits.
706
- </p>
707
- </div>
708
- <hr>
709
- <div class="refsect2">
710
- <a name="G-SIGNAL-FLAGS-MASK:CAPS"></a><h3>G_SIGNAL_FLAGS_MASK</h3>
711
- <pre class="programlisting">#define G_SIGNAL_FLAGS_MASK 0x7f
712
- </pre>
713
- <p>
714
- A mask for all <a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="type">GSignalFlags</span></a> bits.
715
- </p>
716
- </div>
717
- <hr>
718
- <div class="refsect2">
719
- <a name="g-signal-new"></a><h3>g_signal_new ()</h3>
720
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_signal_new (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_name</code></em>,
721
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> itype</code></em>,
722
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="type">GSignalFlags</span></a> signal_flags</code></em>,
723
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> class_offset</code></em>,
724
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="type">GSignalAccumulator</span></a> accumulator</code></em>,
725
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> accu_data</code></em>,
726
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller"><span class="type">GSignalCMarshaller</span></a> c_marshaller</code></em>,
727
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> return_type</code></em>,
728
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_params</code></em>,
729
- <em class="parameter"><code>...</code></em>);</pre>
730
- <p>
731
- Creates a new signal. (This is usually done in the class initializer.)
732
- </p>
733
- <p>
734
- A signal name consists of segments consisting of ASCII letters and
735
- digits, separated by either the '-' or '_' character. The first
736
- character of a signal name must be a letter. Names which violate these
737
- rules lead to undefined behaviour of the GSignal system.
738
- </p>
739
- <p>
740
- When registering a signal and looking up a signal, either separator can
741
- be used, but they cannot be mixed.
742
- </p>
743
- <p>
744
- If 0 is used for <em class="parameter"><code>class_offset</code></em> subclasses cannot override the class handler
745
- in their <code class="code">class_init</code> method by doing
746
- <code class="code">super_class-&gt;signal_handler = my_signal_handler</code>. Instead they
747
- 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>.
748
- </p>
749
- <div class="variablelist"><table border="0">
750
- <col align="left" valign="top">
751
- <tbody>
752
- <tr>
753
- <td><p><span class="term"><em class="parameter"><code>signal_name</code></em> :</span></p></td>
754
- <td>the name for the signal
755
- </td>
756
- </tr>
757
- <tr>
758
- <td><p><span class="term"><em class="parameter"><code>itype</code></em> :</span></p></td>
759
- <td>the type this signal pertains to. It will also pertain to
760
- types which are derived from this type.
761
- </td>
762
- </tr>
763
- <tr>
764
- <td><p><span class="term"><em class="parameter"><code>signal_flags</code></em> :</span></p></td>
765
- <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
766
- the default handler is to be invoked. You should at least specify
767
- <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>.
768
- </td>
769
- </tr>
770
- <tr>
771
- <td><p><span class="term"><em class="parameter"><code>class_offset</code></em> :</span></p></td>
772
- <td>The offset of the function pointer in the class structure
773
- for this type. Used to invoke a class method generically. Pass 0 to
774
- not associate a class method slot with this signal.
775
- </td>
776
- </tr>
777
- <tr>
778
- <td><p><span class="term"><em class="parameter"><code>accumulator</code></em> :</span></p></td>
779
- <td>the accumulator for this signal; may be <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
780
- </td>
781
- </tr>
782
- <tr>
783
- <td><p><span class="term"><em class="parameter"><code>accu_data</code></em> :</span></p></td>
784
- <td>user data for the <em class="parameter"><code>accumulator</code></em>.
785
- </td>
786
- </tr>
787
- <tr>
788
- <td><p><span class="term"><em class="parameter"><code>c_marshaller</code></em> :</span></p></td>
789
- <td>the function to translate arrays of parameter values to
790
- signal emissions into C language callback invocations.
791
- </td>
792
- </tr>
793
- <tr>
794
- <td><p><span class="term"><em class="parameter"><code>return_type</code></em> :</span></p></td>
795
- <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
796
- without a return value.
797
- </td>
798
- </tr>
799
- <tr>
800
- <td><p><span class="term"><em class="parameter"><code>n_params</code></em> :</span></p></td>
801
- <td>the number of parameter types to follow.
802
- </td>
803
- </tr>
804
- <tr>
805
- <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
806
- <td>a list of types, one for each parameter.
807
- </td>
808
- </tr>
809
- <tr>
810
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
811
- <td> the signal id
812
- </td>
813
- </tr>
814
- </tbody>
815
- </table></div>
816
- </div>
817
- <hr>
818
- <div class="refsect2">
819
- <a name="g-signal-newv"></a><h3>g_signal_newv ()</h3>
820
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_signal_newv (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_name</code></em>,
821
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> itype</code></em>,
822
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="type">GSignalFlags</span></a> signal_flags</code></em>,
823
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *class_closure</code></em>,
824
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="type">GSignalAccumulator</span></a> accumulator</code></em>,
825
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> accu_data</code></em>,
826
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller"><span class="type">GSignalCMarshaller</span></a> c_marshaller</code></em>,
827
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> return_type</code></em>,
828
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_params</code></em>,
829
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> *param_types</code></em>);</pre>
830
- <p>
831
- Creates a new signal. (This is usually done in the class initializer.)
832
- </p>
833
- <p>
834
- 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.
835
- </p>
836
- <div class="variablelist"><table border="0">
837
- <col align="left" valign="top">
838
- <tbody>
839
- <tr>
840
- <td><p><span class="term"><em class="parameter"><code>signal_name</code></em> :</span></p></td>
841
- <td>the name for the signal
842
- </td>
843
- </tr>
844
- <tr>
845
- <td><p><span class="term"><em class="parameter"><code>itype</code></em> :</span></p></td>
846
- <td>the type this signal pertains to. It will also pertain to
847
- types which are derived from this type
848
- </td>
849
- </tr>
850
- <tr>
851
- <td><p><span class="term"><em class="parameter"><code>signal_flags</code></em> :</span></p></td>
852
- <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
853
- the default handler is to be invoked. You should at least specify
854
- <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>
855
- </td>
856
- </tr>
857
- <tr>
858
- <td><p><span class="term"><em class="parameter"><code>class_closure</code></em> :</span></p></td>
859
- <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>
860
- </td>
861
- </tr>
862
- <tr>
863
- <td><p><span class="term"><em class="parameter"><code>accumulator</code></em> :</span></p></td>
864
- <td>the accumulator for this signal; may be <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
865
- </td>
866
- </tr>
867
- <tr>
868
- <td><p><span class="term"><em class="parameter"><code>accu_data</code></em> :</span></p></td>
869
- <td>user data for the <em class="parameter"><code>accumulator</code></em>
870
- </td>
871
- </tr>
872
- <tr>
873
- <td><p><span class="term"><em class="parameter"><code>c_marshaller</code></em> :</span></p></td>
874
- <td>the function to translate arrays of parameter values to
875
- signal emissions into C language callback invocations
876
- </td>
877
- </tr>
878
- <tr>
879
- <td><p><span class="term"><em class="parameter"><code>return_type</code></em> :</span></p></td>
880
- <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
881
- without a return value
882
- </td>
883
- </tr>
884
- <tr>
885
- <td><p><span class="term"><em class="parameter"><code>n_params</code></em> :</span></p></td>
886
- <td>the length of <em class="parameter"><code>param_types</code></em>
887
- </td>
888
- </tr>
889
- <tr>
890
- <td><p><span class="term"><em class="parameter"><code>param_types</code></em> :</span></p></td>
891
- <td>an array of types, one for each parameter
892
- </td>
893
- </tr>
894
- <tr>
895
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
896
- <td> the signal id
897
- </td>
898
- </tr>
899
- </tbody>
900
- </table></div>
901
- </div>
902
- <hr>
903
- <div class="refsect2">
904
- <a name="g-signal-new-valist"></a><h3>g_signal_new_valist ()</h3>
905
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_signal_new_valist (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_name</code></em>,
906
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> itype</code></em>,
907
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="type">GSignalFlags</span></a> signal_flags</code></em>,
908
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *class_closure</code></em>,
909
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="type">GSignalAccumulator</span></a> accumulator</code></em>,
910
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> accu_data</code></em>,
911
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller"><span class="type">GSignalCMarshaller</span></a> c_marshaller</code></em>,
912
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> return_type</code></em>,
913
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_params</code></em>,
914
- <em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
915
- <p>
916
- Creates a new signal. (This is usually done in the class initializer.)
917
- </p>
918
- <p>
919
- 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.
920
- </p>
921
- <div class="variablelist"><table border="0">
922
- <col align="left" valign="top">
923
- <tbody>
924
- <tr>
925
- <td><p><span class="term"><em class="parameter"><code>signal_name</code></em> :</span></p></td>
926
- <td>the name for the signal
927
- </td>
928
- </tr>
929
- <tr>
930
- <td><p><span class="term"><em class="parameter"><code>itype</code></em> :</span></p></td>
931
- <td>the type this signal pertains to. It will also pertain to
932
- types which are derived from this type.
933
- </td>
934
- </tr>
935
- <tr>
936
- <td><p><span class="term"><em class="parameter"><code>signal_flags</code></em> :</span></p></td>
937
- <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
938
- the default handler is to be invoked. You should at least specify
939
- <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>.
940
- </td>
941
- </tr>
942
- <tr>
943
- <td><p><span class="term"><em class="parameter"><code>class_closure</code></em> :</span></p></td>
944
- <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>.
945
- </td>
946
- </tr>
947
- <tr>
948
- <td><p><span class="term"><em class="parameter"><code>accumulator</code></em> :</span></p></td>
949
- <td>the accumulator for this signal; may be <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
950
- </td>
951
- </tr>
952
- <tr>
953
- <td><p><span class="term"><em class="parameter"><code>accu_data</code></em> :</span></p></td>
954
- <td>user data for the <em class="parameter"><code>accumulator</code></em>.
955
- </td>
956
- </tr>
957
- <tr>
958
- <td><p><span class="term"><em class="parameter"><code>c_marshaller</code></em> :</span></p></td>
959
- <td>the function to translate arrays of parameter values to
960
- signal emissions into C language callback invocations.
961
- </td>
962
- </tr>
963
- <tr>
964
- <td><p><span class="term"><em class="parameter"><code>return_type</code></em> :</span></p></td>
965
- <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
966
- without a return value.
967
- </td>
968
- </tr>
969
- <tr>
970
- <td><p><span class="term"><em class="parameter"><code>n_params</code></em> :</span></p></td>
971
- <td>the number of parameter types in <em class="parameter"><code>args</code></em>.
972
- </td>
973
- </tr>
974
- <tr>
975
- <td><p><span class="term"><em class="parameter"><code>args</code></em> :</span></p></td>
976
- <td>va_list of <a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a>, one for each parameter.
977
- </td>
978
- </tr>
979
- <tr>
980
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
981
- <td> the signal id
982
- </td>
983
- </tr>
984
- </tbody>
985
- </table></div>
986
- </div>
987
- <hr>
988
- <div class="refsect2">
989
- <a name="g-signal-query"></a><h3>g_signal_query ()</h3>
990
- <pre class="programlisting"><span class="returnvalue">void</span> g_signal_query (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
991
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalQuery" title="GSignalQuery"><span class="type">GSignalQuery</span></a> *query</code></em>);</pre>
992
- <p>
993
- Queries the signal system for in-depth information about a
994
- specific signal. This function will fill in a user-provided
995
- structure to hold signal-specific information. If an invalid
996
- 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>
997
- 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
998
- be considered constant and have to be left untouched.
999
- </p>
1000
- <div class="variablelist"><table border="0">
1001
- <col align="left" valign="top">
1002
- <tbody>
1003
- <tr>
1004
- <td><p><span class="term"><em class="parameter"><code>signal_id</code></em> :</span></p></td>
1005
- <td>The signal id of the signal to query information for.
1006
- </td>
1007
- </tr>
1008
- <tr>
1009
- <td><p><span class="term"><em class="parameter"><code>query</code></em> :</span></p></td>
1010
- <td>A user provided structure that is filled in with constant
1011
- values upon success.
1012
- </td>
1013
- </tr>
1014
- </tbody>
1015
- </table></div>
1016
- </div>
1017
- <hr>
1018
- <div class="refsect2">
1019
- <a name="g-signal-lookup"></a><h3>g_signal_lookup ()</h3>
1020
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_signal_lookup (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
1021
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> itype</code></em>);</pre>
1022
- <p>
1023
- Given the name of the signal and the type of object it connects to, gets
1024
- the signal's identifying integer. Emitting the signal by number is
1025
- somewhat faster than using the name each time.
1026
- </p>
1027
- <p>
1028
- Also tries the ancestors of the given type.
1029
- </p>
1030
- <p>
1031
- 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.
1032
- </p>
1033
- <div class="variablelist"><table border="0">
1034
- <col align="left" valign="top">
1035
- <tbody>
1036
- <tr>
1037
- <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
1038
- <td>the signal's name.
1039
- </td>
1040
- </tr>
1041
- <tr>
1042
- <td><p><span class="term"><em class="parameter"><code>itype</code></em> :</span></p></td>
1043
- <td>the type that the signal operates on.
1044
- </td>
1045
- </tr>
1046
- <tr>
1047
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1048
- <td> the signal's identifying number, or 0 if no signal was found.
1049
- </td>
1050
- </tr>
1051
- </tbody>
1052
- </table></div>
1053
- </div>
1054
- <hr>
1055
- <div class="refsect2">
1056
- <a name="g-signal-name"></a><h3>g_signal_name ()</h3>
1057
- <pre class="programlisting">const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * g_signal_name (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>);</pre>
1058
- <p>
1059
- Given the signal's identifier, finds its name.
1060
- </p>
1061
- <p>
1062
- Two different signals may have the same name, if they have differing types.
1063
- </p>
1064
- <div class="variablelist"><table border="0">
1065
- <col align="left" valign="top">
1066
- <tbody>
1067
- <tr>
1068
- <td><p><span class="term"><em class="parameter"><code>signal_id</code></em> :</span></p></td>
1069
- <td>the signal's identifying number.
1070
- </td>
1071
- </tr>
1072
- <tr>
1073
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1074
- <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.
1075
- </td>
1076
- </tr>
1077
- </tbody>
1078
- </table></div>
1079
- </div>
1080
- <hr>
1081
- <div class="refsect2">
1082
- <a name="g-signal-list-ids"></a><h3>g_signal_list_ids ()</h3>
1083
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> * g_signal_list_ids (<em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> itype</code></em>,
1084
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *n_ids</code></em>);</pre>
1085
- <p>
1086
- Lists the signals by id that a certain instance or interface type
1087
- created. Further information about the signals can be acquired through
1088
- <a class="link" href="gobject-Signals.html#g-signal-query" title="g_signal_query ()"><code class="function">g_signal_query()</code></a>.
1089
- </p>
1090
- <div class="variablelist"><table border="0">
1091
- <col align="left" valign="top">
1092
- <tbody>
1093
- <tr>
1094
- <td><p><span class="term"><em class="parameter"><code>itype</code></em> :</span></p></td>
1095
- <td>Instance or interface type.
1096
- </td>
1097
- </tr>
1098
- <tr>
1099
- <td><p><span class="term"><em class="parameter"><code>n_ids</code></em> :</span></p></td>
1100
- <td>Location to store the number of signal ids for <em class="parameter"><code>itype</code></em>.
1101
- </td>
1102
- </tr>
1103
- <tr>
1104
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1105
- <td> Newly allocated array of signal IDs.
1106
- </td>
1107
- </tr>
1108
- </tbody>
1109
- </table></div>
1110
- </div>
1111
- <hr>
1112
- <div class="refsect2">
1113
- <a name="g-signal-emit"></a><h3>g_signal_emit ()</h3>
1114
- <pre class="programlisting"><span class="returnvalue">void</span> g_signal_emit (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
1115
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
1116
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
1117
- <em class="parameter"><code>...</code></em>);</pre>
1118
- <p>
1119
- Emits a signal.
1120
- </p>
1121
- <p>
1122
- 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
1123
- 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>.
1124
- </p>
1125
- <div class="variablelist"><table border="0">
1126
- <col align="left" valign="top">
1127
- <tbody>
1128
- <tr>
1129
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
1130
- <td>the instance the signal is being emitted on.
1131
- </td>
1132
- </tr>
1133
- <tr>
1134
- <td><p><span class="term"><em class="parameter"><code>signal_id</code></em> :</span></p></td>
1135
- <td>the signal id
1136
- </td>
1137
- </tr>
1138
- <tr>
1139
- <td><p><span class="term"><em class="parameter"><code>detail</code></em> :</span></p></td>
1140
- <td>the detail
1141
- </td>
1142
- </tr>
1143
- <tr>
1144
- <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1145
- <td>parameters to be passed to the signal, followed by a
1146
- location for the return value. If the return type of the signal
1147
- 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.
1148
- </td>
1149
- </tr>
1150
- </tbody>
1151
- </table></div>
1152
- </div>
1153
- <hr>
1154
- <div class="refsect2">
1155
- <a name="g-signal-emit-by-name"></a><h3>g_signal_emit_by_name ()</h3>
1156
- <pre class="programlisting"><span class="returnvalue">void</span> g_signal_emit_by_name (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
1157
- <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_signal</code></em>,
1158
- <em class="parameter"><code>...</code></em>);</pre>
1159
- <p>
1160
- Emits a signal.
1161
- </p>
1162
- <p>
1163
- 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
1164
- 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>.
1165
- </p>
1166
- <div class="variablelist"><table border="0">
1167
- <col align="left" valign="top">
1168
- <tbody>
1169
- <tr>
1170
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
1171
- <td>the instance the signal is being emitted on.
1172
- </td>
1173
- </tr>
1174
- <tr>
1175
- <td><p><span class="term"><em class="parameter"><code>detailed_signal</code></em> :</span></p></td>
1176
- <td>a string of the form "signal-name::detail".
1177
- </td>
1178
- </tr>
1179
- <tr>
1180
- <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1181
- <td>parameters to be passed to the signal, followed by a
1182
- location for the return value. If the return type of the signal
1183
- 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.
1184
- </td>
1185
- </tr>
1186
- </tbody>
1187
- </table></div>
1188
- </div>
1189
- <hr>
1190
- <div class="refsect2">
1191
- <a name="g-signal-emitv"></a><h3>g_signal_emitv ()</h3>
1192
- <pre class="programlisting"><span class="returnvalue">void</span> g_signal_emitv (<em class="parameter"><code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *instance_and_params</code></em>,
1193
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
1194
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
1195
- <em class="parameter"><code><a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *return_value</code></em>);</pre>
1196
- <p>
1197
- Emits a signal.
1198
- </p>
1199
- <p>
1200
- 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
1201
- 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>.
1202
- </p>
1203
- <div class="variablelist"><table border="0">
1204
- <col align="left" valign="top">
1205
- <tbody>
1206
- <tr>
1207
- <td><p><span class="term"><em class="parameter"><code>instance_and_params</code></em> :</span></p></td>
1208
- <td>argument list for the signal emission. The first
1209
- element in the array is a <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> for the instance the signal is
1210
- being emitted on. The rest are any arguments to be passed to the
1211
- signal.
1212
- </td>
1213
- </tr>
1214
- <tr>
1215
- <td><p><span class="term"><em class="parameter"><code>signal_id</code></em> :</span></p></td>
1216
- <td>the signal id
1217
- </td>
1218
- </tr>
1219
- <tr>
1220
- <td><p><span class="term"><em class="parameter"><code>detail</code></em> :</span></p></td>
1221
- <td>the detail
1222
- </td>
1223
- </tr>
1224
- <tr>
1225
- <td><p><span class="term"><em class="parameter"><code>return_value</code></em> :</span></p></td>
1226
- <td>Location to store the return value of the signal emission.
1227
- </td>
1228
- </tr>
1229
- </tbody>
1230
- </table></div>
1231
- </div>
1232
- <hr>
1233
- <div class="refsect2">
1234
- <a name="g-signal-emit-valist"></a><h3>g_signal_emit_valist ()</h3>
1235
- <pre class="programlisting"><span class="returnvalue">void</span> g_signal_emit_valist (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
1236
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
1237
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
1238
- <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
1239
- <p>
1240
- Emits a signal.
1241
- </p>
1242
- <p>
1243
- 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
1244
- 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>.
1245
- </p>
1246
- <div class="variablelist"><table border="0">
1247
- <col align="left" valign="top">
1248
- <tbody>
1249
- <tr>
1250
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
1251
- <td>the instance the signal is being emitted on.
1252
- </td>
1253
- </tr>
1254
- <tr>
1255
- <td><p><span class="term"><em class="parameter"><code>signal_id</code></em> :</span></p></td>
1256
- <td>the signal id
1257
- </td>
1258
- </tr>
1259
- <tr>
1260
- <td><p><span class="term"><em class="parameter"><code>detail</code></em> :</span></p></td>
1261
- <td>the detail
1262
- </td>
1263
- </tr>
1264
- <tr>
1265
- <td><p><span class="term"><em class="parameter"><code>var_args</code></em> :</span></p></td>
1266
- <td>a list of parameters to be passed to the signal, followed by a
1267
- location for the return value. If the return type of the signal
1268
- 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.
1269
- </td>
1270
- </tr>
1271
- </tbody>
1272
- </table></div>
1273
- </div>
1274
- <hr>
1275
- <div class="refsect2">
1276
- <a name="g-signal-connect"></a><h3>g_signal_connect()</h3>
1277
- <pre class="programlisting">#define g_signal_connect(instance, detailed_signal, c_handler, data)</pre>
1278
- <p>
1279
- 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.
1280
- </p>
1281
- <p>
1282
- The handler will be called before the default handler of the signal.
1283
- </p>
1284
- <div class="variablelist"><table border="0">
1285
- <col align="left" valign="top">
1286
- <tbody>
1287
- <tr>
1288
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
1289
- <td>the instance to connect to.
1290
- </td>
1291
- </tr>
1292
- <tr>
1293
- <td><p><span class="term"><em class="parameter"><code>detailed_signal</code></em> :</span></p></td>
1294
- <td>a string of the form "signal-name::detail".
1295
- </td>
1296
- </tr>
1297
- <tr>
1298
- <td><p><span class="term"><em class="parameter"><code>c_handler</code></em> :</span></p></td>
1299
- <td>the <a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="type">GCallback</span></a> to connect.
1300
- </td>
1301
- </tr>
1302
- <tr>
1303
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1304
- <td>data to pass to <em class="parameter"><code>c_handler</code></em> calls.
1305
- </td>
1306
- </tr>
1307
- <tr>
1308
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1309
- <td> the handler id
1310
- </td>
1311
- </tr>
1312
- </tbody>
1313
- </table></div>
1314
- </div>
1315
- <hr>
1316
- <div class="refsect2">
1317
- <a name="g-signal-connect-after"></a><h3>g_signal_connect_after()</h3>
1318
- <pre class="programlisting">#define g_signal_connect_after(instance, detailed_signal, c_handler, data)</pre>
1319
- <p>
1320
- 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.
1321
- </p>
1322
- <p>
1323
- The handler will be called after the default handler of the signal.
1324
- </p>
1325
- <div class="variablelist"><table border="0">
1326
- <col align="left" valign="top">
1327
- <tbody>
1328
- <tr>
1329
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
1330
- <td>the instance to connect to.
1331
- </td>
1332
- </tr>
1333
- <tr>
1334
- <td><p><span class="term"><em class="parameter"><code>detailed_signal</code></em> :</span></p></td>
1335
- <td>a string of the form "signal-name::detail".
1336
- </td>
1337
- </tr>
1338
- <tr>
1339
- <td><p><span class="term"><em class="parameter"><code>c_handler</code></em> :</span></p></td>
1340
- <td>the <a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="type">GCallback</span></a> to connect.
1341
- </td>
1342
- </tr>
1343
- <tr>
1344
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1345
- <td>data to pass to <em class="parameter"><code>c_handler</code></em> calls.
1346
- </td>
1347
- </tr>
1348
- <tr>
1349
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1350
- <td> the handler id
1351
- </td>
1352
- </tr>
1353
- </tbody>
1354
- </table></div>
1355
- </div>
1356
- <hr>
1357
- <div class="refsect2">
1358
- <a name="g-signal-connect-swapped"></a><h3>g_signal_connect_swapped()</h3>
1359
- <pre class="programlisting">#define g_signal_connect_swapped(instance, detailed_signal, c_handler, data)</pre>
1360
- <p>
1361
- 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.
1362
- </p>
1363
- <p>
1364
- The instance on which the signal is emitted and <em class="parameter"><code>data</code></em> will be swapped when
1365
- calling the handler.
1366
- </p>
1367
- <div class="variablelist"><table border="0">
1368
- <col align="left" valign="top">
1369
- <tbody>
1370
- <tr>
1371
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
1372
- <td>the instance to connect to.
1373
- </td>
1374
- </tr>
1375
- <tr>
1376
- <td><p><span class="term"><em class="parameter"><code>detailed_signal</code></em> :</span></p></td>
1377
- <td>a string of the form "signal-name::detail".
1378
- </td>
1379
- </tr>
1380
- <tr>
1381
- <td><p><span class="term"><em class="parameter"><code>c_handler</code></em> :</span></p></td>
1382
- <td>the <a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="type">GCallback</span></a> to connect.
1383
- </td>
1384
- </tr>
1385
- <tr>
1386
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1387
- <td>data to pass to <em class="parameter"><code>c_handler</code></em> calls.
1388
- </td>
1389
- </tr>
1390
- <tr>
1391
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1392
- <td> the handler id
1393
- </td>
1394
- </tr>
1395
- </tbody>
1396
- </table></div>
1397
- </div>
1398
- <hr>
1399
- <div class="refsect2">
1400
- <a name="g-signal-connect-object"></a><h3>g_signal_connect_object ()</h3>
1401
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> g_signal_connect_object (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
1402
- <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_signal</code></em>,
1403
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="type">GCallback</span></a> c_handler</code></em>,
1404
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> gobject</code></em>,
1405
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GConnectFlags" title="enum GConnectFlags"><span class="type">GConnectFlags</span></a> connect_flags</code></em>);</pre>
1406
- <p>
1407
- 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
1408
- ensures that the <em class="parameter"><code>gobject</code></em> stays alive during the call to <em class="parameter"><code>c_handler</code></em>
1409
- by temporarily adding a reference count to <em class="parameter"><code>gobject</code></em>.
1410
- </p>
1411
- <p>
1412
- Note that there is a bug in GObject that makes this function
1413
- much less useful than it might seem otherwise. Once <em class="parameter"><code>gobject</code></em> is
1414
- disposed, the callback will no longer be called, but, the signal
1415
- handler is <span class="emphasis"><em>not</em></span> currently disconnected. If the
1416
- <em class="parameter"><code>instance</code></em> is itself being freed at the same time than this doesn't
1417
- matter, since the signal will automatically be removed, but
1418
- if <em class="parameter"><code>instance</code></em> persists, then the signal handler will leak. You
1419
- should not remove the signal yourself because in a future versions of
1420
- GObject, the handler <span class="emphasis"><em>will</em></span> automatically
1421
- be disconnected.
1422
- </p>
1423
- <p>
1424
- It's possible to work around this problem in a way that will
1425
- continue to work with future versions of GObject by checking
1426
- that the signal handler is still connected before disconnected it:
1427
- </p>
1428
- <div class="informalexample">
1429
- <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1430
- <tbody>
1431
- <tr>
1432
- <td class="listing_lines" align="right"><pre>1
1433
- 2</pre></td>
1434
- <td class="listing_code"><pre class="programlisting"><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="gobject-Signals.html#g-signal-handler-is-connected">g_signal_handler_is_connected</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">instance</span><span class="symbol">,</span><span class="normal"> id</span><span class="symbol">))</span>
1435
- <span class="normal"> </span><span class="function"><a href="gobject-Signals.html#g-signal-handler-disconnect">g_signal_handler_disconnect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">instance</span><span class="symbol">,</span><span class="normal"> id</span><span class="symbol">);</span></pre></td>
1436
- </tr>
1437
- </tbody>
1438
- </table>
1439
- </div>
1440
-
1441
- <p>
1442
- </p>
1443
- <div class="variablelist"><table border="0">
1444
- <col align="left" valign="top">
1445
- <tbody>
1446
- <tr>
1447
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
1448
- <td>the instance to connect to.
1449
- </td>
1450
- </tr>
1451
- <tr>
1452
- <td><p><span class="term"><em class="parameter"><code>detailed_signal</code></em> :</span></p></td>
1453
- <td>a string of the form "signal-name::detail".
1454
- </td>
1455
- </tr>
1456
- <tr>
1457
- <td><p><span class="term"><em class="parameter"><code>c_handler</code></em> :</span></p></td>
1458
- <td>the <a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="type">GCallback</span></a> to connect.
1459
- </td>
1460
- </tr>
1461
- <tr>
1462
- <td><p><span class="term"><em class="parameter"><code>gobject</code></em> :</span></p></td>
1463
- <td>the object to pass as data to <em class="parameter"><code>c_handler</code></em>.
1464
- </td>
1465
- </tr>
1466
- <tr>
1467
- <td><p><span class="term"><em class="parameter"><code>connect_flags</code></em> :</span></p></td>
1468
- <td>a combination of <span class="type">GConnnectFlags</span>.
1469
- </td>
1470
- </tr>
1471
- <tr>
1472
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1473
- <td> the handler id.
1474
- </td>
1475
- </tr>
1476
- </tbody>
1477
- </table></div>
1478
- </div>
1479
- <hr>
1480
- <div class="refsect2">
1481
- <a name="GConnectFlags"></a><h3>enum GConnectFlags</h3>
1482
- <pre class="programlisting">typedef enum
1483
- {
1484
- G_CONNECT_AFTER = 1 &lt;&lt; 0,
1485
- G_CONNECT_SWAPPED = 1 &lt;&lt; 1
1486
- } GConnectFlags;
1487
- </pre>
1488
- <p>
1489
- The connection flags are used to specify the behaviour of a signal's
1490
- connection.
1491
- </p>
1492
- <div class="variablelist"><table border="0">
1493
- <col align="left" valign="top">
1494
- <tbody>
1495
- <tr>
1496
- <td><p><a name="G-CONNECT-AFTER:CAPS"></a><span class="term"><code class="literal">G_CONNECT_AFTER</code></span></p></td>
1497
- <td>whether the handler should be called before or after the
1498
- default handler of the signal.
1499
- </td>
1500
- </tr>
1501
- <tr>
1502
- <td><p><a name="G-CONNECT-SWAPPED:CAPS"></a><span class="term"><code class="literal">G_CONNECT_SWAPPED</code></span></p></td>
1503
- <td>whether the instance and data should be swapped when
1504
- calling the handler.
1505
- </td>
1506
- </tr>
1507
- </tbody>
1508
- </table></div>
1509
- </div>
1510
- <hr>
1511
- <div class="refsect2">
1512
- <a name="g-signal-connect-data"></a><h3>g_signal_connect_data ()</h3>
1513
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> g_signal_connect_data (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
1514
- <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_signal</code></em>,
1515
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="type">GCallback</span></a> c_handler</code></em>,
1516
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
1517
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosureNotify" title="GClosureNotify ()"><span class="type">GClosureNotify</span></a> destroy_data</code></em>,
1518
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GConnectFlags" title="enum GConnectFlags"><span class="type">GConnectFlags</span></a> connect_flags</code></em>);</pre>
1519
- <p>
1520
- 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
1521
- 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
1522
- which will be called when the signal handler is disconnected and no longer
1523
- used. Specify <em class="parameter"><code>connect_flags</code></em> if you need <code class="literal">..._after()</code> or
1524
- <code class="literal">..._swapped()</code> variants of this function.
1525
- </p>
1526
- <div class="variablelist"><table border="0">
1527
- <col align="left" valign="top">
1528
- <tbody>
1529
- <tr>
1530
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
1531
- <td>the instance to connect to.
1532
- </td>
1533
- </tr>
1534
- <tr>
1535
- <td><p><span class="term"><em class="parameter"><code>detailed_signal</code></em> :</span></p></td>
1536
- <td>a string of the form "signal-name::detail".
1537
- </td>
1538
- </tr>
1539
- <tr>
1540
- <td><p><span class="term"><em class="parameter"><code>c_handler</code></em> :</span></p></td>
1541
- <td>the <a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="type">GCallback</span></a> to connect.
1542
- </td>
1543
- </tr>
1544
- <tr>
1545
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1546
- <td>data to pass to <em class="parameter"><code>c_handler</code></em> calls.
1547
- </td>
1548
- </tr>
1549
- <tr>
1550
- <td><p><span class="term"><em class="parameter"><code>destroy_data</code></em> :</span></p></td>
1551
- <td>a <a class="link" href="gobject-Closures.html#GClosureNotify" title="GClosureNotify ()"><span class="type">GClosureNotify</span></a> for <em class="parameter"><code>data</code></em>.
1552
- </td>
1553
- </tr>
1554
- <tr>
1555
- <td><p><span class="term"><em class="parameter"><code>connect_flags</code></em> :</span></p></td>
1556
- <td>a combination of <a class="link" href="gobject-Signals.html#GConnectFlags" title="enum GConnectFlags"><span class="type">GConnectFlags</span></a>.
1557
- </td>
1558
- </tr>
1559
- <tr>
1560
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1561
- <td> the handler id
1562
- </td>
1563
- </tr>
1564
- </tbody>
1565
- </table></div>
1566
- </div>
1567
- <hr>
1568
- <div class="refsect2">
1569
- <a name="g-signal-connect-closure"></a><h3>g_signal_connect_closure ()</h3>
1570
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> g_signal_connect_closure (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
1571
- <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_signal</code></em>,
1572
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *closure</code></em>,
1573
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> after</code></em>);</pre>
1574
- <p>
1575
- Connects a closure to a signal for a particular object.
1576
- </p>
1577
- <div class="variablelist"><table border="0">
1578
- <col align="left" valign="top">
1579
- <tbody>
1580
- <tr>
1581
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
1582
- <td>the instance to connect to.
1583
- </td>
1584
- </tr>
1585
- <tr>
1586
- <td><p><span class="term"><em class="parameter"><code>detailed_signal</code></em> :</span></p></td>
1587
- <td>a string of the form "signal-name::detail".
1588
- </td>
1589
- </tr>
1590
- <tr>
1591
- <td><p><span class="term"><em class="parameter"><code>closure</code></em> :</span></p></td>
1592
- <td>the closure to connect.
1593
- </td>
1594
- </tr>
1595
- <tr>
1596
- <td><p><span class="term"><em class="parameter"><code>after</code></em> :</span></p></td>
1597
- <td>whether the handler should be called before or after the
1598
- default handler of the signal.
1599
- </td>
1600
- </tr>
1601
- <tr>
1602
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1603
- <td> the handler id
1604
- </td>
1605
- </tr>
1606
- </tbody>
1607
- </table></div>
1608
- </div>
1609
- <hr>
1610
- <div class="refsect2">
1611
- <a name="g-signal-connect-closure-by-id"></a><h3>g_signal_connect_closure_by_id ()</h3>
1612
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> g_signal_connect_closure_by_id (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
1613
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
1614
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
1615
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *closure</code></em>,
1616
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> after</code></em>);</pre>
1617
- <p>
1618
- Connects a closure to a signal for a particular object.
1619
- </p>
1620
- <div class="variablelist"><table border="0">
1621
- <col align="left" valign="top">
1622
- <tbody>
1623
- <tr>
1624
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
1625
- <td>the instance to connect to.
1626
- </td>
1627
- </tr>
1628
- <tr>
1629
- <td><p><span class="term"><em class="parameter"><code>signal_id</code></em> :</span></p></td>
1630
- <td>the id of the signal.
1631
- </td>
1632
- </tr>
1633
- <tr>
1634
- <td><p><span class="term"><em class="parameter"><code>detail</code></em> :</span></p></td>
1635
- <td>the detail.
1636
- </td>
1637
- </tr>
1638
- <tr>
1639
- <td><p><span class="term"><em class="parameter"><code>closure</code></em> :</span></p></td>
1640
- <td>the closure to connect.
1641
- </td>
1642
- </tr>
1643
- <tr>
1644
- <td><p><span class="term"><em class="parameter"><code>after</code></em> :</span></p></td>
1645
- <td>whether the handler should be called before or after the
1646
- default handler of the signal.
1647
- </td>
1648
- </tr>
1649
- <tr>
1650
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1651
- <td> the handler id
1652
- </td>
1653
- </tr>
1654
- </tbody>
1655
- </table></div>
1656
- </div>
1657
- <hr>
1658
- <div class="refsect2">
1659
- <a name="g-signal-handler-block"></a><h3>g_signal_handler_block ()</h3>
1660
- <pre class="programlisting"><span class="returnvalue">void</span> g_signal_handler_block (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
1661
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> handler_id</code></em>);</pre>
1662
- <p>
1663
- Blocks a handler of an instance so it will not be called during any
1664
- signal emissions unless it is unblocked again. Thus "blocking" a
1665
- signal handler means to temporarily deactive it, a signal handler
1666
- has to be unblocked exactly the same amount of times it has been
1667
- blocked before to become active again.
1668
- </p>
1669
- <p>
1670
- The <em class="parameter"><code>handler_id</code></em> has to be a valid signal handler id, connected to a
1671
- signal of <em class="parameter"><code>instance</code></em>.
1672
- </p>
1673
- <div class="variablelist"><table border="0">
1674
- <col align="left" valign="top">
1675
- <tbody>
1676
- <tr>
1677
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
1678
- <td>The instance to block the signal handler of.
1679
- </td>
1680
- </tr>
1681
- <tr>
1682
- <td><p><span class="term"><em class="parameter"><code>handler_id</code></em> :</span></p></td>
1683
- <td>Handler id of the handler to be blocked.
1684
- </td>
1685
- </tr>
1686
- </tbody>
1687
- </table></div>
1688
- </div>
1689
- <hr>
1690
- <div class="refsect2">
1691
- <a name="g-signal-handler-unblock"></a><h3>g_signal_handler_unblock ()</h3>
1692
- <pre class="programlisting"><span class="returnvalue">void</span> g_signal_handler_unblock (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
1693
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> handler_id</code></em>);</pre>
1694
- <p>
1695
- 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
1696
- blocked handler is skipped during signal emissions and will not be
1697
- invoked, unblocking it (for exactly the amount of times it has been
1698
- blocked before) reverts its "blocked" state, so the handler will be
1699
- recognized by the signal system and is called upon future or
1700
- currently ongoing signal emissions (since the order in which
1701
- handlers are called during signal emissions is deterministic,
1702
- whether the unblocked handler in question is called as part of a
1703
- currently ongoing emission depends on how far that emission has
1704
- proceeded yet).
1705
- </p>
1706
- <p>
1707
- The <em class="parameter"><code>handler_id</code></em> has to be a valid id of a signal handler that is
1708
- connected to a signal of <em class="parameter"><code>instance</code></em> and is currently blocked.
1709
- </p>
1710
- <div class="variablelist"><table border="0">
1711
- <col align="left" valign="top">
1712
- <tbody>
1713
- <tr>
1714
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
1715
- <td>The instance to unblock the signal handler of.
1716
- </td>
1717
- </tr>
1718
- <tr>
1719
- <td><p><span class="term"><em class="parameter"><code>handler_id</code></em> :</span></p></td>
1720
- <td>Handler id of the handler to be unblocked.
1721
- </td>
1722
- </tr>
1723
- </tbody>
1724
- </table></div>
1725
- </div>
1726
- <hr>
1727
- <div class="refsect2">
1728
- <a name="g-signal-handler-disconnect"></a><h3>g_signal_handler_disconnect ()</h3>
1729
- <pre class="programlisting"><span class="returnvalue">void</span> g_signal_handler_disconnect (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
1730
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> handler_id</code></em>);</pre>
1731
- <p>
1732
- Disconnects a handler from an instance so it will not be called during
1733
- any future or currently ongoing emissions of the signal it has been
1734
- connected to. The <em class="parameter"><code>handler_id</code></em> becomes invalid and may be reused.
1735
- </p>
1736
- <p>
1737
- The <em class="parameter"><code>handler_id</code></em> has to be a valid signal handler id, connected to a
1738
- signal of <em class="parameter"><code>instance</code></em>.
1739
- </p>
1740
- <div class="variablelist"><table border="0">
1741
- <col align="left" valign="top">
1742
- <tbody>
1743
- <tr>
1744
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
1745
- <td>The instance to remove the signal handler from.
1746
- </td>
1747
- </tr>
1748
- <tr>
1749
- <td><p><span class="term"><em class="parameter"><code>handler_id</code></em> :</span></p></td>
1750
- <td>Handler id of the handler to be disconnected.
1751
- </td>
1752
- </tr>
1753
- </tbody>
1754
- </table></div>
1755
- </div>
1756
- <hr>
1757
- <div class="refsect2">
1758
- <a name="g-signal-handler-find"></a><h3>g_signal_handler_find ()</h3>
1759
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> g_signal_handler_find (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
1760
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="type">GSignalMatchType</span></a> mask</code></em>,
1761
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
1762
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
1763
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *closure</code></em>,
1764
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> func</code></em>,
1765
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
1766
- <p>
1767
- Finds the first signal handler that matches certain selection criteria.
1768
- 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>
1769
- flags, and the criteria values are passed as arguments.
1770
- The match <em class="parameter"><code>mask</code></em> has to be non-0 for successful matches.
1771
- If no handler was found, 0 is returned.
1772
- </p>
1773
- <div class="variablelist"><table border="0">
1774
- <col align="left" valign="top">
1775
- <tbody>
1776
- <tr>
1777
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
1778
- <td>The instance owning the signal handler to be found.
1779
- </td>
1780
- </tr>
1781
- <tr>
1782
- <td><p><span class="term"><em class="parameter"><code>mask</code></em> :</span></p></td>
1783
- <td>Mask indicating which of <em class="parameter"><code>signal_id</code></em>, <em class="parameter"><code>detail</code></em>, <em class="parameter"><code>closure</code></em>, <em class="parameter"><code>func</code></em>
1784
- and/or <em class="parameter"><code>data</code></em> the handler has to match.
1785
- </td>
1786
- </tr>
1787
- <tr>
1788
- <td><p><span class="term"><em class="parameter"><code>signal_id</code></em> :</span></p></td>
1789
- <td>Signal the handler has to be connected to.
1790
- </td>
1791
- </tr>
1792
- <tr>
1793
- <td><p><span class="term"><em class="parameter"><code>detail</code></em> :</span></p></td>
1794
- <td>Signal detail the handler has to be connected to.
1795
- </td>
1796
- </tr>
1797
- <tr>
1798
- <td><p><span class="term"><em class="parameter"><code>closure</code></em> :</span></p></td>
1799
- <td>The closure the handler will invoke.
1800
- </td>
1801
- </tr>
1802
- <tr>
1803
- <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
1804
- <td>The C closure callback of the handler (useless for non-C closures).
1805
- </td>
1806
- </tr>
1807
- <tr>
1808
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1809
- <td>The closure data of the handler's closure.
1810
- </td>
1811
- </tr>
1812
- <tr>
1813
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1814
- <td> A valid non-0 signal handler id for a successful match.
1815
- </td>
1816
- </tr>
1817
- </tbody>
1818
- </table></div>
1819
- </div>
1820
- <hr>
1821
- <div class="refsect2">
1822
- <a name="g-signal-handlers-block-matched"></a><h3>g_signal_handlers_block_matched ()</h3>
1823
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_signal_handlers_block_matched (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
1824
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="type">GSignalMatchType</span></a> mask</code></em>,
1825
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
1826
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
1827
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *closure</code></em>,
1828
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> func</code></em>,
1829
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
1830
- <p>
1831
- Blocks all handlers on an instance that match a certain selection criteria.
1832
- 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>
1833
- flags, and the criteria values are passed as arguments.
1834
- 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>
1835
- 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.
1836
- If no handlers were found, 0 is returned, the number of blocked handlers
1837
- otherwise.
1838
- </p>
1839
- <div class="variablelist"><table border="0">
1840
- <col align="left" valign="top">
1841
- <tbody>
1842
- <tr>
1843
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
1844
- <td>The instance to block handlers from.
1845
- </td>
1846
- </tr>
1847
- <tr>
1848
- <td><p><span class="term"><em class="parameter"><code>mask</code></em> :</span></p></td>
1849
- <td>Mask indicating which of <em class="parameter"><code>signal_id</code></em>, <em class="parameter"><code>detail</code></em>, <em class="parameter"><code>closure</code></em>, <em class="parameter"><code>func</code></em>
1850
- and/or <em class="parameter"><code>data</code></em> the handlers have to match.
1851
- </td>
1852
- </tr>
1853
- <tr>
1854
- <td><p><span class="term"><em class="parameter"><code>signal_id</code></em> :</span></p></td>
1855
- <td>Signal the handlers have to be connected to.
1856
- </td>
1857
- </tr>
1858
- <tr>
1859
- <td><p><span class="term"><em class="parameter"><code>detail</code></em> :</span></p></td>
1860
- <td>Signal detail the handlers have to be connected to.
1861
- </td>
1862
- </tr>
1863
- <tr>
1864
- <td><p><span class="term"><em class="parameter"><code>closure</code></em> :</span></p></td>
1865
- <td>The closure the handlers will invoke.
1866
- </td>
1867
- </tr>
1868
- <tr>
1869
- <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
1870
- <td>The C closure callback of the handlers (useless for non-C closures).
1871
- </td>
1872
- </tr>
1873
- <tr>
1874
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1875
- <td>The closure data of the handlers' closures.
1876
- </td>
1877
- </tr>
1878
- <tr>
1879
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1880
- <td> The number of handlers that matched.
1881
- </td>
1882
- </tr>
1883
- </tbody>
1884
- </table></div>
1885
- </div>
1886
- <hr>
1887
- <div class="refsect2">
1888
- <a name="g-signal-handlers-unblock-matched"></a><h3>g_signal_handlers_unblock_matched ()</h3>
1889
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_signal_handlers_unblock_matched (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
1890
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="type">GSignalMatchType</span></a> mask</code></em>,
1891
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
1892
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
1893
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *closure</code></em>,
1894
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> func</code></em>,
1895
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
1896
- <p>
1897
- Unblocks all handlers on an instance that match a certain selection
1898
- criteria. The criteria mask is passed as an OR-ed combination of
1899
- <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.
1900
- 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>
1901
- 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.
1902
- If no handlers were found, 0 is returned, the number of unblocked handlers
1903
- otherwise. The match criteria should not apply to any handlers that are
1904
- not currently blocked.
1905
- </p>
1906
- <div class="variablelist"><table border="0">
1907
- <col align="left" valign="top">
1908
- <tbody>
1909
- <tr>
1910
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
1911
- <td>The instance to unblock handlers from.
1912
- </td>
1913
- </tr>
1914
- <tr>
1915
- <td><p><span class="term"><em class="parameter"><code>mask</code></em> :</span></p></td>
1916
- <td>Mask indicating which of <em class="parameter"><code>signal_id</code></em>, <em class="parameter"><code>detail</code></em>, <em class="parameter"><code>closure</code></em>, <em class="parameter"><code>func</code></em>
1917
- and/or <em class="parameter"><code>data</code></em> the handlers have to match.
1918
- </td>
1919
- </tr>
1920
- <tr>
1921
- <td><p><span class="term"><em class="parameter"><code>signal_id</code></em> :</span></p></td>
1922
- <td>Signal the handlers have to be connected to.
1923
- </td>
1924
- </tr>
1925
- <tr>
1926
- <td><p><span class="term"><em class="parameter"><code>detail</code></em> :</span></p></td>
1927
- <td>Signal detail the handlers have to be connected to.
1928
- </td>
1929
- </tr>
1930
- <tr>
1931
- <td><p><span class="term"><em class="parameter"><code>closure</code></em> :</span></p></td>
1932
- <td>The closure the handlers will invoke.
1933
- </td>
1934
- </tr>
1935
- <tr>
1936
- <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
1937
- <td>The C closure callback of the handlers (useless for non-C closures).
1938
- </td>
1939
- </tr>
1940
- <tr>
1941
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1942
- <td>The closure data of the handlers' closures.
1943
- </td>
1944
- </tr>
1945
- <tr>
1946
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1947
- <td> The number of handlers that matched.
1948
- </td>
1949
- </tr>
1950
- </tbody>
1951
- </table></div>
1952
- </div>
1953
- <hr>
1954
- <div class="refsect2">
1955
- <a name="g-signal-handlers-disconnect-matched"></a><h3>g_signal_handlers_disconnect_matched ()</h3>
1956
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_signal_handlers_disconnect_matched
1957
- (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
1958
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType"><span class="type">GSignalMatchType</span></a> mask</code></em>,
1959
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
1960
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
1961
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *closure</code></em>,
1962
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> func</code></em>,
1963
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
1964
- <p>
1965
- Disconnects all handlers on an instance that match a certain
1966
- selection criteria. The criteria mask is passed as an OR-ed
1967
- 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
1968
- passed as arguments. Passing at least one of the
1969
- <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
1970
- <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
1971
- matches. If no handlers were found, 0 is returned, the number of
1972
- disconnected handlers otherwise.
1973
- </p>
1974
- <div class="variablelist"><table border="0">
1975
- <col align="left" valign="top">
1976
- <tbody>
1977
- <tr>
1978
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
1979
- <td>The instance to remove handlers from.
1980
- </td>
1981
- </tr>
1982
- <tr>
1983
- <td><p><span class="term"><em class="parameter"><code>mask</code></em> :</span></p></td>
1984
- <td>Mask indicating which of <em class="parameter"><code>signal_id</code></em>, <em class="parameter"><code>detail</code></em>, <em class="parameter"><code>closure</code></em>, <em class="parameter"><code>func</code></em>
1985
- and/or <em class="parameter"><code>data</code></em> the handlers have to match.
1986
- </td>
1987
- </tr>
1988
- <tr>
1989
- <td><p><span class="term"><em class="parameter"><code>signal_id</code></em> :</span></p></td>
1990
- <td>Signal the handlers have to be connected to.
1991
- </td>
1992
- </tr>
1993
- <tr>
1994
- <td><p><span class="term"><em class="parameter"><code>detail</code></em> :</span></p></td>
1995
- <td>Signal detail the handlers have to be connected to.
1996
- </td>
1997
- </tr>
1998
- <tr>
1999
- <td><p><span class="term"><em class="parameter"><code>closure</code></em> :</span></p></td>
2000
- <td>The closure the handlers will invoke.
2001
- </td>
2002
- </tr>
2003
- <tr>
2004
- <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
2005
- <td>The C closure callback of the handlers (useless for non-C closures).
2006
- </td>
2007
- </tr>
2008
- <tr>
2009
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
2010
- <td>The closure data of the handlers' closures.
2011
- </td>
2012
- </tr>
2013
- <tr>
2014
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2015
- <td> The number of handlers that matched.
2016
- </td>
2017
- </tr>
2018
- </tbody>
2019
- </table></div>
2020
- </div>
2021
- <hr>
2022
- <div class="refsect2">
2023
- <a name="g-signal-handler-is-connected"></a><h3>g_signal_handler_is_connected ()</h3>
2024
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_signal_handler_is_connected (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
2025
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> handler_id</code></em>);</pre>
2026
- <p>
2027
- 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>.
2028
- </p>
2029
- <div class="variablelist"><table border="0">
2030
- <col align="left" valign="top">
2031
- <tbody>
2032
- <tr>
2033
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
2034
- <td>The instance where a signal handler is sought.
2035
- </td>
2036
- </tr>
2037
- <tr>
2038
- <td><p><span class="term"><em class="parameter"><code>handler_id</code></em> :</span></p></td>
2039
- <td>the handler id.
2040
- </td>
2041
- </tr>
2042
- <tr>
2043
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2044
- <td> whether <em class="parameter"><code>handler_id</code></em> identifies a handler connected to <em class="parameter"><code>instance</code></em>.
2045
- </td>
2046
- </tr>
2047
- </tbody>
2048
- </table></div>
2049
- </div>
2050
- <hr>
2051
- <div class="refsect2">
2052
- <a name="g-signal-handlers-block-by-func"></a><h3>g_signal_handlers_block_by_func()</h3>
2053
- <pre class="programlisting">#define g_signal_handlers_block_by_func(instance, func, data)</pre>
2054
- <p>
2055
- Blocks all handlers on an instance that match <em class="parameter"><code>func</code></em> and <em class="parameter"><code>data</code></em>.
2056
- </p>
2057
- <div class="variablelist"><table border="0">
2058
- <col align="left" valign="top">
2059
- <tbody>
2060
- <tr>
2061
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
2062
- <td>The instance to block handlers from.
2063
- </td>
2064
- </tr>
2065
- <tr>
2066
- <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
2067
- <td>The C closure callback of the handlers (useless for non-C closures).
2068
- </td>
2069
- </tr>
2070
- <tr>
2071
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
2072
- <td>The closure data of the handlers' closures.
2073
- </td>
2074
- </tr>
2075
- <tr>
2076
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2077
- <td> The number of handlers that matched.
2078
- </td>
2079
- </tr>
2080
- </tbody>
2081
- </table></div>
2082
- </div>
2083
- <hr>
2084
- <div class="refsect2">
2085
- <a name="g-signal-handlers-unblock-by-func"></a><h3>g_signal_handlers_unblock_by_func()</h3>
2086
- <pre class="programlisting">#define g_signal_handlers_unblock_by_func(instance, func, data)</pre>
2087
- <p>
2088
- Unblocks all handlers on an instance that match <em class="parameter"><code>func</code></em> and <em class="parameter"><code>data</code></em>.
2089
- </p>
2090
- <div class="variablelist"><table border="0">
2091
- <col align="left" valign="top">
2092
- <tbody>
2093
- <tr>
2094
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
2095
- <td>The instance to unblock handlers from.
2096
- </td>
2097
- </tr>
2098
- <tr>
2099
- <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
2100
- <td>The C closure callback of the handlers (useless for non-C closures).
2101
- </td>
2102
- </tr>
2103
- <tr>
2104
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
2105
- <td>The closure data of the handlers' closures.
2106
- </td>
2107
- </tr>
2108
- <tr>
2109
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2110
- <td> The number of handlers that matched.
2111
- </td>
2112
- </tr>
2113
- </tbody>
2114
- </table></div>
2115
- </div>
2116
- <hr>
2117
- <div class="refsect2">
2118
- <a name="g-signal-handlers-disconnect-by-func"></a><h3>g_signal_handlers_disconnect_by_func()</h3>
2119
- <pre class="programlisting">#define g_signal_handlers_disconnect_by_func(instance, func, data)</pre>
2120
- <p>
2121
- Disconnects all handlers on an instance that match <em class="parameter"><code>func</code></em> and <em class="parameter"><code>data</code></em>.
2122
- </p>
2123
- <div class="variablelist"><table border="0">
2124
- <col align="left" valign="top">
2125
- <tbody>
2126
- <tr>
2127
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
2128
- <td>The instance to remove handlers from.
2129
- </td>
2130
- </tr>
2131
- <tr>
2132
- <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
2133
- <td>The C closure callback of the handlers (useless for non-C closures).
2134
- </td>
2135
- </tr>
2136
- <tr>
2137
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
2138
- <td>The closure data of the handlers' closures.
2139
- </td>
2140
- </tr>
2141
- <tr>
2142
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2143
- <td> The number of handlers that matched.
2144
- </td>
2145
- </tr>
2146
- </tbody>
2147
- </table></div>
2148
- </div>
2149
- <hr>
2150
- <div class="refsect2">
2151
- <a name="g-signal-has-handler-pending"></a><h3>g_signal_has_handler_pending ()</h3>
2152
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_signal_has_handler_pending (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
2153
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
2154
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
2155
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> may_be_blocked</code></em>);</pre>
2156
- <p>
2157
- Returns whether there are any handlers connected to <em class="parameter"><code>instance</code></em> for the
2158
- given signal id and detail.
2159
- </p>
2160
- <p>
2161
- One example of when you might use this is when the arguments to the
2162
- signal are difficult to compute. A class implementor may opt to not
2163
- emit the signal if no one is attached anyway, thus saving the cost
2164
- of building the arguments.
2165
- </p>
2166
- <div class="variablelist"><table border="0">
2167
- <col align="left" valign="top">
2168
- <tbody>
2169
- <tr>
2170
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
2171
- <td>the object whose signal handlers are sought.
2172
- </td>
2173
- </tr>
2174
- <tr>
2175
- <td><p><span class="term"><em class="parameter"><code>signal_id</code></em> :</span></p></td>
2176
- <td>the signal id.
2177
- </td>
2178
- </tr>
2179
- <tr>
2180
- <td><p><span class="term"><em class="parameter"><code>detail</code></em> :</span></p></td>
2181
- <td>the detail.
2182
- </td>
2183
- </tr>
2184
- <tr>
2185
- <td><p><span class="term"><em class="parameter"><code>may_be_blocked</code></em> :</span></p></td>
2186
- <td>whether blocked handlers should count as match.
2187
- </td>
2188
- </tr>
2189
- <tr>
2190
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2191
- <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>
2192
- otherwise.
2193
- </td>
2194
- </tr>
2195
- </tbody>
2196
- </table></div>
2197
- </div>
2198
- <hr>
2199
- <div class="refsect2">
2200
- <a name="g-signal-stop-emission"></a><h3>g_signal_stop_emission ()</h3>
2201
- <pre class="programlisting"><span class="returnvalue">void</span> g_signal_stop_emission (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
2202
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
2203
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>);</pre>
2204
- <p>
2205
- Stops a signal's current emission.
2206
- </p>
2207
- <p>
2208
- This will prevent the default method from running, if the signal was
2209
- <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"
2210
- flag).
2211
- </p>
2212
- <p>
2213
- Prints a warning if used on a signal which isn't being emitted.
2214
- </p>
2215
- <div class="variablelist"><table border="0">
2216
- <col align="left" valign="top">
2217
- <tbody>
2218
- <tr>
2219
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
2220
- <td>the object whose signal handlers you wish to stop.
2221
- </td>
2222
- </tr>
2223
- <tr>
2224
- <td><p><span class="term"><em class="parameter"><code>signal_id</code></em> :</span></p></td>
2225
- <td>the signal identifier, as returned by <a class="link" href="gobject-Signals.html#g-signal-lookup" title="g_signal_lookup ()"><code class="function">g_signal_lookup()</code></a>.
2226
- </td>
2227
- </tr>
2228
- <tr>
2229
- <td><p><span class="term"><em class="parameter"><code>detail</code></em> :</span></p></td>
2230
- <td>the detail which the signal was emitted with.
2231
- </td>
2232
- </tr>
2233
- </tbody>
2234
- </table></div>
2235
- </div>
2236
- <hr>
2237
- <div class="refsect2">
2238
- <a name="g-signal-stop-emission-by-name"></a><h3>g_signal_stop_emission_by_name ()</h3>
2239
- <pre class="programlisting"><span class="returnvalue">void</span> g_signal_stop_emission_by_name (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
2240
- <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_signal</code></em>);</pre>
2241
- <p>
2242
- Stops a signal's current emission.
2243
- </p>
2244
- <p>
2245
- 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
2246
- signal id for you.
2247
- </p>
2248
- <div class="variablelist"><table border="0">
2249
- <col align="left" valign="top">
2250
- <tbody>
2251
- <tr>
2252
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
2253
- <td>the object whose signal handlers you wish to stop.
2254
- </td>
2255
- </tr>
2256
- <tr>
2257
- <td><p><span class="term"><em class="parameter"><code>detailed_signal</code></em> :</span></p></td>
2258
- <td>a string of the form "signal-name::detail".
2259
- </td>
2260
- </tr>
2261
- </tbody>
2262
- </table></div>
2263
- </div>
2264
- <hr>
2265
- <div class="refsect2">
2266
- <a name="g-signal-override-class-closure"></a><h3>g_signal_override_class_closure ()</h3>
2267
- <pre class="programlisting"><span class="returnvalue">void</span> g_signal_override_class_closure (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
2268
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> instance_type</code></em>,
2269
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="type">GClosure</span></a> *class_closure</code></em>);</pre>
2270
- <p>
2271
- Overrides the class closure (i.e. the default handler) for the given signal
2272
- for emissions on instances of <em class="parameter"><code>instance_type</code></em>. <em class="parameter"><code>instance_type</code></em> must be derived
2273
- from the type to which the signal belongs.
2274
- </p>
2275
- <p>
2276
- 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
2277
- <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
2278
- parent class closure from inside the overridden one.
2279
- </p>
2280
- <div class="variablelist"><table border="0">
2281
- <col align="left" valign="top">
2282
- <tbody>
2283
- <tr>
2284
- <td><p><span class="term"><em class="parameter"><code>signal_id</code></em> :</span></p></td>
2285
- <td>the signal id
2286
- </td>
2287
- </tr>
2288
- <tr>
2289
- <td><p><span class="term"><em class="parameter"><code>instance_type</code></em> :</span></p></td>
2290
- <td>the instance type on which to override the class closure
2291
- for the signal.
2292
- </td>
2293
- </tr>
2294
- <tr>
2295
- <td><p><span class="term"><em class="parameter"><code>class_closure</code></em> :</span></p></td>
2296
- <td>the closure.
2297
- </td>
2298
- </tr>
2299
- </tbody>
2300
- </table></div>
2301
- </div>
2302
- <hr>
2303
- <div class="refsect2">
2304
- <a name="g-signal-chain-from-overridden"></a><h3>g_signal_chain_from_overridden ()</h3>
2305
- <pre class="programlisting"><span class="returnvalue">void</span> g_signal_chain_from_overridden (<em class="parameter"><code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *instance_and_params</code></em>,
2306
- <em class="parameter"><code><a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *return_value</code></em>);</pre>
2307
- <p>
2308
- Calls the original class closure of a signal. This function should only
2309
- be called from an overridden class closure; see
2310
- <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
2311
- <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>.
2312
- </p>
2313
- <div class="variablelist"><table border="0">
2314
- <col align="left" valign="top">
2315
- <tbody>
2316
- <tr>
2317
- <td><p><span class="term"><em class="parameter"><code>instance_and_params</code></em> :</span></p></td>
2318
- <td>the argument list of the signal emission. The first
2319
- element in the array is a <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> for the instance the signal is being
2320
- emitted on. The rest are any arguments to be passed to the signal.
2321
- </td>
2322
- </tr>
2323
- <tr>
2324
- <td><p><span class="term"><em class="parameter"><code>return_value</code></em> :</span></p></td>
2325
- <td>Location for the return value.
2326
- </td>
2327
- </tr>
2328
- </tbody>
2329
- </table></div>
2330
- </div>
2331
- <hr>
2332
- <div class="refsect2">
2333
- <a name="g-signal-new-class-handler"></a><h3>g_signal_new_class_handler ()</h3>
2334
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_signal_new_class_handler (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_name</code></em>,
2335
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> itype</code></em>,
2336
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags"><span class="type">GSignalFlags</span></a> signal_flags</code></em>,
2337
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="type">GCallback</span></a> class_handler</code></em>,
2338
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="type">GSignalAccumulator</span></a> accumulator</code></em>,
2339
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> accu_data</code></em>,
2340
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller"><span class="type">GSignalCMarshaller</span></a> c_marshaller</code></em>,
2341
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> return_type</code></em>,
2342
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_params</code></em>,
2343
- <em class="parameter"><code>...</code></em>);</pre>
2344
- <p>
2345
- Creates a new signal. (This is usually done in the class initializer.)
2346
- </p>
2347
- <p>
2348
- This is a variant of <a class="link" href="gobject-Signals.html#g-signal-new" title="g_signal_new ()"><code class="function">g_signal_new()</code></a> that takes a C callback instead
2349
- off a class offset for the signal's class handler. This function
2350
- doesn't need a function pointer exposed in the class structure of
2351
- an object definition, instead the function pointer is passed
2352
- directly and can be overriden by derived classes with
2353
- <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> or
2354
- <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>and chained to with
2355
- <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> or
2356
- <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>.
2357
- </p>
2358
- <p>
2359
- 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.
2360
- </p>
2361
- <div class="variablelist"><table border="0">
2362
- <col align="left" valign="top">
2363
- <tbody>
2364
- <tr>
2365
- <td><p><span class="term"><em class="parameter"><code>signal_name</code></em> :</span></p></td>
2366
- <td>the name for the signal
2367
- </td>
2368
- </tr>
2369
- <tr>
2370
- <td><p><span class="term"><em class="parameter"><code>itype</code></em> :</span></p></td>
2371
- <td>the type this signal pertains to. It will also pertain to
2372
- types which are derived from this type.
2373
- </td>
2374
- </tr>
2375
- <tr>
2376
- <td><p><span class="term"><em class="parameter"><code>signal_flags</code></em> :</span></p></td>
2377
- <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
2378
- the default handler is to be invoked. You should at least specify
2379
- <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>.
2380
- </td>
2381
- </tr>
2382
- <tr>
2383
- <td><p><span class="term"><em class="parameter"><code>class_handler</code></em> :</span></p></td>
2384
- <td>a <a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="type">GCallback</span></a> which acts as class implementation of
2385
- 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
2386
- not associate a class method with this signal.
2387
- </td>
2388
- </tr>
2389
- <tr>
2390
- <td><p><span class="term"><em class="parameter"><code>accumulator</code></em> :</span></p></td>
2391
- <td>the accumulator for this signal; may be <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
2392
- </td>
2393
- </tr>
2394
- <tr>
2395
- <td><p><span class="term"><em class="parameter"><code>accu_data</code></em> :</span></p></td>
2396
- <td>user data for the <em class="parameter"><code>accumulator</code></em>.
2397
- </td>
2398
- </tr>
2399
- <tr>
2400
- <td><p><span class="term"><em class="parameter"><code>c_marshaller</code></em> :</span></p></td>
2401
- <td>the function to translate arrays of parameter values to
2402
- signal emissions into C language callback invocations.
2403
- </td>
2404
- </tr>
2405
- <tr>
2406
- <td><p><span class="term"><em class="parameter"><code>return_type</code></em> :</span></p></td>
2407
- <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
2408
- without a return value.
2409
- </td>
2410
- </tr>
2411
- <tr>
2412
- <td><p><span class="term"><em class="parameter"><code>n_params</code></em> :</span></p></td>
2413
- <td>the number of parameter types to follow.
2414
- </td>
2415
- </tr>
2416
- <tr>
2417
- <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
2418
- <td>a list of types, one for each parameter.
2419
- </td>
2420
- </tr>
2421
- <tr>
2422
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2423
- <td> the signal id
2424
-
2425
- </td>
2426
- </tr>
2427
- </tbody>
2428
- </table></div>
2429
- <p class="since">Since 2.18</p>
2430
- </div>
2431
- <hr>
2432
- <div class="refsect2">
2433
- <a name="g-signal-override-class-handler"></a><h3>g_signal_override_class_handler ()</h3>
2434
- <pre class="programlisting"><span class="returnvalue">void</span> g_signal_override_class_handler (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_name</code></em>,
2435
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> instance_type</code></em>,
2436
- <em class="parameter"><code><a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()"><span class="type">GCallback</span></a> class_handler</code></em>);</pre>
2437
- <p>
2438
- Overrides the class closure (i.e. the default handler) for the
2439
- given signal for emissions on instances of <em class="parameter"><code>instance_type</code></em> with
2440
- callabck <em class="parameter"><code>class_handler</code></em>. <em class="parameter"><code>instance_type</code></em> must be derived from the
2441
- type to which the signal belongs.
2442
- </p>
2443
- <p>
2444
- 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
2445
- <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
2446
- parent class closure from inside the overridden one.
2447
- </p>
2448
- <div class="variablelist"><table border="0">
2449
- <col align="left" valign="top">
2450
- <tbody>
2451
- <tr>
2452
- <td><p><span class="term"><em class="parameter"><code>signal_name</code></em> :</span></p></td>
2453
- <td>the name for the signal
2454
- </td>
2455
- </tr>
2456
- <tr>
2457
- <td><p><span class="term"><em class="parameter"><code>instance_type</code></em> :</span></p></td>
2458
- <td>the instance type on which to override the class handler
2459
- for the signal.
2460
- </td>
2461
- </tr>
2462
- <tr>
2463
- <td><p><span class="term"><em class="parameter"><code>class_handler</code></em> :</span></p></td>
2464
- <td>the handler.
2465
- </td>
2466
- </tr>
2467
- </tbody>
2468
- </table></div>
2469
- <p class="since">Since 2.18</p>
2470
- </div>
2471
- <hr>
2472
- <div class="refsect2">
2473
- <a name="g-signal-chain-from-overridden-handler"></a><h3>g_signal_chain_from_overridden_handler ()</h3>
2474
- <pre class="programlisting"><span class="returnvalue">void</span> g_signal_chain_from_overridden_handler
2475
- (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>,
2476
- <em class="parameter"><code>...</code></em>);</pre>
2477
- <p>
2478
- Calls the original class closure of a signal. This function should
2479
- only be called from an overridden class closure; see
2480
- <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
2481
- <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>.
2482
- </p>
2483
- <div class="variablelist"><table border="0">
2484
- <col align="left" valign="top">
2485
- <tbody>
2486
- <tr>
2487
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
2488
- <td>the instance the signal is being emitted on.
2489
- </td>
2490
- </tr>
2491
- <tr>
2492
- <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
2493
- <td>parameters to be passed to the parent class closure, followed by a
2494
- location for the return value. If the return type of the signal
2495
- 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.
2496
- </td>
2497
- </tr>
2498
- </tbody>
2499
- </table></div>
2500
- <p class="since">Since 2.18</p>
2501
- </div>
2502
- <hr>
2503
- <div class="refsect2">
2504
- <a name="g-signal-add-emission-hook"></a><h3>g_signal_add_emission_hook ()</h3>
2505
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> g_signal_add_emission_hook (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
2506
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> detail</code></em>,
2507
- <em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalEmissionHook" title="GSignalEmissionHook ()"><span class="type">GSignalEmissionHook</span></a> hook_func</code></em>,
2508
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> hook_data</code></em>,
2509
- <em class="parameter"><code><a href="./../glib/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> data_destroy</code></em>);</pre>
2510
- <p>
2511
- Adds an emission hook for a signal, which will get called for any emission
2512
- of that signal, independent of the instance. This is possible only
2513
- 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.
2514
- </p>
2515
- <div class="variablelist"><table border="0">
2516
- <col align="left" valign="top">
2517
- <tbody>
2518
- <tr>
2519
- <td><p><span class="term"><em class="parameter"><code>signal_id</code></em> :</span></p></td>
2520
- <td>the signal identifier, as returned by <a class="link" href="gobject-Signals.html#g-signal-lookup" title="g_signal_lookup ()"><code class="function">g_signal_lookup()</code></a>.
2521
- </td>
2522
- </tr>
2523
- <tr>
2524
- <td><p><span class="term"><em class="parameter"><code>detail</code></em> :</span></p></td>
2525
- <td>the detail on which to call the hook.
2526
- </td>
2527
- </tr>
2528
- <tr>
2529
- <td><p><span class="term"><em class="parameter"><code>hook_func</code></em> :</span></p></td>
2530
- <td>a <a class="link" href="gobject-Signals.html#GSignalEmissionHook" title="GSignalEmissionHook ()"><span class="type">GSignalEmissionHook</span></a> function.
2531
- </td>
2532
- </tr>
2533
- <tr>
2534
- <td><p><span class="term"><em class="parameter"><code>hook_data</code></em> :</span></p></td>
2535
- <td>user data for <em class="parameter"><code>hook_func</code></em>.
2536
- </td>
2537
- </tr>
2538
- <tr>
2539
- <td><p><span class="term"><em class="parameter"><code>data_destroy</code></em> :</span></p></td>
2540
- <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>.
2541
- </td>
2542
- </tr>
2543
- <tr>
2544
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2545
- <td> the hook id, for later use with <a class="link" href="gobject-Signals.html#g-signal-remove-emission-hook" title="g_signal_remove_emission_hook ()"><code class="function">g_signal_remove_emission_hook()</code></a>.
2546
- </td>
2547
- </tr>
2548
- </tbody>
2549
- </table></div>
2550
- </div>
2551
- <hr>
2552
- <div class="refsect2">
2553
- <a name="g-signal-remove-emission-hook"></a><h3>g_signal_remove_emission_hook ()</h3>
2554
- <pre class="programlisting"><span class="returnvalue">void</span> g_signal_remove_emission_hook (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> signal_id</code></em>,
2555
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> hook_id</code></em>);</pre>
2556
- <p>
2557
- Deletes an emission hook.
2558
- </p>
2559
- <div class="variablelist"><table border="0">
2560
- <col align="left" valign="top">
2561
- <tbody>
2562
- <tr>
2563
- <td><p><span class="term"><em class="parameter"><code>signal_id</code></em> :</span></p></td>
2564
- <td>the id of the signal
2565
- </td>
2566
- </tr>
2567
- <tr>
2568
- <td><p><span class="term"><em class="parameter"><code>hook_id</code></em> :</span></p></td>
2569
- <td>the id of the emission hook, as returned by
2570
- <a class="link" href="gobject-Signals.html#g-signal-add-emission-hook" title="g_signal_add_emission_hook ()"><code class="function">g_signal_add_emission_hook()</code></a>
2571
- </td>
2572
- </tr>
2573
- </tbody>
2574
- </table></div>
2575
- </div>
2576
- <hr>
2577
- <div class="refsect2">
2578
- <a name="g-signal-parse-name"></a><h3>g_signal_parse_name ()</h3>
2579
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_signal_parse_name (<em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *detailed_signal</code></em>,
2580
- <em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> itype</code></em>,
2581
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *signal_id_p</code></em>,
2582
- <em class="parameter"><code><a href="./../glib/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> *detail_p</code></em>,
2583
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> force_detail_quark</code></em>);</pre>
2584
- <p>
2585
- Internal function to parse a signal name into its <em class="parameter"><code>signal_id</code></em>
2586
- and <em class="parameter"><code>detail</code></em> quark.
2587
- </p>
2588
- <div class="variablelist"><table border="0">
2589
- <col align="left" valign="top">
2590
- <tbody>
2591
- <tr>
2592
- <td><p><span class="term"><em class="parameter"><code>detailed_signal</code></em> :</span></p></td>
2593
- <td>a string of the form "signal-name::detail".
2594
- </td>
2595
- </tr>
2596
- <tr>
2597
- <td><p><span class="term"><em class="parameter"><code>itype</code></em> :</span></p></td>
2598
- <td>The interface/instance type that introduced "signal-name".
2599
- </td>
2600
- </tr>
2601
- <tr>
2602
- <td><p><span class="term"><em class="parameter"><code>signal_id_p</code></em> :</span></p></td>
2603
- <td>Location to store the signal id.
2604
- </td>
2605
- </tr>
2606
- <tr>
2607
- <td><p><span class="term"><em class="parameter"><code>detail_p</code></em> :</span></p></td>
2608
- <td>Location to store the detail quark.
2609
- </td>
2610
- </tr>
2611
- <tr>
2612
- <td><p><span class="term"><em class="parameter"><code>force_detail_quark</code></em> :</span></p></td>
2613
- <td>
2614
- <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.
2615
- </td>
2616
- </tr>
2617
- <tr>
2618
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2619
- <td> Whether the signal name could successfully be parsed and <em class="parameter"><code>signal_id_p</code></em> and <em class="parameter"><code>detail_p</code></em> contain valid return values.
2620
- </td>
2621
- </tr>
2622
- </tbody>
2623
- </table></div>
2624
- </div>
2625
- <hr>
2626
- <div class="refsect2">
2627
- <a name="g-signal-get-invocation-hint"></a><h3>g_signal_get_invocation_hint ()</h3>
2628
- <pre class="programlisting"><a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="returnvalue">GSignalInvocationHint</span></a> * g_signal_get_invocation_hint (<em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> instance</code></em>);</pre>
2629
- <p>
2630
- Returns the invocation hint of the innermost signal emission of instance.
2631
- </p>
2632
- <div class="variablelist"><table border="0">
2633
- <col align="left" valign="top">
2634
- <tbody>
2635
- <tr>
2636
- <td><p><span class="term"><em class="parameter"><code>instance</code></em> :</span></p></td>
2637
- <td>the instance to query
2638
- </td>
2639
- </tr>
2640
- <tr>
2641
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2642
- <td> the invocation hint of the innermost signal emission.
2643
- </td>
2644
- </tr>
2645
- </tbody>
2646
- </table></div>
2647
- </div>
2648
- <hr>
2649
- <div class="refsect2">
2650
- <a name="g-signal-type-cclosure-new"></a><h3>g_signal_type_cclosure_new ()</h3>
2651
- <pre class="programlisting"><a class="link" href="gobject-Closures.html#GClosure" title="GClosure"><span class="returnvalue">GClosure</span></a> * g_signal_type_cclosure_new (<em class="parameter"><code><a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> itype</code></em>,
2652
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> struct_offset</code></em>);</pre>
2653
- <p>
2654
- Creates a new closure which invokes the function found at the offset
2655
- <em class="parameter"><code>struct_offset</code></em> in the class structure of the interface or classed type
2656
- identified by <em class="parameter"><code>itype</code></em>.
2657
- </p>
2658
- <div class="variablelist"><table border="0">
2659
- <col align="left" valign="top">
2660
- <tbody>
2661
- <tr>
2662
- <td><p><span class="term"><em class="parameter"><code>itype</code></em> :</span></p></td>
2663
- <td>the <a class="link" href="gobject-Type-Information.html#GType" title="GType"><span class="type">GType</span></a> identifier of an interface or classed type
2664
- </td>
2665
- </tr>
2666
- <tr>
2667
- <td><p><span class="term"><em class="parameter"><code>struct_offset</code></em> :</span></p></td>
2668
- <td>the offset of the member function of <em class="parameter"><code>itype</code></em>'s class
2669
- structure which is to be invoked by the new closure
2670
- </td>
2671
- </tr>
2672
- <tr>
2673
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2674
- <td> a new <a class="link" href="gobject-Closures.html#GCClosure" title="GCClosure"><span class="type">GCClosure</span></a>
2675
- </td>
2676
- </tr>
2677
- </tbody>
2678
- </table></div>
2679
- </div>
2680
- <hr>
2681
- <div class="refsect2">
2682
- <a name="g-signal-accumulator-true-handled"></a><h3>g_signal_accumulator_true_handled ()</h3>
2683
- <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_signal_accumulator_true_handled (<em class="parameter"><code><a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="GSignalInvocationHint"><span class="type">GSignalInvocationHint</span></a> *ihint</code></em>,
2684
- <em class="parameter"><code><a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *return_accu</code></em>,
2685
- <em class="parameter"><code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *handler_return</code></em>,
2686
- <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> dummy</code></em>);</pre>
2687
- <p>
2688
- A predefined <a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="type">GSignalAccumulator</span></a> for signals that return a
2689
- boolean values. The behavior that this accumulator gives is
2690
- 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
2691
- 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
2692
- 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
2693
- indicates that the callback <span class="emphasis"><em>handled</em></span> the signal,
2694
- and no further handling is needed.
2695
- </p>
2696
- <div class="variablelist"><table border="0">
2697
- <col align="left" valign="top">
2698
- <tbody>
2699
- <tr>
2700
- <td><p><span class="term"><em class="parameter"><code>ihint</code></em> :</span></p></td>
2701
- <td>standard <a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="type">GSignalAccumulator</span></a> parameter
2702
- </td>
2703
- </tr>
2704
- <tr>
2705
- <td><p><span class="term"><em class="parameter"><code>return_accu</code></em> :</span></p></td>
2706
- <td>standard <a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="type">GSignalAccumulator</span></a> parameter
2707
- </td>
2708
- </tr>
2709
- <tr>
2710
- <td><p><span class="term"><em class="parameter"><code>handler_return</code></em> :</span></p></td>
2711
- <td>standard <a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="type">GSignalAccumulator</span></a> parameter
2712
- </td>
2713
- </tr>
2714
- <tr>
2715
- <td><p><span class="term"><em class="parameter"><code>dummy</code></em> :</span></p></td>
2716
- <td>standard <a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="type">GSignalAccumulator</span></a> parameter
2717
- </td>
2718
- </tr>
2719
- <tr>
2720
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2721
- <td> standard <a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()"><span class="type">GSignalAccumulator</span></a> result
2722
- </td>
2723
- </tr>
2724
- </tbody>
2725
- </table></div>
2726
- <p class="since">Since 2.4</p>
2727
- </div>
2728
- </div>
2729
- <div class="footnotes">
2730
- <br><hr width="100" align="left">
2731
- <div class="footnote"><p><sup>[<a name="ftn.id467280" href="#id467280" class="para">10</a>] </sup>Although signals can deal with any kind of instantiatable
2732
- type, i'm referring to those types as "object types" in the following,
2733
- simply because that is the context most users will encounter signals in.
2734
- </p></div>
2735
- </div>
2736
- </div>
2737
- <div class="footer">
2738
- <hr>
2739
- Generated by GTK-Doc V1.15.1</div>
2740
- </body>
2741
- </html>