fomatting of headers -> fixup. and documentation fixing.
[framework/uifw/elementary.git] / src / lib / elm_mirroring.h
1 /**
2  * @defgroup UI-Mirroring Selective Widget mirroring
3  *
4  * These functions allow you to set ui-mirroring on specific
5  * widgets or the whole interface. Widgets can be in one of two
6  * modes, automatic and manual.  Automatic means they'll be changed
7  * according to the system mirroring mode and manual means only
8  * explicit changes will matter. You are not supposed to change
9  * mirroring state of a widget set to automatic, will mostly work,
10  * but the behavior is not really defined.
11  *
12  * @{
13  */
14
15 EAPI Eina_Bool elm_mirrored_get(void);
16 EAPI void      elm_mirrored_set(Eina_Bool mirrored);
17
18 /**
19  * Get the system mirrored mode. This determines the default mirrored mode
20  * of widgets.
21  *
22  * @return EINA_TRUE if mirrored is set, EINA_FALSE otherwise
23  */
24 EAPI Eina_Bool
25                elm_object_mirrored_get(const Evas_Object *obj)
26 EINA_ARG_NONNULL(1);
27
28 /**
29  * Set the system mirrored mode. This determines the default mirrored mode
30  * of widgets.
31  *
32  * @param mirrored EINA_TRUE to set mirrored mode, EINA_FALSE to unset it.
33  */
34 EAPI void      elm_object_mirrored_set(Evas_Object *obj, Eina_Bool mirrored) EINA_ARG_NONNULL(1);
35
36 /**
37  * Returns the widget's mirrored mode setting.
38  *
39  * @param obj The widget.
40  * @return mirrored mode setting of the object.
41  *
42  **/
43 EAPI Eina_Bool elm_object_mirrored_automatic_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
44
45 /**
46  * Sets the widget's mirrored mode setting.
47  * When widget in automatic mode, it follows the system mirrored mode set by
48  * elm_mirrored_set().
49  * @param obj The widget.
50  * @param automatic EINA_TRUE for auto mirrored mode. EINA_FALSE for manual.
51  */
52 EAPI void      elm_object_mirrored_automatic_set(Evas_Object *obj, Eina_Bool automatic) EINA_ARG_NONNULL(1);
53
54 /**
55  * @}
56  */