Release 0.36.14
[vala-gnome.git] / vapi / gconf-2.0.vapi
blob6179c06bfeeb6bb6f27fe5ded27fd6be3dda3825
1 /* gconf-2.0.vapi generated by vapigen, do not modify. */
3 [Version (replacement = "GLib.Settings")]
4 namespace GConf {
5         [CCode (cheader_filename = "gconf/gconf.h", ref_function = "gconf_change_set_ref", ref_function_void = true, type_id = "gconf_change_set_get_type ()", unref_function = "gconf_change_set_unref")]
6         [Compact]
7         public class ChangeSet {
8                 [CCode (has_construct_function = false)]
9                 public ChangeSet ();
10                 public bool check_value (string key, out unowned GConf.Value value_retloc);
11                 public void clear ();
12                 public void @foreach (GConf.ChangeSetForeachFunc func);
13                 public void* get_user_data ();
14                 public void remove (string key);
15                 public void @set (string key, GConf.Value value);
16                 public void set_bool (string key, bool val);
17                 public void set_float (string key, double val);
18                 public void set_int (string key, int val);
19                 public void set_list (string key, GConf.ValueType list_type, GLib.SList list);
20                 public void set_nocopy (string key, GConf.Value value);
21                 public void set_pair (string key, GConf.ValueType car_type, GConf.ValueType cdr_type, void* address_of_car, void* address_of_cdr);
22                 public void set_schema (string key, GConf.Schema val);
23                 public void set_string (string key, string val);
24                 public void set_user_data (void* data, GLib.DestroyNotify dnotify);
25                 public uint size ();
26                 public void unset (string key);
27         }
28         [CCode (cheader_filename = "gconf/gconf-client.h")]
29         public class Client : GLib.Object {
30                 public weak GLib.HashTable cache_dirs;
31                 public weak GLib.HashTable cache_hash;
32                 public weak GLib.HashTable dir_hash;
33                 public weak GConf.Engine engine;
34                 public GConf.ClientErrorHandlingMode error_mode;
35                 public weak GConf.Listeners listeners;
36                 public uint notify_handler;
37                 public weak GLib.SList notify_list;
38                 public int pad2;
39                 public int pending_notify_count;
40                 [CCode (has_construct_function = false)]
41                 protected Client ();
42                 public void add_dir (string dir, GConf.ClientPreloadType preload) throws GLib.Error;
43                 public GLib.SList<string> all_dirs (string dir) throws GLib.Error;
44                 public GLib.SList<GConf.Entry> all_entries (string dir) throws GLib.Error;
45                 public unowned GConf.ChangeSet change_set_from_current (...) throws GLib.Error;
46                 public unowned GConf.ChangeSet change_set_from_currentv (string keys) throws GLib.Error;
47                 public void clear_cache ();
48                 public bool commit_change_set (GConf.ChangeSet cs, bool remove_committed) throws GLib.Error;
49                 public bool dir_exists (string dir) throws GLib.Error;
50                 public GConf.Value? @get (string key) throws GLib.Error;
51                 public bool get_bool (string key) throws GLib.Error;
52                 public static unowned GConf.Client get_default ();
53                 public GConf.Value? get_default_from_schema (string key) throws GLib.Error;
54                 public GConf.Entry get_entry (string key, string? locale, bool use_schema_default) throws GLib.Error;
55                 public double get_float (string key) throws GLib.Error;
56                 public static unowned GConf.Client get_for_engine (GConf.Engine engine);
57                 public int get_int (string key) throws GLib.Error;
58                 public GLib.SList get_list (string key, GConf.ValueType list_type) throws GLib.Error;
59                 public bool get_pair (string key, GConf.ValueType car_type, GConf.ValueType cdr_type, void* car_retloc, void* cdr_retloc) throws GLib.Error;
60                 public GConf.Schema? get_schema (string key) throws GLib.Error;
61                 public string? get_string (string key) throws GLib.Error;
62                 public GConf.Value? get_without_default (string key) throws GLib.Error;
63                 public bool key_is_writable (string key) throws GLib.Error;
64                 public void notify (string key);
65                 public uint notify_add (string namespace_section, owned GConf.ClientNotifyFunc func) throws GLib.Error;
66                 public void notify_remove (uint cnxn);
67                 public void preload (string dirname, GConf.ClientPreloadType type) throws GLib.Error;
68                 public bool recursive_unset (string key, GConf.UnsetFlags flags) throws GLib.Error;
69                 public void remove_dir (string dir) throws GLib.Error;
70                 public unowned GConf.ChangeSet reverse_change_set (GConf.ChangeSet cs) throws GLib.Error;
71                 public void @set (string key, GConf.Value val) throws GLib.Error;
72                 public bool set_bool (string key, bool val) throws GLib.Error;
73                 public void set_error_handling (GConf.ClientErrorHandlingMode mode);
74                 public bool set_float (string key, double val) throws GLib.Error;
75                 public static void set_global_default_error_handler (GConf.ClientErrorHandlerFunc func);
76                 public bool set_int (string key, int val) throws GLib.Error;
77                 public bool set_list (string key, GConf.ValueType list_type, GLib.SList list) throws GLib.Error;
78                 public bool set_pair (string key, GConf.ValueType car_type, GConf.ValueType cdr_type, void* address_of_car, void* address_of_cdr) throws GLib.Error;
79                 public bool set_schema (string key, GConf.Schema val) throws GLib.Error;
80                 public bool set_string (string key, string val) throws GLib.Error;
81                 public void suggest_sync () throws GLib.Error;
82                 public bool unset (string key) throws GLib.Error;
83                 [HasEmitter]
84                 public virtual signal void error (void* error);
85                 [HasEmitter]
86                 public virtual signal void unreturned_error (void* error);
87                 [HasEmitter]
88                 public virtual signal void value_changed (string key, void* value);
89         }
90         [CCode (cheader_filename = "gconf/gconf.h", ref_function = "gconf_engine_ref", ref_function_void = true, unref_function = "gconf_engine_unref")]
91         [Compact]
92         public class Engine {
93                 public GLib.SList<string> all_dirs (string dir) throws GLib.Error;
94                 public GLib.SList<GConf.Entry> all_entries (string dir) throws GLib.Error;
95                 public bool associate_schema (string key, string schema_key) throws GLib.Error;
96                 public unowned GConf.ChangeSet change_set_from_current (...) throws GLib.Error;
97                 public unowned GConf.ChangeSet change_set_from_currentv (string keys) throws GLib.Error;
98                 public bool commit_change_set (GConf.ChangeSet cs, bool remove_committed) throws GLib.Error;
99                 public bool dir_exists (string dir) throws GLib.Error;
100                 public unowned GConf.Value @get (string key) throws GLib.Error;
101                 public bool get_bool (string key) throws GLib.Error;
102                 public static unowned GConf.Engine get_default ();
103                 public unowned GConf.Value get_default_from_schema (string key) throws GLib.Error;
104                 public unowned GConf.Entry get_entry (string key, string locale, bool use_schema_default) throws GLib.Error;
105                 public double get_float (string key) throws GLib.Error;
106                 public static unowned GConf.Engine get_for_address (string address) throws GLib.Error;
107                 public static unowned GConf.Engine get_for_addresses (GLib.SList<string> addresses) throws GLib.Error;
108                 public int get_int (string key) throws GLib.Error;
109                 public GLib.SList get_list (string key, GConf.ValueType list_type) throws GLib.Error;
110                 public bool get_pair (string key, GConf.ValueType car_type, GConf.ValueType cdr_type, void* car_retloc, void* cdr_retloc) throws GLib.Error;
111                 public unowned GConf.Schema get_schema (string key) throws GLib.Error;
112                 public unowned string get_string (string key) throws GLib.Error;
113                 public void* get_user_data ();
114                 public unowned GConf.Value get_with_locale (string key, string locale) throws GLib.Error;
115                 public unowned GConf.Value get_without_default (string key) throws GLib.Error;
116                 public bool key_is_writable (string key) throws GLib.Error;
117                 public uint notify_add (string namespace_section, GConf.NotifyFunc func) throws GLib.Error;
118                 public void notify_remove (uint cnxn);
119                 public void remove_dir (string dir) throws GLib.Error;
120                 public unowned GConf.ChangeSet reverse_change_set (GConf.ChangeSet cs) throws GLib.Error;
121                 public bool @set (string key, GConf.Value value) throws GLib.Error;
122                 public bool set_bool (string key, bool val) throws GLib.Error;
123                 public bool set_float (string key, double val) throws GLib.Error;
124                 public bool set_int (string key, int val) throws GLib.Error;
125                 public bool set_list (string key, GConf.ValueType list_type, GLib.SList list) throws GLib.Error;
126                 public bool set_pair (string key, GConf.ValueType car_type, GConf.ValueType cdr_type, void* address_of_car, void* address_of_cdr) throws GLib.Error;
127                 public bool set_schema (string key, GConf.Schema val) throws GLib.Error;
128                 public bool set_string (string key, string val) throws GLib.Error;
129                 public void set_user_data (void* data, GLib.DestroyNotify dnotify);
130                 public void suggest_sync () throws GLib.Error;
131                 public bool unset (string key) throws GLib.Error;
132         }
133         [CCode (cheader_filename = "gconf/gconf.h", ref_function = "gconf_entry_ref", ref_function_void = true, unref_function = "gconf_entry_unref")]
134         [Compact]
135         public class Entry {
136                 public weak string key;
137                 public weak GConf.Value value;
138                 [CCode (has_construct_function = false)]
139                 public Entry (string key, GConf.Value val);
140                 public GConf.Entry copy ();
141                 public bool equal (GConf.Entry b);
142                 public bool get_is_default ();
143                 public bool get_is_writable ();
144                 public unowned string get_key ();
145                 public unowned string get_schema_name ();
146                 public unowned GConf.Value get_value ();
147                 [CCode (has_construct_function = false)]
148                 public Entry.nocopy (string key, GConf.Value val);
149                 public void set_is_default (bool is_default);
150                 public void set_is_writable (bool is_writable);
151                 public void set_schema_name (string name);
152                 public void set_value (GConf.Value val);
153                 public void set_value_nocopy (GConf.Value val);
154                 public unowned GConf.Value steal_value ();
155         }
156         [CCode (cheader_filename = "gconf/gconf.h")]
157         [Compact]
158         public class EnumStringPair {
159                 public int enum_value;
160                 public weak string str;
161         }
162         [CCode (cheader_filename = "gconf/gconf.h")]
163         [Compact]
164         public class Listeners {
165                 [CCode (has_construct_function = false)]
166                 public Listeners ();
167                 public uint add (string listen_point, void* listener_data, GLib.FreeFunc destroy_notify);
168                 public uint count ();
169                 public void @foreach (GConf.ListenersForeach callback);
170                 public bool get_data (uint cnxn_id, void* listener_data_p, string location_p);
171                 public void notify (string all_above, GConf.ListenersCallback callback);
172                 public void remove (uint cnxn_id);
173                 public void remove_if (GConf.ListenersPredicate predicate);
174         }
175         [CCode (cheader_filename = "gconf/gconf.h")]
176         [Compact]
177         public class MetaInfo {
178                 public GLib.Time mod_time;
179                 public weak string mod_user;
180                 public weak string schema;
181                 [CCode (has_construct_function = false)]
182                 public MetaInfo ();
183                 [CCode (cname = "gconf_meta_info_mod_time")]
184                 public GLib.Time get_mod_time ();
185                 public unowned string get_mod_user ();
186                 public unowned string get_schema ();
187                 public void set_mod_time (GLib.Time mod_time);
188                 public void set_mod_user (string mod_user);
189                 public void set_schema (string schema_name);
190         }
191         [CCode (cheader_filename = "gconf/gconf.h", copy_function = "gconf_schema_copy")]
192         [Compact]
193         public class Schema {
194                 [CCode (has_construct_function = false)]
195                 public Schema ();
196                 public GConf.Schema copy ();
197                 public GConf.ValueType get_car_type ();
198                 public GConf.ValueType get_cdr_type ();
199                 public unowned GConf.Value get_default_value ();
200                 public GConf.ValueType get_list_type ();
201                 public unowned string get_locale ();
202                 public unowned string get_long_desc ();
203                 public unowned string get_owner ();
204                 public unowned string get_short_desc ();
205                 public void set_car_type (GConf.ValueType type);
206                 public void set_cdr_type (GConf.ValueType type);
207                 public void set_default_value (GConf.Value val);
208                 public void set_default_value_nocopy (GConf.Value val);
209                 public void set_list_type (GConf.ValueType type);
210                 public void set_locale (string locale);
211                 public void set_long_desc (string desc);
212                 public void set_owner (string owner);
213                 public void set_short_desc (string desc);
214                 public void set_type (GConf.ValueType type);
215         }
216         [CCode (cheader_filename = "gconf/gconf.h", copy_function = "gconf_value_copy")]
217         [Compact]
218         public class Value {
219                 public GConf.ValueType type;
220                 [CCode (has_construct_function = false)]
221                 public Value (GConf.ValueType type);
222                 public int compare (GConf.Value value_b);
223                 public GConf.Value copy ();
224                 public static unowned GConf.Value decode (string encoded);
225                 public unowned string encode ();
226                 [CCode (has_construct_function = false)]
227                 public Value.from_string (GConf.ValueType type, string str) throws GLib.Error;
228                 public bool get_bool ();
229                 public unowned GConf.Value get_car ();
230                 public unowned GConf.Value get_cdr ();
231                 public double get_float ();
232                 public int get_int ();
233                 public unowned GLib.SList<GConf.Value> get_list ();
234                 public GConf.ValueType get_list_type ();
235                 public unowned GConf.Schema get_schema ();
236                 public unowned string get_string ();
237                 public void set_bool (bool the_bool);
238                 public void set_car (GConf.Value car);
239                 public void set_car_nocopy (GConf.Value car);
240                 public void set_cdr (GConf.Value cdr);
241                 public void set_cdr_nocopy (GConf.Value cdr);
242                 public void set_float (double the_float);
243                 public void set_int (int the_int);
244                 public void set_list (GLib.SList<GConf.Value> list);
245                 public void set_list_nocopy (owned GLib.SList<GConf.Value> list);
246                 public void set_list_type (GConf.ValueType type);
247                 public void set_schema (GConf.Schema sc);
248                 public void set_schema_nocopy (GConf.Schema sc);
249                 public void set_string (string the_str);
250                 public unowned string to_string ();
251         }
252         [CCode (cheader_filename = "gconf/gconf.h", cprefix = "GCONF_CLIENT_HANDLE_")]
253         public enum ClientErrorHandlingMode {
254                 NONE,
255                 UNRETURNED,
256                 ALL
257         }
258         [CCode (cheader_filename = "gconf/gconf.h", cprefix = "GCONF_CLIENT_PRELOAD_")]
259         public enum ClientPreloadType {
260                 NONE,
261                 ONELEVEL,
262                 RECURSIVE
263         }
264         [CCode (cheader_filename = "gconf/gconf.h", cprefix = "GCONF_ERROR_")]
265         public enum Error {
266                 SUCCESS,
267                 FAILED,
268                 NO_SERVER,
269                 NO_PERMISSION,
270                 BAD_ADDRESS,
271                 BAD_KEY,
272                 PARSE_ERROR,
273                 CORRUPT,
274                 TYPE_MISMATCH,
275                 IS_DIR,
276                 IS_KEY,
277                 OVERRIDDEN,
278                 OAF_ERROR,
279                 LOCAL_ENGINE,
280                 LOCK_FAILED,
281                 NO_WRITABLE_DATABASE,
282                 IN_SHUTDOWN
283         }
284         [CCode (cheader_filename = "gconf/gconf.h", cprefix = "GCONF_UNSET_INCLUDING_SCHEMA_")]
285         [Flags]
286         public enum UnsetFlags {
287                 NAMES
288         }
289         [CCode (cheader_filename = "gconf/gconf.h", cprefix = "GCONF_VALUE_")]
290         public enum ValueType {
291                 INVALID,
292                 STRING,
293                 INT,
294                 FLOAT,
295                 BOOL,
296                 SCHEMA,
297                 LIST,
298                 PAIR
299         }
300         [CCode (cheader_filename = "gconf/gconf.h")]
301         public delegate void ChangeSetForeachFunc (GConf.ChangeSet cs, string key, GConf.Value value);
302         [CCode (cheader_filename = "gconf/gconf.h", has_target = false)]
303         public delegate void ClientErrorHandlerFunc (GConf.Client client, GLib.Error error);
304         [CCode (cheader_filename = "gconf/gconf.h")]
305         public delegate void ClientNotifyFunc (GConf.Client client, uint cnxn_id, GConf.Entry entry);
306         [CCode (cheader_filename = "gconf/gconf.h")]
307         public delegate void ListenersCallback (GConf.Listeners listeners, string all_above_key, uint cnxn_id, void* listener_data);
308         [CCode (cheader_filename = "gconf/gconf.h")]
309         public delegate void ListenersForeach (string location, uint cnxn_id, void* listener_data);
310         [CCode (cheader_filename = "gconf/gconf.h")]
311         public delegate bool ListenersPredicate (string location, uint cnxn_id, void* listener_data);
312         [CCode (cheader_filename = "gconf/gconf.h")]
313         public delegate void NotifyFunc (GConf.Engine conf, uint cnxn_id, GConf.Entry entry);
314         [CCode (cheader_filename = "gconf/gconf.h")]
315         public static unowned string concat_dir_and_key (string dir, string key);
316         [CCode (cheader_filename = "gconf/gconf.h")]
317         public static int debug_shutdown ();
318         [CCode (cheader_filename = "gconf/gconf.h")]
319         public static unowned string enum_to_string (GConf.EnumStringPair[] lookup_table, int enum_value);
320         [CCode (cheader_filename = "gconf/gconf.h")]
321         public static GLib.Quark error_quark ();
322         [CCode (cheader_filename = "gconf/gconf.h")]
323         public static unowned string escape_key (string arbitrary_text, int len);
324         [CCode (cheader_filename = "gconf/gconf.h")]
325         public static bool is_initialized ();
326         [CCode (cheader_filename = "gconf/gconf.h")]
327         public static bool key_is_below (string above, string below);
328         [CCode (cheader_filename = "gconf/gconf.h")]
329         public static bool string_to_enum (GConf.EnumStringPair[] lookup_table, string str, int enum_value_retloc);
330         [CCode (cheader_filename = "gconf/gconf.h")]
331         public static unowned string unescape_key (string escaped_key, int len);
332         [CCode (cheader_filename = "gconf/gconf.h")]
333         public static unowned string unique_key ();
334         [CCode (cheader_filename = "gconf/gconf.h")]
335         public static bool valid_key (string key, string why_invalid);