1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
|
/**
* @ingroup Elm_Prefs
*
* @{
*/
/**
* Add a page widget to an elm_prefs object.
*/
EAPI Eina_Bool elm_prefs_page_widget_common_add(Evas_Object *prefs, Evas_Object *obj);
/**
*
* Set file and page to populate a given prefs widget's interface.
*
* @return @c EINA_TRUE, on success, @c EINA_FALSE otherwise
*
* Elm prefs widgets start blank, with no child widgets. It's meant to
* have its viewport populated with child elements coming from a
* declaration file. That file (usually with @b .epb extension), is a
* binary format (Eet) one, coming from a human-readable textual
* declaration. This textual form (usually with @b .epc extension) is
* translated to the binary form by means of the @b prefs_cc compiler.
*
* With this function, one thus populates a prefs widget with UI
* elements.
*
* If @a file is @c NULL, "elm_app_data_dir_get()/preferences.epb"
* will be used, by default. If @a file is a @b relative path, the
* prefix "elm_app_data_dir_get()/" will be implicitly used with it.
* If @a page is @c NULL, it is considered "main", as default.
*
* @warning If your binary is not properly installed and
* elm_app_data_dir_get() can't be figured out, a fallback value of
* "." will be tryed, instead.
*
* @see elm_prefs_file_get()
*
* @since 1.8
*
* @param[in] file The @b .epb (binary) file to get contents from
* @param[in] page The page, inside @a file, where to get item contents from
*/
EAPI Eina_Bool elm_prefs_file_set(Eo *obj, const char *file, const char *page);
/**
*
* Get file and page bound to a given prefs widget.
*
* @return @c EINA_TRUE, on success, @c EINA_FALSE otherwise
*
* @note Use @c NULL pointers on the components you're not
* interested in: they'll be ignored by the function.
*
* @see elm_prefs_file_set() for more information
*
* @since 1.8
*
* @param[out] file The @b .epb (binary) file to get contents from
* @param[out] page The page, inside @a file, where to get item contents from
*/
EAPI Eina_Bool elm_prefs_file_get(const Eo *obj, const char **file, const char **page);
#include "elm_prefs_eo.legacy.h"
/**
* @}
*/
|
