glib2 0.90.8-x86-mingw32 → 0.90.9-x86-mingw32
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/ChangeLog +46 -0
- data/Rakefile +1 -0
- data/ext/glib2/rbglib.h +1 -1
- data/ext/glib2/rbglib_iochannel.c +15 -6
- data/ext/glib2/rbgobj_signal.c +1 -1
- data/ext/glib2/rbgobject.h +1 -1
- data/lib/1.8/glib2.so +0 -0
- data/lib/1.9/glib2.so +0 -0
- data/lib/gnome2-raketask.rb +3 -2
- data/lib/mkmf-gnome2.rb +47 -23
- data/test/glib-test-init.rb +1 -3
- data/vendor/local/bin/glib-genmarshal.exe +0 -0
- data/vendor/local/bin/glib-gettextize +2 -2
- data/vendor/local/bin/glib-mkenums +3 -2
- data/vendor/local/bin/gobject-query.exe +0 -0
- data/vendor/local/bin/gspawn-win32-helper-console.exe +0 -0
- data/vendor/local/bin/gspawn-win32-helper.exe +0 -0
- data/vendor/local/bin/libgio-2.0-0.dll +0 -0
- data/vendor/local/bin/libglib-2.0-0.dll +0 -0
- data/vendor/local/bin/libgmodule-2.0-0.dll +0 -0
- data/vendor/local/bin/libgobject-2.0-0.dll +0 -0
- data/vendor/local/bin/libgthread-2.0-0.dll +0 -0
- data/vendor/local/include/glib-2.0/gio/gaction.h +91 -0
- data/vendor/local/include/glib-2.0/gio/gactiongroup.h +151 -0
- data/vendor/local/include/glib-2.0/gio/gappinfo.h +11 -1
- data/vendor/local/include/glib-2.0/gio/gapplication.h +165 -0
- data/vendor/local/include/glib-2.0/gio/gapplicationcommandline.h +118 -0
- data/vendor/local/include/glib-2.0/gio/gasyncresult.h +2 -2
- data/vendor/local/include/glib-2.0/gio/gcancellable.h +2 -0
- data/vendor/local/include/glib-2.0/gio/gemblemedicon.h +15 -0
- data/vendor/local/include/glib-2.0/gio/gfileenumerator.h +2 -2
- data/vendor/local/include/glib-2.0/gio/gfileinputstream.h +1 -1
- data/vendor/local/include/glib-2.0/gio/gfileiostream.h +1 -1
- data/vendor/local/include/glib-2.0/gio/gfilemonitor.h +1 -1
- data/vendor/local/include/glib-2.0/gio/gfileoutputstream.h +1 -1
- data/vendor/local/include/glib-2.0/gio/gio.h +14 -0
- data/vendor/local/include/glib-2.0/gio/gioenums.h +158 -2
- data/vendor/local/include/glib-2.0/gio/gioenumtypes.h +12 -0
- data/vendor/local/include/glib-2.0/gio/giomodule.h +1 -1
- data/vendor/local/include/glib-2.0/gio/giostream.h +11 -0
- data/vendor/local/include/glib-2.0/gio/giotypes.h +48 -0
- data/vendor/local/include/glib-2.0/gio/goutputstream.h +1 -1
- data/vendor/local/include/glib-2.0/gio/gpollableinputstream.h +101 -0
- data/vendor/local/include/glib-2.0/gio/gpollableoutputstream.h +98 -0
- data/vendor/local/include/glib-2.0/gio/gsettings.h +9 -2
- data/vendor/local/include/glib-2.0/gio/gsettingsbackend.h +6 -0
- data/vendor/local/include/glib-2.0/gio/gsimpleaction.h +95 -0
- data/vendor/local/include/glib-2.0/gio/gsimpleactiongroup.h +87 -0
- data/vendor/local/include/glib-2.0/gio/gsimpleasyncresult.h +11 -1
- data/vendor/local/include/glib-2.0/gio/gsocketclient.h +7 -0
- data/vendor/local/include/glib-2.0/gio/gtcpwrapperconnection.h +68 -0
- data/vendor/local/include/glib-2.0/gio/gtlsbackend.h +92 -0
- data/vendor/local/include/glib-2.0/gio/gtlscertificate.h +83 -0
- data/vendor/local/include/glib-2.0/gio/gtlsclientconnection.h +72 -0
- data/vendor/local/include/glib-2.0/gio/gtlsconnection.h +136 -0
- data/vendor/local/include/glib-2.0/gio/gtlsserverconnection.h +61 -0
- data/vendor/local/include/glib-2.0/glib/glist.h +2 -0
- data/vendor/local/include/glib-2.0/glib/gmain.h +27 -6
- data/vendor/local/include/glib-2.0/glib/gmarkup.h +80 -5
- data/vendor/local/include/glib-2.0/glib/grand.h +1 -1
- data/vendor/local/include/glib-2.0/glib/gsequence.h +8 -0
- data/vendor/local/include/glib-2.0/glib/gslist.h +2 -0
- data/vendor/local/include/glib-2.0/glib/gtimezone.h +37 -0
- data/vendor/local/include/glib-2.0/glib/gtypes.h +1 -0
- data/vendor/local/include/glib-2.0/glib/gunicode.h +22 -16
- data/vendor/local/include/glib-2.0/glib/gutils.h +5 -0
- data/vendor/local/include/glib-2.0/glib/gvariant.h +35 -11
- data/vendor/local/include/glib-2.0/gobject/gobject.h +15 -0
- data/vendor/local/include/glib-2.0/gobject/gsignal.h +5 -0
- data/vendor/local/include/glib-2.0/gobject/gsourceclosure.h +4 -2
- data/vendor/local/include/glib-2.0/gobject/gtypemodule.h +1 -1
- data/vendor/local/lib/gio-2.0.def +142 -0
- data/vendor/local/lib/gio-2.0.lib +0 -0
- data/vendor/local/lib/glib-2.0.def +21 -0
- data/vendor/local/lib/glib-2.0.lib +0 -0
- data/vendor/local/lib/glib-2.0/include/glibconfig.h +1 -1
- data/vendor/local/lib/gmodule-2.0.lib +0 -0
- data/vendor/local/lib/gobject-2.0.def +3 -0
- data/vendor/local/lib/gobject-2.0.lib +0 -0
- data/vendor/local/lib/gthread-2.0.lib +0 -0
- data/vendor/local/lib/libgio-2.0.dll.a +0 -0
- data/vendor/local/lib/libglib-2.0.dll.a +0 -0
- data/vendor/local/lib/libgmodule-2.0.dll.a +0 -0
- data/vendor/local/lib/libgobject-2.0.dll.a +0 -0
- data/vendor/local/lib/libgthread-2.0.dll.a +0 -0
- data/vendor/local/lib/pkgconfig/gio-2.0.pc +2 -2
- data/vendor/local/lib/pkgconfig/gio-windows-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/glib-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gmodule-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gmodule-no-export-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gobject-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gthread-2.0.pc +1 -1
- data/vendor/local/manifest/{glib-dev_2.26.1-1_win32.mft → glib-dev_2.28.1-1_win32.mft} +55 -19
- data/vendor/local/manifest/{glib_2.26.1-1_win32.mft → glib_2.28.1-1_win32.mft} +3 -2
- data/vendor/local/share/aclocal/glib-2.0.m4 +4 -4
- data/vendor/local/share/doc/{glib-2.26.1 → glib-2.28.1}/COPYING +0 -0
- data/vendor/local/share/doc/{glib-dev-2.26.1 → glib-dev-2.28.1}/COPYING +0 -0
- data/vendor/local/share/glib-2.0/gettext/mkinstalldirs +72 -21
- data/vendor/local/share/glib-2.0/schemas/gschema.dtd +21 -8
- data/vendor/local/share/gtk-doc/html/gio/GAction.html +469 -0
- data/vendor/local/share/gtk-doc/html/gio/GActionGroup.html +754 -0
- data/vendor/local/share/gtk-doc/html/gio/GAppInfo.html +296 -249
- data/vendor/local/share/gtk-doc/html/gio/GApplication.html +1458 -0
- data/vendor/local/share/gtk-doc/html/gio/GApplicationCommandLine.html +815 -0
- data/vendor/local/share/gtk-doc/html/gio/GAsyncInitable.html +61 -97
- data/vendor/local/share/gtk-doc/html/gio/GAsyncResult.html +31 -38
- data/vendor/local/share/gtk-doc/html/gio/GBufferedInputStream.html +52 -68
- data/vendor/local/share/gtk-doc/html/gio/GBufferedOutputStream.html +38 -50
- data/vendor/local/share/gtk-doc/html/gio/GCancellable.html +120 -77
- data/vendor/local/share/gtk-doc/html/gio/GCharsetConverter.html +26 -34
- data/vendor/local/share/gtk-doc/html/gio/GConverter.html +49 -51
- data/vendor/local/share/gtk-doc/html/gio/GCredentials.html +39 -62
- data/vendor/local/share/gtk-doc/html/gio/GDBusAuthObserver.html +26 -35
- data/vendor/local/share/gtk-doc/html/gio/GDBusConnection.html +415 -650
- data/vendor/local/share/gtk-doc/html/gio/{gio-GDBusError.html → GDBusError.html} +118 -147
- data/vendor/local/share/gtk-doc/html/gio/GDBusMessage.html +204 -347
- data/vendor/local/share/gtk-doc/html/gio/GDBusMethodInvocation.html +66 -111
- data/vendor/local/share/gtk-doc/html/gio/GDBusProxy.html +210 -309
- data/vendor/local/share/gtk-doc/html/gio/GDBusServer.html +68 -87
- data/vendor/local/share/gtk-doc/html/gio/GDataInputStream.html +190 -232
- data/vendor/local/share/gtk-doc/html/gio/GDataOutputStream.html +89 -118
- data/vendor/local/share/gtk-doc/html/gio/GDrive.html +196 -270
- data/vendor/local/share/gtk-doc/html/gio/GEmblem.html +40 -46
- data/vendor/local/share/gtk-doc/html/gio/GEmblemedIcon.html +56 -24
- data/vendor/local/share/gtk-doc/html/gio/GFile.html +1090 -1443
- data/vendor/local/share/gtk-doc/html/gio/GFileDescriptorBased.html +13 -16
- data/vendor/local/share/gtk-doc/html/gio/GFileEnumerator.html +66 -86
- data/vendor/local/share/gtk-doc/html/gio/GFileIOStream.html +31 -45
- data/vendor/local/share/gtk-doc/html/gio/GFileIcon.html +19 -21
- data/vendor/local/share/gtk-doc/html/gio/GFileInfo.html +466 -602
- data/vendor/local/share/gtk-doc/html/gio/GFileInputStream.html +32 -40
- data/vendor/local/share/gtk-doc/html/gio/GFileMonitor.html +60 -59
- data/vendor/local/share/gtk-doc/html/gio/GFileOutputStream.html +32 -47
- data/vendor/local/share/gtk-doc/html/gio/GFilenameCompleter.html +37 -45
- data/vendor/local/share/gtk-doc/html/gio/GFilterInputStream.html +22 -26
- data/vendor/local/share/gtk-doc/html/gio/GFilterOutputStream.html +22 -26
- data/vendor/local/share/gtk-doc/html/gio/GIOModule.html +32 -38
- data/vendor/local/share/gtk-doc/html/gio/GIOStream.html +184 -52
- data/vendor/local/share/gtk-doc/html/gio/GIcon.html +45 -54
- data/vendor/local/share/gtk-doc/html/gio/GInetAddress.html +96 -125
- data/vendor/local/share/gtk-doc/html/gio/GInetSocketAddress.html +21 -25
- data/vendor/local/share/gtk-doc/html/gio/GInitable.html +49 -71
- data/vendor/local/share/gtk-doc/html/gio/GInputStream.html +102 -134
- data/vendor/local/share/gtk-doc/html/gio/GLoadableIcon.html +43 -54
- data/vendor/local/share/gtk-doc/html/gio/GMemoryInputStream.html +21 -24
- data/vendor/local/share/gtk-doc/html/gio/GMemoryOutputStream.html +34 -41
- data/vendor/local/share/gtk-doc/html/gio/GMount.html +223 -294
- data/vendor/local/share/gtk-doc/html/gio/GMountOperation.html +127 -153
- data/vendor/local/share/gtk-doc/html/gio/GNetworkAddress.html +35 -46
- data/vendor/local/share/gtk-doc/html/gio/GNetworkService.html +37 -46
- data/vendor/local/share/gtk-doc/html/gio/GOutputStream.html +138 -174
- data/vendor/local/share/gtk-doc/html/gio/GPermission.html +46 -68
- data/vendor/local/share/gtk-doc/html/gio/GPollableInputStream.html +398 -0
- data/vendor/local/share/gtk-doc/html/gio/GPollableOutputStream.html +340 -0
- data/vendor/local/share/gtk-doc/html/gio/GProxy.html +89 -32
- data/vendor/local/share/gtk-doc/html/gio/GProxyAddress.html +42 -56
- data/vendor/local/share/gtk-doc/html/gio/GProxyResolver.html +59 -34
- data/vendor/local/share/gtk-doc/html/gio/GResolver.html +82 -95
- data/vendor/local/share/gtk-doc/html/gio/GSeekable.html +58 -72
- data/vendor/local/share/gtk-doc/html/gio/GSettings.html +597 -357
- data/vendor/local/share/gtk-doc/html/gio/GSettingsBackend.html +125 -75
- data/vendor/local/share/gtk-doc/html/gio/GSimpleAction.html +339 -0
- data/vendor/local/share/gtk-doc/html/gio/GSimpleActionGroup.html +200 -0
- data/vendor/local/share/gtk-doc/html/gio/GSimpleAsyncResult.html +232 -167
- data/vendor/local/share/gtk-doc/html/gio/GSimplePermission.html +15 -16
- data/vendor/local/share/gtk-doc/html/gio/GSocket.html +291 -406
- data/vendor/local/share/gtk-doc/html/gio/GSocketAddress.html +39 -45
- data/vendor/local/share/gtk-doc/html/gio/GSocketClient.html +301 -223
- data/vendor/local/share/gtk-doc/html/gio/GSocketConnectable.html +41 -44
- data/vendor/local/share/gtk-doc/html/gio/GSocketConnection.html +41 -49
- data/vendor/local/share/gtk-doc/html/gio/GSocketControlMessage.html +22 -32
- data/vendor/local/share/gtk-doc/html/gio/GSocketListener.html +88 -107
- data/vendor/local/share/gtk-doc/html/gio/GSocketService.html +26 -32
- data/vendor/local/share/gtk-doc/html/gio/{gio-GSrvTarget.html → GSrvTarget.html} +74 -77
- data/vendor/local/share/gtk-doc/html/gio/GTcpConnection.html +21 -22
- data/vendor/local/share/gtk-doc/html/gio/GTcpWrapperConnection.html +156 -0
- data/vendor/local/share/gtk-doc/html/gio/GThemedIcon.html +40 -46
- data/vendor/local/share/gtk-doc/html/gio/GThreadedSocketService.html +29 -35
- data/vendor/local/share/gtk-doc/html/gio/GTlsBackend.html +260 -0
- data/vendor/local/share/gtk-doc/html/gio/GTlsCertificate.html +396 -0
- data/vendor/local/share/gtk-doc/html/gio/GTlsClientConnection.html +428 -0
- data/vendor/local/share/gtk-doc/html/gio/GTlsConnection.html +869 -0
- data/vendor/local/share/gtk-doc/html/gio/GTlsServerConnection.html +158 -0
- data/vendor/local/share/gtk-doc/html/gio/GUnixConnection.html +32 -41
- data/vendor/local/share/gtk-doc/html/gio/GUnixCredentialsMessage.html +28 -34
- data/vendor/local/share/gtk-doc/html/gio/GUnixFDList.html +44 -54
- data/vendor/local/share/gtk-doc/html/gio/GUnixFDMessage.html +36 -41
- data/vendor/local/share/gtk-doc/html/gio/GUnixInputStream.html +35 -32
- data/vendor/local/share/gtk-doc/html/gio/GUnixOutputStream.html +35 -32
- data/vendor/local/share/gtk-doc/html/gio/GUnixSocketAddress.html +59 -67
- data/vendor/local/share/gtk-doc/html/gio/GVfs.html +49 -57
- data/vendor/local/share/gtk-doc/html/gio/GVolume.html +142 -187
- data/vendor/local/share/gtk-doc/html/gio/GVolumeMonitor.html +99 -132
- data/vendor/local/share/gtk-doc/html/gio/GZlibCompressor.html +33 -32
- data/vendor/local/share/gtk-doc/html/gio/GZlibDecompressor.html +22 -24
- data/vendor/local/share/gtk-doc/html/gio/annotation-glossary.html +43 -13
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-18.html +5 -5
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-20.html +10 -3
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-22.html +20 -20
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-24.html +8 -8
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-26.html +36 -28
- data/vendor/local/share/gtk-doc/html/gio/api-index-2-28.html +744 -0
- data/vendor/local/share/gtk-doc/html/gio/api-index-deprecated.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/api-index-full.html +915 -107
- data/vendor/local/share/gtk-doc/html/gio/application.html +50 -0
- data/vendor/local/share/gtk-doc/html/gio/async.html +5 -5
- data/vendor/local/share/gtk-doc/html/gio/ch01.html +4 -4
- data/vendor/local/share/gtk-doc/html/gio/ch02.html +5 -5
- data/vendor/local/share/gtk-doc/html/gio/ch03.html +23 -24
- data/vendor/local/share/gtk-doc/html/gio/ch26.html +54 -36
- data/vendor/local/share/gtk-doc/html/gio/ch27.html +188 -41
- data/vendor/local/share/gtk-doc/html/gio/ch27s02.html +19 -108
- data/vendor/local/share/gtk-doc/html/gio/ch27s03.html +16 -179
- data/vendor/local/share/gtk-doc/html/gio/ch28.html +57 -0
- data/vendor/local/share/gtk-doc/html/gio/{ch26s02.html → ch28s02.html} +10 -10
- data/vendor/local/share/gtk-doc/html/gio/{ch26s03.html → ch28s03.html} +10 -10
- data/vendor/local/share/gtk-doc/html/gio/{ch26s04.html → ch28s04.html} +10 -10
- data/vendor/local/share/gtk-doc/html/gio/{ch26s05.html → ch28s05.html} +10 -10
- data/vendor/local/share/gtk-doc/html/gio/{ch26s06.html → ch28s06.html} +17 -15
- data/vendor/local/share/gtk-doc/html/gio/{ch26s07.html → ch28s07.html} +10 -10
- data/vendor/local/share/gtk-doc/html/gio/ch29.html +70 -0
- data/vendor/local/share/gtk-doc/html/gio/ch29s02.html +130 -0
- data/vendor/local/share/gtk-doc/html/gio/ch29s03.html +202 -0
- data/vendor/local/share/gtk-doc/html/gio/{ch27s04.html → ch29s04.html} +11 -11
- data/vendor/local/share/gtk-doc/html/gio/{ch27s05.html → ch29s05.html} +12 -12
- data/vendor/local/share/gtk-doc/html/gio/{ch27s06.html → ch29s06.html} +10 -10
- data/vendor/local/share/gtk-doc/html/gio/conversion.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/extending-gio.html +27 -14
- data/vendor/local/share/gtk-doc/html/gio/extending.html +5 -5
- data/vendor/local/share/gtk-doc/html/gio/failable_initialization.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/file_mon.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/file_ops.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/gdbus-convenience.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/gdbus-lowlevel.html +6 -6
- data/vendor/local/share/gtk-doc/html/gio/gdbus.html +18 -18
- data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Addresses.html +39 -62
- data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Introspection-Data.html +141 -248
- data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Utilities.html +28 -40
- data/vendor/local/share/gtk-doc/html/gio/gio-Desktop-file-based-GAppInfo.html +29 -112
- data/vendor/local/share/gtk-doc/html/gio/gio-Extension-Points.html +45 -57
- data/vendor/local/share/gtk-doc/html/gio/gio-GContentType.html +58 -68
- data/vendor/local/share/gtk-doc/html/gio/gio-GConverterInputstream.html +16 -18
- data/vendor/local/share/gtk-doc/html/gio/gio-GConverterOutputstream.html +18 -20
- data/vendor/local/share/gtk-doc/html/gio/gio-GFileAttribute.html +82 -76
- data/vendor/local/share/gtk-doc/html/gio/gio-GIOError.html +34 -28
- data/vendor/local/share/gtk-doc/html/gio/gio-GIOScheduler.html +25 -33
- data/vendor/local/share/gtk-doc/html/gio/gio-Owning-Bus-Names.html +87 -113
- data/vendor/local/share/gtk-doc/html/gio/gio-TLS-Overview.html +287 -0
- data/vendor/local/share/gtk-doc/html/gio/gio-Unix-Mounts.html +119 -151
- data/vendor/local/share/gtk-doc/html/gio/gio-Watching-Bus-Names.html +62 -95
- data/vendor/local/share/gtk-doc/html/gio/gio-hierarchy.html +66 -6
- data/vendor/local/share/gtk-doc/html/gio/gio-querymodules.html +8 -8
- data/vendor/local/share/gtk-doc/html/gio/gio.devhelp +312 -91
- data/vendor/local/share/gtk-doc/html/gio/gio.devhelp2 +386 -133
- data/vendor/local/share/gtk-doc/html/gio/glib-compile-schemas.html +12 -12
- data/vendor/local/share/gtk-doc/html/gio/gsettings-tool.html +162 -0
- data/vendor/local/share/gtk-doc/html/gio/highlevel-socket.html +7 -4
- data/vendor/local/share/gtk-doc/html/gio/icons.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/index.html +88 -36
- data/vendor/local/share/gtk-doc/html/gio/index.sgml +506 -95
- data/vendor/local/share/gtk-doc/html/gio/migrating.html +23 -23
- data/vendor/local/share/gtk-doc/html/gio/networking.html +3 -3
- data/vendor/local/share/gtk-doc/html/gio/permissions.html +5 -5
- data/vendor/local/share/gtk-doc/html/gio/pt01.html +4 -4
- data/vendor/local/share/gtk-doc/html/gio/pt02.html +68 -17
- data/vendor/local/share/gtk-doc/html/gio/resolver.html +6 -6
- data/vendor/local/share/gtk-doc/html/gio/settings.html +7 -7
- data/vendor/local/share/gtk-doc/html/gio/streaming.html +9 -3
- data/vendor/local/share/gtk-doc/html/gio/style.css +2 -1
- data/vendor/local/share/gtk-doc/html/gio/tls.html +50 -0
- data/vendor/local/share/gtk-doc/html/gio/tools.html +4 -4
- data/vendor/local/share/gtk-doc/html/gio/types.html +6 -6
- data/vendor/local/share/gtk-doc/html/gio/utils.html +7 -7
- data/vendor/local/share/gtk-doc/html/gio/volume_mon.html +4 -4
- data/vendor/local/share/gtk-doc/html/glib/annotation-glossary.html +8 -11
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-10.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-12.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-14.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-16.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-18.html +4 -4
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-2.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-20.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-22.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-24.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-26.html +25 -5
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-28.html +112 -0
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-4.html +6 -6
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-6.html +15 -11
- data/vendor/local/share/gtk-doc/html/glib/api-index-2-8.html +5 -5
- data/vendor/local/share/gtk-doc/html/glib/api-index-deprecated.html +9 -5
- data/vendor/local/share/gtk-doc/html/glib/api-index-full.html +201 -89
- data/vendor/local/share/gtk-doc/html/glib/glib-Arrays.html +144 -210
- data/vendor/local/share/gtk-doc/html/glib/glib-Asynchronous-Queues.html +97 -136
- data/vendor/local/share/gtk-doc/html/glib/glib-Atomic-Operations.html +40 -58
- data/vendor/local/share/gtk-doc/html/glib/glib-Automatic-String-Completion.html +99 -128
- data/vendor/local/share/gtk-doc/html/glib/glib-Balanced-Binary-Trees.html +104 -155
- data/vendor/local/share/gtk-doc/html/glib/glib-Base64-Encoding.html +42 -71
- data/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html +40 -43
- data/vendor/local/share/gtk-doc/html/glib/glib-Bookmark-file-parser.html +224 -314
- data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Arrays.html +104 -142
- data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Order-Macros.html +193 -308
- data/vendor/local/share/gtk-doc/html/glib/glib-Caches.html +51 -76
- data/vendor/local/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html +170 -307
- data/vendor/local/share/gtk-doc/html/glib/glib-Commandline-option-parser.html +154 -198
- data/vendor/local/share/gtk-doc/html/glib/glib-Data-Checksums.html +45 -67
- data/vendor/local/share/gtk-doc/html/glib/glib-Datasets.html +60 -97
- data/vendor/local/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html +390 -428
- data/vendor/local/share/gtk-doc/html/glib/glib-Double-ended-Queues.html +265 -333
- data/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html +306 -330
- data/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html +60 -99
- data/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html +122 -152
- data/vendor/local/share/gtk-doc/html/glib/glib-File-Utilities.html +241 -571
- data/vendor/local/share/gtk-doc/html/glib/glib-GDateTime.html +233 -330
- data/vendor/local/share/gtk-doc/html/glib/glib-GTimeZone.html +310 -34
- data/vendor/local/share/gtk-doc/html/glib/glib-GVariant.html +739 -590
- data/vendor/local/share/gtk-doc/html/glib/glib-GVariantType.html +136 -143
- data/vendor/local/share/gtk-doc/html/glib/glib-Glob-style-pattern-matching.html +22 -29
- data/vendor/local/share/gtk-doc/html/glib/glib-Hash-Tables.html +210 -297
- data/vendor/local/share/gtk-doc/html/glib/glib-Hook-Functions.html +294 -355
- data/vendor/local/share/gtk-doc/html/glib/glib-Hostname-Utilities.html +27 -39
- data/vendor/local/share/gtk-doc/html/glib/glib-I18N.html +102 -95
- data/vendor/local/share/gtk-doc/html/glib/glib-IO-Channels.html +402 -486
- data/vendor/local/share/gtk-doc/html/glib/glib-Key-value-file-parser.html +308 -442
- data/vendor/local/share/gtk-doc/html/glib/glib-Keyed-Data-Lists.html +75 -116
- data/vendor/local/share/gtk-doc/html/glib/glib-Lexical-Scanner.html +229 -297
- data/vendor/local/share/gtk-doc/html/glib/glib-Limits-of-Basic-Types.html +36 -36
- data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html +121 -187
- data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocators.html +23 -27
- data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Chunks.html +80 -107
- data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Slices.html +46 -69
- data/vendor/local/share/gtk-doc/html/glib/glib-Message-Logging.html +63 -99
- data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Macros.html +121 -115
- data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html +304 -327
- data/vendor/local/share/gtk-doc/html/glib/glib-N-ary-Trees.html +307 -366
- data/vendor/local/share/gtk-doc/html/glib/glib-Numerical-Definitions.html +39 -20
- data/vendor/local/share/gtk-doc/html/glib/glib-Perl-compatible-regular-expressions.html +230 -343
- data/vendor/local/share/gtk-doc/html/glib/glib-Pointer-Arrays.html +121 -167
- data/vendor/local/share/gtk-doc/html/glib/glib-Quarks.html +31 -45
- data/vendor/local/share/gtk-doc/html/glib/glib-Random-Numbers.html +73 -113
- data/vendor/local/share/gtk-doc/html/glib/glib-Relations-and-Tuples.html +75 -106
- data/vendor/local/share/gtk-doc/html/glib/glib-Sequences.html +229 -184
- data/vendor/local/share/gtk-doc/html/glib/glib-Shell-related-Utilities.html +31 -40
- data/vendor/local/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html +247 -286
- data/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html +281 -283
- data/vendor/local/share/gtk-doc/html/glib/glib-Spawning-Processes.html +83 -337
- data/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html +65 -80
- data/vendor/local/share/gtk-doc/html/glib/glib-String-Chunks.html +36 -42
- data/vendor/local/share/gtk-doc/html/glib/glib-String-Utility-Functions.html +408 -621
- data/vendor/local/share/gtk-doc/html/glib/glib-Strings.html +253 -322
- data/vendor/local/share/gtk-doc/html/glib/glib-Testing.html +161 -252
- data/vendor/local/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html +677 -590
- data/vendor/local/share/gtk-doc/html/glib/glib-Thread-Pools.html +88 -111
- data/vendor/local/share/gtk-doc/html/glib/glib-Threads.html +378 -475
- data/vendor/local/share/gtk-doc/html/glib/glib-Timers.html +27 -48
- data/vendor/local/share/gtk-doc/html/glib/glib-Trash-Stacks.html +39 -48
- data/vendor/local/share/gtk-doc/html/glib/glib-Type-Conversion-Macros.html +19 -25
- data/vendor/local/share/gtk-doc/html/glib/glib-URI-Functions.html +57 -93
- data/vendor/local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html +413 -534
- data/vendor/local/share/gtk-doc/html/glib/glib-Version-Information.html +117 -21
- data/vendor/local/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html +38 -53
- data/vendor/local/share/gtk-doc/html/glib/glib-Windows-Compatibility-Functions.html +60 -114
- data/vendor/local/share/gtk-doc/html/glib/glib-building.html +38 -39
- data/vendor/local/share/gtk-doc/html/glib/glib-changes.html +7 -13
- data/vendor/local/share/gtk-doc/html/glib/glib-compiling.html +5 -5
- data/vendor/local/share/gtk-doc/html/glib/glib-core.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/glib-cross-compiling.html +19 -19
- data/vendor/local/share/gtk-doc/html/glib/glib-data-types.html +6 -3
- data/vendor/local/share/gtk-doc/html/glib/glib-fundamentals.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/glib-gettextize.html +10 -10
- data/vendor/local/share/gtk-doc/html/glib/glib-regex-syntax.html +82 -82
- data/vendor/local/share/gtk-doc/html/glib/glib-resources.html +9 -9
- data/vendor/local/share/gtk-doc/html/glib/glib-running.html +26 -26
- data/vendor/local/share/gtk-doc/html/glib/glib-utilities.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/glib.devhelp +144 -103
- data/vendor/local/share/gtk-doc/html/glib/glib.devhelp2 +170 -105
- data/vendor/local/share/gtk-doc/html/glib/glib.html +3 -3
- data/vendor/local/share/gtk-doc/html/glib/gtester-report.html +10 -10
- data/vendor/local/share/gtk-doc/html/glib/gtester.html +10 -10
- data/vendor/local/share/gtk-doc/html/glib/gvariant-format-strings.html +48 -43
- data/vendor/local/share/gtk-doc/html/glib/gvariant-text.html +660 -0
- data/vendor/local/share/gtk-doc/html/glib/index.html +8 -4
- data/vendor/local/share/gtk-doc/html/glib/index.sgml +67 -2
- data/vendor/local/share/gtk-doc/html/glib/style.css +2 -1
- data/vendor/local/share/gtk-doc/html/glib/tools.html +5 -5
- data/vendor/local/share/gtk-doc/html/gobject/GBinding.html +72 -90
- data/vendor/local/share/gtk-doc/html/gobject/GTypeModule.html +79 -108
- data/vendor/local/share/gtk-doc/html/gobject/GTypePlugin.html +67 -85
- data/vendor/local/share/gtk-doc/html/gobject/annotation-glossary.html +63 -9
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-10.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-12.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-14.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-18.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-2.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-22.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-24.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-26.html +6 -6
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-28.html +47 -0
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-4.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-6.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-2-8.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-deprecated.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/api-index-full.html +65 -53
- data/vendor/local/share/gtk-doc/html/gobject/ch01s02.html +7 -7
- data/vendor/local/share/gtk-doc/html/gobject/ch06s03.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/chapter-gobject.html +8 -11
- data/vendor/local/share/gtk-doc/html/gobject/chapter-gtype.html +19 -19
- data/vendor/local/share/gtk-doc/html/gobject/chapter-intro.html +6 -6
- data/vendor/local/share/gtk-doc/html/gobject/chapter-signal.html +18 -18
- data/vendor/local/share/gtk-doc/html/gobject/glib-genmarshal.html +22 -22
- data/vendor/local/share/gtk-doc/html/gobject/glib-mkenums.html +16 -16
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Boxed-Types.html +40 -54
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html +405 -512
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html +170 -213
- data/vendor/local/share/gtk-doc/html/gobject/gobject-GParamSpec.html +242 -292
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Generic-values.html +91 -127
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html +407 -573
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html +951 -1268
- data/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html +383 -441
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Type-Information.html +648 -829
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Value-arrays.html +82 -95
- data/vendor/local/share/gtk-doc/html/gobject/gobject-Varargs-Value-Collection.html +31 -49
- data/vendor/local/share/gtk-doc/html/gobject/gobject-memory.html +8 -8
- data/vendor/local/share/gtk-doc/html/gobject/gobject-properties.html +15 -14
- data/vendor/local/share/gtk-doc/html/gobject/gobject-query.html +10 -10
- data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp +62 -58
- data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp2 +62 -58
- data/vendor/local/share/gtk-doc/html/gobject/gtype-conventions.html +6 -6
- data/vendor/local/share/gtk-doc/html/gobject/gtype-instantiable-classed.html +11 -11
- data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable-classed.html +14 -14
- data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable.html +6 -6
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-chainup.html +5 -5
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-code.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-construction.html +7 -7
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-destruction.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-methods.html +9 -9
- data/vendor/local/share/gtk-doc/html/gobject/howto-gobject.html +10 -10
- data/vendor/local/share/gtk-doc/html/gobject/howto-interface-implement.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/howto-interface-properties.html +7 -7
- data/vendor/local/share/gtk-doc/html/gobject/howto-interface.html +6 -6
- data/vendor/local/share/gtk-doc/html/gobject/howto-signals.html +6 -6
- data/vendor/local/share/gtk-doc/html/gobject/index.html +11 -10
- data/vendor/local/share/gtk-doc/html/gobject/index.sgml +13 -1
- data/vendor/local/share/gtk-doc/html/gobject/pr01.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/pt01.html +7 -7
- data/vendor/local/share/gtk-doc/html/gobject/pt02.html +8 -8
- data/vendor/local/share/gtk-doc/html/gobject/pt03.html +5 -5
- data/vendor/local/share/gtk-doc/html/gobject/rn01.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/rn02.html +4 -4
- data/vendor/local/share/gtk-doc/html/gobject/signal.html +13 -13
- data/vendor/local/share/gtk-doc/html/gobject/style.css +2 -1
- data/vendor/local/share/gtk-doc/html/gobject/tools-ginspector.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/tools-gob.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/tools-gtkdoc.html +6 -6
- data/vendor/local/share/gtk-doc/html/gobject/tools-refdb.html +3 -3
- data/vendor/local/share/gtk-doc/html/gobject/tools-vala.html +3 -3
- data/vendor/local/share/locale/ar/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/be/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/bg/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/bn_IN/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/cs/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/da/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/de/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/el/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/en_GB/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/es/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/et/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/eu/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/fr/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/gl/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/he/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/hu/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/hy/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/id/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/it/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/ja/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/ko/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/lt/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/nb/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/pa/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/pl/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/pt/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/pt_BR/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/ro/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/ru/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/sl/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/sr/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/sr@latin/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/sv/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/ug/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/vi/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/zh_CN/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/zh_HK/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/locale/zh_TW/LC_MESSAGES/glib20.mo +0 -0
- data/vendor/local/share/man/man1/glib-genmarshal.1 +2 -2
- data/vendor/local/share/man/man1/glib-mkenums.1 +2 -2
- data/vendor/local/share/man/man1/gobject-query.1 +2 -2
- data/vendor/local/src/tml/packaging/{glib_2.26.1-1_win32.log → glib_2.28.1-1_win32.log} +690 -773
- data/vendor/local/src/tml/packaging/{glib_2.26.1-1_win32.sh → glib_2.28.1-1_win32.sh} +2 -4
- metadata +78 -146
- data/ext/glib2/Makefile +0 -169
- data/ext/glib2/glib-enum-types.c +0 -1065
- data/ext/glib2/glib-enum-types.h +0 -144
- data/ext/glib2/ruby-glib2.pc +0 -3
- data/test-unit/COPYING +0 -56
- data/test-unit/GPL +0 -340
- data/test-unit/History.txt +0 -279
- data/test-unit/Manifest.txt +0 -110
- data/test-unit/PSFL +0 -271
- data/test-unit/README.txt +0 -75
- data/test-unit/Rakefile +0 -53
- data/test-unit/TODO +0 -5
- data/test-unit/bin/testrb +0 -5
- data/test-unit/html/bar.png +0 -0
- data/test-unit/html/bar.svg +0 -153
- data/test-unit/html/developer.png +0 -0
- data/test-unit/html/developer.svg +0 -469
- data/test-unit/html/famfamfam-logo.png +0 -0
- data/test-unit/html/favicon.ico +0 -0
- data/test-unit/html/favicon.png +0 -0
- data/test-unit/html/favicon.svg +0 -82
- data/test-unit/html/heading-mark.png +0 -0
- data/test-unit/html/heading-mark.svg +0 -393
- data/test-unit/html/index.html +0 -285
- data/test-unit/html/index.html.ja +0 -299
- data/test-unit/html/install.png +0 -0
- data/test-unit/html/install.svg +0 -636
- data/test-unit/html/jp.png +0 -0
- data/test-unit/html/kinotan-failure.png +0 -0
- data/test-unit/html/kinotan-pass.png +0 -0
- data/test-unit/html/logo.png +0 -0
- data/test-unit/html/logo.svg +0 -483
- data/test-unit/html/reference.png +0 -0
- data/test-unit/html/rubyforge.png +0 -0
- data/test-unit/html/tango-logo.png +0 -0
- data/test-unit/html/test-unit.css +0 -339
- data/test-unit/html/tutorial.png +0 -0
- data/test-unit/html/tutorial.svg +0 -559
- data/test-unit/html/us.png +0 -0
- data/test-unit/images/color-diff.png +0 -0
- data/test-unit/lib/test/unit.rb +0 -328
- data/test-unit/lib/test/unit/assertionfailederror.rb +0 -25
- data/test-unit/lib/test/unit/assertions.rb +0 -1792
- data/test-unit/lib/test/unit/attribute.rb +0 -125
- data/test-unit/lib/test/unit/autorunner.rb +0 -415
- data/test-unit/lib/test/unit/collector.rb +0 -38
- data/test-unit/lib/test/unit/collector/descendant.rb +0 -23
- data/test-unit/lib/test/unit/collector/dir.rb +0 -108
- data/test-unit/lib/test/unit/collector/load.rb +0 -187
- data/test-unit/lib/test/unit/collector/objectspace.rb +0 -34
- data/test-unit/lib/test/unit/collector/xml.rb +0 -250
- data/test-unit/lib/test/unit/color-scheme.rb +0 -106
- data/test-unit/lib/test/unit/color.rb +0 -96
- data/test-unit/lib/test/unit/diff.rb +0 -740
- data/test-unit/lib/test/unit/error.rb +0 -131
- data/test-unit/lib/test/unit/exceptionhandler.rb +0 -39
- data/test-unit/lib/test/unit/failure.rb +0 -136
- data/test-unit/lib/test/unit/fixture.rb +0 -185
- data/test-unit/lib/test/unit/notification.rb +0 -129
- data/test-unit/lib/test/unit/omission.rb +0 -191
- data/test-unit/lib/test/unit/pending.rb +0 -150
- data/test-unit/lib/test/unit/priority.rb +0 -180
- data/test-unit/lib/test/unit/runner/console.rb +0 -52
- data/test-unit/lib/test/unit/runner/emacs.rb +0 -8
- data/test-unit/lib/test/unit/runner/tap.rb +0 -8
- data/test-unit/lib/test/unit/runner/xml.rb +0 -15
- data/test-unit/lib/test/unit/testcase.rb +0 -515
- data/test-unit/lib/test/unit/testresult.rb +0 -125
- data/test-unit/lib/test/unit/testsuite.rb +0 -134
- data/test-unit/lib/test/unit/ui/console/outputlevel.rb +0 -14
- data/test-unit/lib/test/unit/ui/console/testrunner.rb +0 -467
- data/test-unit/lib/test/unit/ui/emacs/testrunner.rb +0 -63
- data/test-unit/lib/test/unit/ui/tap/testrunner.rb +0 -82
- data/test-unit/lib/test/unit/ui/testrunner.rb +0 -53
- data/test-unit/lib/test/unit/ui/testrunnermediator.rb +0 -86
- data/test-unit/lib/test/unit/ui/testrunnerutilities.rb +0 -41
- data/test-unit/lib/test/unit/ui/xml/testrunner.rb +0 -224
- data/test-unit/lib/test/unit/util/backtracefilter.rb +0 -42
- data/test-unit/lib/test/unit/util/method-owner-finder.rb +0 -28
- data/test-unit/lib/test/unit/util/observable.rb +0 -90
- data/test-unit/lib/test/unit/util/output.rb +0 -31
- data/test-unit/lib/test/unit/util/procwrapper.rb +0 -48
- data/test-unit/lib/test/unit/version.rb +0 -7
- data/test-unit/sample/adder.rb +0 -13
- data/test-unit/sample/subtracter.rb +0 -12
- data/test-unit/sample/test_adder.rb +0 -20
- data/test-unit/sample/test_subtracter.rb +0 -20
- data/test-unit/sample/test_user.rb +0 -23
- data/test-unit/test/collector/test-descendant.rb +0 -133
- data/test-unit/test/collector/test-load.rb +0 -442
- data/test-unit/test/collector/test_dir.rb +0 -406
- data/test-unit/test/collector/test_objectspace.rb +0 -100
- data/test-unit/test/run-test.rb +0 -22
- data/test-unit/test/test-assertions.rb +0 -1849
- data/test-unit/test/test-attribute.rb +0 -86
- data/test-unit/test/test-color-scheme.rb +0 -69
- data/test-unit/test/test-color.rb +0 -47
- data/test-unit/test/test-diff.rb +0 -518
- data/test-unit/test/test-emacs-runner.rb +0 -60
- data/test-unit/test/test-fixture.rb +0 -324
- data/test-unit/test/test-notification.rb +0 -33
- data/test-unit/test/test-omission.rb +0 -81
- data/test-unit/test/test-pending.rb +0 -70
- data/test-unit/test/test-priority.rb +0 -119
- data/test-unit/test/test-testcase.rb +0 -569
- data/test-unit/test/test_error.rb +0 -26
- data/test-unit/test/test_failure.rb +0 -33
- data/test-unit/test/test_testresult.rb +0 -113
- data/test-unit/test/test_testsuite.rb +0 -137
- data/test-unit/test/testunit-test-util.rb +0 -14
- data/test-unit/test/ui/test_tap.rb +0 -33
- data/test-unit/test/ui/test_testrunmediator.rb +0 -20
- data/test-unit/test/util/test-method-owner-finder.rb +0 -38
- data/test-unit/test/util/test-output.rb +0 -11
- data/test-unit/test/util/test_backtracefilter.rb +0 -41
- data/test-unit/test/util/test_observable.rb +0 -102
- data/test-unit/test/util/test_procwrapper.rb +0 -36
- data/vendor/local/share/gtk-doc/html/gio/ch24.html +0 -75
- data/vendor/local/share/gtk-doc/html/gio/ch25.html +0 -217
- data/vendor/local/share/gtk-doc/html/gio/ch25s02.html +0 -41
- data/vendor/local/share/gtk-doc/html/gio/ch25s03.html +0 -39
|
@@ -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.
|
|
11
|
+
<meta name="generator" content="GTK-Doc V1.16.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"
|
|
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,13 +41,13 @@
|
|
|
41
41
|
</td>
|
|
42
42
|
<td valign="top" align="right"></td>
|
|
43
43
|
</tr></table></div>
|
|
44
|
-
<div class="refsynopsisdiv"
|
|
44
|
+
<div class="refsynopsisdiv">
|
|
45
45
|
<a name="GSeekable.synopsis"></a><h2>Synopsis</h2>
|
|
46
46
|
<pre class="synopsis">
|
|
47
47
|
#include <gio/gio.h>
|
|
48
48
|
|
|
49
49
|
<a class="link" href="GSeekable.html#GSeekable-struct" title="GSeekable">GSeekable</a>;
|
|
50
|
-
|
|
50
|
+
struct <a class="link" href="GSeekable.html#GSeekableIface" title="struct GSeekableIface">GSeekableIface</a>;
|
|
51
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
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
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>,
|
|
@@ -62,35 +62,35 @@
|
|
|
62
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"
|
|
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"
|
|
72
|
+
<div class="refsect1">
|
|
73
73
|
<a name="GSeekable.prerequisites"></a><h2>Prerequisites</h2>
|
|
74
74
|
<p>
|
|
75
75
|
GSeekable requires
|
|
76
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"
|
|
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"
|
|
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"
|
|
91
|
+
<div class="refsect1">
|
|
92
92
|
<a name="GSeekable.details"></a><h2>Details</h2>
|
|
93
|
-
<div class="refsect2"
|
|
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,9 +98,9 @@ Seek object for streaming operations.
|
|
|
98
98
|
</p>
|
|
99
99
|
</div>
|
|
100
100
|
<hr>
|
|
101
|
-
<div class="refsect2"
|
|
102
|
-
<a name="GSeekableIface"></a><h3>GSeekableIface</h3>
|
|
103
|
-
<pre class="programlisting">
|
|
101
|
+
<div class="refsect2">
|
|
102
|
+
<a name="GSeekableIface"></a><h3>struct GSeekableIface</h3>
|
|
103
|
+
<pre class="programlisting">struct GSeekableIface {
|
|
104
104
|
GTypeInterface g_iface;
|
|
105
105
|
|
|
106
106
|
/* Virtual Table */
|
|
@@ -121,7 +121,7 @@ Seek object for streaming operations.
|
|
|
121
121
|
GError **error);
|
|
122
122
|
|
|
123
123
|
/* TODO: Async seek/truncate */
|
|
124
|
-
}
|
|
124
|
+
};
|
|
125
125
|
</pre>
|
|
126
126
|
<p>
|
|
127
127
|
Provides an interface for implementing seekable functionality on I/O Streams.
|
|
@@ -131,39 +131,33 @@ Provides an interface for implementing seekable functionality on I/O Streams.
|
|
|
131
131
|
<tbody>
|
|
132
132
|
<tr>
|
|
133
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
|
-
<td>The parent interface
|
|
135
|
-
</td>
|
|
134
|
+
<td>The parent interface.</td>
|
|
136
135
|
</tr>
|
|
137
136
|
<tr>
|
|
138
137
|
<td><p><span class="term"><em class="structfield"><code><a name="GSeekableIface.tell"></a>tell</code></em> ()</span></p></td>
|
|
139
|
-
<td>Tells the current location within a stream
|
|
140
|
-
</td>
|
|
138
|
+
<td>Tells the current location within a stream.</td>
|
|
141
139
|
</tr>
|
|
142
140
|
<tr>
|
|
143
141
|
<td><p><span class="term"><em class="structfield"><code><a name="GSeekableIface.can-seek"></a>can_seek</code></em> ()</span></p></td>
|
|
144
|
-
<td>Checks if seeking is supported by the stream
|
|
145
|
-
</td>
|
|
142
|
+
<td>Checks if seeking is supported by the stream.</td>
|
|
146
143
|
</tr>
|
|
147
144
|
<tr>
|
|
148
145
|
<td><p><span class="term"><em class="structfield"><code><a name="GSeekableIface.seek"></a>seek</code></em> ()</span></p></td>
|
|
149
|
-
<td>Seeks to a location within a stream
|
|
150
|
-
</td>
|
|
146
|
+
<td>Seeks to a location within a stream.</td>
|
|
151
147
|
</tr>
|
|
152
148
|
<tr>
|
|
153
149
|
<td><p><span class="term"><em class="structfield"><code><a name="GSeekableIface.can-truncate"></a>can_truncate</code></em> ()</span></p></td>
|
|
154
|
-
<td>Chekcs if truncation is suppored by the stream
|
|
155
|
-
</td>
|
|
150
|
+
<td>Chekcs if truncation is suppored by the stream.</td>
|
|
156
151
|
</tr>
|
|
157
152
|
<tr>
|
|
158
153
|
<td><p><span class="term"><em class="structfield"><code><a name="GSeekableIface.truncate-fn"></a>truncate_fn</code></em> ()</span></p></td>
|
|
159
|
-
<td>Truncates a stream
|
|
160
|
-
</td>
|
|
154
|
+
<td>Truncates a stream.</td>
|
|
161
155
|
</tr>
|
|
162
156
|
</tbody>
|
|
163
157
|
</table></div>
|
|
164
158
|
</div>
|
|
165
159
|
<hr>
|
|
166
|
-
<div class="refsect2"
|
|
160
|
+
<div class="refsect2">
|
|
167
161
|
<a name="g-seekable-tell"></a><h3>g_seekable_tell ()</h3>
|
|
168
162
|
<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
163
|
<p>
|
|
@@ -174,42 +168,39 @@ Tells the current position within the stream.
|
|
|
174
168
|
<tbody>
|
|
175
169
|
<tr>
|
|
176
170
|
<td><p><span class="term"><em class="parameter"><code>seekable</code></em> :</span></p></td>
|
|
177
|
-
<td>a <a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a
|
|
178
|
-
</td>
|
|
171
|
+
<td>a <a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a>.</td>
|
|
179
172
|
</tr>
|
|
180
173
|
<tr>
|
|
181
174
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
182
|
-
<td>
|
|
183
|
-
</td>
|
|
175
|
+
<td>the offset from the beginning of the buffer.</td>
|
|
184
176
|
</tr>
|
|
185
177
|
</tbody>
|
|
186
178
|
</table></div>
|
|
187
179
|
</div>
|
|
188
180
|
<hr>
|
|
189
|
-
<div class="refsect2"
|
|
181
|
+
<div class="refsect2">
|
|
190
182
|
<a name="g-seekable-can-seek"></a><h3>g_seekable_can_seek ()</h3>
|
|
191
183
|
<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
184
|
<p>
|
|
193
|
-
Tests if the stream supports the <a class="link" href="GSeekable.html#GSeekableIface" title="GSeekableIface"><span class="type">GSeekableIface</span></a>.
|
|
185
|
+
Tests if the stream supports the <a class="link" href="GSeekable.html#GSeekableIface" title="struct GSeekableIface"><span class="type">GSeekableIface</span></a>.
|
|
194
186
|
</p>
|
|
195
187
|
<div class="variablelist"><table border="0">
|
|
196
188
|
<col align="left" valign="top">
|
|
197
189
|
<tbody>
|
|
198
190
|
<tr>
|
|
199
191
|
<td><p><span class="term"><em class="parameter"><code>seekable</code></em> :</span></p></td>
|
|
200
|
-
<td>a <a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a
|
|
201
|
-
</td>
|
|
192
|
+
<td>a <a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a>.</td>
|
|
202
193
|
</tr>
|
|
203
194
|
<tr>
|
|
204
195
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
205
|
-
<td>
|
|
206
|
-
</td>
|
|
196
|
+
<td>
|
|
197
|
+
<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.</td>
|
|
207
198
|
</tr>
|
|
208
199
|
</tbody>
|
|
209
200
|
</table></div>
|
|
210
201
|
</div>
|
|
211
202
|
<hr>
|
|
212
|
-
<div class="refsect2"
|
|
203
|
+
<div class="refsect2">
|
|
213
204
|
<a name="g-seekable-seek"></a><h3>g_seekable_seek ()</h3>
|
|
214
205
|
<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
206
|
<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>,
|
|
@@ -229,42 +220,38 @@ was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANC
|
|
|
229
220
|
<tbody>
|
|
230
221
|
<tr>
|
|
231
222
|
<td><p><span class="term"><em class="parameter"><code>seekable</code></em> :</span></p></td>
|
|
232
|
-
<td>a <a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a
|
|
233
|
-
</td>
|
|
223
|
+
<td>a <a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a>.</td>
|
|
234
224
|
</tr>
|
|
235
225
|
<tr>
|
|
236
226
|
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
|
|
237
|
-
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a
|
|
238
|
-
</td>
|
|
227
|
+
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a>.</td>
|
|
239
228
|
</tr>
|
|
240
229
|
<tr>
|
|
241
230
|
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
|
|
242
|
-
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-IO-Channels.html#GSeekType"><span class="type">GSeekType</span></a
|
|
243
|
-
</td>
|
|
231
|
+
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-IO-Channels.html#GSeekType"><span class="type">GSeekType</span></a>.</td>
|
|
244
232
|
</tr>
|
|
245
233
|
<tr>
|
|
246
234
|
<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="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.
|
|
235
|
+
<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. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
|
|
248
236
|
</td>
|
|
249
237
|
</tr>
|
|
250
238
|
<tr>
|
|
251
239
|
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
|
|
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
|
-
ignore
|
|
254
|
-
</td>
|
|
240
|
+
<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
|
|
241
|
+
ignore.</td>
|
|
255
242
|
</tr>
|
|
256
243
|
<tr>
|
|
257
244
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
258
|
-
<td>
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
245
|
+
<td>
|
|
246
|
+
<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
|
|
247
|
+
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>
|
|
248
|
+
appropriately if present.</td>
|
|
262
249
|
</tr>
|
|
263
250
|
</tbody>
|
|
264
251
|
</table></div>
|
|
265
252
|
</div>
|
|
266
253
|
<hr>
|
|
267
|
-
<div class="refsect2"
|
|
254
|
+
<div class="refsect2">
|
|
268
255
|
<a name="g-seekable-can-truncate"></a><h3>g_seekable_can_truncate ()</h3>
|
|
269
256
|
<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
257
|
<p>
|
|
@@ -275,19 +262,18 @@ Tests if the stream can be truncated.
|
|
|
275
262
|
<tbody>
|
|
276
263
|
<tr>
|
|
277
264
|
<td><p><span class="term"><em class="parameter"><code>seekable</code></em> :</span></p></td>
|
|
278
|
-
<td>a <a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a
|
|
279
|
-
</td>
|
|
265
|
+
<td>a <a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a>.</td>
|
|
280
266
|
</tr>
|
|
281
267
|
<tr>
|
|
282
268
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
283
|
-
<td>
|
|
284
|
-
</td>
|
|
269
|
+
<td>
|
|
270
|
+
<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.</td>
|
|
285
271
|
</tr>
|
|
286
272
|
</tbody>
|
|
287
273
|
</table></div>
|
|
288
274
|
</div>
|
|
289
275
|
<hr>
|
|
290
|
-
<div class="refsect2"
|
|
276
|
+
<div class="refsect2">
|
|
291
277
|
<a name="g-seekable-truncate"></a><h3>g_seekable_truncate ()</h3>
|
|
292
278
|
<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
279
|
<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>,
|
|
@@ -303,48 +289,48 @@ was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANC
|
|
|
303
289
|
operation was partially finished when the operation was cancelled the
|
|
304
290
|
partial result will be returned, without an error.
|
|
305
291
|
</p>
|
|
292
|
+
<p>
|
|
293
|
+
Virtual: truncate_fn
|
|
294
|
+
</p>
|
|
306
295
|
<div class="variablelist"><table border="0">
|
|
307
296
|
<col align="left" valign="top">
|
|
308
297
|
<tbody>
|
|
309
298
|
<tr>
|
|
310
299
|
<td><p><span class="term"><em class="parameter"><code>seekable</code></em> :</span></p></td>
|
|
311
|
-
<td>a <a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a
|
|
312
|
-
</td>
|
|
300
|
+
<td>a <a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a>.</td>
|
|
313
301
|
</tr>
|
|
314
302
|
<tr>
|
|
315
303
|
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
|
|
316
|
-
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a
|
|
317
|
-
</td>
|
|
304
|
+
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#goffset"><span class="type">goffset</span></a>.</td>
|
|
318
305
|
</tr>
|
|
319
306
|
<tr>
|
|
320
307
|
<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="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.
|
|
308
|
+
<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. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
|
|
322
309
|
</td>
|
|
323
310
|
</tr>
|
|
324
311
|
<tr>
|
|
325
312
|
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
|
|
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
|
-
ignore
|
|
328
|
-
</td>
|
|
313
|
+
<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
|
|
314
|
+
ignore.</td>
|
|
329
315
|
</tr>
|
|
330
316
|
<tr>
|
|
331
317
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
332
|
-
<td>
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
318
|
+
<td>
|
|
319
|
+
<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
|
|
320
|
+
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>
|
|
321
|
+
appropriately if present.</td>
|
|
336
322
|
</tr>
|
|
337
323
|
</tbody>
|
|
338
324
|
</table></div>
|
|
339
325
|
</div>
|
|
340
326
|
</div>
|
|
341
|
-
<div class="refsect1"
|
|
327
|
+
<div class="refsect1">
|
|
342
328
|
<a name="GSeekable.see-also"></a><h2>See Also</h2>
|
|
343
329
|
<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
330
|
</div>
|
|
345
331
|
</div>
|
|
346
332
|
<div class="footer">
|
|
347
333
|
<hr>
|
|
348
|
-
Generated by GTK-Doc V1.
|
|
334
|
+
Generated by GTK-Doc V1.16.1</div>
|
|
349
335
|
</body>
|
|
350
336
|
</html>
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
<link rel="up" href="settings.html" title="Settings">
|
|
9
9
|
<link rel="prev" href="settings.html" title="Settings">
|
|
10
10
|
<link rel="next" href="GSettingsBackend.html" title="GSettingsBackend">
|
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
|
11
|
+
<meta name="generator" content="GTK-Doc V1.16.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,29 +32,29 @@
|
|
|
32
32
|
<a href="#GSettings.signals" class="shortcut">Signals</a>
|
|
33
33
|
</td></tr>
|
|
34
34
|
</table>
|
|
35
|
-
<div class="refentry"
|
|
35
|
+
<div class="refentry">
|
|
36
36
|
<a name="GSettings"></a><div class="titlepage"></div>
|
|
37
37
|
<div class="refnamediv"><table width="100%"><tr>
|
|
38
38
|
<td valign="top">
|
|
39
39
|
<h2><span class="refentrytitle"><a name="GSettings.top_of_page"></a>GSettings</span></h2>
|
|
40
|
-
<p>GSettings —
|
|
40
|
+
<p>GSettings — High-level API for application settings</p>
|
|
41
41
|
</td>
|
|
42
42
|
<td valign="top" align="right"></td>
|
|
43
43
|
</tr></table></div>
|
|
44
|
-
<div class="refsynopsisdiv"
|
|
44
|
+
<div class="refsynopsisdiv">
|
|
45
45
|
<a name="GSettings.synopsis"></a><h2>Synopsis</h2>
|
|
46
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> *
|
|
48
|
-
<a class="link" href="GSettings.html" title="GSettings"><span class="returnvalue">GSettings</span></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
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> *
|
|
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
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> *
|
|
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
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
54
|
<em class="parameter"><code><a class="link" href="GSettingsBackend.html" title="GSettingsBackend"><span class="type">GSettingsBackend</span></a> *backend</code></em>,
|
|
55
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
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> *
|
|
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
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
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
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>,
|
|
@@ -65,11 +65,21 @@
|
|
|
65
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
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
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> *
|
|
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
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
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
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
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
|
+
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-relocatable-schemas" title="g_settings_list_relocatable_schemas ()">g_settings_list_relocatable_schemas</a>
|
|
75
|
+
(<em class="parameter"><code><span class="type">void</span></code></em>);
|
|
76
|
+
<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-list-keys" title="g_settings_list_keys ()">g_settings_list_keys</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>);
|
|
77
|
+
<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-list-children" title="g_settings_list_children ()">g_settings_list_children</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>);
|
|
78
|
+
<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-range" title="g_settings_get_range ()">g_settings_get_range</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
|
|
79
|
+
<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>);
|
|
80
|
+
<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-range-check" title="g_settings_range_check ()">g_settings_range_check</a> (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</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> *key</code></em>,
|
|
82
|
+
<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>);
|
|
73
83
|
|
|
74
84
|
<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>,
|
|
75
85
|
<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>,
|
|
@@ -94,12 +104,12 @@
|
|
|
94
104
|
<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>,
|
|
95
105
|
<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>,
|
|
96
106
|
<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>);
|
|
97
|
-
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
|
|
107
|
+
<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>,
|
|
98
108
|
<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>);
|
|
99
109
|
<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>,
|
|
100
110
|
<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>,
|
|
101
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> *value</code></em>);
|
|
102
|
-
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
|
|
112
|
+
<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>,
|
|
103
113
|
<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>);
|
|
104
114
|
<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>,
|
|
105
115
|
<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>,
|
|
@@ -153,38 +163,57 @@ enum <a class="link" href="GSettings.html#GSettingsBindFlags" tit
|
|
|
153
163
|
<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>);
|
|
154
164
|
</pre>
|
|
155
165
|
</div>
|
|
156
|
-
<div class="refsect1"
|
|
166
|
+
<div class="refsect1">
|
|
157
167
|
<a name="GSettings.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
|
158
168
|
<pre class="synopsis">
|
|
159
169
|
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
|
|
160
170
|
+----GSettings
|
|
161
171
|
</pre>
|
|
162
172
|
</div>
|
|
163
|
-
<div class="refsect1"
|
|
173
|
+
<div class="refsect1">
|
|
164
174
|
<a name="GSettings.properties"></a><h2>Properties</h2>
|
|
165
175
|
<pre class="synopsis">
|
|
166
176
|
"<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
|
|
177
|
+
"<a class="link" href="GSettings.html#GSettings--delay-apply" title='The "delay-apply" property'>delay-apply</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read
|
|
167
178
|
"<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
|
|
168
179
|
"<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
|
|
169
180
|
"<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
|
|
170
181
|
</pre>
|
|
171
182
|
</div>
|
|
172
|
-
<div class="refsect1"
|
|
183
|
+
<div class="refsect1">
|
|
173
184
|
<a name="GSettings.signals"></a><h2>Signals</h2>
|
|
174
185
|
<pre class="synopsis">
|
|
175
|
-
"<a class="link" href="GSettings.html#GSettings-change-event" title='The "change-event" signal'>change-event</a>" : Run Last
|
|
176
|
-
"<a class="link" href="GSettings.html#GSettings-changed" title='The "changed" signal'>changed</a>" :
|
|
177
|
-
"<a class="link" href="GSettings.html#GSettings-writable-change-event" title='The "writable-change-event" signal'>writable-change-event</a>" : Run Last
|
|
178
|
-
"<a class="link" href="GSettings.html#GSettings-writable-changed" title='The "writable-changed" signal'>writable-changed</a>" :
|
|
186
|
+
"<a class="link" href="GSettings.html#GSettings-change-event" title='The "change-event" signal'>change-event</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
|
|
187
|
+
"<a class="link" href="GSettings.html#GSettings-changed" title='The "changed" signal'>changed</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-DETAILED:CAPS"><code class="literal">Has Details</code></a>
|
|
188
|
+
"<a class="link" href="GSettings.html#GSettings-writable-change-event" title='The "writable-change-event" signal'>writable-change-event</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
|
|
189
|
+
"<a class="link" href="GSettings.html#GSettings-writable-changed" title='The "writable-changed" signal'>writable-changed</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-DETAILED:CAPS"><code class="literal">Has Details</code></a>
|
|
179
190
|
</pre>
|
|
180
191
|
</div>
|
|
181
|
-
<div class="refsect1"
|
|
192
|
+
<div class="refsect1">
|
|
182
193
|
<a name="GSettings.description"></a><h2>Description</h2>
|
|
183
194
|
<p>
|
|
184
195
|
The <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> class provides a convenient API for storing and retrieving
|
|
185
196
|
application settings.
|
|
186
197
|
</p>
|
|
187
198
|
<p>
|
|
199
|
+
Reads and writes can be considered to be non-blocking. Reading
|
|
200
|
+
settings with <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> is typically extremely fast: on
|
|
201
|
+
approximately the same order of magnitude (but slower than) a
|
|
202
|
+
<a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> lookup. Writing settings is also extremely fast in terms
|
|
203
|
+
of time to return to your application, but can be extremely expensive
|
|
204
|
+
for other threads and other processes. Many settings backends
|
|
205
|
+
(including dconf) have lazy initialisation which means in the common
|
|
206
|
+
case of the user using their computer without modifying any settings
|
|
207
|
+
a lot of work can be avoided. For dconf, the D-Bus service doesn't
|
|
208
|
+
even need to be started in this case. For this reason, you should
|
|
209
|
+
only ever modify <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> keys in response to explicit user action.
|
|
210
|
+
Particular care should be paid to ensure that modifications are not
|
|
211
|
+
made during startup -- for example, when settings the initial value
|
|
212
|
+
of preferences widgets. The built-in <a class="link" href="GSettings.html#g-settings-bind" title="g_settings_bind ()"><code class="function">g_settings_bind()</code></a> functionality
|
|
213
|
+
is careful not to write settings in response to notify signals as a
|
|
214
|
+
result of modifications that it makes to widgets.
|
|
215
|
+
</p>
|
|
216
|
+
<p>
|
|
188
217
|
When creating a GSettings instance, you have to specify a schema
|
|
189
218
|
that describes the keys in your settings and their types and default
|
|
190
219
|
values, as well as some other information.
|
|
@@ -283,19 +312,38 @@ described by the following DTD:
|
|
|
283
312
|
57
|
|
284
313
|
58
|
|
285
314
|
59
|
|
286
|
-
60
|
|
315
|
+
60
|
|
316
|
+
61
|
|
317
|
+
62
|
|
318
|
+
63
|
|
319
|
+
64
|
|
320
|
+
65
|
|
321
|
+
66
|
|
322
|
+
67
|
|
323
|
+
68
|
|
324
|
+
69
|
|
325
|
+
70
|
|
326
|
+
71
|
|
327
|
+
72
|
|
328
|
+
73</pre></td>
|
|
287
329
|
<td class="listing_code"><pre class="programlisting"><span class="symbol"><!</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">></span>
|
|
288
330
|
<span class="symbol"><!</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">></span>
|
|
289
331
|
|
|
290
|
-
<span class="symbol"><!</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">></span>
|
|
332
|
+
<span class="symbol"><!</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">override</span><span class="symbol">)*</span><span class="normal"> </span><span class="symbol">></span>
|
|
291
333
|
<span class="symbol"><!</span><span class="normal">ATTLIST schema </span><span class="usertype">id</span><span class="normal"> CDATA #REQUIRED</span>
|
|
292
334
|
<span class="normal"> </span><span class="usertype">path</span><span class="normal"> CDATA #IMPLIED</span>
|
|
293
|
-
<span class="normal"> gettext</span><span class="symbol">-</span><span class="usertype">domain</span><span class="normal"> CDATA #IMPLIED
|
|
335
|
+
<span class="normal"> gettext</span><span class="symbol">-</span><span class="usertype">domain</span><span class="normal"> CDATA #IMPLIED</span>
|
|
336
|
+
<span class="normal"> </span><span class="usertype">extends</span><span class="normal"> CDATA #IMPLIED</span>
|
|
337
|
+
<span class="normal"> list</span><span class="symbol">-</span><span class="usertype">of</span><span class="normal"> CDATA #IMPLIED </span><span class="symbol">></span>
|
|
294
338
|
|
|
295
|
-
<span class="symbol"><!--</span><span class="normal">
|
|
339
|
+
<span class="symbol"><!--</span><span class="normal"> enumerated and </span><span class="usertype">flags</span><span class="normal"> types </span><span class="symbol">--></span>
|
|
296
340
|
<span class="symbol"><!--</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">--></span>
|
|
297
341
|
<span class="symbol"><!</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">></span>
|
|
298
342
|
<span class="symbol"><!</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">></span>
|
|
343
|
+
|
|
344
|
+
<span class="symbol"><!</span><span class="usertype">ELEMENT</span><span class="normal"> </span><span class="function">flags</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">></span>
|
|
345
|
+
<span class="symbol"><!</span><span class="normal">ATTLIST flags </span><span class="usertype">id</span><span class="normal"> CDATA #REQUIRED </span><span class="symbol">></span>
|
|
346
|
+
|
|
299
347
|
<span class="symbol"><!</span><span class="normal">ELEMENT </span><span class="usertype">value</span><span class="normal"> EMPTY </span><span class="symbol">></span>
|
|
300
348
|
<span class="symbol"><!--</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">--></span>
|
|
301
349
|
<span class="symbol"><!--</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">--></span>
|
|
@@ -305,11 +353,13 @@ described by the following DTD:
|
|
|
305
353
|
<span class="symbol"><!</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">></span>
|
|
306
354
|
<span class="symbol"><!--</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">--></span>
|
|
307
355
|
<span class="symbol"><!--</span><span class="normal"> type must be a GVariant </span><span class="usertype">type</span><span class="normal"> string </span><span class="symbol">--></span>
|
|
308
|
-
<span class="symbol"><!--</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">--></span>
|
|
309
|
-
<span class="symbol"><!--</span><span class="normal">
|
|
310
|
-
<span class="symbol"><
|
|
311
|
-
<span class="normal">
|
|
312
|
-
<span class="normal"> </span><span class="
|
|
356
|
+
<span class="symbol"><!--</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"> type that has been </span><span class="usertype">defined</span><span class="normal"> earlier </span><span class="symbol">--></span>
|
|
357
|
+
<span class="symbol"><!--</span><span class="normal"> flags must be the id of a flags type that has been </span><span class="usertype">defined</span><span class="normal"> earlier </span><span class="symbol">--></span>
|
|
358
|
+
<span class="symbol"><!--</span><span class="normal"> exactly one </span><span class="usertype">of</span><span class="normal"> type</span><span class="symbol">,</span><span class="normal"> </span><span class="keyword">enum</span><span class="normal"> or flags must </span><span class="usertype">be</span><span class="normal"> given </span><span class="symbol">--></span>
|
|
359
|
+
<span class="symbol"><!</span><span class="normal">ATTLIST key </span><span class="usertype">name</span><span class="normal"> CDATA #REQUIRED</span>
|
|
360
|
+
<span class="normal"> </span><span class="usertype">type</span><span class="normal"> CDATA #IMPLIED</span>
|
|
361
|
+
<span class="normal"> </span><span class="keyword">enum</span><span class="normal"> CDATA #IMPLIED</span>
|
|
362
|
+
<span class="normal"> </span><span class="usertype">flags</span><span class="normal"> CDATA #IMPLIED </span><span class="symbol">></span>
|
|
313
363
|
|
|
314
364
|
<span class="symbol"><!--</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>
|
|
315
365
|
<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">--></span>
|
|
@@ -343,7 +393,12 @@ described by the following DTD:
|
|
|
343
393
|
|
|
344
394
|
<span class="symbol"><!</span><span class="normal">ELEMENT </span><span class="usertype">child</span><span class="normal"> EMPTY </span><span class="symbol">></span>
|
|
345
395
|
<span class="symbol"><!</span><span class="normal">ATTLIST child </span><span class="usertype">name</span><span class="normal"> CDATA #REQUIRED</span>
|
|
346
|
-
<span class="normal"> </span><span class="usertype">schema</span><span class="normal"> CDATA #REQUIRED </span><span class="symbol">></span
|
|
396
|
+
<span class="normal"> </span><span class="usertype">schema</span><span class="normal"> CDATA #REQUIRED </span><span class="symbol">></span>
|
|
397
|
+
|
|
398
|
+
<span class="symbol"><!</span><span class="usertype">ELEMENT</span><span class="normal"> </span><span class="function">override</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">></span>
|
|
399
|
+
<span class="symbol"><!</span><span class="normal">ATTLIST override </span><span class="usertype">name</span><span class="normal"> CDATA #REQUIRED</span>
|
|
400
|
+
<span class="normal"> </span><span class="usertype">l10n</span><span class="normal"> CDATA #IMPLIED</span>
|
|
401
|
+
<span class="normal"> </span><span class="usertype">context</span><span class="normal"> CDATA #IMPLIED </span><span class="symbol">></span></pre></td>
|
|
347
402
|
</tr>
|
|
348
403
|
</tbody>
|
|
349
404
|
</table>
|
|
@@ -356,12 +411,26 @@ At runtime, schemas are identified by their id (as specified
|
|
|
356
411
|
in the <code class="sgmltag-attribute">id</code> attribute of the
|
|
357
412
|
<code class="sgmltag-starttag"><schema></code> element). The
|
|
358
413
|
convention for schema ids is to use a dotted name, similar in
|
|
359
|
-
style to a
|
|
414
|
+
style to a D-Bus bus name, e.g. "org.gnome.SessionManager". In particular,
|
|
415
|
+
if the settings are for a specific service that owns a D-Bus bus name,
|
|
416
|
+
the D-Bus bus name and schema id should match. For schemas which deal
|
|
417
|
+
with settings not associated with one named application, the id should
|
|
418
|
+
not use StudlyCaps, e.g. "org.gnome.font-rendering".
|
|
419
|
+
</p>
|
|
420
|
+
<p>
|
|
421
|
+
In addition to <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> types, keys can have types that have enumerated
|
|
422
|
+
types. These can be described by a <code class="sgmltag-starttag"><choice></code>,
|
|
423
|
+
<code class="sgmltag-starttag"><enum></code> or <code class="sgmltag-starttag"><flags></code> element, see
|
|
424
|
+
<a class="xref" href="GSettings.html#schema-enumerated" title="Example 12. Ranges, choices and enumerated types">Example 12, “Ranges, choices and enumerated types”</a>. The underlying type of
|
|
425
|
+
such a key is string, but you can use <a class="link" href="GSettings.html#g-settings-get-enum" title="g_settings_get_enum ()"><code class="function">g_settings_get_enum()</code></a>,
|
|
426
|
+
<a class="link" href="GSettings.html#g-settings-set-enum" title="g_settings_set_enum ()"><code class="function">g_settings_set_enum()</code></a>, <a class="link" href="GSettings.html#g-settings-get-flags" title="g_settings_get_flags ()"><code class="function">g_settings_get_flags()</code></a>, <a class="link" href="GSettings.html#g-settings-set-flags" title="g_settings_set_flags ()"><code class="function">g_settings_set_flags()</code></a>
|
|
427
|
+
access the numeric values corresponding to the string value of enum
|
|
428
|
+
and flags keys.
|
|
360
429
|
</p>
|
|
361
430
|
<p>
|
|
362
431
|
</p>
|
|
363
432
|
<div class="example">
|
|
364
|
-
<a name="
|
|
433
|
+
<a name="schema-default-values"></a><p class="title"><b>Example 11. Default values</b></p>
|
|
365
434
|
<div class="example-contents">
|
|
366
435
|
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
|
367
436
|
<tbody>
|
|
@@ -384,7 +453,7 @@ style to a DBus bus name, e.g. "org.gnome.font-rendering".
|
|
|
384
453
|
16
|
|
385
454
|
17</pre></td>
|
|
386
455
|
<td class="listing_code"><pre class="programlisting"><span class="symbol"><</span><span class="normal">schemalist</span><span class="symbol">></span>
|
|
387
|
-
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">schema</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"org.gtk.
|
|
456
|
+
<span class="normal"> </span><span class="symbol"><</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">></span>
|
|
388
457
|
|
|
389
458
|
<span class="normal"> </span><span class="symbol"><</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">></span>
|
|
390
459
|
<span class="normal"> </span><span class="symbol"><</span><span class="keyword">default</span><span class="normal"> l10n</span><span class="symbol">=</span><span class="string">"messages"</span><span class="symbol">></span><span class="string">"Hello, earthlings"</span><span class="symbol"></</span><span class="keyword">default</span><span class="symbol">></span>
|
|
@@ -411,7 +480,7 @@ style to a DBus bus name, e.g. "org.gnome.font-rendering".
|
|
|
411
480
|
<p>
|
|
412
481
|
</p>
|
|
413
482
|
<div class="example">
|
|
414
|
-
<a name="
|
|
483
|
+
<a name="schema-enumerated"></a><p class="title"><b>Example 12. Ranges, choices and enumerated types</b></p>
|
|
415
484
|
<div class="example-contents">
|
|
416
485
|
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
|
417
486
|
<tbody>
|
|
@@ -448,7 +517,16 @@ style to a DBus bus name, e.g. "org.gnome.font-rendering".
|
|
|
448
517
|
30
|
|
449
518
|
31
|
|
450
519
|
32
|
|
451
|
-
33
|
|
520
|
+
33
|
|
521
|
+
34
|
|
522
|
+
35
|
|
523
|
+
36
|
|
524
|
+
37
|
|
525
|
+
38
|
|
526
|
+
39
|
|
527
|
+
40
|
|
528
|
+
41
|
|
529
|
+
42</pre></td>
|
|
452
530
|
<td class="listing_code"><pre class="programlisting"><span class="symbol"><</span><span class="normal">schemalist</span><span class="symbol">></span>
|
|
453
531
|
|
|
454
532
|
<span class="normal"> </span><span class="symbol"><</span><span class="keyword">enum</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"myenum"</span><span class="symbol">></span>
|
|
@@ -456,7 +534,13 @@ style to a DBus bus name, e.g. "org.gnome.font-rendering".
|
|
|
456
534
|
<span class="normal"> </span><span class="symbol"><</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">/></span>
|
|
457
535
|
<span class="normal"> </span><span class="symbol"></</span><span class="keyword">enum</span><span class="symbol">></span>
|
|
458
536
|
|
|
459
|
-
<span class="normal"> </span><span class="symbol"><</span><span class="
|
|
537
|
+
<span class="normal"> </span><span class="symbol"><</span><span class="keyword">enum</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"myflags"</span><span class="symbol">></span>
|
|
538
|
+
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">value</span><span class="normal"> nick</span><span class="symbol">=</span><span class="string">"flag1"</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">"1"</span><span class="symbol">/></span>
|
|
539
|
+
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">value</span><span class="normal"> nick</span><span class="symbol">=</span><span class="string">"flag2"</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">"2"</span><span class="symbol">/></span>
|
|
540
|
+
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">value</span><span class="normal"> nick</span><span class="symbol">=</span><span class="string">"flag3"</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">"4"</span><span class="symbol">/></span>
|
|
541
|
+
<span class="normal"> </span><span class="symbol"></</span><span class="keyword">enum</span><span class="symbol">></span>
|
|
542
|
+
|
|
543
|
+
<span class="normal"> </span><span class="symbol"><</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">></span>
|
|
460
544
|
|
|
461
545
|
<span class="normal"> </span><span class="symbol"><</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">></span>
|
|
462
546
|
<span class="normal"> </span><span class="symbol"><</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">/></span>
|
|
@@ -480,8 +564,11 @@ style to a DBus bus name, e.g. "org.gnome.font-rendering".
|
|
|
480
564
|
<span class="normal"> </span><span class="symbol"><</span><span class="keyword">default</span><span class="symbol">></span><span class="string">'first'</span><span class="symbol"></</span><span class="keyword">default</span><span class="symbol">></span>
|
|
481
565
|
<span class="normal"> </span><span class="symbol"></</span><span class="normal">key</span><span class="symbol">></span>
|
|
482
566
|
|
|
483
|
-
<span class="normal">
|
|
484
|
-
<span class="symbol"><
|
|
567
|
+
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">key</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">'flags-key'</span><span class="normal"> flags</span><span class="symbol">=</span><span class="string">'myflags'</span><span class="symbol">></span>
|
|
568
|
+
<span class="normal"> </span><span class="symbol"><</span><span class="keyword">default</span><span class="symbol">>[</span><span class="string">"flag1"</span><span class="symbol">,</span><span class="normal">flag2</span><span class="string">"]</default></span>
|
|
569
|
+
<span class="string"> </key></span>
|
|
570
|
+
<span class="string"> </schema></span>
|
|
571
|
+
<span class="string"></schemalist></span></pre></td>
|
|
485
572
|
</tr>
|
|
486
573
|
</tbody>
|
|
487
574
|
</table>
|
|
@@ -490,8 +577,10 @@ style to a DBus bus name, e.g. "org.gnome.font-rendering".
|
|
|
490
577
|
</div>
|
|
491
578
|
<p><br class="example-break">
|
|
492
579
|
</p>
|
|
493
|
-
<
|
|
494
|
-
|
|
580
|
+
<p>
|
|
581
|
+
</p>
|
|
582
|
+
<div class="refsect2">
|
|
583
|
+
<a name="id958485"></a><h3>Vendor overrides</h3>
|
|
495
584
|
<p>
|
|
496
585
|
Default values are defined in the schemas that get installed by
|
|
497
586
|
an application. Sometimes, it is necessary for a vendor or distributor
|
|
@@ -521,9 +610,12 @@ style to a DBus bus name, e.g. "org.gnome.font-rendering".
|
|
|
521
610
|
<p>
|
|
522
611
|
</p>
|
|
523
612
|
</div>
|
|
524
|
-
<
|
|
525
|
-
|
|
526
|
-
<
|
|
613
|
+
<p>
|
|
614
|
+
</p>
|
|
615
|
+
<p>
|
|
616
|
+
</p>
|
|
617
|
+
<div class="refsect2">
|
|
618
|
+
<a name="id958518"></a><h3>Binding</h3>
|
|
527
619
|
<p>
|
|
528
620
|
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
|
|
529
621
|
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
|
|
@@ -541,19 +633,21 @@ style to a DBus bus name, e.g. "org.gnome.font-rendering".
|
|
|
541
633
|
<a class="link" href="GSettings.html#G-SETTINGS-BIND-NO-SENSITIVITY:CAPS"><span class="type">G_SETTINGS_BIND_NO_SENSITIVITY</span></a> flag.
|
|
542
634
|
</p>
|
|
543
635
|
</div>
|
|
636
|
+
<p>
|
|
637
|
+
</p>
|
|
544
638
|
</div>
|
|
545
|
-
<div class="refsect1"
|
|
639
|
+
<div class="refsect1">
|
|
546
640
|
<a name="GSettings.details"></a><h2>Details</h2>
|
|
547
|
-
<div class="refsect2"
|
|
641
|
+
<div class="refsect2">
|
|
548
642
|
<a name="GSettings-struct"></a><h3>GSettings</h3>
|
|
549
643
|
<pre class="programlisting">typedef struct _GSettings GSettings;</pre>
|
|
550
644
|
<p>
|
|
551
645
|
</p>
|
|
552
646
|
</div>
|
|
553
647
|
<hr>
|
|
554
|
-
<div class="refsect2"
|
|
648
|
+
<div class="refsect2">
|
|
555
649
|
<a name="g-settings-new"></a><h3>g_settings_new ()</h3>
|
|
556
|
-
<pre class="programlisting"><a class="link" href="GSettings.html" title="GSettings"><span class="returnvalue">GSettings</span></a> *
|
|
650
|
+
<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>
|
|
557
651
|
<p>
|
|
558
652
|
Creates a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object with a given schema.
|
|
559
653
|
</p>
|
|
@@ -568,22 +662,20 @@ on the context. See <a href="http://library.gnome.org/devel/glib/unstable/glib-
|
|
|
568
662
|
<tbody>
|
|
569
663
|
<tr>
|
|
570
664
|
<td><p><span class="term"><em class="parameter"><code>schema</code></em> :</span></p></td>
|
|
571
|
-
<td>the name of the schema
|
|
572
|
-
</td>
|
|
665
|
+
<td>the name of the schema</td>
|
|
573
666
|
</tr>
|
|
574
667
|
<tr>
|
|
575
668
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
576
|
-
<td>a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
577
|
-
</td>
|
|
669
|
+
<td>a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
578
670
|
</tr>
|
|
579
671
|
</tbody>
|
|
580
672
|
</table></div>
|
|
581
673
|
<p class="since">Since 2.26</p>
|
|
582
674
|
</div>
|
|
583
675
|
<hr>
|
|
584
|
-
<div class="refsect2"
|
|
676
|
+
<div class="refsect2">
|
|
585
677
|
<a name="g-settings-new-with-path"></a><h3>g_settings_new_with_path ()</h3>
|
|
586
|
-
<pre class="programlisting"><a class="link" href="GSettings.html" title="GSettings"><span class="returnvalue">GSettings</span></a> *
|
|
678
|
+
<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>,
|
|
587
679
|
<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>
|
|
588
680
|
<p>
|
|
589
681
|
Creates a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object with a given schema and path.
|
|
@@ -602,27 +694,24 @@ has an explicitly specified path.
|
|
|
602
694
|
<tbody>
|
|
603
695
|
<tr>
|
|
604
696
|
<td><p><span class="term"><em class="parameter"><code>schema</code></em> :</span></p></td>
|
|
605
|
-
<td>the name of the schema
|
|
606
|
-
</td>
|
|
697
|
+
<td>the name of the schema</td>
|
|
607
698
|
</tr>
|
|
608
699
|
<tr>
|
|
609
700
|
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
|
|
610
|
-
<td>the path to use
|
|
611
|
-
</td>
|
|
701
|
+
<td>the path to use</td>
|
|
612
702
|
</tr>
|
|
613
703
|
<tr>
|
|
614
704
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
615
|
-
<td>a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
616
|
-
</td>
|
|
705
|
+
<td>a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
617
706
|
</tr>
|
|
618
707
|
</tbody>
|
|
619
708
|
</table></div>
|
|
620
709
|
<p class="since">Since 2.26</p>
|
|
621
710
|
</div>
|
|
622
711
|
<hr>
|
|
623
|
-
<div class="refsect2"
|
|
712
|
+
<div class="refsect2">
|
|
624
713
|
<a name="g-settings-new-with-backend"></a><h3>g_settings_new_with_backend ()</h3>
|
|
625
|
-
<pre class="programlisting"><a class="link" href="GSettings.html" title="GSettings"><span class="returnvalue">GSettings</span></a> *
|
|
714
|
+
<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>,
|
|
626
715
|
<em class="parameter"><code><a class="link" href="GSettingsBackend.html" title="GSettingsBackend"><span class="type">GSettingsBackend</span></a> *backend</code></em>);</pre>
|
|
627
716
|
<p>
|
|
628
717
|
Creates a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object with a given schema and backend.
|
|
@@ -639,27 +728,24 @@ settings instead of the settings for this user.
|
|
|
639
728
|
<tbody>
|
|
640
729
|
<tr>
|
|
641
730
|
<td><p><span class="term"><em class="parameter"><code>schema</code></em> :</span></p></td>
|
|
642
|
-
<td>the name of the schema
|
|
643
|
-
</td>
|
|
731
|
+
<td>the name of the schema</td>
|
|
644
732
|
</tr>
|
|
645
733
|
<tr>
|
|
646
734
|
<td><p><span class="term"><em class="parameter"><code>backend</code></em> :</span></p></td>
|
|
647
|
-
<td>the <a class="link" href="GSettingsBackend.html" title="GSettingsBackend"><span class="type">GSettingsBackend</span></a> to use
|
|
648
|
-
</td>
|
|
735
|
+
<td>the <a class="link" href="GSettingsBackend.html" title="GSettingsBackend"><span class="type">GSettingsBackend</span></a> to use</td>
|
|
649
736
|
</tr>
|
|
650
737
|
<tr>
|
|
651
738
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
652
|
-
<td>a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
653
|
-
</td>
|
|
739
|
+
<td>a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
654
740
|
</tr>
|
|
655
741
|
</tbody>
|
|
656
742
|
</table></div>
|
|
657
743
|
<p class="since">Since 2.26</p>
|
|
658
744
|
</div>
|
|
659
745
|
<hr>
|
|
660
|
-
<div class="refsect2"
|
|
746
|
+
<div class="refsect2">
|
|
661
747
|
<a name="g-settings-new-with-backend-and-path"></a><h3>g_settings_new_with_backend_and_path ()</h3>
|
|
662
|
-
<pre class="programlisting"><a class="link" href="GSettings.html" title="GSettings"><span class="returnvalue">GSettings</span></a> *
|
|
748
|
+
<pre class="programlisting"><a class="link" href="GSettings.html" title="GSettings"><span class="returnvalue">GSettings</span></a> * g_settings_new_with_backend_and_path
|
|
663
749
|
(<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>,
|
|
664
750
|
<em class="parameter"><code><a class="link" href="GSettingsBackend.html" title="GSettingsBackend"><span class="type">GSettingsBackend</span></a> *backend</code></em>,
|
|
665
751
|
<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>
|
|
@@ -676,30 +762,26 @@ This is a mix of <a class="link" href="GSettings.html#g-settings-new-with-backen
|
|
|
676
762
|
<tbody>
|
|
677
763
|
<tr>
|
|
678
764
|
<td><p><span class="term"><em class="parameter"><code>schema</code></em> :</span></p></td>
|
|
679
|
-
<td>the name of the schema
|
|
680
|
-
</td>
|
|
765
|
+
<td>the name of the schema</td>
|
|
681
766
|
</tr>
|
|
682
767
|
<tr>
|
|
683
768
|
<td><p><span class="term"><em class="parameter"><code>backend</code></em> :</span></p></td>
|
|
684
|
-
<td>the <a class="link" href="GSettingsBackend.html" title="GSettingsBackend"><span class="type">GSettingsBackend</span></a> to use
|
|
685
|
-
</td>
|
|
769
|
+
<td>the <a class="link" href="GSettingsBackend.html" title="GSettingsBackend"><span class="type">GSettingsBackend</span></a> to use</td>
|
|
686
770
|
</tr>
|
|
687
771
|
<tr>
|
|
688
772
|
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
|
|
689
|
-
<td>the path to use
|
|
690
|
-
</td>
|
|
773
|
+
<td>the path to use</td>
|
|
691
774
|
</tr>
|
|
692
775
|
<tr>
|
|
693
776
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
694
|
-
<td>a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
695
|
-
</td>
|
|
777
|
+
<td>a new <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
696
778
|
</tr>
|
|
697
779
|
</tbody>
|
|
698
780
|
</table></div>
|
|
699
781
|
<p class="since">Since 2.26</p>
|
|
700
782
|
</div>
|
|
701
783
|
<hr>
|
|
702
|
-
<div class="refsect2"
|
|
784
|
+
<div class="refsect2">
|
|
703
785
|
<a name="g-settings-sync"></a><h3>g_settings_sync ()</h3>
|
|
704
786
|
<pre class="programlisting"><span class="returnvalue">void</span> g_settings_sync (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
|
705
787
|
<p>
|
|
@@ -719,9 +801,9 @@ time the call is done).
|
|
|
719
801
|
</p>
|
|
720
802
|
</div>
|
|
721
803
|
<hr>
|
|
722
|
-
<div class="refsect2"
|
|
804
|
+
<div class="refsect2">
|
|
723
805
|
<a name="g-settings-get-value"></a><h3>g_settings_get_value ()</h3>
|
|
724
|
-
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
|
|
806
|
+
<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>,
|
|
725
807
|
<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>
|
|
726
808
|
<p>
|
|
727
809
|
Gets the value that is stored in <em class="parameter"><code>settings</code></em> for <em class="parameter"><code>key</code></em>.
|
|
@@ -735,13 +817,11 @@ schema for <em class="parameter"><code>settings</code></em>.
|
|
|
735
817
|
<tbody>
|
|
736
818
|
<tr>
|
|
737
819
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
738
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
739
|
-
</td>
|
|
820
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
740
821
|
</tr>
|
|
741
822
|
<tr>
|
|
742
823
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
743
|
-
<td>the key to get the value for
|
|
744
|
-
</td>
|
|
824
|
+
<td>the key to get the value for</td>
|
|
745
825
|
</tr>
|
|
746
826
|
<tr>
|
|
747
827
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
@@ -753,7 +833,7 @@ schema for <em class="parameter"><code>settings</code></em>.
|
|
|
753
833
|
<p class="since">Since 2.26</p>
|
|
754
834
|
</div>
|
|
755
835
|
<hr>
|
|
756
|
-
<div class="refsect2"
|
|
836
|
+
<div class="refsect2">
|
|
757
837
|
<a name="g-settings-set-value"></a><h3>g_settings_set_value ()</h3>
|
|
758
838
|
<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>,
|
|
759
839
|
<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>,
|
|
@@ -774,32 +854,28 @@ If <em class="parameter"><code>value</code></em> is floating then this function
|
|
|
774
854
|
<tbody>
|
|
775
855
|
<tr>
|
|
776
856
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
777
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
778
|
-
</td>
|
|
857
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
779
858
|
</tr>
|
|
780
859
|
<tr>
|
|
781
860
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
782
|
-
<td>the name of the key to set
|
|
783
|
-
</td>
|
|
861
|
+
<td>the name of the key to set</td>
|
|
784
862
|
</tr>
|
|
785
863
|
<tr>
|
|
786
864
|
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
787
|
-
<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
|
|
788
|
-
</td>
|
|
865
|
+
<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</td>
|
|
789
866
|
</tr>
|
|
790
867
|
<tr>
|
|
791
868
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
792
869
|
<td>
|
|
793
870
|
<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,
|
|
794
|
-
|
|
795
|
-
</td>
|
|
871
|
+
<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</td>
|
|
796
872
|
</tr>
|
|
797
873
|
</tbody>
|
|
798
874
|
</table></div>
|
|
799
875
|
<p class="since">Since 2.26</p>
|
|
800
876
|
</div>
|
|
801
877
|
<hr>
|
|
802
|
-
<div class="refsect2"
|
|
878
|
+
<div class="refsect2">
|
|
803
879
|
<a name="g-settings-is-writable"></a><h3>g_settings_is_writable ()</h3>
|
|
804
880
|
<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>,
|
|
805
881
|
<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>
|
|
@@ -811,26 +887,23 @@ Finds out if a key can be written or not
|
|
|
811
887
|
<tbody>
|
|
812
888
|
<tr>
|
|
813
889
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
814
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
815
|
-
</td>
|
|
890
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
816
891
|
</tr>
|
|
817
892
|
<tr>
|
|
818
893
|
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
|
|
819
|
-
<td>the name of a key
|
|
820
|
-
</td>
|
|
894
|
+
<td>the name of a key</td>
|
|
821
895
|
</tr>
|
|
822
896
|
<tr>
|
|
823
897
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
824
898
|
<td>
|
|
825
|
-
<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
|
|
826
|
-
</td>
|
|
899
|
+
<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</td>
|
|
827
900
|
</tr>
|
|
828
901
|
</tbody>
|
|
829
902
|
</table></div>
|
|
830
903
|
<p class="since">Since 2.26</p>
|
|
831
904
|
</div>
|
|
832
905
|
<hr>
|
|
833
|
-
<div class="refsect2"
|
|
906
|
+
<div class="refsect2">
|
|
834
907
|
<a name="g-settings-delay"></a><h3>g_settings_delay ()</h3>
|
|
835
908
|
<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>
|
|
836
909
|
<p>
|
|
@@ -842,14 +915,13 @@ backend, but kept locally until <a class="link" href="GSettings.html#g-settings-
|
|
|
842
915
|
<col align="left" valign="top">
|
|
843
916
|
<tbody><tr>
|
|
844
917
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
845
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
846
|
-
</td>
|
|
918
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
847
919
|
</tr></tbody>
|
|
848
920
|
</table></div>
|
|
849
921
|
<p class="since">Since 2.26</p>
|
|
850
922
|
</div>
|
|
851
923
|
<hr>
|
|
852
|
-
<div class="refsect2"
|
|
924
|
+
<div class="refsect2">
|
|
853
925
|
<a name="g-settings-apply"></a><h3>g_settings_apply ()</h3>
|
|
854
926
|
<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>
|
|
855
927
|
<p>
|
|
@@ -862,13 +934,12 @@ applied immediately.
|
|
|
862
934
|
<col align="left" valign="top">
|
|
863
935
|
<tbody><tr>
|
|
864
936
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
865
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> instance
|
|
866
|
-
</td>
|
|
937
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> instance</td>
|
|
867
938
|
</tr></tbody>
|
|
868
939
|
</table></div>
|
|
869
940
|
</div>
|
|
870
941
|
<hr>
|
|
871
|
-
<div class="refsect2"
|
|
942
|
+
<div class="refsect2">
|
|
872
943
|
<a name="g-settings-revert"></a><h3>g_settings_revert ()</h3>
|
|
873
944
|
<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>
|
|
874
945
|
<p>
|
|
@@ -884,13 +955,12 @@ Change notifications will be emitted for affected keys.
|
|
|
884
955
|
<col align="left" valign="top">
|
|
885
956
|
<tbody><tr>
|
|
886
957
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
887
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> instance
|
|
888
|
-
</td>
|
|
958
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> instance</td>
|
|
889
959
|
</tr></tbody>
|
|
890
960
|
</table></div>
|
|
891
961
|
</div>
|
|
892
962
|
<hr>
|
|
893
|
-
<div class="refsect2"
|
|
963
|
+
<div class="refsect2">
|
|
894
964
|
<a name="g-settings-get-has-unapplied"></a><h3>g_settings_get_has_unapplied ()</h3>
|
|
895
965
|
<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>
|
|
896
966
|
<p>
|
|
@@ -902,27 +972,25 @@ changes. This can only be the case if it is in 'delayed-apply' mode.
|
|
|
902
972
|
<tbody>
|
|
903
973
|
<tr>
|
|
904
974
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
905
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
906
|
-
</td>
|
|
975
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
907
976
|
</tr>
|
|
908
977
|
<tr>
|
|
909
978
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
910
979
|
<td>
|
|
911
|
-
<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
|
|
912
|
-
</td>
|
|
980
|
+
<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</td>
|
|
913
981
|
</tr>
|
|
914
982
|
</tbody>
|
|
915
983
|
</table></div>
|
|
916
984
|
<p class="since">Since 2.26</p>
|
|
917
985
|
</div>
|
|
918
986
|
<hr>
|
|
919
|
-
<div class="refsect2"
|
|
987
|
+
<div class="refsect2">
|
|
920
988
|
<a name="g-settings-get-child"></a><h3>g_settings_get_child ()</h3>
|
|
921
|
-
<pre class="programlisting"><a class="link" href="GSettings.html" title="GSettings"><span class="returnvalue">GSettings</span></a> *
|
|
989
|
+
<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>,
|
|
922
990
|
<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>
|
|
923
991
|
<p>
|
|
924
992
|
Creates a 'child' settings object which has a base path of
|
|
925
|
-
<em class="replaceable"><code>base-path</code></em>/<em class="parameter"><code>name</code></em
|
|
993
|
+
<em class="replaceable"><code>base-path</code></em>/<em class="parameter"><code>name</code></em>, where
|
|
926
994
|
<em class="replaceable"><code>base-path</code></em> is the base path of <em class="parameter"><code>settings</code></em>.
|
|
927
995
|
</p>
|
|
928
996
|
<p>
|
|
@@ -934,17 +1002,15 @@ in the schema of <em class="parameter"><code>settings</code></em> using a <code
|
|
|
934
1002
|
<tbody>
|
|
935
1003
|
<tr>
|
|
936
1004
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
937
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
938
|
-
</td>
|
|
1005
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
939
1006
|
</tr>
|
|
940
1007
|
<tr>
|
|
941
1008
|
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
|
|
942
|
-
<td>the name of the 'child' schema
|
|
943
|
-
</td>
|
|
1009
|
+
<td>the name of the 'child' schema</td>
|
|
944
1010
|
</tr>
|
|
945
1011
|
<tr>
|
|
946
1012
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
947
|
-
<td>a 'child' settings object
|
|
1013
|
+
<td>a 'child' settings object. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
|
|
948
1014
|
</td>
|
|
949
1015
|
</tr>
|
|
950
1016
|
</tbody>
|
|
@@ -952,7 +1018,7 @@ in the schema of <em class="parameter"><code>settings</code></em> using a <code
|
|
|
952
1018
|
<p class="since">Since 2.26</p>
|
|
953
1019
|
</div>
|
|
954
1020
|
<hr>
|
|
955
|
-
<div class="refsect2"
|
|
1021
|
+
<div class="refsect2">
|
|
956
1022
|
<a name="g-settings-reset"></a><h3>g_settings_reset ()</h3>
|
|
957
1023
|
<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>,
|
|
958
1024
|
<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>
|
|
@@ -969,19 +1035,270 @@ administrator.
|
|
|
969
1035
|
<tbody>
|
|
970
1036
|
<tr>
|
|
971
1037
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
972
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1038
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1039
|
+
</tr>
|
|
1040
|
+
<tr>
|
|
1041
|
+
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1042
|
+
<td>the name of a key</td>
|
|
1043
|
+
</tr>
|
|
1044
|
+
</tbody>
|
|
1045
|
+
</table></div>
|
|
1046
|
+
</div>
|
|
1047
|
+
<hr>
|
|
1048
|
+
<div class="refsect2">
|
|
1049
|
+
<a name="g-settings-list-schemas"></a><h3>g_settings_list_schemas ()</h3>
|
|
1050
|
+
<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>
|
|
1051
|
+
<p>
|
|
1052
|
+
Gets a list of the <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> schemas installed on the system. The
|
|
1053
|
+
returned list is exactly the list of schemas for which you may call
|
|
1054
|
+
<a class="link" href="GSettings.html#g-settings-new" title="g_settings_new ()"><code class="function">g_settings_new()</code></a> without adverse effects.
|
|
1055
|
+
</p>
|
|
1056
|
+
<p>
|
|
1057
|
+
This function does not list the schemas that do not provide their own
|
|
1058
|
+
paths (ie: schemas for which you must use
|
|
1059
|
+
<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>). See
|
|
1060
|
+
<a class="link" href="GSettings.html#g-settings-list-relocatable-schemas" title="g_settings_list_relocatable_schemas ()"><code class="function">g_settings_list_relocatable_schemas()</code></a> for that.
|
|
1061
|
+
</p>
|
|
1062
|
+
<div class="variablelist"><table border="0">
|
|
1063
|
+
<col align="left" valign="top">
|
|
1064
|
+
<tbody><tr>
|
|
1065
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1066
|
+
<td>a list of <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a>
|
|
1067
|
+
schemas that are available. The list must not be modified or
|
|
1068
|
+
freed. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
|
|
1069
|
+
</td>
|
|
1070
|
+
</tr></tbody>
|
|
1071
|
+
</table></div>
|
|
1072
|
+
<p class="since">Since 2.26</p>
|
|
1073
|
+
</div>
|
|
1074
|
+
<hr>
|
|
1075
|
+
<div class="refsect2">
|
|
1076
|
+
<a name="g-settings-list-relocatable-schemas"></a><h3>g_settings_list_relocatable_schemas ()</h3>
|
|
1077
|
+
<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_relocatable_schemas
|
|
1078
|
+
(<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
|
1079
|
+
<p>
|
|
1080
|
+
Gets a list of the relocatable <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> schemas installed on the
|
|
1081
|
+
system. These are schemas that do not provide their own path. It is
|
|
1082
|
+
usual to instantiate these schemas directly, but if you want to you
|
|
1083
|
+
can use <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> to specify the path.
|
|
1084
|
+
</p>
|
|
1085
|
+
<p>
|
|
1086
|
+
The output of this function, tTaken together with the output of
|
|
1087
|
+
<a class="link" href="GSettings.html#g-settings-list-schemas" title="g_settings_list_schemas ()"><code class="function">g_settings_list_schemas()</code></a> represents the complete list of all
|
|
1088
|
+
installed schemas.
|
|
1089
|
+
</p>
|
|
1090
|
+
<div class="variablelist"><table border="0">
|
|
1091
|
+
<col align="left" valign="top">
|
|
1092
|
+
<tbody><tr>
|
|
1093
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1094
|
+
<td>a list of relocatable
|
|
1095
|
+
<a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> schemas that are available. The list must not be
|
|
1096
|
+
modified or freed. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
|
|
1097
|
+
</td>
|
|
1098
|
+
</tr></tbody>
|
|
1099
|
+
</table></div>
|
|
1100
|
+
<p class="since">Since 2.28</p>
|
|
1101
|
+
</div>
|
|
1102
|
+
<hr>
|
|
1103
|
+
<div class="refsect2">
|
|
1104
|
+
<a name="g-settings-list-keys"></a><h3>g_settings_list_keys ()</h3>
|
|
1105
|
+
<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_list_keys (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>);</pre>
|
|
1106
|
+
<p>
|
|
1107
|
+
Introspects the list of keys on <em class="parameter"><code>settings</code></em>.
|
|
1108
|
+
</p>
|
|
1109
|
+
<p>
|
|
1110
|
+
You should probably not be calling this function from "normal" code
|
|
1111
|
+
(since you should already know what keys are in your schema). This
|
|
1112
|
+
function is intended for introspection reasons.
|
|
1113
|
+
</p>
|
|
1114
|
+
<p>
|
|
1115
|
+
You should free the return value with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> when you are done
|
|
1116
|
+
with it.
|
|
1117
|
+
</p>
|
|
1118
|
+
<div class="variablelist"><table border="0">
|
|
1119
|
+
<col align="left" valign="top">
|
|
1120
|
+
<tbody>
|
|
1121
|
+
<tr>
|
|
1122
|
+
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1123
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1124
|
+
</tr>
|
|
1125
|
+
<tr>
|
|
1126
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1127
|
+
<td>a list of the keys on <em class="parameter"><code>settings</code></em>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span>
|
|
1128
|
+
</td>
|
|
1129
|
+
</tr>
|
|
1130
|
+
</tbody>
|
|
1131
|
+
</table></div>
|
|
1132
|
+
</div>
|
|
1133
|
+
<hr>
|
|
1134
|
+
<div class="refsect2">
|
|
1135
|
+
<a name="g-settings-list-children"></a><h3>g_settings_list_children ()</h3>
|
|
1136
|
+
<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_list_children (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>);</pre>
|
|
1137
|
+
<p>
|
|
1138
|
+
Gets the list of children on <em class="parameter"><code>settings</code></em>.
|
|
1139
|
+
</p>
|
|
1140
|
+
<p>
|
|
1141
|
+
The list is exactly the list of strings for which it is not an error
|
|
1142
|
+
to call <a class="link" href="GSettings.html#g-settings-get-child" title="g_settings_get_child ()"><code class="function">g_settings_get_child()</code></a>.
|
|
1143
|
+
</p>
|
|
1144
|
+
<p>
|
|
1145
|
+
For GSettings objects that are lists, this value can change at any
|
|
1146
|
+
time and you should connect to the "children-changed" signal to watch
|
|
1147
|
+
for those changes. Note that there is a race condition here: you may
|
|
1148
|
+
request a child after listing it only for it to have been destroyed
|
|
1149
|
+
in the meantime. For this reason, <a class="link" href="GSettings.html#g-settings-get-child" title="g_settings_get_child ()"><code class="function">g_settings_get_child()</code></a> may return
|
|
1150
|
+
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> even for a child that was listed by this function.
|
|
1151
|
+
</p>
|
|
1152
|
+
<p>
|
|
1153
|
+
For GSettings objects that are not lists, you should probably not be
|
|
1154
|
+
calling this function from "normal" code (since you should already
|
|
1155
|
+
know what children are in your schema). This function may still be
|
|
1156
|
+
useful there for introspection reasons, however.
|
|
1157
|
+
</p>
|
|
1158
|
+
<p>
|
|
1159
|
+
You should free the return value with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> when you are done
|
|
1160
|
+
with it.
|
|
1161
|
+
</p>
|
|
1162
|
+
<div class="variablelist"><table border="0">
|
|
1163
|
+
<col align="left" valign="top">
|
|
1164
|
+
<tbody>
|
|
1165
|
+
<tr>
|
|
1166
|
+
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1167
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1168
|
+
</tr>
|
|
1169
|
+
<tr>
|
|
1170
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1171
|
+
<td>a list of the children on <em class="parameter"><code>settings</code></em>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span>
|
|
1172
|
+
</td>
|
|
1173
|
+
</tr>
|
|
1174
|
+
</tbody>
|
|
1175
|
+
</table></div>
|
|
1176
|
+
</div>
|
|
1177
|
+
<hr>
|
|
1178
|
+
<div class="refsect2">
|
|
1179
|
+
<a name="g-settings-get-range"></a><h3>g_settings_get_range ()</h3>
|
|
1180
|
+
<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_range (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
|
|
1181
|
+
<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>
|
|
1182
|
+
<p>
|
|
1183
|
+
Queries the range of a key.
|
|
1184
|
+
</p>
|
|
1185
|
+
<p>
|
|
1186
|
+
This function will return a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> that fully describes the range
|
|
1187
|
+
of values that are valid for <em class="parameter"><code>key</code></em>.
|
|
1188
|
+
</p>
|
|
1189
|
+
<p>
|
|
1190
|
+
The type of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> returned is <code class="literal">(sv)</code>. The
|
|
1191
|
+
string describes the type of range restriction in effect. The type
|
|
1192
|
+
and meaning of the value contained in the variant depends on the
|
|
1193
|
+
string.
|
|
1194
|
+
</p>
|
|
1195
|
+
<p>
|
|
1196
|
+
If the string is <code class="literal">'type'</code> then the variant contains
|
|
1197
|
+
an empty array. The element type of that empty array is the expected
|
|
1198
|
+
type of value and all values of that type are valid.
|
|
1199
|
+
</p>
|
|
1200
|
+
<p>
|
|
1201
|
+
If the string is <code class="literal">'enum'</code> then the variant contains
|
|
1202
|
+
an array enumerating the possible values. Each item in the array is
|
|
1203
|
+
a possible valid value and no other values are valid.
|
|
1204
|
+
</p>
|
|
1205
|
+
<p>
|
|
1206
|
+
If the string is <code class="literal">'flags'</code> then the variant contains
|
|
1207
|
+
an array. Each item in the array is a value that may appear zero or
|
|
1208
|
+
one times in an array to be used as the value for this key. For
|
|
1209
|
+
example, if the variant contained the array <code class="literal">['x',
|
|
1210
|
+
'y']</code> then the valid values for the key would be
|
|
1211
|
+
<code class="literal">[]</code>, <code class="literal">['x']</code>,
|
|
1212
|
+
<code class="literal">['y']</code>, <code class="literal">['x', 'y']</code> and
|
|
1213
|
+
<code class="literal">['y', 'x']</code>.
|
|
1214
|
+
</p>
|
|
1215
|
+
<p>
|
|
1216
|
+
Finally, if the string is <code class="literal">'range'</code> then the variant
|
|
1217
|
+
contains a pair of like-typed values -- the minimum and maximum
|
|
1218
|
+
permissible values for this key.
|
|
1219
|
+
</p>
|
|
1220
|
+
<p>
|
|
1221
|
+
This information should not be used by normal programs. It is
|
|
1222
|
+
considered to be a hint for introspection purposes. Normal programs
|
|
1223
|
+
should already know what is permitted by their own schema. The
|
|
1224
|
+
format may change in any way in the future -- but particularly, new
|
|
1225
|
+
forms may be added to the possibilities described above.
|
|
1226
|
+
</p>
|
|
1227
|
+
<p>
|
|
1228
|
+
It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't contained in the
|
|
1229
|
+
schema for <em class="parameter"><code>settings</code></em>.
|
|
1230
|
+
</p>
|
|
1231
|
+
<p>
|
|
1232
|
+
You should free the returned value with <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a> when it is
|
|
1233
|
+
no longer needed.
|
|
1234
|
+
</p>
|
|
1235
|
+
<div class="variablelist"><table border="0">
|
|
1236
|
+
<col align="left" valign="top">
|
|
1237
|
+
<tbody>
|
|
1238
|
+
<tr>
|
|
1239
|
+
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1240
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a>
|
|
1241
|
+
</td>
|
|
1242
|
+
</tr>
|
|
1243
|
+
<tr>
|
|
1244
|
+
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1245
|
+
<td>the key to query the range of</td>
|
|
1246
|
+
</tr>
|
|
1247
|
+
<tr>
|
|
1248
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1249
|
+
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> describing the range</td>
|
|
1250
|
+
</tr>
|
|
1251
|
+
</tbody>
|
|
1252
|
+
</table></div>
|
|
1253
|
+
<p class="since">Since 2.28</p>
|
|
1254
|
+
</div>
|
|
1255
|
+
<hr>
|
|
1256
|
+
<div class="refsect2">
|
|
1257
|
+
<a name="g-settings-range-check"></a><h3>g_settings_range_check ()</h3>
|
|
1258
|
+
<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_range_check (<em class="parameter"><code><a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> *settings</code></em>,
|
|
1259
|
+
<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>,
|
|
1260
|
+
<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>
|
|
1261
|
+
<p>
|
|
1262
|
+
Checks if the given <em class="parameter"><code>value</code></em> is of the correct type and within the
|
|
1263
|
+
permitted range for <em class="parameter"><code>key</code></em>.
|
|
1264
|
+
</p>
|
|
1265
|
+
<p>
|
|
1266
|
+
This API is not intended to be used by normal programs -- they should
|
|
1267
|
+
already know what is permitted by their own schemas. This API is
|
|
1268
|
+
meant to be used by programs such as editors or commandline tools.
|
|
1269
|
+
</p>
|
|
1270
|
+
<p>
|
|
1271
|
+
It is a programmer error to give a <em class="parameter"><code>key</code></em> that isn't contained in the
|
|
1272
|
+
schema for <em class="parameter"><code>settings</code></em>.
|
|
1273
|
+
</p>
|
|
1274
|
+
<div class="variablelist"><table border="0">
|
|
1275
|
+
<col align="left" valign="top">
|
|
1276
|
+
<tbody>
|
|
1277
|
+
<tr>
|
|
1278
|
+
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1279
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a>
|
|
973
1280
|
</td>
|
|
974
1281
|
</tr>
|
|
975
1282
|
<tr>
|
|
976
1283
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
977
|
-
<td>the
|
|
1284
|
+
<td>the key to check</td>
|
|
1285
|
+
</tr>
|
|
1286
|
+
<tr>
|
|
1287
|
+
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
1288
|
+
<td>the value to check</td>
|
|
1289
|
+
</tr>
|
|
1290
|
+
<tr>
|
|
1291
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1292
|
+
<td>
|
|
1293
|
+
<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>value</code></em> is valid for <em class="parameter"><code>key</code></em>
|
|
978
1294
|
</td>
|
|
979
1295
|
</tr>
|
|
980
1296
|
</tbody>
|
|
981
1297
|
</table></div>
|
|
1298
|
+
<p class="since">Since 2.28</p>
|
|
982
1299
|
</div>
|
|
983
1300
|
<hr>
|
|
984
|
-
<div class="refsect2"
|
|
1301
|
+
<div class="refsect2">
|
|
985
1302
|
<a name="g-settings-get"></a><h3>g_settings_get ()</h3>
|
|
986
1303
|
<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>,
|
|
987
1304
|
<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>,
|
|
@@ -1004,18 +1321,15 @@ the type given in the schema.
|
|
|
1004
1321
|
<tbody>
|
|
1005
1322
|
<tr>
|
|
1006
1323
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1007
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1008
|
-
</td>
|
|
1324
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1009
1325
|
</tr>
|
|
1010
1326
|
<tr>
|
|
1011
1327
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1012
|
-
<td>the key to get the value for
|
|
1013
|
-
</td>
|
|
1328
|
+
<td>the key to get the value for</td>
|
|
1014
1329
|
</tr>
|
|
1015
1330
|
<tr>
|
|
1016
1331
|
<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
|
|
1017
|
-
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> format string
|
|
1018
|
-
</td>
|
|
1332
|
+
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> format string</td>
|
|
1019
1333
|
</tr>
|
|
1020
1334
|
<tr>
|
|
1021
1335
|
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
|
|
@@ -1027,7 +1341,7 @@ the type given in the schema.
|
|
|
1027
1341
|
<p class="since">Since 2.26</p>
|
|
1028
1342
|
</div>
|
|
1029
1343
|
<hr>
|
|
1030
|
-
<div class="refsect2"
|
|
1344
|
+
<div class="refsect2">
|
|
1031
1345
|
<a name="g-settings-set"></a><h3>g_settings_set ()</h3>
|
|
1032
1346
|
<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>,
|
|
1033
1347
|
<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>,
|
|
@@ -1050,18 +1364,15 @@ the type given in the schema.
|
|
|
1050
1364
|
<tbody>
|
|
1051
1365
|
<tr>
|
|
1052
1366
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1053
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1054
|
-
</td>
|
|
1367
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1055
1368
|
</tr>
|
|
1056
1369
|
<tr>
|
|
1057
1370
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1058
|
-
<td>the name of the key to set
|
|
1059
|
-
</td>
|
|
1371
|
+
<td>the name of the key to set</td>
|
|
1060
1372
|
</tr>
|
|
1061
1373
|
<tr>
|
|
1062
1374
|
<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
|
|
1063
|
-
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> format string
|
|
1064
|
-
</td>
|
|
1375
|
+
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> format string</td>
|
|
1065
1376
|
</tr>
|
|
1066
1377
|
<tr>
|
|
1067
1378
|
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
|
|
@@ -1072,15 +1383,14 @@ the type given in the schema.
|
|
|
1072
1383
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1073
1384
|
<td>
|
|
1074
1385
|
<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,
|
|
1075
|
-
|
|
1076
|
-
</td>
|
|
1386
|
+
<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</td>
|
|
1077
1387
|
</tr>
|
|
1078
1388
|
</tbody>
|
|
1079
1389
|
</table></div>
|
|
1080
1390
|
<p class="since">Since 2.26</p>
|
|
1081
1391
|
</div>
|
|
1082
1392
|
<hr>
|
|
1083
|
-
<div class="refsect2"
|
|
1393
|
+
<div class="refsect2">
|
|
1084
1394
|
<a name="g-settings-get-boolean"></a><h3>g_settings_get_boolean ()</h3>
|
|
1085
1395
|
<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>,
|
|
1086
1396
|
<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>
|
|
@@ -1099,25 +1409,22 @@ having a boolean type in the schema for <em class="parameter"><code>settings</co
|
|
|
1099
1409
|
<tbody>
|
|
1100
1410
|
<tr>
|
|
1101
1411
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1102
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1103
|
-
</td>
|
|
1412
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1104
1413
|
</tr>
|
|
1105
1414
|
<tr>
|
|
1106
1415
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1107
|
-
<td>the key to get the value for
|
|
1108
|
-
</td>
|
|
1416
|
+
<td>the key to get the value for</td>
|
|
1109
1417
|
</tr>
|
|
1110
1418
|
<tr>
|
|
1111
1419
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1112
|
-
<td>a boolean
|
|
1113
|
-
</td>
|
|
1420
|
+
<td>a boolean</td>
|
|
1114
1421
|
</tr>
|
|
1115
1422
|
</tbody>
|
|
1116
1423
|
</table></div>
|
|
1117
1424
|
<p class="since">Since 2.26</p>
|
|
1118
1425
|
</div>
|
|
1119
1426
|
<hr>
|
|
1120
|
-
<div class="refsect2"
|
|
1427
|
+
<div class="refsect2">
|
|
1121
1428
|
<a name="g-settings-set-boolean"></a><h3>g_settings_set_boolean ()</h3>
|
|
1122
1429
|
<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>,
|
|
1123
1430
|
<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>,
|
|
@@ -1137,32 +1444,28 @@ having a boolean type in the schema for <em class="parameter"><code>settings</co
|
|
|
1137
1444
|
<tbody>
|
|
1138
1445
|
<tr>
|
|
1139
1446
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1140
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1141
|
-
</td>
|
|
1447
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1142
1448
|
</tr>
|
|
1143
1449
|
<tr>
|
|
1144
1450
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1145
|
-
<td>the name of the key to set
|
|
1146
|
-
</td>
|
|
1451
|
+
<td>the name of the key to set</td>
|
|
1147
1452
|
</tr>
|
|
1148
1453
|
<tr>
|
|
1149
1454
|
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
1150
|
-
<td>the value to set it to
|
|
1151
|
-
</td>
|
|
1455
|
+
<td>the value to set it to</td>
|
|
1152
1456
|
</tr>
|
|
1153
1457
|
<tr>
|
|
1154
1458
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1155
1459
|
<td>
|
|
1156
1460
|
<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,
|
|
1157
|
-
|
|
1158
|
-
</td>
|
|
1461
|
+
<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</td>
|
|
1159
1462
|
</tr>
|
|
1160
1463
|
</tbody>
|
|
1161
1464
|
</table></div>
|
|
1162
1465
|
<p class="since">Since 2.26</p>
|
|
1163
1466
|
</div>
|
|
1164
1467
|
<hr>
|
|
1165
|
-
<div class="refsect2"
|
|
1468
|
+
<div class="refsect2">
|
|
1166
1469
|
<a name="g-settings-get-int"></a><h3>g_settings_get_int ()</h3>
|
|
1167
1470
|
<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>,
|
|
1168
1471
|
<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>
|
|
@@ -1181,25 +1484,22 @@ having a int32 type in the schema for <em class="parameter"><code>settings</code
|
|
|
1181
1484
|
<tbody>
|
|
1182
1485
|
<tr>
|
|
1183
1486
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1184
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1185
|
-
</td>
|
|
1487
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1186
1488
|
</tr>
|
|
1187
1489
|
<tr>
|
|
1188
1490
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1189
|
-
<td>the key to get the value for
|
|
1190
|
-
</td>
|
|
1491
|
+
<td>the key to get the value for</td>
|
|
1191
1492
|
</tr>
|
|
1192
1493
|
<tr>
|
|
1193
1494
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1194
|
-
<td>an integer
|
|
1195
|
-
</td>
|
|
1495
|
+
<td>an integer</td>
|
|
1196
1496
|
</tr>
|
|
1197
1497
|
</tbody>
|
|
1198
1498
|
</table></div>
|
|
1199
1499
|
<p class="since">Since 2.26</p>
|
|
1200
1500
|
</div>
|
|
1201
1501
|
<hr>
|
|
1202
|
-
<div class="refsect2"
|
|
1502
|
+
<div class="refsect2">
|
|
1203
1503
|
<a name="g-settings-set-int"></a><h3>g_settings_set_int ()</h3>
|
|
1204
1504
|
<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>,
|
|
1205
1505
|
<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>,
|
|
@@ -1219,32 +1519,28 @@ having a int32 type in the schema for <em class="parameter"><code>settings</code
|
|
|
1219
1519
|
<tbody>
|
|
1220
1520
|
<tr>
|
|
1221
1521
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1222
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1223
|
-
</td>
|
|
1522
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1224
1523
|
</tr>
|
|
1225
1524
|
<tr>
|
|
1226
1525
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1227
|
-
<td>the name of the key to set
|
|
1228
|
-
</td>
|
|
1526
|
+
<td>the name of the key to set</td>
|
|
1229
1527
|
</tr>
|
|
1230
1528
|
<tr>
|
|
1231
1529
|
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
1232
|
-
<td>the value to set it to
|
|
1233
|
-
</td>
|
|
1530
|
+
<td>the value to set it to</td>
|
|
1234
1531
|
</tr>
|
|
1235
1532
|
<tr>
|
|
1236
1533
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1237
1534
|
<td>
|
|
1238
1535
|
<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,
|
|
1239
|
-
|
|
1240
|
-
</td>
|
|
1536
|
+
<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</td>
|
|
1241
1537
|
</tr>
|
|
1242
1538
|
</tbody>
|
|
1243
1539
|
</table></div>
|
|
1244
1540
|
<p class="since">Since 2.26</p>
|
|
1245
1541
|
</div>
|
|
1246
1542
|
<hr>
|
|
1247
|
-
<div class="refsect2"
|
|
1543
|
+
<div class="refsect2">
|
|
1248
1544
|
<a name="g-settings-get-double"></a><h3>g_settings_get_double ()</h3>
|
|
1249
1545
|
<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>,
|
|
1250
1546
|
<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>
|
|
@@ -1263,25 +1559,22 @@ having a 'double' type in the schema for <em class="parameter"><code>settings</c
|
|
|
1263
1559
|
<tbody>
|
|
1264
1560
|
<tr>
|
|
1265
1561
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1266
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1267
|
-
</td>
|
|
1562
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1268
1563
|
</tr>
|
|
1269
1564
|
<tr>
|
|
1270
1565
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1271
|
-
<td>the key to get the value for
|
|
1272
|
-
</td>
|
|
1566
|
+
<td>the key to get the value for</td>
|
|
1273
1567
|
</tr>
|
|
1274
1568
|
<tr>
|
|
1275
1569
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1276
|
-
<td>a double
|
|
1277
|
-
</td>
|
|
1570
|
+
<td>a double</td>
|
|
1278
1571
|
</tr>
|
|
1279
1572
|
</tbody>
|
|
1280
1573
|
</table></div>
|
|
1281
1574
|
<p class="since">Since 2.26</p>
|
|
1282
1575
|
</div>
|
|
1283
1576
|
<hr>
|
|
1284
|
-
<div class="refsect2"
|
|
1577
|
+
<div class="refsect2">
|
|
1285
1578
|
<a name="g-settings-set-double"></a><h3>g_settings_set_double ()</h3>
|
|
1286
1579
|
<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>,
|
|
1287
1580
|
<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>,
|
|
@@ -1301,34 +1594,30 @@ having a 'double' type in the schema for <em class="parameter"><code>settings</c
|
|
|
1301
1594
|
<tbody>
|
|
1302
1595
|
<tr>
|
|
1303
1596
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1304
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1305
|
-
</td>
|
|
1597
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1306
1598
|
</tr>
|
|
1307
1599
|
<tr>
|
|
1308
1600
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1309
|
-
<td>the name of the key to set
|
|
1310
|
-
</td>
|
|
1601
|
+
<td>the name of the key to set</td>
|
|
1311
1602
|
</tr>
|
|
1312
1603
|
<tr>
|
|
1313
1604
|
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
1314
|
-
<td>the value to set it to
|
|
1315
|
-
</td>
|
|
1605
|
+
<td>the value to set it to</td>
|
|
1316
1606
|
</tr>
|
|
1317
1607
|
<tr>
|
|
1318
1608
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1319
1609
|
<td>
|
|
1320
1610
|
<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,
|
|
1321
|
-
|
|
1322
|
-
</td>
|
|
1611
|
+
<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</td>
|
|
1323
1612
|
</tr>
|
|
1324
1613
|
</tbody>
|
|
1325
1614
|
</table></div>
|
|
1326
1615
|
<p class="since">Since 2.26</p>
|
|
1327
1616
|
</div>
|
|
1328
1617
|
<hr>
|
|
1329
|
-
<div class="refsect2"
|
|
1618
|
+
<div class="refsect2">
|
|
1330
1619
|
<a name="g-settings-get-string"></a><h3>g_settings_get_string ()</h3>
|
|
1331
|
-
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
|
|
1620
|
+
<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>,
|
|
1332
1621
|
<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>
|
|
1333
1622
|
<p>
|
|
1334
1623
|
Gets the value that is stored at <em class="parameter"><code>key</code></em> in <em class="parameter"><code>settings</code></em>.
|
|
@@ -1345,25 +1634,22 @@ having a string type in the schema for <em class="parameter"><code>settings</cod
|
|
|
1345
1634
|
<tbody>
|
|
1346
1635
|
<tr>
|
|
1347
1636
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1348
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1349
|
-
</td>
|
|
1637
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1350
1638
|
</tr>
|
|
1351
1639
|
<tr>
|
|
1352
1640
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1353
|
-
<td>the key to get the value for
|
|
1354
|
-
</td>
|
|
1641
|
+
<td>the key to get the value for</td>
|
|
1355
1642
|
</tr>
|
|
1356
1643
|
<tr>
|
|
1357
1644
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1358
|
-
<td>a newly-allocated string
|
|
1359
|
-
</td>
|
|
1645
|
+
<td>a newly-allocated string</td>
|
|
1360
1646
|
</tr>
|
|
1361
1647
|
</tbody>
|
|
1362
1648
|
</table></div>
|
|
1363
1649
|
<p class="since">Since 2.26</p>
|
|
1364
1650
|
</div>
|
|
1365
1651
|
<hr>
|
|
1366
|
-
<div class="refsect2"
|
|
1652
|
+
<div class="refsect2">
|
|
1367
1653
|
<a name="g-settings-set-string"></a><h3>g_settings_set_string ()</h3>
|
|
1368
1654
|
<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>,
|
|
1369
1655
|
<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>,
|
|
@@ -1383,39 +1669,32 @@ having a string type in the schema for <em class="parameter"><code>settings</cod
|
|
|
1383
1669
|
<tbody>
|
|
1384
1670
|
<tr>
|
|
1385
1671
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1386
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1387
|
-
</td>
|
|
1672
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1388
1673
|
</tr>
|
|
1389
1674
|
<tr>
|
|
1390
1675
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1391
|
-
<td>the name of the key to set
|
|
1392
|
-
</td>
|
|
1676
|
+
<td>the name of the key to set</td>
|
|
1393
1677
|
</tr>
|
|
1394
1678
|
<tr>
|
|
1395
1679
|
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
1396
|
-
<td>the value to set it to
|
|
1397
|
-
</td>
|
|
1680
|
+
<td>the value to set it to</td>
|
|
1398
1681
|
</tr>
|
|
1399
1682
|
<tr>
|
|
1400
1683
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1401
1684
|
<td>
|
|
1402
1685
|
<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,
|
|
1403
|
-
|
|
1404
|
-
</td>
|
|
1686
|
+
<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</td>
|
|
1405
1687
|
</tr>
|
|
1406
1688
|
</tbody>
|
|
1407
1689
|
</table></div>
|
|
1408
1690
|
<p class="since">Since 2.26</p>
|
|
1409
1691
|
</div>
|
|
1410
1692
|
<hr>
|
|
1411
|
-
<div class="refsect2"
|
|
1693
|
+
<div class="refsect2">
|
|
1412
1694
|
<a name="g-settings-get-strv"></a><h3>g_settings_get_strv ()</h3>
|
|
1413
|
-
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
|
|
1695
|
+
<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>,
|
|
1414
1696
|
<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>
|
|
1415
1697
|
<p>
|
|
1416
|
-
Gets the value that is stored at <em class="parameter"><code>key</code></em> in <em class="parameter"><code>settings</code></em>.
|
|
1417
|
-
</p>
|
|
1418
|
-
<p>
|
|
1419
1698
|
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.
|
|
1420
1699
|
</p>
|
|
1421
1700
|
<p>
|
|
@@ -1427,17 +1706,17 @@ having an array of strings type in the schema for <em class="parameter"><code>se
|
|
|
1427
1706
|
<tbody>
|
|
1428
1707
|
<tr>
|
|
1429
1708
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1430
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1431
|
-
</td>
|
|
1709
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1432
1710
|
</tr>
|
|
1433
1711
|
<tr>
|
|
1434
1712
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1435
|
-
<td>the key to get the value for
|
|
1436
|
-
</td>
|
|
1713
|
+
<td>the key to get the value for</td>
|
|
1437
1714
|
</tr>
|
|
1438
1715
|
<tr>
|
|
1439
1716
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1440
|
-
<td>a
|
|
1717
|
+
<td>a
|
|
1718
|
+
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, the value that
|
|
1719
|
+
is stored at <em class="parameter"><code>key</code></em> in <em class="parameter"><code>settings</code></em>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
|
|
1441
1720
|
</td>
|
|
1442
1721
|
</tr>
|
|
1443
1722
|
</tbody>
|
|
@@ -1445,7 +1724,7 @@ having an array of strings type in the schema for <em class="parameter"><code>se
|
|
|
1445
1724
|
<p class="since">Since 2.26</p>
|
|
1446
1725
|
</div>
|
|
1447
1726
|
<hr>
|
|
1448
|
-
<div class="refsect2"
|
|
1727
|
+
<div class="refsect2">
|
|
1449
1728
|
<a name="g-settings-set-strv"></a><h3>g_settings_set_strv ()</h3>
|
|
1450
1729
|
<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>,
|
|
1451
1730
|
<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>,
|
|
@@ -1466,32 +1745,29 @@ having an array of strings type in the schema for <em class="parameter"><code>se
|
|
|
1466
1745
|
<tbody>
|
|
1467
1746
|
<tr>
|
|
1468
1747
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1469
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1470
|
-
</td>
|
|
1748
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1471
1749
|
</tr>
|
|
1472
1750
|
<tr>
|
|
1473
1751
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1474
|
-
<td>the name of the key to set
|
|
1475
|
-
</td>
|
|
1752
|
+
<td>the name of the key to set</td>
|
|
1476
1753
|
</tr>
|
|
1477
1754
|
<tr>
|
|
1478
1755
|
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
1479
|
-
<td>
|
|
1756
|
+
<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>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span>
|
|
1480
1757
|
</td>
|
|
1481
1758
|
</tr>
|
|
1482
1759
|
<tr>
|
|
1483
1760
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1484
1761
|
<td>
|
|
1485
1762
|
<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,
|
|
1486
|
-
|
|
1487
|
-
</td>
|
|
1763
|
+
<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</td>
|
|
1488
1764
|
</tr>
|
|
1489
1765
|
</tbody>
|
|
1490
1766
|
</table></div>
|
|
1491
1767
|
<p class="since">Since 2.26</p>
|
|
1492
1768
|
</div>
|
|
1493
1769
|
<hr>
|
|
1494
|
-
<div class="refsect2"
|
|
1770
|
+
<div class="refsect2">
|
|
1495
1771
|
<a name="g-settings-get-enum"></a><h3>g_settings_get_enum ()</h3>
|
|
1496
1772
|
<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>,
|
|
1497
1773
|
<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>
|
|
@@ -1517,25 +1793,22 @@ default value.
|
|
|
1517
1793
|
<tbody>
|
|
1518
1794
|
<tr>
|
|
1519
1795
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1520
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1521
|
-
</td>
|
|
1796
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1522
1797
|
</tr>
|
|
1523
1798
|
<tr>
|
|
1524
1799
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1525
|
-
<td>the key to get the value for
|
|
1526
|
-
</td>
|
|
1800
|
+
<td>the key to get the value for</td>
|
|
1527
1801
|
</tr>
|
|
1528
1802
|
<tr>
|
|
1529
1803
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1530
|
-
<td>the enum value
|
|
1531
|
-
</td>
|
|
1804
|
+
<td>the enum value</td>
|
|
1532
1805
|
</tr>
|
|
1533
1806
|
</tbody>
|
|
1534
1807
|
</table></div>
|
|
1535
1808
|
<p class="since">Since 2.26</p>
|
|
1536
1809
|
</div>
|
|
1537
1810
|
<hr>
|
|
1538
|
-
<div class="refsect2"
|
|
1811
|
+
<div class="refsect2">
|
|
1539
1812
|
<a name="g-settings-set-enum"></a><h3>g_settings_set_enum ()</h3>
|
|
1540
1813
|
<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>,
|
|
1541
1814
|
<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>,
|
|
@@ -1559,8 +1832,7 @@ After performing the write, accessing <em class="parameter"><code>key</code></em
|
|
|
1559
1832
|
<tbody>
|
|
1560
1833
|
<tr>
|
|
1561
1834
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1562
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1563
|
-
</td>
|
|
1835
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1564
1836
|
</tr>
|
|
1565
1837
|
<tr>
|
|
1566
1838
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
@@ -1569,20 +1841,18 @@ After performing the write, accessing <em class="parameter"><code>key</code></em
|
|
|
1569
1841
|
</tr>
|
|
1570
1842
|
<tr>
|
|
1571
1843
|
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
1572
|
-
<td>an enumerated value
|
|
1573
|
-
</td>
|
|
1844
|
+
<td>an enumerated value</td>
|
|
1574
1845
|
</tr>
|
|
1575
1846
|
<tr>
|
|
1576
1847
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1577
1848
|
<td>
|
|
1578
|
-
<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
|
|
1579
|
-
</td>
|
|
1849
|
+
<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</td>
|
|
1580
1850
|
</tr>
|
|
1581
1851
|
</tbody>
|
|
1582
1852
|
</table></div>
|
|
1583
1853
|
</div>
|
|
1584
1854
|
<hr>
|
|
1585
|
-
<div class="refsect2"
|
|
1855
|
+
<div class="refsect2">
|
|
1586
1856
|
<a name="g-settings-get-flags"></a><h3>g_settings_get_flags ()</h3>
|
|
1587
1857
|
<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>,
|
|
1588
1858
|
<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>
|
|
@@ -1608,25 +1878,22 @@ value.
|
|
|
1608
1878
|
<tbody>
|
|
1609
1879
|
<tr>
|
|
1610
1880
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1611
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1612
|
-
</td>
|
|
1881
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1613
1882
|
</tr>
|
|
1614
1883
|
<tr>
|
|
1615
1884
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1616
|
-
<td>the key to get the value for
|
|
1617
|
-
</td>
|
|
1885
|
+
<td>the key to get the value for</td>
|
|
1618
1886
|
</tr>
|
|
1619
1887
|
<tr>
|
|
1620
1888
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1621
|
-
<td>the flags value
|
|
1622
|
-
</td>
|
|
1889
|
+
<td>the flags value</td>
|
|
1623
1890
|
</tr>
|
|
1624
1891
|
</tbody>
|
|
1625
1892
|
</table></div>
|
|
1626
1893
|
<p class="since">Since 2.26</p>
|
|
1627
1894
|
</div>
|
|
1628
1895
|
<hr>
|
|
1629
|
-
<div class="refsect2"
|
|
1896
|
+
<div class="refsect2">
|
|
1630
1897
|
<a name="g-settings-set-flags"></a><h3>g_settings_set_flags ()</h3>
|
|
1631
1898
|
<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>,
|
|
1632
1899
|
<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>,
|
|
@@ -1651,8 +1918,7 @@ bit in <em class="parameter"><code>value</code></em>.
|
|
|
1651
1918
|
<tbody>
|
|
1652
1919
|
<tr>
|
|
1653
1920
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1654
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1655
|
-
</td>
|
|
1921
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1656
1922
|
</tr>
|
|
1657
1923
|
<tr>
|
|
1658
1924
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
@@ -1661,20 +1927,18 @@ bit in <em class="parameter"><code>value</code></em>.
|
|
|
1661
1927
|
</tr>
|
|
1662
1928
|
<tr>
|
|
1663
1929
|
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
1664
|
-
<td>a flags value
|
|
1665
|
-
</td>
|
|
1930
|
+
<td>a flags value</td>
|
|
1666
1931
|
</tr>
|
|
1667
1932
|
<tr>
|
|
1668
1933
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1669
1934
|
<td>
|
|
1670
|
-
<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
|
|
1671
|
-
</td>
|
|
1935
|
+
<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</td>
|
|
1672
1936
|
</tr>
|
|
1673
1937
|
</tbody>
|
|
1674
1938
|
</table></div>
|
|
1675
1939
|
</div>
|
|
1676
1940
|
<hr>
|
|
1677
|
-
<div class="refsect2"
|
|
1941
|
+
<div class="refsect2">
|
|
1678
1942
|
<a name="GSettingsGetMapping"></a><h3>GSettingsGetMapping ()</h3>
|
|
1679
1943
|
<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>,
|
|
1680
1944
|
<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>,
|
|
@@ -1703,25 +1967,25 @@ must be returned in this case.
|
|
|
1703
1967
|
</tr>
|
|
1704
1968
|
<tr>
|
|
1705
1969
|
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
|
|
1706
|
-
<td>the result of the mapping
|
|
1970
|
+
<td>the result of the mapping. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
|
|
1707
1971
|
</td>
|
|
1708
1972
|
</tr>
|
|
1709
1973
|
<tr>
|
|
1710
1974
|
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
|
1711
|
-
<td>the user data that was passed to
|
|
1975
|
+
<td>the user data that was passed to
|
|
1976
|
+
<a class="link" href="GSettings.html#g-settings-get-mapped" title="g_settings_get_mapped ()"><code class="function">g_settings_get_mapped()</code></a>. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
|
|
1712
1977
|
</td>
|
|
1713
1978
|
</tr>
|
|
1714
1979
|
<tr>
|
|
1715
1980
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1716
1981
|
<td>
|
|
1717
|
-
<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
|
|
1718
|
-
</td>
|
|
1982
|
+
<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</td>
|
|
1719
1983
|
</tr>
|
|
1720
1984
|
</tbody>
|
|
1721
1985
|
</table></div>
|
|
1722
1986
|
</div>
|
|
1723
1987
|
<hr>
|
|
1724
|
-
<div class="refsect2"
|
|
1988
|
+
<div class="refsect2">
|
|
1725
1989
|
<a name="g-settings-get-mapped"></a><h3>g_settings_get_mapped ()</h3>
|
|
1726
1990
|
<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>,
|
|
1727
1991
|
<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>,
|
|
@@ -1766,18 +2030,16 @@ just as any other value would be.
|
|
|
1766
2030
|
<tbody>
|
|
1767
2031
|
<tr>
|
|
1768
2032
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1769
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1770
|
-
</td>
|
|
2033
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1771
2034
|
</tr>
|
|
1772
2035
|
<tr>
|
|
1773
2036
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1774
|
-
<td>the key to get the value for
|
|
1775
|
-
</td>
|
|
2037
|
+
<td>the key to get the value for</td>
|
|
1776
2038
|
</tr>
|
|
1777
2039
|
<tr>
|
|
1778
2040
|
<td><p><span class="term"><em class="parameter"><code>mapping</code></em> :</span></p></td>
|
|
1779
|
-
<td>the function to map the value in the
|
|
1780
|
-
|
|
2041
|
+
<td>the function to map the value in the
|
|
2042
|
+
settings database to the value used by the application. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span>
|
|
1781
2043
|
</td>
|
|
1782
2044
|
</tr>
|
|
1783
2045
|
<tr>
|
|
@@ -1787,14 +2049,14 @@ just as any other value would be.
|
|
|
1787
2049
|
</tr>
|
|
1788
2050
|
<tr>
|
|
1789
2051
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
1790
|
-
<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>
|
|
2052
|
+
<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>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
|
|
1791
2053
|
</td>
|
|
1792
2054
|
</tr>
|
|
1793
2055
|
</tbody>
|
|
1794
2056
|
</table></div>
|
|
1795
2057
|
</div>
|
|
1796
2058
|
<hr>
|
|
1797
|
-
<div class="refsect2"
|
|
2059
|
+
<div class="refsect2">
|
|
1798
2060
|
<a name="GSettingsBindFlags"></a><h3>enum GSettingsBindFlags</h3>
|
|
1799
2061
|
<pre class="programlisting">typedef enum
|
|
1800
2062
|
{
|
|
@@ -1853,7 +2115,7 @@ directions.
|
|
|
1853
2115
|
</table></div>
|
|
1854
2116
|
</div>
|
|
1855
2117
|
<hr>
|
|
1856
|
-
<div class="refsect2"
|
|
2118
|
+
<div class="refsect2">
|
|
1857
2119
|
<a name="g-settings-bind"></a><h3>g_settings_bind ()</h3>
|
|
1858
2120
|
<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>,
|
|
1859
2121
|
<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>,
|
|
@@ -1890,35 +2152,31 @@ binding overrides the first one.
|
|
|
1890
2152
|
<tbody>
|
|
1891
2153
|
<tr>
|
|
1892
2154
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1893
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1894
|
-
</td>
|
|
2155
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1895
2156
|
</tr>
|
|
1896
2157
|
<tr>
|
|
1897
2158
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1898
|
-
<td>the key to bind
|
|
1899
|
-
</td>
|
|
2159
|
+
<td>the key to bind</td>
|
|
1900
2160
|
</tr>
|
|
1901
2161
|
<tr>
|
|
1902
2162
|
<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
|
|
1903
|
-
<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>
|
|
2163
|
+
<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> GObject.Object]</span>
|
|
1904
2164
|
</td>
|
|
1905
2165
|
</tr>
|
|
1906
2166
|
<tr>
|
|
1907
2167
|
<td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
|
|
1908
|
-
<td>the name of the property to bind
|
|
1909
|
-
</td>
|
|
2168
|
+
<td>the name of the property to bind</td>
|
|
1910
2169
|
</tr>
|
|
1911
2170
|
<tr>
|
|
1912
2171
|
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
|
|
1913
|
-
<td>flags for the binding
|
|
1914
|
-
</td>
|
|
2172
|
+
<td>flags for the binding</td>
|
|
1915
2173
|
</tr>
|
|
1916
2174
|
</tbody>
|
|
1917
2175
|
</table></div>
|
|
1918
2176
|
<p class="since">Since 2.26</p>
|
|
1919
2177
|
</div>
|
|
1920
2178
|
<hr>
|
|
1921
|
-
<div class="refsect2"
|
|
2179
|
+
<div class="refsect2">
|
|
1922
2180
|
<a name="g-settings-bind-with-mapping"></a><h3>g_settings_bind_with_mapping ()</h3>
|
|
1923
2181
|
<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>,
|
|
1924
2182
|
<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>,
|
|
@@ -1948,40 +2206,34 @@ binding overrides the first one.
|
|
|
1948
2206
|
<tbody>
|
|
1949
2207
|
<tr>
|
|
1950
2208
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
1951
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
1952
|
-
</td>
|
|
2209
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
1953
2210
|
</tr>
|
|
1954
2211
|
<tr>
|
|
1955
2212
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
1956
|
-
<td>the key to bind
|
|
1957
|
-
</td>
|
|
2213
|
+
<td>the key to bind</td>
|
|
1958
2214
|
</tr>
|
|
1959
2215
|
<tr>
|
|
1960
2216
|
<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
|
|
1961
|
-
<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>
|
|
2217
|
+
<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> GObject.Object]</span>
|
|
1962
2218
|
</td>
|
|
1963
2219
|
</tr>
|
|
1964
2220
|
<tr>
|
|
1965
2221
|
<td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
|
|
1966
|
-
<td>the name of the property to bind
|
|
1967
|
-
</td>
|
|
2222
|
+
<td>the name of the property to bind</td>
|
|
1968
2223
|
</tr>
|
|
1969
2224
|
<tr>
|
|
1970
2225
|
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
|
|
1971
|
-
<td>flags for the binding
|
|
1972
|
-
</td>
|
|
2226
|
+
<td>flags for the binding</td>
|
|
1973
2227
|
</tr>
|
|
1974
2228
|
<tr>
|
|
1975
2229
|
<td><p><span class="term"><em class="parameter"><code>get_mapping</code></em> :</span></p></td>
|
|
1976
2230
|
<td>a function that gets called to convert values
|
|
1977
|
-
|
|
1978
|
-
</td>
|
|
2231
|
+
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</td>
|
|
1979
2232
|
</tr>
|
|
1980
2233
|
<tr>
|
|
1981
2234
|
<td><p><span class="term"><em class="parameter"><code>set_mapping</code></em> :</span></p></td>
|
|
1982
2235
|
<td>a function that gets called to convert values
|
|
1983
|
-
|
|
1984
|
-
</td>
|
|
2236
|
+
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</td>
|
|
1985
2237
|
</tr>
|
|
1986
2238
|
<tr>
|
|
1987
2239
|
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
|
@@ -1999,7 +2251,7 @@ binding overrides the first one.
|
|
|
1999
2251
|
<p class="since">Since 2.26</p>
|
|
2000
2252
|
</div>
|
|
2001
2253
|
<hr>
|
|
2002
|
-
<div class="refsect2"
|
|
2254
|
+
<div class="refsect2">
|
|
2003
2255
|
<a name="g-settings-bind-writable"></a><h3>g_settings_bind_writable ()</h3>
|
|
2004
2256
|
<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>,
|
|
2005
2257
|
<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>,
|
|
@@ -2034,35 +2286,31 @@ binding overrides the first one.
|
|
|
2034
2286
|
<tbody>
|
|
2035
2287
|
<tr>
|
|
2036
2288
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
2037
|
-
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object
|
|
2038
|
-
</td>
|
|
2289
|
+
<td>a <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object</td>
|
|
2039
2290
|
</tr>
|
|
2040
2291
|
<tr>
|
|
2041
2292
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
2042
|
-
<td>the key to bind
|
|
2043
|
-
</td>
|
|
2293
|
+
<td>the key to bind</td>
|
|
2044
2294
|
</tr>
|
|
2045
2295
|
<tr>
|
|
2046
2296
|
<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
|
|
2047
|
-
<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>
|
|
2297
|
+
<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> GObject.Object]</span>
|
|
2048
2298
|
</td>
|
|
2049
2299
|
</tr>
|
|
2050
2300
|
<tr>
|
|
2051
2301
|
<td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
|
|
2052
|
-
<td>the name of a boolean property to bind
|
|
2053
|
-
</td>
|
|
2302
|
+
<td>the name of a boolean property to bind</td>
|
|
2054
2303
|
</tr>
|
|
2055
2304
|
<tr>
|
|
2056
2305
|
<td><p><span class="term"><em class="parameter"><code>inverted</code></em> :</span></p></td>
|
|
2057
|
-
<td>whether to 'invert' the value
|
|
2058
|
-
</td>
|
|
2306
|
+
<td>whether to 'invert' the value</td>
|
|
2059
2307
|
</tr>
|
|
2060
2308
|
</tbody>
|
|
2061
2309
|
</table></div>
|
|
2062
2310
|
<p class="since">Since 2.26</p>
|
|
2063
2311
|
</div>
|
|
2064
2312
|
<hr>
|
|
2065
|
-
<div class="refsect2"
|
|
2313
|
+
<div class="refsect2">
|
|
2066
2314
|
<a name="g-settings-unbind"></a><h3>g_settings_unbind ()</h3>
|
|
2067
2315
|
<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>,
|
|
2068
2316
|
<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>
|
|
@@ -2079,20 +2327,18 @@ function.
|
|
|
2079
2327
|
<tbody>
|
|
2080
2328
|
<tr>
|
|
2081
2329
|
<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
|
|
2082
|
-
<td>the object
|
|
2083
|
-
</td>
|
|
2330
|
+
<td>the object</td>
|
|
2084
2331
|
</tr>
|
|
2085
2332
|
<tr>
|
|
2086
2333
|
<td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
|
|
2087
|
-
<td>the property whose binding is removed
|
|
2088
|
-
</td>
|
|
2334
|
+
<td>the property whose binding is removed</td>
|
|
2089
2335
|
</tr>
|
|
2090
2336
|
</tbody>
|
|
2091
2337
|
</table></div>
|
|
2092
2338
|
<p class="since">Since 2.26</p>
|
|
2093
2339
|
</div>
|
|
2094
2340
|
<hr>
|
|
2095
|
-
<div class="refsect2"
|
|
2341
|
+
<div class="refsect2">
|
|
2096
2342
|
<a name="GSettingsBindSetMapping"></a><h3>GSettingsBindSetMapping ()</h3>
|
|
2097
2343
|
<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>,
|
|
2098
2344
|
<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>,
|
|
@@ -2106,30 +2352,26 @@ value to a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.h
|
|
|
2106
2352
|
<tbody>
|
|
2107
2353
|
<tr>
|
|
2108
2354
|
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
2109
|
-
<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
|
|
2110
|
-
</td>
|
|
2355
|
+
<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</td>
|
|
2111
2356
|
</tr>
|
|
2112
2357
|
<tr>
|
|
2113
2358
|
<td><p><span class="term"><em class="parameter"><code>expected_type</code></em> :</span></p></td>
|
|
2114
|
-
<td>the <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a> to create
|
|
2115
|
-
</td>
|
|
2359
|
+
<td>the <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType"><span class="type">GVariantType</span></a> to create</td>
|
|
2116
2360
|
</tr>
|
|
2117
2361
|
<tr>
|
|
2118
2362
|
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
|
2119
|
-
<td>user data that was specified when the binding was created
|
|
2120
|
-
</td>
|
|
2363
|
+
<td>user data that was specified when the binding was created</td>
|
|
2121
2364
|
</tr>
|
|
2122
2365
|
<tr>
|
|
2123
2366
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
2124
2367
|
<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>,
|
|
2125
|
-
|
|
2126
|
-
</td>
|
|
2368
|
+
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</td>
|
|
2127
2369
|
</tr>
|
|
2128
2370
|
</tbody>
|
|
2129
2371
|
</table></div>
|
|
2130
2372
|
</div>
|
|
2131
2373
|
<hr>
|
|
2132
|
-
<div class="refsect2"
|
|
2374
|
+
<div class="refsect2">
|
|
2133
2375
|
<a name="GSettingsBindGetMapping"></a><h3>GSettingsBindGetMapping ()</h3>
|
|
2134
2376
|
<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>,
|
|
2135
2377
|
<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>,
|
|
@@ -2144,8 +2386,7 @@ of the appropriate type.
|
|
|
2144
2386
|
<tbody>
|
|
2145
2387
|
<tr>
|
|
2146
2388
|
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
2147
|
-
<td>return location for the property value
|
|
2148
|
-
</td>
|
|
2389
|
+
<td>return location for the property value</td>
|
|
2149
2390
|
</tr>
|
|
2150
2391
|
<tr>
|
|
2151
2392
|
<td><p><span class="term"><em class="parameter"><code>variant</code></em> :</span></p></td>
|
|
@@ -2154,28 +2395,37 @@ of the appropriate type.
|
|
|
2154
2395
|
</tr>
|
|
2155
2396
|
<tr>
|
|
2156
2397
|
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
|
2157
|
-
<td>user data that was specified when the binding was created
|
|
2158
|
-
</td>
|
|
2398
|
+
<td>user data that was specified when the binding was created</td>
|
|
2159
2399
|
</tr>
|
|
2160
2400
|
<tr>
|
|
2161
2401
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
2162
2402
|
<td>
|
|
2163
|
-
<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
|
|
2164
|
-
</td>
|
|
2403
|
+
<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</td>
|
|
2165
2404
|
</tr>
|
|
2166
2405
|
</tbody>
|
|
2167
2406
|
</table></div>
|
|
2168
2407
|
</div>
|
|
2169
2408
|
</div>
|
|
2170
|
-
<div class="refsect1"
|
|
2409
|
+
<div class="refsect1">
|
|
2171
2410
|
<a name="GSettings.property-details"></a><h2>Property Details</h2>
|
|
2172
|
-
<div class="refsect2"
|
|
2411
|
+
<div class="refsect2">
|
|
2173
2412
|
<a name="GSettings--backend"></a><h3>The <code class="literal">"backend"</code> property</h3>
|
|
2174
2413
|
<pre class="programlisting"> "backend" <a class="link" href="GSettingsBackend.html" title="GSettingsBackend"><span class="type">GSettingsBackend</span></a>* : Read / Write / Construct Only</pre>
|
|
2175
2414
|
<p>The GSettingsBackend for this settings object.</p>
|
|
2176
2415
|
</div>
|
|
2177
2416
|
<hr>
|
|
2178
|
-
<div class="refsect2"
|
|
2417
|
+
<div class="refsect2">
|
|
2418
|
+
<a name="GSettings--delay-apply"></a><h3>The <code class="literal">"delay-apply"</code> property</h3>
|
|
2419
|
+
<pre class="programlisting"> "delay-apply" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read</pre>
|
|
2420
|
+
<p>
|
|
2421
|
+
Whether the <a class="link" href="GSettings.html" title="GSettings"><span class="type">GSettings</span></a> object is in 'delay-apply' mode. See
|
|
2422
|
+
<a class="link" href="GSettings.html#g-settings-delay" title="g_settings_delay ()"><code class="function">g_settings_delay()</code></a> for details.
|
|
2423
|
+
</p>
|
|
2424
|
+
<p>Default value: FALSE</p>
|
|
2425
|
+
<p class="since">Since 2.28</p>
|
|
2426
|
+
</div>
|
|
2427
|
+
<hr>
|
|
2428
|
+
<div class="refsect2">
|
|
2179
2429
|
<a name="GSettings--has-unapplied"></a><h3>The <code class="literal">"has-unapplied"</code> property</h3>
|
|
2180
2430
|
<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>
|
|
2181
2431
|
<p>
|
|
@@ -2185,7 +2435,7 @@ changes that will be applied when <a class="link" href="GSettings.html#g-setting
|
|
|
2185
2435
|
<p>Default value: FALSE</p>
|
|
2186
2436
|
</div>
|
|
2187
2437
|
<hr>
|
|
2188
|
-
<div class="refsect2"
|
|
2438
|
+
<div class="refsect2">
|
|
2189
2439
|
<a name="GSettings--path"></a><h3>The <code class="literal">"path"</code> property</h3>
|
|
2190
2440
|
<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>
|
|
2191
2441
|
<p>
|
|
@@ -2194,7 +2444,7 @@ The path within the backend where the settings are stored.
|
|
|
2194
2444
|
<p>Default value: NULL</p>
|
|
2195
2445
|
</div>
|
|
2196
2446
|
<hr>
|
|
2197
|
-
<div class="refsect2"
|
|
2447
|
+
<div class="refsect2">
|
|
2198
2448
|
<a name="GSettings--schema"></a><h3>The <code class="literal">"schema"</code> property</h3>
|
|
2199
2449
|
<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>
|
|
2200
2450
|
<p>
|
|
@@ -2204,14 +2454,14 @@ for this <a class="link" href="GSettings.html" title="GSettings"><span class="ty
|
|
|
2204
2454
|
<p>Default value: NULL</p>
|
|
2205
2455
|
</div>
|
|
2206
2456
|
</div>
|
|
2207
|
-
<div class="refsect1"
|
|
2457
|
+
<div class="refsect1">
|
|
2208
2458
|
<a name="GSettings.signal-details"></a><h2>Signal Details</h2>
|
|
2209
|
-
<div class="refsect2"
|
|
2459
|
+
<div class="refsect2">
|
|
2210
2460
|
<a name="GSettings-change-event"></a><h3>The <code class="literal">"change-event"</code> signal</h3>
|
|
2211
2461
|
<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,
|
|
2212
2462
|
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> keys,
|
|
2213
2463
|
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_keys,
|
|
2214
|
-
<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>
|
|
2464
|
+
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
|
|
2215
2465
|
<p>
|
|
2216
2466
|
The "change-event" signal is emitted once per change event that
|
|
2217
2467
|
affects this settings object. You should connect to this signal
|
|
@@ -2236,25 +2486,22 @@ for each affected key. If any other connected handler returns
|
|
|
2236
2486
|
<tbody>
|
|
2237
2487
|
<tr>
|
|
2238
2488
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
2239
|
-
<td>the object on which the signal was emitted
|
|
2240
|
-
</td>
|
|
2489
|
+
<td>the object on which the signal was emitted</td>
|
|
2241
2490
|
</tr>
|
|
2242
2491
|
<tr>
|
|
2243
2492
|
<td><p><span class="term"><em class="parameter"><code>keys</code></em> :</span></p></td>
|
|
2244
|
-
<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>
|
|
2493
|
+
<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>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_keys][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GQuark][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
|
|
2245
2494
|
</td>
|
|
2246
2495
|
</tr>
|
|
2247
2496
|
<tr>
|
|
2248
2497
|
<td><p><span class="term"><em class="parameter"><code>n_keys</code></em> :</span></p></td>
|
|
2249
|
-
<td>the length of the <em class="parameter"><code>keys</code></em> array, or 0
|
|
2250
|
-
</td>
|
|
2498
|
+
<td>the length of the <em class="parameter"><code>keys</code></em> array, or 0</td>
|
|
2251
2499
|
</tr>
|
|
2252
2500
|
<tr>
|
|
2253
2501
|
<td><p><span class="term"><em class="parameter"><code>returns</code></em> :</span></p></td>
|
|
2254
2502
|
<td>
|
|
2255
2503
|
<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
|
|
2256
|
-
|
|
2257
|
-
</td>
|
|
2504
|
+
event. FALSE to propagate the event further.</td>
|
|
2258
2505
|
</tr>
|
|
2259
2506
|
<tr>
|
|
2260
2507
|
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
|
@@ -2264,11 +2511,11 @@ for each affected key. If any other connected handler returns
|
|
|
2264
2511
|
</table></div>
|
|
2265
2512
|
</div>
|
|
2266
2513
|
<hr>
|
|
2267
|
-
<div class="refsect2"
|
|
2514
|
+
<div class="refsect2">
|
|
2268
2515
|
<a name="GSettings-changed"></a><h3>The <code class="literal">"changed"</code> signal</h3>
|
|
2269
2516
|
<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,
|
|
2270
2517
|
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key,
|
|
2271
|
-
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) :
|
|
2518
|
+
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-DETAILED:CAPS"><code class="literal">Has Details</code></a></pre>
|
|
2272
2519
|
<p>
|
|
2273
2520
|
The "changed" signal is emitted when a key has potentially changed.
|
|
2274
2521
|
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
|
|
@@ -2284,13 +2531,11 @@ when key "x" changes.
|
|
|
2284
2531
|
<tbody>
|
|
2285
2532
|
<tr>
|
|
2286
2533
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
2287
|
-
<td>the object on which the signal was emitted
|
|
2288
|
-
</td>
|
|
2534
|
+
<td>the object on which the signal was emitted</td>
|
|
2289
2535
|
</tr>
|
|
2290
2536
|
<tr>
|
|
2291
2537
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
2292
|
-
<td>the name of the key that changed
|
|
2293
|
-
</td>
|
|
2538
|
+
<td>the name of the key that changed</td>
|
|
2294
2539
|
</tr>
|
|
2295
2540
|
<tr>
|
|
2296
2541
|
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
|
@@ -2300,11 +2545,11 @@ when key "x" changes.
|
|
|
2300
2545
|
</table></div>
|
|
2301
2546
|
</div>
|
|
2302
2547
|
<hr>
|
|
2303
|
-
<div class="refsect2"
|
|
2548
|
+
<div class="refsect2">
|
|
2304
2549
|
<a name="GSettings-writable-change-event"></a><h3>The <code class="literal">"writable-change-event"</code> signal</h3>
|
|
2305
2550
|
<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,
|
|
2306
2551
|
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> key,
|
|
2307
|
-
<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>
|
|
2552
|
+
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
|
|
2308
2553
|
<p>
|
|
2309
2554
|
The "writable-change-event" signal is emitted once per writability
|
|
2310
2555
|
change event that affects this settings object. You should connect
|
|
@@ -2332,20 +2577,17 @@ will be supressed.
|
|
|
2332
2577
|
<tbody>
|
|
2333
2578
|
<tr>
|
|
2334
2579
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
2335
|
-
<td>the object on which the signal was emitted
|
|
2336
|
-
</td>
|
|
2580
|
+
<td>the object on which the signal was emitted</td>
|
|
2337
2581
|
</tr>
|
|
2338
2582
|
<tr>
|
|
2339
2583
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
2340
|
-
<td>the quark of the key, or 0
|
|
2341
|
-
</td>
|
|
2584
|
+
<td>the quark of the key, or 0</td>
|
|
2342
2585
|
</tr>
|
|
2343
2586
|
<tr>
|
|
2344
2587
|
<td><p><span class="term"><em class="parameter"><code>returns</code></em> :</span></p></td>
|
|
2345
2588
|
<td>
|
|
2346
2589
|
<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
|
|
2347
|
-
|
|
2348
|
-
</td>
|
|
2590
|
+
event. FALSE to propagate the event further.</td>
|
|
2349
2591
|
</tr>
|
|
2350
2592
|
<tr>
|
|
2351
2593
|
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
|
@@ -2355,11 +2597,11 @@ will be supressed.
|
|
|
2355
2597
|
</table></div>
|
|
2356
2598
|
</div>
|
|
2357
2599
|
<hr>
|
|
2358
|
-
<div class="refsect2"
|
|
2600
|
+
<div class="refsect2">
|
|
2359
2601
|
<a name="GSettings-writable-changed"></a><h3>The <code class="literal">"writable-changed"</code> signal</h3>
|
|
2360
2602
|
<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,
|
|
2361
2603
|
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key,
|
|
2362
|
-
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) :
|
|
2604
|
+
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-DETAILED:CAPS"><code class="literal">Has Details</code></a></pre>
|
|
2363
2605
|
<p>
|
|
2364
2606
|
The "writable-changed" signal is emitted when the writability of a
|
|
2365
2607
|
key has potentially changed. You should call
|
|
@@ -2375,13 +2617,11 @@ callbacks when the writability of "x" changes.
|
|
|
2375
2617
|
<tbody>
|
|
2376
2618
|
<tr>
|
|
2377
2619
|
<td><p><span class="term"><em class="parameter"><code>settings</code></em> :</span></p></td>
|
|
2378
|
-
<td>the object on which the signal was emitted
|
|
2379
|
-
</td>
|
|
2620
|
+
<td>the object on which the signal was emitted</td>
|
|
2380
2621
|
</tr>
|
|
2381
2622
|
<tr>
|
|
2382
2623
|
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
|
|
2383
|
-
<td>the key
|
|
2384
|
-
</td>
|
|
2624
|
+
<td>the key</td>
|
|
2385
2625
|
</tr>
|
|
2386
2626
|
<tr>
|
|
2387
2627
|
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
|
@@ -2394,6 +2634,6 @@ callbacks when the writability of "x" changes.
|
|
|
2394
2634
|
</div>
|
|
2395
2635
|
<div class="footer">
|
|
2396
2636
|
<hr>
|
|
2397
|
-
Generated by GTK-Doc V1.
|
|
2637
|
+
Generated by GTK-Doc V1.16.1</div>
|
|
2398
2638
|
</body>
|
|
2399
2639
|
</html>
|