[elementary] Documenting/exemplifying the following:
[framework/uifw/elementary.git] / src / examples / clock_example.c
1 /**
2  * Simple Elementary's <b>clock widget</b> example, illustrating its
3  * usage and API.
4  *
5  * See stdout/stderr for output. Compile with:
6  *
7  * @verbatim
8  * gcc -g `pkg-config --cflags --libs elementary` clock_example.c -o clock_example
9  * @endverbatim
10  */
11
12 #include <Elementary.h>
13 #ifdef HAVE_CONFIG_H
14 # include "elementary_config.h"
15 #else
16 # define __UNUSED__
17 #endif
18
19 static void
20 _on_done(void *data __UNUSED__,
21         Evas_Object *obj __UNUSED__,
22         void *event_info __UNUSED__)
23 {
24    elm_exit();
25 }
26
27 EAPI int
28 elm_main(int argc __UNUSED__, char **argv __UNUSED__)
29 {
30    Evas_Object *win, *bg, *bx, *ck;
31    unsigned int digedit;
32
33    win = elm_win_add(NULL, "clock", ELM_WIN_BASIC);
34    elm_win_title_set(win, "Clock Example");
35    evas_object_smart_callback_add(win, "delete,request", _on_done, NULL);
36
37    bg = elm_bg_add(win);
38    elm_win_resize_object_add(win, bg);
39    evas_object_size_hint_weight_set(bg, EVAS_HINT_EXPAND, EVAS_HINT_EXPAND);
40    evas_object_show(bg);
41
42    bx = elm_box_add(win);
43    evas_object_size_hint_weight_set(bx, EVAS_HINT_EXPAND, EVAS_HINT_EXPAND);
44    elm_win_resize_object_add(win, bx);
45    evas_object_show(bx);
46
47    /* pristine (no seconds, military time) */
48    ck = elm_clock_add(win);
49    elm_box_pack_end(bx, ck);
50    evas_object_show(ck);
51
52    /* am/pm */
53    ck = elm_clock_add(win);
54    elm_clock_show_am_pm_set(ck, EINA_TRUE);
55    elm_box_pack_end(bx, ck);
56    evas_object_show(ck);
57
58    /* with seconds and custom time */
59    ck = elm_clock_add(win);
60    elm_clock_show_seconds_set(ck, EINA_TRUE);
61    elm_clock_time_set(ck, 10, 11, 12);
62    elm_box_pack_end(bx, ck);
63    evas_object_show(ck);
64
65    /* in edition mode, with seconds, custom time and am/pm set */
66    ck = elm_clock_add(win);
67    elm_clock_edit_set(ck, EINA_TRUE);
68    elm_clock_show_seconds_set(ck, EINA_TRUE);
69    elm_clock_show_am_pm_set(ck, EINA_TRUE);
70    elm_clock_time_set(ck, 10, 11, 12);
71    elm_box_pack_end(bx, ck);
72    evas_object_show(ck);
73
74    /* in edition mode, with seconds, but only some digits editable */
75    ck = elm_clock_add(win);
76    elm_clock_show_seconds_set(ck, EINA_TRUE);
77    elm_clock_edit_set(ck, EINA_TRUE);
78    digedit = ELM_CLOCK_HOUR_UNIT | ELM_CLOCK_MIN_UNIT | ELM_CLOCK_SEC_UNIT;
79    elm_clock_digit_edit_set(ck, digedit);
80    elm_box_pack_end(bx, ck);
81    evas_object_show(ck);
82
83    evas_object_show(win);
84
85    elm_run();
86    return 0;
87 }
88 ELM_MAIN()