src/lib/elm_panes.c

   1 #include <Elementary.h>
   2 #include "elm_priv.h"
   3
   4 /**
   5  * @defgroup Panes panes
   6  * @ingroup Elementary
   7  *
   8  */
   9
  10 typedef struct _Widget_Data Widget_Data;
  11
  12 struct _Widget_Data
  13 {
  14    Evas_Object *panes;
  15
  16    struct
  17      {
  18         Evas_Object *left;
  19         Evas_Object *right;
  20      } contents;
  21
  22    struct
  23      {
  24         int x_diff;
  25         int y_diff;
  26         Eina_Bool move;
  27      } move;
  28
  29    Eina_Bool clicked_double;
  30    Eina_Bool horizontal;
  31    Eina_Bool fixed;
  32 };
  33
  34 static const char *widtype = NULL;
  35 static void _del_hook(Evas_Object *obj);
  36 static void _theme_hook(Evas_Object *obj);
  37 static void _sizing_eval(Evas_Object *obj);
  38 static void _changed_size_hints(void *data, Evas *e, Evas_Object *obj, void *event_info);
  39
  40 static void
  41 _del_hook(Evas_Object *obj)
  42 {
  43    Widget_Data *wd = elm_widget_data_get(obj);
  44    if (!wd) return;
  45    free(wd);
  46 }
  47
  48 static void
  49 _theme_hook(Evas_Object *obj)
  50 {
  51    Widget_Data *wd = elm_widget_data_get(obj);
  52    const char *style = elm_widget_style_get(obj);
  53    double size;
  54
  55    if (!wd) return;
  56    size = elm_panes_content_left_size_get(obj);
  57
  58    if (wd->horizontal)
  59      _elm_theme_object_set(obj, wd->panes, "panes", "horizontal", style);
  60    else
  61      _elm_theme_object_set(obj, wd->panes, "panes", "vertical", style);
  62
  63    if (wd->contents.left)
  64      edje_object_part_swallow(wd->panes, "elm.swallow.left", wd->contents.left);
  65    if (wd->contents.right)
  66      edje_object_part_swallow(wd->panes, "elm.swallow.right", wd->contents.right);
  67
  68    edje_object_scale_set(wd->panes, elm_widget_scale_get(obj) *
  69                          _elm_config->scale);
  70    _sizing_eval(obj);
  71    elm_panes_content_left_size_set(obj, size);
  72 }
  73
  74 static void
  75 _sizing_eval(Evas_Object *obj)
  76 {
  77    Widget_Data *wd = elm_widget_data_get(obj);
  78    if (!wd) return;
  79 }
  80
  81 static void
  82 _changed_size_hints(void *data, Evas *e __UNUSED__, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
  83 {
  84    _sizing_eval(data);
  85 }
  86
  87 static void
  88 _sub_del(void *data __UNUSED__, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
  89 {
  90    Widget_Data *wd = elm_widget_data_get(obj);
  91    Evas_Object *sub = event_info;
  92
  93    if (!wd) return;
  94    if (sub == wd->contents.left)
  95      {
  96         evas_object_event_callback_del_full(sub, EVAS_CALLBACK_CHANGED_SIZE_HINTS,
  97                                             _changed_size_hints, obj);
  98         wd->contents.left = NULL;
  99         _sizing_eval(obj);
 100      }
 101    else if (sub == wd->contents.right)
 102      {
 103         evas_object_event_callback_del_full(sub, EVAS_CALLBACK_CHANGED_SIZE_HINTS,
 104                                             _changed_size_hints, obj);
 105         wd->contents.right= NULL;
 106         _sizing_eval(obj);
 107      }
 108 }
 109
 110 static void
 111 _clicked(void *data, Evas_Object *obj __UNUSED__ , const char *emission __UNUSED__, const char *source __UNUSED__)
 112 {
 113    evas_object_smart_callback_call(data, "clicked", NULL);
 114 }
 115
 116 static void
 117 _clicked_double(void *data, Evas_Object *obj __UNUSED__ , const char *emission __UNUSED__, const char *source __UNUSED__)
 118 {
 119    Widget_Data *wd = elm_widget_data_get(data);
 120
 121    wd->clicked_double = EINA_TRUE;
 122 }
 123
 124 static void
 125 _press(void *data, Evas_Object *obj __UNUSED__ , const char *emission __UNUSED__, const char *source __UNUSED__)
 126 {
 127    evas_object_smart_callback_call(data, "press", NULL);
 128 }
 129
 130 static void
 131 _unpress(void *data, Evas_Object *obj __UNUSED__ , const char *emission __UNUSED__, const char *source __UNUSED__)
 132 {
 133    Widget_Data *wd = elm_widget_data_get(data);
 134    evas_object_smart_callback_call(data, "unpress", NULL);
 135
 136    if (wd->clicked_double)
 137      {
 138         evas_object_smart_callback_call(data, "clicked,double", NULL);
 139         wd->clicked_double = EINA_FALSE;
 140      }
 141 }
 142
 143 /**
 144  * Add a new panes to the parent
 145  *
 146  * @param[in] parent The parent object
 147  * @return The new object or NULL if it cannot be created
 148  *
 149  * @ingroup Panes
 150  */
 151 EAPI Evas_Object *
 152 elm_panes_add(Evas_Object *parent)
 153 {
 154    Evas_Object *obj;
 155    Evas *e;
 156    Widget_Data *wd;
 157
 158    wd = ELM_NEW(Widget_Data);
 159    e = evas_object_evas_get(parent);
 160    obj = elm_widget_add(e);
 161    ELM_SET_WIDTYPE(widtype, "panes");
 162    elm_widget_type_set(obj, widtype);
 163    elm_widget_can_focus_set(obj, EINA_FALSE);
 164    elm_widget_sub_object_add(parent, obj);
 165    elm_widget_data_set(obj, wd);
 166    elm_widget_del_hook_set(obj, _del_hook);
 167    elm_widget_theme_hook_set(obj, _theme_hook);
 168    wd->contents.left = NULL;
 169    wd->contents.right = NULL;
 170
 171    wd->panes = edje_object_add(e);
 172    _elm_theme_object_set(obj, wd->panes, "panes", "vertical", "default");
 173    elm_widget_resize_object_set(obj, wd->panes);
 174    evas_object_show(wd->panes);
 175
 176    elm_panes_content_left_size_set(obj, 0.5);
 177
 178    edje_object_signal_callback_add(wd->panes, "elm,action,click", "",
 179                                    _clicked, obj);
 180    edje_object_signal_callback_add(wd->panes, "elm,action,click,double", "",
 181                                    _clicked_double, obj);
 182    edje_object_signal_callback_add(wd->panes, "elm,action,press", "",
 183                                    _press, obj);
 184    edje_object_signal_callback_add(wd->panes, "elm,action,unpress", "",
 185                                    _unpress, obj);
 186
 187    evas_object_smart_callback_add(obj, "sub-object-del", _sub_del, obj);
 188    evas_object_event_callback_add(obj, EVAS_CALLBACK_CHANGED_SIZE_HINTS,
 189                                   _changed_size_hints, obj);
 190
 191    _sizing_eval(obj);
 192    return obj;
 193 }
 194
 195 /**
 196  * Set the left/top content of the panes widget
 197  *
 198  * Once the content object is set, a previously set one will be deleted.
 199  * If you want to keep that old content object, use the
 200  * elm_panes_content_left_unset() function.
 201  *
 202  * @param[in] obj The panes object
 203  * @param[in] content The new left/top content object
 204  *
 205  * @ingroup Panes
 206  */
 207 EAPI void
 208 elm_panes_content_left_set(Evas_Object *obj, Evas_Object *content)
 209 {
 210    ELM_CHECK_WIDTYPE(obj, widtype);
 211    Widget_Data *wd = elm_widget_data_get(obj);
 212    if (wd->contents.left)
 213      {
 214         evas_object_del(wd->contents.left);
 215         wd->contents.left = NULL;
 216      }
 217    if (content)
 218      {
 219         elm_widget_sub_object_add(obj, content);
 220         wd->contents.left = content;
 221         edje_object_part_swallow(wd->panes, "elm.swallow.left", content);
 222         if (wd->contents.right)
 223            edje_object_signal_emit(wd->panes, "panes_pair", "elm");
 224      }
 225    else
 226       edje_object_signal_emit(wd->panes, "panes_unpair", "elm");
 227 }
 228
 229 /**
 230  * Set the right/bottom content of the panes widget
 231  *
 232  * Once the content object is set, a previously set one will be deleted.
 233  * If you want to keep that old content object, use the
 234  * elm_panes_content_right_unset() function.
 235  *
 236  * @param[in] obj The panes object
 237  * @param[in] content The new right/bottom content object
 238  *
 239  * @ingroup Panes
 240  */
 241 EAPI void
 242 elm_panes_content_right_set(Evas_Object *obj, Evas_Object *content)
 243 {
 244    ELM_CHECK_WIDTYPE(obj, widtype);
 245    Widget_Data *wd = elm_widget_data_get(obj);
 246    if (wd->contents.right)
 247      {
 248         evas_object_del(wd->contents.right);
 249         wd->contents.right = NULL;
 250      }
 251    if (content)
 252      {
 253         elm_widget_sub_object_add(obj, content);
 254         wd->contents.right = content;
 255         edje_object_part_swallow(wd->panes, "elm.swallow.right", content);
 256         if (wd->contents.left)
 257           edje_object_signal_emit(wd->panes, "panes_pair", "elm");
 258      }
 259    else
 260       edje_object_signal_emit(wd->panes, "panes_unpair", "elm");
 261 }
 262
 263 /**
 264  * Get the left/top content used for the panes
 265  *
 266  * Return the left/top content object which is set for this widget.
 267  *
 268  * @param[in] obj The pane object
 269  * @return The left/top content object that is being used
 270  *
 271  * @ingroup Panes
 272  */
 273 EAPI Evas_Object *
 274 elm_panes_content_left_get(const Evas_Object *obj)
 275 {
 276    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
 277    Widget_Data *wd = elm_widget_data_get(obj);
 278    return wd->contents.left;
 279 }
 280
 281 /**
 282  * Get the right/bottom content used for the panes
 283  *
 284  * Return the right/bottom content object which is set for this widget.
 285  *
 286  * @param[in] obj The pane object
 287  * @return The Evas Object set as a right/bottom content of the pane
 288  *
 289  * @ingroup Panes
 290  */
 291 EAPI Evas_Object *
 292 elm_panes_content_right_get(const Evas_Object *obj)
 293 {
 294    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
 295    Widget_Data *wd = elm_widget_data_get(obj);
 296    return wd->contents.right;
 297 }
 298
 299 /**
 300  * Unset the left/top content used for the panes
 301  *
 302  * Unparent and return the left content object which was set for this widget.
 303  *
 304  * @param[in] obj The panes object
 305  * @return The left/top content object that was being used
 306  *
 307  * @ingroup Panes
 308  */
 309 EAPI Evas_Object *
 310 elm_panes_content_left_unset(Evas_Object *obj)
 311 {
 312    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
 313    Widget_Data *wd = NULL;
 314    Evas_Object *content = NULL;
 315
 316    wd = elm_widget_data_get(obj);
 317
 318    content = edje_object_part_swallow_get(wd->panes, "elm.swallow.left");
 319    if (!content)
 320      return NULL;
 321    edje_object_part_unswallow(wd->panes, content);
 322    elm_widget_sub_object_del(obj, content);
 323    evas_object_hide(content);
 324    wd->contents.left = NULL;
 325    edje_object_signal_emit(wd->panes, "panes_unpair", "elm");
 326    return content;
 327 }
 328
 329 /**
 330  * Unset the right/bottom content used for the panes
 331  *
 332  * Unparent and return the right content object which was set for this widget.
 333  *
 334  * @param[in] obj The panes object
 335   * @return The right/bottom content object that was being used
 336  *
 337  * @ingroup Panes
 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 = NULL;
 344    Evas_Object *content = NULL;
 345
 346    wd = elm_widget_data_get(obj);
 347
 348    content = edje_object_part_swallow_get(wd->panes, "elm.swallow.right");
 349    if (!content)
 350      return NULL;
 351    edje_object_part_unswallow(wd->panes, content);
 352    elm_widget_sub_object_del(obj, content);
 353    evas_object_hide(content);
 354    wd->contents.right = NULL;
 355    edje_object_signal_emit(wd->panes, "panes_unpair", "elm");
 356    return content;
 357 }
 358
 359 /**
 360  * Get the relative normalized size of left/top content of the pane
 361  *
 362  * @param[in] obj The panes object
 363  * @return The value of type double in the range [0.0,1.0]
 364  *
 365  * @ingroup Panes
 366  */
 367 EAPI double
 368 elm_panes_content_left_size_get(const Evas_Object *obj)
 369 {
 370    ELM_CHECK_WIDTYPE(obj, widtype) 0.0;
 371    Widget_Data *wd = elm_widget_data_get(obj);
 372    double w, h;
 373
 374    edje_object_part_drag_value_get(wd->panes, "elm.bar", &w, &h);
 375    if (wd->horizontal) return h;
 376    else return w;
 377 }
 378
 379 /**
 380  * Set a size of the left/top content with a relative normalized double value
 381  *
 382  * @param[in] obj The panes object
 383  * @param[in] size The value of type double in the range [0.0,1.0]
 384  *
 385  * @ingroup Panes
 386  */
 387 EAPI void
 388 elm_panes_content_left_size_set(Evas_Object *obj, double size)
 389 {
 390    ELM_CHECK_WIDTYPE(obj, widtype);
 391    Widget_Data *wd = elm_widget_data_get(obj);
 392
 393    if (size < 0.0) size = 0.0;
 394    else if (size > 1.0) size = 1.0;
 395    if (wd->horizontal)
 396      edje_object_part_drag_value_set(wd->panes, "elm.bar", 0.0, size);
 397    else
 398      edje_object_part_drag_value_set(wd->panes, "elm.bar", size, 0.0);
 399 }
 400
 401 /**
 402  * Set the type of an existing panes object to horizontal/vertical
 403  *
 404  * By default the panes is of vertical type
 405  *
 406  * @param[in] obj The panes object
 407  * @param[in] horizontal Boolean value. If true, then the type is set to horizontal else vertical
 408  *
 409  * @ingroup Panes
 410  */
 411 EAPI void
 412 elm_panes_horizontal_set(Evas_Object *obj, Eina_Bool horizontal)
 413 {
 414    ELM_CHECK_WIDTYPE(obj, widtype);
 415    Widget_Data *wd = elm_widget_data_get(obj);
 416
 417    wd->horizontal = horizontal;
 418    _theme_hook(obj);
 419    elm_panes_content_left_size_set(obj, 0.5);
 420 }
 421
 422 /**
 423  * Indicate if the type of pane object is horizontal or not
 424  *
 425  * @param[in] obj The panes object
 426  * @return true if it is of horizontal type else false
 427  *
 428  * @ingroup Panes
 429  */
 430 EAPI Eina_Bool
 431 elm_panes_horizontal_get(const Evas_Object *obj)
 432 {
 433    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
 434    Widget_Data *wd = elm_widget_data_get(obj);
 435    return wd->horizontal;
 436 }
 437
 438 /**
 439  * Set a handler of the pane object non-movable or movable
 440  *
 441  * @param[in] obj The panes object
 442  * @param[in] fixed If set to true then the views size can't be changed using handler otherwise using handler they can be resized
 443  *
 444  * @ingroup Panes
 445  */
 446 EAPI void
 447 elm_panes_fixed_set(Evas_Object *obj, Eina_Bool fixed)
 448 {
 449    ELM_CHECK_WIDTYPE(obj, widtype);
 450    Widget_Data *wd = elm_widget_data_get(obj);
 451    wd->fixed = fixed;
 452    if (wd->fixed == EINA_TRUE)
 453      edje_object_signal_emit(wd->panes, "elm.fixed", "movement.decider");
 454    else
 455      edje_object_signal_emit(wd->panes, "elm.unfixed", "movement.decider");
 456 }
 457
 458 /**
 459  * Indicate if the handler of the panes object can be moved with user interaction
 460  *
 461  * @param[in] obj The panes object
 462  * @return false if the views can be resized using handler else true
 463  *
 464  * @ingroup Panes
 465  */
 466 EAPI Eina_Bool
 467 elm_panes_fixed_get(const Evas_Object *obj)
 468 {
 469    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
 470    Widget_Data *wd = elm_widget_data_get(obj);
 471    return wd->fixed;
 472 }