glib2 0.90.4-x86-mingw32 → 0.90.5-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (567) hide show
  1. data/ChangeLog +10 -0
  2. data/Rakefile +1 -1
  3. data/ext/glib2/extconf.rb +8 -0
  4. data/ext/glib2/rbglib.h +1 -1
  5. data/lib/1.8/glib2.so +0 -0
  6. data/lib/1.9/glib2.so +0 -0
  7. data/lib/glib-mkenums.rb +3 -2
  8. data/lib/mkmf-gnome2.rb +14 -10
  9. data/vendor/local/bin/glib-genmarshal.exe +0 -0
  10. data/vendor/local/bin/glib-gettextize +2 -2
  11. data/vendor/local/bin/glib-mkenums +35 -9
  12. data/vendor/local/bin/gobject-query.exe +0 -0
  13. data/vendor/local/bin/gspawn-win32-helper-console.exe +0 -0
  14. data/vendor/local/bin/gspawn-win32-helper.exe +0 -0
  15. data/vendor/local/bin/libgio-2.0-0.dll +0 -0
  16. data/vendor/local/bin/libglib-2.0-0.dll +0 -0
  17. data/vendor/local/bin/libgmodule-2.0-0.dll +0 -0
  18. data/vendor/local/bin/libgobject-2.0-0.dll +0 -0
  19. data/vendor/local/bin/libgthread-2.0-0.dll +0 -0
  20. data/vendor/local/include/glib-2.0/gio/gappinfo.h +0 -1
  21. data/vendor/local/include/glib-2.0/gio/gbufferedoutputstream.h +0 -1
  22. data/vendor/local/include/glib-2.0/gio/gcontenttype.h +18 -18
  23. data/vendor/local/include/glib-2.0/gio/gconverterinputstream.h +0 -1
  24. data/vendor/local/include/glib-2.0/gio/gconverteroutputstream.h +0 -1
  25. data/vendor/local/include/glib-2.0/gio/gcredentials.h +76 -0
  26. data/vendor/local/include/glib-2.0/gio/gdatainputstream.h +42 -25
  27. data/vendor/local/include/glib-2.0/gio/gdataoutputstream.h +0 -1
  28. data/vendor/local/include/glib-2.0/gio/gdbusaddress.h +58 -0
  29. data/vendor/local/include/glib-2.0/gio/gdbusauthobserver.h +46 -0
  30. data/vendor/local/include/glib-2.0/gio/gdbusconnection.h +562 -0
  31. data/vendor/local/include/glib-2.0/gio/gdbuserror.h +100 -0
  32. data/vendor/local/include/glib-2.0/gio/gdbusintrospection.h +286 -0
  33. data/vendor/local/include/glib-2.0/gio/gdbusmessage.h +149 -0
  34. data/vendor/local/include/glib-2.0/gio/gdbusmethodinvocation.h +73 -0
  35. data/vendor/local/include/glib-2.0/gio/gdbusnameowning.h +112 -0
  36. data/vendor/local/include/glib-2.0/gio/gdbusnamewatching.h +94 -0
  37. data/vendor/local/include/glib-2.0/gio/gdbusproxy.h +167 -0
  38. data/vendor/local/include/glib-2.0/gio/gdbusserver.h +54 -0
  39. data/vendor/local/include/glib-2.0/gio/gdbusutils.h +44 -0
  40. data/vendor/local/include/glib-2.0/gio/gfileenumerator.h +0 -1
  41. data/vendor/local/include/glib-2.0/gio/gfileinfo.h +1 -0
  42. data/vendor/local/include/glib-2.0/gio/gio.h +30 -9
  43. data/vendor/local/include/glib-2.0/gio/gioenums.h +526 -8
  44. data/vendor/local/include/glib-2.0/gio/gioenumtypes.h +42 -0
  45. data/vendor/local/include/glib-2.0/gio/gioerror.h +4 -0
  46. data/vendor/local/include/glib-2.0/gio/giotypes.h +36 -0
  47. data/vendor/local/include/glib-2.0/gio/gmemoryoutputstream.h +1 -0
  48. data/vendor/local/include/glib-2.0/gio/gnetworkaddress.h +4 -0
  49. data/vendor/local/include/glib-2.0/gio/gnetworkservice.h +2 -0
  50. data/vendor/local/include/glib-2.0/gio/gpermission.h +118 -0
  51. data/vendor/local/include/glib-2.0/gio/gproxy.h +123 -0
  52. data/vendor/local/include/glib-2.0/gio/gproxyaddress.h +76 -0
  53. data/vendor/local/include/glib-2.0/gio/gproxyaddressenumerator.h +75 -0
  54. data/vendor/local/include/glib-2.0/gio/gproxyresolver.h +96 -0
  55. data/vendor/local/include/glib-2.0/gio/gsettings.h +258 -0
  56. data/vendor/local/include/glib-2.0/gio/gsettingsbackend.h +138 -0
  57. data/vendor/local/include/glib-2.0/gio/gsimplepermission.h +45 -0
  58. data/vendor/local/include/glib-2.0/gio/gsocket.h +18 -0
  59. data/vendor/local/include/glib-2.0/gio/gsocketclient.h +22 -0
  60. data/vendor/local/include/glib-2.0/gio/gsocketconnectable.h +7 -1
  61. data/vendor/local/include/glib-2.0/gio/gvolumemonitor.h +0 -1
  62. data/vendor/local/include/glib-2.0/gio/gzlibcompressor.h +5 -0
  63. data/vendor/local/include/glib-2.0/gio/gzlibdecompressor.h +3 -0
  64. data/vendor/local/include/glib-2.0/glib-object.h +1 -0
  65. data/vendor/local/include/glib-2.0/glib.h +2 -0
  66. data/vendor/local/include/glib-2.0/glib/galloca.h +47 -0
  67. data/vendor/local/include/glib-2.0/glib/gatomic.h +25 -5
  68. data/vendor/local/include/glib-2.0/glib/gbacktrace.h +7 -7
  69. data/vendor/local/include/glib-2.0/glib/gbase64.h +22 -22
  70. data/vendor/local/include/glib-2.0/glib/gbookmarkfile.h +27 -3
  71. data/vendor/local/include/glib-2.0/glib/gcache.h +1 -1
  72. data/vendor/local/include/glib-2.0/glib/gchecksum.h +20 -20
  73. data/vendor/local/include/glib-2.0/glib/gcompletion.h +4 -0
  74. data/vendor/local/include/glib-2.0/glib/gconvert.h +26 -2
  75. data/vendor/local/include/glib-2.0/glib/gdatetime.h +217 -0
  76. data/vendor/local/include/glib-2.0/glib/gkeyfile.h +16 -0
  77. data/vendor/local/include/glib-2.0/glib/gmacros.h +7 -0
  78. data/vendor/local/include/glib-2.0/glib/gmain.h +305 -78
  79. data/vendor/local/include/glib-2.0/glib/gmarkup.h +1 -1
  80. data/vendor/local/include/glib-2.0/glib/gmem.h +107 -1
  81. data/vendor/local/include/glib-2.0/glib/gnode.h +4 -2
  82. data/vendor/local/include/glib-2.0/glib/gpoll.h +27 -3
  83. data/vendor/local/include/glib-2.0/glib/gregex.h +228 -0
  84. data/vendor/local/include/glib-2.0/glib/grel.h +4 -0
  85. data/vendor/local/include/glib-2.0/glib/gstdio.h +27 -39
  86. data/vendor/local/include/glib-2.0/glib/gstrfuncs.h +3 -1
  87. data/vendor/local/include/glib-2.0/glib/gtestutils.h +19 -14
  88. data/vendor/local/include/glib-2.0/glib/gthread.h +0 -1
  89. data/vendor/local/include/glib-2.0/glib/gtimezone.h +44 -0
  90. data/vendor/local/include/glib-2.0/glib/gunicode.h +18 -1
  91. data/vendor/local/include/glib-2.0/glib/gutils.h +1 -1
  92. data/vendor/local/include/glib-2.0/glib/gvariant.h +25 -1
  93. data/vendor/local/include/glib-2.0/glib/gvarianttype.h +29 -0
  94. data/vendor/local/include/glib-2.0/gobject/gbinding.h +136 -0
  95. data/vendor/local/include/glib-2.0/gobject/gboxed.h +18 -6
  96. data/vendor/local/include/glib-2.0/gobject/gmarshal.h +37 -20
  97. data/vendor/local/include/glib-2.0/gobject/gobject.h +5 -0
  98. data/vendor/local/include/glib-2.0/gobject/gobjectnotifyqueue.c +48 -21
  99. data/vendor/local/include/glib-2.0/gobject/gparam.h +9 -4
  100. data/vendor/local/include/glib-2.0/gobject/gparamspecs.h +54 -0
  101. data/vendor/local/include/glib-2.0/gobject/gtype.h +129 -1
  102. data/vendor/local/include/glib-2.0/gobject/gvaluecollector.h +6 -1
  103. data/vendor/local/include/glib-2.0/gobject/gvaluetypes.h +17 -0
  104. data/vendor/local/lib/gio-2.0.def +345 -2
  105. data/vendor/local/lib/gio-2.0.lib +0 -0
  106. data/vendor/local/lib/glib-2.0.def +71 -0
  107. data/vendor/local/lib/glib-2.0.lib +0 -0
  108. data/vendor/local/lib/glib-2.0/include/glibconfig.h +2 -2
  109. data/vendor/local/lib/gmodule-2.0.lib +0 -0
  110. data/vendor/local/lib/gobject-2.0.def +21 -0
  111. data/vendor/local/lib/gobject-2.0.lib +0 -0
  112. data/vendor/local/lib/gthread-2.0.lib +0 -0
  113. data/vendor/local/lib/intl.lib +0 -0
  114. data/vendor/local/lib/libgio-2.0.dll.a +0 -0
  115. data/vendor/local/lib/libglib-2.0.dll.a +0 -0
  116. data/vendor/local/lib/libgmodule-2.0.dll.a +0 -0
  117. data/vendor/local/lib/libgobject-2.0.dll.a +0 -0
  118. data/vendor/local/lib/libgthread-2.0.dll.a +0 -0
  119. data/vendor/local/lib/pkgconfig/gio-2.0.pc +3 -2
  120. data/vendor/local/lib/pkgconfig/gio-windows-2.0.pc +11 -0
  121. data/vendor/local/lib/pkgconfig/glib-2.0.pc +2 -2
  122. data/vendor/local/lib/pkgconfig/gmodule-2.0.pc +2 -2
  123. data/vendor/local/lib/pkgconfig/gmodule-no-export-2.0.pc +2 -2
  124. data/vendor/local/lib/pkgconfig/gobject-2.0.pc +2 -2
  125. data/vendor/local/lib/pkgconfig/gthread-2.0.pc +2 -2
  126. data/vendor/local/manifest/{glib-dev_2.24.2-2_win32.mft → glib-dev_2.26.0-2_win32.mft} +87 -8
  127. data/vendor/local/manifest/{glib_2.24.2-2_win32.mft → glib_2.26.0-2_win32.mft} +3 -2
  128. data/vendor/local/share/aclocal/glib-gettext.m4 +2 -2
  129. data/vendor/local/share/doc/{glib-2.24.2 → glib-2.26.0}/COPYING +0 -0
  130. data/vendor/local/share/doc/{glib-dev-2.24.2 → glib-dev-2.26.0}/COPYING +0 -0
  131. data/vendor/local/share/glib-2.0/gdb/glib.py +1 -4
  132. data/vendor/local/share/glib-2.0/gettext/po/Makefile.in.in +3 -1
  133. data/vendor/local/share/glib-2.0/schemas/gschema.dtd +60 -0
  134. data/vendor/local/share/gtk-doc/html/gio/GAppInfo.html +179 -166
  135. data/vendor/local/share/gtk-doc/html/gio/GAsyncInitable.html +276 -74
  136. data/vendor/local/share/gtk-doc/html/gio/GAsyncResult.html +35 -35
  137. data/vendor/local/share/gtk-doc/html/gio/GBufferedInputStream.html +114 -119
  138. data/vendor/local/share/gtk-doc/html/gio/GBufferedOutputStream.html +43 -47
  139. data/vendor/local/share/gtk-doc/html/gio/GCancellable.html +67 -67
  140. data/vendor/local/share/gtk-doc/html/gio/GCharsetConverter.html +41 -41
  141. data/vendor/local/share/gtk-doc/html/gio/GConverter.html +70 -35
  142. data/vendor/local/share/gtk-doc/html/gio/GCredentials.html +398 -0
  143. data/vendor/local/share/gtk-doc/html/gio/GDBusAuthObserver.html +254 -0
  144. data/vendor/local/share/gtk-doc/html/gio/GDBusConnection.html +6211 -0
  145. data/vendor/local/share/gtk-doc/html/gio/GDBusMessage.html +1833 -0
  146. data/vendor/local/share/gtk-doc/html/gio/GDBusMethodInvocation.html +618 -0
  147. data/vendor/local/share/gtk-doc/html/gio/GDBusProxy.html +2050 -0
  148. data/vendor/local/share/gtk-doc/html/gio/GDBusServer.html +1124 -0
  149. data/vendor/local/share/gtk-doc/html/gio/GDataInputStream.html +373 -151
  150. data/vendor/local/share/gtk-doc/html/gio/GDataOutputStream.html +103 -107
  151. data/vendor/local/share/gtk-doc/html/gio/GDrive.html +158 -158
  152. data/vendor/local/share/gtk-doc/html/gio/GEmblem.html +22 -22
  153. data/vendor/local/share/gtk-doc/html/gio/GEmblemedIcon.html +19 -19
  154. data/vendor/local/share/gtk-doc/html/gio/GFile.html +935 -923
  155. data/vendor/local/share/gtk-doc/html/gio/GFileDescriptorBased.html +18 -13
  156. data/vendor/local/share/gtk-doc/html/gio/GFileEnumerator.html +71 -75
  157. data/vendor/local/share/gtk-doc/html/gio/GFileIOStream.html +29 -29
  158. data/vendor/local/share/gtk-doc/html/gio/GFileIcon.html +18 -18
  159. data/vendor/local/share/gtk-doc/html/gio/GFileInfo.html +303 -275
  160. data/vendor/local/share/gtk-doc/html/gio/GFileInputStream.html +27 -27
  161. data/vendor/local/share/gtk-doc/html/gio/GFileMonitor.html +32 -32
  162. data/vendor/local/share/gtk-doc/html/gio/GFileOutputStream.html +29 -29
  163. data/vendor/local/share/gtk-doc/html/gio/GFilenameCompleter.html +30 -30
  164. data/vendor/local/share/gtk-doc/html/gio/GFilterInputStream.html +31 -25
  165. data/vendor/local/share/gtk-doc/html/gio/GFilterOutputStream.html +31 -25
  166. data/vendor/local/share/gtk-doc/html/gio/GIOModule.html +27 -27
  167. data/vendor/local/share/gtk-doc/html/gio/GIOStream.html +58 -58
  168. data/vendor/local/share/gtk-doc/html/gio/GIcon.html +38 -38
  169. data/vendor/local/share/gtk-doc/html/gio/GInetAddress.html +109 -109
  170. data/vendor/local/share/gtk-doc/html/gio/GInetSocketAddress.html +26 -25
  171. data/vendor/local/share/gtk-doc/html/gio/GInitable.html +72 -72
  172. data/vendor/local/share/gtk-doc/html/gio/GInputStream.html +120 -120
  173. data/vendor/local/share/gtk-doc/html/gio/GLoadableIcon.html +29 -29
  174. data/vendor/local/share/gtk-doc/html/gio/GMemoryInputStream.html +24 -24
  175. data/vendor/local/share/gtk-doc/html/gio/GMemoryOutputStream.html +90 -59
  176. data/vendor/local/share/gtk-doc/html/gio/GMount.html +155 -155
  177. data/vendor/local/share/gtk-doc/html/gio/GMountOperation.html +76 -76
  178. data/vendor/local/share/gtk-doc/html/gio/GNetworkAddress.html +119 -39
  179. data/vendor/local/share/gtk-doc/html/gio/GNetworkService.html +100 -37
  180. data/vendor/local/share/gtk-doc/html/gio/GOutputStream.html +137 -131
  181. data/vendor/local/share/gtk-doc/html/gio/GPermission.html +560 -0
  182. data/vendor/local/share/gtk-doc/html/gio/GProxy.html +312 -0
  183. data/vendor/local/share/gtk-doc/html/gio/GProxyAddress.html +348 -0
  184. data/vendor/local/share/gtk-doc/html/gio/GProxyResolver.html +301 -0
  185. data/vendor/local/share/gtk-doc/html/gio/GResolver.html +116 -116
  186. data/vendor/local/share/gtk-doc/html/gio/GSeekable.html +54 -54
  187. data/vendor/local/share/gtk-doc/html/gio/GSettings.html +2424 -0
  188. data/vendor/local/share/gtk-doc/html/gio/GSettingsBackend.html +609 -0
  189. data/vendor/local/share/gtk-doc/html/gio/GSimpleAsyncResult.html +362 -148
  190. data/vendor/local/share/gtk-doc/html/gio/GSimplePermission.html +107 -0
  191. data/vendor/local/share/gtk-doc/html/gio/GSocket.html +612 -326
  192. data/vendor/local/share/gtk-doc/html/gio/GSocketAddress.html +36 -36
  193. data/vendor/local/share/gtk-doc/html/gio/GSocketClient.html +470 -108
  194. data/vendor/local/share/gtk-doc/html/gio/GSocketConnectable.html +131 -46
  195. data/vendor/local/share/gtk-doc/html/gio/GSocketConnection.html +48 -259
  196. data/vendor/local/share/gtk-doc/html/gio/GSocketControlMessage.html +27 -26
  197. data/vendor/local/share/gtk-doc/html/gio/GSocketListener.html +123 -119
  198. data/vendor/local/share/gtk-doc/html/gio/GSocketService.html +24 -24
  199. data/vendor/local/share/gtk-doc/html/gio/GTcpConnection.html +165 -0
  200. data/vendor/local/share/gtk-doc/html/gio/GThemedIcon.html +36 -36
  201. data/vendor/local/share/gtk-doc/html/gio/GThreadedSocketService.html +27 -27
  202. data/vendor/local/share/gtk-doc/html/gio/GUnixConnection.html +298 -0
  203. data/vendor/local/share/gtk-doc/html/gio/GUnixCredentialsMessage.html +222 -0
  204. data/vendor/local/share/gtk-doc/html/gio/GUnixFDList.html +65 -57
  205. data/vendor/local/share/gtk-doc/html/gio/GUnixFDMessage.html +59 -51
  206. data/vendor/local/share/gtk-doc/html/gio/GUnixInputStream.html +38 -38
  207. data/vendor/local/share/gtk-doc/html/gio/GUnixOutputStream.html +39 -39
  208. data/vendor/local/share/gtk-doc/html/gio/GUnixSocketAddress.html +246 -61
  209. data/vendor/local/share/gtk-doc/html/gio/GVfs.html +36 -36
  210. data/vendor/local/share/gtk-doc/html/gio/GVolume.html +113 -113
  211. data/vendor/local/share/gtk-doc/html/gio/GVolumeMonitor.html +67 -71
  212. data/vendor/local/share/gtk-doc/html/gio/GZlibCompressor.html +90 -18
  213. data/vendor/local/share/gtk-doc/html/gio/GZlibDecompressor.html +56 -14
  214. data/vendor/local/share/gtk-doc/html/gio/annotation-glossary.html +65 -0
  215. data/vendor/local/share/gtk-doc/html/gio/api-index-2-18.html +3 -3
  216. data/vendor/local/share/gtk-doc/html/gio/api-index-2-20.html +3 -3
  217. data/vendor/local/share/gtk-doc/html/gio/api-index-2-22.html +8 -12
  218. data/vendor/local/share/gtk-doc/html/gio/api-index-2-24.html +21 -4
  219. data/vendor/local/share/gtk-doc/html/gio/api-index-2-26.html +1598 -0
  220. data/vendor/local/share/gtk-doc/html/gio/api-index-deprecated.html +18 -3
  221. data/vendor/local/share/gtk-doc/html/gio/api-index-full.html +2412 -661
  222. data/vendor/local/share/gtk-doc/html/gio/async.html +3 -3
  223. data/vendor/local/share/gtk-doc/html/gio/ch01.html +50 -14
  224. data/vendor/local/share/gtk-doc/html/gio/ch02.html +14 -9
  225. data/vendor/local/share/gtk-doc/html/gio/ch03.html +122 -22
  226. data/vendor/local/share/gtk-doc/html/gio/{ch19.html → ch24.html} +8 -8
  227. data/vendor/local/share/gtk-doc/html/gio/{ch20.html → ch25.html} +19 -19
  228. data/vendor/local/share/gtk-doc/html/gio/{ch20s02.html → ch25s02.html} +10 -10
  229. data/vendor/local/share/gtk-doc/html/gio/{ch20s03.html → ch25s03.html} +12 -12
  230. data/vendor/local/share/gtk-doc/html/gio/ch26.html +57 -0
  231. data/vendor/local/share/gtk-doc/html/gio/ch26s02.html +59 -0
  232. data/vendor/local/share/gtk-doc/html/gio/ch26s03.html +159 -0
  233. data/vendor/local/share/gtk-doc/html/gio/ch26s04.html +46 -0
  234. data/vendor/local/share/gtk-doc/html/gio/ch26s05.html +48 -0
  235. data/vendor/local/share/gtk-doc/html/gio/ch26s06.html +277 -0
  236. data/vendor/local/share/gtk-doc/html/gio/ch26s07.html +95 -0
  237. data/vendor/local/share/gtk-doc/html/gio/ch27.html +70 -0
  238. data/vendor/local/share/gtk-doc/html/gio/ch27s02.html +130 -0
  239. data/vendor/local/share/gtk-doc/html/gio/ch27s03.html +202 -0
  240. data/vendor/local/share/gtk-doc/html/gio/ch27s04.html +96 -0
  241. data/vendor/local/share/gtk-doc/html/gio/ch27s05.html +823 -0
  242. data/vendor/local/share/gtk-doc/html/gio/ch27s06.html +828 -0
  243. data/vendor/local/share/gtk-doc/html/gio/conversion.html +3 -3
  244. data/vendor/local/share/gtk-doc/html/gio/extending-gio.html +33 -20
  245. data/vendor/local/share/gtk-doc/html/gio/extending.html +5 -5
  246. data/vendor/local/share/gtk-doc/html/gio/failable_initialization.html +3 -3
  247. data/vendor/local/share/gtk-doc/html/gio/file_mon.html +3 -3
  248. data/vendor/local/share/gtk-doc/html/gio/file_ops.html +3 -3
  249. data/vendor/local/share/gtk-doc/html/gio/gdbus-convenience.html +41 -0
  250. data/vendor/local/share/gtk-doc/html/gio/gdbus-lowlevel.html +59 -0
  251. data/vendor/local/share/gtk-doc/html/gio/gdbus.html +243 -0
  252. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Addresses.html +316 -0
  253. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Introspection-Data.html +1117 -0
  254. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Utilities.html +216 -0
  255. data/vendor/local/share/gtk-doc/html/gio/gio-Desktop-file-based-GAppInfo.html +35 -35
  256. data/vendor/local/share/gtk-doc/html/gio/gio-Extension-Points.html +58 -50
  257. data/vendor/local/share/gtk-doc/html/gio/gio-GContentType.html +98 -88
  258. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterInputstream.html +15 -19
  259. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterOutputstream.html +15 -19
  260. data/vendor/local/share/gtk-doc/html/gio/gio-GDBusError.html +908 -0
  261. data/vendor/local/share/gtk-doc/html/gio/gio-GFileAttribute.html +37 -31
  262. data/vendor/local/share/gtk-doc/html/gio/gio-GIOError.html +97 -16
  263. data/vendor/local/share/gtk-doc/html/gio/gio-GIOScheduler.html +50 -50
  264. data/vendor/local/share/gtk-doc/html/gio/gio-GSrvTarget.html +38 -38
  265. data/vendor/local/share/gtk-doc/html/gio/gio-Owning-Bus-Names.html +736 -0
  266. data/vendor/local/share/gtk-doc/html/gio/gio-Unix-Mounts.html +113 -122
  267. data/vendor/local/share/gtk-doc/html/gio/gio-Watching-Bus-Names.html +666 -0
  268. data/vendor/local/share/gtk-doc/html/gio/gio-hierarchy.html +26 -10
  269. data/vendor/local/share/gtk-doc/html/gio/gio-querymodules.html +53 -0
  270. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp +569 -68
  271. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp2 +692 -70
  272. data/vendor/local/share/gtk-doc/html/gio/glib-compile-schemas.html +102 -0
  273. data/vendor/local/share/gtk-doc/html/gio/highlevel-socket.html +11 -5
  274. data/vendor/local/share/gtk-doc/html/gio/icons.html +3 -3
  275. data/vendor/local/share/gtk-doc/html/gio/index.html +137 -20
  276. data/vendor/local/share/gtk-doc/html/gio/index.sgml +814 -96
  277. data/vendor/local/share/gtk-doc/html/gio/migrating.html +32 -12
  278. data/vendor/local/share/gtk-doc/html/gio/networking.html +19 -7
  279. data/vendor/local/share/gtk-doc/html/gio/permissions.html +39 -0
  280. data/vendor/local/share/gtk-doc/html/gio/pt01.html +4 -4
  281. data/vendor/local/share/gtk-doc/html/gio/pt02.html +112 -15
  282. data/vendor/local/share/gtk-doc/html/gio/resolver.html +8 -5
  283. data/vendor/local/share/gtk-doc/html/gio/settings.html +38 -0
  284. data/vendor/local/share/gtk-doc/html/gio/streaming.html +4 -4
  285. data/vendor/local/share/gtk-doc/html/gio/style.css +8 -0
  286. data/vendor/local/share/gtk-doc/html/gio/tools.html +44 -0
  287. data/vendor/local/share/gtk-doc/html/gio/types.html +3 -3
  288. data/vendor/local/share/gtk-doc/html/gio/utils.html +5 -5
  289. data/vendor/local/share/gtk-doc/html/gio/volume_mon.html +4 -4
  290. data/vendor/local/share/gtk-doc/html/glib/annotation-glossary.html +77 -0
  291. data/vendor/local/share/gtk-doc/html/glib/api-index-2-10.html +3 -3
  292. data/vendor/local/share/gtk-doc/html/glib/api-index-2-12.html +3 -3
  293. data/vendor/local/share/gtk-doc/html/glib/api-index-2-14.html +3 -7
  294. data/vendor/local/share/gtk-doc/html/glib/api-index-2-16.html +3 -3
  295. data/vendor/local/share/gtk-doc/html/glib/api-index-2-18.html +3 -3
  296. data/vendor/local/share/gtk-doc/html/glib/api-index-2-2.html +3 -3
  297. data/vendor/local/share/gtk-doc/html/glib/api-index-2-20.html +3 -3
  298. data/vendor/local/share/gtk-doc/html/glib/api-index-2-22.html +3 -3
  299. data/vendor/local/share/gtk-doc/html/glib/api-index-2-24.html +5 -4
  300. data/vendor/local/share/gtk-doc/html/glib/api-index-2-26.html +359 -0
  301. data/vendor/local/share/gtk-doc/html/glib/api-index-2-4.html +10 -3
  302. data/vendor/local/share/gtk-doc/html/glib/api-index-2-6.html +8 -4
  303. data/vendor/local/share/gtk-doc/html/glib/api-index-2-8.html +3 -3
  304. data/vendor/local/share/gtk-doc/html/glib/api-index-deprecated.html +82 -3
  305. data/vendor/local/share/gtk-doc/html/glib/api-index-full.html +393 -14
  306. data/vendor/local/share/gtk-doc/html/glib/glib-Arrays.html +52 -52
  307. data/vendor/local/share/gtk-doc/html/glib/glib-Asynchronous-Queues.html +51 -51
  308. data/vendor/local/share/gtk-doc/html/glib/glib-Atomic-Operations.html +75 -74
  309. data/vendor/local/share/gtk-doc/html/glib/glib-Automatic-String-Completion.html +59 -23
  310. data/vendor/local/share/gtk-doc/html/glib/glib-Balanced-Binary-Trees.html +35 -35
  311. data/vendor/local/share/gtk-doc/html/glib/glib-Base64-Encoding.html +19 -19
  312. data/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html +37 -37
  313. data/vendor/local/share/gtk-doc/html/glib/glib-Bookmark-file-parser.html +87 -85
  314. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Arrays.html +39 -39
  315. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Order-Macros.html +69 -69
  316. data/vendor/local/share/gtk-doc/html/glib/glib-Caches.html +21 -21
  317. data/vendor/local/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html +130 -223
  318. data/vendor/local/share/gtk-doc/html/glib/glib-Commandline-option-parser.html +114 -108
  319. data/vendor/local/share/gtk-doc/html/glib/glib-Data-Checksums.html +25 -25
  320. data/vendor/local/share/gtk-doc/html/glib/glib-Datasets.html +20 -20
  321. data/vendor/local/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html +87 -84
  322. data/vendor/local/share/gtk-doc/html/glib/glib-Double-ended-Queues.html +61 -61
  323. data/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html +96 -96
  324. data/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html +30 -30
  325. data/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html +33 -30
  326. data/vendor/local/share/gtk-doc/html/glib/glib-File-Utilities.html +98 -56
  327. data/vendor/local/share/gtk-doc/html/glib/glib-GDateTime.html +2201 -0
  328. data/vendor/local/share/gtk-doc/html/glib/glib-GTimeZone.html +239 -0
  329. data/vendor/local/share/gtk-doc/html/glib/glib-GVariant.html +736 -256
  330. data/vendor/local/share/gtk-doc/html/glib/glib-GVariantType.html +140 -91
  331. data/vendor/local/share/gtk-doc/html/glib/glib-Glob-style-pattern-matching.html +15 -15
  332. data/vendor/local/share/gtk-doc/html/glib/glib-Hash-Tables.html +59 -59
  333. data/vendor/local/share/gtk-doc/html/glib/glib-Hook-Functions.html +65 -65
  334. data/vendor/local/share/gtk-doc/html/glib/glib-Hostname-Utilities.html +11 -11
  335. data/vendor/local/share/gtk-doc/html/glib/glib-I18N.html +91 -28
  336. data/vendor/local/share/gtk-doc/html/glib/glib-IO-Channels.html +72 -72
  337. data/vendor/local/share/gtk-doc/html/glib/glib-Key-value-file-parser.html +257 -73
  338. data/vendor/local/share/gtk-doc/html/glib/glib-Keyed-Data-Lists.html +27 -27
  339. data/vendor/local/share/gtk-doc/html/glib/glib-Lexical-Scanner.html +50 -50
  340. data/vendor/local/share/gtk-doc/html/glib/glib-Limits-of-Basic-Types.html +37 -37
  341. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html +70 -66
  342. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocators.html +14 -14
  343. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Chunks.html +44 -44
  344. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Slices.html +20 -20
  345. data/vendor/local/share/gtk-doc/html/glib/glib-Message-Logging.html +108 -63
  346. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Macros.html +151 -91
  347. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html +132 -103
  348. data/vendor/local/share/gtk-doc/html/glib/glib-N-ary-Trees.html +83 -81
  349. data/vendor/local/share/gtk-doc/html/glib/glib-Numerical-Definitions.html +34 -44
  350. data/vendor/local/share/gtk-doc/html/glib/glib-Perl-compatible-regular-expressions.html +442 -345
  351. data/vendor/local/share/gtk-doc/html/glib/glib-Pointer-Arrays.html +40 -40
  352. data/vendor/local/share/gtk-doc/html/glib/glib-Quarks.html +19 -19
  353. data/vendor/local/share/gtk-doc/html/glib/glib-Random-Numbers.html +35 -35
  354. data/vendor/local/share/gtk-doc/html/glib/glib-Relations-and-Tuples.html +72 -23
  355. data/vendor/local/share/gtk-doc/html/glib/glib-Sequences.html +46 -46
  356. data/vendor/local/share/gtk-doc/html/glib/glib-Shell-related-Utilities.html +15 -15
  357. data/vendor/local/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html +35 -36
  358. data/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html +130 -129
  359. data/vendor/local/share/gtk-doc/html/glib/glib-Spawning-Processes.html +21 -21
  360. data/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html +30 -26
  361. data/vendor/local/share/gtk-doc/html/glib/glib-String-Chunks.html +21 -21
  362. data/vendor/local/share/gtk-doc/html/glib/glib-String-Utility-Functions.html +245 -232
  363. data/vendor/local/share/gtk-doc/html/glib/glib-Strings.html +104 -103
  364. data/vendor/local/share/gtk-doc/html/glib/glib-Testing.html +171 -85
  365. data/vendor/local/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html +422 -323
  366. data/vendor/local/share/gtk-doc/html/glib/glib-Thread-Pools.html +24 -24
  367. data/vendor/local/share/gtk-doc/html/glib/glib-Threads.html +135 -135
  368. data/vendor/local/share/gtk-doc/html/glib/glib-Timers.html +18 -18
  369. data/vendor/local/share/gtk-doc/html/glib/glib-Trash-Stacks.html +11 -11
  370. data/vendor/local/share/gtk-doc/html/glib/glib-Type-Conversion-Macros.html +13 -13
  371. data/vendor/local/share/gtk-doc/html/glib/glib-URI-Functions.html +103 -17
  372. data/vendor/local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html +189 -97
  373. data/vendor/local/share/gtk-doc/html/glib/glib-Version-Information.html +119 -16
  374. data/vendor/local/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html +24 -24
  375. data/vendor/local/share/gtk-doc/html/glib/glib-Windows-Compatibility-Functions.html +32 -32
  376. data/vendor/local/share/gtk-doc/html/glib/glib-building.html +53 -25
  377. data/vendor/local/share/gtk-doc/html/glib/glib-changes.html +7 -7
  378. data/vendor/local/share/gtk-doc/html/glib/glib-compiling.html +5 -5
  379. data/vendor/local/share/gtk-doc/html/glib/glib-core.html +3 -3
  380. data/vendor/local/share/gtk-doc/html/glib/glib-cross-compiling.html +19 -19
  381. data/vendor/local/share/gtk-doc/html/glib/glib-data-types.html +3 -3
  382. data/vendor/local/share/gtk-doc/html/glib/glib-fundamentals.html +3 -3
  383. data/vendor/local/share/gtk-doc/html/glib/glib-gettextize.html +11 -11
  384. data/vendor/local/share/gtk-doc/html/glib/glib-regex-syntax.html +94 -272
  385. data/vendor/local/share/gtk-doc/html/glib/glib-resources.html +9 -9
  386. data/vendor/local/share/gtk-doc/html/glib/glib-running.html +43 -26
  387. data/vendor/local/share/gtk-doc/html/glib/glib-utilities.html +10 -4
  388. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp +131 -32
  389. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp2 +174 -59
  390. data/vendor/local/share/gtk-doc/html/glib/glib.html +3 -3
  391. data/vendor/local/share/gtk-doc/html/glib/gtester-report.html +11 -11
  392. data/vendor/local/share/gtk-doc/html/glib/gtester.html +11 -11
  393. data/vendor/local/share/gtk-doc/html/glib/gvariant-format-strings.html +190 -73
  394. data/vendor/local/share/gtk-doc/html/glib/index.html +13 -5
  395. data/vendor/local/share/gtk-doc/html/glib/index.sgml +133 -4
  396. data/vendor/local/share/gtk-doc/html/glib/style.css +8 -0
  397. data/vendor/local/share/gtk-doc/html/glib/tools.html +3 -3
  398. data/vendor/local/share/gtk-doc/html/gobject/GBinding.html +803 -0
  399. data/vendor/local/share/gtk-doc/html/gobject/GTypeModule.html +21 -21
  400. data/vendor/local/share/gtk-doc/html/gobject/GTypePlugin.html +19 -19
  401. data/vendor/local/share/gtk-doc/html/gobject/annotation-glossary.html +47 -0
  402. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-10.html +3 -3
  403. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-12.html +3 -3
  404. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-14.html +3 -3
  405. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-18.html +3 -3
  406. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-2.html +3 -3
  407. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-22.html +3 -3
  408. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-24.html +6 -5
  409. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-26.html +201 -0
  410. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-4.html +3 -3
  411. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-6.html +3 -3
  412. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-8.html +3 -3
  413. data/vendor/local/share/gtk-doc/html/gobject/api-index-deprecated.html +3 -3
  414. data/vendor/local/share/gtk-doc/html/gobject/api-index-full.html +148 -4
  415. data/vendor/local/share/gtk-doc/html/gobject/ch01s02.html +7 -7
  416. data/vendor/local/share/gtk-doc/html/gobject/ch06s03.html +4 -4
  417. data/vendor/local/share/gtk-doc/html/gobject/chapter-gobject.html +4 -4
  418. data/vendor/local/share/gtk-doc/html/gobject/chapter-gtype.html +6 -6
  419. data/vendor/local/share/gtk-doc/html/gobject/chapter-intro.html +6 -6
  420. data/vendor/local/share/gtk-doc/html/gobject/chapter-signal.html +14 -14
  421. data/vendor/local/share/gtk-doc/html/gobject/glib-genmarshal.html +28 -22
  422. data/vendor/local/share/gtk-doc/html/gobject/glib-mkenums.html +29 -17
  423. data/vendor/local/share/gtk-doc/html/gobject/gobject-Boxed-Types.html +45 -34
  424. data/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html +130 -73
  425. data/vendor/local/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html +43 -43
  426. data/vendor/local/share/gtk-doc/html/gobject/gobject-GParamSpec.html +83 -73
  427. data/vendor/local/share/gtk-doc/html/gobject/gobject-Generic-values.html +35 -35
  428. data/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html +71 -71
  429. data/vendor/local/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html +558 -245
  430. data/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html +358 -92
  431. data/vendor/local/share/gtk-doc/html/gobject/gobject-Type-Information.html +391 -158
  432. data/vendor/local/share/gtk-doc/html/gobject/gobject-Value-arrays.html +47 -44
  433. data/vendor/local/share/gtk-doc/html/gobject/gobject-Varargs-Value-Collection.html +42 -12
  434. data/vendor/local/share/gtk-doc/html/gobject/gobject-memory.html +6 -6
  435. data/vendor/local/share/gtk-doc/html/gobject/gobject-properties.html +8 -8
  436. data/vendor/local/share/gtk-doc/html/gobject/gobject-query.html +10 -10
  437. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp +48 -9
  438. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp2 +53 -9
  439. data/vendor/local/share/gtk-doc/html/gobject/gtype-conventions.html +6 -6
  440. data/vendor/local/share/gtk-doc/html/gobject/gtype-instantiable-classed.html +4 -4
  441. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable-classed.html +5 -5
  442. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable.html +3 -3
  443. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-chainup.html +5 -5
  444. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-code.html +3 -3
  445. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-construction.html +3 -3
  446. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-destruction.html +3 -3
  447. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-methods.html +9 -9
  448. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject.html +8 -8
  449. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-implement.html +4 -4
  450. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-properties.html +7 -7
  451. data/vendor/local/share/gtk-doc/html/gobject/howto-interface.html +4 -4
  452. data/vendor/local/share/gtk-doc/html/gobject/howto-signals.html +6 -6
  453. data/vendor/local/share/gtk-doc/html/gobject/index.html +15 -10
  454. data/vendor/local/share/gtk-doc/html/gobject/index.sgml +53 -1
  455. data/vendor/local/share/gtk-doc/html/gobject/pr01.html +4 -4
  456. data/vendor/local/share/gtk-doc/html/gobject/pt01.html +7 -7
  457. data/vendor/local/share/gtk-doc/html/gobject/pt02.html +8 -8
  458. data/vendor/local/share/gtk-doc/html/gobject/pt03.html +5 -5
  459. data/vendor/local/share/gtk-doc/html/gobject/rn01.html +7 -4
  460. data/vendor/local/share/gtk-doc/html/gobject/rn02.html +6 -6
  461. data/vendor/local/share/gtk-doc/html/gobject/signal.html +11 -11
  462. data/vendor/local/share/gtk-doc/html/gobject/style.css +8 -0
  463. data/vendor/local/share/gtk-doc/html/gobject/tools-ginspector.html +3 -3
  464. data/vendor/local/share/gtk-doc/html/gobject/tools-gob.html +3 -3
  465. data/vendor/local/share/gtk-doc/html/gobject/tools-gtkdoc.html +3 -3
  466. data/vendor/local/share/gtk-doc/html/gobject/tools-refdb.html +3 -3
  467. data/vendor/local/share/gtk-doc/html/gobject/tools-vala.html +3 -3
  468. data/vendor/local/share/locale/af/LC_MESSAGES/glib20.mo +0 -0
  469. data/vendor/local/share/locale/am/LC_MESSAGES/glib20.mo +0 -0
  470. data/vendor/local/share/locale/ar/LC_MESSAGES/glib20.mo +0 -0
  471. data/vendor/local/share/locale/as/LC_MESSAGES/glib20.mo +0 -0
  472. data/vendor/local/share/locale/ast/LC_MESSAGES/glib20.mo +0 -0
  473. data/vendor/local/share/locale/az/LC_MESSAGES/glib20.mo +0 -0
  474. data/vendor/local/share/locale/be/LC_MESSAGES/glib20.mo +0 -0
  475. data/vendor/local/share/locale/be@latin/LC_MESSAGES/glib20.mo +0 -0
  476. data/vendor/local/share/locale/bg/LC_MESSAGES/glib20.mo +0 -0
  477. data/vendor/local/share/locale/bn/LC_MESSAGES/glib20.mo +0 -0
  478. data/vendor/local/share/locale/bn_IN/LC_MESSAGES/glib20.mo +0 -0
  479. data/vendor/local/share/locale/bs/LC_MESSAGES/glib20.mo +0 -0
  480. data/vendor/local/share/locale/ca/LC_MESSAGES/glib20.mo +0 -0
  481. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/glib20.mo +0 -0
  482. data/vendor/local/share/locale/cs/LC_MESSAGES/glib20.mo +0 -0
  483. data/vendor/local/share/locale/cy/LC_MESSAGES/glib20.mo +0 -0
  484. data/vendor/local/share/locale/da/LC_MESSAGES/glib20.mo +0 -0
  485. data/vendor/local/share/locale/de/LC_MESSAGES/glib20.mo +0 -0
  486. data/vendor/local/share/locale/dz/LC_MESSAGES/glib20.mo +0 -0
  487. data/vendor/local/share/locale/el/LC_MESSAGES/glib20.mo +0 -0
  488. data/vendor/local/share/locale/en@shaw/LC_MESSAGES/glib20.mo +0 -0
  489. data/vendor/local/share/locale/en_CA/LC_MESSAGES/glib20.mo +0 -0
  490. data/vendor/local/share/locale/en_GB/LC_MESSAGES/glib20.mo +0 -0
  491. data/vendor/local/share/locale/eo/LC_MESSAGES/glib20.mo +0 -0
  492. data/vendor/local/share/locale/es/LC_MESSAGES/glib20.mo +0 -0
  493. data/vendor/local/share/locale/et/LC_MESSAGES/glib20.mo +0 -0
  494. data/vendor/local/share/locale/eu/LC_MESSAGES/glib20.mo +0 -0
  495. data/vendor/local/share/locale/fa/LC_MESSAGES/glib20.mo +0 -0
  496. data/vendor/local/share/locale/fi/LC_MESSAGES/glib20.mo +0 -0
  497. data/vendor/local/share/locale/fr/LC_MESSAGES/glib20.mo +0 -0
  498. data/vendor/local/share/locale/ga/LC_MESSAGES/glib20.mo +0 -0
  499. data/vendor/local/share/locale/gl/LC_MESSAGES/glib20.mo +0 -0
  500. data/vendor/local/share/locale/gu/LC_MESSAGES/glib20.mo +0 -0
  501. data/vendor/local/share/locale/he/LC_MESSAGES/glib20.mo +0 -0
  502. data/vendor/local/share/locale/hi/LC_MESSAGES/glib20.mo +0 -0
  503. data/vendor/local/share/locale/hr/LC_MESSAGES/glib20.mo +0 -0
  504. data/vendor/local/share/locale/hu/LC_MESSAGES/glib20.mo +0 -0
  505. data/vendor/local/share/locale/hy/LC_MESSAGES/glib20.mo +0 -0
  506. data/vendor/local/share/locale/id/LC_MESSAGES/glib20.mo +0 -0
  507. data/vendor/local/share/locale/is/LC_MESSAGES/glib20.mo +0 -0
  508. data/vendor/local/share/locale/it/LC_MESSAGES/glib20.mo +0 -0
  509. data/vendor/local/share/locale/ja/LC_MESSAGES/glib20.mo +0 -0
  510. data/vendor/local/share/locale/ka/LC_MESSAGES/glib20.mo +0 -0
  511. data/vendor/local/share/locale/kk/LC_MESSAGES/glib20.mo +0 -0
  512. data/vendor/local/share/locale/kn/LC_MESSAGES/glib20.mo +0 -0
  513. data/vendor/local/share/locale/ko/LC_MESSAGES/glib20.mo +0 -0
  514. data/vendor/local/share/locale/ku/LC_MESSAGES/glib20.mo +0 -0
  515. data/vendor/local/share/locale/lt/LC_MESSAGES/glib20.mo +0 -0
  516. data/vendor/local/share/locale/lv/LC_MESSAGES/glib20.mo +0 -0
  517. data/vendor/local/share/locale/mai/LC_MESSAGES/glib20.mo +0 -0
  518. data/vendor/local/share/locale/mg/LC_MESSAGES/glib20.mo +0 -0
  519. data/vendor/local/share/locale/mk/LC_MESSAGES/glib20.mo +0 -0
  520. data/vendor/local/share/locale/ml/LC_MESSAGES/glib20.mo +0 -0
  521. data/vendor/local/share/locale/mn/LC_MESSAGES/glib20.mo +0 -0
  522. data/vendor/local/share/locale/mr/LC_MESSAGES/glib20.mo +0 -0
  523. data/vendor/local/share/locale/ms/LC_MESSAGES/glib20.mo +0 -0
  524. data/vendor/local/share/locale/nb/LC_MESSAGES/glib20.mo +0 -0
  525. data/vendor/local/share/locale/nds/LC_MESSAGES/glib20.mo +0 -0
  526. data/vendor/local/share/locale/ne/LC_MESSAGES/glib20.mo +0 -0
  527. data/vendor/local/share/locale/nl/LC_MESSAGES/glib20.mo +0 -0
  528. data/vendor/local/share/locale/nn/LC_MESSAGES/glib20.mo +0 -0
  529. data/vendor/local/share/locale/oc/LC_MESSAGES/glib20.mo +0 -0
  530. data/vendor/local/share/locale/or/LC_MESSAGES/glib20.mo +0 -0
  531. data/vendor/local/share/locale/pa/LC_MESSAGES/glib20.mo +0 -0
  532. data/vendor/local/share/locale/pl/LC_MESSAGES/glib20.mo +0 -0
  533. data/vendor/local/share/locale/ps/LC_MESSAGES/glib20.mo +0 -0
  534. data/vendor/local/share/locale/pt/LC_MESSAGES/glib20.mo +0 -0
  535. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/glib20.mo +0 -0
  536. data/vendor/local/share/locale/ro/LC_MESSAGES/glib20.mo +0 -0
  537. data/vendor/local/share/locale/ru/LC_MESSAGES/glib20.mo +0 -0
  538. data/vendor/local/share/locale/rw/LC_MESSAGES/glib20.mo +0 -0
  539. data/vendor/local/share/locale/si/LC_MESSAGES/glib20.mo +0 -0
  540. data/vendor/local/share/locale/sk/LC_MESSAGES/glib20.mo +0 -0
  541. data/vendor/local/share/locale/sl/LC_MESSAGES/glib20.mo +0 -0
  542. data/vendor/local/share/locale/sq/LC_MESSAGES/glib20.mo +0 -0
  543. data/vendor/local/share/locale/sr/LC_MESSAGES/glib20.mo +0 -0
  544. data/vendor/local/share/locale/sr@ije/LC_MESSAGES/glib20.mo +0 -0
  545. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/glib20.mo +0 -0
  546. data/vendor/local/share/locale/sv/LC_MESSAGES/glib20.mo +0 -0
  547. data/vendor/local/share/locale/ta/LC_MESSAGES/glib20.mo +0 -0
  548. data/vendor/local/share/locale/te/LC_MESSAGES/glib20.mo +0 -0
  549. data/vendor/local/share/locale/th/LC_MESSAGES/glib20.mo +0 -0
  550. data/vendor/local/share/locale/tl/LC_MESSAGES/glib20.mo +0 -0
  551. data/vendor/local/share/locale/tr/LC_MESSAGES/glib20.mo +0 -0
  552. data/vendor/local/share/locale/tt/LC_MESSAGES/glib20.mo +0 -0
  553. data/vendor/local/share/locale/uk/LC_MESSAGES/glib20.mo +0 -0
  554. data/vendor/local/share/locale/vi/LC_MESSAGES/glib20.mo +0 -0
  555. data/vendor/local/share/locale/wa/LC_MESSAGES/glib20.mo +0 -0
  556. data/vendor/local/share/locale/xh/LC_MESSAGES/glib20.mo +0 -0
  557. data/vendor/local/share/locale/yi/LC_MESSAGES/glib20.mo +0 -0
  558. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/glib20.mo +0 -0
  559. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/glib20.mo +0 -0
  560. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/glib20.mo +0 -0
  561. data/vendor/local/share/man/man1/glib-genmarshal.1 +9 -4
  562. data/vendor/local/share/man/man1/glib-mkenums.1 +17 -5
  563. data/vendor/local/share/man/man1/gobject-query.1 +4 -4
  564. data/vendor/local/src/tml/packaging/{glib_2.24.2-2_win32.log → glib_2.26.0-2_win32.log} +1102 -837
  565. data/vendor/local/src/tml/packaging/glib_2.26.0-2_win32.sh +64 -0
  566. metadata +905 -825
  567. data/vendor/local/src/tml/packaging/glib_2.24.2-2_win32.sh +0 -290
@@ -8,7 +8,7 @@
8
8
  <link rel="up" href="streaming.html" title="Streaming I/O">
9
9
  <link rel="prev" href="streaming.html" title="Streaming I/O">
10
10
  <link rel="next" href="GInputStream.html" title="GInputStream">
11
- <meta name="generator" content="GTK-Doc V1.14 (XML mode)">
11
+ <meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
12
12
  <link rel="stylesheet" href="style.css" type="text/css">
13
13
  </head>
14
14
  <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -32,7 +32,7 @@
32
32
  <a href="#GSeekable.implementations" class="shortcut">Known Implementations</a>
33
33
  </td></tr>
34
34
  </table>
35
- <div class="refentry" title="GSeekable">
35
+ <div class="refentry">
36
36
  <a name="GSeekable"></a><div class="titlepage"></div>
37
37
  <div class="refnamediv"><table width="100%"><tr>
38
38
  <td valign="top">
@@ -41,56 +41,56 @@
41
41
  </td>
42
42
  <td valign="top" align="right"></td>
43
43
  </tr></table></div>
44
- <div class="refsynopsisdiv" title="Synopsis">
44
+ <div class="refsynopsisdiv">
45
45
  <a name="GSeekable.synopsis"></a><h2>Synopsis</h2>
46
46
  <pre class="synopsis">
47
47
  #include &lt;gio/gio.h&gt;
48
48
 
49
49
  <a class="link" href="GSeekable.html#GSeekable-struct" title="GSeekable">GSeekable</a>;
50
50
  <a class="link" href="GSeekable.html#GSeekableIface" title="GSeekableIface">GSeekableIface</a>;
51
- <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#goffset"><span class="returnvalue">goffset</span></a> <a class="link" href="GSeekable.html#g-seekable-tell" title="g_seekable_tell ()">g_seekable_tell</a> (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>);
52
- <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSeekable.html#g-seekable-can-seek" title="g_seekable_can_seek ()">g_seekable_can_seek</a> (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>);
53
- <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSeekable.html#g-seekable-seek" title="g_seekable_seek ()">g_seekable_seek</a> (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>,
54
- <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a> offset</code></em>,
55
- <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-IO-Channels.html#GSeekType"><span class="type">GSeekType</span></a> type</code></em>,
51
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#goffset"><span class="returnvalue">goffset</span></a> <a class="link" href="GSeekable.html#g-seekable-tell" title="g_seekable_tell ()">g_seekable_tell</a> (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>);
52
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSeekable.html#g-seekable-can-seek" title="g_seekable_can_seek ()">g_seekable_can_seek</a> (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>);
53
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSeekable.html#g-seekable-seek" title="g_seekable_seek ()">g_seekable_seek</a> (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>,
54
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a> offset</code></em>,
55
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-IO-Channels.html#GSeekType"><span class="type">GSeekType</span></a> type</code></em>,
56
56
  <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
57
- <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
58
- <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSeekable.html#g-seekable-can-truncate" title="g_seekable_can_truncate ()">g_seekable_can_truncate</a> (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>);
59
- <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSeekable.html#g-seekable-truncate" title="g_seekable_truncate ()">g_seekable_truncate</a> (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>,
60
- <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a> offset</code></em>,
57
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
58
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSeekable.html#g-seekable-can-truncate" title="g_seekable_can_truncate ()">g_seekable_can_truncate</a> (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>);
59
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSeekable.html#g-seekable-truncate" title="g_seekable_truncate ()">g_seekable_truncate</a> (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>,
60
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a> offset</code></em>,
61
61
  <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
62
- <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
62
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
63
63
  </pre>
64
64
  </div>
65
- <div class="refsect1" title="Object Hierarchy">
65
+ <div class="refsect1">
66
66
  <a name="GSeekable.object-hierarchy"></a><h2>Object Hierarchy</h2>
67
67
  <pre class="synopsis">
68
68
  GInterface
69
69
  +----GSeekable
70
70
  </pre>
71
71
  </div>
72
- <div class="refsect1" title="Prerequisites">
72
+ <div class="refsect1">
73
73
  <a name="GSeekable.prerequisites"></a><h2>Prerequisites</h2>
74
74
  <p>
75
75
  GSeekable requires
76
- <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>.</p>
76
+ <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>.</p>
77
77
  </div>
78
- <div class="refsect1" title="Known Implementations">
78
+ <div class="refsect1">
79
79
  <a name="GSeekable.implementations"></a><h2>Known Implementations</h2>
80
80
  <p>
81
81
  GSeekable is implemented by
82
82
  <a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a>, <a class="link" href="GFileInputStream.html" title="GFileInputStream">GFileInputStream</a>, <a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a>, <a class="link" href="GMemoryInputStream.html" title="GMemoryInputStream">GMemoryInputStream</a> and <a class="link" href="GMemoryOutputStream.html" title="GMemoryOutputStream">GMemoryOutputStream</a>.</p>
83
83
  </div>
84
- <div class="refsect1" title="Description">
84
+ <div class="refsect1">
85
85
  <a name="GSeekable.description"></a><h2>Description</h2>
86
86
  <p>
87
87
  <a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> is implemented by streams (implementations of
88
88
  <a class="link" href="GInputStream.html" title="GInputStream"><span class="type">GInputStream</span></a> or <a class="link" href="GOutputStream.html" title="GOutputStream"><span class="type">GOutputStream</span></a>) that support seeking.
89
89
  </p>
90
90
  </div>
91
- <div class="refsect1" title="Details">
91
+ <div class="refsect1">
92
92
  <a name="GSeekable.details"></a><h2>Details</h2>
93
- <div class="refsect2" title="GSeekable">
93
+ <div class="refsect2">
94
94
  <a name="GSeekable-struct"></a><h3>GSeekable</h3>
95
95
  <pre class="programlisting">typedef struct _GSeekable GSeekable;</pre>
96
96
  <p>
@@ -98,7 +98,7 @@ Seek object for streaming operations.
98
98
  </p>
99
99
  </div>
100
100
  <hr>
101
- <div class="refsect2" title="GSeekableIface">
101
+ <div class="refsect2">
102
102
  <a name="GSeekableIface"></a><h3>GSeekableIface</h3>
103
103
  <pre class="programlisting">typedef struct {
104
104
  GTypeInterface g_iface;
@@ -130,7 +130,7 @@ Provides an interface for implementing seekable functionality on I/O Streams.
130
130
  <col align="left" valign="top">
131
131
  <tbody>
132
132
  <tr>
133
- <td><p><span class="term"><a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GTypeInterface"><span class="type">GTypeInterface</span></a> <em class="structfield"><code><a name="GSeekableIface.g-iface"></a>g_iface</code></em>;</span></p></td>
133
+ <td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GTypeInterface"><span class="type">GTypeInterface</span></a> <em class="structfield"><code><a name="GSeekableIface.g-iface"></a>g_iface</code></em>;</span></p></td>
134
134
  <td>The parent interface.
135
135
  </td>
136
136
  </tr>
@@ -163,9 +163,9 @@ Provides an interface for implementing seekable functionality on I/O Streams.
163
163
  </table></div>
164
164
  </div>
165
165
  <hr>
166
- <div class="refsect2" title="g_seekable_tell ()">
166
+ <div class="refsect2">
167
167
  <a name="g-seekable-tell"></a><h3>g_seekable_tell ()</h3>
168
- <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#goffset"><span class="returnvalue">goffset</span></a> g_seekable_tell (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>);</pre>
168
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#goffset"><span class="returnvalue">goffset</span></a> g_seekable_tell (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>);</pre>
169
169
  <p>
170
170
  Tells the current position within the stream.
171
171
  </p>
@@ -186,9 +186,9 @@ Tells the current position within the stream.
186
186
  </table></div>
187
187
  </div>
188
188
  <hr>
189
- <div class="refsect2" title="g_seekable_can_seek ()">
189
+ <div class="refsect2">
190
190
  <a name="g-seekable-can-seek"></a><h3>g_seekable_can_seek ()</h3>
191
- <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_seekable_can_seek (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>);</pre>
191
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_seekable_can_seek (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>);</pre>
192
192
  <p>
193
193
  Tests if the stream supports the <a class="link" href="GSeekable.html#GSeekableIface" title="GSeekableIface"><span class="type">GSeekableIface</span></a>.
194
194
  </p>
@@ -202,25 +202,25 @@ Tests if the stream supports the <a class="link" href="GSeekable.html#GSeekableI
202
202
  </tr>
203
203
  <tr>
204
204
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
205
- <td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>seekable</code></em> can be seeked. <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
205
+ <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>seekable</code></em> can be seeked. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
206
206
  </td>
207
207
  </tr>
208
208
  </tbody>
209
209
  </table></div>
210
210
  </div>
211
211
  <hr>
212
- <div class="refsect2" title="g_seekable_seek ()">
212
+ <div class="refsect2">
213
213
  <a name="g-seekable-seek"></a><h3>g_seekable_seek ()</h3>
214
- <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_seekable_seek (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>,
215
- <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a> offset</code></em>,
216
- <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-IO-Channels.html#GSeekType"><span class="type">GSeekType</span></a> type</code></em>,
214
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_seekable_seek (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>,
215
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a> offset</code></em>,
216
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-IO-Channels.html#GSeekType"><span class="type">GSeekType</span></a> type</code></em>,
217
217
  <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
218
- <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
218
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
219
219
  <p>
220
220
  Seeks in the stream by the given <em class="parameter"><code>offset</code></em>, modified by <em class="parameter"><code>type</code></em>.
221
221
  </p>
222
222
  <p>
223
- If <em class="parameter"><code>cancellable</code></em> is not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
223
+ If <em class="parameter"><code>cancellable</code></em> is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
224
224
  triggering the cancellable object from another thread. If the operation
225
225
  was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.
226
226
  </p>
@@ -234,29 +234,29 @@ was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANC
234
234
  </tr>
235
235
  <tr>
236
236
  <td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
237
- <td>a <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a>.
237
+ <td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a>.
238
238
  </td>
239
239
  </tr>
240
240
  <tr>
241
241
  <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
242
- <td>a <a href="/usr/share/gtk-doc/html/glib/glib-IO-Channels.html#GSeekType"><span class="type">GSeekType</span></a>.
242
+ <td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-IO-Channels.html#GSeekType"><span class="type">GSeekType</span></a>.
243
243
  </td>
244
244
  </tr>
245
245
  <tr>
246
246
  <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
247
- <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.
247
+ <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.
248
248
  </td>
249
249
  </tr>
250
250
  <tr>
251
251
  <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
252
- <td>a <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occuring, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
252
+ <td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occuring, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
253
253
  ignore.
254
254
  </td>
255
255
  </tr>
256
256
  <tr>
257
257
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
258
- <td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful. If an error
259
- has occurred, this function will return <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and set <em class="parameter"><code>error</code></em>
258
+ <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful. If an error
259
+ has occurred, this function will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and set <em class="parameter"><code>error</code></em>
260
260
  appropriately if present.
261
261
  </td>
262
262
  </tr>
@@ -264,9 +264,9 @@ ignore.
264
264
  </table></div>
265
265
  </div>
266
266
  <hr>
267
- <div class="refsect2" title="g_seekable_can_truncate ()">
267
+ <div class="refsect2">
268
268
  <a name="g-seekable-can-truncate"></a><h3>g_seekable_can_truncate ()</h3>
269
- <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_seekable_can_truncate (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>);</pre>
269
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_seekable_can_truncate (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>);</pre>
270
270
  <p>
271
271
  Tests if the stream can be truncated.
272
272
  </p>
@@ -280,24 +280,24 @@ Tests if the stream can be truncated.
280
280
  </tr>
281
281
  <tr>
282
282
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
283
- <td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the stream can be truncated, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
283
+ <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the stream can be truncated, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
284
284
  </td>
285
285
  </tr>
286
286
  </tbody>
287
287
  </table></div>
288
288
  </div>
289
289
  <hr>
290
- <div class="refsect2" title="g_seekable_truncate ()">
290
+ <div class="refsect2">
291
291
  <a name="g-seekable-truncate"></a><h3>g_seekable_truncate ()</h3>
292
- <pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_seekable_truncate (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>,
293
- <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a> offset</code></em>,
292
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_seekable_truncate (<em class="parameter"><code><a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a> *seekable</code></em>,
293
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a> offset</code></em>,
294
294
  <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
295
- <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
295
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
296
296
  <p>
297
297
  Truncates a stream with a given <span class="type">offset</span>.
298
298
  </p>
299
299
  <p>
300
- If <em class="parameter"><code>cancellable</code></em> is not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
300
+ If <em class="parameter"><code>cancellable</code></em> is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by
301
301
  triggering the cancellable object from another thread. If the operation
302
302
  was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned. If an
303
303
  operation was partially finished when the operation was cancelled the
@@ -313,24 +313,24 @@ partial result will be returned, without an error.
313
313
  </tr>
314
314
  <tr>
315
315
  <td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
316
- <td>a <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a>.
316
+ <td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a>.
317
317
  </td>
318
318
  </tr>
319
319
  <tr>
320
320
  <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
321
- <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.
321
+ <td>optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.
322
322
  </td>
323
323
  </tr>
324
324
  <tr>
325
325
  <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
326
- <td>a <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occuring, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
326
+ <td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occuring, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
327
327
  ignore.
328
328
  </td>
329
329
  </tr>
330
330
  <tr>
331
331
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
332
- <td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful. If an error
333
- has occurred, this function will return <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and set <em class="parameter"><code>error</code></em>
332
+ <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful. If an error
333
+ has occurred, this function will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and set <em class="parameter"><code>error</code></em>
334
334
  appropriately if present.
335
335
  </td>
336
336
  </tr>
@@ -338,13 +338,13 @@ ignore.
338
338
  </table></div>
339
339
  </div>
340
340
  </div>
341
- <div class="refsect1" title="See Also">
341
+ <div class="refsect1">
342
342
  <a name="GSeekable.see-also"></a><h2>See Also</h2>
343
343
  <a class="link" href="GInputStream.html" title="GInputStream"><span class="type">GInputStream</span></a>, <a class="link" href="GOutputStream.html" title="GOutputStream"><span class="type">GOutputStream</span></a>
344
344
  </div>
345
345
  </div>
346
346
  <div class="footer">
347
347
  <hr>
348
- Generated by GTK-Doc V1.14</div>
348
+ Generated by GTK-Doc V1.15.1</div>
349
349
  </body>
350
350
  </html>
@@ -0,0 +1,2424 @@
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>GSettings</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
+ <link rel="home" href="index.html" title="GIO Reference Manual">
8
+ <link rel="up" href="settings.html" title="Settings">
9
+ <link rel="prev" href="settings.html" title="Settings">
10
+ <link rel="next" href="GSettingsBackend.html" title="GSettingsBackend">
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="settings.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
+ <td><a accesskey="u" href="settings.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">GIO Reference Manual</th>
21
+ <td><a accesskey="n" href="GSettingsBackend.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="#GSettings.synopsis" class="shortcut">Top</a>
25
+  | 
26
+ <a href="#GSettings.description" class="shortcut">Description</a>
27
+  | 
28
+ <a href="#GSettings.object-hierarchy" class="shortcut">Object Hierarchy</a>
29
+  | 
30
+ <a href="#GSettings.properties" class="shortcut">Properties</a>
31
+  | 
32
+ <a href="#GSettings.signals" class="shortcut">Signals</a>
33
+ </td></tr>
34
+ </table>
35
+ <div class="refentry">
36
+ <a name="GSettings"></a><div class="titlepage"></div>
37
+ <div class="refnamediv"><table width="100%"><tr>
38
+ <td valign="top">
39
+ <h2><span class="refentrytitle"><a name="GSettings.top_of_page"></a>GSettings</span></h2>
40
+ <p>GSettings — a high-level API for application settings</p>
41
+ </td>
42
+ <td valign="top" align="right"></td>
43
+ </tr></table></div>
44
+ <div class="refsynopsisdiv">
45
+ <a name="GSettings.synopsis"></a><h2>Synopsis</h2>
46
+ <pre class="synopsis"> <a class="link" href="GSettings.html#GSettings-struct" title="GSettings">GSettings</a>;
47
+ <a class="link" href="GSettings.html" title="GSettings"><span class="returnvalue">GSettings</span></a> * <a class="link" href="GSettings.html#g-settings-new" title="g_settings_new ()">g_settings_new</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *schema</code></em>);
48
+ <a class="link" href="GSettings.html" title="GSettings"><span class="returnvalue">GSettings</span></a> * <a class="link" href="GSettings.html#g-settings-new-with-path" title="g_settings_new_with_path ()">g_settings_new_with_path</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *schema</code></em>,
49
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);
50
+ <a class="link" href="GSettings.html" title="GSettings"><span class="returnvalue">GSettings</span></a> * <a class="link" href="GSettings.html#g-settings-new-with-backend" title="g_settings_new_with_backend ()">g_settings_new_with_backend</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *schema</code></em>,
51
+ <em class="parameter"><code><a class="link" href="GSettingsBackend.html" title="GSettingsBackend"><span class="type">GSettingsBackend</span></a> *backend</code></em>);
52
+ <a class="link" href="GSettings.html" title="GSettings"><span class="returnvalue">GSettings</span></a> * <a class="link" href="GSettings.html#g-settings-new-with-backend-and-path" title="g_settings_new_with_backend_and_path ()">g_settings_new_with_backend_and_path</a>
53
+ (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *schema</code></em>,
54
+ <em class="parameter"><code><a class="link" href="GSettingsBackend.html" title="GSettingsBackend"><span class="type">GSettingsBackend</span></a> *backend</code></em>,
55
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);
56
+ <span class="returnvalue">void</span> <a class="link" href="GSettings.html#g-settings-sync" title="g_settings_sync ()">g_settings_sync</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
57
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="GSettings.html#g-settings-get-value" title="g_settings_get_value ()">g_settings_get_value</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
58
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
59
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSettings.html#g-settings-set-value" title="g_settings_set_value ()">g_settings_set_value</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
60
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
61
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *value</code></em>);
62
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSettings.html#g-settings-is-writable" title="g_settings_is_writable ()">g_settings_is_writable</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
63
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
64
+ <span class="returnvalue">void</span> <a class="link" href="GSettings.html#g-settings-delay" title="g_settings_delay ()">g_settings_delay</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>);
65
+ <span class="returnvalue">void</span> <a class="link" href="GSettings.html#g-settings-apply" title="g_settings_apply ()">g_settings_apply</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>);
66
+ <span class="returnvalue">void</span> <a class="link" href="GSettings.html#g-settings-revert" title="g_settings_revert ()">g_settings_revert</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>);
67
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSettings.html#g-settings-get-has-unapplied" title="g_settings_get_has_unapplied ()">g_settings_get_has_unapplied</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>);
68
+ <a class="link" href="GSettings.html" title="GSettings"><span class="returnvalue">GSettings</span></a> * <a class="link" href="GSettings.html#g-settings-get-child" title="g_settings_get_child ()">g_settings_get_child</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
69
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
70
+ <span class="returnvalue">void</span> <a class="link" href="GSettings.html#g-settings-reset" title="g_settings_reset ()">g_settings_reset</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
71
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
72
+
73
+ const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const * <a class="link" href="GSettings.html#g-settings-list-schemas" title="g_settings_list_schemas ()">g_settings_list_schemas</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
74
+
75
+ <span class="returnvalue">void</span> <a class="link" href="GSettings.html#g-settings-get" title="g_settings_get ()">g_settings_get</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
76
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
77
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *format</code></em>,
78
+ <em class="parameter"><code>...</code></em>);
79
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSettings.html#g-settings-set" title="g_settings_set ()">g_settings_set</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
80
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
81
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *format</code></em>,
82
+ <em class="parameter"><code>...</code></em>);
83
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSettings.html#g-settings-get-boolean" title="g_settings_get_boolean ()">g_settings_get_boolean</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
84
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
85
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSettings.html#g-settings-set-boolean" title="g_settings_set_boolean ()">g_settings_set_boolean</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
86
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
87
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> value</code></em>);
88
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="GSettings.html#g-settings-get-int" title="g_settings_get_int ()">g_settings_get_int</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
89
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
90
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSettings.html#g-settings-set-int" title="g_settings_set_int ()">g_settings_set_int</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
91
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
92
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> value</code></em>);
93
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a> <a class="link" href="GSettings.html#g-settings-get-double" title="g_settings_get_double ()">g_settings_get_double</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
94
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
95
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSettings.html#g-settings-set-double" title="g_settings_set_double ()">g_settings_set_double</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
96
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
97
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> value</code></em>);
98
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GSettings.html#g-settings-get-string" title="g_settings_get_string ()">g_settings_get_string</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
99
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
100
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSettings.html#g-settings-set-string" title="g_settings_set_string ()">g_settings_set_string</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
101
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
102
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);
103
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** <a class="link" href="GSettings.html#g-settings-get-strv" title="g_settings_get_strv ()">g_settings_get_strv</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
104
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
105
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSettings.html#g-settings-set-strv" title="g_settings_set_strv ()">g_settings_set_strv</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
106
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
107
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *const *value</code></em>);
108
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="GSettings.html#g-settings-get-enum" title="g_settings_get_enum ()">g_settings_get_enum</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
109
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
110
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSettings.html#g-settings-set-enum" title="g_settings_set_enum ()">g_settings_set_enum</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
111
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
112
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> value</code></em>);
113
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="GSettings.html#g-settings-get-flags" title="g_settings_get_flags ()">g_settings_get_flags</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
114
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
115
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GSettings.html#g-settings-set-flags" title="g_settings_set_flags ()">g_settings_set_flags</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
116
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
117
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> value</code></em>);
118
+
119
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="GSettings.html#GSettingsGetMapping" title="GSettingsGetMapping ()">*GSettingsGetMapping</a>) (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *value</code></em>,
120
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> *result</code></em>,
121
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
122
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> <a class="link" href="GSettings.html#g-settings-get-mapped" title="g_settings_get_mapped ()">g_settings_get_mapped</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
123
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
124
+ <em class="parameter"><code><a class="link" href="GSettings.html#GSettingsGetMapping" title="GSettingsGetMapping ()"><span class="type">GSettingsGetMapping</span></a> mapping</code></em>,
125
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
126
+
127
+ enum <a class="link" href="GSettings.html#GSettingsBindFlags" title="enum GSettingsBindFlags">GSettingsBindFlags</a>;
128
+ <span class="returnvalue">void</span> <a class="link" href="GSettings.html#g-settings-bind" title="g_settings_bind ()">g_settings_bind</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
129
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
130
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> object</code></em>,
131
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property</code></em>,
132
+ <em class="parameter"><code><a class="link" href="GSettings.html#GSettingsBindFlags" title="enum GSettingsBindFlags"><span class="type">GSettingsBindFlags</span></a> flags</code></em>);
133
+ <span class="returnvalue">void</span> <a class="link" href="GSettings.html#g-settings-bind-with-mapping" title="g_settings_bind_with_mapping ()">g_settings_bind_with_mapping</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
134
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
135
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> object</code></em>,
136
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property</code></em>,
137
+ <em class="parameter"><code><a class="link" href="GSettings.html#GSettingsBindFlags" title="enum GSettingsBindFlags"><span class="type">GSettingsBindFlags</span></a> flags</code></em>,
138
+ <em class="parameter"><code><a class="link" href="GSettings.html#GSettingsBindGetMapping" title="GSettingsBindGetMapping ()"><span class="type">GSettingsBindGetMapping</span></a> get_mapping</code></em>,
139
+ <em class="parameter"><code><a class="link" href="GSettings.html#GSettingsBindSetMapping" title="GSettingsBindSetMapping ()"><span class="type">GSettingsBindSetMapping</span></a> set_mapping</code></em>,
140
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
141
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);
142
+ <span class="returnvalue">void</span> <a class="link" href="GSettings.html#g-settings-bind-writable" title="g_settings_bind_writable ()">g_settings_bind_writable</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
143
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
144
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> object</code></em>,
145
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property</code></em>,
146
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> inverted</code></em>);
147
+ <span class="returnvalue">void</span> <a class="link" href="GSettings.html#g-settings-unbind" title="g_settings_unbind ()">g_settings_unbind</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> object</code></em>,
148
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property</code></em>);
149
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * (<a class="link" href="GSettings.html#GSettingsBindSetMapping" title="GSettingsBindSetMapping ()">*GSettingsBindSetMapping</a>) (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
150
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a> *expected_type</code></em>,
151
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
152
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="GSettings.html#GSettingsBindGetMapping" title="GSettingsBindGetMapping ()">*GSettingsBindGetMapping</a>) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
153
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *variant</code></em>,
154
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
155
+ </pre>
156
+ </div>
157
+ <div class="refsect1">
158
+ <a name="GSettings.object-hierarchy"></a><h2>Object Hierarchy</h2>
159
+ <pre class="synopsis">
160
+ <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
161
+ +----GSettings
162
+ </pre>
163
+ </div>
164
+ <div class="refsect1">
165
+ <a name="GSettings.properties"></a><h2>Properties</h2>
166
+ <pre class="synopsis">
167
+ "<a class="link" href="GSettings.html#GSettings--backend" title='The "backend" property'>backend</a>" <a class="link" href="GSettingsBackend.html" title="GSettingsBackend"><span class="type">GSettingsBackend</span></a>* : Read / Write / Construct Only
168
+ "<a class="link" href="GSettings.html#GSettings--has-unapplied" title='The "has-unapplied" property'>has-unapplied</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read
169
+ "<a class="link" href="GSettings.html#GSettings--path" title='The "path" property'>path</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write / Construct Only
170
+ "<a class="link" href="GSettings.html#GSettings--schema" title='The "schema" property'>schema</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write / Construct Only
171
+ </pre>
172
+ </div>
173
+ <div class="refsect1">
174
+ <a name="GSettings.signals"></a><h2>Signals</h2>
175
+ <pre class="synopsis">
176
+ "<a class="link" href="GSettings.html#GSettings-change-event" title='The "change-event" signal'>change-event</a>" : Run Last
177
+ "<a class="link" href="GSettings.html#GSettings-changed" title='The "changed" signal'>changed</a>" : Run Last / Has Details
178
+ "<a class="link" href="GSettings.html#GSettings-writable-change-event" title='The "writable-change-event" signal'>writable-change-event</a>" : Run Last
179
+ "<a class="link" href="GSettings.html#GSettings-writable-changed" title='The "writable-changed" signal'>writable-changed</a>" : Run Last / Has Details
180
+ </pre>
181
+ </div>
182
+ <div class="refsect1">
183
+ <a name="GSettings.description"></a><h2>Description</h2>
184
+ <p>
185
+ The <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> class provides a convenient API for storing and retrieving
186
+ application settings.
187
+ </p>
188
+ <p>
189
+ When creating a GSettings instance, you have to specify a schema
190
+ that describes the keys in your settings and their types and default
191
+ values, as well as some other information.
192
+ </p>
193
+ <p>
194
+ Normally, a schema has as fixed path that determines where the settings
195
+ are stored in the conceptual global tree of settings. However, schemas
196
+ can also be 'relocatable', i.e. not equipped with a fixed path. This is
197
+ useful e.g. when the schema describes an 'account', and you want to be
198
+ able to store a arbitrary number of accounts.
199
+ </p>
200
+ <p>
201
+ Unlike other configuration systems (like GConf), GSettings does not
202
+ restrict keys to basic types like strings and numbers. GSettings stores
203
+ values as <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>, and allows any <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a> for keys. Key names
204
+ are restricted to lowercase characters, numbers and '-'. Furthermore,
205
+ the names must begin with a lowercase character, must not end
206
+ with a '-', and must not contain consecutive dashes. Key names can
207
+ be up to 32 characters long.
208
+ </p>
209
+ <p>
210
+ Similar to GConf, the default values in GSettings schemas can be
211
+ localized, but the localized values are stored in gettext catalogs
212
+ and looked up with the domain that is specified in the
213
+ <code class="sgmltag-attribute">gettext-domain</code> attribute of the
214
+ <code class="sgmltag-starttag">&lt;schemalist&gt;</code> or <code class="sgmltag-starttag">&lt;schema&gt;</code>
215
+ elements and the category that is specified in the l10n attribute of the
216
+ <code class="sgmltag-starttag">&lt;key&gt;</code> element.
217
+ </p>
218
+ <p>
219
+ GSettings uses schemas in a compact binary form that is created
220
+ by the <a href="glib-compile-schemas.html">glib-compile-schemas</a>
221
+ utility. The input is a schema description in an XML format that can be
222
+ described by the following DTD:
223
+ </p>
224
+ <div class="informalexample">
225
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
226
+ <tbody>
227
+ <tr>
228
+ <td class="listing_lines" align="right"><pre>1
229
+ 2
230
+ 3
231
+ 4
232
+ 5
233
+ 6
234
+ 7
235
+ 8
236
+ 9
237
+ 10
238
+ 11
239
+ 12
240
+ 13
241
+ 14
242
+ 15
243
+ 16
244
+ 17
245
+ 18
246
+ 19
247
+ 20
248
+ 21
249
+ 22
250
+ 23
251
+ 24
252
+ 25
253
+ 26
254
+ 27
255
+ 28
256
+ 29
257
+ 30
258
+ 31
259
+ 32
260
+ 33
261
+ 34
262
+ 35
263
+ 36
264
+ 37
265
+ 38
266
+ 39
267
+ 40
268
+ 41
269
+ 42
270
+ 43
271
+ 44
272
+ 45
273
+ 46
274
+ 47
275
+ 48
276
+ 49
277
+ 50
278
+ 51
279
+ 52
280
+ 53
281
+ 54
282
+ 55
283
+ 56
284
+ 57
285
+ 58
286
+ 59
287
+ 60</pre></td>
288
+ <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;!</span><span class="usertype">ELEMENT</span><span class="normal"> </span><span class="function">schemalist</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">schema</span><span class="symbol">|</span><span class="keyword">enum</span><span class="symbol">)*</span><span class="normal"> </span><span class="symbol">&gt;</span>
289
+ <span class="symbol">&lt;!</span><span class="normal">ATTLIST </span><span class="usertype">schemalist</span><span class="normal"> gettext</span><span class="symbol">-</span><span class="normal">domain #IMPLIED </span><span class="symbol">&gt;</span>
290
+
291
+ <span class="symbol">&lt;!</span><span class="usertype">ELEMENT</span><span class="normal"> </span><span class="function">schema</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">key</span><span class="symbol">|</span><span class="normal">child</span><span class="symbol">)*</span><span class="normal"> </span><span class="symbol">&gt;</span>
292
+ <span class="symbol">&lt;!</span><span class="normal">ATTLIST schema </span><span class="usertype">id</span><span class="normal"> CDATA #REQUIRED</span>
293
+ <span class="normal"> </span><span class="usertype">path</span><span class="normal"> CDATA #IMPLIED</span>
294
+ <span class="normal"> gettext</span><span class="symbol">-</span><span class="usertype">domain</span><span class="normal"> CDATA #IMPLIED </span><span class="symbol">&gt;</span>
295
+
296
+ <span class="symbol">&lt;!--</span><span class="normal"> defines an </span><span class="usertype">enumerated</span><span class="normal"> type </span><span class="symbol">--&gt;</span>
297
+ <span class="symbol">&lt;!--</span><span class="normal"> each value element maps a nick to a </span><span class="usertype">numeric</span><span class="normal"> value </span><span class="symbol">--&gt;</span>
298
+ <span class="symbol">&lt;!</span><span class="usertype">ELEMENT</span><span class="normal"> </span><span class="keyword">enum</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">value</span><span class="symbol">*)</span><span class="normal"> </span><span class="symbol">&gt;</span>
299
+ <span class="symbol">&lt;!</span><span class="normal">ATTLIST </span><span class="keyword">enum</span><span class="normal"> </span><span class="usertype">id</span><span class="normal"> CDATA #REQUIRED </span><span class="symbol">&gt;</span>
300
+ <span class="symbol">&lt;!</span><span class="normal">ELEMENT </span><span class="usertype">value</span><span class="normal"> EMPTY </span><span class="symbol">&gt;</span>
301
+ <span class="symbol">&lt;!--</span><span class="normal"> nick must be at least </span><span class="number">2</span><span class="normal"> </span><span class="usertype">characters</span><span class="normal"> </span><span class="type">long</span><span class="normal"> </span><span class="symbol">--&gt;</span>
302
+ <span class="symbol">&lt;!--</span><span class="normal"> value must be parsable as a </span><span class="number">32</span><span class="symbol">-</span><span class="usertype">bit</span><span class="normal"> integer </span><span class="symbol">--&gt;</span>
303
+ <span class="symbol">&lt;!</span><span class="normal">ELEMENT </span><span class="usertype">value</span><span class="normal"> nick #REQUIRED</span>
304
+ <span class="normal"> value #REQUIRED </span><span class="symbol">&gt;</span>
305
+
306
+ <span class="symbol">&lt;!</span><span class="usertype">ELEMENT</span><span class="normal"> </span><span class="function">key</span><span class="normal"> </span><span class="symbol">(</span><span class="keyword">default</span><span class="symbol">|</span><span class="normal">summary</span><span class="symbol">?|</span><span class="normal">description</span><span class="symbol">?|</span><span class="normal">range</span><span class="symbol">?|</span><span class="normal">choices</span><span class="symbol">?|</span><span class="normal">aliases</span><span class="symbol">?)</span><span class="normal"> </span><span class="symbol">&gt;</span>
307
+ <span class="symbol">&lt;!--</span><span class="normal"> name can only contain </span><span class="usertype">lowercase</span><span class="normal"> letters</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">numbers</span><span class="normal"> and </span><span class="string">'-'</span><span class="normal"> </span><span class="symbol">--&gt;</span>
308
+ <span class="symbol">&lt;!--</span><span class="normal"> type must be a GVariant </span><span class="usertype">type</span><span class="normal"> string </span><span class="symbol">--&gt;</span>
309
+ <span class="symbol">&lt;!--</span><span class="normal"> </span><span class="keyword">enum</span><span class="normal"> must be the id of an </span><span class="keyword">enum</span><span class="normal"> that has been </span><span class="usertype">defined</span><span class="normal"> earlier </span><span class="symbol">--&gt;</span>
310
+ <span class="symbol">&lt;!--</span><span class="normal"> exactly one of </span><span class="keyword">enum</span><span class="normal"> or type must </span><span class="usertype">be</span><span class="normal"> given </span><span class="symbol">--&gt;</span>
311
+ <span class="symbol">&lt;!</span><span class="normal">ATTLIST key </span><span class="usertype">name</span><span class="normal"> CDATA #REQUIRED</span>
312
+ <span class="normal"> </span><span class="usertype">type</span><span class="normal"> CDATA #IMPLIED</span>
313
+ <span class="normal"> </span><span class="keyword">enum</span><span class="normal"> CDATA #IMPLIED </span><span class="symbol">&gt;</span>
314
+
315
+ <span class="symbol">&lt;!--</span><span class="normal"> the </span><span class="keyword">default</span><span class="normal"> value is specified a a </span><span class="usertype">serialized</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a></span><span class="symbol">,</span>
316
+ <span class="normal"> i</span><span class="symbol">.</span><span class="normal">e</span><span class="symbol">.</span><span class="normal"> you have to include the quotes when specifying </span><span class="usertype">a</span><span class="normal"> string </span><span class="symbol">--&gt;</span>
317
+ <span class="symbol">&lt;!</span><span class="usertype">ELEMENT</span><span class="normal"> </span><span class="keyword">default</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">#PCDATA</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">&gt;</span>
318
+ <span class="symbol">&lt;!--</span><span class="normal"> the presence of the l10n attribute marks a </span><span class="keyword">default</span><span class="normal"> value </span><span class="keyword">for</span>
319
+ <span class="normal"> translation</span><span class="symbol">,</span><span class="normal"> its value is the gettext category </span><span class="usertype">to</span><span class="normal"> use </span><span class="symbol">--&gt;</span>
320
+ <span class="symbol">&lt;!--</span><span class="normal"> </span><span class="keyword">if</span><span class="normal"> context </span><span class="usertype">is</span><span class="normal"> present</span><span class="symbol">,</span><span class="normal"> it specifies msgctxt </span><span class="usertype">to</span><span class="normal"> use </span><span class="symbol">--&gt;</span>
321
+ <span class="symbol">&lt;!</span><span class="normal">ATTLIST </span><span class="usertype">default</span><span class="normal"> </span><span class="function">l10n</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">messages</span><span class="symbol">|</span><span class="normal">time</span><span class="symbol">)</span><span class="normal"> #IMPLIED</span>
322
+ <span class="normal"> </span><span class="usertype">context</span><span class="normal"> CDATA #IMPLIED </span><span class="symbol">&gt;</span>
323
+
324
+ <span class="symbol">&lt;!</span><span class="usertype">ELEMENT</span><span class="normal"> </span><span class="function">summary</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">#PCDATA</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">&gt;</span>
325
+ <span class="symbol">&lt;!</span><span class="usertype">ELEMENT</span><span class="normal"> </span><span class="function">description</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">#PCDATA</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">&gt;</span>
326
+
327
+ <span class="symbol">&lt;!--</span><span class="normal"> range is only allowed </span><span class="keyword">for</span><span class="normal"> keys with </span><span class="usertype">numeric</span><span class="normal"> type </span><span class="symbol">--&gt;</span>
328
+ <span class="symbol">&lt;!</span><span class="normal">ELEMENT </span><span class="usertype">range</span><span class="normal"> EMPTY </span><span class="symbol">&gt;</span>
329
+ <span class="symbol">&lt;!--</span><span class="normal"> min and max must be parseable as values of the key type </span><span class="usertype">and</span><span class="normal"> min </span><span class="symbol">&lt;</span><span class="normal"> max </span><span class="symbol">--&gt;</span>
330
+ <span class="symbol">&lt;!</span><span class="normal">ATTLIST range </span><span class="usertype">min</span><span class="normal"> CDATA #REQUIRED</span>
331
+ <span class="normal"> </span><span class="usertype">max</span><span class="normal"> CDATA #REQUIRED </span><span class="symbol">&gt;</span>
332
+
333
+ <span class="symbol">&lt;!--</span><span class="normal"> choices is only allowed </span><span class="keyword">for</span><span class="normal"> keys with string or string </span><span class="usertype">array</span><span class="normal"> type </span><span class="symbol">--&gt;</span>
334
+ <span class="symbol">&lt;!</span><span class="usertype">ELEMENT</span><span class="normal"> </span><span class="function">choices</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">choice</span><span class="symbol">+)</span><span class="normal"> </span><span class="symbol">&gt;</span>
335
+ <span class="symbol">&lt;!--</span><span class="normal"> each choice element specifies one </span><span class="usertype">possible</span><span class="normal"> value </span><span class="symbol">--&gt;</span>
336
+ <span class="symbol">&lt;!</span><span class="normal">ELEMENT </span><span class="usertype">choice</span><span class="normal"> EMPTY </span><span class="symbol">&gt;</span>
337
+ <span class="symbol">&lt;!</span><span class="normal">ATTLIST choice </span><span class="usertype">value</span><span class="normal"> CDATA #REQUIRED </span><span class="symbol">&gt;</span>
338
+
339
+ <span class="symbol">&lt;!--</span><span class="normal"> aliases is only allowed </span><span class="keyword">for</span><span class="normal"> keys with enumerated type or </span><span class="usertype">with</span><span class="normal"> choices </span><span class="symbol">--&gt;</span>
340
+ <span class="symbol">&lt;!</span><span class="usertype">ELEMENT</span><span class="normal"> </span><span class="function">aliases</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">alias</span><span class="symbol">+)</span><span class="normal"> </span><span class="symbol">&gt;</span>
341
+ <span class="symbol">&lt;!--</span><span class="normal"> each alias element specifies an alias </span><span class="keyword">for</span><span class="normal"> one of the </span><span class="usertype">possible</span><span class="normal"> values </span><span class="symbol">--&gt;</span>
342
+ <span class="symbol">&lt;!</span><span class="normal">ELEMENT </span><span class="usertype">alias</span><span class="normal"> EMPTY </span><span class="symbol">&gt;</span>
343
+ <span class="symbol">&lt;!</span><span class="normal">ATTLIST alias </span><span class="usertype">value</span><span class="normal"> CDATA #REQUIRED </span><span class="symbol">&gt;</span>
344
+
345
+ <span class="symbol">&lt;!</span><span class="normal">ELEMENT </span><span class="usertype">child</span><span class="normal"> EMPTY </span><span class="symbol">&gt;</span>
346
+ <span class="symbol">&lt;!</span><span class="normal">ATTLIST child </span><span class="usertype">name</span><span class="normal"> CDATA #REQUIRED</span>
347
+ <span class="normal"> </span><span class="usertype">schema</span><span class="normal"> CDATA #REQUIRED </span><span class="symbol">&gt;</span></pre></td>
348
+ </tr>
349
+ </tbody>
350
+ </table>
351
+ </div>
352
+
353
+ <p>
354
+ </p>
355
+ <p>
356
+ At runtime, schemas are identified by their id (as specified
357
+ in the <code class="sgmltag-attribute">id</code> attribute of the
358
+ <code class="sgmltag-starttag">&lt;schema&gt;</code> element). The
359
+ convention for schema ids is to use a dotted name, similar in
360
+ style to a DBus bus name, e.g. "org.gnome.font-rendering".
361
+ </p>
362
+ <p>
363
+ </p>
364
+ <div class="example">
365
+ <a name="id676742"></a><p class="title"><b>Example 11. Default values</b></p>
366
+ <div class="example-contents">
367
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
368
+ <tbody>
369
+ <tr>
370
+ <td class="listing_lines" align="right"><pre>1
371
+ 2
372
+ 3
373
+ 4
374
+ 5
375
+ 6
376
+ 7
377
+ 8
378
+ 9
379
+ 10
380
+ 11
381
+ 12
382
+ 13
383
+ 14
384
+ 15
385
+ 16
386
+ 17</pre></td>
387
+ <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;</span><span class="normal">schemalist</span><span class="symbol">&gt;</span>
388
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">schema</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"org.gtk.test"</span><span class="normal"> path</span><span class="symbol">=</span><span class="string">"/tests/"</span><span class="normal"> gettext</span><span class="symbol">-</span><span class="normal">domain</span><span class="symbol">=</span><span class="string">"test"</span><span class="symbol">&gt;</span>
389
+
390
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">key</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"greeting"</span><span class="normal"> type</span><span class="symbol">=</span><span class="string">"s"</span><span class="symbol">&gt;</span>
391
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="keyword">default</span><span class="normal"> l10n</span><span class="symbol">=</span><span class="string">"messages"</span><span class="symbol">&gt;</span><span class="string">"Hello, earthlings"</span><span class="symbol">&lt;/</span><span class="keyword">default</span><span class="symbol">&gt;</span>
392
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">summary</span><span class="symbol">&gt;</span><span class="usertype">A</span><span class="normal"> greeting</span><span class="symbol">&lt;/</span><span class="normal">summary</span><span class="symbol">&gt;</span>
393
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">description</span><span class="symbol">&gt;</span>
394
+ <span class="normal"> Greeting of the invading martians</span>
395
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">description</span><span class="symbol">&gt;</span>
396
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">key</span><span class="symbol">&gt;</span>
397
+
398
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">key</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"box"</span><span class="normal"> type</span><span class="symbol">=</span><span class="string">"(ii)"</span><span class="symbol">&gt;</span>
399
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="keyword">default</span><span class="symbol">&gt;(</span><span class="number">20</span><span class="symbol">,</span><span class="number">30</span><span class="symbol">)&lt;/</span><span class="keyword">default</span><span class="symbol">&gt;</span>
400
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">key</span><span class="symbol">&gt;</span>
401
+
402
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">schema</span><span class="symbol">&gt;</span>
403
+ <span class="symbol">&lt;/</span><span class="normal">schemalist</span><span class="symbol">&gt;</span></pre></td>
404
+ </tr>
405
+ </tbody>
406
+ </table>
407
+ </div>
408
+
409
+ </div>
410
+ <p><br class="example-break">
411
+ </p>
412
+ <p>
413
+ </p>
414
+ <div class="example">
415
+ <a name="id676761"></a><p class="title"><b>Example 12. Ranges, choices and enumerated types</b></p>
416
+ <div class="example-contents">
417
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
418
+ <tbody>
419
+ <tr>
420
+ <td class="listing_lines" align="right"><pre>1
421
+ 2
422
+ 3
423
+ 4
424
+ 5
425
+ 6
426
+ 7
427
+ 8
428
+ 9
429
+ 10
430
+ 11
431
+ 12
432
+ 13
433
+ 14
434
+ 15
435
+ 16
436
+ 17
437
+ 18
438
+ 19
439
+ 20
440
+ 21
441
+ 22
442
+ 23
443
+ 24
444
+ 25
445
+ 26
446
+ 27
447
+ 28
448
+ 29
449
+ 30
450
+ 31
451
+ 32
452
+ 33</pre></td>
453
+ <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;</span><span class="normal">schemalist</span><span class="symbol">&gt;</span>
454
+
455
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="keyword">enum</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"myenum"</span><span class="symbol">&gt;</span>
456
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">value</span><span class="normal"> nick</span><span class="symbol">=</span><span class="string">"first"</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">"1"</span><span class="symbol">/&gt;</span>
457
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">value</span><span class="normal"> nick</span><span class="symbol">=</span><span class="string">"second"</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">"2"</span><span class="symbol">/&gt;</span>
458
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="keyword">enum</span><span class="symbol">&gt;</span>
459
+
460
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">schema</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"org.gtk.test"</span><span class="symbol">&gt;</span>
461
+
462
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">key</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"key-with-range"</span><span class="normal"> type</span><span class="symbol">=</span><span class="string">"i"</span><span class="symbol">&gt;</span>
463
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">range</span><span class="normal"> min</span><span class="symbol">=</span><span class="string">"1"</span><span class="normal"> max</span><span class="symbol">=</span><span class="string">"100"</span><span class="symbol">/&gt;</span>
464
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="keyword">default</span><span class="symbol">&gt;</span><span class="number">10</span><span class="symbol">&lt;/</span><span class="keyword">default</span><span class="symbol">&gt;</span>
465
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">key</span><span class="symbol">&gt;</span>
466
+
467
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">key</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"key-with-choices"</span><span class="normal"> type</span><span class="symbol">=</span><span class="string">"s"</span><span class="symbol">&gt;</span>
468
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">choices</span><span class="symbol">&gt;</span>
469
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">choice</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">'Elisabeth'</span><span class="symbol">/&gt;</span>
470
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">choice</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">'Annabeth'</span><span class="symbol">/&gt;</span>
471
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">choice</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">'Joe'</span><span class="symbol">/&gt;</span>
472
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">choices</span><span class="symbol">&gt;</span>
473
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">aliases</span><span class="symbol">&gt;</span>
474
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">alias</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">'Anna'</span><span class="normal"> target</span><span class="symbol">=</span><span class="string">'Annabeth'</span><span class="symbol">/&gt;</span>
475
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">alias</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">'Beth'</span><span class="normal"> target</span><span class="symbol">=</span><span class="string">'Elisabeth'</span><span class="symbol">/&gt;</span>
476
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">aliases</span><span class="symbol">&gt;</span>
477
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="keyword">default</span><span class="symbol">&gt;</span><span class="string">'Joe'</span><span class="symbol">&lt;/</span><span class="keyword">default</span><span class="symbol">&gt;</span>
478
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">key</span><span class="symbol">&gt;</span>
479
+
480
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">key</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">'enumerated-key'</span><span class="normal"> </span><span class="keyword">enum</span><span class="symbol">=</span><span class="string">'myenum'</span><span class="symbol">&gt;</span>
481
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="keyword">default</span><span class="symbol">&gt;</span><span class="string">'first'</span><span class="symbol">&lt;/</span><span class="keyword">default</span><span class="symbol">&gt;</span>
482
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">key</span><span class="symbol">&gt;</span>
483
+
484
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">schema</span><span class="symbol">&gt;</span>
485
+ <span class="symbol">&lt;/</span><span class="normal">schemalist</span><span class="symbol">&gt;</span></pre></td>
486
+ </tr>
487
+ </tbody>
488
+ </table>
489
+ </div>
490
+
491
+ </div>
492
+ <p><br class="example-break">
493
+ </p>
494
+ <p>
495
+ </p>
496
+ <div class="refsect2">
497
+ <a name="id676782"></a><h3>Vendor overrides</h3>
498
+ <p>
499
+ Default values are defined in the schemas that get installed by
500
+ an application. Sometimes, it is necessary for a vendor or distributor
501
+ to adjust these defaults. Since patching the XML source for the schema
502
+ is inconvenient and error-prone,
503
+ <a href="glib-compile-schemas.html">glib-compile-schemas</a> reads
504
+ so-called 'vendor override' files. These are keyfiles in the same
505
+ directory as the XML schema sources which can override default values.
506
+ The schema id serves as the group name in the key file, and the values
507
+ are expected in serialized GVariant form, as in the following example:
508
+ </p>
509
+ <div class="informalexample">
510
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
511
+ <tbody>
512
+ <tr>
513
+ <td class="listing_lines" align="right"><pre>1
514
+ 2
515
+ 3</pre></td>
516
+ <td class="listing_code"><pre class="programlisting"><span class="symbol">[</span><span class="normal">org</span><span class="symbol">.</span><span class="normal">gtk</span><span class="symbol">.</span><span class="normal">Example</span><span class="symbol">]</span>
517
+ <span class="normal">key1</span><span class="symbol">=</span><span class="string">'string'</span>
518
+ <span class="normal">key2</span><span class="symbol">=</span><span class="number">1.5</span></pre></td>
519
+ </tr>
520
+ </tbody>
521
+ </table>
522
+ </div>
523
+
524
+ <p>
525
+ </p>
526
+ </div>
527
+ <p>
528
+ </p>
529
+ <p>
530
+ </p>
531
+ <div class="refsect2">
532
+ <a name="id676815"></a><h3>Binding</h3>
533
+ <p>
534
+ A very convenient feature of GSettings lets you bind <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> properties
535
+ directly to settings, using <a class="link" href="GSettings.html#g-settings-bind" title="g_settings_bind ()"><code class="function">g_settings_bind()</code></a>. Once a GObject property
536
+ has been bound to a setting, changes on either side are automatically
537
+ propagated to the other side. GSettings handles details like
538
+ mapping between GObject and GVariant types, and preventing infinite
539
+ cycles.
540
+ </p>
541
+ <p>
542
+ This makes it very easy to hook up a preferences dialog to the
543
+ underlying settings. To make this even more convenient, GSettings
544
+ looks for a boolean property with the name "sensitivity" and
545
+ automatically binds it to the writability of the bound setting.
546
+ If this 'magic' gets in the way, it can be suppressed with the
547
+ <a class="link" href="GSettings.html#G-SETTINGS-BIND-NO-SENSITIVITY:CAPS"><span class="type">G_SETTINGS_BIND_NO_SENSITIVITY</span></a> flag.
548
+ </p>
549
+ </div>
550
+ <p>
551
+ </p>
552
+ </div>
553
+ <div class="refsect1">
554
+ <a name="GSettings.details"></a><h2>Details</h2>
555
+ <div class="refsect2">
556
+ <a name="GSettings-struct"></a><h3>GSettings</h3>
557
+ <pre class="programlisting">typedef struct _GSettings GSettings;</pre>
558
+ <p>
559
+ </p>
560
+ </div>
561
+ <hr>
562
+ <div class="refsect2">
563
+ <a name="g-settings-new"></a><h3>g_settings_new ()</h3>
564
+ <pre class="programlisting"><a class="link" href="GSettings.html" title="GSettings"><span class="returnvalue">GSettings</span></a> * g_settings_new (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *schema</code></em>);</pre>
565
+ <p>
566
+ Creates a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object with a given schema.
567
+ </p>
568
+ <p>
569
+ Signals on the newly created <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object will be dispatched
570
+ via the thread-default <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> in effect at the time of the
571
+ call to <a class="link" href="GSettings.html#g-settings-new" title="g_settings_new ()"><code class="function">g_settings_new()</code></a>. The new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> will hold a reference
572
+ on the context. See <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default"><code class="function">g_main_context_push_thread_default()</code></a>.
573
+ </p>
574
+ <div class="variablelist"><table border="0">
575
+ <col align="left" valign="top">
576
+ <tbody>
577
+ <tr>
578
+ <td><p><span class="term"><em class="parameter"><code>schema</code></em> :</span></p></td>
579
+ <td>the name of the schema
580
+ </td>
581
+ </tr>
582
+ <tr>
583
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
584
+ <td>a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
585
+ </td>
586
+ </tr>
587
+ </tbody>
588
+ </table></div>
589
+ <p class="since">Since 2.26</p>
590
+ </div>
591
+ <hr>
592
+ <div class="refsect2">
593
+ <a name="g-settings-new-with-path"></a><h3>g_settings_new_with_path ()</h3>
594
+ <pre class="programlisting"><a class="link" href="GSettings.html" title="GSettings"><span class="returnvalue">GSettings</span></a> * g_settings_new_with_path (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *schema</code></em>,
595
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);</pre>
596
+ <p>
597
+ Creates a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object with a given schema and path.
598
+ </p>
599
+ <p>
600
+ You only need to do this if you want to directly create a settings
601
+ object with a schema that doesn't have a specified path of its own.
602
+ That's quite rare.
603
+ </p>
604
+ <p>
605
+ It is a programmer error to call this function for a schema that
606
+ has an explicitly specified path.
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"><em class="parameter"><code>schema</code></em> :</span></p></td>
613
+ <td>the name of the schema
614
+ </td>
615
+ </tr>
616
+ <tr>
617
+ <td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
618
+ <td>the path to use
619
+ </td>
620
+ </tr>
621
+ <tr>
622
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
623
+ <td>a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
624
+ </td>
625
+ </tr>
626
+ </tbody>
627
+ </table></div>
628
+ <p class="since">Since 2.26</p>
629
+ </div>
630
+ <hr>
631
+ <div class="refsect2">
632
+ <a name="g-settings-new-with-backend"></a><h3>g_settings_new_with_backend ()</h3>
633
+ <pre class="programlisting"><a class="link" href="GSettings.html" title="GSettings"><span class="returnvalue">GSettings</span></a> * g_settings_new_with_backend (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *schema</code></em>,
634
+ <em class="parameter"><code><a class="link" href="GSettingsBackend.html" title="GSettingsBackend"><span class="type">GSettingsBackend</span></a> *backend</code></em>);</pre>
635
+ <p>
636
+ Creates a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object with a given schema and backend.
637
+ </p>
638
+ <p>
639
+ Creating settings objects with an different backend allows accessing settings
640
+ from a database other than the usual one. For example, it may make
641
+ sense to pass a backend corresponding to the "defaults" settings database on
642
+ the system to get a settings object that modifies the system default
643
+ settings instead of the settings for this user.
644
+ </p>
645
+ <div class="variablelist"><table border="0">
646
+ <col align="left" valign="top">
647
+ <tbody>
648
+ <tr>
649
+ <td><p><span class="term"><em class="parameter"><code>schema</code></em> :</span></p></td>
650
+ <td>the name of the schema
651
+ </td>
652
+ </tr>
653
+ <tr>
654
+ <td><p><span class="term"><em class="parameter"><code>backend</code></em> :</span></p></td>
655
+ <td>the <a class="link" href="GSettingsBackend.html" title="GSettingsBackend"><span class="type">GSettingsBackend</span></a> to use
656
+ </td>
657
+ </tr>
658
+ <tr>
659
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
660
+ <td>a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
661
+ </td>
662
+ </tr>
663
+ </tbody>
664
+ </table></div>
665
+ <p class="since">Since 2.26</p>
666
+ </div>
667
+ <hr>
668
+ <div class="refsect2">
669
+ <a name="g-settings-new-with-backend-and-path"></a><h3>g_settings_new_with_backend_and_path ()</h3>
670
+ <pre class="programlisting"><a class="link" href="GSettings.html" title="GSettings"><span class="returnvalue">GSettings</span></a> * g_settings_new_with_backend_and_path
671
+ (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *schema</code></em>,
672
+ <em class="parameter"><code><a class="link" href="GSettingsBackend.html" title="GSettingsBackend"><span class="type">GSettingsBackend</span></a> *backend</code></em>,
673
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);</pre>
674
+ <p>
675
+ Creates a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object with a given schema, backend and
676
+ path.
677
+ </p>
678
+ <p>
679
+ This is a mix of <a class="link" href="GSettings.html#g-settings-new-with-backend" title="g_settings_new_with_backend ()"><code class="function">g_settings_new_with_backend()</code></a> and
680
+ <a class="link" href="GSettings.html#g-settings-new-with-path" title="g_settings_new_with_path ()"><code class="function">g_settings_new_with_path()</code></a>.
681
+ </p>
682
+ <div class="variablelist"><table border="0">
683
+ <col align="left" valign="top">
684
+ <tbody>
685
+ <tr>
686
+ <td><p><span class="term"><em class="parameter"><code>schema</code></em> :</span></p></td>
687
+ <td>the name of the schema
688
+ </td>
689
+ </tr>
690
+ <tr>
691
+ <td><p><span class="term"><em class="parameter"><code>backend</code></em> :</span></p></td>
692
+ <td>the <a class="link" href="GSettingsBackend.html" title="GSettingsBackend"><span class="type">GSettingsBackend</span></a> to use
693
+ </td>
694
+ </tr>
695
+ <tr>
696
+ <td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
697
+ <td>the path to use
698
+ </td>
699
+ </tr>
700
+ <tr>
701
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
702
+ <td>a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
703
+ </td>
704
+ </tr>
705
+ </tbody>
706
+ </table></div>
707
+ <p class="since">Since 2.26</p>
708
+ </div>
709
+ <hr>
710
+ <div class="refsect2">
711
+ <a name="g-settings-sync"></a><h3>g_settings_sync ()</h3>
712
+ <pre class="programlisting"><span class="returnvalue">void</span> g_settings_sync (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
713
+ <p>
714
+ Ensures that all pending operations for the given are complete for
715
+ the default backend.
716
+ </p>
717
+ <p>
718
+ Writes made to a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> are handled asynchronously. For this
719
+ reason, it is very unlikely that the changes have it to disk by the
720
+ time <a class="link" href="GSettings.html#g-settings-set" title="g_settings_set ()"><code class="function">g_settings_set()</code></a> returns.
721
+ </p>
722
+ <p>
723
+ This call will block until all of the writes have made it to the
724
+ backend. Since the mainloop is not running, no change notifications
725
+ will be dispatched during this call (but some may be queued by the
726
+ time the call is done).
727
+ </p>
728
+ </div>
729
+ <hr>
730
+ <div class="refsect2">
731
+ <a name="g-settings-get-value"></a><h3>g_settings_get_value ()</h3>
732
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * g_settings_get_value (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
733
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
734
+ <p>
735
+ Gets the value that is stored in <em class="parameter"><code>settings</code></em> for <em class="parameter"><code>key</code></em>.
736
+ </p>
737
+ <p>
738
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't contained in the
739
+ schema for <em class="parameter"><code>settings</code></em>.
740
+ </p>
741
+ <div class="variablelist"><table border="0">
742
+ <col align="left" valign="top">
743
+ <tbody>
744
+ <tr>
745
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
746
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
747
+ </td>
748
+ </tr>
749
+ <tr>
750
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
751
+ <td>the key to get the value for
752
+ </td>
753
+ </tr>
754
+ <tr>
755
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
756
+ <td>a new <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>
757
+ </td>
758
+ </tr>
759
+ </tbody>
760
+ </table></div>
761
+ <p class="since">Since 2.26</p>
762
+ </div>
763
+ <hr>
764
+ <div class="refsect2">
765
+ <a name="g-settings-set-value"></a><h3>g_settings_set_value ()</h3>
766
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_settings_set_value (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
767
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
768
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
769
+ <p>
770
+ Sets <em class="parameter"><code>key</code></em> in <em class="parameter"><code>settings</code></em> to <em class="parameter"><code>value</code></em>.
771
+ </p>
772
+ <p>
773
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't contained in the
774
+ schema for <em class="parameter"><code>settings</code></em> or for <em class="parameter"><code>value</code></em> to have the incorrect type, per
775
+ the schema.
776
+ </p>
777
+ <p>
778
+ If <em class="parameter"><code>value</code></em> is floating then this function consumes the reference.
779
+ </p>
780
+ <div class="variablelist"><table border="0">
781
+ <col align="left" valign="top">
782
+ <tbody>
783
+ <tr>
784
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
785
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
786
+ </td>
787
+ </tr>
788
+ <tr>
789
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
790
+ <td>the name of the key to set
791
+ </td>
792
+ </tr>
793
+ <tr>
794
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
795
+ <td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> of the correct type
796
+ </td>
797
+ </tr>
798
+ <tr>
799
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
800
+ <td>
801
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if setting the key succeeded,
802
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the key was not writable
803
+ </td>
804
+ </tr>
805
+ </tbody>
806
+ </table></div>
807
+ <p class="since">Since 2.26</p>
808
+ </div>
809
+ <hr>
810
+ <div class="refsect2">
811
+ <a name="g-settings-is-writable"></a><h3>g_settings_is_writable ()</h3>
812
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_settings_is_writable (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
813
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
814
+ <p>
815
+ Finds out if a key can be written or not
816
+ </p>
817
+ <div class="variablelist"><table border="0">
818
+ <col align="left" valign="top">
819
+ <tbody>
820
+ <tr>
821
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
822
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
823
+ </td>
824
+ </tr>
825
+ <tr>
826
+ <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
827
+ <td>the name of a key
828
+ </td>
829
+ </tr>
830
+ <tr>
831
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
832
+ <td>
833
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the key <em class="parameter"><code>name</code></em> is writable
834
+ </td>
835
+ </tr>
836
+ </tbody>
837
+ </table></div>
838
+ <p class="since">Since 2.26</p>
839
+ </div>
840
+ <hr>
841
+ <div class="refsect2">
842
+ <a name="g-settings-delay"></a><h3>g_settings_delay ()</h3>
843
+ <pre class="programlisting"><span class="returnvalue">void</span> g_settings_delay (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>);</pre>
844
+ <p>
845
+ Changes the <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object into 'delay-apply' mode. In this
846
+ mode, changes to <em class="parameter"><code>settings</code></em> are not immediately propagated to the
847
+ backend, but kept locally until <a class="link" href="GSettings.html#g-settings-apply" title="g_settings_apply ()"><code class="function">g_settings_apply()</code></a> is called.
848
+ </p>
849
+ <div class="variablelist"><table border="0">
850
+ <col align="left" valign="top">
851
+ <tbody><tr>
852
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
853
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
854
+ </td>
855
+ </tr></tbody>
856
+ </table></div>
857
+ <p class="since">Since 2.26</p>
858
+ </div>
859
+ <hr>
860
+ <div class="refsect2">
861
+ <a name="g-settings-apply"></a><h3>g_settings_apply ()</h3>
862
+ <pre class="programlisting"><span class="returnvalue">void</span> g_settings_apply (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>);</pre>
863
+ <p>
864
+ Applies any changes that have been made to the settings. This
865
+ function does nothing unless <em class="parameter"><code>settings</code></em> is in 'delay-apply' mode;
866
+ see <a class="link" href="GSettings.html#g-settings-delay" title="g_settings_delay ()"><code class="function">g_settings_delay()</code></a>. In the normal case settings are always
867
+ applied immediately.
868
+ </p>
869
+ <div class="variablelist"><table border="0">
870
+ <col align="left" valign="top">
871
+ <tbody><tr>
872
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
873
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> instance
874
+ </td>
875
+ </tr></tbody>
876
+ </table></div>
877
+ </div>
878
+ <hr>
879
+ <div class="refsect2">
880
+ <a name="g-settings-revert"></a><h3>g_settings_revert ()</h3>
881
+ <pre class="programlisting"><span class="returnvalue">void</span> g_settings_revert (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>);</pre>
882
+ <p>
883
+ Reverts all non-applied changes to the settings. This function
884
+ does nothing unless <em class="parameter"><code>settings</code></em> is in 'delay-apply' mode; see
885
+ <a class="link" href="GSettings.html#g-settings-delay" title="g_settings_delay ()"><code class="function">g_settings_delay()</code></a>. In the normal case settings are always applied
886
+ immediately.
887
+ </p>
888
+ <p>
889
+ Change notifications will be emitted for affected keys.
890
+ </p>
891
+ <div class="variablelist"><table border="0">
892
+ <col align="left" valign="top">
893
+ <tbody><tr>
894
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
895
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> instance
896
+ </td>
897
+ </tr></tbody>
898
+ </table></div>
899
+ </div>
900
+ <hr>
901
+ <div class="refsect2">
902
+ <a name="g-settings-get-has-unapplied"></a><h3>g_settings_get_has_unapplied ()</h3>
903
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_settings_get_has_unapplied (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>);</pre>
904
+ <p>
905
+ Returns whether the <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object has any unapplied
906
+ changes. This can only be the case if it is in 'delayed-apply' mode.
907
+ </p>
908
+ <div class="variablelist"><table border="0">
909
+ <col align="left" valign="top">
910
+ <tbody>
911
+ <tr>
912
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
913
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
914
+ </td>
915
+ </tr>
916
+ <tr>
917
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
918
+ <td>
919
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>settings</code></em> has unapplied changes
920
+ </td>
921
+ </tr>
922
+ </tbody>
923
+ </table></div>
924
+ <p class="since">Since 2.26</p>
925
+ </div>
926
+ <hr>
927
+ <div class="refsect2">
928
+ <a name="g-settings-get-child"></a><h3>g_settings_get_child ()</h3>
929
+ <pre class="programlisting"><a class="link" href="GSettings.html" title="GSettings"><span class="returnvalue">GSettings</span></a> * g_settings_get_child (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
930
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
931
+ <p>
932
+ Creates a 'child' settings object which has a base path of
933
+ <em class="replaceable"><code>base-path</code></em>/<em class="parameter"><code>name</code></em>", where
934
+ <em class="replaceable"><code>base-path</code></em> is the base path of <em class="parameter"><code>settings</code></em>.
935
+ </p>
936
+ <p>
937
+ The schema for the child settings object must have been declared
938
+ in the schema of <em class="parameter"><code>settings</code></em> using a <code class="sgmltag-starttag">&lt;child&gt;</code> element.
939
+ </p>
940
+ <div class="variablelist"><table border="0">
941
+ <col align="left" valign="top">
942
+ <tbody>
943
+ <tr>
944
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
945
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
946
+ </td>
947
+ </tr>
948
+ <tr>
949
+ <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
950
+ <td>the name of the 'child' schema
951
+ </td>
952
+ </tr>
953
+ <tr>
954
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
955
+ <td>a 'child' settings object
956
+ </td>
957
+ </tr>
958
+ </tbody>
959
+ </table></div>
960
+ <p class="since">Since 2.26</p>
961
+ </div>
962
+ <hr>
963
+ <div class="refsect2">
964
+ <a name="g-settings-reset"></a><h3>g_settings_reset ()</h3>
965
+ <pre class="programlisting"><span class="returnvalue">void</span> g_settings_reset (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
966
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
967
+ <p>
968
+ Resets <em class="parameter"><code>key</code></em> to its default value.
969
+ </p>
970
+ <p>
971
+ This call resets the key, as much as possible, to its default value.
972
+ That might the value specified in the schema or the one set by the
973
+ administrator.
974
+ </p>
975
+ <div class="variablelist"><table border="0">
976
+ <col align="left" valign="top">
977
+ <tbody>
978
+ <tr>
979
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
980
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
981
+ </td>
982
+ </tr>
983
+ <tr>
984
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
985
+ <td>the name of a key
986
+ </td>
987
+ </tr>
988
+ </tbody>
989
+ </table></div>
990
+ </div>
991
+ <hr>
992
+ <div class="refsect2">
993
+ <a name="g-settings-list-schemas"></a><h3>g_settings_list_schemas ()</h3>
994
+ <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const * g_settings_list_schemas (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
995
+ <p>
996
+ Returns a list of GSettings schemas that are available. The list
997
+ must not be modified or freed.
998
+ </p>
999
+ <div class="variablelist"><table border="0">
1000
+ <col align="left" valign="top">
1001
+ <tbody><tr>
1002
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1003
+ <td>a list of the schemas installed on the system
1004
+ </td>
1005
+ </tr></tbody>
1006
+ </table></div>
1007
+ </div>
1008
+ <hr>
1009
+ <div class="refsect2">
1010
+ <a name="g-settings-get"></a><h3>g_settings_get ()</h3>
1011
+ <pre class="programlisting"><span class="returnvalue">void</span> g_settings_get (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1012
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
1013
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *format</code></em>,
1014
+ <em class="parameter"><code>...</code></em>);</pre>
1015
+ <p>
1016
+ Gets the value that is stored at <em class="parameter"><code>key</code></em> in <em class="parameter"><code>settings</code></em>.
1017
+ </p>
1018
+ <p>
1019
+ A convenience function that combines <a class="link" href="GSettings.html#g-settings-get-value" title="g_settings_get_value ()"><code class="function">g_settings_get_value()</code></a> with
1020
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-get"><code class="function">g_variant_get()</code></a>.
1021
+ </p>
1022
+ <p>
1023
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't contained in the
1024
+ schema for <em class="parameter"><code>settings</code></em> or for the <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a> of <em class="parameter"><code>format</code></em> to mismatch
1025
+ the type given in the schema.
1026
+ </p>
1027
+ <div class="variablelist"><table border="0">
1028
+ <col align="left" valign="top">
1029
+ <tbody>
1030
+ <tr>
1031
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1032
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1033
+ </td>
1034
+ </tr>
1035
+ <tr>
1036
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1037
+ <td>the key to get the value for
1038
+ </td>
1039
+ </tr>
1040
+ <tr>
1041
+ <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
1042
+ <td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> format string
1043
+ </td>
1044
+ </tr>
1045
+ <tr>
1046
+ <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1047
+ <td>arguments as per <em class="parameter"><code>format</code></em>
1048
+ </td>
1049
+ </tr>
1050
+ </tbody>
1051
+ </table></div>
1052
+ <p class="since">Since 2.26</p>
1053
+ </div>
1054
+ <hr>
1055
+ <div class="refsect2">
1056
+ <a name="g-settings-set"></a><h3>g_settings_set ()</h3>
1057
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_settings_set (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1058
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
1059
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *format</code></em>,
1060
+ <em class="parameter"><code>...</code></em>);</pre>
1061
+ <p>
1062
+ Sets <em class="parameter"><code>key</code></em> in <em class="parameter"><code>settings</code></em> to <em class="parameter"><code>value</code></em>.
1063
+ </p>
1064
+ <p>
1065
+ A convenience function that combines <a class="link" href="GSettings.html#g-settings-set-value" title="g_settings_set_value ()"><code class="function">g_settings_set_value()</code></a> with
1066
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-new"><code class="function">g_variant_new()</code></a>.
1067
+ </p>
1068
+ <p>
1069
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't contained in the
1070
+ schema for <em class="parameter"><code>settings</code></em> or for the <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a> of <em class="parameter"><code>format</code></em> to mismatch
1071
+ the type given in the schema.
1072
+ </p>
1073
+ <div class="variablelist"><table border="0">
1074
+ <col align="left" valign="top">
1075
+ <tbody>
1076
+ <tr>
1077
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1078
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1079
+ </td>
1080
+ </tr>
1081
+ <tr>
1082
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1083
+ <td>the name of the key to set
1084
+ </td>
1085
+ </tr>
1086
+ <tr>
1087
+ <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
1088
+ <td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> format string
1089
+ </td>
1090
+ </tr>
1091
+ <tr>
1092
+ <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1093
+ <td>arguments as per <em class="parameter"><code>format</code></em>
1094
+ </td>
1095
+ </tr>
1096
+ <tr>
1097
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1098
+ <td>
1099
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if setting the key succeeded,
1100
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the key was not writable
1101
+ </td>
1102
+ </tr>
1103
+ </tbody>
1104
+ </table></div>
1105
+ <p class="since">Since 2.26</p>
1106
+ </div>
1107
+ <hr>
1108
+ <div class="refsect2">
1109
+ <a name="g-settings-get-boolean"></a><h3>g_settings_get_boolean ()</h3>
1110
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_settings_get_boolean (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1111
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
1112
+ <p>
1113
+ Gets the value that is stored at <em class="parameter"><code>key</code></em> in <em class="parameter"><code>settings</code></em>.
1114
+ </p>
1115
+ <p>
1116
+ A convenience variant of <a class="link" href="GSettings.html#g-settings-get" title="g_settings_get ()"><code class="function">g_settings_get()</code></a> for booleans.
1117
+ </p>
1118
+ <p>
1119
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't specified as
1120
+ having a boolean type in the schema for <em class="parameter"><code>settings</code></em>.
1121
+ </p>
1122
+ <div class="variablelist"><table border="0">
1123
+ <col align="left" valign="top">
1124
+ <tbody>
1125
+ <tr>
1126
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1127
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1128
+ </td>
1129
+ </tr>
1130
+ <tr>
1131
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1132
+ <td>the key to get the value for
1133
+ </td>
1134
+ </tr>
1135
+ <tr>
1136
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1137
+ <td>a boolean
1138
+ </td>
1139
+ </tr>
1140
+ </tbody>
1141
+ </table></div>
1142
+ <p class="since">Since 2.26</p>
1143
+ </div>
1144
+ <hr>
1145
+ <div class="refsect2">
1146
+ <a name="g-settings-set-boolean"></a><h3>g_settings_set_boolean ()</h3>
1147
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_settings_set_boolean (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1148
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
1149
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> value</code></em>);</pre>
1150
+ <p>
1151
+ Sets <em class="parameter"><code>key</code></em> in <em class="parameter"><code>settings</code></em> to <em class="parameter"><code>value</code></em>.
1152
+ </p>
1153
+ <p>
1154
+ A convenience variant of <a class="link" href="GSettings.html#g-settings-set" title="g_settings_set ()"><code class="function">g_settings_set()</code></a> for booleans.
1155
+ </p>
1156
+ <p>
1157
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't specified as
1158
+ having a boolean type in the schema for <em class="parameter"><code>settings</code></em>.
1159
+ </p>
1160
+ <div class="variablelist"><table border="0">
1161
+ <col align="left" valign="top">
1162
+ <tbody>
1163
+ <tr>
1164
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1165
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1166
+ </td>
1167
+ </tr>
1168
+ <tr>
1169
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1170
+ <td>the name of the key to set
1171
+ </td>
1172
+ </tr>
1173
+ <tr>
1174
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1175
+ <td>the value to set it to
1176
+ </td>
1177
+ </tr>
1178
+ <tr>
1179
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1180
+ <td>
1181
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if setting the key succeeded,
1182
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the key was not writable
1183
+ </td>
1184
+ </tr>
1185
+ </tbody>
1186
+ </table></div>
1187
+ <p class="since">Since 2.26</p>
1188
+ </div>
1189
+ <hr>
1190
+ <div class="refsect2">
1191
+ <a name="g-settings-get-int"></a><h3>g_settings_get_int ()</h3>
1192
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> g_settings_get_int (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1193
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
1194
+ <p>
1195
+ Gets the value that is stored at <em class="parameter"><code>key</code></em> in <em class="parameter"><code>settings</code></em>.
1196
+ </p>
1197
+ <p>
1198
+ A convenience variant of <a class="link" href="GSettings.html#g-settings-get" title="g_settings_get ()"><code class="function">g_settings_get()</code></a> for 32-bit integers.
1199
+ </p>
1200
+ <p>
1201
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't specified as
1202
+ having a int32 type in the schema for <em class="parameter"><code>settings</code></em>.
1203
+ </p>
1204
+ <div class="variablelist"><table border="0">
1205
+ <col align="left" valign="top">
1206
+ <tbody>
1207
+ <tr>
1208
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1209
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1210
+ </td>
1211
+ </tr>
1212
+ <tr>
1213
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1214
+ <td>the key to get the value for
1215
+ </td>
1216
+ </tr>
1217
+ <tr>
1218
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1219
+ <td>an integer
1220
+ </td>
1221
+ </tr>
1222
+ </tbody>
1223
+ </table></div>
1224
+ <p class="since">Since 2.26</p>
1225
+ </div>
1226
+ <hr>
1227
+ <div class="refsect2">
1228
+ <a name="g-settings-set-int"></a><h3>g_settings_set_int ()</h3>
1229
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_settings_set_int (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1230
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
1231
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> value</code></em>);</pre>
1232
+ <p>
1233
+ Sets <em class="parameter"><code>key</code></em> in <em class="parameter"><code>settings</code></em> to <em class="parameter"><code>value</code></em>.
1234
+ </p>
1235
+ <p>
1236
+ A convenience variant of <a class="link" href="GSettings.html#g-settings-set" title="g_settings_set ()"><code class="function">g_settings_set()</code></a> for 32-bit integers.
1237
+ </p>
1238
+ <p>
1239
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't specified as
1240
+ having a int32 type in the schema for <em class="parameter"><code>settings</code></em>.
1241
+ </p>
1242
+ <div class="variablelist"><table border="0">
1243
+ <col align="left" valign="top">
1244
+ <tbody>
1245
+ <tr>
1246
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1247
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1248
+ </td>
1249
+ </tr>
1250
+ <tr>
1251
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1252
+ <td>the name of the key to set
1253
+ </td>
1254
+ </tr>
1255
+ <tr>
1256
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1257
+ <td>the value to set it to
1258
+ </td>
1259
+ </tr>
1260
+ <tr>
1261
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1262
+ <td>
1263
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if setting the key succeeded,
1264
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the key was not writable
1265
+ </td>
1266
+ </tr>
1267
+ </tbody>
1268
+ </table></div>
1269
+ <p class="since">Since 2.26</p>
1270
+ </div>
1271
+ <hr>
1272
+ <div class="refsect2">
1273
+ <a name="g-settings-get-double"></a><h3>g_settings_get_double ()</h3>
1274
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a> g_settings_get_double (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1275
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
1276
+ <p>
1277
+ Gets the value that is stored at <em class="parameter"><code>key</code></em> in <em class="parameter"><code>settings</code></em>.
1278
+ </p>
1279
+ <p>
1280
+ A convenience variant of <a class="link" href="GSettings.html#g-settings-get" title="g_settings_get ()"><code class="function">g_settings_get()</code></a> for doubles.
1281
+ </p>
1282
+ <p>
1283
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't specified as
1284
+ having a 'double' type in the schema for <em class="parameter"><code>settings</code></em>.
1285
+ </p>
1286
+ <div class="variablelist"><table border="0">
1287
+ <col align="left" valign="top">
1288
+ <tbody>
1289
+ <tr>
1290
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1291
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1292
+ </td>
1293
+ </tr>
1294
+ <tr>
1295
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1296
+ <td>the key to get the value for
1297
+ </td>
1298
+ </tr>
1299
+ <tr>
1300
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1301
+ <td>a double
1302
+ </td>
1303
+ </tr>
1304
+ </tbody>
1305
+ </table></div>
1306
+ <p class="since">Since 2.26</p>
1307
+ </div>
1308
+ <hr>
1309
+ <div class="refsect2">
1310
+ <a name="g-settings-set-double"></a><h3>g_settings_set_double ()</h3>
1311
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_settings_set_double (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1312
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
1313
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> value</code></em>);</pre>
1314
+ <p>
1315
+ Sets <em class="parameter"><code>key</code></em> in <em class="parameter"><code>settings</code></em> to <em class="parameter"><code>value</code></em>.
1316
+ </p>
1317
+ <p>
1318
+ A convenience variant of <a class="link" href="GSettings.html#g-settings-set" title="g_settings_set ()"><code class="function">g_settings_set()</code></a> for doubles.
1319
+ </p>
1320
+ <p>
1321
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't specified as
1322
+ having a 'double' type in the schema for <em class="parameter"><code>settings</code></em>.
1323
+ </p>
1324
+ <div class="variablelist"><table border="0">
1325
+ <col align="left" valign="top">
1326
+ <tbody>
1327
+ <tr>
1328
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1329
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1330
+ </td>
1331
+ </tr>
1332
+ <tr>
1333
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1334
+ <td>the name of the key to set
1335
+ </td>
1336
+ </tr>
1337
+ <tr>
1338
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1339
+ <td>the value to set it to
1340
+ </td>
1341
+ </tr>
1342
+ <tr>
1343
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1344
+ <td>
1345
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if setting the key succeeded,
1346
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the key was not writable
1347
+ </td>
1348
+ </tr>
1349
+ </tbody>
1350
+ </table></div>
1351
+ <p class="since">Since 2.26</p>
1352
+ </div>
1353
+ <hr>
1354
+ <div class="refsect2">
1355
+ <a name="g-settings-get-string"></a><h3>g_settings_get_string ()</h3>
1356
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * g_settings_get_string (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1357
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
1358
+ <p>
1359
+ Gets the value that is stored at <em class="parameter"><code>key</code></em> in <em class="parameter"><code>settings</code></em>.
1360
+ </p>
1361
+ <p>
1362
+ A convenience variant of <a class="link" href="GSettings.html#g-settings-get" title="g_settings_get ()"><code class="function">g_settings_get()</code></a> for strings.
1363
+ </p>
1364
+ <p>
1365
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't specified as
1366
+ having a string type in the schema for <em class="parameter"><code>settings</code></em>.
1367
+ </p>
1368
+ <div class="variablelist"><table border="0">
1369
+ <col align="left" valign="top">
1370
+ <tbody>
1371
+ <tr>
1372
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1373
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1374
+ </td>
1375
+ </tr>
1376
+ <tr>
1377
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1378
+ <td>the key to get the value for
1379
+ </td>
1380
+ </tr>
1381
+ <tr>
1382
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1383
+ <td>a newly-allocated string
1384
+ </td>
1385
+ </tr>
1386
+ </tbody>
1387
+ </table></div>
1388
+ <p class="since">Since 2.26</p>
1389
+ </div>
1390
+ <hr>
1391
+ <div class="refsect2">
1392
+ <a name="g-settings-set-string"></a><h3>g_settings_set_string ()</h3>
1393
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_settings_set_string (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1394
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
1395
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1396
+ <p>
1397
+ Sets <em class="parameter"><code>key</code></em> in <em class="parameter"><code>settings</code></em> to <em class="parameter"><code>value</code></em>.
1398
+ </p>
1399
+ <p>
1400
+ A convenience variant of <a class="link" href="GSettings.html#g-settings-set" title="g_settings_set ()"><code class="function">g_settings_set()</code></a> for strings.
1401
+ </p>
1402
+ <p>
1403
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't specified as
1404
+ having a string type in the schema for <em class="parameter"><code>settings</code></em>.
1405
+ </p>
1406
+ <div class="variablelist"><table border="0">
1407
+ <col align="left" valign="top">
1408
+ <tbody>
1409
+ <tr>
1410
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1411
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1412
+ </td>
1413
+ </tr>
1414
+ <tr>
1415
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1416
+ <td>the name of the key to set
1417
+ </td>
1418
+ </tr>
1419
+ <tr>
1420
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1421
+ <td>the value to set it to
1422
+ </td>
1423
+ </tr>
1424
+ <tr>
1425
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1426
+ <td>
1427
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if setting the key succeeded,
1428
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the key was not writable
1429
+ </td>
1430
+ </tr>
1431
+ </tbody>
1432
+ </table></div>
1433
+ <p class="since">Since 2.26</p>
1434
+ </div>
1435
+ <hr>
1436
+ <div class="refsect2">
1437
+ <a name="g-settings-get-strv"></a><h3>g_settings_get_strv ()</h3>
1438
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** g_settings_get_strv (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1439
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
1440
+ <p>
1441
+ Gets the value that is stored at <em class="parameter"><code>key</code></em> in <em class="parameter"><code>settings</code></em>.
1442
+ </p>
1443
+ <p>
1444
+ A convenience variant of <a class="link" href="GSettings.html#g-settings-get" title="g_settings_get ()"><code class="function">g_settings_get()</code></a> for string arrays.
1445
+ </p>
1446
+ <p>
1447
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't specified as
1448
+ having an array of strings type in the schema for <em class="parameter"><code>settings</code></em>.
1449
+ </p>
1450
+ <div class="variablelist"><table border="0">
1451
+ <col align="left" valign="top">
1452
+ <tbody>
1453
+ <tr>
1454
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1455
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1456
+ </td>
1457
+ </tr>
1458
+ <tr>
1459
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1460
+ <td>the key to get the value for
1461
+ </td>
1462
+ </tr>
1463
+ <tr>
1464
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1465
+ <td>a newly-allocated, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings
1466
+ </td>
1467
+ </tr>
1468
+ </tbody>
1469
+ </table></div>
1470
+ <p class="since">Since 2.26</p>
1471
+ </div>
1472
+ <hr>
1473
+ <div class="refsect2">
1474
+ <a name="g-settings-set-strv"></a><h3>g_settings_set_strv ()</h3>
1475
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_settings_set_strv (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1476
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
1477
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *const *value</code></em>);</pre>
1478
+ <p>
1479
+ Sets <em class="parameter"><code>key</code></em> in <em class="parameter"><code>settings</code></em> to <em class="parameter"><code>value</code></em>.
1480
+ </p>
1481
+ <p>
1482
+ A convenience variant of <a class="link" href="GSettings.html#g-settings-set" title="g_settings_set ()"><code class="function">g_settings_set()</code></a> for string arrays. If
1483
+ <em class="parameter"><code>value</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then <em class="parameter"><code>key</code></em> is set to be the empty array.
1484
+ </p>
1485
+ <p>
1486
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't specified as
1487
+ having an array of strings type in the schema for <em class="parameter"><code>settings</code></em>.
1488
+ </p>
1489
+ <div class="variablelist"><table border="0">
1490
+ <col align="left" valign="top">
1491
+ <tbody>
1492
+ <tr>
1493
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1494
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1495
+ </td>
1496
+ </tr>
1497
+ <tr>
1498
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1499
+ <td>the name of the key to set
1500
+ </td>
1501
+ </tr>
1502
+ <tr>
1503
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1504
+ <td> the value to set it to, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1505
+ </td>
1506
+ </tr>
1507
+ <tr>
1508
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1509
+ <td>
1510
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if setting the key succeeded,
1511
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the key was not writable
1512
+ </td>
1513
+ </tr>
1514
+ </tbody>
1515
+ </table></div>
1516
+ <p class="since">Since 2.26</p>
1517
+ </div>
1518
+ <hr>
1519
+ <div class="refsect2">
1520
+ <a name="g-settings-get-enum"></a><h3>g_settings_get_enum ()</h3>
1521
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> g_settings_get_enum (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1522
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
1523
+ <p>
1524
+ Gets the value that is stored in <em class="parameter"><code>settings</code></em> for <em class="parameter"><code>key</code></em> and converts it
1525
+ to the enum value that it represents.
1526
+ </p>
1527
+ <p>
1528
+ In order to use this function the type of the value must be a string
1529
+ and it must be marked in the schema file as an enumerated type.
1530
+ </p>
1531
+ <p>
1532
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't contained in the
1533
+ schema for <em class="parameter"><code>settings</code></em> or is not marked as an enumerated type.
1534
+ </p>
1535
+ <p>
1536
+ If the value stored in the configuration database is not a valid
1537
+ value for the enumerated type then this function will return the
1538
+ default value.
1539
+ </p>
1540
+ <div class="variablelist"><table border="0">
1541
+ <col align="left" valign="top">
1542
+ <tbody>
1543
+ <tr>
1544
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1545
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1546
+ </td>
1547
+ </tr>
1548
+ <tr>
1549
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1550
+ <td>the key to get the value for
1551
+ </td>
1552
+ </tr>
1553
+ <tr>
1554
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1555
+ <td>the enum value
1556
+ </td>
1557
+ </tr>
1558
+ </tbody>
1559
+ </table></div>
1560
+ <p class="since">Since 2.26</p>
1561
+ </div>
1562
+ <hr>
1563
+ <div class="refsect2">
1564
+ <a name="g-settings-set-enum"></a><h3>g_settings_set_enum ()</h3>
1565
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_settings_set_enum (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1566
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
1567
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> value</code></em>);</pre>
1568
+ <p>
1569
+ Looks up the enumerated type nick for <em class="parameter"><code>value</code></em> and writes it to <em class="parameter"><code>key</code></em>,
1570
+ within <em class="parameter"><code>settings</code></em>.
1571
+ </p>
1572
+ <p>
1573
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't contained in the
1574
+ schema for <em class="parameter"><code>settings</code></em> or is not marked as an enumerated type, or for
1575
+ <em class="parameter"><code>value</code></em> not to be a valid value for the named type.
1576
+ </p>
1577
+ <p>
1578
+ After performing the write, accessing <em class="parameter"><code>key</code></em> directly with
1579
+ <a class="link" href="GSettings.html#g-settings-get-string" title="g_settings_get_string ()"><code class="function">g_settings_get_string()</code></a> will return the 'nick' associated with
1580
+ <em class="parameter"><code>value</code></em>.
1581
+ </p>
1582
+ <div class="variablelist"><table border="0">
1583
+ <col align="left" valign="top">
1584
+ <tbody>
1585
+ <tr>
1586
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1587
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1588
+ </td>
1589
+ </tr>
1590
+ <tr>
1591
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1592
+ <td>a key, within <em class="parameter"><code>settings</code></em>
1593
+ </td>
1594
+ </tr>
1595
+ <tr>
1596
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1597
+ <td>an enumerated value
1598
+ </td>
1599
+ </tr>
1600
+ <tr>
1601
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1602
+ <td>
1603
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if the set succeeds
1604
+ </td>
1605
+ </tr>
1606
+ </tbody>
1607
+ </table></div>
1608
+ </div>
1609
+ <hr>
1610
+ <div class="refsect2">
1611
+ <a name="g-settings-get-flags"></a><h3>g_settings_get_flags ()</h3>
1612
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> g_settings_get_flags (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1613
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
1614
+ <p>
1615
+ Gets the value that is stored in <em class="parameter"><code>settings</code></em> for <em class="parameter"><code>key</code></em> and converts it
1616
+ to the flags value that it represents.
1617
+ </p>
1618
+ <p>
1619
+ In order to use this function the type of the value must be an array
1620
+ of strings and it must be marked in the schema file as an flags type.
1621
+ </p>
1622
+ <p>
1623
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't contained in the
1624
+ schema for <em class="parameter"><code>settings</code></em> or is not marked as a flags type.
1625
+ </p>
1626
+ <p>
1627
+ If the value stored in the configuration database is not a valid
1628
+ value for the flags type then this function will return the default
1629
+ value.
1630
+ </p>
1631
+ <div class="variablelist"><table border="0">
1632
+ <col align="left" valign="top">
1633
+ <tbody>
1634
+ <tr>
1635
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1636
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1637
+ </td>
1638
+ </tr>
1639
+ <tr>
1640
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1641
+ <td>the key to get the value for
1642
+ </td>
1643
+ </tr>
1644
+ <tr>
1645
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1646
+ <td>the flags value
1647
+ </td>
1648
+ </tr>
1649
+ </tbody>
1650
+ </table></div>
1651
+ <p class="since">Since 2.26</p>
1652
+ </div>
1653
+ <hr>
1654
+ <div class="refsect2">
1655
+ <a name="g-settings-set-flags"></a><h3>g_settings_set_flags ()</h3>
1656
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> g_settings_set_flags (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1657
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
1658
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> value</code></em>);</pre>
1659
+ <p>
1660
+ Looks up the flags type nicks for the bits specified by <em class="parameter"><code>value</code></em>, puts
1661
+ them in an array of strings and writes the array to <em class="parameter"><code>key</code></em>, withing
1662
+ <em class="parameter"><code>settings</code></em>.
1663
+ </p>
1664
+ <p>
1665
+ It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't contained in the
1666
+ schema for <em class="parameter"><code>settings</code></em> or is not marked as a flags type, or for <em class="parameter"><code>value</code></em>
1667
+ to contain any bits that are not value for the named type.
1668
+ </p>
1669
+ <p>
1670
+ After performing the write, accessing <em class="parameter"><code>key</code></em> directly with
1671
+ <a class="link" href="GSettings.html#g-settings-get-strv" title="g_settings_get_strv ()"><code class="function">g_settings_get_strv()</code></a> will return an array of 'nicks'; one for each
1672
+ bit in <em class="parameter"><code>value</code></em>.
1673
+ </p>
1674
+ <div class="variablelist"><table border="0">
1675
+ <col align="left" valign="top">
1676
+ <tbody>
1677
+ <tr>
1678
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1679
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1680
+ </td>
1681
+ </tr>
1682
+ <tr>
1683
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1684
+ <td>a key, within <em class="parameter"><code>settings</code></em>
1685
+ </td>
1686
+ </tr>
1687
+ <tr>
1688
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1689
+ <td>a flags value
1690
+ </td>
1691
+ </tr>
1692
+ <tr>
1693
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1694
+ <td>
1695
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if the set succeeds
1696
+ </td>
1697
+ </tr>
1698
+ </tbody>
1699
+ </table></div>
1700
+ </div>
1701
+ <hr>
1702
+ <div class="refsect2">
1703
+ <a name="GSettingsGetMapping"></a><h3>GSettingsGetMapping ()</h3>
1704
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (*GSettingsGetMapping) (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *value</code></em>,
1705
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> *result</code></em>,
1706
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1707
+ <p>
1708
+ The type of the function that is used to convert from a value stored
1709
+ in a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> to a value that is useful to the application.
1710
+ </p>
1711
+ <p>
1712
+ If the value is successfully mapped, the result should be stored at
1713
+ <em class="parameter"><code>result</code></em> and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> returned. If mapping fails (for example, if <em class="parameter"><code>value</code></em>
1714
+ is not in the right format) then <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> should be returned.
1715
+ </p>
1716
+ <p>
1717
+ If <em class="parameter"><code>value</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then it means that the mapping function is being
1718
+ given a "last chance" to successfully return a valid value. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
1719
+ must be returned in this case.
1720
+ </p>
1721
+ <div class="variablelist"><table border="0">
1722
+ <col align="left" valign="top">
1723
+ <tbody>
1724
+ <tr>
1725
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1726
+ <td>the <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> to map, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1727
+ </td>
1728
+ </tr>
1729
+ <tr>
1730
+ <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1731
+ <td>the result of the mapping
1732
+ </td>
1733
+ </tr>
1734
+ <tr>
1735
+ <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1736
+ <td>the user data that was passed to <a class="link" href="GSettings.html#g-settings-get-mapped" title="g_settings_get_mapped ()"><code class="function">g_settings_get_mapped()</code></a>
1737
+ </td>
1738
+ </tr>
1739
+ <tr>
1740
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1741
+ <td>
1742
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the conversion succeeded, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> in case of an error
1743
+ </td>
1744
+ </tr>
1745
+ </tbody>
1746
+ </table></div>
1747
+ </div>
1748
+ <hr>
1749
+ <div class="refsect2">
1750
+ <a name="g-settings-get-mapped"></a><h3>g_settings_get_mapped ()</h3>
1751
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> g_settings_get_mapped (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1752
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
1753
+ <em class="parameter"><code><a class="link" href="GSettings.html#GSettingsGetMapping" title="GSettingsGetMapping ()"><span class="type">GSettingsGetMapping</span></a> mapping</code></em>,
1754
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1755
+ <p>
1756
+ Gets the value that is stored at <em class="parameter"><code>key</code></em> in <em class="parameter"><code>settings</code></em>, subject to
1757
+ application-level validation/mapping.
1758
+ </p>
1759
+ <p>
1760
+ You should use this function when the application needs to perform
1761
+ some processing on the value of the key (for example, parsing). The
1762
+ <em class="parameter"><code>mapping</code></em> function performs that processing. If the function
1763
+ indicates that the processing was unsuccessful (due to a parse error,
1764
+ for example) then the mapping is tried again with another value.
1765
+ </p>
1766
+ <p>
1767
+ This allows a robust 'fall back to defaults' behaviour to be
1768
+ implemented somewhat automatically.
1769
+ </p>
1770
+ <p>
1771
+ The first value that is tried is the user's setting for the key. If
1772
+ the mapping function fails to map this value, other values may be
1773
+ tried in an unspecified order (system or site defaults, translated
1774
+ schema default values, untranslated schema default values, etc).
1775
+ </p>
1776
+ <p>
1777
+ If the mapping function fails for all possible values, one additional
1778
+ attempt is made: the mapping function is called with a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value.
1779
+ If the mapping function still indicates failure at this point then
1780
+ the application will be aborted.
1781
+ </p>
1782
+ <p>
1783
+ The result parameter for the <em class="parameter"><code>mapping</code></em> function is pointed to a
1784
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> which is initially set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. The same pointer is given
1785
+ to each invocation of <em class="parameter"><code>mapping</code></em>. The final value of that <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> is
1786
+ what is returned by this function. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is valid; it is returned
1787
+ just as any other value would be.
1788
+ </p>
1789
+ <div class="variablelist"><table border="0">
1790
+ <col align="left" valign="top">
1791
+ <tbody>
1792
+ <tr>
1793
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1794
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1795
+ </td>
1796
+ </tr>
1797
+ <tr>
1798
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1799
+ <td>the key to get the value for
1800
+ </td>
1801
+ </tr>
1802
+ <tr>
1803
+ <td><p><span class="term"><em class="parameter"><code>mapping</code></em> :</span></p></td>
1804
+ <td>the function to map the value in the settings database to
1805
+ the value used by the application
1806
+ </td>
1807
+ </tr>
1808
+ <tr>
1809
+ <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1810
+ <td>user data for <em class="parameter"><code>mapping</code></em>
1811
+ </td>
1812
+ </tr>
1813
+ <tr>
1814
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1815
+ <td>the result, which may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1816
+ </td>
1817
+ </tr>
1818
+ </tbody>
1819
+ </table></div>
1820
+ </div>
1821
+ <hr>
1822
+ <div class="refsect2">
1823
+ <a name="GSettingsBindFlags"></a><h3>enum GSettingsBindFlags</h3>
1824
+ <pre class="programlisting">typedef enum
1825
+ {
1826
+ G_SETTINGS_BIND_DEFAULT,
1827
+ G_SETTINGS_BIND_GET = (1&lt;&lt;0),
1828
+ G_SETTINGS_BIND_SET = (1&lt;&lt;1),
1829
+ G_SETTINGS_BIND_NO_SENSITIVITY = (1&lt;&lt;2),
1830
+ G_SETTINGS_BIND_GET_NO_CHANGES = (1&lt;&lt;3),
1831
+ G_SETTINGS_BIND_INVERT_BOOLEAN = (1&lt;&lt;4)
1832
+ } GSettingsBindFlags;
1833
+ </pre>
1834
+ <p>
1835
+ Flags used when creating a binding. These flags determine in which
1836
+ direction the binding works. The default is to synchronize in both
1837
+ directions.
1838
+ </p>
1839
+ <div class="variablelist"><table border="0">
1840
+ <col align="left" valign="top">
1841
+ <tbody>
1842
+ <tr>
1843
+ <td><p><a name="G-SETTINGS-BIND-DEFAULT:CAPS"></a><span class="term"><code class="literal">G_SETTINGS_BIND_DEFAULT</code></span></p></td>
1844
+ <td>Equivalent to <code class="literal">G_SETTINGS_BIND_GET|G_SETTINGS_BIND_SET</code>
1845
+ </td>
1846
+ </tr>
1847
+ <tr>
1848
+ <td><p><a name="G-SETTINGS-BIND-GET:CAPS"></a><span class="term"><code class="literal">G_SETTINGS_BIND_GET</code></span></p></td>
1849
+ <td>Update the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> property when the setting changes.
1850
+ It is an error to use this flag if the property is not writable.
1851
+ </td>
1852
+ </tr>
1853
+ <tr>
1854
+ <td><p><a name="G-SETTINGS-BIND-SET:CAPS"></a><span class="term"><code class="literal">G_SETTINGS_BIND_SET</code></span></p></td>
1855
+ <td>Update the setting when the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> property changes.
1856
+ It is an error to use this flag if the property is not readable.
1857
+ </td>
1858
+ </tr>
1859
+ <tr>
1860
+ <td><p><a name="G-SETTINGS-BIND-NO-SENSITIVITY:CAPS"></a><span class="term"><code class="literal">G_SETTINGS_BIND_NO_SENSITIVITY</code></span></p></td>
1861
+ <td>Do not try to bind a "sensitivity" property to the writability of the setting
1862
+ </td>
1863
+ </tr>
1864
+ <tr>
1865
+ <td><p><a name="G-SETTINGS-BIND-GET-NO-CHANGES:CAPS"></a><span class="term"><code class="literal">G_SETTINGS_BIND_GET_NO_CHANGES</code></span></p></td>
1866
+ <td>When set in addition to <a class="link" href="GSettings.html#G-SETTINGS-BIND-GET:CAPS"><span class="type">G_SETTINGS_BIND_GET</span></a>, set the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> property
1867
+ value initially from the setting, but do not listen for changes of the setting
1868
+ </td>
1869
+ </tr>
1870
+ <tr>
1871
+ <td><p><a name="G-SETTINGS-BIND-INVERT-BOOLEAN:CAPS"></a><span class="term"><code class="literal">G_SETTINGS_BIND_INVERT_BOOLEAN</code></span></p></td>
1872
+ <td>When passed to <a class="link" href="GSettings.html#g-settings-bind" title="g_settings_bind ()"><code class="function">g_settings_bind()</code></a>, uses a pair of mapping functions that invert
1873
+ the boolean value when mapping between the setting and the property. The setting and property must both
1874
+ be booleans. You can not pass this flag to <a class="link" href="GSettings.html#g-settings-bind-with-mapping" title="g_settings_bind_with_mapping ()"><code class="function">g_settings_bind_with_mapping()</code></a>.
1875
+ </td>
1876
+ </tr>
1877
+ </tbody>
1878
+ </table></div>
1879
+ </div>
1880
+ <hr>
1881
+ <div class="refsect2">
1882
+ <a name="g-settings-bind"></a><h3>g_settings_bind ()</h3>
1883
+ <pre class="programlisting"><span class="returnvalue">void</span> g_settings_bind (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1884
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
1885
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> object</code></em>,
1886
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property</code></em>,
1887
+ <em class="parameter"><code><a class="link" href="GSettings.html#GSettingsBindFlags" title="enum GSettingsBindFlags"><span class="type">GSettingsBindFlags</span></a> flags</code></em>);</pre>
1888
+ <p>
1889
+ Create a binding between the <em class="parameter"><code>key</code></em> in the <em class="parameter"><code>settings</code></em> object
1890
+ and the property <em class="parameter"><code>property</code></em> of <em class="parameter"><code>object</code></em>.
1891
+ </p>
1892
+ <p>
1893
+ The binding uses the default GIO mapping functions to map
1894
+ between the settings and property values. These functions
1895
+ handle booleans, numeric types and string types in a
1896
+ straightforward way. Use <a class="link" href="GSettings.html#g-settings-bind-with-mapping" title="g_settings_bind_with_mapping ()"><code class="function">g_settings_bind_with_mapping()</code></a> if
1897
+ you need a custom mapping, or map between types that are not
1898
+ supported by the default mapping functions.
1899
+ </p>
1900
+ <p>
1901
+ Unless the <em class="parameter"><code>flags</code></em> include <a class="link" href="GSettings.html#G-SETTINGS-BIND-NO-SENSITIVITY:CAPS"><code class="literal">G_SETTINGS_BIND_NO_SENSITIVITY</code></a>, this
1902
+ function also establishes a binding between the writability of
1903
+ <em class="parameter"><code>key</code></em> and the "sensitive" property of <em class="parameter"><code>object</code></em> (if <em class="parameter"><code>object</code></em> has
1904
+ a boolean property by that name). See <a class="link" href="GSettings.html#g-settings-bind-writable" title="g_settings_bind_writable ()"><code class="function">g_settings_bind_writable()</code></a>
1905
+ for more details about writable bindings.
1906
+ </p>
1907
+ <p>
1908
+ Note that the lifecycle of the binding is tied to the object,
1909
+ and that you can have only one binding per object property.
1910
+ If you bind the same property twice on the same object, the second
1911
+ binding overrides the first one.
1912
+ </p>
1913
+ <div class="variablelist"><table border="0">
1914
+ <col align="left" valign="top">
1915
+ <tbody>
1916
+ <tr>
1917
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1918
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1919
+ </td>
1920
+ </tr>
1921
+ <tr>
1922
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1923
+ <td>the key to bind
1924
+ </td>
1925
+ </tr>
1926
+ <tr>
1927
+ <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
1928
+ <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>
1929
+ </td>
1930
+ </tr>
1931
+ <tr>
1932
+ <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
1933
+ <td>the name of the property to bind
1934
+ </td>
1935
+ </tr>
1936
+ <tr>
1937
+ <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
1938
+ <td>flags for the binding
1939
+ </td>
1940
+ </tr>
1941
+ </tbody>
1942
+ </table></div>
1943
+ <p class="since">Since 2.26</p>
1944
+ </div>
1945
+ <hr>
1946
+ <div class="refsect2">
1947
+ <a name="g-settings-bind-with-mapping"></a><h3>g_settings_bind_with_mapping ()</h3>
1948
+ <pre class="programlisting"><span class="returnvalue">void</span> g_settings_bind_with_mapping (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
1949
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
1950
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> object</code></em>,
1951
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property</code></em>,
1952
+ <em class="parameter"><code><a class="link" href="GSettings.html#GSettingsBindFlags" title="enum GSettingsBindFlags"><span class="type">GSettingsBindFlags</span></a> flags</code></em>,
1953
+ <em class="parameter"><code><a class="link" href="GSettings.html#GSettingsBindGetMapping" title="GSettingsBindGetMapping ()"><span class="type">GSettingsBindGetMapping</span></a> get_mapping</code></em>,
1954
+ <em class="parameter"><code><a class="link" href="GSettings.html#GSettingsBindSetMapping" title="GSettingsBindSetMapping ()"><span class="type">GSettingsBindSetMapping</span></a> set_mapping</code></em>,
1955
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
1956
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);</pre>
1957
+ <p>
1958
+ Create a binding between the <em class="parameter"><code>key</code></em> in the <em class="parameter"><code>settings</code></em> object
1959
+ and the property <em class="parameter"><code>property</code></em> of <em class="parameter"><code>object</code></em>.
1960
+ </p>
1961
+ <p>
1962
+ The binding uses the provided mapping functions to map between
1963
+ settings and property values.
1964
+ </p>
1965
+ <p>
1966
+ Note that the lifecycle of the binding is tied to the object,
1967
+ and that you can have only one binding per object property.
1968
+ If you bind the same property twice on the same object, the second
1969
+ binding overrides the first one.
1970
+ </p>
1971
+ <div class="variablelist"><table border="0">
1972
+ <col align="left" valign="top">
1973
+ <tbody>
1974
+ <tr>
1975
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
1976
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
1977
+ </td>
1978
+ </tr>
1979
+ <tr>
1980
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1981
+ <td>the key to bind
1982
+ </td>
1983
+ </tr>
1984
+ <tr>
1985
+ <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
1986
+ <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>
1987
+ </td>
1988
+ </tr>
1989
+ <tr>
1990
+ <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
1991
+ <td>the name of the property to bind
1992
+ </td>
1993
+ </tr>
1994
+ <tr>
1995
+ <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
1996
+ <td>flags for the binding
1997
+ </td>
1998
+ </tr>
1999
+ <tr>
2000
+ <td><p><span class="term"><em class="parameter"><code>get_mapping</code></em> :</span></p></td>
2001
+ <td>a function that gets called to convert values
2002
+ from <em class="parameter"><code>settings</code></em> to <em class="parameter"><code>object</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to use the default GIO mapping
2003
+ </td>
2004
+ </tr>
2005
+ <tr>
2006
+ <td><p><span class="term"><em class="parameter"><code>set_mapping</code></em> :</span></p></td>
2007
+ <td>a function that gets called to convert values
2008
+ from <em class="parameter"><code>object</code></em> to <em class="parameter"><code>settings</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to use the default GIO mapping
2009
+ </td>
2010
+ </tr>
2011
+ <tr>
2012
+ <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2013
+ <td>data that gets passed to <em class="parameter"><code>get_mapping</code></em> and <em class="parameter"><code>set_mapping</code></em>
2014
+ </td>
2015
+ </tr>
2016
+ <tr>
2017
+ <td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
2018
+ <td>
2019
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> function for <em class="parameter"><code>user_data</code></em>
2020
+ </td>
2021
+ </tr>
2022
+ </tbody>
2023
+ </table></div>
2024
+ <p class="since">Since 2.26</p>
2025
+ </div>
2026
+ <hr>
2027
+ <div class="refsect2">
2028
+ <a name="g-settings-bind-writable"></a><h3>g_settings_bind_writable ()</h3>
2029
+ <pre class="programlisting"><span class="returnvalue">void</span> g_settings_bind_writable (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
2030
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
2031
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> object</code></em>,
2032
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property</code></em>,
2033
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> inverted</code></em>);</pre>
2034
+ <p>
2035
+ Create a binding between the writability of <em class="parameter"><code>key</code></em> in the
2036
+ <em class="parameter"><code>settings</code></em> object and the property <em class="parameter"><code>property</code></em> of <em class="parameter"><code>object</code></em>.
2037
+ The property must be boolean; "sensitive" or "visible"
2038
+ properties of widgets are the most likely candidates.
2039
+ </p>
2040
+ <p>
2041
+ Writable bindings are always uni-directional; changes of the
2042
+ writability of the setting will be propagated to the object
2043
+ property, not the other way.
2044
+ </p>
2045
+ <p>
2046
+ When the <em class="parameter"><code>inverted</code></em> argument is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the binding inverts the
2047
+ value as it passes from the setting to the object, i.e. <em class="parameter"><code>property</code></em>
2048
+ will be set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the key is <span class="emphasis"><em>not</em></span>
2049
+ writable.
2050
+ </p>
2051
+ <p>
2052
+ Note that the lifecycle of the binding is tied to the object,
2053
+ and that you can have only one binding per object property.
2054
+ If you bind the same property twice on the same object, the second
2055
+ binding overrides the first one.
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>settings</code></em> :</span></p></td>
2062
+ <td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
2063
+ </td>
2064
+ </tr>
2065
+ <tr>
2066
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
2067
+ <td>the key to bind
2068
+ </td>
2069
+ </tr>
2070
+ <tr>
2071
+ <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
2072
+ <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>
2073
+ </td>
2074
+ </tr>
2075
+ <tr>
2076
+ <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
2077
+ <td>the name of a boolean property to bind
2078
+ </td>
2079
+ </tr>
2080
+ <tr>
2081
+ <td><p><span class="term"><em class="parameter"><code>inverted</code></em> :</span></p></td>
2082
+ <td>whether to 'invert' the value
2083
+ </td>
2084
+ </tr>
2085
+ </tbody>
2086
+ </table></div>
2087
+ <p class="since">Since 2.26</p>
2088
+ </div>
2089
+ <hr>
2090
+ <div class="refsect2">
2091
+ <a name="g-settings-unbind"></a><h3>g_settings_unbind ()</h3>
2092
+ <pre class="programlisting"><span class="returnvalue">void</span> g_settings_unbind (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> object</code></em>,
2093
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property</code></em>);</pre>
2094
+ <p>
2095
+ Removes an existing binding for <em class="parameter"><code>property</code></em> on <em class="parameter"><code>object</code></em>.
2096
+ </p>
2097
+ <p>
2098
+ Note that bindings are automatically removed when the
2099
+ object is finalized, so it is rarely necessary to call this
2100
+ function.
2101
+ </p>
2102
+ <div class="variablelist"><table border="0">
2103
+ <col align="left" valign="top">
2104
+ <tbody>
2105
+ <tr>
2106
+ <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
2107
+ <td>the object
2108
+ </td>
2109
+ </tr>
2110
+ <tr>
2111
+ <td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
2112
+ <td>the property whose binding is removed
2113
+ </td>
2114
+ </tr>
2115
+ </tbody>
2116
+ </table></div>
2117
+ <p class="since">Since 2.26</p>
2118
+ </div>
2119
+ <hr>
2120
+ <div class="refsect2">
2121
+ <a name="GSettingsBindSetMapping"></a><h3>GSettingsBindSetMapping ()</h3>
2122
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> * (*GSettingsBindSetMapping) (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
2123
+ <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a> *expected_type</code></em>,
2124
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2125
+ <p>
2126
+ The type for the function that is used to convert an object property
2127
+ value to a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> for storing it in <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a>.
2128
+ </p>
2129
+ <div class="variablelist"><table border="0">
2130
+ <col align="left" valign="top">
2131
+ <tbody>
2132
+ <tr>
2133
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2134
+ <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> containing the property value to map
2135
+ </td>
2136
+ </tr>
2137
+ <tr>
2138
+ <td><p><span class="term"><em class="parameter"><code>expected_type</code></em> :</span></p></td>
2139
+ <td>the <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a> to create
2140
+ </td>
2141
+ </tr>
2142
+ <tr>
2143
+ <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2144
+ <td>user data that was specified when the binding was created
2145
+ </td>
2146
+ </tr>
2147
+ <tr>
2148
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2149
+ <td>a new <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> holding the data from <em class="parameter"><code>value</code></em>,
2150
+ or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case of an error
2151
+ </td>
2152
+ </tr>
2153
+ </tbody>
2154
+ </table></div>
2155
+ </div>
2156
+ <hr>
2157
+ <div class="refsect2">
2158
+ <a name="GSettingsBindGetMapping"></a><h3>GSettingsBindGetMapping ()</h3>
2159
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (*GSettingsBindGetMapping) (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
2160
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *variant</code></em>,
2161
+ <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
2162
+ <p>
2163
+ The type for the function that is used to convert from <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> to
2164
+ an object property. The <em class="parameter"><code>value</code></em> is already initialized to hold values
2165
+ of the appropriate type.
2166
+ </p>
2167
+ <div class="variablelist"><table border="0">
2168
+ <col align="left" valign="top">
2169
+ <tbody>
2170
+ <tr>
2171
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2172
+ <td>return location for the property value
2173
+ </td>
2174
+ </tr>
2175
+ <tr>
2176
+ <td><p><span class="term"><em class="parameter"><code>variant</code></em> :</span></p></td>
2177
+ <td>the <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a>
2178
+ </td>
2179
+ </tr>
2180
+ <tr>
2181
+ <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2182
+ <td>user data that was specified when the binding was created
2183
+ </td>
2184
+ </tr>
2185
+ <tr>
2186
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2187
+ <td>
2188
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the conversion succeeded, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> in case of an error
2189
+ </td>
2190
+ </tr>
2191
+ </tbody>
2192
+ </table></div>
2193
+ </div>
2194
+ </div>
2195
+ <div class="refsect1">
2196
+ <a name="GSettings.property-details"></a><h2>Property Details</h2>
2197
+ <div class="refsect2">
2198
+ <a name="GSettings--backend"></a><h3>The <code class="literal">"backend"</code> property</h3>
2199
+ <pre class="programlisting"> "backend" <a class="link" href="GSettingsBackend.html" title="GSettingsBackend"><span class="type">GSettingsBackend</span></a>* : Read / Write / Construct Only</pre>
2200
+ <p>The GSettingsBackend for this settings object.</p>
2201
+ </div>
2202
+ <hr>
2203
+ <div class="refsect2">
2204
+ <a name="GSettings--has-unapplied"></a><h3>The <code class="literal">"has-unapplied"</code> property</h3>
2205
+ <pre class="programlisting"> "has-unapplied" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read</pre>
2206
+ <p>
2207
+ If this property is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object has outstanding
2208
+ changes that will be applied when <a class="link" href="GSettings.html#g-settings-apply" title="g_settings_apply ()"><code class="function">g_settings_apply()</code></a> is called.
2209
+ </p>
2210
+ <p>Default value: FALSE</p>
2211
+ </div>
2212
+ <hr>
2213
+ <div class="refsect2">
2214
+ <a name="GSettings--path"></a><h3>The <code class="literal">"path"</code> property</h3>
2215
+ <pre class="programlisting"> "path" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write / Construct Only</pre>
2216
+ <p>
2217
+ The path within the backend where the settings are stored.
2218
+ </p>
2219
+ <p>Default value: NULL</p>
2220
+ </div>
2221
+ <hr>
2222
+ <div class="refsect2">
2223
+ <a name="GSettings--schema"></a><h3>The <code class="literal">"schema"</code> property</h3>
2224
+ <pre class="programlisting"> "schema" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write / Construct Only</pre>
2225
+ <p>
2226
+ The name of the schema that describes the types of keys
2227
+ for this <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object.
2228
+ </p>
2229
+ <p>Default value: NULL</p>
2230
+ </div>
2231
+ </div>
2232
+ <div class="refsect1">
2233
+ <a name="GSettings.signal-details"></a><h2>Signal Details</h2>
2234
+ <div class="refsect2">
2235
+ <a name="GSettings-change-event"></a><h3>The <code class="literal">"change-event"</code> signal</h3>
2236
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> user_function (<a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings,
2237
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> keys,
2238
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_keys,
2239
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last</pre>
2240
+ <p>
2241
+ The "change-event" signal is emitted once per change event that
2242
+ affects this settings object. You should connect to this signal
2243
+ only if you are interested in viewing groups of changes before they
2244
+ are split out into multiple emissions of the "changed" signal.
2245
+ For most use cases it is more appropriate to use the "changed" signal.
2246
+ </p>
2247
+ <p>
2248
+ In the event that the change event applies to one or more specified
2249
+ keys, <em class="parameter"><code>keys</code></em> will be an array of <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> of length <em class="parameter"><code>n_keys</code></em>. In the
2250
+ event that the change event applies to the <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object as a
2251
+ whole (ie: potentially every key has been changed) then <em class="parameter"><code>keys</code></em> will
2252
+ be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and <em class="parameter"><code>n_keys</code></em> will be 0.
2253
+ </p>
2254
+ <p>
2255
+ The default handler for this signal invokes the "changed" signal
2256
+ for each affected key. If any other connected handler returns
2257
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> then this default functionality will be supressed.
2258
+ </p>
2259
+ <div class="variablelist"><table border="0">
2260
+ <col align="left" valign="top">
2261
+ <tbody>
2262
+ <tr>
2263
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
2264
+ <td>the object on which the signal was emitted
2265
+ </td>
2266
+ </tr>
2267
+ <tr>
2268
+ <td><p><span class="term"><em class="parameter"><code>keys</code></em> :</span></p></td>
2269
+ <td>an array of <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a>s for the changed keys, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2270
+ </td>
2271
+ </tr>
2272
+ <tr>
2273
+ <td><p><span class="term"><em class="parameter"><code>n_keys</code></em> :</span></p></td>
2274
+ <td>the length of the <em class="parameter"><code>keys</code></em> array, or 0
2275
+ </td>
2276
+ </tr>
2277
+ <tr>
2278
+ <td><p><span class="term"><em class="parameter"><code>returns</code></em> :</span></p></td>
2279
+ <td>
2280
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked for the
2281
+ event. FALSE to propagate the event further.
2282
+ </td>
2283
+ </tr>
2284
+ <tr>
2285
+ <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2286
+ <td>user data set when the signal handler was connected.</td>
2287
+ </tr>
2288
+ </tbody>
2289
+ </table></div>
2290
+ </div>
2291
+ <hr>
2292
+ <div class="refsect2">
2293
+ <a name="GSettings-changed"></a><h3>The <code class="literal">"changed"</code> signal</h3>
2294
+ <pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings,
2295
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key,
2296
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
2297
+ <p>
2298
+ The "changed" signal is emitted when a key has potentially changed.
2299
+ You should call one of the <a class="link" href="GSettings.html#g-settings-get" title="g_settings_get ()"><code class="function">g_settings_get()</code></a> calls to check the new
2300
+ value.
2301
+ </p>
2302
+ <p>
2303
+ This signal supports detailed connections. You can connect to the
2304
+ detailed signal "changed::x" in order to only receive callbacks
2305
+ when key "x" changes.
2306
+ </p>
2307
+ <div class="variablelist"><table border="0">
2308
+ <col align="left" valign="top">
2309
+ <tbody>
2310
+ <tr>
2311
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
2312
+ <td>the object on which the signal was emitted
2313
+ </td>
2314
+ </tr>
2315
+ <tr>
2316
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
2317
+ <td>the name of the key that changed
2318
+ </td>
2319
+ </tr>
2320
+ <tr>
2321
+ <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2322
+ <td>user data set when the signal handler was connected.</td>
2323
+ </tr>
2324
+ </tbody>
2325
+ </table></div>
2326
+ </div>
2327
+ <hr>
2328
+ <div class="refsect2">
2329
+ <a name="GSettings-writable-change-event"></a><h3>The <code class="literal">"writable-change-event"</code> signal</h3>
2330
+ <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> user_function (<a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings,
2331
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> key,
2332
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last</pre>
2333
+ <p>
2334
+ The "writable-change-event" signal is emitted once per writability
2335
+ change event that affects this settings object. You should connect
2336
+ to this signal if you are interested in viewing groups of changes
2337
+ before they are split out into multiple emissions of the
2338
+ "writable-changed" signal. For most use cases it is more
2339
+ appropriate to use the "writable-changed" signal.
2340
+ </p>
2341
+ <p>
2342
+ In the event that the writability change applies only to a single
2343
+ key, <em class="parameter"><code>key</code></em> will be set to the <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> for that key. In the event
2344
+ that the writability change affects the entire settings object,
2345
+ <em class="parameter"><code>key</code></em> will be 0.
2346
+ </p>
2347
+ <p>
2348
+ The default handler for this signal invokes the "writable-changed"
2349
+ and "changed" signals for each affected key. This is done because
2350
+ changes in writability might also imply changes in value (if for
2351
+ example, a new mandatory setting is introduced). If any other
2352
+ connected handler returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> then this default functionality
2353
+ will be supressed.
2354
+ </p>
2355
+ <div class="variablelist"><table border="0">
2356
+ <col align="left" valign="top">
2357
+ <tbody>
2358
+ <tr>
2359
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
2360
+ <td>the object on which the signal was emitted
2361
+ </td>
2362
+ </tr>
2363
+ <tr>
2364
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
2365
+ <td>the quark of the key, or 0
2366
+ </td>
2367
+ </tr>
2368
+ <tr>
2369
+ <td><p><span class="term"><em class="parameter"><code>returns</code></em> :</span></p></td>
2370
+ <td>
2371
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked for the
2372
+ event. FALSE to propagate the event further.
2373
+ </td>
2374
+ </tr>
2375
+ <tr>
2376
+ <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2377
+ <td>user data set when the signal handler was connected.</td>
2378
+ </tr>
2379
+ </tbody>
2380
+ </table></div>
2381
+ </div>
2382
+ <hr>
2383
+ <div class="refsect2">
2384
+ <a name="GSettings-writable-changed"></a><h3>The <code class="literal">"writable-changed"</code> signal</h3>
2385
+ <pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings,
2386
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key,
2387
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last / Has Details</pre>
2388
+ <p>
2389
+ The "writable-changed" signal is emitted when the writability of a
2390
+ key has potentially changed. You should call
2391
+ <a class="link" href="GSettings.html#g-settings-is-writable" title="g_settings_is_writable ()"><code class="function">g_settings_is_writable()</code></a> in order to determine the new status.
2392
+ </p>
2393
+ <p>
2394
+ This signal supports detailed connections. You can connect to the
2395
+ detailed signal "writable-changed::x" in order to only receive
2396
+ callbacks when the writability of "x" changes.
2397
+ </p>
2398
+ <div class="variablelist"><table border="0">
2399
+ <col align="left" valign="top">
2400
+ <tbody>
2401
+ <tr>
2402
+ <td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
2403
+ <td>the object on which the signal was emitted
2404
+ </td>
2405
+ </tr>
2406
+ <tr>
2407
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
2408
+ <td>the key
2409
+ </td>
2410
+ </tr>
2411
+ <tr>
2412
+ <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2413
+ <td>user data set when the signal handler was connected.</td>
2414
+ </tr>
2415
+ </tbody>
2416
+ </table></div>
2417
+ </div>
2418
+ </div>
2419
+ </div>
2420
+ <div class="footer">
2421
+ <hr>
2422
+ Generated by GTK-Doc V1.15.1</div>
2423
+ </body>
2424
+ </html>