[panes] delete docs
[framework/uifw/elementary.git] / src / lib / elm_panes.c
1 #include <Elementary.h>
2 #include "elm_priv.h"
3
4 /**
5  * TODO
6  * Update the minimun height of the bar in the theme.
7  * No minimun should be set in the vertical theme
8  * Add events (move, start ...)
9  */
10
11 typedef struct _Widget_Data Widget_Data;
12
13 struct _Widget_Data
14 {
15    Evas_Object *panes;
16
17    struct
18      {
19         Evas_Object *left;
20         Evas_Object *right;
21      } contents;
22
23    struct
24      {
25         int x_diff;
26         int y_diff;
27         Eina_Bool move;
28      } move;
29
30    Eina_Bool clicked_double;
31    Eina_Bool horizontal;
32    Eina_Bool fixed;
33 };
34
35 static const char *widtype = NULL;
36 static void _del_hook(Evas_Object *obj);
37 static void _mirrored_set(Evas_Object *obj, Eina_Bool rtl);
38 static void _theme_hook(Evas_Object *obj);
39 static void _sizing_eval(Evas_Object *obj);
40 static void _changed_size_hints(void *data, Evas *e, Evas_Object *obj, void *event_info);
41
42 static const char SIG_CLICKED[] = "clicked";
43 static const char SIG_PRESS[] = "press";
44 static const char SIG_UNPRESS[] = "unpress";
45 static const char SIG_CLICKED_DOUBLE[] = "clicked,double";
46
47 static const Evas_Smart_Cb_Description _signals[] = {
48    {SIG_CLICKED, ""},
49    {SIG_PRESS, ""},
50    {SIG_UNPRESS, ""},
51    {SIG_CLICKED_DOUBLE, ""},
52    {NULL, NULL}
53 };
54
55 static void
56 _del_hook(Evas_Object *obj)
57 {
58    Widget_Data *wd = elm_widget_data_get(obj);
59    if (!wd) return;
60    free(wd);
61 }
62
63 static void
64 _mirrored_set(Evas_Object *obj, Eina_Bool rtl)
65 {
66    Widget_Data *wd = elm_widget_data_get(obj);
67    if (!wd) return;
68    edje_object_mirrored_set(wd->panes, rtl);
69 }
70
71 static void
72 _theme_hook(Evas_Object *obj)
73 {
74    Widget_Data *wd = elm_widget_data_get(obj);
75    const char *style = elm_widget_style_get(obj);
76    double size;
77
78    if (!wd) return;
79    _elm_widget_mirrored_reload(obj);
80    _mirrored_set(obj, elm_widget_mirrored_get(obj));
81    size = elm_panes_content_left_size_get(obj);
82
83    if (wd->horizontal)
84      _elm_theme_object_set(obj, wd->panes, "panes", "horizontal", style);
85    else
86      _elm_theme_object_set(obj, wd->panes, "panes", "vertical", style);
87
88    if (wd->contents.left)
89      edje_object_part_swallow(wd->panes, "elm.swallow.left", wd->contents.left);
90    if (wd->contents.right)
91      edje_object_part_swallow(wd->panes, "elm.swallow.right", wd->contents.right);
92    if(wd->contents.left && wd->contents.right)
93      edje_object_signal_emit(wd->panes, "elm.panes.pair", "elm");
94    if(wd->fixed)
95      edje_object_signal_emit(wd->panes, "elm.panes.fixed", "elm");
96
97    edje_object_scale_set(wd->panes, elm_widget_scale_get(obj) *
98                          _elm_config->scale);
99    _sizing_eval(obj);
100    elm_panes_content_left_size_set(obj, size);
101 }
102
103 static Eina_Bool
104 _elm_panes_focus_next_hook(const Evas_Object *obj, Elm_Focus_Direction dir, Evas_Object **next)
105 {
106    Widget_Data *wd = elm_widget_data_get(obj);
107
108    if (!wd)
109      return EINA_FALSE;
110
111    double w, h;
112    edje_object_part_drag_value_get(wd->panes, "elm.bar", &w, &h);
113    if (((wd->horizontal) && ( h == 0.0 )) || ((!wd->horizontal) && ( w == 0.0 )))
114      return elm_widget_focus_next_get(wd->contents.right, dir, next);
115
116    Evas_Object *chain[2];
117
118    /* Direction */
119    if (dir == ELM_FOCUS_PREVIOUS)
120      {
121         chain[0] = wd->contents.right;
122         chain[1] = wd->contents.left;
123      }
124    else if (dir == ELM_FOCUS_NEXT)
125      {
126         chain[0] = wd->contents.left;
127         chain[1] = wd->contents.right;
128      }
129    else
130      return EINA_FALSE;
131
132    unsigned char i = elm_widget_focus_get(chain[1]);
133
134    if (elm_widget_focus_next_get(chain[i], dir, next))
135      return EINA_TRUE;
136
137    i = !i;
138
139    Evas_Object *to_focus;
140    if (elm_widget_focus_next_get(chain[i], dir, &to_focus))
141      {
142         *next = to_focus;
143         return !!i;
144      }
145
146    return EINA_FALSE;
147 }
148
149 static void
150 _sizing_eval(Evas_Object *obj)
151 {
152    Widget_Data *wd = elm_widget_data_get(obj);
153    if (!wd) return;
154 }
155
156 static void
157 _changed_size_hints(void *data, Evas *e __UNUSED__, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
158 {
159    _sizing_eval(data);
160 }
161
162 static void
163 _sub_del(void *data __UNUSED__, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
164 {
165    Widget_Data *wd = elm_widget_data_get(obj);
166    Evas_Object *sub = event_info;
167
168    if (!wd) return;
169    if (sub == wd->contents.left)
170      {
171         evas_object_event_callback_del_full(sub, EVAS_CALLBACK_CHANGED_SIZE_HINTS,
172                                             _changed_size_hints, obj);
173         wd->contents.left = NULL;
174         _sizing_eval(obj);
175      }
176    else if (sub == wd->contents.right)
177      {
178         evas_object_event_callback_del_full(sub, EVAS_CALLBACK_CHANGED_SIZE_HINTS,
179                                             _changed_size_hints, obj);
180         wd->contents.right= NULL;
181         _sizing_eval(obj);
182      }
183 }
184
185 static void
186 _clicked(void *data, Evas_Object *obj __UNUSED__ , const char *emission __UNUSED__, const char *source __UNUSED__)
187 {
188    evas_object_smart_callback_call(data, SIG_CLICKED, NULL);
189 }
190
191 static void
192 _clicked_double(void *data, Evas_Object *obj __UNUSED__ , const char *emission __UNUSED__, const char *source __UNUSED__)
193 {
194    Widget_Data *wd = elm_widget_data_get(data);
195
196    wd->clicked_double = EINA_TRUE;
197 }
198
199 static void
200 _press(void *data, Evas_Object *obj __UNUSED__ , const char *emission __UNUSED__, const char *source __UNUSED__)
201 {
202    evas_object_smart_callback_call(data, SIG_PRESS, NULL);
203 }
204
205 static void
206 _unpress(void *data, Evas_Object *obj __UNUSED__ , const char *emission __UNUSED__, const char *source __UNUSED__)
207 {
208    Widget_Data *wd = elm_widget_data_get(data);
209    evas_object_smart_callback_call(data, SIG_UNPRESS, NULL);
210
211    if (wd->clicked_double)
212      {
213         evas_object_smart_callback_call(data, SIG_CLICKED_DOUBLE, NULL);
214         wd->clicked_double = EINA_FALSE;
215      }
216 }
217
218 EAPI Evas_Object *
219 elm_panes_add(Evas_Object *parent)
220 {
221    Evas_Object *obj;
222    Evas *e;
223    Widget_Data *wd;
224
225    ELM_WIDGET_STANDARD_SETUP(wd, Widget_Data, parent, e, obj, NULL);
226
227    ELM_SET_WIDTYPE(widtype, "panes");
228    elm_widget_type_set(obj, "panes");
229    elm_widget_can_focus_set(obj, EINA_FALSE);
230    elm_widget_sub_object_add(parent, obj);
231    elm_widget_data_set(obj, wd);
232    elm_widget_del_hook_set(obj, _del_hook);
233    elm_widget_theme_hook_set(obj, _theme_hook);
234    elm_widget_focus_next_hook_set(obj, _elm_panes_focus_next_hook);
235
236    wd->panes = edje_object_add(e);
237    _elm_theme_object_set(obj, wd->panes, "panes", "vertical", "default");
238    elm_widget_resize_object_set(obj, wd->panes);
239    evas_object_show(wd->panes);
240
241    elm_panes_content_left_size_set(obj, 0.5);
242
243    edje_object_signal_callback_add(wd->panes, "elm,action,click", "",
244                                    _clicked, obj);
245    edje_object_signal_callback_add(wd->panes, "elm,action,click,double", "",
246                                    _clicked_double, obj);
247    edje_object_signal_callback_add(wd->panes, "elm,action,press", "",
248                                    _press, obj);
249    edje_object_signal_callback_add(wd->panes, "elm,action,unpress", "",
250                                    _unpress, obj);
251
252    evas_object_smart_callback_add(obj, "sub-object-del", _sub_del, obj);
253    evas_object_event_callback_add(obj, EVAS_CALLBACK_CHANGED_SIZE_HINTS,
254                                   _changed_size_hints, obj);
255
256    evas_object_smart_callbacks_descriptions_set(obj, _signals);
257
258    _mirrored_set(obj, elm_widget_mirrored_get(obj));
259    _sizing_eval(obj);
260    return obj;
261 }
262
263 EAPI void
264 elm_panes_content_left_set(Evas_Object *obj, Evas_Object *content)
265 {
266    ELM_CHECK_WIDTYPE(obj, widtype);
267    Widget_Data *wd = elm_widget_data_get(obj);
268    if (wd->contents.left)
269      {
270         evas_object_del(wd->contents.left);
271         wd->contents.left = NULL;
272      }
273    if (content)
274      {
275         wd->contents.left = content;
276         elm_widget_sub_object_add(obj, content);
277         edje_object_part_swallow(wd->panes, "elm.swallow.left", content);
278         if (wd->contents.right)
279           edje_object_signal_emit(wd->panes, "elm.panes.pair", "elm");
280      }
281    else
282       edje_object_signal_emit(wd->panes, "elm.panes.unpair", "elm");
283 }
284
285 EAPI void
286 elm_panes_content_right_set(Evas_Object *obj, Evas_Object *content)
287 {
288    ELM_CHECK_WIDTYPE(obj, widtype);
289    Widget_Data *wd = elm_widget_data_get(obj);
290    if (wd->contents.right)
291      {
292         evas_object_del(wd->contents.right);
293         wd->contents.right = NULL;
294      }
295    if (content)
296      {
297         wd->contents.right = content;
298         elm_widget_sub_object_add(obj, content);
299         edje_object_part_swallow(wd->panes, "elm.swallow.right", content);
300         if (wd->contents.left)
301           edje_object_signal_emit(wd->panes, "elm.panes.pair", "elm");
302      }
303    else
304      edje_object_signal_emit(wd->panes, "elm.panes.unpair", "elm");
305 }
306
307 EAPI Evas_Object *
308 elm_panes_content_left_get(const Evas_Object *obj)
309 {
310    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
311    Widget_Data *wd = elm_widget_data_get(obj);
312    return wd->contents.left;
313 }
314
315 EAPI Evas_Object *
316 elm_panes_content_right_get(const Evas_Object *obj)
317 {
318    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
319    Widget_Data *wd = elm_widget_data_get(obj);
320    return wd->contents.right;
321 }
322
323 EAPI Evas_Object *
324 elm_panes_content_left_unset(Evas_Object *obj)
325 {
326    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
327    Widget_Data *wd = elm_widget_data_get(obj);
328    if (!wd) return NULL;
329    if (!wd->contents.left) return NULL;
330    Evas_Object *content = wd->contents.left;
331    elm_widget_sub_object_del(obj, content);
332    edje_object_part_unswallow(wd->panes, content);
333    evas_object_hide(content);
334    wd->contents.left = NULL;
335    edje_object_signal_emit(wd->panes, "elm.panes.unpair", "elm");
336    return content;
337 }
338
339 EAPI Evas_Object *
340 elm_panes_content_right_unset(Evas_Object *obj)
341 {
342    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
343    Widget_Data *wd = elm_widget_data_get(obj);
344    if (!wd) return NULL;
345    if (!wd->contents.right) return NULL;
346    Evas_Object *content = wd->contents.right;
347    elm_widget_sub_object_del(obj, content);
348    edje_object_part_unswallow(wd->panes, content);
349    evas_object_hide(content);
350    wd->contents.right = NULL;
351    edje_object_signal_emit(wd->panes, "elm.panes.unpair", "elm");
352    return content;
353 }
354
355 EAPI double
356 elm_panes_content_left_size_get(const Evas_Object *obj)
357 {
358    ELM_CHECK_WIDTYPE(obj, widtype) 0.0;
359    Widget_Data *wd = elm_widget_data_get(obj);
360    double w, h;
361
362    edje_object_part_drag_value_get(wd->panes, "elm.bar", &w, &h);
363    if (wd->horizontal) return h;
364    else return w;
365 }
366
367 EAPI void
368 elm_panes_content_left_size_set(Evas_Object *obj, double size)
369 {
370    ELM_CHECK_WIDTYPE(obj, widtype);
371    Widget_Data *wd = elm_widget_data_get(obj);
372
373    if (size < 0.0) size = 0.0;
374    else if (size > 1.0) size = 1.0;
375    if (wd->horizontal)
376      edje_object_part_drag_value_set(wd->panes, "elm.bar", 0.0, size);
377    else
378      edje_object_part_drag_value_set(wd->panes, "elm.bar", size, 0.0);
379 }
380
381 EAPI void
382 elm_panes_horizontal_set(Evas_Object *obj, Eina_Bool horizontal)
383 {
384    ELM_CHECK_WIDTYPE(obj, widtype);
385    Widget_Data *wd = elm_widget_data_get(obj);
386
387    wd->horizontal = horizontal;
388    _theme_hook(obj);
389    elm_panes_content_left_size_set(obj, 0.5);
390 }
391
392 EAPI Eina_Bool
393 elm_panes_horizontal_get(const Evas_Object *obj)
394 {
395    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
396    Widget_Data *wd = elm_widget_data_get(obj);
397    return wd->horizontal;
398 }
399
400 EAPI void
401 elm_panes_fixed_set(Evas_Object *obj, Eina_Bool fixed)
402 {
403    ELM_CHECK_WIDTYPE(obj, widtype);
404    Widget_Data *wd = elm_widget_data_get(obj);
405    wd->fixed = fixed;
406    if (wd->fixed == EINA_TRUE)
407      edje_object_signal_emit(wd->panes, "elm.panes.fixed", "elm");
408    else
409      edje_object_signal_emit(wd->panes, "elm.panes.unfixed", "elm");
410 }
411
412 EAPI Eina_Bool
413 elm_panes_fixed_get(const Evas_Object *obj)
414 {
415    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
416    Widget_Data *wd = elm_widget_data_get(obj);
417    return wd->fixed;
418 }