src/lib/elm_clock.c

   1 #include <Elementary.h>
   2 #include "elm_priv.h"
   3
   4 /**
   5  * @defgroup Clock Clock
   6  *
   7  * It's a widget to show clock with animation. The update of time is
   8  * shown in an animation like the flip of a sheet.
   9  *
  10  */
  11
  12 typedef struct _Widget_Data Widget_Data;
  13
  14 struct _Widget_Data
  15 {
  16    Evas_Object *clk;
  17    double interval, first_interval;
  18    Eina_Bool seconds : 1;
  19    Eina_Bool am_pm : 1;
  20    Eina_Bool edit : 1;
  21    Elm_Clock_Digedit digedit;
  22    int hrs, min, sec, timediff;
  23    Evas_Object *digit[6];
  24    Evas_Object *ampm;
  25    Evas_Object *sel_obj;
  26    Ecore_Timer *ticker, *spin;
  27    struct
  28      {
  29         int hrs, min, sec;
  30         char ampm;
  31         Eina_Bool seconds : 1;
  32         Eina_Bool am_pm : 1;
  33         Eina_Bool edit : 1;
  34         Elm_Clock_Digedit digedit;
  35      } cur;
  36 };
  37
  38 static const char *widtype = NULL;
  39 static void _del_hook(Evas_Object *obj);
  40 static void _theme_hook(Evas_Object *obj);
  41 static void _on_focus_hook(void *data, Evas_Object *obj);
  42 static Eina_Bool _ticker(void *data);
  43 static Eina_Bool _signal_clock_val_up(void *data);
  44 static Eina_Bool _signal_clock_val_down(void *data);
  45 static void _time_update(Evas_Object *obj);
  46
  47 static void
  48 _del_hook(Evas_Object *obj)
  49 {
  50    Widget_Data *wd = elm_widget_data_get(obj);
  51    if (!wd) return;
  52    int i;
  53    for (i = 0; i < 6; i++)
  54      {
  55         if (wd->digit[i]) evas_object_del(wd->digit[i]);
  56      }
  57    if (wd->ampm) evas_object_del(wd->ampm);
  58    if (wd->ticker) ecore_timer_del(wd->ticker);
  59    if (wd->spin) ecore_timer_del(wd->spin);
  60    free(wd);
  61 }
  62
  63 static void
  64 _theme_hook(Evas_Object *obj)
  65 {
  66    Widget_Data *wd = elm_widget_data_get(obj);
  67    if (!wd) return;
  68    if (elm_widget_focus_get(obj))
  69      edje_object_signal_emit(wd->clk, "elm,action,focus", "elm");
  70    else
  71      edje_object_signal_emit(wd->clk, "elm,action,unfocus", "elm");
  72    wd->cur.am_pm = !wd->cur.am_pm; /* hack - force update */
  73    _time_update(obj);
  74 }
  75
  76 static void
  77 _on_focus_hook(void *data __UNUSED__, Evas_Object *obj)
  78 {
  79    Widget_Data *wd = elm_widget_data_get(obj);
  80    if (!wd) return;
  81    if (elm_widget_focus_get(obj))
  82      {
  83        edje_object_signal_emit(wd->clk, "elm,action,focus", "elm");
  84        evas_object_focus_set(wd->clk, EINA_TRUE);
  85      }
  86    else
  87      {
  88        edje_object_signal_emit(wd->clk, "elm,action,unfocus", "elm");
  89        evas_object_focus_set(wd->clk, EINA_FALSE);
  90      }
  91 }
  92
  93 static void
  94 _signal_emit_hook(Evas_Object *obj, const char *emission, const char *source)
  95 {
  96    Widget_Data *wd = elm_widget_data_get(obj);
  97    int i;
  98    if (!wd) return;
  99    edje_object_signal_emit(wd->clk, emission, source);
 100    for (i = 0; i < 6; i++)
 101      {
 102         if (wd->digit[i])
 103           edje_object_signal_emit(wd->digit[i], emission, source);
 104      }
 105 }
 106
 107 static void
 108 _signal_callback_add_hook(Evas_Object *obj, const char *emission, const char *source, void (*func_cb) (void *data, Evas_Object *o, const char *emission, const char *source), void *data)
 109 {
 110    Widget_Data *wd = elm_widget_data_get(obj);
 111    int i;
 112    if (!wd) return;
 113    edje_object_signal_callback_add(wd->clk, emission, source, func_cb, data);
 114    for (i = 0; i < 6; i++)
 115      {
 116         if (wd->digit[i])
 117           edje_object_signal_callback_add(wd->digit[i], emission, source,
 118                 func_cb, data);
 119      }
 120 }
 121
 122 static void
 123 _signal_callback_del_hook(Evas_Object *obj, const char *emission, const char *source, void (*func_cb) (void *data, Evas_Object *o, const char *emission, const char *source), void *data)
 124 {
 125    Widget_Data *wd = elm_widget_data_get(obj);
 126    int i;
 127    for (i = 0; i < 6; i++)
 128      {
 129         edje_object_signal_callback_del_full(wd->digit[i], emission, source,
 130                                              func_cb, data);
 131      }
 132    edje_object_signal_callback_del_full(wd->clk, emission, source, func_cb,
 133                                         data);
 134 }
 135
 136 static void
 137 _timediff_set(Widget_Data *wd)
 138 {
 139    struct timeval timev;
 140    struct tm *tm;
 141    time_t tt;
 142    gettimeofday(&timev, NULL);
 143    tt = (time_t)(timev.tv_sec);
 144    tzset();
 145    tm = localtime(&tt);
 146    wd->timediff = (((wd->hrs - tm->tm_hour) * 60 +
 147             wd->min - tm->tm_min) * 60) + wd->sec - tm->tm_sec;
 148 }
 149
 150 static Eina_Bool
 151 _ticker(void *data)
 152 {
 153    Widget_Data *wd = elm_widget_data_get(data);
 154    double t;
 155    struct timeval timev;
 156    struct tm *tm;
 157    time_t tt;
 158    if (!wd) return ECORE_CALLBACK_CANCEL;
 159    gettimeofday(&timev, NULL);
 160    t = ((double)(1000000 - timev.tv_usec)) / 1000000.0;
 161    wd->ticker = ecore_timer_add(t, _ticker, data);
 162    if (!wd->edit)
 163      {
 164         tt = (time_t)(timev.tv_sec) + wd->timediff;
 165         tzset();
 166         tm = localtime(&tt);
 167         if (tm)
 168           {
 169              wd->hrs = tm->tm_hour;
 170              wd->min = tm->tm_min;
 171              wd->sec = tm->tm_sec;
 172              _time_update(data);
 173           }
 174      }
 175    return ECORE_CALLBACK_CANCEL;
 176 }
 177
 178 static Eina_Bool
 179 _signal_clock_val_up(void *data)
 180 {
 181    Widget_Data *wd = elm_widget_data_get(data);
 182    if (!wd) goto clock_val_up_exit_on_error;
 183    if (!wd->edit) goto clock_val_up_cancel;
 184    if (!wd->sel_obj) goto clock_val_up_cancel;
 185    if (wd->sel_obj == wd->digit[0])
 186      {
 187         wd->hrs = wd->hrs + 10;
 188         if (wd->hrs >= 24) wd->hrs -= 24;
 189      }
 190    if (wd->sel_obj == wd->digit[1])
 191      {
 192         wd->hrs = wd->hrs + 1;
 193         if (wd->hrs >= 24) wd->hrs -= 24;
 194      }
 195    if (wd->sel_obj == wd->digit[2])
 196      {
 197         wd->min = wd->min + 10;
 198         if (wd->min >= 60) wd->min -= 60;
 199      }
 200    if (wd->sel_obj == wd->digit[3])
 201      {
 202         wd->min = wd->min + 1;
 203         if (wd->min >= 60) wd->min -= 60;
 204      }
 205    if (wd->sel_obj == wd->digit[4])
 206      {
 207         wd->sec = wd->sec + 10;
 208         if (wd->sec >= 60) wd->sec -= 60;
 209      }
 210    if (wd->sel_obj == wd->digit[5])
 211      {
 212         wd->sec = wd->sec + 1;
 213         if (wd->sec >= 60) wd->sec -= 60;
 214      }
 215    if (wd->sel_obj == wd->ampm)
 216      {
 217         wd->hrs = wd->hrs + 12;
 218         if (wd->hrs > 23) wd->hrs -= 24;
 219      }
 220    wd->interval = wd->interval / 1.05;
 221    ecore_timer_interval_set(wd->spin, wd->interval);
 222    _time_update(data);
 223    evas_object_smart_callback_call(data, "changed", NULL);
 224    return ECORE_CALLBACK_RENEW;
 225 clock_val_up_cancel:
 226    wd->spin = NULL;
 227 clock_val_up_exit_on_error:
 228    return ECORE_CALLBACK_CANCEL;
 229 }
 230
 231 static Eina_Bool
 232 _signal_clock_val_down(void *data)
 233 {
 234    Widget_Data *wd = elm_widget_data_get(data);
 235    if (!wd) goto clock_val_down_exit_on_error;
 236    if (!wd->edit) goto clock_val_down_cancel;
 237    if (!wd->sel_obj) goto clock_val_down_cancel;
 238    if (wd->sel_obj == wd->digit[0])
 239      {
 240         wd->hrs = wd->hrs - 10;
 241         if (wd->hrs < 0) wd->hrs += 24;
 242      }
 243    if (wd->sel_obj == wd->digit[1])
 244      {
 245         wd->hrs = wd->hrs - 1;
 246         if (wd->hrs < 0) wd->hrs += 24;
 247      }
 248    if (wd->sel_obj == wd->digit[2])
 249      {
 250         wd->min = wd->min - 10;
 251         if (wd->min < 0) wd->min += 60;
 252      }
 253    if (wd->sel_obj == wd->digit[3])
 254      {
 255         wd->min = wd->min - 1;
 256         if (wd->min < 0) wd->min += 60;
 257      }
 258    if (wd->sel_obj == wd->digit[4])
 259      {
 260         wd->sec = wd->sec - 10;
 261         if (wd->sec < 0) wd->sec += 60;
 262      }
 263    if (wd->sel_obj == wd->digit[5])
 264      {
 265         wd->sec = wd->sec - 1;
 266         if (wd->sec < 0) wd->sec += 60;
 267      }
 268    if (wd->sel_obj == wd->ampm)
 269      {
 270         wd->hrs = wd->hrs - 12;
 271         if (wd->hrs < 0) wd->hrs += 24;
 272      }
 273    wd->interval = wd->interval / 1.05;
 274    ecore_timer_interval_set(wd->spin, wd->interval);
 275    _time_update(data);
 276    evas_object_smart_callback_call(data, "changed", NULL);
 277    return ECORE_CALLBACK_RENEW;
 278 clock_val_down_cancel:
 279    wd->spin = NULL;
 280 clock_val_down_exit_on_error:
 281    return ECORE_CALLBACK_CANCEL;
 282 }
 283
 284 static void
 285 _signal_clock_val_up_start(void *data, Evas_Object *obj, const char *emission __UNUSED__, const char *source __UNUSED__)
 286 {
 287    Widget_Data *wd = elm_widget_data_get(data);
 288    if (!wd) return;
 289    wd->interval = wd->first_interval;
 290    wd->sel_obj = obj;
 291    if (wd->spin) ecore_timer_del(wd->spin);
 292    wd->spin = ecore_timer_add(wd->interval, _signal_clock_val_up, data);
 293    _signal_clock_val_up(data);
 294 }
 295
 296 static void
 297 _signal_clock_val_down_start(void *data, Evas_Object *obj, const char *emission __UNUSED__, const char *source __UNUSED__)
 298 {
 299    Widget_Data *wd = elm_widget_data_get(data);
 300    if (!wd) return;
 301    wd->interval = wd->first_interval;
 302    wd->sel_obj = obj;
 303    if (wd->spin) ecore_timer_del(wd->spin);
 304    wd->spin = ecore_timer_add(wd->interval, _signal_clock_val_down, data);
 305    _signal_clock_val_down(data);
 306 }
 307
 308 static void
 309 _signal_clock_val_change_stop(void *data, Evas_Object *obj __UNUSED__, const char *emission __UNUSED__, const char *source __UNUSED__)
 310 {
 311    Widget_Data *wd = elm_widget_data_get(data);
 312    if (!wd) return;
 313    if (wd->spin) ecore_timer_del(wd->spin);
 314    wd->spin = NULL;
 315    wd->sel_obj = NULL;
 316 }
 317
 318 static void
 319 _time_update(Evas_Object *obj)
 320 {
 321    Widget_Data *wd = elm_widget_data_get(obj);
 322    Edje_Message_Int msg;
 323    int ampm = 0;
 324    const char *style = elm_widget_style_get(obj);
 325    if (!wd) return;
 326    if ((wd->cur.seconds != wd->seconds) || (wd->cur.am_pm != wd->am_pm) ||
 327        (wd->cur.edit != wd->edit) || (wd->cur.digedit != wd->digedit))
 328      {
 329         int i;
 330         Evas_Coord mw, mh;
 331
 332         for (i = 0; i < 6; i++)
 333           {
 334              if (wd->digit[i])
 335                {
 336                   evas_object_del(wd->digit[i]);
 337                   wd->digit[i] = NULL;
 338                }
 339           }
 340         if (wd->ampm)
 341           {
 342              evas_object_del(wd->ampm);
 343              wd->ampm = NULL;
 344           }
 345
 346         if ((wd->seconds) && (wd->am_pm))
 347           _elm_theme_object_set(obj, wd->clk, "clock", "base-all", style);
 348         else if (wd->seconds)
 349           _elm_theme_object_set(obj, wd->clk, "clock", "base-seconds", style);
 350         else if (wd->am_pm)
 351           _elm_theme_object_set(obj, wd->clk, "clock", "base-am_pm", style);
 352         else
 353           _elm_theme_object_set(obj, wd->clk, "clock", "base", style);
 354         edje_object_scale_set(wd->clk, elm_widget_scale_get(obj) *
 355                               _elm_config->scale);
 356
 357         for (i = 0; i < 6; i++)
 358           {
 359              char buf[16];
 360
 361              if ((!wd->seconds) && (i >= 4)) break;
 362              wd->digit[i] = edje_object_add(evas_object_evas_get(wd->clk));
 363              _elm_theme_object_set(obj, wd->digit[i], "clock", "flipdigit", style);
 364              edje_object_scale_set(wd->digit[i], elm_widget_scale_get(obj) *
 365                                    _elm_config->scale);
 366              if ((wd->edit) && (wd->digedit & (1 << i)))
 367                edje_object_signal_emit(wd->digit[i], "elm,state,edit,on", "elm");
 368              edje_object_signal_callback_add(wd->digit[i], "elm,action,up,start",
 369                                              "", _signal_clock_val_up_start, obj);
 370              edje_object_signal_callback_add(wd->digit[i], "elm,action,up,stop",
 371                                              "", _signal_clock_val_change_stop, obj);
 372              edje_object_signal_callback_add(wd->digit[i], "elm,action,down,start",
 373                                              "", _signal_clock_val_down_start, obj);
 374              edje_object_signal_callback_add(wd->digit[i], "elm,action,down,stop",
 375                                              "", _signal_clock_val_change_stop, obj);
 376              mw = mh = -1;
 377              elm_coords_finger_size_adjust(1, &mw, 2, &mh);
 378              edje_object_size_min_restricted_calc(wd->digit[i], &mw, &mh, mw, mh);
 379              elm_coords_finger_size_adjust(1, &mw, 2, &mh);
 380              edje_extern_object_min_size_set(wd->digit[i], mw, mh);
 381              snprintf(buf, sizeof(buf), "d%i", i);
 382              edje_object_part_swallow(wd->clk , buf, wd->digit[i]);
 383              evas_object_show(wd->digit[i]);
 384           }
 385         if (wd->am_pm)
 386           {
 387              wd->ampm = edje_object_add(evas_object_evas_get(wd->clk));
 388              _elm_theme_object_set(obj, wd->ampm, "clock", "flipampm", style);
 389              edje_object_scale_set(wd->ampm, elm_widget_scale_get(obj) *
 390                                    _elm_config->scale);
 391              if (wd->edit)
 392                edje_object_signal_emit(wd->ampm, "elm,state,edit,on", "elm");
 393              edje_object_signal_callback_add(wd->ampm, "elm,action,up,start",
 394                                              "", _signal_clock_val_up_start, obj);
 395              edje_object_signal_callback_add(wd->ampm, "elm,action,up,stop",
 396                                              "", _signal_clock_val_change_stop, obj);
 397              edje_object_signal_callback_add(wd->ampm, "elm,action,down,start",
 398                                              "", _signal_clock_val_down_start, obj);
 399              edje_object_signal_callback_add(wd->ampm, "elm,action,down,stop",
 400                                              "", _signal_clock_val_change_stop, obj);
 401              mw = mh = -1;
 402              elm_coords_finger_size_adjust(1, &mw, 2, &mh);
 403              edje_object_size_min_restricted_calc(wd->ampm, &mw, &mh, mw, mh);
 404              elm_coords_finger_size_adjust(1, &mw, 2, &mh);
 405              edje_extern_object_min_size_set(wd->ampm, mw, mh);
 406              edje_object_part_swallow(wd->clk , "ampm", wd->ampm);
 407              evas_object_show(wd->ampm);
 408           }
 409
 410         edje_object_size_min_calc(wd->clk, &mw, &mh);
 411         evas_object_size_hint_min_set(obj, mw, mh);
 412
 413         wd->cur.hrs = 0;
 414         wd->cur.min = 0;
 415         wd->cur.sec = 0;
 416         wd->cur.ampm = -1;
 417         wd->cur.seconds = wd->seconds;
 418         wd->cur.am_pm = wd->am_pm;
 419         wd->cur.edit = wd->edit;
 420         wd->cur.digedit = wd->digedit;
 421      }
 422    if (wd->hrs != wd->cur.hrs)
 423      {
 424         int hrs;
 425         int d1, d2, dc1, dc2;
 426
 427         hrs = wd->hrs;
 428         if (wd->am_pm)
 429           {
 430              if (hrs >= 12)
 431                {
 432                   if (hrs > 12) hrs -= 12;
 433                   ampm = 1;
 434                }
 435              else if (!hrs) hrs = 12;
 436           }
 437         d1 = hrs / 10;
 438         d2 = hrs % 10;
 439         dc1 = wd->cur.hrs / 10;
 440         dc2 = wd->cur.hrs % 10;
 441         if (d1 != dc1)
 442           {
 443              msg.val = d1;
 444              edje_object_message_send(wd->digit[0], EDJE_MESSAGE_INT, 1, &msg);
 445           }
 446         if (d2 != dc2)
 447           {
 448              msg.val = d2;
 449              edje_object_message_send(wd->digit[1], EDJE_MESSAGE_INT, 1, &msg);
 450           }
 451         wd->cur.hrs = hrs;
 452      }
 453    if (wd->min != wd->cur.min)
 454      {
 455         int d1, d2, dc1, dc2;
 456
 457         d1 = wd->min / 10;
 458         d2 = wd->min % 10;
 459         dc1 = wd->cur.min / 10;
 460         dc2 = wd->cur.min % 10;
 461         if (d1 != dc1)
 462           {
 463              msg.val = d1;
 464              edje_object_message_send(wd->digit[2], EDJE_MESSAGE_INT, 1, &msg);
 465           }
 466         if (d2 != dc2)
 467           {
 468              msg.val = d2;
 469              edje_object_message_send(wd->digit[3], EDJE_MESSAGE_INT, 1, &msg);
 470           }
 471         wd->cur.min = wd->min;
 472      }
 473    if (wd->seconds)
 474      {
 475         if (wd->sec != wd->cur.sec)
 476           {
 477              int d1, d2, dc1, dc2;
 478
 479              d1 = wd->sec / 10;
 480              d2 = wd->sec % 10;
 481              dc1 = wd->cur.sec / 10;
 482              dc2 = wd->cur.sec % 10;
 483              if (d1 != dc1)
 484                {
 485                   msg.val = d1;
 486                   edje_object_message_send(wd->digit[4], EDJE_MESSAGE_INT, 1, &msg);
 487                }
 488              if (d2 != dc2)
 489                {
 490                   msg.val = d2;
 491                   edje_object_message_send(wd->digit[5], EDJE_MESSAGE_INT, 1, &msg);
 492                }
 493              wd->cur.sec = wd->sec;
 494           }
 495      }
 496    else
 497      wd->cur.sec = -1;
 498
 499    if (wd->am_pm)
 500      {
 501         if (wd->hrs >= 12) ampm = 1;
 502         if (ampm != wd->cur.ampm)
 503           {
 504              if (wd->cur.ampm != ampm)
 505                {
 506                   msg.val = ampm;
 507                   edje_object_message_send(wd->ampm, EDJE_MESSAGE_INT, 1, &msg);
 508                }
 509              wd->cur.ampm = ampm;
 510           }
 511      }
 512    else
 513      wd->cur.ampm = -1;
 514 }
 515
 516 /**
 517  * Add a new clock to the parent
 518  *
 519  * @param parent The parent object
 520  *
 521  * This function inserts a clock widget on a given canvas to show a
 522  * animated clock.
 523  *
 524  * @ingroup Clock
 525  */
 526 EAPI Evas_Object *
 527 elm_clock_add(Evas_Object *parent)
 528 {
 529    Evas_Object *obj;
 530    Evas *e;
 531    Widget_Data *wd;
 532
 533    EINA_SAFETY_ON_NULL_RETURN_VAL(parent, NULL);
 534
 535    wd = ELM_NEW(Widget_Data);
 536    e = evas_object_evas_get(parent);
 537    if (!e) return NULL;
 538    obj = elm_widget_add(e);
 539    ELM_SET_WIDTYPE(widtype, "clock");
 540    elm_widget_type_set(obj, "clock");
 541    elm_widget_sub_object_add(parent, obj);
 542    elm_widget_data_set(obj, wd);
 543    elm_widget_del_hook_set(obj, _del_hook);
 544    elm_widget_theme_hook_set(obj, _theme_hook);
 545    elm_widget_on_focus_hook_set(obj, _on_focus_hook, NULL);
 546    elm_widget_signal_emit_hook_set(obj, _signal_emit_hook);
 547    elm_widget_signal_callback_add_hook_set(obj, _signal_callback_add_hook);
 548    elm_widget_signal_callback_del_hook_set(obj, _signal_callback_del_hook);
 549    elm_widget_can_focus_set(obj, EINA_TRUE);
 550
 551    wd->clk = edje_object_add(e);
 552    elm_widget_resize_object_set(obj, wd->clk);
 553
 554    wd->cur.ampm = -1;
 555    wd->cur.seconds = EINA_TRUE;
 556    wd->cur.am_pm = EINA_TRUE;
 557    wd->cur.edit = EINA_TRUE;
 558    wd->cur.digedit = ELM_CLOCK_NONE;
 559    wd->first_interval = 0.85;
 560    wd->timediff = 0;
 561
 562    _time_update(obj);
 563    _ticker(obj);
 564
 565    return obj;
 566 }
 567
 568 /**
 569  * Set the clock time
 570  *
 571  * @param obj The clock object
 572  * @param hrs The hours to set
 573  * @param min The minutes to set
 574  * @param sec The secondes to set
 575  *
 576  * This function updates the time that is showed by the clock widget
 577  *
 578  * @ingroup Clock
 579  */
 580 EAPI void
 581 elm_clock_time_set(Evas_Object *obj, int hrs, int min, int sec)
 582 {
 583    ELM_CHECK_WIDTYPE(obj, widtype);
 584    Widget_Data *wd = elm_widget_data_get(obj);
 585    if (!wd) return;
 586    wd->hrs = hrs;
 587    wd->min = min;
 588    wd->sec = sec;
 589    _timediff_set(wd);
 590    _time_update(obj);
 591 }
 592
 593 /**
 594  * Get clock time
 595  *
 596  * @param obj The clock object
 597  * @param hrs Pointer to the variable to get the hour of this clock
 598  * object
 599  * @param min Pointer to the variable to get the minute of this clock
 600  * object
 601  * @param sec Pointer to the variable to get the second of this clock
 602  * object
 603  *
 604  * This function gets the time set of the clock widget and returns it
 605  * on the variables passed as the arguments to function
 606  *
 607  * @ingroup Clock
 608  */
 609 EAPI void
 610 elm_clock_time_get(const Evas_Object *obj, int *hrs, int *min, int *sec)
 611 {
 612    ELM_CHECK_WIDTYPE(obj, widtype);
 613    Widget_Data *wd = elm_widget_data_get(obj);
 614    if (!wd) return;
 615    if (hrs) *hrs = wd->hrs;
 616    if (min) *min = wd->min;
 617    if (sec) *sec = wd->sec;
 618 }
 619
 620 /**
 621  * Set if the clock settings can be edited
 622  *
 623  * @param obj The clock object
 624  * @param edit Bool option for edited (1 = yes, 0 = no)
 625  *
 626  * This function sets if the clock settings can be edited or not.
 627  * By default or if digit_edit option was previously set to ELM_CLOCK_NONE,
 628  * all digits are editable. To choose what digits to make editable
 629  * use elm_clock_digit_edit_set().
 630  *
 631  * @ingroup Clock
 632  */
 633 EAPI void
 634 elm_clock_edit_set(Evas_Object *obj, Eina_Bool edit)
 635 {
 636    ELM_CHECK_WIDTYPE(obj, widtype);
 637    Widget_Data *wd = elm_widget_data_get(obj);
 638    if (!wd) return;
 639    wd->edit = edit;
 640    if (!edit)
 641      _timediff_set(wd);
 642    if ((edit) && (wd->digedit == ELM_CLOCK_NONE))
 643      elm_clock_digit_edit_set(obj, ELM_CLOCK_ALL);
 644    else
 645      _time_update(obj);
 646 }
 647
 648 /**
 649  * Get if the clock settings can be edited
 650  *
 651  * @param obj The clock object
 652  * @return Bool option for edited (1 = yes, 0 = no)
 653  *
 654  * This function gets if the clock settings can be edited or not.
 655  *
 656  * @ingroup Clock
 657  */
 658 EAPI Eina_Bool
 659 elm_clock_edit_get(const Evas_Object *obj)
 660 {
 661    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
 662    Widget_Data *wd = elm_widget_data_get(obj);
 663    if (!wd) return EINA_FALSE;
 664    return wd->edit;
 665 }
 666
 667 /**
 668  * Set what digits of the clock are editable
 669  *
 670  * @param obj The clock object
 671  * @param digedit Bit mask indicating the digits to edit
 672  *
 673  * If the digedit param is ELM_CLOCK_NONE, editing will be disabled.
 674  *
 675  * @ingroup Clock
 676  */
 677 EAPI void
 678 elm_clock_digit_edit_set(Evas_Object *obj, Elm_Clock_Digedit digedit)
 679 {
 680    ELM_CHECK_WIDTYPE(obj, widtype);
 681    Widget_Data *wd = elm_widget_data_get(obj);
 682    if (!wd) return;
 683    wd->digedit = digedit;
 684    if (digedit == ELM_CLOCK_NONE)
 685      elm_clock_edit_set(obj, EINA_FALSE);
 686    else
 687      _time_update(obj);
 688 }
 689
 690 /**
 691  * Get what digits of the clock are editable
 692  *
 693  * @param obj The clock object
 694  * @return Bit mask indicating the digits.
 695  *
 696  * @ingroup Clock
 697  */
 698 EAPI Elm_Clock_Digedit
 699 elm_clock_digit_edit_get(const Evas_Object *obj)
 700 {
 701    ELM_CHECK_WIDTYPE(obj, widtype) 0;
 702    Widget_Data *wd = elm_widget_data_get(obj);
 703    if (!wd) return 0;
 704    return wd->digedit;
 705 }
 706
 707 /**
 708  * Set if the clock shows hours in military or am/pm mode
 709  *
 710  * @param obj The clock object
 711  * @param am_pm Bool option for the hours mode
 712  * (1 = am/pm, 0 = military)
 713  *
 714  * This function sets the clock to show hours in military or am/pm
 715  * mode. Some countries like Brazil the military mode (00-24h-format)
 716  * is used in opposition to the USA where the am/pm mode is more
 717  * common used.
 718  *
 719  * @ingroup Clock
 720  */
 721 EAPI void
 722 elm_clock_show_am_pm_set(Evas_Object *obj, Eina_Bool am_pm)
 723 {
 724    ELM_CHECK_WIDTYPE(obj, widtype);
 725    Widget_Data *wd = elm_widget_data_get(obj);
 726    if (!wd) return;
 727    wd->am_pm = am_pm;
 728    _time_update(obj);
 729 }
 730
 731 /**
 732  * Get if the clock shows hours in military or am/pm mode
 733  *
 734  * @param obj The clock object
 735  * @return Bool option for the hours mode
 736  * (1 = am/pm, 0 = military)
 737  *
 738  * This function gets if the clock show hours in military or am/pm
 739  * mode. Some countries like Brazil the military mode (00-24h-format)
 740  * is used in opposition to the USA where the am/pm mode is more
 741  * common used.
 742  *
 743  * @ingroup Clock
 744  */
 745 EAPI Eina_Bool
 746 elm_clock_show_am_pm_get(const Evas_Object *obj)
 747 {
 748    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
 749    Widget_Data *wd = elm_widget_data_get(obj);
 750    if (!wd) return EINA_FALSE;
 751    return wd->am_pm;
 752 }
 753
 754 /**
 755  * Set if the clock shows hour with the seconds
 756  *
 757  * @param obj The clock object
 758  * @param seconds Bool option for the show seconds
 759  * (1 = show seconds, 0 = not show seconds)
 760  *
 761  * This function sets the clock to show or not to show the elapsed
 762  * seconds.
 763  *
 764  * @ingroup Clock
 765  */
 766 EAPI void
 767 elm_clock_show_seconds_set(Evas_Object *obj, Eina_Bool seconds)
 768 {
 769    ELM_CHECK_WIDTYPE(obj, widtype);
 770    Widget_Data *wd = elm_widget_data_get(obj);
 771    if (!wd) return;
 772    wd->seconds = seconds;
 773    _time_update(obj);
 774 }
 775
 776 /**
 777  * Get if the clock shows hour with the seconds
 778  *
 779  * @param obj The clock object
 780  * @return Bool option for the show seconds
 781  * (1 = show seconds, 0 = not show seconds)
 782  *
 783  * This function gets if the clock show or not show the elapsed
 784  * seconds.
 785  *
 786  * @ingroup Clock
 787  */
 788 EAPI Eina_Bool
 789 elm_clock_show_seconds_get(const Evas_Object *obj)
 790 {
 791    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
 792    Widget_Data *wd = elm_widget_data_get(obj);
 793    if (!wd) return EINA_FALSE;
 794    return wd->seconds;
 795 }
 796
 797 /**
 798  * Set the interval for the clock
 799  *
 800  * @param obj The clock object
 801  * @param interval The interval value in seconds
 802  *
 803  * The interval value is decreased while the user increments or decrements
 804  * the clock value. The next interval value is the previous interval / 1.05,
 805  * so it speed up a bit. Default value is 0.85 seconds.
 806  *
 807  * @ingroup Clock
 808  */
 809 EAPI void
 810 elm_clock_interval_set(Evas_Object *obj, double interval)
 811 {
 812    ELM_CHECK_WIDTYPE(obj, widtype);
 813    Widget_Data *wd = elm_widget_data_get(obj);
 814    if (!wd) return;
 815    wd->first_interval = interval;
 816 }
 817
 818 /**
 819  * Get the interval of the clock
 820  *
 821  * @param obj The clock object
 822  * @return The value of the first interval in seconds
 823  *
 824  * The interval value is decreased while the user increments or decrements
 825  * the clock value. The next interval value is the previous interval / 1.05,
 826  * so it speed up a bit. Default value is 0.85 seconds.
 827  *
 828  * @ingroup Clock
 829  */
 830 EAPI double
 831 elm_clock_interval_get(const Evas_Object *obj)
 832 {
 833    ELM_CHECK_WIDTYPE(obj, widtype) 0.0;
 834    Widget_Data *wd = elm_widget_data_get(obj);
 835    if (!wd) return 0.0;
 836    return wd->first_interval;
 837 }