src/lib/elc_ctxpopup.c

   1 #include <Elementary.h>
   2 #include "elm_priv.h"
   3
   4 /**
   5  * @defgroup Ctxpopup
   6  *
   7  * A ctxpopup is a widget that, when shown, pops up a list of items.
   8  * It automatically chooses an area inside its parent object's view
   9  * (set via elm_ctxpopup_add() and elm_ctxpopup_hover_parent_set()) to
  10  * optimally fit into it. In the default theme, it will also point an
  11  * arrow to the cursor position at the time one shows it. Ctxpopup
  12  * items have a label and/or an icon. It is intended for a small
  13  * number of items (hence the use of list, not genlist).
  14  *
  15  * Signals that you can add callbacks for are:
  16  *
  17  * "dismissed" - the ctxpopup was dismissed
  18  */
  19
  20 typedef struct _Widget_Data Widget_Data;
  21
  22 struct _Elm_Ctxpopup_Item
  23 {
  24    Elm_Widget_Item base;
  25    const char *label;
  26    Evas_Object *icon;
  27    Evas_Smart_Cb func;
  28    Eina_Bool disabled:1;
  29 };
  30
  31 struct _Widget_Data
  32 {
  33    Evas_Object *parent;
  34    Evas_Object *base;
  35    Evas_Object *content;
  36    Evas_Object *box;
  37    Evas_Object *arrow;
  38    Evas_Object *scr;
  39    Evas_Object *bg;
  40    Evas_Object *hover_parent;
  41    Eina_List *items;
  42    Elm_Ctxpopup_Direction dir;
  43    Elm_Ctxpopup_Direction dir_priority[4];
  44    Evas_Coord max_sc_w, max_sc_h;
  45    Eina_Bool horizontal:1;
  46    Eina_Bool visible:1;
  47    Eina_Bool finished:1;
  48 };
  49
  50 static const char *widtype = NULL;
  51
  52 static void _freeze_on(void *data __UNUSED__, Evas_Object *obj,
  53                        void *event_info __UNUSED__);
  54 static void _freeze_off(void *data __UNUSED__, Evas_Object *obj,
  55                         void *event_info __UNUSED__);
  56 static void _hold_on(void *data __UNUSED__, Evas_Object *obj,
  57                      void *event_info __UNUSED__);
  58 static void _hold_off(void *data __UNUSED__, Evas_Object *obj,
  59                       void *event_info __UNUSED__);
  60 static void _scroller_size_reset(Widget_Data *wd);
  61 static void _hover_parent_callbacks_del(Evas_Object *obj);
  62 static void _hover_parent_resize(void *data, Evas *e __UNUSED__,
  63                                  Evas_Object *obj __UNUSED__,
  64                                  void *event_info __UNUSED__);
  65 static void _hover_parent_move(void *data, Evas *e __UNUSED__,
  66                                Evas_Object *obj __UNUSED__,
  67                                void *event_info __UNUSED__);
  68 static void _hover_parent_del(void *data, Evas *e __UNUSED__,
  69                               Evas_Object *obj __UNUSED__,
  70                               void *event_info __UNUSED__);
  71 static void _item_sizing_eval(Elm_Ctxpopup_Item *item);
  72 static void _adjust_pos_x(Evas_Coord_Point *pos, Evas_Coord_Point *base_size,
  73                           Evas_Coord_Rectangle *hover_area);
  74 static void _adjust_pos_y(Evas_Coord_Point *pos, Evas_Coord_Point *base_size,
  75                           Evas_Coord_Rectangle *hover_area);
  76 static void _ctxpopup_changed_size_hints(void *data __UNUSED__,
  77                                          Evas *e __UNUSED__, Evas_Object *obj,
  78                                          void *event_info __UNUSED__);
  79 static Elm_Ctxpopup_Direction _calc_base_geometry(Evas_Object *obj,
  80                                                   Evas_Coord_Rectangle *rect);
  81 static void _update_arrow(Evas_Object *obj, Elm_Ctxpopup_Direction dir);
  82 static void _sizing_eval(Evas_Object *obj);
  83 static void _shift_base_by_arrow(Evas_Object *arrow,
  84                                  Elm_Ctxpopup_Direction dir,
  85                                  Evas_Coord_Rectangle *rect);
  86 static void _del_pre_hook(Evas_Object *obj);
  87 static void _del_hook(Evas_Object *obj);
  88 static void _theme_hook(Evas_Object *obj);
  89 static void _bg_clicked_cb(void *data, Evas_Object *obj __UNUSED__,
  90                            const char *emission __UNUSED__,
  91                            const char *source __UNUSED__);
  92 static void _parent_resize(void *data, Evas *e, Evas_Object *obj,
  93                            void *event_info __UNUSED__);
  94 static void _ctxpopup_show(void *data __UNUSED__, Evas *e __UNUSED__,
  95                            Evas_Object *obj, void *event_info __UNUSED__);
  96 static void _hide(Evas_Object *obj);
  97 static void _ctxpopup_hide(void *data __UNUSED__, Evas *e __UNUSED__,
  98                            Evas_Object *obj, void *event_info __UNUSED__);
  99 static void _scroller_resize(void *data, Evas *e __UNUSED__, Evas_Object *obj,
 100                              void *event_info __UNUSED__);
 101 static void _ctxpopup_move(void *data __UNUSED__, Evas *e __UNUSED__,
 102                            Evas_Object *obj, void *event_info __UNUSED__);
 103 static void _item_select_cb(void *data, Evas_Object *obj __UNUSED__,
 104                             const char *emission __UNUSED__,
 105                             const char *source __UNUSED__);
 106 static void _item_icon_set(Elm_Ctxpopup_Item *item, Evas_Object *icon);
 107 static void _item_label_set(Elm_Ctxpopup_Item *item, const char *label);
 108 static void _item_new(Elm_Ctxpopup_Item *item, char *group_name);
 109 static void _content_del(void *data, Evas *e, Evas_Object *obj __UNUSED__,
 110                          void *event_info __UNUSED__);
 111 static void _list_del(Widget_Data *wd);
 112 static void _list_new(Evas_Object *obj);
 113 static void _remove_items(Widget_Data * wd);
 114
 115 static const char SIG_DISMISSED[] = "dismissed";
 116
 117 static const Evas_Smart_Cb_Description _signals[] = {
 118    {SIG_DISMISSED, ""},
 119    {NULL, NULL}
 120 };
 121
 122 #define ELM_CTXPOPUP_ITEM_CHECK_RETURN(it, ...)                        \
 123   ELM_WIDGET_ITEM_CHECK_OR_RETURN((Elm_Widget_Item *)it, __VA_ARGS__); \
 124   ELM_CHECK_WIDTYPE(item->base.widget, widtype) __VA_ARGS__;
 125
 126 static void
 127 _freeze_on(void *data __UNUSED__, Evas_Object *obj,
 128            void *event_info __UNUSED__)
 129 {
 130    Widget_Data *wd = elm_widget_data_get(obj);
 131
 132    if ((!wd) || (!wd->scr)) return;
 133    elm_object_scroll_freeze_push(wd->scr);
 134 }
 135
 136 static void
 137 _freeze_off(void *data __UNUSED__, Evas_Object *obj,
 138             void *event_info __UNUSED__)
 139 {
 140    Widget_Data *wd = elm_widget_data_get(obj);
 141
 142    if ((!wd) || (!wd->scr)) return;
 143    elm_object_scroll_freeze_pop(wd->scr);
 144 }
 145
 146 static void
 147 _hold_on(void *data __UNUSED__, Evas_Object *obj, void *event_info __UNUSED__)
 148 {
 149    Widget_Data *wd = elm_widget_data_get(obj);
 150
 151    if ((!wd) || (!wd->scr)) return;
 152    elm_object_scroll_hold_push(wd->scr);
 153 }
 154
 155 static void
 156 _hold_off(void *data __UNUSED__, Evas_Object *obj, void *event_info __UNUSED__)
 157 {
 158    Widget_Data *wd = elm_widget_data_get(obj);
 159
 160    if ((!wd) || (!wd->scr)) return;
 161    elm_object_scroll_hold_pop(wd->scr);
 162 }
 163
 164 static void
 165 _scroller_size_reset(Widget_Data *wd)
 166 {
 167    wd->finished = EINA_FALSE;
 168    wd->max_sc_h = -1;
 169    wd->max_sc_w = -1;
 170 }
 171
 172 static void
 173 _hover_parent_callbacks_del(Evas_Object *obj)
 174 {
 175    Widget_Data *wd = elm_widget_data_get(obj);
 176
 177    if ((!wd) || (!wd->hover_parent))
 178       return;
 179
 180    evas_object_event_callback_del_full(wd->hover_parent, EVAS_CALLBACK_DEL,
 181                                        _hover_parent_del, obj);
 182    evas_object_event_callback_del_full(wd->hover_parent, EVAS_CALLBACK_MOVE,
 183                                        _hover_parent_move, obj);
 184    evas_object_event_callback_del_full(wd->hover_parent, EVAS_CALLBACK_RESIZE,
 185                                        _hover_parent_resize, obj);
 186 }
 187
 188 static void
 189 _hover_parent_resize(void *data, Evas *e __UNUSED__,
 190                      Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
 191 {
 192    Widget_Data *wd = elm_widget_data_get(data);
 193
 194    if (!wd) return;
 195
 196    if (wd->visible)
 197      {
 198         _scroller_size_reset(wd);
 199         _sizing_eval(data);
 200      }
 201 }
 202
 203 static void
 204 _hover_parent_move(void *data, Evas *e __UNUSED__,
 205                    Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
 206 {
 207    Widget_Data *wd = elm_widget_data_get(data);
 208
 209    if (!wd) return;
 210
 211    if (wd->visible)
 212      {
 213         _scroller_size_reset(wd);
 214         _sizing_eval(obj);
 215      }
 216 }
 217
 218 static void
 219 _hover_parent_del(void *data, Evas *e __UNUSED__, Evas_Object *obj __UNUSED__,
 220                   void *event_info __UNUSED__)
 221 {
 222    Widget_Data *wd = elm_widget_data_get(data);
 223
 224    if (!wd) return;
 225
 226    wd->hover_parent = NULL;
 227 }
 228
 229 static void
 230 _item_sizing_eval(Elm_Ctxpopup_Item *item)
 231 {
 232    Evas_Coord min_w = -1, min_h = -1, max_w = -1, max_h = -1;
 233
 234    if (!item) return;
 235
 236    edje_object_size_min_restricted_calc(item->base.view, &min_w, &min_h, min_w,
 237                                         min_h);
 238    evas_object_size_hint_min_set(item->base.view, min_w, min_h);
 239    evas_object_size_hint_max_set(item->base.view, max_w, max_h);
 240 }
 241
 242 static void
 243 _adjust_pos_x(Evas_Coord_Point *pos, Evas_Coord_Point *base_size,
 244               Evas_Coord_Rectangle *hover_area)
 245 {
 246    pos->x -= (base_size->x / 2);
 247
 248    if (pos->x < hover_area->x)
 249       pos->x = hover_area->x;
 250    else if ((pos->x + base_size->x) > (hover_area->x + hover_area->w))
 251       pos->x = (hover_area->x + hover_area->w) - base_size->x;
 252
 253    if (base_size->x > hover_area->w)
 254       base_size->x -= (base_size->x - hover_area->w);
 255
 256    if (pos->x < hover_area->x)
 257       pos->x = hover_area->x;
 258 }
 259
 260 static void
 261 _adjust_pos_y(Evas_Coord_Point *pos, Evas_Coord_Point *base_size,
 262               Evas_Coord_Rectangle *hover_area)
 263 {
 264    pos->y -= (base_size->y / 2);
 265
 266    if (pos->y < hover_area->y)
 267       pos->y = hover_area->y;
 268    else if ((pos->y + base_size->y) > (hover_area->y + hover_area->h))
 269       pos->y = hover_area->y + hover_area->h - base_size->y;
 270
 271    if (base_size->y > hover_area->h)
 272       base_size->y -= (base_size->y - hover_area->h);
 273
 274    if (pos->y < hover_area->y)
 275       pos->y = hover_area->y;
 276 }
 277
 278 static void
 279 _ctxpopup_changed_size_hints(void *data __UNUSED__, Evas *e __UNUSED__,
 280                              Evas_Object *obj, void *event_info __UNUSED__)
 281 {
 282    Widget_Data *wd;
 283
 284    wd = elm_widget_data_get(obj);
 285    if (!wd) return;
 286
 287    if (wd->visible)
 288       _sizing_eval(obj);
 289 }
 290
 291 static Elm_Ctxpopup_Direction
 292 _calc_base_geometry(Evas_Object *obj, Evas_Coord_Rectangle *rect)
 293 {
 294    Widget_Data *wd;
 295    Evas_Coord_Point pos = {0, 0};
 296    Evas_Coord_Point base_size;
 297    Evas_Coord_Point max_size;
 298    Evas_Coord_Point min_size;
 299    Evas_Coord_Rectangle hover_area;
 300    Evas_Coord_Rectangle parent_size;
 301    Evas_Coord_Point arrow_size;
 302    Elm_Ctxpopup_Direction arrow = ELM_CTXPOPUP_DIRECTION_DOWN;
 303    Evas_Coord_Point temp;
 304    int idx;
 305
 306    wd = elm_widget_data_get(obj);
 307
 308    if ((!wd) || (!rect))
 309       return ELM_CTXPOPUP_DIRECTION_DOWN;
 310
 311    edje_object_part_geometry_get(wd->arrow, "ctxpopup_arrow", NULL, NULL,
 312                                  &arrow_size.x, &arrow_size.y);
 313    evas_object_resize(wd->arrow, arrow_size.x, arrow_size.y);
 314
 315    //Initialize Area Rectangle.
 316    if (wd->hover_parent)
 317       evas_object_geometry_get(wd->hover_parent, &hover_area.x, &hover_area.y,
 318                                &hover_area.w, &hover_area.h);
 319    else
 320      {
 321         evas_object_geometry_get(wd->parent, &parent_size.x, &parent_size.y,
 322                                  &parent_size.w, &parent_size.h);
 323         hover_area.x = parent_size.x;
 324         hover_area.y = parent_size.y;
 325         hover_area.w = parent_size.w;
 326         hover_area.h = parent_size.h;
 327      }
 328
 329    evas_object_geometry_get(obj, &pos.x, &pos.y, NULL, NULL);
 330
 331    //recalc the edje
 332    edje_object_size_min_calc(wd->base, &base_size.x, &base_size.y);
 333    evas_object_smart_calculate(wd->base);
 334
 335    //Limit to Max Size
 336    evas_object_size_hint_max_get(obj, &max_size.x, &max_size.y);
 337
 338    if ((max_size.y > 0) && (base_size.y > max_size.y))
 339       base_size.y = max_size.y;
 340
 341    if ((max_size.x > 0) && (base_size.x > max_size.x))
 342       base_size.x = max_size.x;
 343
 344    //Limit to Min Size
 345    evas_object_size_hint_min_get(obj, &min_size.x, &min_size.y);
 346
 347    if ((min_size.y > 0) && (base_size.y < min_size.y))
 348       base_size.y = min_size.y;
 349
 350    if ((min_size.x > 0) && (base_size.x < min_size.x))
 351       base_size.x = min_size.x;
 352
 353    //Check the Which direction is available.
 354    //If find a avaialble direction, it adjusts position and size.
 355    for (idx = 0; idx < 4; idx++)
 356      {
 357         switch (wd->dir_priority[idx])
 358           {
 359            case ELM_CTXPOPUP_DIRECTION_UP:
 360               temp.y = (pos.y - base_size.y);
 361               if ((temp.y - arrow_size.y) < hover_area.y)
 362                  continue;
 363               _adjust_pos_x(&pos, &base_size, &hover_area);
 364               pos.y -= base_size.y;
 365               arrow = ELM_CTXPOPUP_DIRECTION_DOWN;
 366               break;
 367            case ELM_CTXPOPUP_DIRECTION_LEFT:
 368               temp.x = (pos.x - base_size.x);
 369               if ((temp.x - arrow_size.x) < hover_area.x)
 370                  continue;
 371               _adjust_pos_y(&pos, &base_size, &hover_area);
 372               pos.x -= base_size.x;
 373               arrow = ELM_CTXPOPUP_DIRECTION_RIGHT;
 374               break;
 375            case ELM_CTXPOPUP_DIRECTION_RIGHT:
 376               temp.x = (pos.x + base_size.x);
 377               if ((temp.x + arrow_size.x) >
 378                   (hover_area.x + hover_area.w))
 379                  continue;
 380               _adjust_pos_y(&pos, &base_size, &hover_area);
 381               arrow = ELM_CTXPOPUP_DIRECTION_LEFT;
 382               break;
 383            case ELM_CTXPOPUP_DIRECTION_DOWN:
 384               temp.y = (pos.y + base_size.y);
 385               if ((temp.y + arrow_size.y) >
 386                   (hover_area.y + hover_area.h))
 387                  continue;
 388               _adjust_pos_x(&pos, &base_size, &hover_area);
 389               arrow = ELM_CTXPOPUP_DIRECTION_UP;
 390               break;
 391            default:
 392               break;
 393           }
 394         break;
 395      }
 396
 397    //In this case, all directions are invalid because of lack of space.
 398    if (idx == 4)
 399      {
 400         //TODO 1: Find the largest space direction.
 401         Evas_Coord length[2];
 402
 403         length[0] = pos.y - hover_area.y;
 404         length[1] = (hover_area.y + hover_area.h) - pos.y;
 405
 406         if (length[0] > length[1])
 407            idx = ELM_CTXPOPUP_DIRECTION_UP;
 408         else
 409            idx = ELM_CTXPOPUP_DIRECTION_DOWN;
 410
 411         //TODO 2: determine x , y
 412         switch (idx)
 413           {
 414            case ELM_CTXPOPUP_DIRECTION_UP:
 415               _adjust_pos_x(&pos, &base_size, &hover_area);
 416               pos.y -= base_size.y;
 417               arrow = ELM_CTXPOPUP_DIRECTION_DOWN;
 418               if (pos.y < hover_area.y + arrow_size.y)
 419                 {
 420                    base_size.y -= ((hover_area.y + arrow_size.y) - pos.y);
 421                    pos.y = hover_area.y + arrow_size.y;
 422                 }
 423               break;
 424            case ELM_CTXPOPUP_DIRECTION_LEFT:
 425               _adjust_pos_y(&pos, &base_size, &hover_area);
 426               pos.x -= base_size.x;
 427               arrow = ELM_CTXPOPUP_DIRECTION_RIGHT;
 428               if (pos.x < hover_area.x + arrow_size.x)
 429                 {
 430                    base_size.x -= ((hover_area.x + arrow_size.x) - pos.x);
 431                    pos.x = hover_area.x + arrow_size.x;
 432                 }
 433               break;
 434            case ELM_CTXPOPUP_DIRECTION_RIGHT:
 435               _adjust_pos_y(&pos, &base_size, &hover_area);
 436               arrow = ELM_CTXPOPUP_DIRECTION_LEFT;
 437               if (pos.x + arrow_size.x + base_size.x >
 438                   hover_area.x + hover_area.w)
 439                  base_size.x -=
 440                     ((pos.x + arrow_size.x + base_size.x) -
 441                      (hover_area.x + hover_area.w));
 442               break;
 443            case ELM_CTXPOPUP_DIRECTION_DOWN:
 444               _adjust_pos_x(&pos, &base_size, &hover_area);
 445               arrow = ELM_CTXPOPUP_DIRECTION_UP;
 446               if (pos.y + arrow_size.y + base_size.y >
 447                   hover_area.y + hover_area.h)
 448                  base_size.y -=
 449                     ((pos.y + arrow_size.y + base_size.y) -
 450                      (hover_area.y + hover_area.h));
 451               break;
 452            default:
 453               break;
 454           }
 455      }
 456
 457    //Final position and size.
 458    rect->x = pos.x;
 459    rect->y = pos.y;
 460    rect->w = base_size.x;
 461    rect->h = base_size.y;
 462
 463    return arrow;
 464 }
 465
 466 static void
 467 _update_arrow(Evas_Object *obj, Elm_Ctxpopup_Direction dir)
 468 {
 469    Evas_Coord x, y;
 470    Evas_Coord_Rectangle arrow_size;
 471    Evas_Coord_Rectangle base_size;
 472    Widget_Data *wd;
 473
 474    wd = elm_widget_data_get(obj);
 475    if (!wd) return;
 476
 477    evas_object_geometry_get(obj, &x, &y, NULL, NULL);
 478    evas_object_geometry_get(wd->arrow, NULL, NULL, &arrow_size.w,
 479                             &arrow_size.h);
 480    evas_object_geometry_get(wd->base, &base_size.x, &base_size.y,
 481                             &base_size.w, &base_size.h);
 482
 483    switch (dir)
 484      {
 485       case ELM_CTXPOPUP_DIRECTION_LEFT:
 486          edje_object_signal_emit(wd->arrow, "elm,state,left", "elm");
 487          edje_object_part_swallow(wd->base, "elm.swallow.arrow_left", wd->arrow);
 488          if (base_size.h > 0)
 489            {
 490               if (y < (arrow_size.h * 0.5) + base_size.y) y = 0;
 491               else if (y > base_size.y + base_size.h - (arrow_size.h * 0.5)) y = base_size.h - arrow_size.h;
 492               else y = y - base_size.y - (arrow_size.h * 0.5);
 493               edje_object_part_drag_value_set(wd->base, "elm.swallow.arrow_left", 0.5,
 494                                               (double) (y) / (double) (base_size.h - arrow_size.h));
 495           }
 496          break;
 497       case ELM_CTXPOPUP_DIRECTION_RIGHT:
 498          edje_object_signal_emit(wd->arrow, "elm,state,right", "elm");
 499          edje_object_part_swallow(wd->base, "elm.swallow.arrow_right", wd->arrow);
 500          if (base_size.h > 0)
 501             {
 502               if (y < (arrow_size.h * 0.5) + base_size.y) y = 0;
 503               else if (y > base_size.y + base_size.h - (arrow_size.h * 0.5)) y = base_size.h - arrow_size.h;
 504               else y = y - base_size.y - (arrow_size.h * 0.5);
 505               edje_object_part_drag_value_set(wd->base, "elm.swallow.arrow_right", 0.5,
 506                                               (double) (y) / (double) (base_size.h - arrow_size.h));
 507             }
 508          break;
 509       case ELM_CTXPOPUP_DIRECTION_UP:
 510          edje_object_signal_emit(wd->arrow, "elm,state,top", "elm");
 511          edje_object_part_swallow(wd->base, "elm.swallow.arrow_up", wd->arrow);
 512          if (base_size.w > 0)
 513            {
 514               if (x < (arrow_size.w * 0.5) + base_size.x) x = 0;
 515               else if (x > base_size.x + base_size.w - (arrow_size.w * 0.5)) x = base_size.w - arrow_size.w;
 516               else x = x - base_size.x - (arrow_size.w * 0.5);
 517               edje_object_part_drag_value_set(wd->base, "elm.swallow.arrow_up",
 518                                               (double) (x) / (double) (base_size.w - arrow_size.w), 0.5);
 519            }
 520          break;
 521       case ELM_CTXPOPUP_DIRECTION_DOWN:
 522          edje_object_signal_emit(wd->arrow, "elm,state,bottom", "elm");
 523          edje_object_part_swallow(wd->base, "elm.swallow.arrow_down", wd->arrow);
 524          if (base_size.w > 0)
 525            {
 526               if (x < (arrow_size.w * 0.5) + base_size.x) x = 0;
 527               else if (x > base_size.x + base_size.w - (arrow_size.w * 0.5)) x = base_size.w - arrow_size.w;
 528               else x = x - base_size.x - (arrow_size.w * 0.5);
 529               edje_object_part_drag_value_set(wd->base, "elm.swallow.arrow_down",
 530                                               (double) (x) / (double) (base_size.w - arrow_size.w), 0.5);
 531            }
 532          break;
 533       default:
 534          break;
 535      }
 536 }
 537
 538 static void
 539 _sizing_eval(Evas_Object *obj)
 540 {
 541    Widget_Data *wd;
 542    Eina_List *elist;
 543    Elm_Ctxpopup_Item *item;
 544    Evas_Coord_Rectangle rect = { 0, 0, 1, 1 };
 545    Evas_Coord_Point box_size = { 0, 0 };
 546    Evas_Coord_Point _box_size = { 0, 0 };
 547
 548    wd = elm_widget_data_get(obj);
 549    if ((!wd) || (!wd->parent)) return;
 550
 551    //Box, Scroller
 552    EINA_LIST_FOREACH(wd->items, elist, item)
 553      {
 554         _item_sizing_eval(item);
 555         evas_object_size_hint_min_get(item->base.view, &_box_size.x, &_box_size.y);
 556         if (!wd->horizontal)
 557           {
 558              if (_box_size.x > box_size.x)
 559                 box_size.x = _box_size.x;
 560              if (_box_size.y != -1)
 561                 box_size.y += _box_size.y;
 562           }
 563         else
 564           {
 565              if (_box_size.x != -1)
 566                 box_size.x += _box_size.x;
 567              if (_box_size.y > box_size.y)
 568                 box_size.y = _box_size.y;
 569           }
 570      }
 571
 572    if (!wd->content)
 573      {
 574         evas_object_size_hint_min_set(wd->box, box_size.x, box_size.y);
 575         evas_object_size_hint_min_set(wd->scr, box_size.x, box_size.y);
 576      }
 577
 578    //Base
 579    wd->dir = _calc_base_geometry(obj, &rect);
 580    _update_arrow(obj, wd->dir);
 581    _shift_base_by_arrow(wd->arrow, wd->dir, &rect);
 582
 583    //resize scroller according to final size.
 584    if (!wd->content)
 585       evas_object_smart_calculate(wd->scr);
 586
 587    evas_object_move(wd->base, rect.x, rect.y);
 588    evas_object_resize(wd->base, rect.w, rect.h);
 589 }
 590
 591 static void
 592 _shift_base_by_arrow(Evas_Object *arrow, Elm_Ctxpopup_Direction dir,
 593                      Evas_Coord_Rectangle *rect)
 594 {
 595    Evas_Coord arrow_w, arrow_h;
 596
 597    evas_object_geometry_get(arrow, NULL, NULL, &arrow_w, &arrow_h);
 598
 599    switch (dir)
 600      {
 601       case ELM_CTXPOPUP_DIRECTION_LEFT:
 602          rect->x += arrow_w;
 603          break;
 604       case ELM_CTXPOPUP_DIRECTION_RIGHT:
 605          rect->x -= arrow_w;
 606          break;
 607       case ELM_CTXPOPUP_DIRECTION_UP:
 608          rect->y += arrow_h;
 609          break;
 610       case ELM_CTXPOPUP_DIRECTION_DOWN:
 611          rect->y -= arrow_h;
 612          break;
 613       default:
 614          break;
 615      }
 616 }
 617
 618 static void
 619 _del_pre_hook(Evas_Object *obj)
 620 {
 621    Widget_Data *wd;
 622
 623    wd = elm_widget_data_get(obj);
 624    if (!wd) return;
 625
 626    evas_object_event_callback_del_full(wd->parent, EVAS_CALLBACK_RESIZE,
 627                                        _parent_resize, obj);
 628
 629    _hover_parent_callbacks_del(obj);
 630 }
 631
 632 static void
 633 _del_hook(Evas_Object *obj)
 634 {
 635    Widget_Data *wd;
 636
 637    wd = elm_widget_data_get(obj);
 638    if (!wd) return;
 639
 640    elm_ctxpopup_clear(obj);
 641    evas_object_del(wd->arrow);
 642    evas_object_del(wd->base);
 643    free(wd);
 644 }
 645
 646 static void
 647 _theme_hook(Evas_Object *obj)
 648 {
 649    Widget_Data *wd;
 650    Eina_List *elist;
 651    Elm_Ctxpopup_Item *item;
 652
 653    wd = elm_widget_data_get(obj);
 654    if (!wd) return;
 655
 656    //Items
 657    EINA_LIST_FOREACH(wd->items, elist, item)
 658      {
 659         if (item->label && item->icon)
 660            _elm_theme_object_set(obj, item->base.view, "ctxpopup",
 661                                  "icon_text_style_item",
 662                                  elm_widget_style_get(obj));
 663         else if (item->label)
 664            _elm_theme_object_set(obj, item->base.view, "ctxpopup", "text_style_item",
 665                                  elm_widget_style_get(obj));
 666         else if (item->icon)
 667            _elm_theme_object_set(obj, item->base.view, "ctxpopup", "icon_style_item",
 668                                  elm_widget_style_get(obj));
 669         if (item->label)
 670            edje_object_part_text_set(item->base.view, "elm.text", item->label);
 671
 672         if (item->disabled)
 673            edje_object_signal_emit(item->base.view, "elm,state,disabled", "elm");
 674
 675         edje_object_message_signal_process(item->base.view);
 676      }
 677
 678    _elm_theme_object_set(obj, wd->bg, "ctxpopup", "bg",
 679                          elm_widget_style_get(obj));
 680    _elm_theme_object_set(obj, wd->base, "ctxpopup", "base",
 681                          elm_widget_style_get(obj));
 682    _elm_theme_object_set(obj, wd->arrow, "ctxpopup", "arrow",
 683                          elm_widget_style_get(obj));
 684
 685    if (wd->scr)
 686      {
 687         if (!strncmp(elm_object_style_get(obj), "default",
 688                      strlen("default")))
 689            elm_object_style_set(wd->scr, "ctxpopup");
 690         else
 691            elm_object_style_set(wd->scr, elm_object_style_get(obj));
 692      }
 693
 694    if (wd->visible)
 695      {
 696         _scroller_size_reset(wd);
 697         _sizing_eval(obj);
 698      }
 699 }
 700
 701 static void
 702 _bg_clicked_cb(void *data, Evas_Object *obj __UNUSED__,
 703                const char *emission __UNUSED__, const char *source __UNUSED__)
 704 {
 705    evas_object_hide(data);
 706 }
 707
 708 static void
 709 _parent_resize(void *data, Evas *e __UNUSED__, Evas_Object *obj,
 710                void *event_info __UNUSED__)
 711 {
 712    Evas_Coord w, h;
 713    Widget_Data *wd;
 714
 715    wd = elm_widget_data_get(data);
 716    if (!wd) return;
 717
 718    evas_object_geometry_get(obj, NULL, NULL, &w, &h);
 719    evas_object_resize(wd->bg, w, h);
 720
 721    if (!wd->visible) return;
 722
 723    _hide(data);
 724 }
 725
 726 static void
 727 _ctxpopup_show(void *data __UNUSED__, Evas *e __UNUSED__, Evas_Object *obj,
 728                void *event_info __UNUSED__)
 729 {
 730    Widget_Data *wd;
 731
 732    wd = elm_widget_data_get(obj);
 733    if (!wd) return;
 734
 735    if ((!wd->items) && (!wd->content)) return;
 736
 737    wd->visible = EINA_TRUE;
 738
 739    evas_object_show(wd->bg);
 740    evas_object_show(wd->base);
 741    evas_object_show(wd->arrow);
 742
 743    edje_object_signal_emit(wd->bg, "elm,state,show", "elm");
 744
 745    _sizing_eval(obj);
 746 }
 747
 748 static void
 749 _hide(Evas_Object *obj)
 750 {
 751    Widget_Data *wd = elm_widget_data_get(obj);
 752
 753    if (!wd) return;
 754
 755    evas_object_hide(wd->bg);
 756    evas_object_hide(wd->arrow);
 757    evas_object_hide(wd->base);
 758
 759    _scroller_size_reset(wd);
 760
 761    evas_object_smart_callback_call(obj, SIG_DISMISSED, NULL);
 762    wd->visible = EINA_FALSE;
 763 }
 764
 765 static void
 766 _ctxpopup_hide(void *data __UNUSED__, Evas *e __UNUSED__, Evas_Object *obj,
 767                void *event_info __UNUSED__)
 768 {
 769    Widget_Data *wd;
 770
 771    wd = elm_widget_data_get(obj);
 772    if ((!wd) || (!wd->visible))
 773       return;
 774
 775    _hide(obj);
 776 }
 777
 778 static void
 779 _scroller_resize(void *data, Evas *e __UNUSED__, Evas_Object *obj,
 780                  void *event_info __UNUSED__)
 781 {
 782    Widget_Data *wd;
 783    Evas_Coord w, h;
 784
 785    wd = elm_widget_data_get(data);
 786    if (!wd) return;
 787    if (!wd->visible) return;
 788    if (wd->finished) return;
 789
 790    evas_object_geometry_get(obj, 0, 0, &w, &h);
 791
 792    if (w != 0 && h != 0)
 793      {
 794         if ((w <= wd->max_sc_w) && (h <= wd->max_sc_h))
 795           {
 796              _sizing_eval(data);
 797              wd->finished = EINA_TRUE;
 798              return;
 799           }
 800      }
 801
 802    if (wd->max_sc_w < w)
 803       wd->max_sc_w = w;
 804    if (wd->max_sc_h < h)
 805       wd->max_sc_h = h;
 806
 807    _sizing_eval(data);
 808 }
 809
 810 static void
 811 _ctxpopup_move(void *data __UNUSED__, Evas *e __UNUSED__, Evas_Object *obj,
 812                void *event_info __UNUSED__)
 813 {
 814    Widget_Data *wd;
 815
 816    wd = elm_widget_data_get(obj);
 817
 818    if (!wd) return;
 819
 820    if (wd->visible)
 821       evas_object_show(wd->arrow);
 822
 823    _scroller_size_reset(wd);
 824    _sizing_eval(obj);
 825 }
 826
 827 static void
 828 _item_select_cb(void *data, Evas_Object *obj __UNUSED__,
 829                 const char *emission __UNUSED__, const char *source __UNUSED__)
 830 {
 831    Elm_Ctxpopup_Item *item = data;
 832
 833    if (!item) return;
 834    if (item->disabled) return;
 835
 836    if (item->func)
 837       item->func((void*) item->base.data, item->base.widget, data);
 838 }
 839
 840 static void
 841 _item_icon_set(Elm_Ctxpopup_Item *item, Evas_Object *icon)
 842 {
 843    if (item->icon)
 844      evas_object_del(item->icon);
 845
 846    item->icon = icon;
 847    if (!icon) return;
 848
 849    edje_object_part_swallow(item->base.view, "elm.swallow.icon", item->icon);
 850    edje_object_message_signal_process(item->base.view);
 851 }
 852
 853 static void
 854 _item_label_set(Elm_Ctxpopup_Item *item, const char *label)
 855 {
 856    if (!eina_stringshare_replace(&item->label, label))
 857       return;
 858
 859    edje_object_part_text_set(item->base.view, "elm.text", label);
 860    edje_object_message_signal_process(item->base.view);
 861 }
 862
 863 static void
 864 _item_new(Elm_Ctxpopup_Item *item, char *group_name)
 865 {
 866    Widget_Data *wd;
 867
 868    wd = elm_widget_data_get(item->base.widget);
 869    if (!wd) return;
 870
 871    item->base.view = edje_object_add(evas_object_evas_get(wd->base));
 872    _elm_theme_object_set(item->base.widget, item->base.view, "ctxpopup", group_name,
 873                          elm_widget_style_get(item->base.widget));
 874    edje_object_signal_callback_add(item->base.view, "elm,action,click", "",
 875                                    _item_select_cb, item);
 876    evas_object_size_hint_align_set(item->base.view, EVAS_HINT_FILL, EVAS_HINT_FILL);
 877    evas_object_show(item->base.view);
 878 }
 879
 880 static void
 881 _content_del(void *data, Evas *e __UNUSED__, Evas_Object *obj __UNUSED__,
 882              void *event_info __UNUSED__)
 883 {
 884    elm_ctxpopup_content_unset(data);
 885 }
 886
 887 static void
 888 _list_del(Widget_Data *wd)
 889 {
 890    if (!wd->scr) return;
 891
 892    edje_object_part_unswallow(wd->base, wd->scr);
 893    evas_object_del(wd->scr);
 894    wd->scr = NULL;
 895    wd->box = NULL;
 896 }
 897
 898 static void
 899 _list_new(Evas_Object *obj)
 900 {
 901    Widget_Data *wd;
 902    wd = elm_widget_data_get(obj);
 903    if (!wd) return;
 904
 905    //scroller
 906    wd->scr = elm_scroller_add(obj);
 907    elm_object_style_set(wd->scr, "ctxpopup");
 908    evas_object_size_hint_align_set(wd->scr, EVAS_HINT_FILL, EVAS_HINT_FILL);
 909    evas_object_event_callback_add(wd->scr, EVAS_CALLBACK_RESIZE,
 910                                   _scroller_resize, obj);
 911    edje_object_part_swallow(wd->base, "elm.swallow.content", wd->scr);
 912
 913    //box
 914    wd->box = elm_box_add(obj);
 915    evas_object_size_hint_weight_set(wd->box, EVAS_HINT_EXPAND,
 916                                     EVAS_HINT_EXPAND);
 917
 918    elm_scroller_content_set(wd->scr, wd->box);
 919    elm_ctxpopup_horizontal_set(obj, wd->horizontal);
 920 }
 921
 922 static void
 923 _remove_items(Widget_Data *wd)
 924 {
 925    Eina_List *elist;
 926    Elm_Ctxpopup_Item *item;
 927
 928    if (!wd->items) return;
 929
 930    EINA_LIST_FOREACH(wd->items, elist, item)
 931      {
 932         if (item->label)
 933            eina_stringshare_del(item->label);
 934         if (item->icon)
 935            evas_object_del(item->icon);
 936         wd->items = eina_list_remove(wd->items, item);
 937         free(item);
 938      }
 939
 940    wd->items = NULL;
 941 }
 942
 943 /**
 944  * Add a new Ctxpopup object to the parent.
 945  *
 946  * @param parent Parent object
 947  * @return New object or @c NULL, if it cannot be created
 948  *
 949  * @ingroup Ctxpopup
 950  */
 951 EAPI Evas_Object *
 952 elm_ctxpopup_add(Evas_Object *parent)
 953 {
 954    Evas_Object *obj;
 955    Evas *e;
 956    Widget_Data *wd;
 957    Evas_Coord x, y, w, h;
 958
 959    ELM_WIDGET_STANDARD_SETUP(wd, Widget_Data, parent, e, obj, NULL);
 960
 961    ELM_SET_WIDTYPE(widtype, "ctxpopup");
 962    elm_widget_type_set(obj, "ctxpopup");
 963    elm_widget_sub_object_add(parent, obj);
 964    elm_widget_data_set(obj, wd);
 965    elm_widget_del_pre_hook_set(obj, _del_pre_hook);
 966    elm_widget_del_hook_set(obj, _del_hook);
 967    elm_widget_theme_hook_set(obj, _theme_hook);
 968
 969    wd->parent = parent;
 970
 971    //Background
 972    wd->bg = edje_object_add(e);
 973    elm_widget_sub_object_add(obj, wd->bg);
 974    _elm_theme_object_set(obj, wd->bg, "ctxpopup", "bg", "default");
 975    evas_object_geometry_get(parent, &x, &y, &w, &h);
 976    evas_object_move(wd->bg, x, y);
 977    evas_object_resize(wd->bg, w, h);
 978    edje_object_signal_callback_add(wd->bg, "elm,action,click", "",
 979                                    _bg_clicked_cb, obj);
 980
 981    //Base
 982    wd->base = edje_object_add(e);
 983    elm_widget_sub_object_add(obj, wd->base);
 984    _elm_theme_object_set(obj, wd->base, "ctxpopup", "base", "default");
 985
 986    //Arrow
 987    wd->arrow = edje_object_add(e);
 988    elm_widget_sub_object_add(obj, wd->arrow);
 989    _elm_theme_object_set(obj, wd->arrow, "ctxpopup", "arrow", "default");
 990
 991    wd->dir_priority[0] = ELM_CTXPOPUP_DIRECTION_UP;
 992    wd->dir_priority[1] = ELM_CTXPOPUP_DIRECTION_LEFT;
 993    wd->dir_priority[2] = ELM_CTXPOPUP_DIRECTION_RIGHT;
 994    wd->dir_priority[3] = ELM_CTXPOPUP_DIRECTION_DOWN;
 995
 996    evas_object_event_callback_add(parent, EVAS_CALLBACK_RESIZE, _parent_resize,
 997                                   obj);
 998    evas_object_event_callback_add(obj, EVAS_CALLBACK_SHOW, _ctxpopup_show,
 999                                   NULL);
1000    evas_object_event_callback_add(obj, EVAS_CALLBACK_HIDE, _ctxpopup_hide,
1001                                   NULL);
1002    evas_object_event_callback_add(obj, EVAS_CALLBACK_MOVE, _ctxpopup_move,
1003                                   NULL);
1004    evas_object_event_callback_add(obj, EVAS_CALLBACK_CHANGED_SIZE_HINTS,
1005                                   _ctxpopup_changed_size_hints, NULL);
1006    evas_object_smart_callback_add(obj, "scroll-freeze-on", _freeze_on, obj);
1007    evas_object_smart_callback_add(obj, "scroll-freeze-off", _freeze_off, obj);
1008    evas_object_smart_callback_add(obj, "scroll-hold-on", _hold_on, obj);
1009    evas_object_smart_callback_add(obj, "scroll-hold-off", _hold_off, obj);
1010
1011    evas_object_smart_callbacks_descriptions_set(obj, _signals);
1012
1013    return obj;
1014 }
1015
1016 /**
1017  * Get the icon object for the given ctxpopup item.
1018  *
1019  * @param item Ctxpopup item
1020  * @return icon object or @c NULL, if the item does not have icon or an error occurred
1021  *
1022  * @ingroup Ctxpopup
1023  */
1024 EAPI Evas_Object *
1025 elm_ctxpopup_item_icon_get(const Elm_Ctxpopup_Item *item)
1026 {
1027    ELM_CTXPOPUP_ITEM_CHECK_RETURN(item, NULL);
1028    return item->icon;
1029 }
1030
1031 /**
1032  * Sets the side icon associated with the ctxpopup item
1033  *
1034  * Once the icon object is set, a previously set one will be deleted.
1035  * You probably don't want, then, to have the <b>same</b> icon object
1036  * set for more than one item of the list (when replacing one of its
1037  * instances).
1038  *
1039  * @param item Ctxpopup item
1040  * @param icon Icon object to be set
1041  *
1042  * @ingroup Ctxpopup
1043  */
1044 EAPI void
1045 elm_ctxpopup_item_icon_set(Elm_Ctxpopup_Item *item, Evas_Object *icon)
1046 {
1047    ELM_CTXPOPUP_ITEM_CHECK_RETURN(item);
1048
1049    Widget_Data *wd;
1050
1051    wd = elm_widget_data_get(item->base.widget);
1052    if (!wd) return;
1053
1054    _item_icon_set(item, icon);
1055
1056    if (wd->visible)
1057      {
1058         _scroller_size_reset(wd);
1059         _sizing_eval(item->base.widget);
1060      }
1061 }
1062
1063 /**
1064  * Get the label object for the given ctxpopup item.
1065  *
1066  * @param item Ctxpopup item
1067  * @return label object or @c NULL, if the item does not have label or an error occured
1068  *
1069  * @ingroup Ctxpopup
1070  *
1071  */
1072 EAPI const char *
1073 elm_ctxpopup_item_label_get(const Elm_Ctxpopup_Item *item)
1074 {
1075    ELM_CTXPOPUP_ITEM_CHECK_RETURN(item, NULL);
1076    return item->label;
1077 }
1078
1079 /**
1080  * (Re)set the label on the given ctxpopup item.
1081  *
1082  * @param item Ctxpopup item
1083  * @param label String to set as label
1084  *
1085  * @ingroup Ctxpopup
1086  */
1087 EAPI void
1088 elm_ctxpopup_item_label_set(Elm_Ctxpopup_Item *item, const char *label)
1089 {
1090    ELM_CTXPOPUP_ITEM_CHECK_RETURN(item);
1091
1092    Widget_Data *wd;
1093
1094    wd = elm_widget_data_get(item->base.widget);
1095    if (!wd) return;
1096
1097    _item_label_set(item, label);
1098
1099    if (wd->visible)
1100      {
1101         _scroller_size_reset(wd);
1102         _sizing_eval(item->base.widget);
1103      }
1104 }
1105
1106 /**
1107  * Set the Ctxpopup's parent
1108  * Set the parent object (it would much probably be the
1109  * window that the ctxpopup is in).
1110  *
1111  * @param obj The ctxpopup object
1112  * @param area The parent to use
1113  *
1114  * @note elm_ctxpopup_add() will automatically call this function
1115  * with its @c parent argument.
1116  *
1117  * @ingroup Ctxpopup
1118  */
1119 EAPI void
1120 elm_ctxpopup_hover_parent_set(Evas_Object *obj, Evas_Object *hover_parent)
1121 {
1122    ELM_CHECK_WIDTYPE(obj, widtype);
1123
1124    Widget_Data *wd;
1125
1126    wd = elm_widget_data_get(obj);
1127    if (!wd) return;
1128
1129    _hover_parent_callbacks_del(obj);
1130
1131    if (hover_parent)
1132      {
1133         evas_object_event_callback_add(hover_parent, EVAS_CALLBACK_DEL,
1134                                        _hover_parent_del, obj);
1135         evas_object_event_callback_add(hover_parent, EVAS_CALLBACK_MOVE,
1136                                        _hover_parent_move, obj);
1137         evas_object_event_callback_add(hover_parent, EVAS_CALLBACK_RESIZE,
1138                                        _hover_parent_resize, obj);
1139      }
1140
1141    wd->hover_parent = hover_parent;
1142 }
1143
1144 /**
1145  * Get the Ctxpopup's parent
1146  *
1147  * @param obj The ctxpopup object
1148  *
1149  * @see elm_ctxpopup_hover_parent_set() for more information
1150  *
1151  * @ingroup Ctxpopup
1152  */
1153 EAPI Evas_Object *
1154 elm_ctxpopup_hover_parent_get(const Evas_Object *obj)
1155 {
1156    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
1157
1158    Widget_Data *wd;
1159
1160    wd = elm_widget_data_get(obj);
1161    if (!wd) return NULL;
1162
1163    return wd->hover_parent;
1164 }
1165
1166 /**
1167  * Clear all items in the given ctxpopup object.
1168  *
1169  * @param obj Ctxpopup object
1170  *
1171  * @ingroup Ctxpopup
1172  */
1173 EAPI void
1174 elm_ctxpopup_clear(Evas_Object * obj)
1175 {
1176    ELM_CHECK_WIDTYPE(obj, widtype);
1177
1178    Widget_Data *wd = elm_widget_data_get(obj);
1179    if (!wd) return;
1180
1181    _remove_items(wd);
1182    _list_del(wd);
1183 }
1184
1185 /**
1186  * Change the ctxpopup's orientation to horizontal or vertical.
1187  *
1188  * @param obj Ctxpopup object
1189  * @param horizontal @c EINA_TRUE for horizontal mode, @c EINA_FALSE for vertical
1190  *
1191  * @ingroup Ctxpopup
1192  */
1193 EAPI void
1194 elm_ctxpopup_horizontal_set(Evas_Object *obj, Eina_Bool horizontal)
1195 {
1196    ELM_CHECK_WIDTYPE(obj, widtype);
1197
1198    Widget_Data *wd;
1199
1200    wd = elm_widget_data_get(obj);
1201    if (!wd) return;
1202
1203    wd->horizontal = !!horizontal;
1204
1205    if ((!wd->scr) && (!wd->box))
1206       return;
1207
1208    if (!horizontal)
1209      {
1210         elm_box_horizontal_set(wd->box, EINA_FALSE);
1211         elm_scroller_bounce_set(wd->scr, EINA_FALSE, EINA_TRUE);
1212      }
1213    else
1214      {
1215         elm_box_horizontal_set(wd->box, EINA_TRUE);
1216         elm_scroller_bounce_set(wd->scr, EINA_TRUE, EINA_FALSE);
1217      }
1218
1219    if (wd->visible)
1220       _sizing_eval(obj);
1221 }
1222
1223 /**
1224  * Get the value of current ctxpopup object's orientation.
1225  *
1226  * @param obj Ctxpopup object
1227  * @return @c EINA_TRUE for horizontal mode, @c EINA_FALSE for vertical mode (or errors)
1228  *
1229  * @ingroup Ctxpopup
1230  */
1231 EAPI Eina_Bool
1232 elm_ctxpopup_horizontal_get(const Evas_Object *obj)
1233 {
1234    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
1235
1236    Widget_Data *wd;
1237
1238    wd = elm_widget_data_get(obj);
1239    if (!wd) return EINA_FALSE;
1240
1241    return wd->horizontal;
1242 }
1243
1244 /**
1245  * Add a new item to a ctxpopup object.
1246  *
1247  * Both a item list and a content could not be set at the same time!
1248  * once you set add a item, the previous content will be removed.
1249  *
1250  * @param obj Ctxpopup object
1251  * @param icon Icon to be set on new item
1252  * @param label The Label of the new item
1253  * @param func Convenience function called when item selected
1254  * @param data Data passed to @p func above
1255  * @return A handle to the item added or @c NULL, on errors
1256  *
1257  * @ingroup Ctxpopup
1258  */
1259 EAPI Elm_Ctxpopup_Item *
1260 elm_ctxpopup_item_append(Evas_Object *obj, const char *label,
1261                          Evas_Object *icon, Evas_Smart_Cb func,
1262                          const void *data)
1263 {
1264    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
1265
1266    Widget_Data *wd;
1267    Elm_Ctxpopup_Item *item;
1268
1269    wd = elm_widget_data_get(obj);
1270    if (!wd) return NULL;
1271
1272    item = elm_widget_item_new(obj, Elm_Ctxpopup_Item);
1273    if (!item) return NULL;
1274
1275    //The first item is appended.
1276    if (wd->content)
1277       evas_object_del(elm_ctxpopup_content_unset(obj));
1278
1279    if (!wd->items)
1280       _list_new(obj);
1281
1282    item->func = func;
1283    item->base.data = data;
1284
1285    if (icon && label)
1286       _item_new(item, "icon_text_style_item");
1287    else if (label)
1288       _item_new(item, "text_style_item");
1289    else
1290       _item_new(item, "icon_style_item");
1291
1292    _item_icon_set(item, icon);
1293    _item_label_set(item, label);
1294    elm_box_pack_end(wd->box, item->base.view);
1295    wd->items = eina_list_append(wd->items, item);
1296
1297    if (wd->visible)
1298      {
1299         _scroller_size_reset(wd);
1300         _sizing_eval(obj);
1301      }
1302
1303    return item;
1304 }
1305
1306 /**
1307  * Delete the given item in a ctxpopup object.
1308  *
1309  * @param item Ctxpopup item to be deleted
1310  *
1311  * @ingroup Ctxpopup
1312  */
1313 EAPI void
1314 elm_ctxpopup_item_del(Elm_Ctxpopup_Item *item)
1315 {
1316    ELM_CTXPOPUP_ITEM_CHECK_RETURN(item);
1317
1318    Widget_Data *wd;
1319
1320    wd = elm_widget_data_get(item->base.widget);
1321    if (!wd) return;
1322
1323    if (item->icon)
1324       evas_object_del(item->icon);
1325    if (item->base.view)
1326       evas_object_del(item->base.view);
1327
1328    eina_stringshare_del(item->label);
1329
1330    wd->items = eina_list_remove(wd->items, item);
1331
1332    if (eina_list_count(wd->items) < 1)
1333       wd->items = NULL;
1334
1335    if (wd->visible)
1336       _sizing_eval(item->base.widget);
1337
1338    free(item);
1339 }
1340
1341 /**
1342  * Set the ctxpopup item's state as disabled or enabled.
1343  *
1344  * @param item Ctxpopup item to be enabled/disabled
1345  * @param disabled @c EINA_TRUE to disable it, @c EINA_FALSE to enable it
1346  *
1347  * @ingroup Ctxpopup
1348  */
1349 EAPI void
1350 elm_ctxpopup_item_disabled_set(Elm_Ctxpopup_Item *item, Eina_Bool disabled)
1351 {
1352    ELM_CTXPOPUP_ITEM_CHECK_RETURN(item);
1353
1354    Widget_Data *wd;
1355
1356    wd = elm_widget_data_get(item->base.widget);
1357    if (!wd) return;
1358
1359    if (disabled == item->disabled)
1360       return;
1361
1362    if (disabled)
1363       edje_object_signal_emit(item->base.view, "elm,state,disabled", "elm");
1364    else
1365       edje_object_signal_emit(item->base.view, "elm,state,enabled", "elm");
1366
1367    item->disabled = !!disabled;
1368 }
1369
1370 /**
1371  * Get the ctxpopup item's disabled/enabled state.
1372  *
1373  * @param item Ctxpopup item to be enabled/disabled
1374  * @return disabled @c EINA_TRUE, if disabled, @c EINA_FALSE otherwise
1375  *
1376  * @ingroup Ctxpopup
1377  */
1378 EAPI Eina_Bool
1379 elm_ctxpopup_item_disabled_get(const Elm_Ctxpopup_Item *item)
1380 {
1381    ELM_CTXPOPUP_ITEM_CHECK_RETURN(item, EINA_FALSE);
1382    return item->disabled;
1383 }
1384
1385 /**
1386  * Once the content object is set, a previously set one will be deleted.
1387  * If you want to keep that old content object, use the
1388  * elm_ctxpopup_content_unset() function
1389  *
1390  * Both a item list and a content could not be set at the same time!
1391  * once you set a content, the previous list items will be removed.
1392  *
1393  * @param obj Ctxpopup object
1394  * @param content Content to be swallowed
1395  *
1396  * @ingroup Ctxpopup
1397  */
1398 EAPI void
1399 elm_ctxpopup_content_set(Evas_Object *obj, Evas_Object *content)
1400 {
1401    ELM_CHECK_WIDTYPE(obj, widtype);
1402
1403    Widget_Data *wd;
1404
1405    wd = elm_widget_data_get(obj);
1406    if ((!wd) || (!content))
1407       return;
1408
1409    if (wd->items)
1410       elm_ctxpopup_clear(obj);
1411
1412    if (wd->content)
1413       evas_object_del(wd->content);
1414
1415    evas_object_event_callback_add(content, EVAS_CALLBACK_DEL, _content_del,
1416                                   obj);
1417
1418    elm_widget_sub_object_add(obj, content);
1419    edje_object_part_swallow(wd->base, "elm.swallow.content", content);
1420    edje_object_message_signal_process(wd->base);
1421
1422    wd->content = content;
1423
1424    if (wd->visible)
1425       _sizing_eval(obj);
1426 }
1427
1428 /**
1429  * Unset the ctxpopup content
1430  *
1431  * Unparent and return the content object which was set for this widget
1432  *
1433  * @param obj Ctxpopup object
1434  * @return The content that was being used
1435  *
1436  * @ingroup Ctxpopup
1437  */
1438 EAPI Evas_Object *
1439 elm_ctxpopup_content_unset(Evas_Object *obj)
1440 {
1441    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
1442
1443    Widget_Data *wd;
1444    Evas_Object *content;
1445
1446    wd = elm_widget_data_get(obj);
1447    if (!wd) return NULL;
1448
1449    content = wd->content;
1450    if (!content) return NULL;
1451
1452    edje_object_part_unswallow(wd->base, content);
1453    elm_widget_sub_object_del(obj, content);
1454    evas_object_event_callback_del(content, EVAS_CALLBACK_DEL, _content_del);
1455    edje_object_signal_emit(wd->base, "elm,state,content,disable", "elm");
1456
1457    wd->content = NULL;
1458
1459    return content;
1460 }
1461
1462 /**
1463  * Set the direction priority of a ctxpopup.
1464  * This functions gives a chance to user to set the priority of ctxpopup showing direction.
1465  *
1466  * @param obj Ctxpopup object
1467  * @param first 1st priority of direction
1468  * @param second 2nd priority of direction
1469  * @param third 3th priority of direction
1470  * @param fourth 4th priority of direction
1471  *
1472  * @ingroup Ctxpopup
1473  */
1474 EAPI void
1475 elm_ctxpopup_direction_priority_set(Evas_Object *obj,
1476                                     Elm_Ctxpopup_Direction first,
1477                                     Elm_Ctxpopup_Direction second,
1478                                     Elm_Ctxpopup_Direction third,
1479                                     Elm_Ctxpopup_Direction fourth)
1480 {
1481    ELM_CHECK_WIDTYPE(obj, widtype);
1482    Widget_Data *wd;
1483
1484    wd = elm_widget_data_get(obj);
1485    if (!wd) return;
1486
1487    wd->dir_priority[0] = first;
1488    wd->dir_priority[1] = second;
1489    wd->dir_priority[2] = third;
1490    wd->dir_priority[3] = fourth;
1491
1492    if (wd->visible)
1493       _sizing_eval(obj);
1494 }
1495
1496 /**
1497  * Get the direction priority of a ctxpopup.
1498  *
1499  * @param obj Ctxpopup object
1500  * @param first 1st priority of direction to be returned
1501  * @param second 2nd priority of direction to be returned
1502  * @param third 3th priority of direction to be returned
1503  * @param fourth 4th priority of direction to be returned
1504  *
1505  * @see elm_ctxpopup_direction_priority_set for more information.
1506  *
1507  * @ingroup Ctxpopup
1508  */
1509 EAPI void
1510 elm_ctxpopup_direction_priority_get(Evas_Object *obj,
1511                                     Elm_Ctxpopup_Direction *first,
1512                                     Elm_Ctxpopup_Direction *second,
1513                                     Elm_Ctxpopup_Direction *third,
1514                                     Elm_Ctxpopup_Direction *fourth)
1515 {
1516    ELM_CHECK_WIDTYPE(obj, widtype);
1517    Widget_Data *wd;
1518
1519    wd = elm_widget_data_get(obj);
1520    if (!wd) return;
1521
1522    if (first) *first = wd->dir_priority[0];
1523    if (second) *second = wd->dir_priority[1];
1524    if (third) *third = wd->dir_priority[2];
1525    if (fourth) *fourth = wd->dir_priority[3];
1526 }