1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" style="task" id="overview-settings" xml:lang="de">
<info>
<link type="guide" xref="index" group="settings"/>
<revision version="0.1" date="2013-08-06" status="review"/>
<credit type="author copyright">
<name>David King</name>
<email its:translate="no">davidk@gnome.org</email>
<years>2013</years>
</credit>
<desc>Flexible user configuration system.</desc>
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
<mal:name>Mario Blättermann</mal:name>
<mal:email>mario.blaettermann@gmail.com</mal:email>
<mal:years>2009-2012</mal:years>
</mal:credit>
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
<mal:name>Christian Kirbach</mal:name>
<mal:email>christian.kirbach@gmail.com</mal:email>
<mal:years>2011, 2012.</mal:years>
</mal:credit>
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
<mal:name>Aljosha Papsch</mal:name>
<mal:email>al@rpapsch.de</mal:email>
<mal:years>2012</mal:years>
</mal:credit>
</info>
<title>Settings management</title>
<list>
<item>
<p><em style="strong">High-level access for application settings</em></p>
</item>
<item>
<p><em style="strong">Easily bind settings to UI elements</em></p>
</item>
<item>
<p><em style="strong">Flexible overrides for packagers and system
administrators</em></p>
</item>
</list>
<p>Store user settings and make your application respond to them automatically
with GSettings. Easily override settings defaults as a system administrator.
Store a wide variety of data, such as integers and arrays of strings, with
ease.</p>
<section id="what">
<title>What can you do?</title>
<p>Use the <em style="strong" xref="tech-gsettings">GSettings</em> API of
GIO to read and write <em style="strong">application settings</em>. GSettings
<em style="strong">transparently uses the platform configuration
database</em> so that platform-specific configuration tools can be
used. Make <em style="strong">UI controls update according to settings</em>
with a single function.</p>
</section>
<!-- TODO: Write code sample.
<section id="samples">
<title>Code samples</title>
<list>
<item><p>A sample we should write</p></item>
<item><p><link xref="samples">More…</link></p></item>
</list>
</section>
-->
<section id="realworld">
<title>Real-world examples</title>
<p>Nearly all GNOME applications use GSettings.</p>
<list>
<item>
<p><em style="strong">Dconf editor</em> is the GUI tool for managing
preferences stored in the dconf database with GSettings.</p>
<p>( <link href="https://developer.gnome.org/dconf/unstable/dconf-editor.html">Website</link> | <link href="https://git.gnome.org/browse/dconf/tree/editor">Source code</link> )</p>
</item>
</list>
</section>
</page>
|
