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