General (top-level) functions example
/* Compile with:
* gcc -g general_funcs_example.c -o general_funcs_example `pkg-config --cflags --libs elementary`
*/
#include <Elementary.h>
#define BIN_DIR "/usr/bin"
#define LIB_DIR "/usr/lib"
#define DATA_DIR "/usr/local/share/elementary"
#define WIDTH 300
#define HEIGHT 300
struct test_data
{
Evas_Object *btn;
Eina_Bool btn_enabled;
Eina_Bool btn_gets_focus;
};
struct test_data d = {NULL, EINA_TRUE, EINA_TRUE};
static void
_btn_enabled_cb(void *data EINA_UNUSED,
Evas_Object *obj EINA_UNUSED,
void *event EINA_UNUSED)
{
elm_object_disabled_set(d.btn, !d.btn_enabled);
}
static void
/* focus callback */
_btn_focus_cb(void *data EINA_UNUSED,
Evas_Object *obj EINA_UNUSED,
void *event EINA_UNUSED)
{
elm_object_focus_set(d.btn, EINA_TRUE);
}
static void
/* unfocus callback */
_btn_unfocus_cb(void *data EINA_UNUSED,
Evas_Object *obj EINA_UNUSED,
void *event EINA_UNUSED)
{
elm_object_focus_set(d.btn, EINA_FALSE);
}
static void
/* focus allow callback */
_btn_focus_allow_cb(void *data EINA_UNUSED,
Evas_Object *obj EINA_UNUSED,
void *event EINA_UNUSED)
{
elm_object_focus_allow_set(d.btn, d.btn_gets_focus);
}
static void /* scaling callback */
_btn_scale_cb(void *data EINA_UNUSED,
Evas_Object *obj,
void *event EINA_UNUSED)
{
elm_object_scale_set(d.btn, elm_slider_value_get(obj));
}
EAPI_MAIN int
elm_main(int argc EINA_UNUSED,
char **argv EINA_UNUSED)
{
Evas_Object *win, *box, *frame, *check, *b, *slider;
/* tell elm about our app so it can figure out where to get files */
elm_app_compile_bin_dir_set(BIN_DIR);
elm_app_compile_data_dir_set(DATA_DIR);
elm_app_compile_lib_dir_set(LIB_DIR);
elm_app_info_set(elm_main, "elementary", "images/logo.png");
printf("prefix was set to: %s\n", elm_app_prefix_dir_get());
printf("data directory is: %s\n", elm_app_data_dir_get());
printf("library directory is: %s\n", elm_app_lib_dir_get());
printf("locale directory is: %s\n", elm_app_locale_dir_get());
win = elm_win_util_standard_add("top-level-funcs-example",
"Elementary Top-level Functions Example");
/* by using this policy value, we avoid having to
* evas_object_smart_callback_add(win, "delete,request", _on_exit, NULL),
* calling elm_exit() on that callback ourselves.
*/
elm_policy_set(ELM_POLICY_QUIT, ELM_POLICY_QUIT_LAST_WINDOW_CLOSED);
elm_win_autodel_set(win, EINA_TRUE);
/* outer box */
box = elm_box_add(win);
evas_object_size_hint_weight_set(box, EVAS_HINT_EXPAND, EVAS_HINT_EXPAND);
elm_win_resize_object_add(win, box);
evas_object_show(box);
frame = elm_frame_add(win);
elm_object_text_set(frame, "Button");
evas_object_size_hint_align_set(frame, EVAS_HINT_FILL, EVAS_HINT_FILL);
evas_object_show(frame);
elm_box_pack_end(box, frame);
d.btn = elm_button_add(win);
elm_object_text_set(d.btn, "Click me");
elm_object_content_set(frame, d.btn);
printf("Elementary's finger size is set to %d pixels\n.",
elm_config_finger_size_get());
evas_object_show(d.btn);
b = elm_box_add(win);
elm_box_horizontal_set(b, EINA_FALSE);
evas_object_size_hint_weight_set(b, EVAS_HINT_EXPAND, EVAS_HINT_EXPAND);
elm_box_pack_end(box, b);
evas_object_show(b);
check = elm_check_add(win);
evas_object_size_hint_weight_set(check, EVAS_HINT_EXPAND, EVAS_HINT_EXPAND);
evas_object_size_hint_align_set(check, 0.0, 0.0);
elm_object_text_set(check, "Button enabled");
elm_check_state_pointer_set(check, &d.btn_enabled);
evas_object_smart_callback_add(check, "changed", _btn_enabled_cb, NULL);
elm_box_pack_end(box, check);
evas_object_show(check);
b = elm_button_add(win);
evas_object_size_hint_weight_set(b, EVAS_HINT_EXPAND, EVAS_HINT_EXPAND);
evas_object_size_hint_align_set(b, 0.0, 0.0);
elm_object_text_set(b, "Focus top button");
evas_object_smart_callback_add(b, "clicked", _btn_focus_cb, NULL);
elm_box_pack_end(box, b);
evas_object_show(b);
b = elm_button_add(win);
evas_object_size_hint_weight_set(b, EVAS_HINT_EXPAND, EVAS_HINT_EXPAND);
evas_object_size_hint_align_set(b, 0.0, 0.0);
elm_object_text_set(b, "Unfocus top button");
evas_object_smart_callback_add(b, "clicked", _btn_unfocus_cb, NULL);
elm_box_pack_end(box, b);
evas_object_show(b);
check = elm_check_add(win);
evas_object_size_hint_weight_set(check, EVAS_HINT_EXPAND, EVAS_HINT_EXPAND);
evas_object_size_hint_align_set(check, 0.0, 0.0);
elm_object_text_set(check, "Button gets focus");
elm_check_state_pointer_set(check, &d.btn_gets_focus);
evas_object_smart_callback_add(check, "changed", _btn_focus_allow_cb, NULL);
elm_box_pack_end(box, check);
evas_object_show(check);
slider = elm_slider_add(win);
elm_slider_min_max_set(slider, 0, 4);
elm_slider_unit_format_set(slider, "%1.1f");
elm_slider_indicator_format_set(slider, "%1.1f");
evas_object_size_hint_weight_set(
slider, EVAS_HINT_EXPAND, EVAS_HINT_EXPAND);
evas_object_size_hint_align_set(slider, EVAS_HINT_FILL, EVAS_HINT_FILL);
evas_object_smart_callback_add(slider, "changed", _btn_scale_cb, NULL);
elm_box_pack_end(box, slider);
evas_object_show(slider);
evas_object_resize(win, WIDTH, HEIGHT);
elm_win_focus_highlight_enabled_set(win, EINA_TRUE);
evas_object_show(win);
elm_run(); /* and run the program now, starting to handle all
* events, etc. */
/* exit code */
return 0;
}
ELM_MAIN()
EVAS_HINT_EXPAND
#define EVAS_HINT_EXPAND
Use with evas_object_size_hint_weight_set(), evas_object_size_hint_weight_get(), evas_object_size_hin...
Definition Evas_Common.h:297
EVAS_HINT_FILL
#define EVAS_HINT_FILL
Use with evas_object_size_hint_align_set(), evas_object_size_hint_align_get(), evas_object_size_hint_...
Definition Evas_Common.h:298
EINA_TRUE
#define EINA_TRUE
boolean value TRUE (numerical value 1)
Definition eina_types.h:539
EINA_FALSE
#define EINA_FALSE
boolean value FALSE (numerical value 0)
Definition eina_types.h:533
Eina_Bool
unsigned char Eina_Bool
Type to mimic a boolean.
Definition eina_types.h:527
EINA_UNUSED
#define EINA_UNUSED
Used to indicate that a function parameter is purposely unused.
Definition eina_types.h:339
elm_app_info_set
void elm_app_info_set(void *mainfunc, const char *dom, const char *checkfile)
Re-locate the application somewhere else after compilation, if the developer wishes for easier distri...
Definition elm_main.c:496
elm_app_compile_data_dir_set
void elm_app_compile_data_dir_set(const char *dir)
Provide information on the fallback application's data directory, on scenarios where they get overrid...
Definition elm_main.c:528
elm_app_lib_dir_get
const char * elm_app_lib_dir_get(void)
Get the application's run time libraries prefix directory, as set by elm_app_info_set() and the way (...
Definition elm_main.c:576
elm_app_compile_lib_dir_set
void elm_app_compile_lib_dir_set(const char *dir)
Provide information on the fallback application's libraries directory, on scenarios where they get ov...
Definition elm_main.c:522
elm_app_data_dir_get
const char * elm_app_data_dir_get(void)
Get the application's run time data prefix directory, as set by elm_app_info_set() and the way (envir...
Definition elm_main.c:586
elm_app_locale_dir_get
const char * elm_app_locale_dir_get(void)
Get the application's run time locale prefix directory, as set by elm_app_info_set() and the way (env...
Definition elm_main.c:611
elm_app_compile_bin_dir_set
void elm_app_compile_bin_dir_set(const char *dir)
Provide information on the fallback application's binaries directory, in scenarios where they get ove...
Definition elm_main.c:516
elm_app_prefix_dir_get
const char * elm_app_prefix_dir_get(void)
Get the application's run time prefix directory, as set by elm_app_info_set() and the way (environmen...
Definition elm_main.c:556
elm_box_horizontal_set
void elm_box_horizontal_set(Elm_Box *obj, Eina_Bool horizontal)
Set the horizontal orientation.
Definition elm_box_eo.legacy.c:27
elm_box_add
Evas_Object * elm_box_add(Evas_Object *parent)
Add a new box to the parent.
Definition elm_box.c:363
elm_box_pack_end
void elm_box_pack_end(Elm_Box *obj, Efl_Canvas_Object *subobj)
Add an object at the end of the pack list.
Definition elm_box_eo.legacy.c:57
elm_button_add
Evas_Object * elm_button_add(Evas_Object *parent)
Add a new button to the parent's canvas.
Definition efl_ui_button.c:459
elm_check_add
Evas_Object * elm_check_add(Evas_Object *parent)
Add a new Check object.
Definition efl_ui_check.c:516
elm_check_state_pointer_set
void elm_check_state_pointer_set(Eo *obj, Eina_Bool *statep)
Set a convenience pointer to a boolean to change.
Definition efl_ui_check.c:387
elm_config_finger_size_get
Evas_Coord elm_config_finger_size_get(void)
Get the configured "finger size".
Definition elm_config.c:3683
elm_object_focus_set
void elm_object_focus_set(Evas_Object *obj, Eina_Bool focus)
Set/unset focus to a given Elementary object.
Definition elm_focus_legacy.c:374
elm_object_focus_allow_set
void elm_object_focus_allow_set(Evas_Object *obj, Eina_Bool enable)
Set the ability for an Elementary object to be focused.
Definition elm_main.c:1661
elm_frame_add
Evas_Object * elm_frame_add(Evas_Object *parent)
Add a new frame to the parent.
Definition efl_ui_frame.c:274
ELM_MAIN
#define ELM_MAIN()
macro to be used after the elm_main() function
Definition elm_general.h:556
elm_object_disabled_set
void elm_object_disabled_set(Evas_Object *obj, Eina_Bool disabled)
Set the disabled state of an Elementary object.
Definition elm_main.c:1613
elm_policy_set
Eina_Bool elm_policy_set(unsigned int policy, int value)
Set a new policy's value (for a given policy group/identifier).
Definition elm_main.c:1380
elm_run
void elm_run(void)
Run Elementary's main loop.
Definition elm_main.c:1357
ELM_POLICY_QUIT_LAST_WINDOW_CLOSED
@ ELM_POLICY_QUIT_LAST_WINDOW_CLOSED
quit when the application's last window is closed
Definition elm_general.h:248
ELM_POLICY_QUIT
@ ELM_POLICY_QUIT
under which circumstances the application should quit automatically.
Definition elm_general.h:227
elm_object_scale_set
void elm_object_scale_set(Evas_Object *obj, double scale)
Set the scaling factor for a given Elementary object.
Definition elm_main.c:1470
elm_slider_value_get
double elm_slider_value_get(const Evas_Object *obj)
Get the value displayed by the slider.
Definition elm_slider.c:1531
elm_slider_min_max_set
void elm_slider_min_max_set(Evas_Object *obj, double min, double max)
Set the minimum and maximum values for the slider.
Definition elm_slider.c:1707
elm_slider_add
Evas_Object * elm_slider_add(Evas_Object *parent)
Add a new slider widget to the given parent Elementary (container) object.
Definition elm_slider.c:1437
elm_slider_indicator_format_set
void elm_slider_indicator_format_set(Evas_Object *obj, const char *indicator)
Set the format string for the indicator label.
Definition elm_slider.c:1740
elm_slider_unit_format_set
void elm_slider_unit_format_set(Evas_Object *obj, const char *units)
Set the format string for the unit label.
Definition elm_slider.c:1458
elm_win_util_standard_add
Evas_Object * elm_win_util_standard_add(const char *name, const char *title)
Adds a window object with standard setup.
Definition efl_ui_win.c:9587
elm_win_resize_object_add
void elm_win_resize_object_add(Eo *obj, Evas_Object *subobj)
Add subobj as a resize object of window obj.
Definition efl_ui_win.c:9002
elm_win_autodel_set
void elm_win_autodel_set(Eo *obj, Eina_Bool autodel)
Set the window's autodel state.
Definition efl_ui_win.c:6199
evas_object_show
EVAS_API void evas_object_show(Evas_Object *eo_obj)
Makes the given Evas object visible.
Definition evas_object_main.c:1814
evas_object_size_hint_weight_set
EVAS_API void evas_object_size_hint_weight_set(Evas_Object *obj, double x, double y)
Sets the hints for an object's weight.
Definition evas_object_main.c:2638
evas_object_size_hint_align_set
EVAS_API void evas_object_size_hint_align_set(Evas_Object *obj, double x, double y)
Sets the hints for an object's alignment.
Definition evas_object_main.c:2650
Evas_Object
Efl_Canvas_Object Evas_Object
An Evas Object handle.
Definition Evas_Common.h:185
evas_object_resize
EVAS_API void evas_object_resize(Evas_Object *obj, Evas_Coord w, Evas_Coord h)
Changes the size of the given Evas object.
Definition evas_object_main.c:1236
evas_object_smart_callback_add
EVAS_API void evas_object_smart_callback_add(Evas_Object *eo_obj, const char *event, Evas_Smart_Cb func, const void *data)
Add (register) a callback function to the smart event specified by event on the smart object obj.
Definition evas_object_smart.c:1040