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