<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>gconfmm: Gnome::Conf::Client Class Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.5 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="classes.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="classes.html"><span>Alphabetical List</span></a></li>
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div class="navpath"><a class="el" href="namespaceGnome.html">Gnome</a>::<a class="el" href="namespaceGnome_1_1Conf.html">Conf</a>::<a class="el" href="classGnome_1_1Conf_1_1Client.html">Client</a>
</div>
</div>
<div class="contents">
<h1>Gnome::Conf::Client Class Reference</h1><!-- doxytag: class="Gnome::Conf::Client" --><!-- doxytag: inherits="Glib::Object,Gnome::Conf::SetInterface" -->The main <a class="el" href="namespaceGnome_1_1Conf.html">Gnome::Conf</a> object.
<a href="#_details">More...</a>
<p>
<code>#include <<a class="el" href="client_8h-source.html">client.h</a>></code>
<p>
<div class="dynheader">
Inheritance diagram for Gnome::Conf::Client:</div>
<div class="dynsection">
<p><center><img src="classGnome_1_1Conf_1_1Client.png" usemap="#Gnome::Conf::Client_map" border="0" alt=""></center>
<map name="Gnome::Conf::Client_map">
<area href="classGlib_1_1Object.html" alt="Object" shape="rect" coords="0,0,158,24">
<area href="classGnome_1_1Conf_1_1SetInterface.html" alt="Gnome::Conf::SetInterface" shape="rect" coords="168,0,326,24">
</map>
</div>
<p>
<a href="classGnome_1_1Conf_1_1Client-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Public Types</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef Glib::SListHandle< int, <br>
BasicTypeTraits< int > > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#58f35130189f26313b0b221b7147271f">SListHandleInts</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef Glib::SListHandle<br>
< bool, BasicTypeTraits< bool > > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#cf8b936341ce9f52dd0e1835727e75dd">SListHandleBools</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef Glib::SListHandle<br>
< double, BasicTypeTraits<br>
< double > > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#53c51bfee8f732a028035835019003ea">SListHandleFloats</a></td></tr>
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#1bb77f2e39e1fe0fd51cf07150139eb1">~Client</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">GConfClient * </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#5df9a0136f78491379124d0bd8876075">gobj</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#5df9a0136f78491379124d0bd8876075"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const GConfClient * </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#0b2227668a2e934ecc264146b1587d50">gobj</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#0b2227668a2e934ecc264146b1587d50"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">GConfClient * </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#0679c98477afcc10e83c65a3e78475a6">gobj_copy</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. <a href="#0679c98477afcc10e83c65a3e78475a6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#752d1a7e9172b4ba4d112594c2711dfb">add_dir</a> (const Glib::ustring &dir, <a class="el" href="group__gconfmmEnums.html#gd0575a00dcfc2a15d1b15e109704e99a">ClientPreloadType</a> preload=CLIENT_PRELOAD_NONE)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Add a directory to the list of directories the <a class="el" href="classGnome_1_1Conf_1_1Client.html" title="The main Gnome::Conf object.">Client</a> will watch. <a href="#752d1a7e9172b4ba4d112594c2711dfb"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#41aaf6ebdcd026629e48446927d3666c">remove_dir</a> (const Glib::ustring &dir)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Remove a directory from the list of directories the <a class="el" href="classGnome_1_1Conf_1_1Client.html" title="The main Gnome::Conf object.">Client</a> will watch. <a href="#41aaf6ebdcd026629e48446927d3666c"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">guint </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#46ae9fb669535fb2e9c33e71bd150871">notify_add</a> (const Glib::ustring &namespace_section, <a class="el" href="namespaceGnome_1_1Conf.html#a7f52de608e8ecf7c3385b55e9674e52">Callback</a> callback)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Request notification of changes to namespace_section. <a href="#46ae9fb669535fb2e9c33e71bd150871"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#c56f16796ad1451452a4544ace2256de">notify_remove</a> (guint cnxn)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Cancel a notification request. <a href="#c56f16796ad1451452a4544ace2256de"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#b40c988361a768719926ddc50e28115e">set_error_handling</a> (<a class="el" href="group__gconfmmEnums.html#g45912783c88c883ee158c6d60dc6f2c4">ClientErrorHandlingMode</a> mode)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#4555d99d897df46fbdd9e6dfaab12a7c">clear_cache</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Clear the client-side cache. <a href="#4555d99d897df46fbdd9e6dfaab12a7c"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#9b300092e1970808ceb364eac348f7a8">preload</a> (const Glib::ustring &dirname, <a class="el" href="group__gconfmmEnums.html#gd0575a00dcfc2a15d1b15e109704e99a">ClientPreloadType</a> type)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Preloads a directory. <a href="#9b300092e1970808ceb364eac348f7a8"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGnome_1_1Conf_1_1Value.html">Value</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#059b6f4cd673d22e9c4f656904136b4d">get</a> (const Glib::ustring &key) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the value of a configuration key. <a href="#059b6f4cd673d22e9c4f656904136b4d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGnome_1_1Conf_1_1Value.html">Value</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#bb202018927c82c23c8d3c74843c4a41">get_without_default</a> (const Glib::ustring &key) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the value of a configuration key, without falling back to the default if the key has not been set. <a href="#bb202018927c82c23c8d3c74843c4a41"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGnome_1_1Conf_1_1Value.html">Value</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#ab8795987feaa0009244e3f91a574276">get_default_from_schema</a> (const Glib::ustring &key) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the default value of this key by looking it up in the appropriate schema. <a href="#ab8795987feaa0009244e3f91a574276"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGnome_1_1Conf_1_1Entry.html">Entry</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#91173a8a764cfed8acccb048358d0199">get_entry</a> (const Glib::ustring &key, bool use_schema_default=true) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the complete <a class="el" href="classGnome_1_1Conf_1_1Entry.html" title="An Entry stores an entry from a GConf "directory", including a key-value...">Entry</a> of the specified key. <a href="#91173a8a764cfed8acccb048358d0199"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGnome_1_1Conf_1_1Entry.html">Entry</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#144f33d505eec0f62de39cb0c75762cb">get_entry</a> (const Glib::ustring &key, const char *locale, bool use_schema_default=true) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the complete <a class="el" href="classGnome_1_1Conf_1_1Entry.html" title="An Entry stores an entry from a GConf "directory", including a key-value...">Entry</a> of the specified key. <a href="#144f33d505eec0f62de39cb0c75762cb"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#b6e48a6db99e2d472d97377e4e0505ba">unset</a> (const Glib::ustring &key)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Unset a configuration key. <a href="#b6e48a6db99e2d472d97377e4e0505ba"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">Glib::SListHandle< <a class="el" href="classGnome_1_1Conf_1_1Entry.html">Entry</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#ae728903846aa0bd97494d61d63f166a">all_entries</a> (const Glib::ustring &dir) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieve all keys in the given configuration directory. <a href="#ae728903846aa0bd97494d61d63f166a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">Glib::SListHandle< Glib::ustring > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#9fe7c96a54aff4e11d015df784450b95">all_dirs</a> (const Glib::ustring &dir) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieve all subdirectories of a given configuration directory. <a href="#9fe7c96a54aff4e11d015df784450b95"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#949121403d46ca78268269f36d9575af">suggest_sync</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Suggest to the GConf server that a sync of cached data to stable storage would be appropriate now. <a href="#949121403d46ca78268269f36d9575af"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#ece7a86daa026a2a6543e4bf70d1d1e8">dir_exists</a> (const Glib::ustring &) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Determine whether a given configuration directory exists. <a href="#ece7a86daa026a2a6543e4bf70d1d1e8"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#ae018f41ba9a53e3c4e5002e476c254d">key_is_writable</a> (const Glib::ustring &) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Determine whether a given configuration key is writeable by the application. <a href="#ae018f41ba9a53e3c4e5002e476c254d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">double </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#c3d0a826114da44e878539af7340fe18">get_float</a> (const Glib::ustring &key) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the float value at the given configuration key. <a href="#c3d0a826114da44e878539af7340fe18"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">gint </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#5f77cf1fccf4dc4436de8da18c3183f6">get_int</a> (const Glib::ustring &key) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the integer at the given configuration key. <a href="#5f77cf1fccf4dc4436de8da18c3183f6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#e8049b65be022921da9967da7cd3b5ff">get_bool</a> (const Glib::ustring &key) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the boolean at the given configuration key. <a href="#e8049b65be022921da9967da7cd3b5ff"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">Glib::ustring </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#2dcccf695be17214feccc43bf07a8d0e">get_string</a> (const Glib::ustring &key) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the string at the given configuration key. <a href="#2dcccf695be17214feccc43bf07a8d0e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGnome_1_1Conf_1_1Schema.html">Schema</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#d7f53c7fd8bfdba3e005a126b6ca79f8">get_schema</a> (const Glib::ustring &key) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the <a class="el" href="classGnome_1_1Conf_1_1Schema.html">Schema</a> at the given configuration key. <a href="#d7f53c7fd8bfdba3e005a126b6ca79f8"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">SListHandle_ValueInt </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#b542ac8a24891b54c359334d7dd41810">get_int_list</a> (const Glib::ustring &key) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the list of integers at the given configuration key. <a href="#b542ac8a24891b54c359334d7dd41810"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">SListHandle_ValueBool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#1f181fc1330a7525bc0826a224982ad6">get_bool_list</a> (const Glib::ustring &key) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the list of booleans at the given configuration key. <a href="#1f181fc1330a7525bc0826a224982ad6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">SListHandle_ValueFloat </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#f797b74761cb40e772c2c940bb8d3954">get_float_list</a> (const Glib::ustring &key) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the list of doubles at the given configuration key. <a href="#f797b74761cb40e772c2c940bb8d3954"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">SListHandle_ValueSchema </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#683f2ff59f540652d20c465971f8e4d2">get_schema_list</a> (const Glib::ustring &key) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the list of Schemas at the given configuration key. <a href="#683f2ff59f540652d20c465971f8e4d2"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">SListHandle_ValueString </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#818df5ad84bd1df1cbe392cbedc57aeb">get_string_list</a> (const Glib::ustring &key) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the list of strings at the given configuration key. <a href="#818df5ad84bd1df1cbe392cbedc57aeb"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="namespaceGnome_1_1Conf.html#53532813345d00a4ddcd4018ac33092d">ValuePair</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#9485c82a4e959f328bdd8aa1b9155b0b">get_pair</a> (const Glib::ustring &key, <a class="el" href="namespaceGnome_1_1Conf.html#285693631ab6667a2bcf7a4ecbfd2808">ValueTypePair</a> types) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the pair at the given configuration key. <a href="#9485c82a4e959f328bdd8aa1b9155b0b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#44e92ef5dc82f7ca79fa0fac64f6bba9">set</a> (const Glib::ustring &key, int what)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the given configuration key to the specified integer value. <a href="#44e92ef5dc82f7ca79fa0fac64f6bba9"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#133cb49ee01abbe30f111b9c924367bb">set</a> (const Glib::ustring &key, bool what)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the given configuration key to the specified boolean value. <a href="#133cb49ee01abbe30f111b9c924367bb"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#da36f42a271508cf550033bd763afa14">set</a> (const Glib::ustring &key, double what)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the given configuration key to the specified double value. <a href="#da36f42a271508cf550033bd763afa14"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#b263fb89054b60f5bd0a77dac6cbbba0">set</a> (const Glib::ustring &key, const Glib::ustring &what)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the given configuration key to the specified string. <a href="#b263fb89054b60f5bd0a77dac6cbbba0"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#ac43c01d77071452d4ce92e81b2d2eb6">set</a> (const Glib::ustring &key, const <a class="el" href="classGnome_1_1Conf_1_1Schema.html">Schema</a> &what)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the given configuration key to the specified <a class="el" href="classGnome_1_1Conf_1_1Schema.html">Schema</a>. <a href="#ac43c01d77071452d4ce92e81b2d2eb6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#ef236807423ba2e0a7b0d5d30159d91c">set</a> (const Glib::ustring &key, const <a class="el" href="classGnome_1_1Conf_1_1Value.html">Value</a> &what)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the given configuration key to the specified <a class="el" href="classGnome_1_1Conf_1_1Value.html" title="Wrapper for primitive types.">Value</a>. <a href="#ef236807423ba2e0a7b0d5d30159d91c"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#1258ba3c8548953e90be69c3f1815d4e">set_int_list</a> (const Glib::ustring &key, const <a class="el" href="classGnome_1_1Conf_1_1Client.html#58f35130189f26313b0b221b7147271f">SListHandleInts</a> &what)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#162957be007eed3cdb638bca7ff9e4d6">set_bool_list</a> (const Glib::ustring &key, const <a class="el" href="classGnome_1_1Conf_1_1Client.html#cf8b936341ce9f52dd0e1835727e75dd">SListHandleBools</a> &what)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#80c0c8ebcb9154c3c32416124b0aa0e8">set_float_list</a> (const Glib::ustring &key, const <a class="el" href="classGnome_1_1Conf_1_1Client.html#53c51bfee8f732a028035835019003ea">SListHandleFloats</a> &what)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#1fbd177777b4b4aa42543fd3537d9b4e">set_schema_list</a> (const Glib::ustring &key, const Glib::SListHandle< <a class="el" href="classGnome_1_1Conf_1_1Schema.html">Schema</a> > &what)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#d43cee2d9aebeafd02262477a3bd484a">set_string_list</a> (const Glib::ustring &key, const Glib::SListHandle< Glib::ustring > &what)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html">ChangeSet</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#bb31f9070f1315cfb3f2c528e0ab1201">change_set_from_current</a> (const Glib::SArray &set)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create a <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a> from the current values of the configuration database. <a href="#bb31f9070f1315cfb3f2c528e0ab1201"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#637924bcaf613156f2abb40914a8b3f1">change_set_commit</a> (<a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html">ChangeSet</a> &set, bool remove_commited)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Commit the <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a> to the configuration database. <a href="#637924bcaf613156f2abb40914a8b3f1"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html">ChangeSet</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#d5809e4e842457e7f67ee2efaf7ea3ce">change_set_reverse</a> (const <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html">ChangeSet</a> &set)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a> to reverse the effects of the given <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a>. <a href="#d5809e4e842457e7f67ee2efaf7ea3ce"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">Glib::SignalProxy2< void, <br>
const Glib::ustring &, const <br>
<a class="el" href="classGnome_1_1Conf_1_1Value.html">Value</a> & > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#ca9fa01e85ebca6f14b89e2dd8a7d727">signal_value_changed</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A signal emitted when a value changes. <a href="#ca9fa01e85ebca6f14b89e2dd8a7d727"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#ad70c3032da6bf53c00f1f589df8d7bb">value_changed</a> (const Glib::ustring &key, const <a class="el" href="classGnome_1_1Conf_1_1Value.html">Value</a> &value)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">Glib::SignalProxy1< void, <br>
const Glib::Error & > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#9a206872b198bb115b1136fea81c6de9">signal_error</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A signal emitted when an error occurs. <a href="#9a206872b198bb115b1136fea81c6de9"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#3100a84531a915318ce83fde4706ac91">error</a> (const Glib::Error &error)</td></tr>
<tr><td colspan="2"><br><h2>Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static Glib::RefPtr< <a class="el" href="classGnome_1_1Conf_1_1Client.html">Client</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#7bb9f0f8b8e6351d74823f432a14b59b">get_default_client</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the default client object for this application. <a href="#7bb9f0f8b8e6351d74823f432a14b59b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static Glib::RefPtr< <a class="el" href="classGnome_1_1Conf_1_1Client.html">Client</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#30015273b97fdeae6f3c0f4aaf75aebe">get_client_for_engine</a> (GConfEngine *engine)</td></tr>
<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#5b7c2ecbd06e5db0b892f07885047a83">on_value_changed</a> (const Glib::ustring &key, const <a class="el" href="classGnome_1_1Conf_1_1Value.html">Value</a> &value)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#5d08ed907b817c2f37ed26d7d49bf8d3">on_unreturned_error</a> (const Glib::Error &error)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#79f42d1932b6ba088e7092f5ec0da15b">on_error</a> (const Glib::Error &error)</td></tr>
<tr><td colspan="2"><br><h2>Related Functions</h2></td></tr>
<tr><td colspan="2">(Note that these are not member functions.) <br><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">Glib::RefPtr< <a class="el" href="classGnome_1_1Conf_1_1Client.html">Gnome::Conf::Client</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Conf_1_1Client.html#bf27c17240058ebb5f26cdc872af043e">wrap</a> (GConfClient *object, bool take_copy=false)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A Glib::wrap() method for this object. <a href="#bf27c17240058ebb5f26cdc872af043e"></a><br></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
The main <a class="el" href="namespaceGnome_1_1Conf.html">Gnome::Conf</a> object.
<p>
This class allows you to interface withe the <a class="el" href="namespaceGnome.html">Gnome</a> configuration system. Generally, it stores key-value pairs. The keys have an hierarchical namespace, with elements separated by slashes. The values are either typed primitives (int, bool, string, float or a <code><a class="el" href="classGnome_1_1Conf_1_1Schema.html">Schema</a></code>), or lists of primitives or pairs of primitives (for limits on the compound values, see <a class="el" href="classGnome_1_1Conf_1_1Value.html" title="Wrapper for primitive types.">Value</a>). For conventions on the names of keys, see the GConf documentation. <hr><h2>Member Typedef Documentation</h2>
<a class="anchor" name="58f35130189f26313b0b221b7147271f"></a><!-- doxytag: member="Gnome::Conf::Client::SListHandleInts" ref="58f35130189f26313b0b221b7147271f" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef Glib::SListHandle< int, BasicTypeTraits<int> > <a class="el" href="classGnome_1_1Conf_1_1Client.html#58f35130189f26313b0b221b7147271f">Gnome::Conf::Client::SListHandleInts</a> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="cf8b936341ce9f52dd0e1835727e75dd"></a><!-- doxytag: member="Gnome::Conf::Client::SListHandleBools" ref="cf8b936341ce9f52dd0e1835727e75dd" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef Glib::SListHandle< bool, BasicTypeTraits<bool> > <a class="el" href="classGnome_1_1Conf_1_1Client.html#cf8b936341ce9f52dd0e1835727e75dd">Gnome::Conf::Client::SListHandleBools</a> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="53c51bfee8f732a028035835019003ea"></a><!-- doxytag: member="Gnome::Conf::Client::SListHandleFloats" ref="53c51bfee8f732a028035835019003ea" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef Glib::SListHandle< double, BasicTypeTraits<double> > <a class="el" href="classGnome_1_1Conf_1_1Client.html#53c51bfee8f732a028035835019003ea">Gnome::Conf::Client::SListHandleFloats</a> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<hr><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" name="1bb77f2e39e1fe0fd51cf07150139eb1"></a><!-- doxytag: member="Gnome::Conf::Client::~Client" ref="1bb77f2e39e1fe0fd51cf07150139eb1" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual Gnome::Conf::Client::~Client </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="5df9a0136f78491379124d0bd8876075"></a><!-- doxytag: member="Gnome::Conf::Client::gobj" ref="5df9a0136f78491379124d0bd8876075" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GConfClient* Gnome::Conf::Client::gobj </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Provides access to the underlying C GObject.
<p>
</div>
</div><p>
<a class="anchor" name="0b2227668a2e934ecc264146b1587d50"></a><!-- doxytag: member="Gnome::Conf::Client::gobj" ref="0b2227668a2e934ecc264146b1587d50" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const GConfClient* Gnome::Conf::Client::gobj </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Provides access to the underlying C GObject.
<p>
</div>
</div><p>
<a class="anchor" name="0679c98477afcc10e83c65a3e78475a6"></a><!-- doxytag: member="Gnome::Conf::Client::gobj_copy" ref="0679c98477afcc10e83c65a3e78475a6" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GConfClient* Gnome::Conf::Client::gobj_copy </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
<p>
</div>
</div><p>
<a class="anchor" name="7bb9f0f8b8e6351d74823f432a14b59b"></a><!-- doxytag: member="Gnome::Conf::Client::get_default_client" ref="7bb9f0f8b8e6351d74823f432a14b59b" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static Glib::RefPtr<<a class="el" href="classGnome_1_1Conf_1_1Client.html">Client</a>> Gnome::Conf::Client::get_default_client </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the default client object for this application.
<p>
The object is a Singleton, so you will always get the same instance. Most applications should use this.
</div>
</div><p>
<a class="anchor" name="30015273b97fdeae6f3c0f4aaf75aebe"></a><!-- doxytag: member="Gnome::Conf::Client::get_client_for_engine" ref="30015273b97fdeae6f3c0f4aaf75aebe" args="(GConfEngine *engine)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static Glib::RefPtr<<a class="el" href="classGnome_1_1Conf_1_1Client.html">Client</a>> Gnome::Conf::Client::get_client_for_engine </td>
<td>(</td>
<td class="paramtype">GConfEngine * </td>
<td class="paramname"> <em>engine</em> </td>
<td> ) </td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="752d1a7e9172b4ba4d112594c2711dfb"></a><!-- doxytag: member="Gnome::Conf::Client::add_dir" ref="752d1a7e9172b4ba4d112594c2711dfb" args="(const Glib::ustring &dir, ClientPreloadType preload=CLIENT_PRELOAD_NONE)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::add_dir </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>dir</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__gconfmmEnums.html#gd0575a00dcfc2a15d1b15e109704e99a">ClientPreloadType</a> </td>
<td class="paramname"> <em>preload</em> = <code>CLIENT_PRELOAD_NONE</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Add a directory to the list of directories the <a class="el" href="classGnome_1_1Conf_1_1Client.html" title="The main Gnome::Conf object.">Client</a> will watch.
<p>
Any changes to keys below this directory will cause the "value_changed" signal to be emitted. When you add the directory, you can request that the <a class="el" href="classGnome_1_1Conf_1_1Client.html" title="The main Gnome::Conf object.">Client</a> preloads its contents - see ClientPreloadType for details.<p>
Added directories may not overlap. That is, if you add "/foo", you may not add "/foo/bar". However you can add "/foo" and "/bar". You can also add "/foo" multiple times; if you add a directory multiple times, it will not be removed until you call <a class="el" href="classGnome_1_1Conf_1_1Client.html#41aaf6ebdcd026629e48446927d3666c" title="Remove a directory from the list of directories the Client will watch.">remove_dir()</a> an equal number of times. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dir,:</em> </td><td>the directory to watch. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>preload,:</em> </td><td>the preload type (if any) to be performed. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="41aaf6ebdcd026629e48446927d3666c"></a><!-- doxytag: member="Gnome::Conf::Client::remove_dir" ref="41aaf6ebdcd026629e48446927d3666c" args="(const Glib::ustring &dir)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::remove_dir </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>dir</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Remove a directory from the list of directories the <a class="el" href="classGnome_1_1Conf_1_1Client.html" title="The main Gnome::Conf object.">Client</a> will watch.
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classGnome_1_1Conf_1_1Client.html#752d1a7e9172b4ba4d112594c2711dfb" title="Add a directory to the list of directories the Client will watch.">add_dir()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="46ae9fb669535fb2e9c33e71bd150871"></a><!-- doxytag: member="Gnome::Conf::Client::notify_add" ref="46ae9fb669535fb2e9c33e71bd150871" args="(const Glib::ustring &namespace_section, Callback callback)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">guint Gnome::Conf::Client::notify_add </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>namespace_section</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="namespaceGnome_1_1Conf.html#a7f52de608e8ecf7c3385b55e9674e52">Callback</a> </td>
<td class="paramname"> <em>callback</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Request notification of changes to namespace_section.
<p>
This includes the key <code>namespace_section</code> itself, and any keys below it. For the notification to happen, <code>namespace_section</code> must be equal to or below one of the directories added with <a class="el" href="classGnome_1_1Conf_1_1Client.html#752d1a7e9172b4ba4d112594c2711dfb" title="Add a directory to the list of directories the Client will watch.">add_dir()</a>. You can still call <a class="el" href="classGnome_1_1Conf_1_1Client.html#46ae9fb669535fb2e9c33e71bd150871" title="Request notification of changes to namespace_section.">notify_add()</a> for other directories, but no notification will be received until you add a directory above or equal to <code>namespace_section</code>. One implication of this is that <a class="el" href="classGnome_1_1Conf_1_1Client.html#41aaf6ebdcd026629e48446927d3666c" title="Remove a directory from the list of directories the Client will watch.">remove_dir()</a> temporarily disables notifications that were below the removed directory.<p>
The callback will be called with the key that changed and the <a class="el" href="classGnome_1_1Conf_1_1Entry.html" title="An Entry stores an entry from a GConf "directory", including a key-value...">Entry</a> that holds the new <a class="el" href="classGnome_1_1Conf_1_1Value.html" title="Wrapper for primitive types.">Value</a>. If the <a class="el" href="classGnome_1_1Conf_1_1Value.html" title="Wrapper for primitive types.">Value</a> has a type of VALUE_INVALID, then the key has been unset.<p>
The function returns a connection ID you can use when calling <a class="el" href="classGnome_1_1Conf_1_1Client.html#c56f16796ad1451452a4544ace2256de" title="Cancel a notification request.">notify_remove()</a>.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>namespace_section,:</em> </td><td>the namespace section for which notification is required. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>callback,:</em> </td><td>the sigc::slot to call when the a key under namespace_section changes. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>a connection id that can be passed to <a class="el" href="classGnome_1_1Conf_1_1Client.html#c56f16796ad1451452a4544ace2256de" title="Cancel a notification request.">notify_remove()</a> to cancel the notification request. </dd></dl>
</div>
</div><p>
<a class="anchor" name="c56f16796ad1451452a4544ace2256de"></a><!-- doxytag: member="Gnome::Conf::Client::notify_remove" ref="c56f16796ad1451452a4544ace2256de" args="(guint cnxn)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::notify_remove </td>
<td>(</td>
<td class="paramtype">guint </td>
<td class="paramname"> <em>cnxn</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Cancel a notification request.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>cnxn,:</em> </td><td>a connection id, previously returned by <a class="el" href="classGnome_1_1Conf_1_1Client.html#46ae9fb669535fb2e9c33e71bd150871" title="Request notification of changes to namespace_section.">notify_add()</a> </td></tr>
</table>
</dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classGnome_1_1Conf_1_1Client.html#46ae9fb669535fb2e9c33e71bd150871" title="Request notification of changes to namespace_section.">notify_add()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="b40c988361a768719926ddc50e28115e"></a><!-- doxytag: member="Gnome::Conf::Client::set_error_handling" ref="b40c988361a768719926ddc50e28115e" args="(ClientErrorHandlingMode mode)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::set_error_handling </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__gconfmmEnums.html#g45912783c88c883ee158c6d60dc6f2c4">ClientErrorHandlingMode</a> </td>
<td class="paramname"> <em>mode</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="4555d99d897df46fbdd9e6dfaab12a7c"></a><!-- doxytag: member="Gnome::Conf::Client::clear_cache" ref="4555d99d897df46fbdd9e6dfaab12a7c" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::clear_cache </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Clear the client-side cache.
<p>
</div>
</div><p>
<a class="anchor" name="9b300092e1970808ceb364eac348f7a8"></a><!-- doxytag: member="Gnome::Conf::Client::preload" ref="9b300092e1970808ceb364eac348f7a8" args="(const Glib::ustring &dirname, ClientPreloadType type)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::preload </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>dirname</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__gconfmmEnums.html#gd0575a00dcfc2a15d1b15e109704e99a">ClientPreloadType</a> </td>
<td class="paramname"> <em>type</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Preloads a directory.
<p>
Normally this happens automatically with <a class="el" href="classGnome_1_1Conf_1_1Client.html#752d1a7e9172b4ba4d112594c2711dfb" title="Add a directory to the list of directories the Client will watch.">add_dir()</a>, but if you've called <a class="el" href="classGnome_1_1Conf_1_1Client.html#4555d99d897df46fbdd9e6dfaab12a7c" title="Clear the client-side cache.">clear_cache()</a> you may need to do it again. <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classGnome_1_1Conf_1_1Client.html#752d1a7e9172b4ba4d112594c2711dfb" title="Add a directory to the list of directories the Client will watch.">add_dir()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="059b6f4cd673d22e9c4f656904136b4d"></a><!-- doxytag: member="Gnome::Conf::Client::get" ref="059b6f4cd673d22e9c4f656904136b4d" args="(const Glib::ustring &key) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGnome_1_1Conf_1_1Value.html">Value</a> Gnome::Conf::Client::get </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the value of a configuration key.
<p>
key: the configuration key to retrieve. <dl class="return" compact><dt><b>Returns:</b></dt><dd>the <a class="el" href="classGnome_1_1Conf_1_1Value.html" title="Wrapper for primitive types.">Value</a> of the key. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>Gnome::Conf::Error.</em> </td><td></td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="bb202018927c82c23c8d3c74843c4a41"></a><!-- doxytag: member="Gnome::Conf::Client::get_without_default" ref="bb202018927c82c23c8d3c74843c4a41" args="(const Glib::ustring &key) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGnome_1_1Conf_1_1Value.html">Value</a> Gnome::Conf::Client::get_without_default </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the value of a configuration key, without falling back to the default if the key has not been set.
<p>
In that case, the type of the value will be VALUE_INVALID. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>key,:</em> </td><td>the configuration key to retrieve. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the <a class="el" href="classGnome_1_1Conf_1_1Value.html" title="Wrapper for primitive types.">Value</a> of the key. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>Gnome::Conf::Error.</em> </td><td></td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="ab8795987feaa0009244e3f91a574276"></a><!-- doxytag: member="Gnome::Conf::Client::get_default_from_schema" ref="ab8795987feaa0009244e3f91a574276" args="(const Glib::ustring &key) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGnome_1_1Conf_1_1Value.html">Value</a> Gnome::Conf::Client::get_default_from_schema </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the default value of this key by looking it up in the appropriate schema.
<p>
key: the configuration key to retrieve. <dl class="return" compact><dt><b>Returns:</b></dt><dd>the default <a class="el" href="classGnome_1_1Conf_1_1Value.html" title="Wrapper for primitive types.">Value</a> of the key. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>Gnome::Conf::Error.</em> </td><td></td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="91173a8a764cfed8acccb048358d0199"></a><!-- doxytag: member="Gnome::Conf::Client::get_entry" ref="91173a8a764cfed8acccb048358d0199" args="(const Glib::ustring &key, bool use_schema_default=true) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGnome_1_1Conf_1_1Entry.html">Entry</a> Gnome::Conf::Client::get_entry </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>use_schema_default</em> = <code>true</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the complete <a class="el" href="classGnome_1_1Conf_1_1Entry.html" title="An Entry stores an entry from a GConf "directory", including a key-value...">Entry</a> of the specified key.
<p>
Uses the default locale <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>the configuration key to retrieve. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>use_schema_default</em> </td><td>whether to fall back to the <a class="el" href="classGnome_1_1Conf_1_1Schema.html">Schema</a> default value if the specified configuration key has not been set. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>an <a class="el" href="classGnome_1_1Conf_1_1Entry.html" title="An Entry stores an entry from a GConf "directory", including a key-value...">Entry</a> for the corresponding configuration key. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>Gnome::Conf::Error.</em> </td><td></td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="144f33d505eec0f62de39cb0c75762cb"></a><!-- doxytag: member="Gnome::Conf::Client::get_entry" ref="144f33d505eec0f62de39cb0c75762cb" args="(const Glib::ustring &key, const char *locale, bool use_schema_default=true) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGnome_1_1Conf_1_1Entry.html">Entry</a> Gnome::Conf::Client::get_entry </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>locale</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>use_schema_default</em> = <code>true</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the complete <a class="el" href="classGnome_1_1Conf_1_1Entry.html" title="An Entry stores an entry from a GConf "directory", including a key-value...">Entry</a> of the specified key.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>the configuration key to retrieve. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>locale</em> </td><td>the locale for the user-visible strings in the Entry's <a class="el" href="classGnome_1_1Conf_1_1Schema.html">Schema</a>. Use 0 to use the default. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>use_schema_default</em> </td><td>whether to fall back to the <a class="el" href="classGnome_1_1Conf_1_1Schema.html">Schema</a> default value if the specified configuration key has not been set. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>an <a class="el" href="classGnome_1_1Conf_1_1Entry.html" title="An Entry stores an entry from a GConf "directory", including a key-value...">Entry</a> for the corresponding configuration key. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>Gnome::Conf::Error.</em> </td><td></td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="b6e48a6db99e2d472d97377e4e0505ba"></a><!-- doxytag: member="Gnome::Conf::Client::unset" ref="b6e48a6db99e2d472d97377e4e0505ba" args="(const Glib::ustring &key)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::unset </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Unset a configuration key.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>the configuration key to unset. </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>Gnome::Conf::Error.</em> </td><td></td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="ae728903846aa0bd97494d61d63f166a"></a><!-- doxytag: member="Gnome::Conf::Client::all_entries" ref="ae728903846aa0bd97494d61d63f166a" args="(const Glib::ustring &dir) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Glib::SListHandle<<a class="el" href="classGnome_1_1Conf_1_1Entry.html">Entry</a>> Gnome::Conf::Client::all_entries </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>dir</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Retrieve all keys in the given configuration directory.
<p>
Get all the configuration keys in the given directory, without recursion. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dir,:</em> </td><td>the configuration directory to scan. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>a container with the names of the configuration keys. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>Gnome::Conf::Error.</em> </td><td></td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="9fe7c96a54aff4e11d015df784450b95"></a><!-- doxytag: member="Gnome::Conf::Client::all_dirs" ref="9fe7c96a54aff4e11d015df784450b95" args="(const Glib::ustring &dir) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Glib::SListHandle<Glib::ustring> Gnome::Conf::Client::all_dirs </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>dir</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Retrieve all subdirectories of a given configuration directory.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dir,:</em> </td><td>the configuration directory to scan. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>a container with the names of the subdirectories. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>Gnome::Conf::Error.</em> </td><td></td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="949121403d46ca78268269f36d9575af"></a><!-- doxytag: member="Gnome::Conf::Client::suggest_sync" ref="949121403d46ca78268269f36d9575af" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::suggest_sync </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Suggest to the GConf server that a sync of cached data to stable storage would be appropriate now.
<p>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>Gnome::Conf::Error.</em> </td><td></td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="ece7a86daa026a2a6543e4bf70d1d1e8"></a><!-- doxytag: member="Gnome::Conf::Client::dir_exists" ref="ece7a86daa026a2a6543e4bf70d1d1e8" args="(const Glib::ustring &) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gnome::Conf::Client::dir_exists </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Determine whether a given configuration directory exists.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>true if the directory exists. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>Gnome::Conf::Error.</em> </td><td></td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="ae018f41ba9a53e3c4e5002e476c254d"></a><!-- doxytag: member="Gnome::Conf::Client::key_is_writable" ref="ae018f41ba9a53e3c4e5002e476c254d" args="(const Glib::ustring &) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gnome::Conf::Client::key_is_writable </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Determine whether a given configuration key is writeable by the application.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>true if the key is writeable. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>Gnome::Conf::Error.</em> </td><td></td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="c3d0a826114da44e878539af7340fe18"></a><!-- doxytag: member="Gnome::Conf::Client::get_float" ref="c3d0a826114da44e878539af7340fe18" args="(const Glib::ustring &key) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">double Gnome::Conf::Client::get_float </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the float value at the given configuration key.
<p>
Throws an error if the key does not contain the appropriate type. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>key,:</em> </td><td>the configuration key to fetch. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the value at the specified configuration key. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classGnome_1_1Conf_1_1Error.html" title="Exception class for Gnome::Conf::Client errors.">Gnome::Conf::Error</a></em> </td><td></td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="5f77cf1fccf4dc4436de8da18c3183f6"></a><!-- doxytag: member="Gnome::Conf::Client::get_int" ref="5f77cf1fccf4dc4436de8da18c3183f6" args="(const Glib::ustring &key) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">gint Gnome::Conf::Client::get_int </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the integer at the given configuration key.
<p>
</div>
</div><p>
<a class="anchor" name="e8049b65be022921da9967da7cd3b5ff"></a><!-- doxytag: member="Gnome::Conf::Client::get_bool" ref="e8049b65be022921da9967da7cd3b5ff" args="(const Glib::ustring &key) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gnome::Conf::Client::get_bool </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the boolean at the given configuration key.
<p>
</div>
</div><p>
<a class="anchor" name="2dcccf695be17214feccc43bf07a8d0e"></a><!-- doxytag: member="Gnome::Conf::Client::get_string" ref="2dcccf695be17214feccc43bf07a8d0e" args="(const Glib::ustring &key) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Glib::ustring Gnome::Conf::Client::get_string </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the string at the given configuration key.
<p>
</div>
</div><p>
<a class="anchor" name="d7f53c7fd8bfdba3e005a126b6ca79f8"></a><!-- doxytag: member="Gnome::Conf::Client::get_schema" ref="d7f53c7fd8bfdba3e005a126b6ca79f8" args="(const Glib::ustring &key) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGnome_1_1Conf_1_1Schema.html">Schema</a> Gnome::Conf::Client::get_schema </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the <a class="el" href="classGnome_1_1Conf_1_1Schema.html">Schema</a> at the given configuration key.
<p>
</div>
</div><p>
<a class="anchor" name="b542ac8a24891b54c359334d7dd41810"></a><!-- doxytag: member="Gnome::Conf::Client::get_int_list" ref="b542ac8a24891b54c359334d7dd41810" args="(const Glib::ustring &key) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">SListHandle_ValueInt Gnome::Conf::Client::get_int_list </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the list of integers at the given configuration key.
<p>
If the given key is not a list, or the list elements are not of the appropriate type, an error will be thrown. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>the configuration key that contains the list. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>a Glib::SListHandle of the appropriate type. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classGnome_1_1Conf_1_1Error.html" title="Exception class for Gnome::Conf::Client errors.">Gnome::Conf::Error</a></em> </td><td></td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="1f181fc1330a7525bc0826a224982ad6"></a><!-- doxytag: member="Gnome::Conf::Client::get_bool_list" ref="1f181fc1330a7525bc0826a224982ad6" args="(const Glib::ustring &key) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">SListHandle_ValueBool Gnome::Conf::Client::get_bool_list </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the list of booleans at the given configuration key.
<p>
</div>
</div><p>
<a class="anchor" name="f797b74761cb40e772c2c940bb8d3954"></a><!-- doxytag: member="Gnome::Conf::Client::get_float_list" ref="f797b74761cb40e772c2c940bb8d3954" args="(const Glib::ustring &key) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">SListHandle_ValueFloat Gnome::Conf::Client::get_float_list </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the list of doubles at the given configuration key.
<p>
</div>
</div><p>
<a class="anchor" name="683f2ff59f540652d20c465971f8e4d2"></a><!-- doxytag: member="Gnome::Conf::Client::get_schema_list" ref="683f2ff59f540652d20c465971f8e4d2" args="(const Glib::ustring &key) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">SListHandle_ValueSchema Gnome::Conf::Client::get_schema_list </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the list of Schemas at the given configuration key.
<p>
</div>
</div><p>
<a class="anchor" name="818df5ad84bd1df1cbe392cbedc57aeb"></a><!-- doxytag: member="Gnome::Conf::Client::get_string_list" ref="818df5ad84bd1df1cbe392cbedc57aeb" args="(const Glib::ustring &key) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">SListHandle_ValueString Gnome::Conf::Client::get_string_list </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the list of strings at the given configuration key.
<p>
</div>
</div><p>
<a class="anchor" name="9485c82a4e959f328bdd8aa1b9155b0b"></a><!-- doxytag: member="Gnome::Conf::Client::get_pair" ref="9485c82a4e959f328bdd8aa1b9155b0b" args="(const Glib::ustring &key, ValueTypePair types) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="namespaceGnome_1_1Conf.html#53532813345d00a4ddcd4018ac33092d">ValuePair</a> Gnome::Conf::Client::get_pair </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="namespaceGnome_1_1Conf.html#285693631ab6667a2bcf7a4ecbfd2808">ValueTypePair</a> </td>
<td class="paramname"> <em>types</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the pair at the given configuration key.
<p>
The pair's elements must have the types given in <code>types</code> respectively. If the value is not a pair or the types do not match, an error will be thrown. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>the configuration key that contains the pair. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>types</em> </td><td>a pair of the expected types of the values. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>a ValuePair. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classGnome_1_1Conf_1_1Error.html" title="Exception class for Gnome::Conf::Client errors.">Gnome::Conf::Error</a></em> </td><td></td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="44e92ef5dc82f7ca79fa0fac64f6bba9"></a><!-- doxytag: member="Gnome::Conf::Client::set" ref="44e92ef5dc82f7ca79fa0fac64f6bba9" args="(const Glib::ustring &key, int what)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::set </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>what</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set the given configuration key to the specified integer value.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>the configuration key to set. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>what</em> </td><td>the value to set it to. </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classGnome_1_1Conf_1_1Error.html" title="Exception class for Gnome::Conf::Client errors.">Gnome::Conf::Error</a></em> </td><td></td></tr>
</table>
</dl>
<p>Implements <a class="el" href="classGnome_1_1Conf_1_1SetInterface.html#9f3eb6b23df170f835771f9241d675ba">Gnome::Conf::SetInterface</a>.</p>
</div>
</div><p>
<a class="anchor" name="133cb49ee01abbe30f111b9c924367bb"></a><!-- doxytag: member="Gnome::Conf::Client::set" ref="133cb49ee01abbe30f111b9c924367bb" args="(const Glib::ustring &key, bool what)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::set </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>what</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set the given configuration key to the specified boolean value.
<p>
Set the given configuration key to the specified integer value. <p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>the configuration key to set. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>what</em> </td><td>the value to set it to. </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classGnome_1_1Conf_1_1Error.html" title="Exception class for Gnome::Conf::Client errors.">Gnome::Conf::Error</a></em> </td><td></td></tr>
</table>
</dl>
<p>Implements <a class="el" href="classGnome_1_1Conf_1_1SetInterface.html#7e1003845faa0897722a491a738dc425">Gnome::Conf::SetInterface</a>.</p>
</div>
</div><p>
<a class="anchor" name="da36f42a271508cf550033bd763afa14"></a><!-- doxytag: member="Gnome::Conf::Client::set" ref="da36f42a271508cf550033bd763afa14" args="(const Glib::ustring &key, double what)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::set </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double </td>
<td class="paramname"> <em>what</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set the given configuration key to the specified double value.
<p>
Set the given configuration key to the specified integer value. <p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>the configuration key to set. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>what</em> </td><td>the value to set it to. </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classGnome_1_1Conf_1_1Error.html" title="Exception class for Gnome::Conf::Client errors.">Gnome::Conf::Error</a></em> </td><td></td></tr>
</table>
</dl>
<p>Implements <a class="el" href="classGnome_1_1Conf_1_1SetInterface.html#ab09868d6718240f5999f4d647a22f72">Gnome::Conf::SetInterface</a>.</p>
</div>
</div><p>
<a class="anchor" name="b263fb89054b60f5bd0a77dac6cbbba0"></a><!-- doxytag: member="Gnome::Conf::Client::set" ref="b263fb89054b60f5bd0a77dac6cbbba0" args="(const Glib::ustring &key, const Glib::ustring &what)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::set </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>what</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set the given configuration key to the specified string.
<p>
Set the given configuration key to the specified integer value. <p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>the configuration key to set. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>what</em> </td><td>the value to set it to. </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classGnome_1_1Conf_1_1Error.html" title="Exception class for Gnome::Conf::Client errors.">Gnome::Conf::Error</a></em> </td><td></td></tr>
</table>
</dl>
<p>Implements <a class="el" href="classGnome_1_1Conf_1_1SetInterface.html#bfae1a040cc44b0f7293451cef652ff2">Gnome::Conf::SetInterface</a>.</p>
</div>
</div><p>
<a class="anchor" name="ac43c01d77071452d4ce92e81b2d2eb6"></a><!-- doxytag: member="Gnome::Conf::Client::set" ref="ac43c01d77071452d4ce92e81b2d2eb6" args="(const Glib::ustring &key, const Schema &what)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::set </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGnome_1_1Conf_1_1Schema.html">Schema</a> & </td>
<td class="paramname"> <em>what</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set the given configuration key to the specified <a class="el" href="classGnome_1_1Conf_1_1Schema.html">Schema</a>.
<p>
Set the given configuration key to the specified integer value. <p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>the configuration key to set. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>what</em> </td><td>the value to set it to. </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classGnome_1_1Conf_1_1Error.html" title="Exception class for Gnome::Conf::Client errors.">Gnome::Conf::Error</a></em> </td><td></td></tr>
</table>
</dl>
<p>Implements <a class="el" href="classGnome_1_1Conf_1_1SetInterface.html#27e9b88d39385f64d5e708007a438a34">Gnome::Conf::SetInterface</a>.</p>
</div>
</div><p>
<a class="anchor" name="ef236807423ba2e0a7b0d5d30159d91c"></a><!-- doxytag: member="Gnome::Conf::Client::set" ref="ef236807423ba2e0a7b0d5d30159d91c" args="(const Glib::ustring &key, const Value &what)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::set </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGnome_1_1Conf_1_1Value.html">Value</a> & </td>
<td class="paramname"> <em>what</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set the given configuration key to the specified <a class="el" href="classGnome_1_1Conf_1_1Value.html" title="Wrapper for primitive types.">Value</a>.
<p>
Set the given configuration key to the specified integer value. <p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>the configuration key to set. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>what</em> </td><td>the value to set it to. </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classGnome_1_1Conf_1_1Error.html" title="Exception class for Gnome::Conf::Client errors.">Gnome::Conf::Error</a></em> </td><td></td></tr>
</table>
</dl>
<p>Implements <a class="el" href="classGnome_1_1Conf_1_1SetInterface.html#ff29fa04ecbe3c81811b6129a9bec556">Gnome::Conf::SetInterface</a>.</p>
</div>
</div><p>
<a class="anchor" name="1258ba3c8548953e90be69c3f1815d4e"></a><!-- doxytag: member="Gnome::Conf::Client::set_int_list" ref="1258ba3c8548953e90be69c3f1815d4e" args="(const Glib::ustring &key, const SListHandleInts &what)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::set_int_list </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGnome_1_1Conf_1_1Client.html#58f35130189f26313b0b221b7147271f">SListHandleInts</a> & </td>
<td class="paramname"> <em>what</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="162957be007eed3cdb638bca7ff9e4d6"></a><!-- doxytag: member="Gnome::Conf::Client::set_bool_list" ref="162957be007eed3cdb638bca7ff9e4d6" args="(const Glib::ustring &key, const SListHandleBools &what)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::set_bool_list </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGnome_1_1Conf_1_1Client.html#cf8b936341ce9f52dd0e1835727e75dd">SListHandleBools</a> & </td>
<td class="paramname"> <em>what</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="80c0c8ebcb9154c3c32416124b0aa0e8"></a><!-- doxytag: member="Gnome::Conf::Client::set_float_list" ref="80c0c8ebcb9154c3c32416124b0aa0e8" args="(const Glib::ustring &key, const SListHandleFloats &what)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::set_float_list </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGnome_1_1Conf_1_1Client.html#53c51bfee8f732a028035835019003ea">SListHandleFloats</a> & </td>
<td class="paramname"> <em>what</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="1fbd177777b4b4aa42543fd3537d9b4e"></a><!-- doxytag: member="Gnome::Conf::Client::set_schema_list" ref="1fbd177777b4b4aa42543fd3537d9b4e" args="(const Glib::ustring &key, const Glib::SListHandle< Schema > &what)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::set_schema_list </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const Glib::SListHandle< <a class="el" href="classGnome_1_1Conf_1_1Schema.html">Schema</a> > & </td>
<td class="paramname"> <em>what</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="d43cee2d9aebeafd02262477a3bd484a"></a><!-- doxytag: member="Gnome::Conf::Client::set_string_list" ref="d43cee2d9aebeafd02262477a3bd484a" args="(const Glib::ustring &key, const Glib::SListHandle< Glib::ustring > &what)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::set_string_list </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const Glib::SListHandle< Glib::ustring > & </td>
<td class="paramname"> <em>what</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="bb31f9070f1315cfb3f2c528e0ab1201"></a><!-- doxytag: member="Gnome::Conf::Client::change_set_from_current" ref="bb31f9070f1315cfb3f2c528e0ab1201" args="(const Glib::SArray &set)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html">ChangeSet</a> Gnome::Conf::Client::change_set_from_current </td>
<td>(</td>
<td class="paramtype">const Glib::SArray & </td>
<td class="paramname"> <em>set</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Create a <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a> from the current values of the configuration database.
<p>
Creates a <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a> containing the current values of all the keys listed in the <code>set</code>. For instance, this could be used in a preferences dialog as an undo operation. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>set</em> </td><td>A container of the configuration keys to backup. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a> with the current values. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classGnome_1_1Conf_1_1Error.html" title="Exception class for Gnome::Conf::Client errors.">Gnome::Conf::Error</a></em> </td><td></td></tr>
</table>
</dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="637924bcaf613156f2abb40914a8b3f1"></a><!-- doxytag: member="Gnome::Conf::Client::change_set_commit" ref="637924bcaf613156f2abb40914a8b3f1" args="(ChangeSet &set, bool remove_commited)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::change_set_commit </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html">ChangeSet</a> & </td>
<td class="paramname"> <em>set</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>remove_commited</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Commit the <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a> to the configuration database.
<p>
Commits the configuration changes in the <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a> to the database. If <code>remove_commited</code> is <code>true</code>, all successfully commited keys will be removed from the <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a>. If an error occurs, a <a class="el" href="classGnome_1_1Conf_1_1Error.html" title="Exception class for Gnome::Conf::Client errors.">Gnome::Conf::Error</a> will be thrown. This operation is not atomic - an error will be thrown on the first error. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>set</em> </td><td>the <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a> to commit. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>remove_commited</em> </td><td>whether to remove successfully-commited keys from the <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a>. </td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classGnome_1_1Conf_1_1Error.html" title="Exception class for Gnome::Conf::Client errors.">Gnome::Conf::Error</a></em> </td><td></td></tr>
</table>
</dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="d5809e4e842457e7f67ee2efaf7ea3ce"></a><!-- doxytag: member="Gnome::Conf::Client::change_set_reverse" ref="d5809e4e842457e7f67ee2efaf7ea3ce" args="(const ChangeSet &set)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html">ChangeSet</a> Gnome::Conf::Client::change_set_reverse </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html">ChangeSet</a> & </td>
<td class="paramname"> <em>set</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Creates a <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a> to reverse the effects of the given <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a>.
<p>
Creates a <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a> that contains the current values of the keys in <code>set</code>, effectively creating a back-up of the values in the database that will be modifed when the <code>set</code> will be commited. For instance, this allows you to create a back-up changeset to use in case of errors, or an undo facility for preferences. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>set</em> </td><td>the <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a> to reverse. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the reverse <a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a>. </dd></dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classGnome_1_1Conf_1_1Error.html" title="Exception class for Gnome::Conf::Client errors.">Gnome::Conf::Error</a></em> </td><td></td></tr>
</table>
</dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classGnome_1_1Conf_1_1ChangeSet.html" title="A ChangeSet is a set of changes to the GConf database that can be commited and reversed...">ChangeSet</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="ca9fa01e85ebca6f14b89e2dd8a7d727"></a><!-- doxytag: member="Gnome::Conf::Client::signal_value_changed" ref="ca9fa01e85ebca6f14b89e2dd8a7d727" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Glib::SignalProxy2< void,const Glib::ustring&,const <a class="el" href="classGnome_1_1Conf_1_1Value.html">Value</a>& > Gnome::Conf::Client::signal_value_changed </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
A signal emitted when a value changes.
<p>
This signal will only be called for directories added with <a class="el" href="classGnome_1_1Conf_1_1Client.html#752d1a7e9172b4ba4d112594c2711dfb" title="Add a directory to the list of directories the Client will watch.">add_dir()</a>.<p>
<dl class="user" compact><dt><b>Prototype:</b></dt><dd><code>void on_my_value_changed(const Glib::ustring& key, const <a class="el" href="classGnome_1_1Conf_1_1Value.html" title="Wrapper for primitive types.">Value</a>& value)</code> </dd></dl>
</div>
</div><p>
<a class="anchor" name="ad70c3032da6bf53c00f1f589df8d7bb"></a><!-- doxytag: member="Gnome::Conf::Client::value_changed" ref="ad70c3032da6bf53c00f1f589df8d7bb" args="(const Glib::ustring &key, const Value &value)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::value_changed </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGnome_1_1Conf_1_1Value.html">Value</a> & </td>
<td class="paramname"> <em>value</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="9a206872b198bb115b1136fea81c6de9"></a><!-- doxytag: member="Gnome::Conf::Client::signal_error" ref="9a206872b198bb115b1136fea81c6de9" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Glib::SignalProxy1< void,const Glib::Error& > Gnome::Conf::Client::signal_error </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
A signal emitted when an error occurs.
<p>
This signal will be emitted when an error occurs, right before the throw() of the error.<p>
<dl class="user" compact><dt><b>Prototype:</b></dt><dd><code>void on_my_error(const <a class="el" href="classGlib_1_1Error.html">Glib::Error</a>& error)</code> </dd></dl>
</div>
</div><p>
<a class="anchor" name="3100a84531a915318ce83fde4706ac91"></a><!-- doxytag: member="Gnome::Conf::Client::error" ref="3100a84531a915318ce83fde4706ac91" args="(const Glib::Error &error)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Conf::Client::error </td>
<td>(</td>
<td class="paramtype">const Glib::Error & </td>
<td class="paramname"> <em>error</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="5b7c2ecbd06e5db0b892f07885047a83"></a><!-- doxytag: member="Gnome::Conf::Client::on_value_changed" ref="5b7c2ecbd06e5db0b892f07885047a83" args="(const Glib::ustring &key, const Value &value)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void Gnome::Conf::Client::on_value_changed </td>
<td>(</td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGnome_1_1Conf_1_1Value.html">Value</a> & </td>
<td class="paramname"> <em>value</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="5d08ed907b817c2f37ed26d7d49bf8d3"></a><!-- doxytag: member="Gnome::Conf::Client::on_unreturned_error" ref="5d08ed907b817c2f37ed26d7d49bf8d3" args="(const Glib::Error &error)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void Gnome::Conf::Client::on_unreturned_error </td>
<td>(</td>
<td class="paramtype">const Glib::Error & </td>
<td class="paramname"> <em>error</em> </td>
<td> ) </td>
<td width="100%"><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="79f42d1932b6ba088e7092f5ec0da15b"></a><!-- doxytag: member="Gnome::Conf::Client::on_error" ref="79f42d1932b6ba088e7092f5ec0da15b" args="(const Glib::Error &error)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void Gnome::Conf::Client::on_error </td>
<td>(</td>
<td class="paramtype">const Glib::Error & </td>
<td class="paramname"> <em>error</em> </td>
<td> ) </td>
<td width="100%"><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<hr><h2>Friends And Related Function Documentation</h2>
<a class="anchor" name="bf27c17240058ebb5f26cdc872af043e"></a><!-- doxytag: member="Gnome::Conf::Client::wrap" ref="bf27c17240058ebb5f26cdc872af043e" args="(GConfClient *object, bool take_copy=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Glib::RefPtr< <a class="el" href="classGnome_1_1Conf_1_1Client.html">Gnome::Conf::Client</a> > wrap </td>
<td>(</td>
<td class="paramtype">GConfClient * </td>
<td class="paramname"> <em>object</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>take_copy</em> = <code>false</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [related]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
A Glib::wrap() method for this object.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>object</em> </td><td>The C instance. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>take_copy</em> </td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
</div>
</div><p>
<hr>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="client_8h-source.html">client.h</a></ul>
</div>
<hr size="1"><address style="text-align: right;"><small>Generated on Sun Mar 9 14:41:20 2008 for gconfmm by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.5 </small></address>
</body>
</html>
distrib
>
Mandriva
>
2008.1
>
x86_64
>
media
>
main-release
>
by-pkgid
>
00f412dee87984fe9c31cb95c8f6e15c
>
files
>
16
