src/lib/Elementary.h.in

   1 /*
   2  *
   3  * vim:ts=8:sw=3:sts=3:expandtab:cino=>5n-3f0^-2{2(0W1st0
   4  */
   5 #ifndef ELEMENTARY_H
   6 #define ELEMENTARY_H
   7
   8 /**
   9  * @file Elementary.h
  10  * @brief Elementary's API
  11  *
  12  * Elementary API.
  13  */
  14
  15 @ELM_UNIX_DEF@ ELM_UNIX
  16 @ELM_WIN32_DEF@ ELM_WIN32
  17 @ELM_WINCE_DEF@ ELM_WINCE
  18 @ELM_EDBUS_DEF@ ELM_EDBUS
  19 @ELM_EFREET_DEF@ ELM_EFREET
  20 @ELM_ETHUMB_DEF@ ELM_ETHUMB
  21 @ELM_DEBUG_DEF@ ELM_DEBUG
  22 @ELM_ALLOCA_H_DEF@ ELM_ALLOCA_H
  23 @ELM_LIBINTL_H_DEF@ ELM_LIBINTL_H
  24
  25 /* Standard headers for standard system calls etc. */
  26 #include <stdio.h>
  27 #include <stdlib.h>
  28 #include <unistd.h>
  29 #include <string.h>
  30 #include <sys/types.h>
  31 #include <sys/stat.h>
  32 #include <sys/time.h>
  33 #include <sys/param.h>
  34 #include <dlfcn.h>
  35 #include <math.h>
  36 #include <fnmatch.h>
  37 #include <limits.h>
  38 #include <ctype.h>
  39 #include <time.h>
  40 #include <dirent.h>
  41 #include <pwd.h>
  42 #include <errno.h>
  43
  44 #ifdef ELM_UNIX
  45 # include <locale.h>
  46 # ifdef ELM_LIBINTL_H
  47 #  include <libintl.h>
  48 # endif
  49 # include <signal.h>
  50 # include <grp.h>
  51 # include <glob.h>
  52 #endif
  53
  54 #ifdef ELM_ALLOCA_H
  55 # include <alloca.h>
  56 #endif
  57
  58 #if defined (ELM_WIN32) || defined (ELM_WINCE)
  59 # include <malloc.h>
  60 # ifndef alloca
  61 #  define alloca _alloca
  62 # endif
  63 #endif
  64
  65
  66 /* EFL headers */
  67 #include <Eina.h>
  68 #include <Eet.h>
  69 #include <Evas.h>
  70 #include <Ecore.h>
  71 #include <Ecore_Evas.h>
  72 #include <Ecore_File.h>
  73 #include <Ecore_IMF.h>
  74 #include <Edje.h>
  75
  76 #ifdef ELM_EDBUS
  77 # include <E_DBus.h>
  78 # include <E_Hal.h>
  79 #endif
  80
  81 #ifdef ELM_EFREET
  82 # include <Efreet.h>
  83 # include <Efreet_Mime.h>
  84 # include <Efreet_Trash.h>
  85 #endif
  86
  87 #ifdef ELM_ETHUMB
  88 # include <Ethumb_Client.h>
  89 #endif
  90
  91 #ifdef EAPI
  92 # undef EAPI
  93 #endif
  94
  95 #ifdef _WIN32
  96 # ifdef ELEMENTARY_BUILD
  97 #  ifdef DLL_EXPORT
  98 #   define EAPI __declspec(dllexport)
  99 #  else
 100 #   define EAPI
 101 #  endif /* ! DLL_EXPORT */
 102 # else
 103 #  define EAPI __declspec(dllimport)
 104 # endif /* ! EFL_EVAS_BUILD */
 105 #else
 106 # ifdef __GNUC__
 107 #  if __GNUC__ >= 4
 108 #   define EAPI __attribute__ ((visibility("default")))
 109 #  else
 110 #   define EAPI
 111 #  endif
 112 # else
 113 #  define EAPI
 114 # endif
 115 #endif /* ! _WIN32 */
 116
 117
 118 /* allow usage from c++ */
 119 #ifdef __cplusplus
 120 extern "C" {
 121 #endif
 122
 123 #define ELM_VERSION_MAJOR @VMAJ@
 124 #define ELM_VERSION_MINOR @VMIN@
 125
 126    typedef struct _Elm_Version
 127      {
 128         int major;
 129         int minor;
 130         int micro;
 131         int revision;
 132      } Elm_Version;
 133
 134    EAPI extern Elm_Version *elm_version;
 135
 136 /* handy macros */
 137 #define ELM_RECTS_INTERSECT(x, y, w, h, xx, yy, ww, hh) (((x) < ((xx) + (ww))) && ((y) < ((yy) + (hh))) && (((x) + (w)) > (xx)) && (((y) + (h)) > (yy)))
 138 #define ELM_PI 3.14159265358979323846
 139
 140   /**
 141    * Defines couple of standard Evas_Object layers to be used
 142    * with evas_object_layer_set().
 143    *
 144    * @note whenever extending with new values, try to keep some padding
 145    *       to siblings so there is room for further extensions.
 146    */
 147   typedef enum _Elm_Object_Layer
 148     {
 149        ELM_OBJECT_LAYER_BACKGROUND = EVAS_LAYER_MIN + 64, /**< where to place backgrounds */
 150        ELM_OBJECT_LAYER_DEFAULT = 0, /**< Evas_Object default layer (and thus for Elementary) */
 151        ELM_OBJECT_LAYER_FOCUS = EVAS_LAYER_MAX - 128, /**< where focus object visualization is */
 152        ELM_OBJECT_LAYER_TOOLTIP = EVAS_LAYER_MAX - 64, /**< where to show tooltips */
 153        ELM_OBJECT_LAYER_CURSOR = EVAS_LAYER_MAX - 32, /**< where to show cursors */
 154        ELM_OBJECT_LAYER_LAST /**< last layer known by Elementary */
 155     } Elm_Object_Layer;
 156
 157 /**************************************************************************/
 158    EAPI extern int ELM_ECORE_EVENT_ETHUMB_CONNECT;
 159
 160    /* Objects */
 161    /**
 162     * Emitted when policy value changed.
 163     */
 164    EAPI extern int ELM_EVENT_POLICY_CHANGED;
 165    typedef struct _Elm_Event_Policy_Changed
 166      {
 167         unsigned int policy;
 168         int          new_value;
 169         int          old_value;
 170      } Elm_Event_Policy_Changed;
 171
 172    /**
 173     * Policy identifiers.
 174     *
 175     * @see elm_policy_set()
 176     */
 177    typedef enum _Elm_Policy
 178      {
 179         ELM_POLICY_QUIT, /**< when should quit application automatically.
 180                           * @see Elm_Policy_Quit.
 181                           */
 182         ELM_POLICY_LAST
 183      } Elm_Policy;
 184
 185    typedef enum _Elm_Policy_Quit
 186      {
 187         ELM_POLICY_QUIT_NONE = 0, /**< never quit application automatically */
 188         ELM_POLICY_QUIT_LAST_WINDOW_CLOSED /**< quit when last window is closed */
 189      } Elm_Policy_Quit;
 190
 191    typedef enum _Elm_Focus_Direction
 192      {
 193         ELM_FOCUS_PREVIOUS,
 194         ELM_FOCUS_NEXT
 195      } Elm_Focus_Direction;
 196
 197    typedef enum _Elm_Text_Format
 198      {
 199         ELM_TEXT_FORMAT_PLAIN_UTF8,
 200         ELM_TEXT_FORMAT_MARKUP_UTF8
 201      } Elm_Text_Format;
 202
 203    /**
 204     * Called back when a widget's tooltip is activated and needs content.
 205     * @param data user-data given to elm_object_tooltip_content_cb_set()
 206     * @param obj owner widget.
 207     */
 208    typedef Evas_Object *(*Elm_Tooltip_Content_Cb) (void *data, Evas_Object *obj);
 209
 210    /**
 211     * Called back when a widget's item tooltip is activated and needs content.
 212     * @param data user-data given to elm_object_tooltip_content_cb_set()
 213     * @param obj owner widget.
 214     * @param item context dependent item. As an example, if tooltip was
 215     *        set on Elm_List_Item, then it is of this type.
 216     */
 217    typedef Evas_Object *(*Elm_Tooltip_Item_Content_Cb) (void *data, Evas_Object *obj, void *item);
 218
 219    typedef Eina_Bool (*Elm_Event_Cb) (void *data, Evas_Object *obj, Evas_Object *src, Evas_Callback_Type type, void *event_info);
 220
 221 #ifndef ELM_LIB_QUICKLAUNCH
 222 #define ELM_MAIN() int main(int argc, char **argv) {elm_init(argc, argv); return elm_main(argc, argv);}
 223 #else
 224 #define ELM_MAIN() int main(int argc, char **argv) {return elm_quicklaunch_fallback(argc, argv);}
 225 #endif
 226
 227 /**************************************************************************/
 228    /* General calls */
 229    EAPI int          elm_init(int argc, char **argv);
 230    EAPI int          elm_shutdown(void);
 231    EAPI void         elm_run(void);
 232    EAPI void         elm_exit(void);
 233
 234    EAPI void         elm_quicklaunch_mode_set(Eina_Bool ql_on);
 235    EAPI Eina_Bool    elm_quicklaunch_mode_get(void);
 236    EAPI int          elm_quicklaunch_init(int argc, char **argv);
 237    EAPI int          elm_quicklaunch_sub_init(int argc, char **argv);
 238    EAPI int          elm_quicklaunch_sub_shutdown(void);
 239    EAPI int          elm_quicklaunch_shutdown(void);
 240    EAPI void         elm_quicklaunch_seed(void);
 241    EAPI Eina_Bool    elm_quicklaunch_prepare(int argc, char **argv);
 242    EAPI Eina_Bool    elm_quicklaunch_fork(int argc, char **argv, char *cwd, void (postfork_func) (void *data), void *postfork_data);
 243    EAPI void         elm_quicklaunch_cleanup(void);
 244    EAPI int          elm_quicklaunch_fallback(int argc, char **argv);
 245    EAPI char        *elm_quicklaunch_exe_path_get(const char *exe);
 246
 247    EAPI Eina_Bool    elm_need_efreet(void);
 248    EAPI Eina_Bool    elm_need_e_dbus(void);
 249    EAPI Eina_Bool    elm_need_ethumb(void);
 250
 251    EAPI Eina_Bool    elm_policy_set(unsigned int policy, int value);
 252    EAPI int          elm_policy_get(unsigned int policy);
 253
 254    EAPI void         elm_all_flush(void);
 255    EAPI int          elm_cache_flush_interval_get(void);
 256    EAPI void         elm_cache_flush_interval_set(int size);
 257    EAPI void         elm_cache_flush_interval_all_set(int size);
 258    EAPI Eina_Bool    elm_cache_flush_enabled_get(void);
 259    EAPI void         elm_cache_flush_enabled_set(Eina_Bool enabled);
 260    EAPI void         elm_cache_flush_enabled_all_set(Eina_Bool enabled);
 261    EAPI int          elm_font_cache_get(void);
 262    EAPI void         elm_font_cache_set(int size);
 263    EAPI void         elm_font_cache_all_set(int size);
 264    EAPI int          elm_image_cache_get(void);
 265    EAPI void         elm_image_cache_set(int size);
 266    EAPI void         elm_image_cache_all_set(int size);
 267    EAPI int          elm_edje_file_cache_get(void);
 268    EAPI void         elm_edje_file_cache_set(int size);
 269    EAPI void         elm_edje_file_cache_all_set(int size);
 270    EAPI int          elm_edje_collection_cache_get(void);
 271    EAPI void         elm_edje_collection_cache_set(int size);
 272    EAPI void         elm_edje_collection_cache_all_set(int size);
 273
 274    EAPI void         elm_object_scale_set(Evas_Object *obj, double scale) EINA_ARG_NONNULL(1);
 275    EAPI double       elm_object_scale_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 276    EAPI Eina_Bool    elm_object_mirrored_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 277    EAPI void         elm_object_mirrored_set(Evas_Object *obj, Eina_Bool mirrored) EINA_ARG_NONNULL(1);
 278    EAPI Eina_Bool    elm_object_mirrored_automatic_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 279    EAPI void         elm_object_mirrored_automatic_set(Evas_Object *obj, Eina_Bool automatic) EINA_ARG_NONNULL(1);
 280    EAPI void         elm_object_style_set(Evas_Object *obj, const char *style) EINA_ARG_NONNULL(1);
 281    EAPI const char  *elm_object_style_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 282    EAPI void         elm_object_disabled_set(Evas_Object *obj, Eina_Bool disabled) EINA_ARG_NONNULL(1);
 283    EAPI Eina_Bool    elm_object_disabled_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 284
 285    EAPI Eina_Bool    elm_object_widget_check(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 286    EAPI Evas_Object *elm_object_parent_widget_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 287    EAPI Evas_Object *elm_object_top_widget_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 288    EAPI const char  *elm_object_widget_type_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 289
 290    EAPI double       elm_scale_get(void);
 291    EAPI void         elm_scale_set(double scale);
 292    EAPI void         elm_scale_all_set(double scale);
 293
 294    EAPI Eina_Bool    elm_mirrored_get(void);
 295    EAPI void         elm_mirrored_set(Eina_Bool mirrored);
 296
 297    EAPI Eina_Bool    elm_config_save(void);
 298    EAPI void         elm_config_reload(void);
 299
 300    EAPI const char  *elm_profile_current_get(void);
 301    EAPI const char  *elm_profile_dir_get(const char *profile, Eina_Bool is_user);
 302    EAPI void         elm_profile_dir_free(const char *p_dir);
 303    EAPI Eina_List   *elm_profile_list_get(void);
 304    EAPI void         elm_profile_list_free(Eina_List *l);
 305    EAPI void         elm_profile_set(const char *profile);
 306    EAPI void         elm_profile_all_set(const char *profile);
 307
 308    EAPI const char  *elm_engine_current_get(void);
 309    EAPI void         elm_engine_set(const char *engine);
 310
 311   typedef struct _Elm_Text_Class
 312     {
 313        const char *name;
 314        const char *desc;
 315     } Elm_Text_Class;
 316
 317   typedef struct _Elm_Font_Overlay
 318     {
 319        const char     *text_class;
 320        const char     *font;
 321        Evas_Font_Size  size;
 322     } Elm_Font_Overlay;
 323
 324   typedef struct _Elm_Font_Properties
 325     {
 326        const char *name;
 327        Eina_List  *styles;
 328     } Elm_Font_Properties;
 329
 330    EAPI const Eina_List     *elm_text_classes_list_get(void);
 331    EAPI void                 elm_text_classes_list_free(const Eina_List *list);
 332
 333    EAPI const Eina_List     *elm_font_overlay_list_get(void);
 334    EAPI void                 elm_font_overlay_set(const char *text_class, const char *font, Evas_Font_Size size);
 335    EAPI void                 elm_font_overlay_unset(const char *text_class);
 336    EAPI void                 elm_font_overlay_apply(void);
 337    EAPI void                 elm_font_overlay_all_apply(void);
 338
 339    EAPI Elm_Font_Properties *elm_font_properties_get(const char *font) EINA_ARG_NONNULL(1);
 340    EAPI void                 elm_font_properties_free(Elm_Font_Properties *efp) EINA_ARG_NONNULL(1);
 341    EAPI const char          *elm_font_fontconfig_name_get(const char *name, const char *style) EINA_ARG_NONNULL(1);
 342    EAPI void                 elm_font_fontconfig_name_free(const char *name) EINA_ARG_NONNULL(1);
 343    EAPI Eina_Hash           *elm_font_available_hash_add(Eina_List *list);
 344    EAPI void                 elm_font_available_hash_del(Eina_Hash *hash);
 345
 346    EAPI Evas_Coord       elm_finger_size_get(void);
 347    EAPI void             elm_finger_size_set(Evas_Coord size);
 348    EAPI void             elm_finger_size_all_set(Evas_Coord size);
 349
 350    EAPI Eina_Bool        elm_focus_highlight_enabled_get(void);
 351    EAPI void             elm_focus_highlight_enabled_set(Eina_Bool enable);
 352    EAPI Eina_Bool        elm_focus_highlight_animate_get(void);
 353    EAPI void             elm_focus_highlight_animate_set(Eina_Bool animate);
 354
 355    EAPI Eina_Bool        elm_object_focus_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 356    EAPI void             elm_object_focus(Evas_Object *obj) EINA_ARG_NONNULL(1);
 357    EAPI void             elm_object_unfocus(Evas_Object *obj) EINA_ARG_NONNULL(1);
 358    EAPI void             elm_object_focus_allow_set(Evas_Object *obj, Eina_Bool enable) EINA_ARG_NONNULL(1);
 359    EAPI Eina_Bool        elm_object_focus_allow_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 360
 361    EAPI void             elm_object_focus_custom_chain_set(Evas_Object *obj, Eina_List *objs) EINA_ARG_NONNULL(1);
 362    EAPI void             elm_object_focus_custom_chain_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
 363    EAPI const Eina_List *elm_object_focus_custom_chain_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 364    EAPI void             elm_object_focus_custom_chain_append(Evas_Object *obj, Evas_Object *child, Evas_Object *relative_child) EINA_ARG_NONNULL(1, 2);
 365    EAPI void             elm_object_focus_custom_chain_prepend(Evas_Object *obj, Evas_Object *child, Evas_Object *relative_child) EINA_ARG_NONNULL(1, 2);
 366    EAPI void             elm_object_focus_cycle(Evas_Object *obj, Elm_Focus_Direction dir) EINA_ARG_NONNULL(1);
 367    EAPI void             elm_object_focus_direction_go(Evas_Object *obj, int x, int y) EINA_ARG_NONNULL(1);
 368
 369    EAPI Eina_Bool        elm_scroll_bounce_enabled_get(void);
 370    EAPI void             elm_scroll_bounce_enabled_set(Eina_Bool enabled);
 371    EAPI void             elm_scroll_bounce_enabled_all_set(Eina_Bool enabled);
 372    EAPI double           elm_scroll_bounce_friction_get(void);
 373    EAPI void             elm_scroll_bounce_friction_set(double friction);
 374    EAPI void             elm_scroll_bounce_friction_all_set(double friction);
 375    EAPI double           elm_scroll_page_scroll_friction_get(void);
 376    EAPI void             elm_scroll_page_scroll_friction_set(double friction);
 377    EAPI void             elm_scroll_page_scroll_friction_all_set(double friction);
 378    EAPI double           elm_scroll_bring_in_scroll_friction_get(void);
 379    EAPI void             elm_scroll_bring_in_scroll_friction_set(double friction);
 380    EAPI void             elm_scroll_bring_in_scroll_friction_all_set(double friction);
 381    EAPI double           elm_scroll_zoom_friction_get(void);
 382    EAPI void             elm_scroll_zoom_friction_set(double friction);
 383    EAPI void             elm_scroll_zoom_friction_all_set(double friction);
 384    EAPI Eina_Bool        elm_scroll_thumbscroll_enabled_get(void);
 385    EAPI void             elm_scroll_thumbscroll_enabled_set(Eina_Bool enabled);
 386    EAPI void             elm_scroll_thumbscroll_enabled_all_set(Eina_Bool enabled);
 387    EAPI unsigned int     elm_scroll_thumbscroll_threshold_get(void);
 388    EAPI void             elm_scroll_thumbscroll_threshold_set(unsigned int threshold);
 389    EAPI void             elm_scroll_thumbscroll_threshold_all_set(unsigned int threshold);
 390    EAPI double           elm_scroll_thumbscroll_momentum_threshold_get(void);
 391    EAPI void             elm_scroll_thumbscroll_momentum_threshold_set(double threshold);
 392    EAPI void             elm_scroll_thumbscroll_momentum_threshold_all_set(double threshold);
 393    EAPI double           elm_scroll_thumbscroll_friction_get(void);
 394    EAPI void             elm_scroll_thumbscroll_friction_set(double friction);
 395    EAPI void             elm_scroll_thumbscroll_friction_all_set(double friction);
 396    EAPI double           elm_scroll_thumbscroll_border_friction_get(void);
 397    EAPI void             elm_scroll_thumbscroll_border_friction_set(double friction);
 398    EAPI void             elm_scroll_thumbscroll_border_friction_all_set(double friction);
 399
 400    EAPI void             elm_object_scroll_hold_push(Evas_Object *obj) EINA_ARG_NONNULL(1);
 401    EAPI void             elm_object_scroll_hold_pop(Evas_Object *obj) EINA_ARG_NONNULL(1);
 402    EAPI void             elm_object_scroll_freeze_push(Evas_Object *obj) EINA_ARG_NONNULL(1);
 403    EAPI void             elm_object_scroll_freeze_pop(Evas_Object *obj) EINA_ARG_NONNULL(1);
 404    EAPI void             elm_object_scroll_lock_x_set(Evas_Object *obj, Eina_Bool lock) EINA_ARG_NONNULL(1);
 405    EAPI void             elm_object_scroll_lock_y_set(Evas_Object *obj, Eina_Bool lock) EINA_ARG_NONNULL(1);
 406    EAPI Eina_Bool        elm_object_scroll_lock_x_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 407    EAPI Eina_Bool        elm_object_scroll_lock_y_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 408
 409    EAPI void             elm_object_signal_emit(Evas_Object *obj, const char *emission, const char *source) EINA_ARG_NONNULL(1);
 410    EAPI void             elm_object_signal_callback_add(Evas_Object *obj, const char *emission, const char *source, void (*func) (void *data, Evas_Object *o, const char *emission, const char *source), void *data) EINA_ARG_NONNULL(1, 4);
 411    EAPI void            *elm_object_signal_callback_del(Evas_Object *obj, const char *emission, const char *source, void (*func) (void *data, Evas_Object *o, const char *emission, const char *source)) EINA_ARG_NONNULL(1, 4);
 412
 413    EAPI void             elm_object_event_callback_add(Evas_Object *obj, Elm_Event_Cb func, const void *data) EINA_ARG_NONNULL(1, 2);
 414    EAPI void            *elm_object_event_callback_del(Evas_Object *obj, Elm_Event_Cb func, const void *data) EINA_ARG_NONNULL(1, 2);
 415
 416    EAPI void             elm_coords_finger_size_adjust(int times_w, Evas_Coord *w, int times_h, Evas_Coord *h);
 417
 418    EAPI double           elm_longpress_timeout_get(void);
 419    EAPI void             elm_longpress_timeout_set(double longpress_timeout);
 420
 421    /* debug
 422     * don't use it unless you are sure
 423     */
 424    EAPI void             elm_object_tree_dump(const Evas_Object *top);
 425    EAPI void             elm_object_tree_dot_dump(const Evas_Object *top, const char *file);
 426
 427    EAPI void             elm_autocapitalization_allow_all_set(Eina_Bool autocap);
 428    EAPI void             elm_autoperiod_allow_all_set(Eina_Bool autoperiod);
 429
 430    /* theme */
 431    typedef struct _Elm_Theme Elm_Theme;
 432
 433    EAPI Elm_Theme       *elm_theme_new(void);
 434    EAPI void             elm_theme_free(Elm_Theme *th);
 435    EAPI void             elm_theme_copy(Elm_Theme *th, Elm_Theme *thdst);
 436    EAPI void             elm_theme_ref_set(Elm_Theme *th, Elm_Theme *thref);
 437    EAPI Elm_Theme       *elm_theme_ref_get(Elm_Theme *th);
 438    EAPI Elm_Theme       *elm_theme_default_get(void);
 439    EAPI void             elm_theme_overlay_add(Elm_Theme *th, const char *item);
 440    EAPI void             elm_theme_overlay_del(Elm_Theme *th, const char *item);
 441    EAPI void             elm_theme_extension_add(Elm_Theme *th, const char *item);
 442    EAPI void             elm_theme_extension_del(Elm_Theme *th, const char *item);
 443    EAPI void             elm_theme_set(Elm_Theme *th, const char *theme);
 444    EAPI const char      *elm_theme_get(Elm_Theme *th);
 445    EAPI const Eina_List *elm_theme_list_get(const Elm_Theme *th);
 446    EAPI char            *elm_theme_list_item_path_get(const char *f, Eina_Bool *in_search_path);
 447    EAPI void             elm_theme_flush(Elm_Theme *th);
 448    EAPI void             elm_theme_full_flush(void);
 449
 450    EAPI void             elm_theme_all_set(const char *theme);
 451
 452    EAPI Eina_List       *elm_theme_name_available_list_new(void);
 453    EAPI void             elm_theme_name_available_list_free(Eina_List *list);
 454
 455    EAPI void             elm_object_theme_set(Evas_Object *obj, Elm_Theme *th) EINA_ARG_NONNULL(1);
 456    EAPI Elm_Theme       *elm_object_theme_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 457
 458    /* win */
 459    typedef enum _Elm_Win_Type
 460      {
 461         ELM_WIN_BASIC,
 462         ELM_WIN_DIALOG_BASIC,
 463         ELM_WIN_DESKTOP,
 464         ELM_WIN_DOCK,
 465         ELM_WIN_TOOLBAR,
 466         ELM_WIN_MENU,
 467         ELM_WIN_UTILITY,
 468         ELM_WIN_SPLASH,
 469         ELM_WIN_DROPDOWN_MENU,
 470         ELM_WIN_POPUP_MENU,
 471         ELM_WIN_TOOLTIP,
 472         ELM_WIN_NOTIFICATION,
 473         ELM_WIN_COMBO,
 474         ELM_WIN_DND
 475      } Elm_Win_Type;
 476
 477    typedef enum _Elm_Win_Keyboard_Mode
 478      {
 479         ELM_WIN_KEYBOARD_UNKNOWN,
 480         ELM_WIN_KEYBOARD_OFF,
 481         ELM_WIN_KEYBOARD_ON,
 482         ELM_WIN_KEYBOARD_ALPHA,
 483         ELM_WIN_KEYBOARD_NUMERIC,
 484         ELM_WIN_KEYBOARD_PIN,
 485         ELM_WIN_KEYBOARD_PHONE_NUMBER,
 486         ELM_WIN_KEYBOARD_HEX,
 487         ELM_WIN_KEYBOARD_TERMINAL,
 488         ELM_WIN_KEYBOARD_PASSWORD,
 489         ELM_WIN_KEYBOARD_IP,
 490         ELM_WIN_KEYBOARD_HOST,
 491         ELM_WIN_KEYBOARD_FILE,
 492         ELM_WIN_KEYBOARD_URL,
 493         ELM_WIN_KEYBOARD_KEYPAD,
 494         ELM_WIN_KEYBOARD_J2ME
 495      } Elm_Win_Keyboard_Mode;
 496
 497    typedef enum _Elm_Illume_Command
 498      {
 499         ELM_ILLUME_COMMAND_FOCUS_BACK,
 500         ELM_ILLUME_COMMAND_FOCUS_FORWARD,
 501         ELM_ILLUME_COMMAND_FOCUS_HOME,
 502         ELM_ILLUME_COMMAND_CLOSE
 503      } Elm_Illume_Command;
 504
 505    EAPI Evas_Object *elm_win_add(Evas_Object *parent, const char *name, Elm_Win_Type type);
 506    EAPI void         elm_win_resize_object_add(Evas_Object *obj, Evas_Object *subobj) EINA_ARG_NONNULL(1);
 507    EAPI void         elm_win_resize_object_del(Evas_Object *obj, Evas_Object *subobj) EINA_ARG_NONNULL(1);
 508    EAPI void         elm_win_title_set(Evas_Object *obj, const char *title) EINA_ARG_NONNULL(1);
 509    EAPI const char  *elm_win_title_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 510    EAPI void         elm_win_autodel_set(Evas_Object *obj, Eina_Bool autodel) EINA_ARG_NONNULL(1);
 511    EAPI Eina_Bool    elm_win_autodel_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 512    EAPI void         elm_win_activate(Evas_Object *obj) EINA_ARG_NONNULL(1);
 513    EAPI void         elm_win_lower(Evas_Object *obj) EINA_ARG_NONNULL(1);
 514    EAPI void         elm_win_raise(Evas_Object *obj) EINA_ARG_NONNULL(1);
 515    EAPI void         elm_win_borderless_set(Evas_Object *obj, Eina_Bool borderless) EINA_ARG_NONNULL(1);
 516    EAPI Eina_Bool    elm_win_borderless_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 517    EAPI void         elm_win_shaped_set(Evas_Object *obj, Eina_Bool shaped) EINA_ARG_NONNULL(1);
 518    EAPI Eina_Bool    elm_win_shaped_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 519    EAPI void         elm_win_alpha_set(Evas_Object *obj, Eina_Bool alpha) EINA_ARG_NONNULL(1);
 520    EAPI Eina_Bool    elm_win_transparent_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 521    EAPI void         elm_win_transparent_set(Evas_Object *obj, Eina_Bool transparent) EINA_ARG_NONNULL(1);
 522    EAPI Eina_Bool    elm_win_alpha_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 523    EAPI void         elm_win_override_set(Evas_Object *obj, Eina_Bool override) EINA_ARG_NONNULL(1);
 524    EAPI Eina_Bool    elm_win_override_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 525    EAPI void         elm_win_fullscreen_set(Evas_Object *obj, Eina_Bool fullscreen) EINA_ARG_NONNULL(1);
 526    EAPI Eina_Bool    elm_win_fullscreen_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 527    EAPI void         elm_win_maximized_set(Evas_Object *obj, Eina_Bool maximized) EINA_ARG_NONNULL(1);
 528    EAPI Eina_Bool    elm_win_maximized_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 529    EAPI void         elm_win_iconified_set(Evas_Object *obj, Eina_Bool iconified) EINA_ARG_NONNULL(1);
 530    EAPI Eina_Bool    elm_win_iconified_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 531    EAPI void         elm_win_layer_set(Evas_Object *obj, int layer) EINA_ARG_NONNULL(1);
 532    EAPI int          elm_win_layer_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 533    EAPI void         elm_win_rotation_set(Evas_Object *obj, int rotation) EINA_ARG_NONNULL(1);
 534    EAPI void         elm_win_rotation_with_resize_set(Evas_Object *obj, int rotation) EINA_ARG_NONNULL(1);
 535    EAPI int          elm_win_rotation_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 536    EAPI void         elm_win_sticky_set(Evas_Object *obj, Eina_Bool sticky) EINA_ARG_NONNULL(1);
 537    EAPI Eina_Bool    elm_win_sticky_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 538    EAPI void         elm_win_conformant_set(Evas_Object *obj, Eina_Bool conformant) EINA_ARG_NONNULL(1);
 539    EAPI Eina_Bool    elm_win_conformant_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 540    EAPI void         elm_win_quickpanel_set(Evas_Object *obj, Eina_Bool quickpanel) EINA_ARG_NONNULL(1);
 541    EAPI Eina_Bool    elm_win_quickpanel_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 542    EAPI void         elm_win_quickpanel_priority_major_set(Evas_Object *obj, int priority) EINA_ARG_NONNULL(1);
 543    EAPI int          elm_win_quickpanel_priority_major_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 544    EAPI void         elm_win_quickpanel_priority_minor_set(Evas_Object *obj, int priority) EINA_ARG_NONNULL(1);
 545    EAPI int          elm_win_quickpanel_priority_minor_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 546    EAPI void         elm_win_quickpanel_zone_set(Evas_Object *obj, int zone) EINA_ARG_NONNULL(1);
 547    EAPI int          elm_win_quickpanel_zone_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 548    EAPI void         elm_win_prop_focus_skip_set(Evas_Object *obj, Eina_Bool skip); EINA_ARG_NONNULL(1);
 549    EAPI void         elm_win_illume_command_send(Evas_Object *obj, Elm_Illume_Command command, void *params); EINA_ARG_NONNULL(1);
 550    EAPI void         elm_win_focus_highlight_enabled_set(Evas_Object *obj, Eina_Bool enabled) EINA_ARG_NONNULL(1);
 551    EAPI Eina_Bool    elm_win_focus_highlight_enabled_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 552    EAPI void         elm_win_focus_highlight_style_set(Evas_Object *obj, const char *style) EINA_ARG_NONNULL(1);
 553    EAPI const char  *elm_win_focus_highlight_style_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 554    EAPI void         elm_win_indicator_state_set(Evas_Object *obj, int show_state);
 555    EAPI int          elm_win_indicator_state_get(Evas_Object *obj);
 556    /*...
 557     * ecore_x_icccm_hints_set -> accepts_focus (add to ecore_evas)
 558     * ecore_x_icccm_hints_set -> window_group (add to ecore_evas)
 559     * ecore_x_icccm_size_pos_hints_set -> request_pos (add to ecore_evas)
 560     * ecore_x_icccm_client_leader_set -> l (add to ecore_evas)
 561     * ecore_x_icccm_window_role_set -> role (add to ecore_evas)
 562     * ecore_x_icccm_transient_for_set -> forwin (add to ecore_evas)
 563     * ecore_x_netwm_window_type_set -> type (add to ecore_evas)
 564     *
 565     * (add to ecore_x) set netwm argb icon! (add to ecore_evas)
 566     * (blank mouse, private mouse obj, defaultmouse)
 567     *
 568     */
 569    EAPI void                  elm_win_keyboard_mode_set(Evas_Object *obj, Elm_Win_Keyboard_Mode mode) EINA_ARG_NONNULL(1);
 570    EAPI Elm_Win_Keyboard_Mode elm_win_keyboard_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 571    EAPI void                  elm_win_keyboard_win_set(Evas_Object *obj, Eina_Bool is_keyboard) EINA_ARG_NONNULL(1);
 572    EAPI Eina_Bool             elm_win_keyboard_win_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 573
 574    EAPI void                  elm_win_screen_position_get(const Evas_Object *obj, int *x, int *y) EINA_ARG_NONNULL(1);
 575
 576    EAPI Evas_Object          *elm_win_inwin_add(Evas_Object *obj) EINA_ARG_NONNULL(1);
 577    EAPI void                  elm_win_inwin_activate(Evas_Object *obj) EINA_ARG_NONNULL(1);
 578    EAPI void                  elm_win_inwin_content_set(Evas_Object *obj, Evas_Object *content) EINA_ARG_NONNULL(1);
 579    EAPI Evas_Object          *elm_win_inwin_content_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 580    EAPI Evas_Object          *elm_win_inwin_content_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
 581    /* available styles:
 582     * default
 583     * minimal
 584     * minimal_vertical
 585     */
 586    /* X specific calls - won't work on non-x engines (return 0) */
 587    EAPI Ecore_X_Window elm_win_xwindow_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 588    /* smart callbacks called:
 589     * "delete,request" - the user requested to delete the window
 590     * "focus,in" - window got focus
 591     * "focus,out" - window lost focus
 592     * "moved" - window that holds the canvas was moved
 593     */
 594
 595    /* bg */
 596    typedef enum _Elm_Bg_Option
 597      {
 598         ELM_BG_OPTION_CENTER,  /**< center the background */
 599         ELM_BG_OPTION_SCALE,   /**< scale the background retaining aspect ratio */
 600         ELM_BG_OPTION_STRETCH, /**< stretch the background to fill */
 601         ELM_BG_OPTION_TILE     /**< tile background at its original size */
 602      } Elm_Bg_Option;
 603
 604    EAPI Evas_Object  *elm_bg_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
 605    EAPI void          elm_bg_file_set(Evas_Object *obj, const char *file, const char *group) EINA_ARG_NONNULL(1);
 606    EAPI void          elm_bg_file_get(const Evas_Object *obj, const char **file, const char **group) EINA_ARG_NONNULL(1);
 607    EAPI void          elm_bg_option_set(Evas_Object *obj, Elm_Bg_Option option) EINA_ARG_NONNULL(1);
 608    EAPI Elm_Bg_Option elm_bg_option_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 609    EAPI void          elm_bg_color_set(Evas_Object *obj, int r, int g, int b) EINA_ARG_NONNULL(1);
 610    EAPI void          elm_bg_color_get(const Evas_Object *obj, int *r, int *g, int *b) EINA_ARG_NONNULL(1);
 611    EAPI void          elm_bg_overlay_set(Evas_Object *obj, Evas_Object *overlay) EINA_ARG_NONNULL(1);
 612    EAPI Evas_Object  *elm_bg_overlay_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 613    EAPI Evas_Object  *elm_bg_overlay_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
 614    EAPI void          elm_bg_load_size_set(Evas_Object *obj, Evas_Coord w, Evas_Coord h) EINA_ARG_NONNULL(1);
 615    /* smart callbacks called:
 616     */
 617
 618    /* icon */
 619    typedef enum _Elm_Icon_Lookup_Order
 620      {
 621         ELM_ICON_LOOKUP_FDO_THEME, /**< icon look up order: freedesktop, theme */
 622         ELM_ICON_LOOKUP_THEME_FDO, /**< icon look up order: theme, freedesktop */
 623         ELM_ICON_LOOKUP_FDO,       /**< icon look up order: freedesktop */
 624         ELM_ICON_LOOKUP_THEME      /**< icon look up order: theme */
 625      } Elm_Icon_Lookup_Order;
 626
 627    EAPI Evas_Object          *elm_icon_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
 628    EAPI Eina_Bool             elm_icon_file_set(Evas_Object *obj, const char *file, const char *group) EINA_ARG_NONNULL(1, 2);
 629    EAPI void                  elm_icon_file_get(const Evas_Object *obj, const char **file, const char **group) EINA_ARG_NONNULL(1);
 630    EAPI Eina_Bool             elm_icon_standard_set(Evas_Object *obj, const char *name) EINA_ARG_NONNULL(1);
 631    EAPI const char           *elm_icon_standard_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 632    EAPI void                  elm_icon_smooth_set(Evas_Object *obj, Eina_Bool smooth) EINA_ARG_NONNULL(1);
 633    EAPI Eina_Bool             elm_icon_smooth_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 634    EAPI void                  elm_icon_no_scale_set(Evas_Object *obj, Eina_Bool no_scale) EINA_ARG_NONNULL(1);
 635    EAPI Eina_Bool             elm_icon_no_scale_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 636    EAPI void                  elm_icon_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down) EINA_ARG_NONNULL(1);
 637    EAPI void                  elm_icon_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down) EINA_ARG_NONNULL(1);
 638    EAPI void                  elm_icon_fill_outside_set(Evas_Object *obj, Eina_Bool fill_outside) EINA_ARG_NONNULL(1);
 639    EAPI Eina_Bool             elm_icon_fill_outside_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 640    EAPI void                  elm_icon_prescale_set(Evas_Object *obj, int size) EINA_ARG_NONNULL(1);
 641    EAPI int                   elm_icon_prescale_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 642    EAPI void                  elm_icon_order_lookup_set(Evas_Object *obj, Elm_Icon_Lookup_Order order) EINA_ARG_NONNULL(1);
 643    EAPI Elm_Icon_Lookup_Order elm_icon_order_lookup_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 644    /* smart callbacks called:
 645     * "clicked" - the user clicked the icon
 646     */
 647
 648    /* image */
 649    typedef enum _Elm_Image_Orient
 650      {
 651         ELM_IMAGE_ORIENT_NONE,
 652         ELM_IMAGE_ROTATE_90_CW,
 653         ELM_IMAGE_ROTATE_180_CW,
 654         ELM_IMAGE_ROTATE_90_CCW,
 655         ELM_IMAGE_FLIP_HORIZONTAL,
 656         ELM_IMAGE_FLIP_VERTICAL,
 657         ELM_IMAGE_FLIP_TRANSPOSE,
 658         ELM_IMAGE_FLIP_TRANSVERSE
 659      } Elm_Image_Orient;
 660    EAPI Evas_Object     *elm_image_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
 661    EAPI Eina_Bool        elm_image_file_set(Evas_Object *obj, const char *file, const char *group) EINA_ARG_NONNULL(1, 2);
 662    EAPI void             elm_image_file_get(const Evas_Object *obj, const char **file, const char **group) EINA_ARG_NONNULL(1);
 663    EAPI void             elm_image_smooth_set(Evas_Object *obj, Eina_Bool smooth) EINA_ARG_NONNULL(1);
 664    EAPI Eina_Bool        elm_image_smooth_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 665    EAPI void             elm_image_object_size_get(const Evas_Object *obj, int *w, int *h) EINA_ARG_NONNULL(1);
 666    EAPI void             elm_image_no_scale_set(Evas_Object *obj, Eina_Bool no_scale) EINA_ARG_NONNULL(1);
 667    EAPI Eina_Bool        elm_image_no_scale_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 668    EAPI void             elm_image_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down) EINA_ARG_NONNULL(1);
 669    EAPI void             elm_image_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down) EINA_ARG_NONNULL(1);
 670    EAPI void             elm_image_fill_outside_set(Evas_Object *obj, Eina_Bool fill_outside) EINA_ARG_NONNULL(1);
 671    EAPI Eina_Bool        elm_image_fill_outside_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 672    EAPI void             elm_image_prescale_set(Evas_Object *obj, int size) EINA_ARG_NONNULL(1);
 673    EAPI int              elm_image_prescale_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 674    EAPI void             elm_image_orient_set(Evas_Object *obj, Elm_Image_Orient orient) EINA_ARG_NONNULL(1);
 675    EAPI Elm_Image_Orient elm_image_orient_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 676    EAPI void             elm_image_editable_set(Evas_Object *obj, Eina_Bool set) EINA_ARG_NONNULL(1);
 677    EAPI Eina_Bool        elm_image_editable_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 678    /* smart callbacks called:
 679     * "clicked" - the user clicked the image
 680     */
 681
 682    /* box */
 683    typedef struct _Elm_Box_Transition Elm_Box_Transition;
 684
 685    EAPI Evas_Object        *elm_box_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
 686    EAPI void                elm_box_horizontal_set(Evas_Object *obj, Eina_Bool horizontal) EINA_ARG_NONNULL(1);
 687    EAPI Eina_Bool           elm_box_horizontal_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 688    EAPI void                elm_box_homogenous_set(Evas_Object *obj, Eina_Bool homogenous) EINA_ARG_NONNULL(1);
 689    EAPI Eina_Bool           elm_box_homogenous_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 690    EAPI void                elm_box_extended_mode_set(Evas_Object *obj, Eina_Bool extended) EINA_ARG_NONNULL(1);
 691    EAPI Eina_Bool           elm_box_extended_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 692    EAPI void                elm_box_pack_start(Evas_Object *obj, Evas_Object *subobj) EINA_ARG_NONNULL(1);
 693    EAPI void                elm_box_pack_end(Evas_Object *obj, Evas_Object *subobj) EINA_ARG_NONNULL(1);
 694    EAPI void                elm_box_pack_before(Evas_Object *obj, Evas_Object *subobj, Evas_Object *before) EINA_ARG_NONNULL(1);
 695    EAPI void                elm_box_pack_after(Evas_Object *obj, Evas_Object *subobj, Evas_Object *after) EINA_ARG_NONNULL(1);
 696    EAPI void                elm_box_clear(Evas_Object *obj) EINA_ARG_NONNULL(1);
 697    EAPI void                elm_box_unpack(Evas_Object *obj, Evas_Object *subobj) EINA_ARG_NONNULL(1);
 698    EAPI void                elm_box_unpack_all(Evas_Object *obj) EINA_ARG_NONNULL(1);
 699    EAPI const Eina_List    *elm_box_children_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 700    EAPI void                elm_box_padding_set(Evas_Object *obj, Evas_Coord horizontal, Evas_Coord vertical) EINA_ARG_NONNULL(1);
 701    EAPI void                elm_box_padding_get(const Evas_Object *obj, Evas_Coord *horizontal, Evas_Coord *vertical) EINA_ARG_NONNULL(1);
 702    EAPI void                elm_box_align_set(Evas_Object *obj, double horizontal, double vertical) EINA_ARG_NONNULL(1);
 703    EAPI void                elm_box_align_get(const Evas_Object *obj, double *horizontal, double *vertical) EINA_ARG_NONNULL(1);
 704
 705    EAPI void                elm_box_layout_set(Evas_Object *obj, Evas_Object_Box_Layout cb, const void *data, void (*free_data)(void *data)) EINA_ARG_NONNULL(1);
 706    EAPI void                elm_box_layout_transition(Evas_Object *obj, Evas_Object_Box_Data *priv, void *data);
 707    EAPI Elm_Box_Transition *elm_box_transition_new(const double duration, Evas_Object_Box_Layout start_layout, void *start_layout_data, void(*start_layout_free_data)(void *data), Evas_Object_Box_Layout end_layout, void *end_layout_data, void(*end_layout_free_data)(void *data), void(*transition_end_cb)(void *data), void *transition_end_data) EINA_ARG_NONNULL(2, 5);
 708    EAPI void                elm_box_transition_free(void *data);
 709    /* smart callbacks called:
 710     */
 711    typedef enum
 712      {
 713         UIControlStateDefault,
 714         UIControlStateHighlighted,
 715         UIControlStateDisabled,
 716         UIControlStateFocused,
 717         UIControlStateReserved
 718      } UIControlState;
 719
 720  /* button */
 721    EAPI Evas_Object *elm_button_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
 722    EAPI void         elm_button_label_set(Evas_Object *obj, const char *label) EINA_ARG_NONNULL(1);
 723    EAPI void         elm_button_label_set_for_state(Evas_Object *obj, const char *label, UIControlState state);
 724    EAPI const char  *elm_button_label_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 725    EAPI const char  *elm_button_label_get_for_state(const Evas_Object *obj, UIControlState state);
 726    EAPI void         elm_button_icon_set(Evas_Object *obj, Evas_Object *icon) EINA_ARG_NONNULL(1);
 727    EAPI Evas_Object *elm_button_icon_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 728    EAPI Evas_Object *elm_button_icon_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
 729    EAPI void         elm_button_autorepeat_set(Evas_Object *obj, Eina_Bool on) EINA_ARG_NONNULL(1);
 730    EAPI Eina_Bool    elm_button_autorepeat_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 731    EAPI void         elm_button_autorepeat_initial_timeout_set(Evas_Object *obj, double t) EINA_ARG_NONNULL(1);
 732    EAPI double       elm_button_autorepeat_initial_timeout_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 733    EAPI void         elm_button_autorepeat_gap_timeout_set(Evas_Object *obj, double t) EINA_ARG_NONNULL(1);
 734    EAPI double       elm_button_autorepeat_gap_timeout_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 735    /* available styles:
 736     * default
 737     * anchor
 738     * hoversel_vertical
 739     * hoversel_vertical_entry
 740     */
 741    /* smart callbacks called:
 742     * "clicked" - the user clicked the button
 743     * "repeated" - the user pressed the button without releasing it
 744     * "unpressed" - when the button is unpressed (released)
 745     */
 746
 747    /* fileselector */
 748    EAPI Evas_Object *elm_fileselector_button_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
 749    EAPI void         elm_fileselector_button_label_set(Evas_Object *obj, const char *label) EINA_ARG_NONNULL(1);
 750    EAPI const char  *elm_fileselector_button_label_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 751    EAPI void         elm_fileselector_button_icon_set(Evas_Object *obj, Evas_Object *icon) EINA_ARG_NONNULL(1);
 752    EAPI Evas_Object *elm_fileselector_button_icon_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 753    EAPI Evas_Object *elm_fileselector_button_icon_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
 754    EAPI void         elm_fileselector_button_window_title_set(Evas_Object *obj, const char *title) EINA_ARG_NONNULL(1);
 755    EAPI const char  *elm_fileselector_button_window_title_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 756    EAPI void         elm_fileselector_button_window_size_set(Evas_Object *obj, Evas_Coord width, Evas_Coord height) EINA_ARG_NONNULL(1);
 757    EAPI void         elm_fileselector_button_window_size_get(const Evas_Object *obj, Evas_Coord *width, Evas_Coord *height) EINA_ARG_NONNULL(1);
 758    EAPI void         elm_fileselector_button_path_set(Evas_Object *obj, const char *path) EINA_ARG_NONNULL(1);
 759    EAPI const char  *elm_fileselector_button_path_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 760    EAPI void         elm_fileselector_button_expandable_set(Evas_Object *obj, Eina_Bool value) EINA_ARG_NONNULL(1);
 761    EAPI Eina_Bool    elm_fileselector_button_expandable_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 762    EAPI void         elm_fileselector_button_folder_only_set(Evas_Object *obj, Eina_Bool value) EINA_ARG_NONNULL(1);
 763    EAPI Eina_Bool    elm_fileselector_button_folder_only_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 764    EAPI void         elm_fileselector_button_is_save_set(Evas_Object *obj, Eina_Bool value) EINA_ARG_NONNULL(1);
 765    EAPI Eina_Bool    elm_fileselector_button_is_save_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 766    EAPI void         elm_fileselector_button_inwin_mode_set(Evas_Object *obj, Eina_Bool value) EINA_ARG_NONNULL(1);
 767    EAPI Eina_Bool    elm_fileselector_button_inwin_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 768    /* available styles:
 769     * default
 770     * anchor
 771     * hoversel_vertical
 772     * hoversel_vertical_entry
 773     */
 774    /* smart callbacks called:
 775     * "file,chosen" - the user has selected a path, whose string pointer comes
 776                       as event info
 777     */
 778
 779    EAPI Evas_Object *elm_fileselector_entry_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
 780    EAPI void         elm_fileselector_entry_button_label_set(Evas_Object *obj, const char *label) EINA_ARG_NONNULL(1);
 781    EAPI const char  *elm_fileselector_entry_button_label_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 782    EAPI void         elm_fileselector_entry_button_icon_set(Evas_Object *obj, Evas_Object *icon) EINA_ARG_NONNULL(1);
 783    EAPI Evas_Object *elm_fileselector_entry_button_icon_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 784    EAPI Evas_Object *elm_fileselector_entry_button_icon_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
 785    EAPI void         elm_fileselector_entry_window_title_set(Evas_Object *obj, const char *title) EINA_ARG_NONNULL(1);
 786    EAPI const char  *elm_fileselector_entry_window_title_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 787    EAPI void         elm_fileselector_entry_window_size_set(Evas_Object *obj, Evas_Coord width, Evas_Coord height) EINA_ARG_NONNULL(1);
 788    EAPI void         elm_fileselector_entry_window_size_get(const Evas_Object *obj, Evas_Coord *width, Evas_Coord *height) EINA_ARG_NONNULL(1);
 789    EAPI void         elm_fileselector_entry_path_set(Evas_Object *obj, const char *path) EINA_ARG_NONNULL(1);
 790    EAPI const char  *elm_fileselector_entry_path_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 791    EAPI void         elm_fileselector_entry_expandable_set(Evas_Object *obj, Eina_Bool value) EINA_ARG_NONNULL(1);
 792    EAPI Eina_Bool    elm_fileselector_entry_expandable_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 793    EAPI void         elm_fileselector_entry_folder_only_set(Evas_Object *obj, Eina_Bool value) EINA_ARG_NONNULL(1);
 794    EAPI Eina_Bool    elm_fileselector_entry_folder_only_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 795    EAPI void         elm_fileselector_entry_is_save_set(Evas_Object *obj, Eina_Bool value) EINA_ARG_NONNULL(1);
 796    EAPI Eina_Bool    elm_fileselector_entry_is_save_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 797    EAPI void         elm_fileselector_entry_inwin_mode_set(Evas_Object *obj, Eina_Bool value) EINA_ARG_NONNULL(1);
 798    EAPI Eina_Bool    elm_fileselector_entry_inwin_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 799    EAPI void         elm_fileselector_entry_selected_set(Evas_Object *obj, const char *path) EINA_ARG_NONNULL(1);
 800    EAPI const char  *elm_fileselector_entry_selected_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 801
 802    /* scroller policy */
 803    typedef enum _Elm_Scroller_Policy
 804      {
 805         ELM_SCROLLER_POLICY_AUTO = 0,
 806         ELM_SCROLLER_POLICY_ON,
 807         ELM_SCROLLER_POLICY_OFF,
 808         ELM_SCROLLER_POLICY_LAST
 809      } Elm_Scroller_Policy;
 810
 811    EAPI Evas_Object *elm_scroller_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
 812    EAPI void         elm_scroller_content_set(Evas_Object *obj, Evas_Object *child) EINA_ARG_NONNULL(1);
 813    EAPI Evas_Object *elm_scroller_content_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 814    EAPI Evas_Object *elm_scroller_content_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
 815    EAPI void         elm_scroller_custom_widget_base_theme_set(Evas_Object *obj, const char *widget, const char *base) EINA_ARG_NONNULL(1, 2, 3);
 816    EAPI void         elm_scroller_content_min_limit(Evas_Object *obj, Eina_Bool w, Eina_Bool h) EINA_ARG_NONNULL(1);
 817    EAPI void         elm_scroller_region_show(Evas_Object *obj, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord h) EINA_ARG_NONNULL(1);
 818    EAPI void         elm_scroller_policy_set(Evas_Object *obj, Elm_Scroller_Policy policy_h, Elm_Scroller_Policy policy_v) EINA_ARG_NONNULL(1);
 819    EAPI void         elm_scroller_policy_get(const Evas_Object *obj, Elm_Scroller_Policy *policy_h, Elm_Scroller_Policy *policy_v) EINA_ARG_NONNULL(1);
 820    EAPI void         elm_scroller_region_get(const Evas_Object *obj, Evas_Coord *x, Evas_Coord *y, Evas_Coord *w, Evas_Coord *h) EINA_ARG_NONNULL(1);
 821    EAPI void         elm_scroller_child_size_get(const Evas_Object *obj, Evas_Coord *w, Evas_Coord *h) EINA_ARG_NONNULL(1);
 822    EAPI void         elm_scroller_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce) EINA_ARG_NONNULL(1);
 823    EAPI void         elm_scroller_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce) EINA_ARG_NONNULL(1);
 824    EAPI void         elm_scroller_page_relative_set(Evas_Object *obj, double h_pagerel, double v_pagerel) EINA_ARG_NONNULL(1);
 825    EAPI void         elm_scroller_page_size_set(Evas_Object *obj, Evas_Coord h_pagesize, Evas_Coord v_pagesize) EINA_ARG_NONNULL(1);
 826    EAPI void         elm_scroller_region_bring_in(Evas_Object *obj, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord h) EINA_ARG_NONNULL(1);
 827    EAPI void         elm_scroller_propagate_events_set(Evas_Object *obj, Eina_Bool propagation);
 828    EAPI Eina_Bool    elm_scroller_propagate_events_get(const Evas_Object *obj);
 829    EINA_DEPRECATED EAPI void         elm_scroller_page_move_set(Evas_Object *obj, Eina_Bool set);
 830    /* smart callbacks called:
 831     * "edge,left" - the left edge of the content has been reached
 832     * "edge,right" - the right edge of the content has been reached
 833     * "edge,top" - the top edge of the content has been reached
 834     * "edge,bottom" - the bottom edge of the content has been reached
 835     * "scroll" - the content has been scrolled (moved)
 836     * "scroll,anim,start" - scrolling animation has started
 837     * "scroll,anim,stop" - scrolling animation has stopped
 838     * "scroll,drag,start" - dragging the contents around has started
 839     * "scroll,drag,stop" - dragging the contents around has stopped
 840     */
 841
 842    /* label */
 843    EAPI Evas_Object *elm_label_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
 844    EAPI void         elm_label_label_set(Evas_Object *obj, const char *label) EINA_ARG_NONNULL(1);
 845    EAPI const char  *elm_label_label_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 846    EAPI void         elm_label_line_wrap_set(Evas_Object *obj, Eina_Bool wrap) EINA_ARG_NONNULL(1);
 847    EAPI Eina_Bool    elm_label_line_wrap_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 848    EAPI void         elm_label_wrap_width_set(Evas_Object *obj, Evas_Coord w) EINA_ARG_NONNULL(1);
 849    EAPI Evas_Coord   elm_label_wrap_width_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 850    EAPI void         elm_label_wrap_height_set(Evas_Object *obj, Evas_Coord h) EINA_ARG_NONNULL(1);
 851    EAPI Evas_Coord   elm_label_wrap_height_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 852    EAPI void         elm_label_fontsize_set(Evas_Object *obj, int fontsize) EINA_ARG_NONNULL(1);
 853    EAPI void         elm_label_text_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a) EINA_ARG_NONNULL(1);
 854    EAPI void         elm_label_text_align_set(Evas_Object *obj, const char *alignmode) EINA_ARG_NONNULL(1);
 855    EAPI void         elm_label_background_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a) EINA_ARG_NONNULL(1);
 856    EAPI void         elm_label_ellipsis_set(Evas_Object *obj, Eina_Bool ellipsis) EINA_ARG_NONNULL(1);
 857    EAPI void         elm_label_wrap_mode_set(Evas_Object *obj, Eina_Bool wrapmode) EINA_ARG_NONNULL(1);
 858    EAPI void         elm_label_slide_set(Evas_Object *obj, Eina_Bool slide) EINA_ARG_NONNULL(1);
 859    EAPI Eina_Bool    elm_label_slide_get(Evas_Object *obj) EINA_ARG_NONNULL(1);
 860    EAPI void         elm_label_slide_duration_set(Evas_Object *obj, int duration) EINA_ARG_NONNULL(1);
 861    EAPI int          elm_label_slide_duration_get(Evas_Object *obj) EINA_ARG_NONNULL(1);
 862    /* available styles:
 863     * default
 864     * marker
 865     */
 866    /* smart callbacks called:
 867     */
 868
 869    /* toggle */
 870    EAPI Evas_Object *elm_toggle_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
 871    EAPI void         elm_toggle_label_set(Evas_Object *obj, const char *label) EINA_ARG_NONNULL(1);
 872    EAPI const char  *elm_toggle_label_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 873    EAPI void         elm_toggle_icon_set(Evas_Object *obj, Evas_Object *icon) EINA_ARG_NONNULL(1);
 874    EAPI Evas_Object *elm_toggle_icon_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 875    EAPI Evas_Object *elm_toggle_icon_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
 876    EAPI void         elm_toggle_states_labels_set(Evas_Object *obj, const char *onlabel, const char *offlabel) EINA_ARG_NONNULL(1);
 877    EAPI void         elm_toggle_states_labels_get(const Evas_Object *obj, const char **onlabel, const char **offlabel) EINA_ARG_NONNULL(1);
 878    EAPI void         elm_toggle_state_set(Evas_Object *obj, Eina_Bool state) EINA_ARG_NONNULL(1);
 879    EAPI Eina_Bool    elm_toggle_state_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 880    EAPI void         elm_toggle_state_pointer_set(Evas_Object *obj, Eina_Bool *statep) EINA_ARG_NONNULL(1);
 881    /* smart callbacks called:
 882     * "changed" - Whenever the toggle value has been changed.  Is not called
 883     *             until the toggle is released by the cursor (assuming it has been triggered
 884     *             by the cursor in the first place).
 885     */
 886
 887    /* frame */
 888    EAPI Evas_Object *elm_frame_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
 889    EAPI void         elm_frame_label_set(Evas_Object *obj, const char *label); EINA_ARG_NONNULL(1)
 890    EAPI const char  *elm_frame_label_get(const Evas_Object *obj); EINA_ARG_NONNULL(1)
 891    EAPI void         elm_frame_content_set(Evas_Object *obj, Evas_Object *content); EINA_ARG_NONNULL(1)
 892    EAPI Evas_Object *elm_frame_content_get(const Evas_Object *obj); EINA_ARG_NONNULL(1)
 893    EAPI Evas_Object *elm_frame_content_unset(Evas_Object *obj); EINA_ARG_NONNULL(1)
 894    /* available styles:
 895     * default
 896     * pad_small
 897     * pad_medium
 898     * pad_large
 899     * pad_huge
 900     * outdent_top
 901     * outdent_bottom
 902     */
 903    /* smart callbacks called:
 904     */
 905
 906    /* table */
 907    EAPI Evas_Object *elm_table_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
 908    EAPI void         elm_table_homogenous_set(Evas_Object *obj, Eina_Bool homogenous) EINA_ARG_NONNULL(1);
 909    EAPI Eina_Bool    elm_table_homogeneous_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 910    EAPI void         elm_table_padding_set(Evas_Object *obj, Evas_Coord horizontal, Evas_Coord vertical) EINA_ARG_NONNULL(1);
 911    EAPI void         elm_table_padding_get(const Evas_Object *obj, Evas_Coord *horizontal, Evas_Coord *vertical) EINA_ARG_NONNULL(1);
 912    EAPI void         elm_table_pack(Evas_Object *obj, Evas_Object *subobj, int x, int y, int w, int h) EINA_ARG_NONNULL(1);
 913    EAPI void         elm_table_unpack(Evas_Object *obj, Evas_Object *subobj) EINA_ARG_NONNULL(1);
 914    EAPI void         elm_table_clear(Evas_Object *obj, Eina_Bool clear) EINA_ARG_NONNULL(1);
 915
 916    /* gengrid */
 917    typedef struct _Elm_Gengrid_Item_Class Elm_Gengrid_Item_Class;
 918    typedef struct _Elm_Gengrid_Item_Class_Func Elm_Gengrid_Item_Class_Func;
 919    typedef struct _Elm_Gengrid_Item Elm_Gengrid_Item; /**< Item of Elm_Gengrid. Sub-type of Elm_Widget_Item */
 920    typedef char        *(*GridItemLabelGetFunc) (void *data, Evas_Object *obj, const char *part);
 921    typedef Evas_Object *(*GridItemIconGetFunc)  (void *data, Evas_Object *obj, const char *part);
 922    typedef Eina_Bool    (*GridItemStateGetFunc) (void *data, Evas_Object *obj, const char *part);
 923    typedef void         (*GridItemDelFunc)      (void *data, Evas_Object *obj);
 924
 925    struct _Elm_Gengrid_Item_Class
 926      {
 927         const char             *item_style;
 928         struct _Elm_Gengrid_Item_Class_Func
 929           {
 930              GridItemLabelGetFunc  label_get;
 931              GridItemIconGetFunc   icon_get;
 932              GridItemStateGetFunc  state_get;
 933              GridItemDelFunc       del;
 934           } func;
 935      };
 936
 937    EAPI Evas_Object       *elm_gengrid_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
 938    EAPI void               elm_gengrid_item_size_set(Evas_Object *obj, Evas_Coord w, Evas_Coord h) EINA_ARG_NONNULL(1);
 939    EAPI void               elm_gengrid_item_size_get(const Evas_Object *obj, Evas_Coord *w, Evas_Coord *h) EINA_ARG_NONNULL(1);
 940    EAPI void               elm_gengrid_align_set(Evas_Object *obj, double align_x, double align_y) EINA_ARG_NONNULL(1);
 941    EAPI void               elm_gengrid_align_get(const Evas_Object *obj, double *align_x, double *align_y) EINA_ARG_NONNULL(1);
 942
 943    EAPI void               elm_gengrid_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select) EINA_ARG_NONNULL(1);
 944    EAPI Eina_Bool          elm_gengrid_always_select_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 945    EAPI void               elm_gengrid_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select) EINA_ARG_NONNULL(1);
 946    EAPI Eina_Bool          elm_gengrid_no_select_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 947    EAPI void               elm_gengrid_multi_select_set(Evas_Object *obj, Eina_Bool multi) EINA_ARG_NONNULL(1);
 948    EAPI Eina_Bool          elm_gengrid_multi_select_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 949    EAPI void               elm_gengrid_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce) EINA_ARG_NONNULL(1);
 950    EAPI void               elm_gengrid_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce) EINA_ARG_NONNULL(1);
 951    EAPI void               elm_gengrid_page_relative_set(Evas_Object *obj, double h_pagerel, double v_pagerel) EINA_ARG_NONNULL(1);
 952    EAPI void               elm_gengrid_page_size_set(Evas_Object *obj, Evas_Coord h_pagesize, Evas_Coord v_pagesize) EINA_ARG_NONNULL(1);
 953    EAPI void               elm_gengrid_horizontal_set(Evas_Object *obj, Eina_Bool setting) EINA_ARG_NONNULL(1);
 954
 955    EAPI Elm_Gengrid_Item  *elm_gengrid_first_item_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 956    EAPI Elm_Gengrid_Item  *elm_gengrid_last_item_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 957
 958    EAPI Elm_Gengrid_Item  *elm_gengrid_item_next_get(const Elm_Gengrid_Item *item) EINA_ARG_NONNULL(1);
 959    EAPI Elm_Gengrid_Item  *elm_gengrid_item_prev_get(const Elm_Gengrid_Item *item) EINA_ARG_NONNULL(1);
 960    EAPI Evas_Object       *elm_gengrid_item_gengrid_get(const Elm_Gengrid_Item *item) EINA_ARG_NONNULL(1);
 961    EAPI void               elm_gengrid_item_del(Elm_Gengrid_Item *item) EINA_ARG_NONNULL(1);
 962    EAPI void               elm_gengrid_item_update(Elm_Gengrid_Item *item) EINA_ARG_NONNULL(1);
 963    EAPI void              *elm_gengrid_item_data_get(const Elm_Gengrid_Item *item) EINA_ARG_NONNULL(1);
 964    EAPI void               elm_gengrid_item_data_set(Elm_Gengrid_Item *item, const void *data) EINA_ARG_NONNULL(1);
 965    EAPI void               elm_gengrid_item_pos_get(const Elm_Gengrid_Item *item, unsigned int *x, unsigned int *y) EINA_ARG_NONNULL(1);
 966    EAPI void               elm_gengrid_item_selected_set(Elm_Gengrid_Item *item, Eina_Bool selected) EINA_ARG_NONNULL(1);
 967    EAPI Eina_Bool          elm_gengrid_item_selected_get(const Elm_Gengrid_Item *item) EINA_ARG_NONNULL(1);
 968    EAPI const Evas_Object *elm_gengrid_item_object_get(const Elm_Gengrid_Item *item) EINA_ARG_NONNULL(1);
 969    EAPI void               elm_gengrid_item_show(Elm_Gengrid_Item *item) EINA_ARG_NONNULL(1);
 970    EAPI void               elm_gengrid_item_bring_in(Elm_Gengrid_Item *item) EINA_ARG_NONNULL(1);
 971    EAPI void               elm_gengrid_item_disabled_set(Elm_Gengrid_Item *item, Eina_Bool disabled) EINA_ARG_NONNULL(1);
 972    EAPI Eina_Bool          elm_gengrid_item_disabled_get(const Elm_Gengrid_Item *item) EINA_ARG_NONNULL(1);
 973
 974    EAPI void               elm_gengrid_item_tooltip_text_set(Elm_Gengrid_Item *item, const char *text) EINA_ARG_NONNULL(1);
 975    EAPI void               elm_gengrid_item_tooltip_content_cb_set(Elm_Gengrid_Item *item, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb) EINA_ARG_NONNULL(1);
 976    EAPI void               elm_gengrid_item_tooltip_unset(Elm_Gengrid_Item *item) EINA_ARG_NONNULL(1);
 977    EAPI void               elm_gengrid_item_tooltip_style_set(Elm_Gengrid_Item *item, const char *style) EINA_ARG_NONNULL(1);
 978    EAPI const char        *elm_gengrid_item_tooltip_style_get(const Elm_Gengrid_Item *item) EINA_ARG_NONNULL(1);
 979    EAPI void               elm_gengrid_item_cursor_set(Elm_Gengrid_Item *item, const char *cursor) EINA_ARG_NONNULL(1);
 980    EAPI const char        *elm_gengrid_item_cursor_get(const Elm_Gengrid_Item *item) EINA_ARG_NONNULL(1);
 981    EAPI void               elm_gengrid_item_cursor_unset(Elm_Gengrid_Item *item) EINA_ARG_NONNULL(1);
 982    EAPI void               elm_gengrid_item_cursor_style_set(Elm_Gengrid_Item *item, const char *style) EINA_ARG_NONNULL(1);
 983    EAPI const char        *elm_gengrid_item_cursor_style_get(const Elm_Gengrid_Item *item) EINA_ARG_NONNULL(1);
 984    EAPI void               elm_gengrid_item_cursor_engine_only_set(Elm_Gengrid_Item *item, Eina_Bool engine_only) EINA_ARG_NONNULL(1);
 985    EAPI Eina_Bool          elm_gengrid_item_cursor_engine_only_get(const Elm_Gengrid_Item *item) EINA_ARG_NONNULL(1);
 986
 987    EAPI void               elm_gengrid_clear(Evas_Object *obj) EINA_ARG_NONNULL(1);
 988    EAPI Elm_Gengrid_Item  *elm_gengrid_selected_item_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 989    EAPI const Eina_List   *elm_gengrid_selected_items_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
 990
 991    EAPI Elm_Gengrid_Item  *elm_gengrid_item_append(Evas_Object *obj, const Elm_Gengrid_Item_Class *gic,  const void *data, Evas_Smart_Cb func, const void *func_data) EINA_ARG_NONNULL(1);
 992    EAPI Elm_Gengrid_Item  *elm_gengrid_item_prepend(Evas_Object *obj, const Elm_Gengrid_Item_Class *gic, const void *data, Evas_Smart_Cb func, const void *func_data) EINA_ARG_NONNULL(1);
 993    EAPI Elm_Gengrid_Item  *elm_gengrid_item_insert_before(Evas_Object *obj, const Elm_Gengrid_Item_Class *gic, const void *data, Elm_Gengrid_Item *relative, Evas_Smart_Cb func, const void *func_data) EINA_ARG_NONNULL(1);
 994    EAPI Elm_Gengrid_Item  *elm_gengrid_item_insert_after(Evas_Object *obj, const Elm_Gengrid_Item_Class *gic, const void *data, Elm_Gengrid_Item *relative, Evas_Smart_Cb func, const void *func_data) EINA_ARG_NONNULL(1);
 995    /* smart callbacks called:
 996     *
 997     * selected - User has selected a item.
 998     * unselected - User has unselected a item.
 999     * clicked - User has double-clicked or pressed enter on a item.
1000     * realized - An evas object for a item was built.
1001     * unrealized - An evas object for a item was deleted.
1002     * changed - An item has been added, removed, resized or moved,
1003     * or gengrid has been resized or horizontal property has been changed.
1004     * scroll - the content has been scrolled (moved).
1005     * "scroll,drag,start" - dragging the contents around has started.
1006     * "scroll,drag,stop" - dragging the contents around has stopped.
1007     * drag - Gengrid is being dragged.
1008     * "drag,start,up" - Gengrid has been dragged (not scrolled) up.
1009     * "drag,start,down" - Gengrid has been dragged (not scrolled) down.
1010     * "drag,start,left" - Gengrid has been dragged (not scrolled) left.
1011     * "drag,start,rigth" - Gengrid has been dragged (nto scrolled) right.
1012     * "drag,stop" - Gengrid is not being dragged.
1013     */
1014
1015    /* clock */
1016    typedef enum _Elm_Clock_Digedit
1017      {
1018         ELM_CLOCK_NONE         = 0,
1019         ELM_CLOCK_HOUR_DECIMAL = 1 << 0,
1020         ELM_CLOCK_HOUR_UNIT    = 1 << 1,
1021         ELM_CLOCK_MIN_DECIMAL  = 1 << 2,
1022         ELM_CLOCK_MIN_UNIT     = 1 << 3,
1023         ELM_CLOCK_SEC_DECIMAL  = 1 << 4,
1024         ELM_CLOCK_SEC_UNIT     = 1 << 5,
1025         ELM_CLOCK_ALL          = (1 << 6) - 1
1026      } Elm_Clock_Digedit;
1027
1028    EAPI Evas_Object      *elm_clock_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
1029    EAPI void              elm_clock_time_set(Evas_Object *obj, int hrs, int min, int sec) EINA_ARG_NONNULL(1);
1030    EAPI void              elm_clock_time_get(const Evas_Object *obj, int *hrs, int *min, int *sec) EINA_ARG_NONNULL(1);
1031    EAPI void              elm_clock_edit_set(Evas_Object *obj, Eina_Bool edit) EINA_ARG_NONNULL(1);
1032    EAPI Eina_Bool         elm_clock_edit_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1033    EAPI void              elm_clock_digit_edit_set(Evas_Object *obj, Elm_Clock_Digedit digedit) EINA_ARG_NONNULL(1);
1034    EAPI Elm_Clock_Digedit elm_clock_digit_edit_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1035    EAPI void              elm_clock_show_am_pm_set(Evas_Object *obj, Eina_Bool am_pm) EINA_ARG_NONNULL(1);
1036    EAPI Eina_Bool         elm_clock_show_am_pm_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1037    EAPI void              elm_clock_show_seconds_set(Evas_Object *obj, Eina_Bool seconds) EINA_ARG_NONNULL(1);
1038    EAPI Eina_Bool         elm_clock_show_seconds_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1039    EAPI void              elm_clock_interval_set(Evas_Object *obj, double interval) EINA_ARG_NONNULL(1);
1040    EAPI double            elm_clock_interval_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1041    /* smart callbacks called:
1042     * "changed" - the user changed the time
1043     */
1044
1045    /* layout */
1046    EAPI Evas_Object       *elm_layout_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
1047    EAPI Eina_Bool          elm_layout_file_set(Evas_Object *obj, const char *file, const char *group) EINA_ARG_NONNULL(1);
1048    EAPI Eina_Bool          elm_layout_theme_set(Evas_Object *obj, const char *clas, const char *group, const char *style) EINA_ARG_NONNULL(1);
1049    EAPI void               elm_layout_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content) EINA_ARG_NONNULL(1);
1050    EAPI const Evas_Object *elm_layout_content_get(const Evas_Object *obj, const char *swallow) EINA_ARG_NONNULL(1);
1051    EAPI Evas_Object       *elm_layout_content_unset(Evas_Object *obj, const char *swallow) EINA_ARG_NONNULL(1);
1052    EAPI void               elm_layout_text_set(Evas_Object *obj, const char *part, const char *text) EINA_ARG_NONNULL(1);
1053    EAPI const char        *elm_layout_text_get(const Evas_Object *obj, const char *part) EINA_ARG_NONNULL(1);
1054    EAPI void               elm_layout_box_append(Evas_Object *obj, const char *part, Evas_Object *child) EINA_ARG_NONNULL(1);
1055    EAPI void               elm_layout_box_prepend(Evas_Object *obj, const char *part, Evas_Object *child) EINA_ARG_NONNULL(1);
1056    EAPI void               elm_layout_box_insert_before(Evas_Object *obj, const char *part, Evas_Object *child, const Evas_Object *reference) EINA_ARG_NONNULL(1);
1057    EAPI void               elm_layout_box_insert_at(Evas_Object *obj, const char *part, Evas_Object *child, unsigned int pos) EINA_ARG_NONNULL(1);
1058    EAPI Evas_Object       *elm_layout_box_remove(Evas_Object *obj, const char *part, Evas_Object *child) EINA_ARG_NONNULL(1, 2, 3);
1059    EAPI void               elm_layout_box_remove_all(Evas_Object *obj, const char *part, Eina_Bool clear) EINA_ARG_NONNULL(1, 2);
1060    EAPI void               elm_layout_table_pack(Evas_Object *obj, const char *part, Evas_Object *child_obj, unsigned short col, unsigned short row, unsigned short colspan, unsigned short rowspan) EINA_ARG_NONNULL(1);
1061    EAPI Evas_Object       *elm_layout_table_unpack(Evas_Object *obj, const char *part, Evas_Object *child_obj) EINA_ARG_NONNULL(1, 2, 3);
1062    EAPI void               elm_layout_table_clear(Evas_Object *obj, const char *part, Eina_Bool clear) EINA_ARG_NONNULL(1, 2);
1063    EAPI Evas_Object       *elm_layout_edje_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1064    EAPI const char        *elm_layout_data_get(const Evas_Object *obj, const char *key) EINA_ARG_NONNULL(1, 2);
1065    EAPI void               elm_layout_sizing_eval(Evas_Object *obj) EINA_ARG_NONNULL(1);
1066    EAPI Eina_Bool          elm_layout_part_cursor_set(Evas_Object *obj, const char *part_name, const char *cursor) EINA_ARG_NONNULL(1, 2);
1067    EAPI const char        *elm_layout_part_cursor_get(const Evas_Object *obj, const char *part_name) EINA_ARG_NONNULL(1, 2);
1068    EAPI void               elm_layout_part_cursor_unset(Evas_Object *obj, const char *part_name) EINA_ARG_NONNULL(1, 2);
1069    EAPI Eina_Bool          elm_layout_part_cursor_style_set(Evas_Object *obj, const char *part_name, const char *style) EINA_ARG_NONNULL(1, 2);
1070    EAPI const char        *elm_layout_part_cursor_style_get(const Evas_Object *obj, const char *part_name) EINA_ARG_NONNULL(1, 2);
1071    EAPI Eina_Bool          elm_layout_part_cursor_engine_only_set(Evas_Object *obj, const char *part_name, Eina_Bool engine_only) EINA_ARG_NONNULL(1, 2);
1072    EAPI Eina_Bool          elm_layout_part_cursor_engine_only_get(const Evas_Object *obj, const char *part_name) EINA_ARG_NONNULL(1, 2);
1073 /**
1074  * @def elm_layout_icon_set
1075  * Convienience macro to set the icon object in a layout that follows the
1076  * Elementary naming convention for its parts.
1077  *
1078  * @ingroup Layout
1079  */
1080 #define elm_layout_icon_set(_ly, _obj) \
1081   do { \
1082     const char *sig; \
1083     elm_layout_content_set((_ly), "elm.swallow.icon", (_obj)); \
1084     if ((_obj)) sig = "elm,state,icon,visible"; \
1085     else sig = "elm,state,icon,hidden"; \
1086     elm_object_signal_emit((_ly), sig, "elm"); \
1087   } while (0)
1088
1089 /**
1090  * @def elm_layout_icon_get
1091  * Convienience macro to get the icon object from a layout that follows the
1092  * Elementary naming convention for its parts.
1093  *
1094  * @ingroup Layout
1095  */
1096 #define elm_layout_icon_get(_ly) \
1097   elm_layout_content_get((_ly), "elm.swallow.icon")
1098
1099 /**
1100  * @def elm_layout_end_set
1101  * Convienience macro to set the end object in a layout that follows the
1102  * Elementary naming convention for its parts.
1103  *
1104  * @ingroup Layout
1105  */
1106 #define elm_layout_end_set(_ly, _obj) \
1107   do { \
1108     const char *sig; \
1109     elm_layout_content_set((_ly), "elm.swallow.end", (_obj)); \
1110     if ((_obj)) sig = "elm,state,end,visible"; \
1111     else sig = "elm,state,end,hidden"; \
1112     elm_object_signal_emit((_ly), sig, "elm"); \
1113   } while (0)
1114
1115 /**
1116  * @def elm_layout_end_get
1117  * Convienience macro to get the end object in a layout that follows the
1118  * Elementary naming convention for its parts.
1119  *
1120  * @ingroup Layout
1121  */
1122 #define elm_layout_end_get(_ly) \
1123   elm_layout_content_get((_ly), "elm.swallow.end")
1124
1125 /**
1126  * @def elm_layout_label_set
1127  * Convienience macro to set the label in a layout that follows the
1128  * Elementary naming convention for its parts.
1129  *
1130  * @ingroup Layout
1131  */
1132 #define elm_layout_label_set(_ly, _txt) \
1133   elm_layout_text_set((_ly), "elm.text", (_txt))
1134
1135 /**
1136  * @def elm_layout_label_get
1137  * Convienience macro to get the label in a layout that follows the
1138  * Elementary naming convention for its parts.
1139  *
1140  * @ingroup Layout
1141  */
1142 #define elm_layout_label_get(_ly) \
1143   elm_layout_text_get((_ly), "elm.text")
1144
1145    /* smart callbacks called:
1146     */
1147
1148    /* notify */
1149    typedef enum _Elm_Notify_Orient
1150      {
1151         ELM_NOTIFY_ORIENT_TOP,
1152         ELM_NOTIFY_ORIENT_CENTER,
1153         ELM_NOTIFY_ORIENT_BOTTOM,
1154         ELM_NOTIFY_ORIENT_LEFT,
1155         ELM_NOTIFY_ORIENT_RIGHT,
1156         ELM_NOTIFY_ORIENT_TOP_LEFT,
1157         ELM_NOTIFY_ORIENT_TOP_RIGHT,
1158         ELM_NOTIFY_ORIENT_BOTTOM_LEFT,
1159         ELM_NOTIFY_ORIENT_BOTTOM_RIGHT,
1160         ELM_NOTIFY_ORIENT_LAST
1161      } Elm_Notify_Orient;
1162    EAPI Evas_Object      *elm_notify_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
1163    EAPI void              elm_notify_content_set(Evas_Object *obj, Evas_Object *content) EINA_ARG_NONNULL(1);
1164    EAPI Evas_Object      *elm_notify_content_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
1165    EAPI Evas_Object      *elm_notify_content_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1166    EAPI void              elm_notify_parent_set(Evas_Object *obj, Evas_Object *parent) EINA_ARG_NONNULL(1);
1167    EAPI Evas_Object      *elm_notify_parent_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1168    EAPI void              elm_notify_orient_set(Evas_Object *obj, Elm_Notify_Orient orient) EINA_ARG_NONNULL(1);
1169    EAPI Elm_Notify_Orient elm_notify_orient_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1170    EAPI void              elm_notify_timeout_set(Evas_Object *obj, double timeout) EINA_ARG_NONNULL(1);
1171    EAPI double            elm_notify_timeout_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1172    EAPI void              elm_notify_repeat_events_set(Evas_Object *obj, Eina_Bool repeat) EINA_ARG_NONNULL(1);
1173    EAPI Eina_Bool         elm_notify_repeat_events_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1174    /* smart callbacks called:
1175     * "timeout" - when timeout happens on notify and it's hidden
1176     * "block,clicked" - when it's hidden by a click outside of the notify's view
1177     */
1178
1179    /* hover */
1180    typedef enum _Elm_Hover_Axis
1181      {
1182         ELM_HOVER_AXIS_NONE,
1183         ELM_HOVER_AXIS_HORIZONTAL,
1184         ELM_HOVER_AXIS_VERTICAL,
1185         ELM_HOVER_AXIS_BOTH
1186      } Elm_Hover_Axis;
1187    EAPI Evas_Object *elm_hover_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
1188    EAPI void         elm_hover_target_set(Evas_Object *obj, Evas_Object *target) EINA_ARG_NONNULL(1);
1189    EAPI Evas_Object *elm_hover_target_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1190    EAPI void         elm_hover_parent_set(Evas_Object *obj, Evas_Object *parent) EINA_ARG_NONNULL(1);
1191    EAPI Evas_Object *elm_hover_parent_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1192    EAPI void         elm_hover_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content) EINA_ARG_NONNULL(1);
1193    EAPI Evas_Object *elm_hover_content_get(const Evas_Object *obj, const char *swallow) EINA_ARG_NONNULL(1);
1194    EAPI Evas_Object *elm_hover_content_unset(Evas_Object *obj, const char *swallow) EINA_ARG_NONNULL(1);
1195    EAPI const char  *elm_hover_best_content_location_get(const Evas_Object *obj, Elm_Hover_Axis pref_axis) EINA_ARG_NONNULL(1);
1196    /* available styles:
1197     * default
1198     * popout
1199     * menu
1200     * hoversel_vertical
1201     */
1202    /* smart callbacks called:
1203     * "clicked" - the user clicked the empty space in the hover to dismiss
1204     * "smart,changed" - a content object placed under the "smart"
1205     *                   policy was replaced to a new slot direction.
1206     */
1207
1208    /* entry */
1209    typedef struct _Elm_Entry_Anchor_Info Elm_Entry_Anchor_Info;
1210    struct _Elm_Entry_Anchor_Info
1211      {
1212         const char *name;
1213         int         button;
1214         Evas_Coord  x, y, w, h;
1215      };
1216    typedef enum _Elm_Icon_Type
1217      {
1218         ELM_ICON_NONE,
1219         ELM_ICON_FILE,
1220         ELM_ICON_STANDARD
1221      } Elm_Icon_Type;
1222
1223    typedef enum _Elm_Input_Panel_Layout
1224      {
1225         ELM_INPUT_PANEL_LAYOUT_NORMAL,          /**< Default 4x4 layout */
1226         ELM_INPUT_PANEL_LAYOUT_NUMBER,          /**< Number layout */
1227         ELM_INPUT_PANEL_LAYOUT_EMAIL,           /**< Email layout */
1228         ELM_INPUT_PANEL_LAYOUT_URL,             /**< URL layout */
1229         ELM_INPUT_PANEL_LAYOUT_PHONENUMBER,     /**< Phone Number layout */
1230         ELM_INPUT_PANEL_LAYOUT_IP,              /**< IP layout */
1231         ELM_INPUT_PANEL_LAYOUT_MONTH,           /**< Month layout */
1232         ELM_INPUT_PANEL_LAYOUT_NUMBERONLY,      /**< Number Only layout */
1233         ELM_INPUT_PANEL_LAYOUT_CUSTOM_1 = 100,  /* Reserved for future use */
1234         ELM_INPUT_PANEL_LAYOUT_CUSTOM_2,
1235         ELM_INPUT_PANEL_LAYOUT_CUSTOM_3,
1236         ELM_INPUT_PANEL_LAYOUT_CUSTOM_4,
1237         ELM_INPUT_PANEL_LAYOUT_CUSTOM_5,
1238         ELM_INPUT_PANEL_LAYOUT_CUSTOM_6,
1239         ELM_INPUT_PANEL_LAYOUT_CUSTOM_7,
1240         ELM_INPUT_PANEL_LAYOUT_CUSTOM_8,
1241         ELM_INPUT_PANEL_LAYOUT_CUSTOM_9,
1242         ELM_INPUT_PANEL_LAYOUT_CUSTOM_10
1243      } Elm_Input_Panel_Layout;
1244
1245    typedef struct _Elm_Hoversel_Item Elm_Hoversel_Item; /**< Item of Elm_Hoversel. Sub-type of Elm_Widget_Item */
1246
1247    EAPI Evas_Object *elm_entry_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
1248    EAPI void         elm_entry_single_line_set(Evas_Object *obj, Eina_Bool single_line) EINA_ARG_NONNULL(1);
1249    EAPI Eina_Bool    elm_entry_single_line_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1250    EAPI void         elm_entry_password_set(Evas_Object *obj, Eina_Bool password) EINA_ARG_NONNULL(1);
1251    EAPI Eina_Bool    elm_entry_password_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1252    EAPI void         elm_entry_entry_set(Evas_Object *obj, const char *entry) EINA_ARG_NONNULL(1);
1253    EAPI const char  *elm_entry_entry_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1254    EAPI Eina_Bool    elm_entry_is_empty(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1255    EAPI const char  *elm_entry_selection_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1256    EAPI void         elm_entry_entry_insert(Evas_Object *obj, const char *entry) EINA_ARG_NONNULL(1);
1257    EAPI void         elm_entry_line_wrap_set(Evas_Object *obj, Eina_Bool wrap) EINA_ARG_NONNULL(1);
1258    EAPI void         elm_entry_line_char_wrap_set(Evas_Object *obj, Eina_Bool wrap) EINA_ARG_NONNULL(1);
1259    EAPI void         elm_entry_editable_set(Evas_Object *obj, Eina_Bool editable) EINA_ARG_NONNULL(1);
1260    EAPI Eina_Bool    elm_entry_editable_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1261    EAPI void         elm_entry_select_none(Evas_Object *obj) EINA_ARG_NONNULL(1);
1262    EAPI void         elm_entry_select_all(Evas_Object *obj) EINA_ARG_NONNULL(1);
1263    EAPI Eina_Bool    elm_entry_cursor_next(Evas_Object *obj) EINA_ARG_NONNULL(1);
1264    EAPI Eina_Bool    elm_entry_cursor_prev(Evas_Object *obj) EINA_ARG_NONNULL(1);
1265    EAPI Eina_Bool    elm_entry_cursor_up(Evas_Object *obj) EINA_ARG_NONNULL(1);
1266    EAPI Eina_Bool    elm_entry_cursor_down(Evas_Object *obj) EINA_ARG_NONNULL(1);
1267    EAPI void         elm_entry_cursor_begin_set(Evas_Object *obj) EINA_ARG_NONNULL(1);
1268    EAPI void         elm_entry_cursor_end_set(Evas_Object *obj) EINA_ARG_NONNULL(1);
1269    EAPI void         elm_entry_cursor_line_begin_set(Evas_Object *obj) EINA_ARG_NONNULL(1);
1270    EAPI void         elm_entry_cursor_line_end_set(Evas_Object *obj) EINA_ARG_NONNULL(1);
1271    EAPI void         elm_entry_cursor_selection_begin(Evas_Object *obj) EINA_ARG_NONNULL(1);
1272    EAPI void         elm_entry_cursor_selection_end(Evas_Object *obj) EINA_ARG_NONNULL(1);
1273    EAPI Eina_Bool    elm_entry_cursor_is_format_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1274    EAPI Eina_Bool    elm_entry_cursor_is_visible_format_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1275    EAPI const char  *elm_entry_cursor_content_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1276    EAPI Eina_Bool    elm_entry_cursor_geometry_get(const Evas_Object *obj, Evas_Coord *x, Evas_Coord *y, Evas_Coord *w, Evas_Coord *h) EINA_ARG_NONNULL(1);
1277    EAPI void         elm_entry_cursor_pos_set(Evas_Object *obj, int pos) EINA_ARG_NONNULL(1);
1278    EAPI int          elm_entry_cursor_pos_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1279    EAPI void         elm_entry_selection_cut(Evas_Object *obj) EINA_ARG_NONNULL(1);
1280    EAPI void         elm_entry_selection_copy(Evas_Object *obj) EINA_ARG_NONNULL(1);
1281    EAPI void         elm_entry_selection_paste(Evas_Object *obj) EINA_ARG_NONNULL(1);
1282    EAPI void         elm_entry_context_menu_clear(Evas_Object *obj) EINA_ARG_NONNULL(1);
1283    EAPI void         elm_entry_context_menu_item_add(Evas_Object *obj, const char *label, const char *icon_file, Elm_Icon_Type icon_type, Evas_Smart_Cb func, const void *data) EINA_ARG_NONNULL(1);
1284    EAPI void         elm_entry_context_menu_disabled_set(Evas_Object *obj, Eina_Bool disabled) EINA_ARG_NONNULL(1);
1285    EAPI Eina_Bool    elm_entry_context_menu_disabled_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1286    EAPI void         elm_entry_item_provider_append(Evas_Object *obj, Evas_Object *(*func) (void *data, Evas_Object *entry, const char *item), void *data) EINA_ARG_NONNULL(1, 2);
1287    EAPI void         elm_entry_item_provider_prepend(Evas_Object *obj, Evas_Object *(*func) (void *data, Evas_Object *entry, const char *item), void *data) EINA_ARG_NONNULL(1, 2);
1288    EAPI void         elm_entry_item_provider_remove(Evas_Object *obj, Evas_Object *(*func) (void *data, Evas_Object *entry, const char *item), void *data) EINA_ARG_NONNULL(1, 2);
1289    EAPI void         elm_entry_text_filter_append(Evas_Object *obj, void (*func) (void *data, Evas_Object *entry, char **text), void *data) EINA_ARG_NONNULL(1, 2);
1290    EAPI void         elm_entry_text_filter_prepend(Evas_Object *obj, void (*func) (void *data, Evas_Object *entry, char **text), void *data) EINA_ARG_NONNULL(1, 2);
1291    EAPI void         elm_entry_text_filter_remove(Evas_Object *obj, void (*func) (void *data, Evas_Object *entry, char **text), void *data) EINA_ARG_NONNULL(1, 2);
1292    EAPI char        *elm_entry_markup_to_utf8(const char *s) EINA_MALLOC EINA_WARN_UNUSED_RESULT;
1293    EAPI char        *elm_entry_utf8_to_markup(const char *s) EINA_MALLOC EINA_WARN_UNUSED_RESULT;
1294    EINA_DEPRECATED EAPI void         elm_entry_wrap_width_set(Evas_Object *obj, Evas_Coord w);
1295    EINA_DEPRECATED EAPI Evas_Coord   elm_entry_wrap_width_get(const Evas_Object *obj);
1296    EINA_DEPRECATED EAPI void         elm_entry_fontsize_set(Evas_Object *obj, int fontsize);
1297    EINA_DEPRECATED EAPI void         elm_entry_text_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
1298    EINA_DEPRECATED EAPI void         elm_entry_text_align_set(Evas_Object *obj, const char *alignmode);
1299    EAPI void         elm_entry_background_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
1300    EAPI void         elm_entry_file_set(Evas_Object *obj, const char *file, Elm_Text_Format format) EINA_ARG_NONNULL(1);
1301    EAPI void         elm_entry_file_get(const Evas_Object *obj, const char **file, Elm_Text_Format *format) EINA_ARG_NONNULL(1);
1302    EAPI void         elm_entry_file_save(Evas_Object *obj) EINA_ARG_NONNULL(1);
1303    EAPI void         elm_entry_autosave_set(Evas_Object *obj, Eina_Bool autosave) EINA_ARG_NONNULL(1);
1304    EAPI Eina_Bool    elm_entry_autosave_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1305    EAPI void         elm_entry_cnp_textonly_set(Evas_Object *obj, Eina_Bool textonly) EINA_ARG_NONNULL(1);
1306    EAPI Eina_Bool    elm_entry_cnp_textonly_get(Evas_Object *obj) EINA_ARG_NONNULL(1);
1307    EAPI void         elm_entry_autocapitalization_set(Evas_Object *obj, Eina_Bool autocap);
1308    EAPI void         elm_entry_autoperiod_set(Evas_Object *obj, Eina_Bool autoperiod);
1309    EAPI void         elm_entry_autoenable_returnkey_set(Evas_Object *obj, Eina_Bool on);
1310    EAPI void         elm_entry_input_panel_enabled_set(Evas_Object *obj, Eina_Bool enabled);
1311    EAPI void         elm_entry_input_panel_layout_set(Evas_Object *obj, Elm_Input_Panel_Layout layout);
1312    EAPI Ecore_IMF_Context *elm_entry_imf_context_get(Evas_Object *obj);
1313    EAPI void         elm_entry_matchlist_set(Evas_Object *obj, Eina_List *match_list, Eina_Bool case_sensitive);
1314    EAPI Eina_Bool    elm_entry_is_empty(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1315    EAPI void         elm_entry_magnifier_type_set(Evas_Object *obj, int type) EINA_ARG_NONNULL(1);
1316
1317
1318    /* pre-made filters for entries */
1319    typedef struct _Elm_Entry_Filter_Limit_Size Elm_Entry_Filter_Limit_Size;
1320    struct _Elm_Entry_Filter_Limit_Size
1321      {
1322         int max_char_count;
1323         int max_byte_count;
1324      };
1325    EAPI void         elm_entry_filter_limit_size(void *data, Evas_Object *entry, char **text) EINA_ARG_NONNULL(1, 2, 3);
1326    typedef struct _Elm_Entry_Filter_Accept_Set Elm_Entry_Filter_Accept_Set;
1327    struct _Elm_Entry_Filter_Accept_Set
1328      {
1329         const char *accepted;
1330         const char *rejected;
1331      };
1332    EAPI void         elm_entry_filter_accept_set(void *data, Evas_Object *entry, char **text) EINA_ARG_NONNULL(1, 3);
1333    /* smart callbacks called:
1334     * "changed" - the text content changed
1335     * "selection,start" - the user started selecting text
1336     * "selection,changed" - the user modified the selection size/location
1337     * "selection,cleared" - the user cleared the selection
1338     * "selection,paste" - the user requested a paste of text
1339     * "selection,copy" - the user copied the text
1340     * "selection,cut" - the user cut the text
1341     * "cursor,changed" - the cursor changed position
1342     * "anchor,clicked" - achor called was clicked | event_info = Elm_Entry_Anchor_Info
1343     * "activated" - when the enter key is pressed (useful for single line)
1344     * "press" - when finger/mouse is pressed down
1345     * "clicked" - when finger/mouse is pressed and released (without a drag etc.)
1346     * "clicked,double" - when finger/mouse is double-pressed
1347     * "longpressed" - the entry has been longpressed
1348     * "focused" - the entry has received keyboard focus
1349     * "unfocused" - keyboard focus is gone
1350     */
1351
1352    /* composite widgets - these basically put together basic widgets above
1353     * in convenient packages that do more than basic stuff */
1354
1355    /* anchorview */
1356    typedef struct _Elm_Entry_Anchorview_Info Elm_Entry_Anchorview_Info;
1357    struct _Elm_Entry_Anchorview_Info
1358      {
1359         const char     *name;
1360         int             button;
1361         Evas_Object    *hover;
1362         struct {
1363              Evas_Coord    x, y, w, h;
1364         } anchor, hover_parent;
1365         Eina_Bool       hover_left : 1;
1366         Eina_Bool       hover_right : 1;
1367         Eina_Bool       hover_top : 1;
1368         Eina_Bool       hover_bottom : 1;
1369      };
1370    EAPI Evas_Object *elm_anchorview_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
1371    EAPI void         elm_anchorview_text_set(Evas_Object *obj, const char *text) EINA_ARG_NONNULL(1);
1372    EAPI const char  *elm_anchorview_text_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1373
1374    EAPI void         elm_anchorview_hover_parent_set(Evas_Object *obj, Evas_Object *parent) EINA_ARG_NONNULL(1);
1375    EAPI Evas_Object *elm_anchorview_hover_parent_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1376    EAPI void         elm_anchorview_hover_style_set(Evas_Object *obj, const char *style) EINA_ARG_NONNULL(1);
1377    EAPI const char  *elm_anchorview_hover_style_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1378    EAPI void         elm_anchorview_hover_end(Evas_Object *obj) EINA_ARG_NONNULL(1);
1379    EAPI void         elm_anchorview_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce) EINA_ARG_NONNULL(1);
1380    EAPI void         elm_anchorview_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce) EINA_ARG_NONNULL(1);
1381    EAPI void         elm_anchorview_item_provider_append(Evas_Object *obj, Evas_Object *(*func) (void *data, Evas_Object *anchorview, const char *item), void *data) EINA_ARG_NONNULL(1, 2);
1382    EAPI void         elm_anchorview_item_provider_prepend(Evas_Object *obj, Evas_Object *(*func) (void *data, Evas_Object *anchorview, const char *item), void *data) EINA_ARG_NONNULL(1, 2);
1383    EAPI void         elm_anchorview_item_provider_remove(Evas_Object *obj, Evas_Object *(*func) (void *data, Evas_Object *anchorview, const char *item), void *data) EINA_ARG_NONNULL(1, 2);
1384    /* smart callbacks called:
1385     * "anchor,clicked" - achor called was clicked | event_info = Elm_Entry_Anchorview_Info
1386     */
1387
1388    /* anchorblock */
1389    typedef struct _Elm_Entry_Anchorblock_Info Elm_Entry_Anchorblock_Info;
1390    struct _Elm_Entry_Anchorblock_Info
1391      {
1392         const char     *name;
1393         int             button;
1394         Evas_Object    *hover;
1395         struct {
1396              Evas_Coord    x, y, w, h;
1397         } anchor, hover_parent;
1398         Eina_Bool       hover_left : 1;
1399         Eina_Bool       hover_right : 1;
1400         Eina_Bool       hover_top : 1;
1401         Eina_Bool       hover_bottom : 1;
1402      };
1403    EAPI Evas_Object *elm_anchorblock_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
1404    EAPI void         elm_anchorblock_text_set(Evas_Object *obj, const char *text) EINA_ARG_NONNULL(1);
1405    EAPI const char  *elm_anchorblock_text_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1406    EAPI void         elm_anchorblock_hover_parent_set(Evas_Object *obj, Evas_Object *parent) EINA_ARG_NONNULL(1);
1407    EAPI Evas_Object *elm_anchorblock_hover_parent_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1408    EAPI void         elm_anchorblock_hover_style_set(Evas_Object *obj, const char *style) EINA_ARG_NONNULL(1);
1409    EAPI const char  *elm_anchorblock_hover_style_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1410    EAPI void         elm_anchorblock_hover_end(Evas_Object *obj) EINA_ARG_NONNULL(1);
1411    EAPI void         elm_anchorblock_item_provider_append(Evas_Object *obj, Evas_Object *(*func) (void *data, Evas_Object *anchorblock, const char *item), void *data) EINA_ARG_NONNULL(1, 2);
1412    EAPI void         elm_anchorblock_item_provider_prepend(Evas_Object *obj, Evas_Object *(*func) (void *data, Evas_Object *anchorblock, const char *item), void *data) EINA_ARG_NONNULL(1, 2);
1413    EAPI void         elm_anchorblock_item_provider_remove(Evas_Object *obj, Evas_Object *(*func) (void *data, Evas_Object *anchorblock, const char *item), void *data) EINA_ARG_NONNULL(1, 2);
1414    /* smart callbacks called:
1415     * "anchor,clicked" - achor called was clicked | event_info = Elm_Entry_Anchorblock_Info
1416     */
1417
1418    /* bubble */
1419    EAPI Evas_Object *elm_bubble_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
1420    EAPI void         elm_bubble_label_set(Evas_Object *obj, const char *label) EINA_ARG_NONNULL(1);
1421    EAPI const char  *elm_bubble_label_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1422    EAPI void         elm_bubble_info_set(Evas_Object *obj, const char *info) EINA_ARG_NONNULL(1);
1423    EAPI const char  *elm_bubble_info_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1424
1425    EAPI void         elm_bubble_content_set(Evas_Object *obj, Evas_Object *content) EINA_ARG_NONNULL(1);
1426    EAPI Evas_Object *elm_bubble_content_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1427    EAPI Evas_Object *elm_bubble_content_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
1428    EAPI void         elm_bubble_icon_set(Evas_Object *obj, Evas_Object *icon) EINA_ARG_NONNULL(1);
1429    EAPI Evas_Object *elm_bubble_icon_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1430    EAPI Evas_Object *elm_bubble_icon_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
1431    EINA_DEPRECATED EAPI void         elm_bubble_sweep_layout_set(Evas_Object *obj, Evas_Object *sweep) EINA_ARG_NONNULL(1);
1432    EINA_DEPRECATED EAPI Evas_Object *elm_bubble_sweep_layout_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
1433    EAPI void         elm_bubble_corner_set(Evas_Object *obj, const char *corner) EINA_ARG_NONNULL(1, 2);
1434    EAPI const char  *elm_bubble_corner_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1435    /* smart callbacks called:
1436     * "clicked" - the user clicked the bubble
1437     * "sweep,left,right" - when bubble is sweeped from left to right, this signal is sent.
1438     * "sweep,right,left" - when bubble is sweeped from right to left, this signal is sent.
1439     */
1440
1441    /* photo */
1442    EAPI Evas_Object *elm_photo_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
1443    EAPI Eina_Bool    elm_photo_file_set(Evas_Object *obj, const char *file) EINA_ARG_NONNULL(1);
1444    EAPI void         elm_photo_size_set(Evas_Object *obj, int size) EINA_ARG_NONNULL(1);
1445    EAPI void         elm_photo_fill_inside_set(Evas_Object *obj, Eina_Bool fill) EINA_ARG_NONNULL(1);
1446    EAPI void         elm_photo_editable_set(Evas_Object *obj, Eina_Bool set) EINA_ARG_NONNULL(1);
1447    /* smart callbacks called:
1448     * "clicked" - the user clicked the icon
1449     * "drop" - Something was dropped on the widget
1450     * "drag,start" - Someone started dragging the image out of the object
1451     * "drag,end" - Dragged item was dropped (somewhere)
1452     */
1453
1454    /* thumb */
1455    typedef enum _Elm_Thumb_Animation_Setting
1456      {
1457         ELM_THUMB_ANIMATION_START = 0, /* Play animation once */
1458         ELM_THUMB_ANIMATION_LOOP,      /* Keep playing animation until stop is requested */
1459         ELM_THUMB_ANIMATION_STOP,
1460         ELM_THUMB_ANIMATION_LAST
1461      } Elm_Thumb_Animation_Setting;
1462
1463    EAPI Evas_Object                 *elm_thumb_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
1464    EAPI void                         elm_thumb_reload(Evas_Object *obj) EINA_ARG_NONNULL(1);
1465    EAPI void                         elm_thumb_file_set(Evas_Object *obj, const char *file, const char *key) EINA_ARG_NONNULL(1);
1466    EAPI void                         elm_thumb_file_get(const Evas_Object *obj, const char **file, const char **key) EINA_ARG_NONNULL(1);
1467    EAPI void                         elm_thumb_path_get(const Evas_Object *obj, const char **file, const char **key) EINA_ARG_NONNULL(1);
1468    EAPI void                         elm_thumb_animate_set(Evas_Object *obj, Elm_Thumb_Animation_Setting s) EINA_ARG_NONNULL(1);
1469    EAPI Elm_Thumb_Animation_Setting  elm_thumb_animate_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1470    EAPI void                        *elm_thumb_ethumb_client_get(void);
1471    EAPI Eina_Bool                    elm_thumb_ethumb_client_connected(void);
1472    EAPI Eina_Bool                    elm_thumb_editable_set(Evas_Object *obj, Eina_Bool edit) EINA_ARG_NONNULL(1);
1473    EAPI Eina_Bool                    elm_thumb_editable_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1474    /* available styles:
1475     * default
1476     * noframe
1477     */
1478    /* smart callbacks called:
1479     * "clicked" - This is called when a user has clicked the thumb without dragging around.
1480     * "clicked,double" - This is called when a user has double-clicked the thumb.
1481     * "press" - This is called when a user has pressed down the thumb.
1482     * "generate,start" - The thumbnail generation started.
1483     * "generate,stop" - The generation process stopped.
1484     * "generate,error" - The generation failed.
1485     * "load,error" - The thumbnail image loading failed.
1486     */
1487
1488    /* hoversel */
1489    EAPI Evas_Object       *elm_hoversel_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
1490    EAPI void               elm_hoversel_horizontal_set(Evas_Object *obj, Eina_Bool horizontal) EINA_ARG_NONNULL(1);
1491    EAPI Eina_Bool          elm_hoversel_horizontal_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1492    EAPI void               elm_hoversel_hover_parent_set(Evas_Object *obj, Evas_Object *parent) EINA_ARG_NONNULL(1);
1493    EAPI Evas_Object       *elm_hoversel_hover_parent_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1494    EAPI void               elm_hoversel_label_set(Evas_Object *obj, const char *label) EINA_ARG_NONNULL(1);
1495    EAPI const char        *elm_hoversel_label_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1496    EAPI void               elm_hoversel_icon_set(Evas_Object *obj, Evas_Object *icon) EINA_ARG_NONNULL(1);
1497    EAPI Evas_Object       *elm_hoversel_icon_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1498    EAPI Evas_Object       *elm_hoversel_icon_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
1499    EAPI void               elm_hoversel_hover_begin(Evas_Object *obj) EINA_ARG_NONNULL(1);
1500    EAPI void               elm_hoversel_hover_end(Evas_Object *obj) EINA_ARG_NONNULL(1);
1501    EAPI Eina_Bool          elm_hoversel_expanded_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1502    EAPI void               elm_hoversel_clear(Evas_Object *obj) EINA_ARG_NONNULL(1);
1503    EAPI const Eina_List   *elm_hoversel_items_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1504    EAPI Elm_Hoversel_Item *elm_hoversel_item_add(Evas_Object *obj, const char *label, const char *icon_file, Elm_Icon_Type icon_type, Evas_Smart_Cb func, const void *data) EINA_ARG_NONNULL(1);
1505    EAPI void               elm_hoversel_item_del(Elm_Hoversel_Item *item) EINA_ARG_NONNULL(1);
1506    EAPI void               elm_hoversel_item_del_cb_set(Elm_Hoversel_Item *it, Evas_Smart_Cb func) EINA_ARG_NONNULL(1);
1507    EAPI void              *elm_hoversel_item_data_get(const Elm_Hoversel_Item *it) EINA_ARG_NONNULL(1);
1508    EAPI const char        *elm_hoversel_item_label_get(const Elm_Hoversel_Item *it) EINA_ARG_NONNULL(1);
1509    EAPI void               elm_hoversel_item_icon_set(Elm_Hoversel_Item *it, const char *icon_file, const char *icon_group, Elm_Icon_Type icon_type) EINA_ARG_NONNULL(1);
1510    EAPI void               elm_hoversel_item_icon_get(const Elm_Hoversel_Item *it, const char **icon_file, const char **icon_group, Elm_Icon_Type *icon_type) EINA_ARG_NONNULL(1);
1511    /* smart callbacks called:
1512     * "clicked" - the user clicked the hoversel button and popped up the sel
1513     * "selected" - an item in the hoversel list is selected
1514     * "dismissed" - the hover is dismissed
1515     */
1516
1517    /* toolbar */
1518    typedef enum _Elm_Toolbar_Shrink_Mode
1519      {
1520         ELM_TOOLBAR_SHRINK_NONE,   /**< set toolbar minimun size to fit all the items */
1521         ELM_TOOLBAR_SHRINK_HIDE,   /**< hide excess items */
1522         ELM_TOOLBAR_SHRINK_SCROLL, /**< allow accessing excess items through a scroller */
1523         ELM_TOOLBAR_SHRINK_MENU    /**< inserts a button to pop up a menu with excess items */
1524      } Elm_Toolbar_Shrink_Mode;
1525
1526    typedef struct _Elm_Toolbar_Item Elm_Toolbar_Item; /**< Item of Elm_Toolbar. Sub-type of Elm_Widget_Item */
1527    typedef struct _Elm_Toolbar_Item_State Elm_Toolbar_Item_State; /** State of a Elm_Toolbar_Item */
1528
1529    EAPI Evas_Object            *elm_toolbar_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
1530    EAPI void                    elm_toolbar_icon_size_set(Evas_Object *obj, int icon_size) EINA_ARG_NONNULL(1);
1531    EAPI int                     elm_toolbar_icon_size_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1532    EAPI void                    elm_toolbar_icon_order_lookup_set(Evas_Object *obj, Elm_Icon_Lookup_Order order) EINA_ARG_NONNULL(1);
1533    EAPI Elm_Icon_Lookup_Order   elm_toolbar_icon_order_lookup_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1534    EAPI void                    elm_toolbar_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select) EINA_ARG_NONNULL(1);
1535    EAPI Eina_Bool               elm_toolbar_no_select_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1536    EAPI Elm_Toolbar_Item       *elm_toolbar_item_append(Evas_Object *obj, const char *icon, const char *label, Evas_Smart_Cb func, const void *data) EINA_ARG_NONNULL(1);
1537    EAPI Elm_Toolbar_Item       *elm_toolbar_item_prepend(Evas_Object *obj, const char *icon, const char *label, Evas_Smart_Cb func, const void *data) EINA_ARG_NONNULL(1);
1538    EAPI Elm_Toolbar_Item       *elm_toolbar_item_insert_before(Evas_Object *obj, Elm_Toolbar_Item *before, const char *icon, const char *label, Evas_Smart_Cb func, const void *data) EINA_ARG_NONNULL(1);
1539    EAPI Elm_Toolbar_Item       *elm_toolbar_item_insert_after(Evas_Object *obj, Elm_Toolbar_Item *after, const char *icon, const char *label, Evas_Smart_Cb func, const void *data) EINA_ARG_NONNULL(1);
1540    EAPI Elm_Toolbar_Item       *elm_toolbar_first_item_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1541    EAPI Elm_Toolbar_Item       *elm_toolbar_last_item_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1542    EAPI Elm_Toolbar_Item       *elm_toolbar_item_next_get(const Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1543    EAPI Elm_Toolbar_Item       *elm_toolbar_item_prev_get(const Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1544    EAPI Evas_Object            *elm_toolbar_item_toolbar_get(const Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1545    EAPI void                    elm_toolbar_item_priority_set(Elm_Toolbar_Item *item, int priority) EINA_ARG_NONNULL(1);
1546    EAPI int                     elm_toolbar_item_priority_get(const Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1547    EAPI const char             *elm_toolbar_item_icon_get(const Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1548    EAPI const char             *elm_toolbar_item_label_get(const Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1549    EAPI void                    elm_toolbar_item_label_set(Elm_Toolbar_Item *item, const char *label) EINA_ARG_NONNULL(1);
1550    EAPI void                   *elm_toolbar_item_data_get(const Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1551    EAPI void                    elm_toolbar_item_data_set(Elm_Toolbar_Item *item, const void *data) EINA_ARG_NONNULL(1);
1552    EAPI Elm_Toolbar_Item       *elm_toolbar_item_find_by_label(const Evas_Object *obj, const char *label) EINA_ARG_NONNULL(1);
1553    EAPI Eina_Bool               elm_toolbar_item_selected_get(const Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1554    EAPI void                    elm_toolbar_item_selected_set(Elm_Toolbar_Item *item, Eina_Bool selected) EINA_ARG_NONNULL(1);
1555    EAPI Elm_Toolbar_Item       *elm_toolbar_selected_item_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1556    EAPI void                    elm_toolbar_item_icon_set(Elm_Toolbar_Item *item, const char *icon) EINA_ARG_NONNULL(1);
1557    EAPI void                    elm_toolbar_item_del(Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1558    EAPI void                    elm_toolbar_item_del_cb_set(Elm_Toolbar_Item *item, Evas_Smart_Cb func) EINA_ARG_NONNULL(1);
1559    EAPI Eina_Bool               elm_toolbar_item_disabled_get(const Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1560    EAPI void                    elm_toolbar_item_disabled_set(Elm_Toolbar_Item *item, Eina_Bool disabled) EINA_ARG_NONNULL(1);
1561    EAPI void                    elm_toolbar_item_separator_set(Elm_Toolbar_Item *item, Eina_Bool separator) EINA_ARG_NONNULL(1);
1562    EAPI Eina_Bool               elm_toolbar_item_separator_get(const Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1563    EAPI void                    elm_toolbar_mode_shrink_set(Evas_Object *obj, Elm_Toolbar_Shrink_Mode shrink_mode) EINA_ARG_NONNULL(1);
1564    EAPI Elm_Toolbar_Shrink_Mode elm_toolbar_mode_shrink_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1565    EAPI void                    elm_toolbar_homogenous_set(Evas_Object *obj, Eina_Bool homogenous) EINA_ARG_NONNULL(1);
1566    EAPI Eina_Bool               elm_toolbar_homogenous_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1567    EAPI void                    elm_toolbar_menu_parent_set(Evas_Object *obj, Evas_Object *parent) EINA_ARG_NONNULL(1);
1568    EAPI Evas_Object            *elm_toolbar_menu_parent_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1569    EAPI void                    elm_toolbar_align_set(Evas_Object *obj, double align) EINA_ARG_NONNULL(1);
1570    EAPI double                  elm_toolbar_align_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1571    EAPI void                    elm_toolbar_item_menu_set(Elm_Toolbar_Item *item, Eina_Bool menu) EINA_ARG_NONNULL(1);
1572    EAPI Evas_Object            *elm_toolbar_item_menu_get(Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1573    EAPI Elm_Toolbar_Item_State *elm_toolbar_item_state_add(Elm_Toolbar_Item *item, const char *icon, const char *label, Evas_Smart_Cb func, const void *data) EINA_ARG_NONNULL(1);
1574    EAPI Eina_Bool               elm_toolbar_item_state_del(Elm_Toolbar_Item *item, Elm_Toolbar_Item_State *state) EINA_ARG_NONNULL(1);
1575    EAPI Eina_Bool               elm_toolbar_item_state_set(Elm_Toolbar_Item *it, Elm_Toolbar_Item_State *state) EINA_ARG_NONNULL(1);
1576    EAPI void                    elm_toolbar_item_state_unset(Elm_Toolbar_Item *it) EINA_ARG_NONNULL(1);
1577    EAPI Elm_Toolbar_Item_State *elm_toolbar_item_state_get(const Elm_Toolbar_Item *it) EINA_ARG_NONNULL(1);
1578    EAPI Elm_Toolbar_Item_State *elm_toolbar_item_state_next(Elm_Toolbar_Item *it) EINA_ARG_NONNULL(1);
1579    EAPI Elm_Toolbar_Item_State *elm_toolbar_item_state_prev(Elm_Toolbar_Item *it) EINA_ARG_NONNULL(1);
1580    EAPI void                    elm_toolbar_item_tooltip_text_set(Elm_Toolbar_Item *item, const char *text) EINA_ARG_NONNULL(1);
1581    EAPI void                    elm_toolbar_item_tooltip_content_cb_set(Elm_Toolbar_Item *item, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb) EINA_ARG_NONNULL(1);
1582    EAPI void                    elm_toolbar_item_tooltip_unset(Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1583    EAPI void                    elm_toolbar_item_tooltip_style_set(Elm_Toolbar_Item *item, const char *style) EINA_ARG_NONNULL(1);
1584    EAPI const char             *elm_toolbar_item_tooltip_style_get(const Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1585    EAPI void                    elm_toolbar_item_cursor_set(Elm_Toolbar_Item *item, const char *cursor) EINA_ARG_NONNULL(1);
1586    EAPI const char             *elm_toolbar_item_cursor_get(const Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1587    EAPI void                    elm_toolbar_item_cursor_unset(Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1588    EAPI void                    elm_toolbar_item_cursor_style_set(Elm_Toolbar_Item *item, const char *style) EINA_ARG_NONNULL(1);
1589    EAPI const char             *elm_toolbar_item_cursor_style_get(const Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1590    EAPI void                    elm_toolbar_item_cursor_engine_only_set(Elm_Toolbar_Item *item, Eina_Bool engine_only) EINA_ARG_NONNULL(1);
1591    EAPI Eina_Bool               elm_toolbar_item_cursor_engine_only_get(const Elm_Toolbar_Item *item) EINA_ARG_NONNULL(1);
1592    /* smart callbacks called:
1593     * "clicked" - when the user clicks on a toolbar item and becomes selected
1594     */
1595    /* available styles:
1596     * default
1597     * transparent (no background or shadow, just show the provided content)
1598     */
1599
1600    /* tooltip */
1601    EAPI double       elm_tooltip_delay_get(void);
1602    EAPI Eina_Bool    elm_tooltip_delay_set(double delay);
1603    EAPI void         elm_object_tooltip_show(Evas_Object *obj) EINA_ARG_NONNULL(1);
1604    EAPI void         elm_object_tooltip_hide(Evas_Object *obj) EINA_ARG_NONNULL(1);
1605    EAPI void         elm_object_tooltip_text_set(Evas_Object *obj, const char *text) EINA_ARG_NONNULL(1, 2);
1606    EAPI void         elm_object_tooltip_content_cb_set(Evas_Object *obj, Elm_Tooltip_Content_Cb func, const void *data, Evas_Smart_Cb del_cb) EINA_ARG_NONNULL(1);
1607    EAPI void         elm_object_tooltip_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
1608    EAPI void         elm_object_tooltip_style_set(Evas_Object *obj, const char *style) EINA_ARG_NONNULL(1);
1609    EAPI const char  *elm_object_tooltip_style_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1610    EAPI void         elm_object_cursor_set(Evas_Object *obj, const char *cursor) EINA_ARG_NONNULL(1);
1611    EAPI const char  *elm_object_cursor_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1612    EAPI void         elm_object_cursor_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
1613    EAPI void         elm_object_cursor_style_set(Evas_Object *obj, const char *style) EINA_ARG_NONNULL(1);
1614    EAPI const char  *elm_object_cursor_style_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1615    EAPI void         elm_object_cursor_engine_only_set(Evas_Object *obj, Eina_Bool engine_only) EINA_ARG_NONNULL(1);
1616    EAPI Eina_Bool    elm_object_cursor_engine_only_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1617
1618    /* cursors */
1619    EAPI int          elm_cursor_engine_only_get(void);
1620    EAPI Eina_Bool    elm_cursor_engine_only_set(int engine_only);
1621
1622    /* menu */
1623    typedef struct _Elm_Menu_Item Elm_Menu_Item; /**< Item of Elm_Menu. Sub-type of Elm_Widget_Item */
1624    EAPI Evas_Object       *elm_menu_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
1625    EAPI void               elm_menu_parent_set(Evas_Object *obj, Evas_Object *parent) EINA_ARG_NONNULL(1);
1626    EAPI Evas_Object       *elm_menu_parent_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1627    EAPI void               elm_menu_move(Evas_Object *obj, Evas_Coord x, Evas_Coord y) EINA_ARG_NONNULL(1);
1628    EAPI void               elm_menu_close(Evas_Object *obj) EINA_ARG_NONNULL(1);
1629    EAPI const Eina_List   *elm_menu_items_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1630    EAPI Evas_Object       *elm_menu_item_object_get(const Elm_Menu_Item *it) EINA_ARG_NONNULL(1);
1631    EAPI Elm_Menu_Item     *elm_menu_item_add(Evas_Object *obj, Elm_Menu_Item *parent, const char *icon, const char *label, Evas_Smart_Cb func, const void *data) EINA_ARG_NONNULL(1);
1632    EAPI void               elm_menu_item_label_set(Elm_Menu_Item *item, const char *label) EINA_ARG_NONNULL(1);
1633    EAPI const char        *elm_menu_item_label_get(const Elm_Menu_Item *item) EINA_ARG_NONNULL(1);
1634    EAPI void               elm_menu_item_icon_set(Elm_Menu_Item *item, const char *icon) EINA_ARG_NONNULL(1, 2);
1635    EAPI const char        *elm_menu_item_icon_get(const Elm_Menu_Item *item) EINA_ARG_NONNULL(1);
1636    EAPI const Evas_Object *elm_menu_item_object_icon_get(const Elm_Menu_Item *item) EINA_ARG_NONNULL(1);
1637    EAPI void               elm_menu_item_selected_set(Elm_Menu_Item *item, Eina_Bool selected) EINA_ARG_NONNULL(1);
1638    EAPI Eina_Bool          elm_menu_item_selected_get(const Elm_Menu_Item *item) EINA_ARG_NONNULL(1);
1639    EAPI void               elm_menu_item_disabled_set(Elm_Menu_Item *item, Eina_Bool disabled) EINA_ARG_NONNULL(1);
1640    EAPI Eina_Bool          elm_menu_item_disabled_get(const Elm_Menu_Item *item) EINA_ARG_NONNULL(1);
1641    EAPI Elm_Menu_Item     *elm_menu_item_separator_add(Evas_Object *obj, Elm_Menu_Item *parent) EINA_ARG_NONNULL(1);
1642    EAPI Eina_Bool          elm_menu_item_is_separator(Elm_Menu_Item *item) EINA_ARG_NONNULL(1);
1643    EAPI void               elm_menu_item_del(Elm_Menu_Item *item) EINA_ARG_NONNULL(1);
1644    EAPI void               elm_menu_item_del_cb_set(Elm_Menu_Item *it, Evas_Smart_Cb func) EINA_ARG_NONNULL(1);
1645    EAPI void              *elm_menu_item_data_get(const Elm_Menu_Item *it) EINA_ARG_NONNULL(1);
1646    EAPI void               elm_menu_item_data_set(Elm_Menu_Item *item, const void *data) EINA_ARG_NONNULL(1);
1647    EAPI const Eina_List   *elm_menu_item_subitems_get(const Elm_Menu_Item *item) EINA_ARG_NONNULL(1);
1648    EAPI const Elm_Menu_Item *elm_menu_selected_item_get(const Evas_Object * obj) EINA_ARG_NONNULL(1);
1649    EAPI const Elm_Menu_Item *elm_menu_last_item_get(const Evas_Object * obj) EINA_ARG_NONNULL(1);
1650    EAPI const Elm_Menu_Item *elm_menu_first_item_get(const Evas_Object * obj) EINA_ARG_NONNULL(1);
1651    EAPI const Elm_Menu_Item *elm_menu_item_next_get(const Elm_Menu_Item *it) EINA_ARG_NONNULL(1);
1652    EAPI const Elm_Menu_Item *elm_menu_item_prev_get(const Elm_Menu_Item *it) EINA_ARG_NONNULL(1);
1653
1654    /* smart callbacks called:
1655     * "clicked" - the user clicked the empty space in the menu to dismiss. event_info is NULL.
1656     */
1657
1658    /* list */
1659    typedef enum _Elm_List_Mode
1660      {
1661         ELM_LIST_COMPRESS = 0,
1662         ELM_LIST_SCROLL,
1663         ELM_LIST_LIMIT,
1664         ELM_LIST_EXPAND,
1665         ELM_LIST_LAST
1666      } Elm_List_Mode;
1667    typedef struct _Elm_List_Item Elm_List_Item; /**< Item of Elm_List. Sub-type of Elm_Widget_Item */
1668    EAPI Evas_Object     *elm_list_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
1669    EAPI Elm_List_Item   *elm_list_item_append(Evas_Object *obj, const char *label, Evas_Object *icon, Evas_Object *end, Evas_Smart_Cb func, const void *data) EINA_ARG_NONNULL(1);
1670    EAPI Elm_List_Item   *elm_list_item_prepend(Evas_Object *obj, const char *label, Evas_Object *icon, Evas_Object *end, Evas_Smart_Cb func, const void *data) EINA_ARG_NONNULL(1);
1671    EAPI Elm_List_Item   *elm_list_item_insert_before(Evas_Object *obj, Elm_List_Item *before, const char *label, Evas_Object *icon, Evas_Object *end, Evas_Smart_Cb func, const void *data) EINA_ARG_NONNULL(1, 2);
1672    EAPI Elm_List_Item   *elm_list_item_insert_after(Evas_Object *obj, Elm_List_Item *after, const char *label, Evas_Object *icon, Evas_Object *end, Evas_Smart_Cb func, const void *data) EINA_ARG_NONNULL(1, 2);
1673    EAPI Elm_List_Item   *elm_list_item_sorted_insert(Evas_Object *obj, const char *label, Evas_Object *icon, Evas_Object *end, Evas_Smart_Cb func, const void *data, Eina_Compare_Cb cmp_func) EINA_ARG_NONNULL(1);
1674    EAPI void             elm_list_clear(Evas_Object *obj) EINA_ARG_NONNULL(1);
1675    EAPI void             elm_list_go(Evas_Object *obj) EINA_ARG_NONNULL(1);
1676    EAPI void             elm_list_multi_select_set(Evas_Object *obj, Eina_Bool multi) EINA_ARG_NONNULL(1);
1677    EAPI Eina_Bool        elm_list_multi_select_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1678    EAPI void             elm_list_mode_set(Evas_Object *obj, Elm_List_Mode mode) EINA_ARG_NONNULL(1);
1679    EAPI Elm_List_Mode    elm_list_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1680    EAPI void             elm_list_horizontal_set(Evas_Object *obj, Eina_Bool horizontal) EINA_ARG_NONNULL(1);
1681    EAPI Eina_Bool        elm_list_horizontal_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1682    EAPI void             elm_list_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select) EINA_ARG_NONNULL(1);
1683    EAPI Eina_Bool        elm_list_always_select_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1684    EAPI const Eina_List *elm_list_items_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1685    EAPI Elm_List_Item   *elm_list_selected_item_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1686    EAPI const Eina_List *elm_list_selected_items_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1687    EAPI void             elm_list_item_separator_set(Elm_List_Item *it, Eina_Bool setting) EINA_ARG_NONNULL(1);
1688    EAPI Eina_Bool        elm_list_item_separator_get(const Elm_List_Item *it) EINA_ARG_NONNULL(1);
1689    EAPI void             elm_list_item_selected_set(Elm_List_Item *item, Eina_Bool selected) EINA_ARG_NONNULL(1);
1690    EAPI Eina_Bool        elm_list_item_selected_get(const Elm_List_Item *item) EINA_ARG_NONNULL(1);
1691    EAPI void             elm_list_item_show(Elm_List_Item *item) EINA_ARG_NONNULL(1);
1692    EAPI void             elm_list_item_bring_in(Elm_List_Item *item) EINA_ARG_NONNULL(1);
1693    EAPI void             elm_list_item_del(Elm_List_Item *item) EINA_ARG_NONNULL(1);
1694    EAPI void             elm_list_item_del_cb_set(Elm_List_Item *item, Evas_Smart_Cb func) EINA_ARG_NONNULL(1);
1695    EAPI void            *elm_list_item_data_get(const Elm_List_Item *item) EINA_ARG_NONNULL(1);
1696    EAPI Evas_Object     *elm_list_item_icon_get(const Elm_List_Item *item) EINA_ARG_NONNULL(1);
1697    EAPI void             elm_list_item_icon_set(Elm_List_Item *item, Evas_Object *icon) EINA_ARG_NONNULL(1);
1698    EAPI Evas_Object     *elm_list_item_end_get(const Elm_List_Item *item) EINA_ARG_NONNULL(1);
1699    EAPI void             elm_list_item_end_set(Elm_List_Item *item, Evas_Object *end) EINA_ARG_NONNULL(1);
1700    EAPI Evas_Object     *elm_list_item_base_get(const Elm_List_Item *item) EINA_ARG_NONNULL(1);
1701    EAPI const char      *elm_list_item_label_get(const Elm_List_Item *item) EINA_ARG_NONNULL(1);
1702    EAPI void             elm_list_item_label_set(Elm_List_Item *item, const char *text) EINA_ARG_NONNULL(1);
1703    EAPI Elm_List_Item   *elm_list_item_prev(const Elm_List_Item *it) EINA_ARG_NONNULL(1);
1704    EAPI Elm_List_Item   *elm_list_item_next(const Elm_List_Item *it) EINA_ARG_NONNULL(1);
1705    EAPI void             elm_list_item_tooltip_text_set(Elm_List_Item *item, const char *text) EINA_ARG_NONNULL(1);
1706    EAPI void             elm_list_item_tooltip_content_cb_set(Elm_List_Item *item, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb) EINA_ARG_NONNULL(1);
1707    EAPI void             elm_list_item_tooltip_unset(Elm_List_Item *item) EINA_ARG_NONNULL(1);
1708    EAPI void             elm_list_item_tooltip_style_set(Elm_List_Item *item, const char *style) EINA_ARG_NONNULL(1);
1709    EAPI const char      *elm_list_item_tooltip_style_get(const Elm_List_Item *item) EINA_ARG_NONNULL(1);
1710    EAPI void             elm_list_item_cursor_set(Elm_List_Item *item, const char *cursor) EINA_ARG_NONNULL(1);
1711    EAPI const char      *elm_list_item_cursor_get(const Elm_List_Item *item) EINA_ARG_NONNULL(1);
1712    EAPI void             elm_list_item_cursor_unset(Elm_List_Item *item) EINA_ARG_NONNULL(1);
1713    EAPI void             elm_list_item_cursor_style_set(Elm_List_Item *item, const char *style) EINA_ARG_NONNULL(1);
1714    EAPI const char      *elm_list_item_cursor_style_get(const Elm_List_Item *item) EINA_ARG_NONNULL(1);
1715    EAPI void             elm_list_item_cursor_engine_only_set(Elm_List_Item *item, Eina_Bool engine_only) EINA_ARG_NONNULL(1);
1716    EAPI Eina_Bool        elm_list_item_cursor_engine_only_get(const Elm_List_Item *item) EINA_ARG_NONNULL(1);
1717    EAPI void             elm_list_item_disabled_set(Elm_List_Item *it, Eina_Bool disabled) EINA_ARG_NONNULL(1);
1718    EAPI Eina_Bool        elm_list_item_disabled_get(const Elm_List_Item *it) EINA_ARG_NONNULL(1);
1719    EAPI void             elm_list_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce) EINA_ARG_NONNULL(1);
1720    EAPI void             elm_list_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce) EINA_ARG_NONNULL(1);
1721    EAPI void             elm_list_scroller_policy_set(Evas_Object *obj, Elm_Scroller_Policy policy_h, Elm_Scroller_Policy policy_v) EINA_ARG_NONNULL(1);
1722    EAPI void             elm_list_scroller_policy_get(const Evas_Object *obj, Elm_Scroller_Policy *policy_h, Elm_Scroller_Policy *policy_v) EINA_ARG_NONNULL(1);
1723    /* smart callbacks called:
1724     * "clicked" - when the user double-clicked an item
1725     * "selected" - when the user selected an item
1726     * "unselected" - when the user selected an item
1727     * "longpressed" - an item in the hoversel list is long-pressed
1728     * "scroll,edge,top" - the list is scrolled until the top edge
1729     * "scroll,edge,bottom" - the list is scrolled until the bottom edge
1730     * "scroll,edge,left" - the list is scrolled until the left edge
1731     * "scroll,edge,right" - the list is scrolled until the right edge
1732     */
1733
1734    // FIXME: incomplete - carousel. don't use this until this comment is removed
1735    typedef struct _Elm_Carousel_Item Elm_Carousel_Item;
1736    EAPI Evas_Object       *elm_carousel_add(Evas_Object *parent);
1737    EAPI Elm_Carousel_Item *elm_carousel_item_add(Evas_Object *obj, Evas_Object *icon, const char *label, Evas_Smart_Cb func, const void *data);
1738    EAPI void               elm_carousel_item_del(Elm_Carousel_Item *item);
1739    EAPI void               elm_carousel_item_select(Elm_Carousel_Item *item);
1740    /* smart callbacks called:
1741     * "clicked" - when the user clicks on a carousel item and becomes selected
1742     */
1743
1744    /* slider */
1745    EAPI Evas_Object       *elm_slider_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
1746    EAPI void               elm_slider_label_set(Evas_Object *obj, const char *label) EINA_ARG_NONNULL(1);
1747    EAPI const char        *elm_slider_label_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1748    EAPI void               elm_slider_icon_set(Evas_Object *obj, Evas_Object *icon) EINA_ARG_NONNULL(1);
1749    EAPI Evas_Object       *elm_slider_icon_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
1750    EAPI Evas_Object       *elm_slider_icon_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1751    EAPI void               elm_slider_end_set(Evas_Object *obj, Evas_Object *end) EINA_ARG_NONNULL(1);
1752    EAPI Evas_Object       *elm_slider_end_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
1753    EAPI Evas_Object       *elm_slider_end_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1754    EAPI void               elm_slider_span_size_set(Evas_Object *obj, Evas_Coord size) EINA_ARG_NONNULL(1);
1755    EAPI Evas_Coord         elm_slider_span_size_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1756    EAPI void               elm_slider_unit_format_set(Evas_Object *obj, const char *format) EINA_ARG_NONNULL(1);
1757    EAPI const char        *elm_slider_unit_format_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1758    EAPI void               elm_slider_indicator_format_set(Evas_Object *obj, const char *indicator) EINA_ARG_NONNULL(1);
1759    EAPI const char        *elm_slider_indicator_format_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1760    EAPI void               elm_slider_indicator_format_function_set(Evas_Object *obj, const char *(*func)(double val)) EINA_ARG_NONNULL(1);
1761    EAPI void               elm_slider_horizontal_set(Evas_Object *obj, Eina_Bool horizontal) EINA_ARG_NONNULL(1);
1762    EAPI Eina_Bool          elm_slider_horizontal_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1763    EAPI void               elm_slider_min_max_set(Evas_Object *obj, double min, double max) EINA_ARG_NONNULL(1);
1764    EAPI void               elm_slider_min_max_get(const Evas_Object *obj, double *min, double *max) EINA_ARG_NONNULL(1);
1765    EAPI void               elm_slider_value_set(Evas_Object *obj, double val) EINA_ARG_NONNULL(1);
1766    EAPI double             elm_slider_value_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1767    EAPI void               elm_slider_inverted_set(Evas_Object *obj, Eina_Bool inverted) EINA_ARG_NONNULL(1);
1768    EAPI Eina_Bool          elm_slider_inverted_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1769    EAPI void               elm_slider_indicator_show_set(Evas_Object *obj, Eina_Bool show) EINA_ARG_NONNULL(1);
1770    EAPI Eina_Bool          elm_slider_indicator_show_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1771    /* smart callbacks called:
1772     * "changed" - Whenever the slider value is changed by the user.
1773     * "slider,drag,start" - dragging the slider indicator around has started
1774     * "slider,drag,stop" - dragging the slider indicator around has stopped
1775     * "delay,changed" - A short time after the value is changed by the user.
1776     *                   This will be called only when the user stops dragging for a very short
1777     *                   period or when they release their finger/mouse, so it avoids possibly
1778     *                   expensive reactions to the value change.
1779     */
1780
1781
1782    /* actionslider */
1783
1784    typedef enum _Elm_Actionslider_Pos
1785      {
1786         ELM_ACTIONSLIDER_NONE = 0,
1787         ELM_ACTIONSLIDER_LEFT = 1 << 0,
1788         ELM_ACTIONSLIDER_CENTER = 1 << 1,
1789         ELM_ACTIONSLIDER_RIGHT = 1 << 2,
1790         ELM_ACTIONSLIDER_ALL = (1 << 3) -1
1791      } Elm_Actionslider_Pos;
1792
1793    typedef enum _Elm_Actionslider_Indicator_Pos
1794      {
1795         ELM_ACTIONSLIDER_INDICATOR_NONE,
1796         ELM_ACTIONSLIDER_INDICATOR_LEFT,
1797         ELM_ACTIONSLIDER_INDICATOR_RIGHT,
1798         ELM_ACTIONSLIDER_INDICATOR_CENTER
1799      } Elm_Actionslider_Indicator_Pos;
1800
1801    typedef enum _Elm_Actionslider_Magnet_Pos
1802      {
1803         ELM_ACTIONSLIDER_MAGNET_NONE = 0,
1804         ELM_ACTIONSLIDER_MAGNET_LEFT = 1 << 0,
1805         ELM_ACTIONSLIDER_MAGNET_CENTER = 1 << 1,
1806         ELM_ACTIONSLIDER_MAGNET_RIGHT= 1 << 2,
1807         ELM_ACTIONSLIDER_MAGNET_ALL = (1 << 3) -1,
1808         ELM_ACTIONSLIDER_MAGNET_BOTH = (1 << 3)
1809      } Elm_Actionslider_Magnet_Pos;
1810
1811    typedef enum _Elm_Actionslider_Label_Pos
1812      {
1813         ELM_ACTIONSLIDER_LABEL_LEFT,
1814         ELM_ACTIONSLIDER_LABEL_RIGHT,
1815         ELM_ACTIONSLIDER_LABEL_CENTER,
1816         ELM_ACTIONSLIDER_LABEL_BUTTON
1817      } Elm_Actionslider_Label_Pos;
1818
1819    EAPI Evas_Object                     *elm_actionslider_add(Evas_Object *parent);
1820    EAPI void                             elm_actionslider_indicator_pos_set(Evas_Object *obj, Elm_Actionslider_Indicator_Pos pos);
1821    EAPI Elm_Actionslider_Indicator_Pos   elm_actionslider_indicator_pos_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1822    EAPI void                             elm_actionslider_magnet_pos_set(Evas_Object *obj, Elm_Actionslider_Magnet_Pos pos);
1823    EAPI Elm_Actionslider_Magnet_Pos      elm_actionslider_magnet_pos_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1824    EAPI void                             elm_actionslider_label_set(Evas_Object *obj, Elm_Actionslider_Label_Pos pos, const char *label);
1825    EAPI void                             elm_actionslider_labels_get(const Evas_Object *obj, const char **left_label, const char **center_label, const char **right_label) EINA_ARG_NONNULL(1);
1826    EAPI const char                      *elm_actionslider_selected_label_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1827    EAPI void                             elm_actionslider_enabled_pos_set(Evas_Object *obj, Elm_Actionslider_Magnet_Pos pos) EINA_ARG_NONNULL(1);
1828    EAPI Elm_Actionslider_Magnet_Pos      elm_actionslider_enabled_pos_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1829    EAPI void                             elm_actionslider_indicator_label_set(Evas_Object *obj, const char *label) EINA_ARG_NONNULL(1);
1830    EAPI const char                      *elm_actionslider_indicator_label_get(Evas_Object *obj) EINA_ARG_NONNULL(1);
1831    EAPI void                             elm_actionslider_hold(Evas_Object *obj, Eina_Bool flag);
1832    /* smart callbacks called:
1833     * "indicator,position" - when a button reaches to the special position like "left", "right" and "center".
1834     */
1835
1836    /* genlist */
1837    typedef enum _Elm_Genlist_Item_Flags
1838      {
1839         ELM_GENLIST_ITEM_NONE = 0,
1840         ELM_GENLIST_ITEM_SUBITEMS = (1 << 0),
1841         ELM_GENLIST_ITEM_GROUP = (1 << 1)
1842      } Elm_Genlist_Item_Flags;
1843    typedef struct _Elm_Genlist_Item_Class Elm_Genlist_Item_Class;
1844    typedef struct _Elm_Genlist_Item       Elm_Genlist_Item; /**< Item of Elm_Genlist. Sub-type of Elm_Widget_Item */
1845    typedef struct _Elm_Genlist_Item_Class_Func Elm_Genlist_Item_Class_Func;
1846    typedef char        *(*GenlistItemLabelGetFunc) (const void *data, Evas_Object *obj, const char *part);
1847    typedef Evas_Object *(*GenlistItemIconGetFunc)  (const void *data, Evas_Object *obj, const char *part);
1848    typedef Eina_Bool    (*GenlistItemStateGetFunc) (const void *data, Evas_Object *obj, const char *part);
1849    typedef void         (*GenlistItemDelFunc)      (const void *data, Evas_Object *obj);
1850    typedef void         (*GenlistItemMovedFunc)    ( Evas_Object *genlist, Elm_Genlist_Item *item, Elm_Genlist_Item *rel_item, Eina_Bool move_after);
1851
1852    struct _Elm_Genlist_Item_Class
1853      {
1854         const char                *item_style;
1855         struct {
1856           GenlistItemLabelGetFunc  label_get;
1857           GenlistItemIconGetFunc   icon_get;
1858           GenlistItemStateGetFunc  state_get;
1859           GenlistItemDelFunc       del;
1860           GenlistItemMovedFunc     moved;
1861         } func;
1862         const char *edit_item_style;
1863         const char                *mode_item_style;
1864      };
1865    EAPI Evas_Object      *elm_genlist_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
1866    EAPI void              elm_genlist_clear(Evas_Object *obj) EINA_ARG_NONNULL(1);
1867    EAPI void              elm_genlist_multi_select_set(Evas_Object *obj, Eina_Bool multi) EINA_ARG_NONNULL(1);
1868    EAPI Eina_Bool         elm_genlist_multi_select_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1869    EAPI void              elm_genlist_horizontal_mode_set(Evas_Object *obj, Elm_List_Mode mode) EINA_ARG_NONNULL(1);
1870    EAPI Elm_List_Mode     elm_genlist_horizontal_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1871    EAPI void              elm_genlist_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select) EINA_ARG_NONNULL(1);
1872    EAPI Eina_Bool         elm_genlist_always_select_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1873    EAPI void              elm_genlist_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select) EINA_ARG_NONNULL(1);
1874    EAPI Eina_Bool         elm_genlist_no_select_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1875    EAPI void              elm_genlist_compress_mode_set(Evas_Object *obj, Eina_Bool compress) EINA_ARG_NONNULL(1);
1876    EAPI Eina_Bool         elm_genlist_compress_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1877    EAPI void              elm_genlist_height_for_width_mode_set(Evas_Object *obj, Eina_Bool height_for_width) EINA_ARG_NONNULL(1);
1878    EAPI Eina_Bool         elm_genlist_height_for_width_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1879    EAPI void              elm_genlist_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce) EINA_ARG_NONNULL(1);
1880    EAPI void              elm_genlist_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce) EINA_ARG_NONNULL(1);
1881    EAPI void              elm_genlist_homogeneous_set(Evas_Object *obj, Eina_Bool homogeneous) EINA_ARG_NONNULL(1);
1882    EAPI Eina_Bool         elm_genlist_homogeneous_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1883    EAPI void              elm_genlist_block_count_set(Evas_Object *obj, int n) EINA_ARG_NONNULL(1);
1884    EAPI int               elm_genlist_block_count_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1885    EAPI void              elm_genlist_longpress_timeout_set(Evas_Object *obj, double timeout) EINA_ARG_NONNULL(1);
1886    EAPI double            elm_genlist_longpress_timeout_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1887    /* operations to add items */
1888    EAPI Elm_Genlist_Item *elm_genlist_item_append(Evas_Object *obj, const Elm_Genlist_Item_Class *itc, const void *data, Elm_Genlist_Item *parent, Elm_Genlist_Item_Flags flags, Evas_Smart_Cb func, const void *func_data) EINA_ARG_NONNULL(1);
1889    EAPI Elm_Genlist_Item *elm_genlist_item_prepend(Evas_Object *obj, const Elm_Genlist_Item_Class *itc, const void *data, Elm_Genlist_Item *parent, Elm_Genlist_Item_Flags flags, Evas_Smart_Cb func, const void *func_data) EINA_ARG_NONNULL(1);
1890    EAPI Elm_Genlist_Item *elm_genlist_item_insert_before(Evas_Object *obj, const Elm_Genlist_Item_Class *itc, const void *data, Elm_Genlist_Item *parent, Elm_Genlist_Item *before, Elm_Genlist_Item_Flags flags, Evas_Smart_Cb func, const void *func_data) EINA_ARG_NONNULL(1, 5);
1891    EAPI Elm_Genlist_Item *elm_genlist_item_insert_after(Evas_Object *obj, const Elm_Genlist_Item_Class *itc, const void *data, Elm_Genlist_Item *parent, Elm_Genlist_Item *after, Elm_Genlist_Item_Flags flags, Evas_Smart_Cb func, const void *func_data) EINA_ARG_NONNULL(1, 5);
1892    /* operations to retrieve existing items */
1893    EAPI Elm_Genlist_Item *elm_genlist_selected_item_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1894    EAPI const Eina_List  *elm_genlist_selected_items_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1895    EAPI Eina_List        *elm_genlist_realized_items_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1896    EAPI Elm_Genlist_Item *elm_genlist_at_xy_item_get(const Evas_Object *obj, Evas_Coord x, Evas_Coord y, int *posret) EINA_ARG_NONNULL(1);
1897    EAPI Elm_Genlist_Item *elm_genlist_first_item_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1898    EAPI Elm_Genlist_Item *elm_genlist_last_item_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
1899    EAPI void              elm_genlist_scroller_policy_set(Evas_Object *obj, Elm_Scroller_Policy policy_h, Elm_Scroller_Policy policy_v) EINA_ARG_NONNULL(1);
1900    EAPI void              elm_genlist_scroller_policy_get(const Evas_Object *obj, Elm_Scroller_Policy *policy_h, Elm_Scroller_Policy *policy_v) EINA_ARG_NONNULL(1);
1901    /* available item styles:
1902     * default
1903     * default_style - The text part is a textblock
1904     * double_label
1905     * icon_top_text_bottom
1906     */
1907    /* Genlist Item operation */
1908    EAPI Elm_Genlist_Item  *elm_genlist_item_next_get(const Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1909    EAPI Elm_Genlist_Item  *elm_genlist_item_prev_get(const Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1910    EAPI Evas_Object       *elm_genlist_item_genlist_get(const Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1911    EAPI Elm_Genlist_Item  *elm_genlist_item_parent_get(const Elm_Genlist_Item *it) EINA_ARG_NONNULL(1);
1912    EAPI void               elm_genlist_item_subitems_clear(Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1913    EAPI void               elm_genlist_item_selected_set(Elm_Genlist_Item *item, Eina_Bool selected) EINA_ARG_NONNULL(1);
1914    EAPI Eina_Bool          elm_genlist_item_selected_get(const Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1915    EAPI void               elm_genlist_item_expanded_set(Elm_Genlist_Item *item, Eina_Bool expanded) EINA_ARG_NONNULL(1);
1916    EAPI Eina_Bool          elm_genlist_item_expanded_get(const Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1917    EAPI int                elm_genlist_item_expanded_depth_get(const Elm_Genlist_Item *it) EINA_ARG_NONNULL(1);
1918    EAPI void               elm_genlist_item_disabled_set(Elm_Genlist_Item *item, Eina_Bool disabled) EINA_ARG_NONNULL(1);
1919    EAPI Eina_Bool          elm_genlist_item_disabled_get(const Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1920    EAPI void               elm_genlist_item_display_only_set(Elm_Genlist_Item *it, Eina_Bool display_only) EINA_ARG_NONNULL(1);
1921    EAPI Eina_Bool          elm_genlist_item_display_only_get(const Elm_Genlist_Item *it) EINA_ARG_NONNULL(1);
1922    EAPI void               elm_genlist_item_show(Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1923    EAPI void               elm_genlist_item_bring_in(Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1924    EAPI void               elm_genlist_item_top_show(Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1925    EAPI void               elm_genlist_item_top_bring_in(Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1926    EAPI void               elm_genlist_item_middle_show(Elm_Genlist_Item *it) EINA_ARG_NONNULL(1);
1927    EAPI void               elm_genlist_item_middle_bring_in(Elm_Genlist_Item *it) EINA_ARG_NONNULL(1);
1928    EAPI void               elm_genlist_item_del(Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1929    EAPI void              *elm_genlist_item_data_get(const Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1930    EAPI void               elm_genlist_item_data_set(Elm_Genlist_Item *it, const void *data) EINA_ARG_NONNULL(1);
1931    EAPI void               elm_genlist_item_icons_orphan(Elm_Genlist_Item *it) EINA_ARG_NONNULL(1);
1932    EAPI const Evas_Object *elm_genlist_item_object_get(const Elm_Genlist_Item *it) EINA_ARG_NONNULL(1);
1933    EAPI void               elm_genlist_item_update(Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1934    EAPI void               elm_genlist_item_item_class_update(Elm_Genlist_Item *it, const Elm_Genlist_Item_Class *itc) EINA_ARG_NONNULL(1, 2);
1935    EAPI void               elm_genlist_item_tooltip_text_set(Elm_Genlist_Item *item, const char *text) EINA_ARG_NONNULL(1);
1936    EAPI void               elm_genlist_item_tooltip_content_cb_set(Elm_Genlist_Item *item, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb) EINA_ARG_NONNULL(1);
1937    EAPI void               elm_genlist_item_tooltip_unset(Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1938    EAPI void               elm_genlist_item_tooltip_style_set(Elm_Genlist_Item *item, const char *style) EINA_ARG_NONNULL(1);
1939    EAPI const char        *elm_genlist_item_tooltip_style_get(const Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1940    EAPI void               elm_genlist_item_cursor_set(Elm_Genlist_Item *item, const char *cursor) EINA_ARG_NONNULL(1);
1941    EAPI const char        *elm_genlist_item_cursor_get(const Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1942    EAPI void               elm_genlist_item_cursor_unset(Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1943    EAPI void               elm_genlist_item_cursor_style_set(Elm_Genlist_Item *item, const char *style) EINA_ARG_NONNULL(1);
1944    EAPI const char        *elm_genlist_item_cursor_style_get(const Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1945    EAPI void               elm_genlist_item_cursor_engine_only_set(Elm_Genlist_Item *item, Eina_Bool engine_only) EINA_ARG_NONNULL(1);
1946    EAPI Eina_Bool          elm_genlist_item_cursor_engine_only_get(const Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
1947    EAPI void               elm_genlist_realized_items_update(Evas_Object *obj) EINA_ARG_NONNULL(1);
1948    /* smart callbacks called:
1949     * "clicked,double" - This is called when a user has double-clicked an item. The
1950     *                    event_info parameter is the genlist item that was double-clicked.
1951     * "selected" - This is called when a user has made an item selected. The
1952     *              event_info parameter is the genlist item that was selected.
1953     * "unselected" - This is called when a user has made an item unselected. The
1954     *                 event_info parameter is the genlist item that was unselected.
1955     * "expanded" - This is called when elm_genlist_item_expanded_set() is called
1956     *              and the item is now meant to be expanded. The event_info parameter is the
1957     *              genlist item that was indicated to expand. It is the job of this callback
1958     *              to then fill in the child items.
1959     * "contracted" - This is called when elm_genlist_item_expanded_set() is called
1960     *                and the item is now meant to be contracted. The event_info parameter is
1961     *                the genlist item that was indicated to contract. It is the job of this
1962     *                callback to then delete the child items.
1963     * "expand,request" - This is called when a user has indicated they want to
1964     *                    expand a tree branch item. The callback should decide if the item can
1965     *                    expand (has any children) and then call elm_genlist_item_expanded_set()
1966     *                    appropriately to set the state. The event_info parameter is the genlist
1967     *                    item that was indicated to expand.
1968     * "contract,request" - This is called when a user has indicated they want to
1969     *                      contract a tree branch item. The callback should decide if the item can
1970     *                      contract (has any children) and then call elm_genlist_item_expanded_set()
1971     *                      appropriately to set the state. The event_info parameter is the genlist
1972     *                      item that was indicated to contract.
1973     * "realized" - This is called when the item in the list is created as a real
1974     *              evas object. event_info parameter is the genlist item that was created.
1975     *              The object may be deleted at any time, so it is up to the caller to
1976     *              not use the object pointer from elm_genlist_item_object_get() in a way
1977     *              where it may point to freed objects.
1978     * "unrealized" - This is called just before an item is unrealized. After
1979     *                this call icon objects provided will be deleted and the item object
1980     *                itself delete or be put into a floating cache.
1981     * "drag,start,up" - This is called when the item in the list has been dragged
1982     *                   (not scrolled) up.
1983     * "drag,start,down" - This is called when the item in the list has been dragged
1984     *                     (not scrolled) down.
1985     * "drag,start,left" - This is called when the item in the list has been dragged i
1986     *                     (not scrolled) left.
1987     * "drag,start,right" - This is called when the item in the list has been dragged
1988     *                      (not scrolled) right.
1989     * "drag,stop" - This is called when the item in the list has stopped being
1990     *               dragged.
1991     * "drag" - This is called when the item in the list is being dragged.
1992     * "longpressed" - This is called when the item is pressed for a certain amount
1993     *                 of time. By default it's 1 second.
1994     * "scroll,edge,top" - This is called when the genlist is scrolled until the
1995     *                     top edge.
1996     * "scroll,edge,bottom" - This is called when the genlist is scrolled until the
1997     *                         bottom edge.
1998     * "scroll,edge,left" - This is called when the genlist is scrolled until the
1999     *                      left edge.
2000     * "scroll,edge,right" - This is called when the genlist is scrolled until the
2001     *                       right edge.
2002     * "multi,swipe,left" - This is called when the genlist is multi-touch swiped
2003     *                       left.
2004     * "multi,swipe,right" - This is called when the genlist is multi-touch swiped
2005     *                       right.
2006     * "multi,swipe,up" - This is called when the genlist is multi-touch swiped up.
2007     * "multi,swipe,down" - This is called when the genlist is multi-touch swiped
2008     *                      down.
2009     * "multi,pinch,out" - This is called when the genlist is multi-touch pinched
2010     *                     out.
2011     * "multi,pinch,in" - This is called when the genlist is multi-touch pinched in.
2012     */
2013
2014    EAPI void               elm_genlist_edit_mode_set(Evas_Object *obj, Eina_Bool edit_mode) EINA_ARG_NONNULL(1);
2015    EAPI Eina_Bool          elm_genlist_edit_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2016    EAPI void               elm_genlist_item_rename_mode_set(Elm_Genlist_Item *it, Eina_Bool renamed) EINA_ARG_NONNULL(1);
2017    EAPI Eina_Bool          elm_genlist_item_rename_mode_get(Elm_Genlist_Item *item) EINA_ARG_NONNULL(1);
2018    EAPI void               elm_genlist_item_move_after(Elm_Genlist_Item *it, Elm_Genlist_Item *after ) EINA_ARG_NONNULL(1, 2);
2019    EAPI void               elm_genlist_item_move_before(Elm_Genlist_Item *it, Elm_Genlist_Item *before) EINA_ARG_NONNULL(1, 2);
2020    EAPI void               elm_genlist_effect_set(const Evas_Object *obj, Eina_Bool emode) EINA_ARG_NONNULL(1);
2021    EAPI void               elm_genlist_pinch_zoom_set(Evas_Object *obj, Eina_Bool emode) EINA_ARG_NONNULL(1);
2022    EAPI void               elm_genlist_pinch_zoom_mode_set(Evas_Object *obj, Eina_Bool emode) EINA_ARG_NONNULL(1);
2023    EAPI Eina_Bool          elm_genlist_pinch_zoom_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2024    EAPI void               elm_genlist_reorder_mode_set(Evas_Object *obj, Eina_Bool reorder_mode) EINA_ARG_NONNULL(1);
2025    EAPI Eina_Bool          elm_genlist_reorder_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2026    EINA_DEPRECATED EAPI void elm_genlist_selected_items_del(Evas_Object *obj);
2027    EINA_DEPRECATED EAPI void elm_genlist_queue_exception_set(const Evas_Object *obj, Eina_Bool emode);
2028    EINA_DEPRECATED EAPI void               elm_genlist_edit_selected_items_del(Evas_Object *obj);
2029    EINA_DEPRECATED EAPI Eina_List         *elm_genlist_edit_selected_items_get(const Evas_Object *obj);
2030    EINA_DEPRECATED EAPI void               elm_genlist_edit_item_selected_set(Elm_Genlist_Item *it, Eina_Bool selected);
2031    EINA_DEPRECATED EAPI Eina_Bool          elm_genlist_edit_item_selected_get(const Elm_Genlist_Item *it) EINA_ARG_NONNULL(1);
2032    EAPI void               elm_genlist_item_mode_set(Elm_Genlist_Item *it, const char *mode_type, Eina_Bool mode_set) EINA_ARG_NONNULL(1, 2);
2033    EAPI const char        *elm_genlist_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2034    EAPI const Elm_Genlist_Item *elm_genlist_mode_item_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2035
2036   /* check */
2037    EAPI Evas_Object *elm_check_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2038    EAPI void         elm_check_label_set(Evas_Object *obj, const char *label); EINA_ARG_NONNULL(1)
2039    EAPI const char  *elm_check_label_get(const Evas_Object *obj); EINA_ARG_NONNULL(1)
2040    EAPI void         elm_check_icon_set(Evas_Object *obj, Evas_Object *icon); EINA_ARG_NONNULL(1)
2041    EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj); EINA_ARG_NONNULL(1)
2042    EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj); EINA_ARG_NONNULL(1)
2043    EAPI void         elm_check_state_set(Evas_Object *obj, Eina_Bool state); EINA_ARG_NONNULL(1)
2044    EAPI Eina_Bool    elm_check_state_get(const Evas_Object *obj); EINA_ARG_NONNULL(1)
2045    EAPI void         elm_check_state_pointer_set(Evas_Object *obj, Eina_Bool *statep); EINA_ARG_NONNULL(1)
2046    /* smart callbacks called:
2047     * "changed" - This is called whenever the user changes the state of one of the check object.
2048     */
2049
2050    /* radio */
2051    EAPI Evas_Object *elm_radio_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2052    EAPI void         elm_radio_label_set(Evas_Object *obj, const char *label) EINA_ARG_NONNULL(1);
2053    EAPI const char  *elm_radio_label_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2054    EAPI void         elm_radio_icon_set(Evas_Object *obj, Evas_Object *icon) EINA_ARG_NONNULL(1);
2055    EAPI Evas_Object *elm_radio_icon_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2056    EAPI Evas_Object *elm_radio_icon_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
2057    EAPI void         elm_radio_group_add(Evas_Object *obj, Evas_Object *group) EINA_ARG_NONNULL(1);
2058    EAPI void         elm_radio_state_value_set(Evas_Object *obj, int value) EINA_ARG_NONNULL(1);
2059    EAPI int          elm_radio_state_value_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2060    EAPI void         elm_radio_value_set(Evas_Object *obj, int value) EINA_ARG_NONNULL(1);
2061    EAPI int          elm_radio_value_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2062    EAPI void         elm_radio_value_pointer_set(Evas_Object *obj, int *valuep) EINA_ARG_NONNULL(1);
2063    /* smart callbacks called:
2064     * "changed" - when the radio status is changed
2065     */
2066
2067    EAPI Evas_Object *elm_page_control_add(Evas_Object *parent);
2068    EAPI void         elm_page_control_page_count_set(Evas_Object *obj, unsigned int page_count);
2069    EAPI void         elm_page_control_page_id_set(Evas_Object *obj, unsigned int page_id);
2070    EAPI unsigned int elm_page_control_page_id_get(Evas_Object *obj);
2071    /* pager */
2072    EAPI Evas_Object *elm_pager_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2073    EAPI void         elm_pager_content_push(Evas_Object *obj, Evas_Object *content) EINA_ARG_NONNULL(1);
2074    EAPI void         elm_pager_content_pop(Evas_Object *obj) EINA_ARG_NONNULL(1);
2075    EAPI void         elm_pager_content_promote(Evas_Object *obj, Evas_Object *content) EINA_ARG_NONNULL(1);
2076    EAPI Evas_Object *elm_pager_content_bottom_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2077    EAPI Evas_Object *elm_pager_content_top_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2078    EAPI void         elm_pager_to_content_pop(Evas_Object *obj, Evas_Object *content); EINA_ARG_NONNULL(1);
2079    EAPI void         elm_pager_animation_disabled_set(Evas_Object *obj, Eina_Bool disable); EINA_ARG_NONNULL(1);
2080
2081    /* available item styles:
2082     * default
2083     * fade
2084     * fade_translucide
2085     * fade_invisible
2086     */
2087    /* smart callbacks called:
2088     * "hide,finished" - when the previous page is hided
2089     */
2090
2091    typedef struct _Elm_Slideshow_Item_Class Elm_Slideshow_Item_Class;
2092    typedef struct _Elm_Slideshow_Item_Class_Func Elm_Slideshow_Item_Class_Func;
2093    typedef struct _Elm_Slideshow_Item       Elm_Slideshow_Item; /**< Item of Elm_Slideshow. Sub-type of Elm_Widget_Item */
2094    typedef Evas_Object *(*SlideshowItemGetFunc) (void *data, Evas_Object *obj);
2095    typedef void         (*SlideshowItemDelFunc) (void *data, Evas_Object *obj);
2096
2097    struct _Elm_Slideshow_Item_Class
2098      {
2099         struct _Elm_Slideshow_Item_Class_Func
2100           {
2101              SlideshowItemGetFunc get;
2102              SlideshowItemDelFunc del;
2103           } func;
2104      };
2105
2106    EAPI Evas_Object        *elm_slideshow_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2107    EAPI Elm_Slideshow_Item *elm_slideshow_item_add(Evas_Object *obj, const Elm_Slideshow_Item_Class *itc, const void *data) EINA_ARG_NONNULL(1);
2108    EAPI void                elm_slideshow_show(Elm_Slideshow_Item *item) EINA_ARG_NONNULL(1);
2109    EAPI void                elm_slideshow_next(Evas_Object *obj) EINA_ARG_NONNULL(1);
2110    EAPI void                elm_slideshow_previous(Evas_Object *obj) EINA_ARG_NONNULL(1);
2111    EAPI const Eina_List    *elm_slideshow_transitions_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2112    EAPI void                elm_slideshow_transition_set(Evas_Object *obj, const char *transition) EINA_ARG_NONNULL(1);
2113    EAPI const char         *elm_slideshow_transition_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2114    EAPI void                elm_slideshow_timeout_set(Evas_Object *obj, double timeout) EINA_ARG_NONNULL(1);
2115    EAPI double              elm_slideshow_timeout_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2116    EAPI void                elm_slideshow_loop_set(Evas_Object *obj, Eina_Bool loop) EINA_ARG_NONNULL(1);
2117    EAPI Eina_Bool           elm_slideshow_loop_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2118    EAPI void                elm_slideshow_clear(Evas_Object *obj) EINA_ARG_NONNULL(1);
2119    EAPI const Eina_List    *elm_slideshow_items_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2120    EAPI void                elm_slideshow_item_del(Elm_Slideshow_Item *item) EINA_ARG_NONNULL(1);
2121    EAPI void               *elm_slideshow_item_data_get(const Elm_Slideshow_Item *item) EINA_ARG_NONNULL(1);
2122    EAPI Elm_Slideshow_Item *elm_slideshow_item_current_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2123    EAPI Evas_Object*        elm_slideshow_item_object_get(const Elm_Slideshow_Item* item) EINA_ARG_NONNULL(1);
2124    EAPI const char         *elm_slideshow_layout_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2125    EAPI void                elm_slideshow_layout_set(Evas_Object *obj, const char *layout) EINA_ARG_NONNULL(1);
2126    EAPI const Eina_List    *elm_slideshow_layouts_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2127    /* smart callbacks called:
2128     * "changed" - when the slideshow switch to another item
2129     */
2130
2131    /* file selector */
2132    typedef enum _Elm_Fileselector_Mode
2133      {
2134         ELM_FILESELECTOR_LIST = 0,
2135         ELM_FILESELECTOR_GRID,
2136         ELM_FILESELECTOR_LAST
2137      } Elm_Fileselector_Mode;
2138
2139    EAPI Evas_Object          *elm_fileselector_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2140    EAPI void                  elm_fileselector_is_save_set(Evas_Object *obj, Eina_Bool is_save) EINA_ARG_NONNULL(1);
2141    EAPI Eina_Bool             elm_fileselector_is_save_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2142    EAPI void                  elm_fileselector_folder_only_set(Evas_Object *obj, Eina_Bool only) EINA_ARG_NONNULL(1);
2143    EAPI Eina_Bool             elm_fileselector_folder_only_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2144    EAPI void                  elm_fileselector_buttons_ok_cancel_set(Evas_Object *obj, Eina_Bool buttons) EINA_ARG_NONNULL(1);
2145    EAPI Eina_Bool             elm_fileselector_buttons_ok_cancel_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2146    EAPI Eina_Bool             elm_fileselector_expandable_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2147    EAPI void                  elm_fileselector_expandable_set(Evas_Object *obj, Eina_Bool expand) EINA_ARG_NONNULL(1);
2148    EAPI void                  elm_fileselector_path_set(Evas_Object *obj, const char *path) EINA_ARG_NONNULL(1);
2149    EAPI const char           *elm_fileselector_path_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2150    EAPI const char           *elm_fileselector_selected_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2151    EAPI Eina_Bool             elm_fileselector_selected_set(Evas_Object *obj, const char *path) EINA_ARG_NONNULL(1);
2152    EAPI void                  elm_fileselector_mode_set(Evas_Object *obj, Elm_Fileselector_Mode mode) EINA_ARG_NONNULL(1);
2153    EAPI Elm_Fileselector_Mode elm_fileselector_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2154    /* smart callbacks called:
2155     * "selected" - the user click on a file
2156     * "directory,open" - the list is populate with a new content. event_info is a directory.
2157     * "done" - the user click on the ok or cancel buttons
2158     */
2159
2160    /* progressbar */
2161    EAPI Evas_Object *elm_progressbar_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2162    EAPI void         elm_progressbar_pulse_set(Evas_Object *obj, Eina_Bool pulse) EINA_ARG_NONNULL(1);
2163    EAPI Eina_Bool    elm_progressbar_pulse_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2164    EAPI void         elm_progressbar_pulse(Evas_Object *obj, Eina_Bool state) EINA_ARG_NONNULL(1);
2165    EAPI void         elm_progressbar_value_set(Evas_Object *obj, double val) EINA_ARG_NONNULL(1);
2166    EAPI double       elm_progressbar_value_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2167    EAPI void         elm_progressbar_label_set(Evas_Object *obj, const char *label) EINA_ARG_NONNULL(1);
2168    EAPI const char  *elm_progressbar_label_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2169    EAPI void         elm_progressbar_icon_set(Evas_Object *obj, Evas_Object *icon) EINA_ARG_NONNULL(1);
2170    EAPI Evas_Object *elm_progressbar_icon_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2171    EAPI Evas_Object *elm_progressbar_icon_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
2172    EAPI void         elm_progressbar_span_size_set(Evas_Object *obj, Evas_Coord size) EINA_ARG_NONNULL(1);
2173    EAPI Evas_Coord   elm_progressbar_span_size_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2174    EAPI void         elm_progressbar_unit_format_set(Evas_Object *obj, const char *format) EINA_ARG_NONNULL(1);
2175    EAPI const char  *elm_progressbar_unit_format_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2176    EAPI void         elm_progressbar_horizontal_set(Evas_Object *obj, Eina_Bool horizontal) EINA_ARG_NONNULL(1);
2177    EAPI Eina_Bool    elm_progressbar_horizontal_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2178    EAPI void         elm_progressbar_inverted_set(Evas_Object *obj, Eina_Bool inverted) EINA_ARG_NONNULL(1);
2179    EAPI Eina_Bool    elm_progressbar_inverted_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2180    /* smart callbacks called:
2181     */
2182    /* available item styles:
2183     * default
2184     * wheel (simple style, no text, no progression, only pulse is available)
2185     */
2186
2187    /* separator */
2188    EAPI Evas_Object *elm_separator_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2189    EAPI void         elm_separator_horizontal_set(Evas_Object *obj, Eina_Bool horizontal) EINA_ARG_NONNULL(1);
2190    EAPI Eina_Bool    elm_separator_horizontal_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2191    /* smart callbacks called:
2192     */
2193
2194    /* spinner */
2195    EAPI Evas_Object *elm_spinner_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2196    EAPI void         elm_spinner_label_format_set(Evas_Object *obj, const char *fmt) EINA_ARG_NONNULL(1);
2197    EAPI const char  *elm_spinner_label_format_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2198    EAPI void         elm_spinner_min_max_set(Evas_Object *obj, double min, double max) EINA_ARG_NONNULL(1);
2199    EAPI void         elm_spinner_min_max_get(const Evas_Object *obj, double *min, double *max) EINA_ARG_NONNULL(1);
2200    EAPI void         elm_spinner_step_set(Evas_Object *obj, double step) EINA_ARG_NONNULL(1);
2201    EAPI double       elm_spinner_step_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2202    EAPI void         elm_spinner_value_set(Evas_Object *obj, double val) EINA_ARG_NONNULL(1);
2203    EAPI double       elm_spinner_value_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2204    EAPI void         elm_spinner_wrap_set(Evas_Object *obj, Eina_Bool wrap) EINA_ARG_NONNULL(1);
2205    EAPI Eina_Bool    elm_spinner_wrap_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2206    EAPI void         elm_spinner_editable_set(Evas_Object *obj, Eina_Bool editable) EINA_ARG_NONNULL(1);
2207    EAPI Eina_Bool    elm_spinner_editable_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2208    EAPI void         elm_spinner_special_value_add(Evas_Object *obj, double value, const char *label) EINA_ARG_NONNULL(1);
2209    EAPI void         elm_spinner_interval_set(Evas_Object *obj, double interval) EINA_ARG_NONNULL(1);
2210    EAPI double       elm_spinner_interval_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2211    /* smart callbacks called:
2212     * "changed" - when the spinner value changes
2213     * "delay,changed" - when the spinner value changed, but a small time after a change (use this if you only want to respond to a change once the spinner is held still for a short while).
2214     */
2215    /* available item styles:
2216     * default
2217     * vertical (two up/down buttons at the right side and text left aligned)
2218     */
2219
2220    /* index */
2221    typedef struct _Elm_Index_Item Elm_Index_Item; /**< Item of Elm_Index. Sub-type of Elm_Widget_Item */
2222
2223    EAPI Evas_Object    *elm_index_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2224    EAPI void            elm_index_active_set(Evas_Object *obj, Eina_Bool active) EINA_ARG_NONNULL(1);
2225    EAPI void            elm_index_item_level_set(Evas_Object *obj, int level) EINA_ARG_NONNULL(1);
2226    EAPI int             elm_index_item_level_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2227    EAPI void           *elm_index_item_selected_get(const Evas_Object *obj, int level) EINA_ARG_NONNULL(1);
2228    EAPI void            elm_index_item_append(Evas_Object *obj, const char *letter, const void *item) EINA_ARG_NONNULL(1);
2229    EAPI void            elm_index_item_prepend(Evas_Object *obj, const char *letter, const void *item) EINA_ARG_NONNULL(1);
2230    EAPI void            elm_index_item_append_relative(Evas_Object *obj, const char *letter, const void *item, const void *relative) EINA_ARG_NONNULL(1);
2231    EAPI void            elm_index_item_prepend_relative(Evas_Object *obj, const char *letter, const void *item, const void *relative) EINA_ARG_NONNULL(1);
2232    EAPI void            elm_index_item_sorted_insert(Evas_Object *obj, const char *letter, const void *item, Eina_Compare_Cb cmp_func, Eina_Compare_Cb cmp_data_func) EINA_ARG_NONNULL(1);
2233    EAPI void            elm_index_item_del(Evas_Object *obj, const void *item) EINA_ARG_NONNULL(1);
2234    EAPI Elm_Index_Item *elm_index_item_find(Evas_Object *obj, const void *item) EINA_ARG_NONNULL(1);
2235    EAPI void            elm_index_item_clear(Evas_Object *obj) EINA_ARG_NONNULL(1);
2236    EAPI void            elm_index_item_go(Evas_Object *obj, int level) EINA_ARG_NONNULL(1);
2237    EAPI void           *elm_index_item_data_get(const Elm_Index_Item *item) EINA_ARG_NONNULL(1);
2238    EAPI void            elm_index_item_data_set(Elm_Index_Item *it, const void *data) EINA_ARG_NONNULL(1);
2239    EAPI void            elm_index_item_del_cb_set(Elm_Index_Item *it, Evas_Smart_Cb func) EINA_ARG_NONNULL(1);
2240    EAPI const char     *elm_index_item_letter_get(const Elm_Index_Item *item) EINA_ARG_NONNULL(1);
2241    EAPI void         elm_index_button_image_invisible_set(Evas_Object *obj, Eina_Bool invisible);
2242    /* smart callbacks called:
2243     * "changed" - when the selected index item changes
2244     * "delay,changed" - when the selected index item changes, but after some small idle period
2245     * "selected" - when the user releases a finger and selects an item
2246     * "level,up" - when the user moves a finger from the first level to the second level
2247     * "level,down" - when the user moves a finger from the second level to the first level
2248     */
2249
2250    /* photocam */
2251    typedef enum _Elm_Photocam_Zoom_Mode
2252      {
2253         ELM_PHOTOCAM_ZOOM_MODE_MANUAL = 0,
2254         ELM_PHOTOCAM_ZOOM_MODE_AUTO_FIT,
2255         ELM_PHOTOCAM_ZOOM_MODE_AUTO_FILL,
2256         ELM_PHOTOCAM_ZOOM_MODE_LAST
2257      } Elm_Photocam_Zoom_Mode;
2258
2259    EAPI Evas_Object           *elm_photocam_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2260    EAPI Evas_Load_Error        elm_photocam_file_set(Evas_Object *obj, const char *file) EINA_ARG_NONNULL(1);
2261    EAPI const char            *elm_photocam_file_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2262    EAPI void                   elm_photocam_zoom_set(Evas_Object *obj, double zoom) EINA_ARG_NONNULL(1);
2263    EAPI double                 elm_photocam_zoom_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2264    EAPI void                   elm_photocam_zoom_mode_set(Evas_Object *obj, Elm_Photocam_Zoom_Mode mode) EINA_ARG_NONNULL(1);
2265    EAPI Elm_Photocam_Zoom_Mode elm_photocam_zoom_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2266    EAPI void                   elm_photocam_image_size_get(const Evas_Object *obj, int *w, int *h) EINA_ARG_NONNULL(1);
2267    EAPI void                   elm_photocam_region_get(const Evas_Object *obj, int *x, int *y, int *w, int *h) EINA_ARG_NONNULL(1);
2268    EAPI void                   elm_photocam_image_region_show(Evas_Object *obj, int x, int y, int w, int h) EINA_ARG_NONNULL(1);
2269    EAPI void                   elm_photocam_image_region_bring_in(Evas_Object *obj, int x, int y, int w, int h) EINA_ARG_NONNULL(1);
2270    EAPI void                   elm_photocam_paused_set(Evas_Object *obj, Eina_Bool paused) EINA_ARG_NONNULL(1);
2271    EAPI Eina_Bool              elm_photocam_paused_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2272    EAPI Evas_Object           *elm_photocam_internal_image_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2273    EAPI void                   elm_photocam_bounce_set(Evas_Object *obj,  Eina_Bool h_bounce, Eina_Bool v_bounce) EINA_ARG_NONNULL(1);
2274    EAPI void                   elm_photocam_bounce_get(const Evas_Object *obj,  Eina_Bool *h_bounce, Eina_Bool *v_bounce) EINA_ARG_NONNULL(1);
2275    /* smart callbacks called:
2276     * "clicked" - when image clicked
2277     * "press" - when mouse/finger held down initially on image
2278     * "longpressed" - when mouse/finger held for long time on image
2279     * "clicked,double" - when mouse/finger double-clicked
2280     * "load" - when photo load begins
2281     * "loaded" - when photo load done
2282     * "load,details" - when detailed image load begins
2283     * "loaded,details" - when detailed image load done
2284     * "zoom,start" - when zooming started
2285     * "zoom,stop" - when zooming stopped
2286     * "zoom,change" - when auto zoom mode changed zoom level
2287     * "scroll - the content has been scrolled (moved)
2288     * "scroll,anim,start" - scrolling animation has started
2289     * "scroll,anim,stop" - scrolling animation has stopped
2290     * "scroll,drag,start" - dragging the contents around has started
2291     * "scroll,drag,stop" - dragging the contents around has stopped
2292     */
2293
2294    /* map */
2295    typedef enum _Elm_Map_Zoom_Mode
2296      {
2297         ELM_MAP_ZOOM_MODE_MANUAL,
2298         ELM_MAP_ZOOM_MODE_AUTO_FIT,
2299         ELM_MAP_ZOOM_MODE_AUTO_FILL,
2300         ELM_MAP_ZOOM_MODE_LAST
2301      } Elm_Map_Zoom_Mode;
2302
2303    typedef enum _Elm_Map_Route_Sources
2304      {
2305         ELM_MAP_ROUTE_SOURCE_YOURS,
2306         ELM_MAP_ROUTE_SOURCE_MONAV,
2307         ELM_MAP_ROUTE_SOURCE_ORS,
2308         ELM_MAP_ROUTE_SOURCE_LAST
2309      } Elm_Map_Route_Sources;
2310
2311    typedef enum _Elm_Map_Name_Sources
2312      {
2313         ELM_MAP_NAME_SOURCE_NOMINATIM,
2314         ELM_MAP_NAME_SOURCE_LAST
2315      } Elm_Map_Name_Sources;
2316
2317    typedef enum _Elm_Map_Route_Type
2318      {
2319         ELM_MAP_ROUTE_TYPE_MOTOCAR,
2320         ELM_MAP_ROUTE_TYPE_BICYCLE,
2321         ELM_MAP_ROUTE_TYPE_FOOT,
2322         ELM_MAP_ROUTE_TYPE_LAST
2323      } Elm_Map_Route_Type;
2324
2325    typedef enum _Elm_Map_Route_Method
2326      {
2327         ELM_MAP_ROUTE_METHOD_FASTEST,
2328         ELM_MAP_ROUTE_METHOD_SHORTEST,
2329         ELM_MAP_ROUTE_METHOD_LAST
2330      } Elm_Map_Route_Method;
2331
2332    typedef enum _Elm_Map_Name_Method
2333      {
2334         ELM_MAP_NAME_METHOD_SEARCH,
2335         ELM_MAP_NAME_METHOD_REVERSE,
2336         ELM_MAP_NAME_METHOD_LAST
2337      } Elm_Map_Name_Method;
2338
2339    typedef struct _Elm_Map_Marker          Elm_Map_Marker;
2340    typedef struct _Elm_Map_Marker_Class    Elm_Map_Marker_Class;
2341    typedef struct _Elm_Map_Group_Class     Elm_Map_Group_Class;
2342    typedef struct _Elm_Map_Route           Elm_Map_Route;
2343    typedef struct _Elm_Map_Name            Elm_Map_Name;
2344
2345    typedef Evas_Object *(*ElmMapMarkerGetFunc)      (Evas_Object *obj, Elm_Map_Marker *marker, void *data);
2346    typedef void         (*ElmMapMarkerDelFunc)      (Evas_Object *obj, Elm_Map_Marker *marker, void *data, Evas_Object *o);
2347    typedef Evas_Object *(*ElmMapMarkerIconGetFunc)  (Evas_Object *obj, Elm_Map_Marker *marker, void *data);
2348    typedef Evas_Object *(*ElmMapGroupIconGetFunc)   (Evas_Object *obj, void *data);
2349
2350    typedef char        *(*ElmMapModuleSourceFunc) (void);
2351    typedef int          (*ElmMapModuleZoomMinFunc) (void);
2352    typedef int          (*ElmMapModuleZoomMaxFunc) (void);
2353    typedef char        *(*ElmMapModuleUrlFunc) (Evas_Object *obj, int x, int y, int zoom);
2354    typedef int          (*ElmMapModuleRouteSourceFunc) (void);
2355    typedef char        *(*ElmMapModuleRouteUrlFunc) (Evas_Object *obj, char *type_name, int method, double flon, double flat, double tlon, double tlat);
2356    typedef char        *(*ElmMapModuleNameUrlFunc) (Evas_Object *obj, int method, char *name, double lon, double lat);
2357    typedef Eina_Bool    (*ElmMapModuleGeoIntoCoordFunc) (const Evas_Object *obj, int zoom, double lon, double lat, int size, int *x, int *y);
2358    typedef Eina_Bool    (*ElmMapModuleCoordIntoGeoFunc) (const Evas_Object *obj, int zoom, int x, int y, int size, double *lon, double *lat);
2359
2360    EAPI Evas_Object          *elm_map_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2361    EAPI void                  elm_map_zoom_set(Evas_Object *obj, int zoom) EINA_ARG_NONNULL(1);
2362    EAPI int                   elm_map_zoom_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2363    EAPI void                  elm_map_zoom_mode_set(Evas_Object *obj, Elm_Map_Zoom_Mode mode) EINA_ARG_NONNULL(1);
2364    EAPI Elm_Map_Zoom_Mode     elm_map_zoom_mode_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2365    EAPI void                  elm_map_geo_region_get(const Evas_Object *obj, double *lon, double *lat) EINA_ARG_NONNULL(1);
2366    EAPI void                  elm_map_geo_region_bring_in(Evas_Object *obj, double lon, double lat) EINA_ARG_NONNULL(1);
2367    EAPI void                  elm_map_geo_region_show(Evas_Object *obj, double lon, double lat) EINA_ARG_NONNULL(1);
2368    EAPI void                  elm_map_paused_set(Evas_Object *obj, Eina_Bool paused) EINA_ARG_NONNULL(1);
2369    EAPI Eina_Bool             elm_map_paused_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2370    EAPI void                  elm_map_paused_markers_set(Evas_Object *obj, Eina_Bool paused) EINA_ARG_NONNULL(1);
2371    EAPI Eina_Bool             elm_map_paused_markers_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2372    EAPI void                  elm_map_utils_downloading_status_get(const Evas_Object *obj, int *try_num, int *finish_num) EINA_ARG_NONNULL(1, 2, 3);
2373    EAPI void                  elm_map_utils_convert_coord_into_geo(const Evas_Object *obj, int x, int y, int size, double *lon, double *lat) EINA_ARG_NONNULL(1, 5, 6);
2374    EAPI void                  elm_map_utils_convert_geo_into_coord(const Evas_Object *obj, double lon, double lat, int size, int *x, int *y) EINA_ARG_NONNULL(1, 5, 6);
2375    EAPI Elm_Map_Name         *elm_map_utils_convert_coord_into_name(const Evas_Object *obj, double lon, double lat) EINA_ARG_NONNULL(1);
2376    EAPI Elm_Map_Name         *elm_map_utils_convert_name_into_coord(const Evas_Object *obj, char *address) EINA_ARG_NONNULL(1, 2);
2377    EAPI void                  elm_map_utils_rotate_coord(const Evas_Object *obj, const Evas_Coord x, const Evas_Coord y, const Evas_Coord cx, const Evas_Coord cy, const double degree, Evas_Coord *xx, Evas_Coord *yy) EINA_ARG_NONNULL(1);
2378    EAPI Elm_Map_Marker       *elm_map_marker_add(Evas_Object *obj, double lon, double lat, Elm_Map_Marker_Class *clas, Elm_Map_Group_Class *clas_group, void *data) EINA_ARG_NONNULL(1, 4, 5);
2379    EAPI void                  elm_map_max_marker_per_group_set(Evas_Object *obj, int max) EINA_ARG_NONNULL(1);
2380    EAPI void                  elm_map_marker_remove(Elm_Map_Marker *marker) EINA_ARG_NONNULL(1);
2381    EAPI void                  elm_map_marker_region_get(const Elm_Map_Marker *marker, double *lon, double *lat) EINA_ARG_NONNULL(1);
2382    EAPI void                  elm_map_marker_bring_in(Elm_Map_Marker *marker) EINA_ARG_NONNULL(1);
2383    EAPI void                  elm_map_marker_show(Elm_Map_Marker *marker) EINA_ARG_NONNULL(1);
2384    EAPI void                  elm_map_markers_list_show(Eina_List *markers) EINA_ARG_NONNULL(1);
2385    EAPI Evas_Object          *elm_map_marker_object_get(const Elm_Map_Marker *marker) EINA_ARG_NONNULL(1);
2386    EAPI void                  elm_map_marker_update(Elm_Map_Marker *marker) EINA_ARG_NONNULL(1);
2387    EAPI void                  elm_map_bubbles_close(Evas_Object *obj) EINA_ARG_NONNULL(1);
2388    EAPI Elm_Map_Group_Class  *elm_map_group_class_new(Evas_Object *obj) EINA_ARG_NONNULL(1);
2389    EAPI void                  elm_map_group_class_style_set(Elm_Map_Group_Class *clas, const char *style) EINA_ARG_NONNULL(1);
2390    EAPI void                  elm_map_group_class_icon_cb_set(Elm_Map_Group_Class *clas, ElmMapGroupIconGetFunc icon_get) EINA_ARG_NONNULL(1);
2391    EAPI void                  elm_map_group_class_data_set(Elm_Map_Group_Class *clas, void *data) EINA_ARG_NONNULL(1);
2392    EAPI void                  elm_map_group_class_zoom_displayed_set(Elm_Map_Group_Class *clas, int zoom) EINA_ARG_NONNULL(1);
2393    EAPI void                  elm_map_group_class_zoom_grouped_set(Elm_Map_Group_Class *clas, int zoom) EINA_ARG_NONNULL(1);
2394    EAPI void                  elm_map_group_class_hide_set(Evas_Object *obj, Elm_Map_Group_Class *clas, Eina_Bool hide) EINA_ARG_NONNULL(1, 2);
2395    EAPI Elm_Map_Marker_Class *elm_map_marker_class_new(Evas_Object *obj) EINA_ARG_NONNULL(1);
2396    EAPI void                  elm_map_marker_class_style_set(Elm_Map_Marker_Class *clas, const char *style) EINA_ARG_NONNULL(1);
2397    EAPI void                  elm_map_marker_class_icon_cb_set(Elm_Map_Marker_Class *clas, ElmMapMarkerIconGetFunc icon_get) EINA_ARG_NONNULL(1);
2398    EAPI void                  elm_map_marker_class_get_cb_set(Elm_Map_Marker_Class *clas, ElmMapMarkerGetFunc get) EINA_ARG_NONNULL(1);
2399    EAPI void                  elm_map_marker_class_del_cb_set(Elm_Map_Marker_Class *clas, ElmMapMarkerDelFunc del) EINA_ARG_NONNULL(1);
2400    EAPI const char          **elm_map_source_names_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2401    EAPI void                  elm_map_source_name_set(Evas_Object *obj, const char *source_name) EINA_ARG_NONNULL(1);
2402    EAPI const char           *elm_map_source_name_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2403    EAPI void                  elm_map_route_source_set(Evas_Object *obj, Elm_Map_Route_Sources source) EINA_ARG_NONNULL(1);
2404    EAPI Elm_Map_Route_Sources elm_map_route_source_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2405    EAPI int                   elm_map_source_zoom_min_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2406    EAPI int                   elm_map_source_zoom_max_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2407    EAPI void                  elm_map_user_agent_set(Evas_Object *obj, const char *user_agent) EINA_ARG_NONNULL(1, 2);
2408    EAPI const char           *elm_map_user_agent_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2409    EAPI Elm_Map_Route        *elm_map_route_add(Evas_Object *obj, Elm_Map_Route_Type type, Elm_Map_Route_Method method, double flon, double flat, double tlon, double tlat) EINA_ARG_NONNULL(1);
2410    EAPI void                  elm_map_route_remove(Elm_Map_Route *route) EINA_ARG_NONNULL(1);
2411    EAPI void                  elm_map_route_color_set(Elm_Map_Route *route, int r, int g , int b, int a) EINA_ARG_NONNULL(1);
2412    EAPI void                  elm_map_route_color_get(const Elm_Map_Route *route, int *r, int *g , int *b, int *a) EINA_ARG_NONNULL(1);
2413    EAPI double                elm_map_route_distance_get(const Elm_Map_Route *route) EINA_ARG_NONNULL(1);
2414    EAPI const char           *elm_map_route_node_get(const Elm_Map_Route *route) EINA_ARG_NONNULL(1);
2415    EAPI const char           *elm_map_route_waypoint_get(const Elm_Map_Route *route) EINA_ARG_NONNULL(1);
2416    EAPI const char           *elm_map_name_address_get(const Elm_Map_Name *name) EINA_ARG_NONNULL(1);
2417    EAPI void                  elm_map_name_region_get(const Elm_Map_Name *name, double *lon, double *lat) EINA_ARG_NONNULL(1);
2418    EAPI void                  elm_map_name_remove(Elm_Map_Name *name) EINA_ARG_NONNULL(1);
2419    EAPI void                  elm_map_rotate_set(Evas_Object *obj, double degree, Evas_Coord cx, Evas_Coord cy) EINA_ARG_NONNULL(1);
2420    EAPI void                  elm_map_rotate_get(const Evas_Object *obj, double *degree, Evas_Coord *cx, Evas_Coord *cy) EINA_ARG_NONNULL(1, 2, 3, 4);
2421    EAPI void                  elm_map_wheel_disabled_set(Evas_Object *obj, Eina_Bool disabled) EINA_ARG_NONNULL(1);
2422    EAPI Eina_Bool             elm_map_wheel_disabled_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2423
2424    /* smart callbacks called:
2425     * "clicked" - when image clicked
2426     * "press" - when mouse/finger held down initially on image
2427     * "longpressed" - when mouse/finger held for long time on image
2428     * "clicked,double" - when mouse/finger double-clicked
2429     * "load,details" - when detailed image load begins
2430     * "loaded,details" - when detailed image load done
2431     * "zoom,start" - when zooming started
2432     * "zoom,stop" - when zooming stopped
2433     * "zoom,change" - when auto zoom mode changed zoom level
2434     * "scroll - the content has been scrolled (moved)
2435     * "scroll,anim,start" - scrolling animation has started
2436     * "scroll,anim,stop" - scrolling animation has stopped
2437     * "scroll,drag,start" - dragging the contents around has started
2438     * "scroll,drag,stop" - dragging the contents around has stopped
2439     */
2440
2441    /* panel */
2442    typedef enum _Elm_Panel_Orient
2443      {
2444         ELM_PANEL_ORIENT_TOP,
2445         ELM_PANEL_ORIENT_BOTTOM,
2446         ELM_PANEL_ORIENT_LEFT,
2447         ELM_PANEL_ORIENT_RIGHT,
2448      } Elm_Panel_Orient;
2449
2450    EAPI Evas_Object          *elm_panel_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2451    EAPI void                  elm_panel_orient_set(Evas_Object *obj, Elm_Panel_Orient orient) EINA_ARG_NONNULL(1);
2452    EAPI Elm_Panel_Orient      elm_panel_orient_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2453    EAPI void                  elm_panel_content_set(Evas_Object *obj, Evas_Object *content) EINA_ARG_NONNULL(1);
2454    EAPI Evas_Object          *elm_panel_content_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2455    EAPI Evas_Object          *elm_panel_content_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
2456    EAPI void                  elm_panel_hidden_set(Evas_Object *obj, Eina_Bool hidden) EINA_ARG_NONNULL(1);
2457    EAPI Eina_Bool             elm_panel_hidden_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2458    EAPI void                  elm_panel_toggle(Evas_Object *obj) EINA_ARG_NONNULL(1);
2459
2460    /* panes */
2461    /**
2462     * TODO
2463     *
2464     * Update the minimun height of the bar in the theme. No minimun should be set in the vertical theme
2465     * Add events (move, start ...)
2466     */
2467    EAPI Evas_Object          *elm_panes_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2468    EAPI void                  elm_panes_content_left_set(Evas_Object *obj, Evas_Object *content) EINA_ARG_NONNULL(1);
2469    EAPI void                  elm_panes_content_right_set(Evas_Object *obj, Evas_Object *content) EINA_ARG_NONNULL(1);
2470    EAPI Evas_Object          *elm_panes_content_left_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2471    EAPI Evas_Object          *elm_panes_content_right_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2472    EAPI Evas_Object          *elm_panes_content_left_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
2473    EAPI Evas_Object          *elm_panes_content_right_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
2474    EAPI double                elm_panes_content_left_size_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2475    EAPI void                  elm_panes_content_left_size_set(Evas_Object *obj, double size) EINA_ARG_NONNULL(1);
2476    EAPI void                  elm_panes_horizontal_set(Evas_Object *obj, Eina_Bool horizontal) EINA_ARG_NONNULL(1);
2477    EAPI Eina_Bool             elm_panes_horizontal_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2478    EAPI void                  elm_panes_fixed_set(Evas_Object *obj, Eina_Bool fixed) EINA_ARG_NONNULL(1);
2479    EAPI Eina_Bool             elm_panes_fixed_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2480
2481    /* flip */
2482    typedef enum _Elm_Flip_Mode
2483      {
2484         ELM_FLIP_ROTATE_Y_CENTER_AXIS,
2485         ELM_FLIP_ROTATE_X_CENTER_AXIS,
2486         ELM_FLIP_ROTATE_XZ_CENTER_AXIS,
2487         ELM_FLIP_ROTATE_YZ_CENTER_AXIS,
2488         ELM_FLIP_CUBE_LEFT,
2489         ELM_FLIP_CUBE_RIGHT,
2490         ELM_FLIP_CUBE_UP,
2491         ELM_FLIP_CUBE_DOWN
2492      } Elm_Flip_Mode;
2493
2494    EAPI Evas_Object *elm_flip_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2495    EAPI void         elm_flip_content_front_set(Evas_Object *obj, Evas_Object *content) EINA_ARG_NONNULL(1);
2496    EAPI void         elm_flip_content_back_set(Evas_Object *obj, Evas_Object *content) EINA_ARG_NONNULL(1);
2497    EAPI Evas_Object *elm_flip_content_front_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2498    EAPI Evas_Object *elm_flip_content_back_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2499    EAPI Evas_Object *elm_flip_content_front_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
2500    EAPI Evas_Object *elm_flip_content_back_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
2501    EAPI Eina_Bool    elm_flip_front_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2502    EAPI void         elm_flip_perspective_set(Evas_Object *obj, Evas_Coord foc, Evas_Coord x, Evas_Coord y) EINA_ARG_NONNULL(1);
2503    EAPI void         elm_flip_go(Evas_Object *obj, Elm_Flip_Mode mode) EINA_ARG_NONNULL(1);
2504    /* smart callbacks called:
2505     * "animate,done" - when a flip animation is finished
2506     */
2507
2508    /* scrolledentry */
2509    EAPI Evas_Object *elm_scrolled_entry_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2510    EAPI void         elm_scrolled_entry_single_line_set(Evas_Object *obj, Eina_Bool single_line) EINA_ARG_NONNULL(1);
2511    EAPI Eina_Bool    elm_scrolled_entry_single_line_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2512    EAPI void         elm_scrolled_entry_password_set(Evas_Object *obj, Eina_Bool password) EINA_ARG_NONNULL(1);
2513    EAPI Eina_Bool    elm_scrolled_entry_password_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2514    EAPI void         elm_scrolled_entry_entry_set(Evas_Object *obj, const char *entry) EINA_ARG_NONNULL(1);
2515    EAPI const char  *elm_scrolled_entry_entry_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2516    EAPI Eina_Bool    elm_scrolled_entry_is_empty(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2517    EAPI const char  *elm_scrolled_entry_selection_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2518    EAPI void         elm_scrolled_entry_entry_insert(Evas_Object *obj, const char *entry) EINA_ARG_NONNULL(1);
2519    EAPI void         elm_scrolled_entry_line_wrap_set(Evas_Object *obj, Eina_Bool wrap) EINA_ARG_NONNULL(1);
2520    EAPI void         elm_scrolled_entry_line_char_wrap_set(Evas_Object *obj, Eina_Bool wrap) EINA_ARG_NONNULL(1);
2521    EAPI void         elm_scrolled_entry_editable_set(Evas_Object *obj, Eina_Bool editable) EINA_ARG_NONNULL(1);
2522    EAPI Eina_Bool    elm_scrolled_entry_editable_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2523    EAPI void         elm_scrolled_entry_select_none(Evas_Object *obj) EINA_ARG_NONNULL(1);
2524    EAPI void         elm_scrolled_entry_select_all(Evas_Object *obj) EINA_ARG_NONNULL(1);
2525    EAPI Eina_Bool    elm_scrolled_entry_cursor_next(Evas_Object *obj) EINA_ARG_NONNULL(1);
2526    EAPI Eina_Bool    elm_scrolled_entry_cursor_prev(Evas_Object *obj) EINA_ARG_NONNULL(1);
2527    EAPI Eina_Bool    elm_scrolled_entry_cursor_up(Evas_Object *obj) EINA_ARG_NONNULL(1);
2528    EAPI Eina_Bool    elm_scrolled_entry_cursor_down(Evas_Object *obj) EINA_ARG_NONNULL(1);
2529    EAPI void         elm_scrolled_entry_cursor_begin_set(Evas_Object *obj) EINA_ARG_NONNULL(1);
2530    EAPI void         elm_scrolled_entry_cursor_end_set(Evas_Object *obj) EINA_ARG_NONNULL(1);
2531    EAPI void         elm_scrolled_entry_cursor_line_begin_set(Evas_Object *obj) EINA_ARG_NONNULL(1);
2532    EAPI void         elm_scrolled_entry_cursor_line_end_set(Evas_Object *obj) EINA_ARG_NONNULL(1);
2533    EAPI void         elm_scrolled_entry_cursor_selection_begin(Evas_Object *obj) EINA_ARG_NONNULL(1);
2534    EAPI void         elm_scrolled_entry_cursor_selection_end(Evas_Object *obj) EINA_ARG_NONNULL(1);
2535    EAPI Eina_Bool    elm_scrolled_entry_cursor_is_format_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2536    EAPI Eina_Bool    elm_scrolled_entry_cursor_is_visible_format_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2537    EAPI const char  *elm_scrolled_entry_cursor_content_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2538    EAPI void         elm_scrolled_entry_selection_cut(Evas_Object *obj) EINA_ARG_NONNULL(1);
2539    EAPI void         elm_scrolled_entry_selection_copy(Evas_Object *obj) EINA_ARG_NONNULL(1);
2540    EAPI void         elm_scrolled_entry_selection_paste(Evas_Object *obj) EINA_ARG_NONNULL(1);
2541    EAPI void         elm_scrolled_entry_context_menu_clear(Evas_Object *obj) EINA_ARG_NONNULL(1);
2542    EAPI void         elm_scrolled_entry_context_menu_item_add(Evas_Object *obj, const char *label, const char *icon_file, Elm_Icon_Type icon_type, Evas_Smart_Cb func, const void *data) EINA_ARG_NONNULL(1);
2543    EAPI void         elm_scrolled_entry_context_menu_disabled_set(Evas_Object *obj, Eina_Bool disabled) EINA_ARG_NONNULL(1);
2544    EAPI Eina_Bool    elm_scrolled_entry_context_menu_disabled_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2545    EAPI void         elm_scrolled_entry_scrollbar_policy_set(Evas_Object *obj, Elm_Scroller_Policy h, Elm_Scroller_Policy v) EINA_ARG_NONNULL(1);
2546    EAPI void         elm_scrolled_entry_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce) EINA_ARG_NONNULL(1);
2547    EAPI void         elm_scrolled_entry_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce) EINA_ARG_NONNULL(1);
2548    EAPI void         elm_scrolled_entry_icon_set(Evas_Object *obj, Evas_Object *icon) EINA_ARG_NONNULL(1, 2);
2549    EAPI Evas_Object *elm_scrolled_entry_icon_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2550    EAPI Evas_Object *elm_scrolled_entry_icon_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
2551    EAPI void         elm_scrolled_entry_icon_visible_set(Evas_Object *obj, Eina_Bool setting) EINA_ARG_NONNULL(1);
2552    EAPI void         elm_scrolled_entry_end_set(Evas_Object *obj, Evas_Object *end) EINA_ARG_NONNULL(1, 2);
2553    EAPI Evas_Object *elm_scrolled_entry_end_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2554    EAPI Evas_Object *elm_scrolled_entry_end_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
2555    EAPI void         elm_scrolled_entry_end_visible_set(Evas_Object *obj, Eina_Bool setting) EINA_ARG_NONNULL(1);
2556    EAPI void         elm_scrolled_entry_item_provider_append(Evas_Object *obj, Evas_Object *(*func) (void *data, Evas_Object *entry, const char *item), void *data) EINA_ARG_NONNULL(1, 2);
2557    EAPI void         elm_scrolled_entry_item_provider_prepend(Evas_Object *obj, Evas_Object *(*func) (void *data, Evas_Object *entry, const char *item), void *data) EINA_ARG_NONNULL(1, 2);
2558    EAPI void         elm_scrolled_entry_item_provider_remove(Evas_Object *obj, Evas_Object *(*func) (void *data, Evas_Object *entry, const char *item), void *data) EINA_ARG_NONNULL(1, 2);
2559    EAPI void         elm_scrolled_entry_text_filter_append(Evas_Object *obj, void (*func) (void *data, Evas_Object *entry, char **text), void *data) EINA_ARG_NONNULL(1, 2);
2560    EAPI void         elm_scrolled_entry_text_filter_prepend(Evas_Object *obj, void (*func) (void *data, Evas_Object *entry, char **text), void *data) EINA_ARG_NONNULL(1, 2);
2561    EAPI void         elm_scrolled_entry_text_filter_remove(Evas_Object *obj, void (*func) (void *data, Evas_Object *entry, char **text), void *data) EINA_ARG_NONNULL(1, 2);
2562    EAPI void         elm_scrolled_entry_file_set(Evas_Object *obj, const char *file, Elm_Text_Format format) EINA_ARG_NONNULL(1);
2563    EAPI void         elm_scrolled_entry_file_get(const Evas_Object *obj, const char **file, Elm_Text_Format *format) EINA_ARG_NONNULL(1);
2564    EAPI void         elm_scrolled_entry_file_save(Evas_Object *obj) EINA_ARG_NONNULL(1);
2565    EAPI void         elm_scrolled_entry_autosave_set(Evas_Object *obj, Eina_Bool autosave) EINA_ARG_NONNULL(1);
2566    EAPI Eina_Bool    elm_scrolled_entry_autosave_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2567    EAPI void         elm_scrolled_entry_cnp_textonly_set(Evas_Object *obj, Eina_Bool textonly) EINA_ARG_NONNULL(1);
2568    EAPI Eina_Bool    elm_scrolled_entry_cnp_textonly_get(Evas_Object *obj) EINA_ARG_NONNULL(1);
2569    EAPI void         elm_scrolled_entry_input_panel_enabled_set(Evas_Object *obj, Eina_Bool enabled);
2570    EAPI void         elm_scrolled_entry_input_panel_layout_set(Evas_Object *obj, Elm_Input_Panel_Layout layout);
2571    EAPI Ecore_IMF_Context *elm_scrolled_entry_imf_context_get(Evas_Object *obj);
2572    EAPI void         elm_scrolled_entry_autocapitalization_set(Evas_Object *obj, Eina_Bool autocap);
2573    EAPI void         elm_scrolled_entry_autoperiod_set(Evas_Object *obj, Eina_Bool autoperiod);
2574
2575    /* conformant */
2576    EAPI Evas_Object *elm_conformant_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2577    EAPI void         elm_conformant_content_set(Evas_Object *obj, Evas_Object *content) EINA_ARG_NONNULL(1);
2578    EAPI Evas_Object *elm_conformant_content_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2579    EAPI Evas_Object *elm_conformant_content_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
2580    EAPI Evas_Object *elm_conformant_content_area_get(Evas_Object *obj); EINA_ARG_NONNULL(1);
2581
2582    /* mapbuf */
2583    EAPI Evas_Object *elm_mapbuf_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2584    EAPI void         elm_mapbuf_content_set(Evas_Object *obj, Evas_Object *content) EINA_ARG_NONNULL(1);
2585    EAPI Evas_Object *elm_mapbuf_content_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2586    EAPI Evas_Object *elm_mapbuf_content_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
2587    EAPI void         elm_mapbuf_enabled_set(Evas_Object *obj, Eina_Bool enabled) EINA_ARG_NONNULL(1);
2588    EAPI Eina_Bool    elm_mapbuf_enabled_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2589    EAPI void         elm_mapbuf_smooth_set(Evas_Object *obj, Eina_Bool smooth) EINA_ARG_NONNULL(1);
2590    EAPI Eina_Bool    elm_mapbuf_smooth_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2591    EAPI void         elm_mapbuf_alpha_set(Evas_Object *obj, Eina_Bool alpha) EINA_ARG_NONNULL(1);
2592    EAPI Eina_Bool    elm_mapbuf_alpha_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2593
2594    /* flipselector */
2595    typedef struct _Elm_Flipselector_Item Elm_Flipselector_Item;
2596
2597    EAPI Evas_Object               *elm_flipselector_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2598    EAPI void                       elm_flipselector_flip_next(Evas_Object *obj) EINA_ARG_NONNULL(1);
2599    EAPI void                       elm_flipselector_flip_prev(Evas_Object *obj) EINA_ARG_NONNULL(1);
2600    EAPI Elm_Flipselector_Item     *elm_flipselector_item_append(Evas_Object *obj, const char *label, void (*func)(void *data, Evas_Object *obj, void *event_info), void *data) EINA_ARG_NONNULL(1);
2601    EAPI Elm_Flipselector_Item     *elm_flipselector_item_prepend(Evas_Object *obj, const char *label, void (*func)(void *data, Evas_Object *obj, void *event_info), void *data) EINA_ARG_NONNULL(1);
2602    EAPI const Eina_List           *elm_flipselector_items_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2603    EAPI Elm_Flipselector_Item     *elm_flipselector_first_item_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2604    EAPI Elm_Flipselector_Item     *elm_flipselector_last_item_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2605    EAPI Elm_Flipselector_Item     *elm_flipselector_selected_item_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2606    EAPI void                       elm_flipselector_item_selected_set(Elm_Flipselector_Item *item, Eina_Bool selected) EINA_ARG_NONNULL(1);
2607    EAPI Eina_Bool                  elm_flipselector_item_selected_get(const Elm_Flipselector_Item *item) EINA_ARG_NONNULL(1);
2608    EAPI void                       elm_flipselector_item_del(Elm_Flipselector_Item *item) EINA_ARG_NONNULL(1);
2609    EAPI const char                *elm_flipselector_item_label_get(const Elm_Flipselector_Item *item) EINA_ARG_NONNULL(1);
2610    EAPI void                       elm_flipselector_item_label_set(Elm_Flipselector_Item *item, const char *label) EINA_ARG_NONNULL(1);
2611    EAPI Elm_Flipselector_Item     *elm_flipselector_item_prev_get(Elm_Flipselector_Item *item) EINA_ARG_NONNULL(1);
2612    EAPI Elm_Flipselector_Item     *elm_flipselector_item_next_get(Elm_Flipselector_Item *item) EINA_ARG_NONNULL(1);
2613    EAPI void                       elm_flipselector_interval_set(Evas_Object *obj, double interval) EINA_ARG_NONNULL(1);
2614    EAPI double                     elm_flipselector_interval_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2615    /* smart callbacks called:
2616     * "selected" - when flipselector selected item is changed
2617     * "overflowed" - when flipselector item is changed to first item
2618     *                from last item
2619     * "underflowed" - when flipselector item is changed to last item
2620     *                 from first item.
2621     */
2622    /* available styles:
2623     * default
2624     */
2625
2626    /* animator */
2627    typedef enum
2628      {
2629         ELM_ANIMATOR_CURVE_LINEAR,
2630         ELM_ANIMATOR_CURVE_IN_OUT,
2631         ELM_ANIMATOR_CURVE_IN,
2632         ELM_ANIMATOR_CURVE_OUT
2633      } Elm_Animator_Curve_Style;
2634    typedef struct _Elm_Animator Elm_Animator;
2635   /**
2636    * Called back per loop of an elementary animators cycle
2637    * @param data user-data given to elm_animator_operation_callback_set()
2638    * @param animator the animator being run
2639    * @param double the position in the animation
2640    */
2641    typedef void (*Elm_Animator_Operation_Cb) (void *data, Elm_Animator *animator, double frame);
2642   /**
2643    * Called back when an elementary animator finishes
2644    * @param data user-data given to elm_animator_completion_callback_set()
2645    */
2646    typedef void (*Elm_Animator_Completion_Cb) (void *data);
2647
2648    EAPI Elm_Animator*            elm_animator_add(Evas_Object *parent);
2649    EAPI void                     elm_animator_del(Elm_Animator *animator) EINA_ARG_NONNULL(1);
2650    EAPI void                     elm_animator_duration_set(Elm_Animator *animator, double duration) EINA_ARG_NONNULL(1);
2651    EAPI void                     elm_animator_operation_callback_set(Elm_Animator *animator, Elm_Animator_Operation_Cb func, void *data) EINA_ARG_NONNULL(1);
2652    EAPI void                     elm_animator_completion_callback_set(Elm_Animator *animator, Elm_Animator_Completion_Cb func, void *data) EINA_ARG_NONNULL(1);
2653    EAPI void                     elm_animator_stop(Elm_Animator *animator) EINA_ARG_NONNULL(1);
2654    EAPI void                     elm_animator_repeat_set(Elm_Animator *animator, unsigned int repeat_cnt) EINA_ARG_NONNULL(1);
2655    EAPI void                     elm_animator_animate(Elm_Animator *animator) EINA_ARG_NONNULL(1);
2656    EAPI void                     elm_animator_curve_style_set(Elm_Animator *animator, Elm_Animator_Curve_Style cs) EINA_ARG_NONNULL(1);
2657    EAPI Elm_Animator_Curve_Style elm_animator_curve_style_get(const Elm_Animator *animator); EINA_ARG_NONNULL(1);
2658    EAPI void                     elm_animator_auto_reverse_set(Elm_Animator *animator, Eina_Bool reverse) EINA_ARG_NONNULL(1);
2659    EAPI Eina_Bool                elm_animator_auto_reverse_get(const Elm_Animator *animator) EINA_ARG_NONNULL(1);
2660    EAPI Eina_Bool                elm_animator_operating_get(const Elm_Animator *animator) EINA_ARG_NONNULL(1);
2661    EAPI unsigned int             elm_animator_repeat_get(const Elm_Animator *animator) EINA_ARG_NONNULL(1);
2662    EAPI void                     elm_animator_pause(Elm_Animator *animator) EINA_ARG_NONNULL(1);
2663    EAPI void                     elm_animator_resume(Elm_Animator *animator) EINA_ARG_NONNULL(1);
2664
2665    /* calendar */
2666    typedef enum
2667      {
2668         ELM_CALENDAR_UNIQUE,
2669         ELM_CALENDAR_DAILY,
2670         ELM_CALENDAR_WEEKLY,
2671         ELM_CALENDAR_MONTHLY,
2672         ELM_CALENDAR_ANNUALLY
2673      } Elm_Calendar_Mark_Repeat;
2674    typedef struct _Elm_Calendar_Mark Elm_Calendar_Mark;
2675
2676    EAPI Evas_Object       *elm_calendar_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2677    EAPI const char       **elm_calendar_weekdays_names_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2678    EAPI void               elm_calendar_weekdays_names_set(Evas_Object *obj, const char *weekdays[]) EINA_ARG_NONNULL(1, 2);
2679    EAPI double             elm_calendar_interval_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2680    EAPI void               elm_calendar_interval_set(Evas_Object *obj, double interval) EINA_ARG_NONNULL(1);
2681    EAPI void               elm_calendar_min_max_year_get(const Evas_Object *obj, int *min, int *max) EINA_ARG_NONNULL(1);
2682    EAPI void               elm_calendar_min_max_year_set(Evas_Object *obj, int min, int max) EINA_ARG_NONNULL(1);
2683    EAPI Eina_Bool          elm_calendar_day_selection_enabled_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2684    EAPI void               elm_calendar_day_selection_enabled_set(Evas_Object *obj, Eina_Bool enabled) EINA_ARG_NONNULL(1);
2685    EAPI Eina_Bool          elm_calendar_selected_time_get(const Evas_Object *obj, struct tm *selected_time) EINA_ARG_NONNULL(1, 2);
2686    EAPI void               elm_calendar_selected_time_set(Evas_Object *obj, struct tm *selected_time) EINA_ARG_NONNULL(1);
2687    EAPI void               elm_calendar_format_function_set(Evas_Object *obj, char * (*format_function) (struct tm *stime)) EINA_ARG_NONNULL(1);
2688    EAPI Elm_Calendar_Mark *elm_calendar_mark_add(Evas_Object *obj, const char *mark_type, struct tm *mark_time, Elm_Calendar_Mark_Repeat repeat) EINA_ARG_NONNULL(1);
2689    EAPI void               elm_calendar_mark_del(Elm_Calendar_Mark *mark) EINA_ARG_NONNULL(1);
2690    EAPI void               elm_calendar_marks_clear(Evas_Object *obj) EINA_ARG_NONNULL(1);
2691    EAPI const Eina_List   *elm_calendar_marks_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2692    EAPI void               elm_calendar_marks_draw(Evas_Object *obj) EINA_ARG_NONNULL(1);
2693    EINA_DEPRECATED EAPI void               elm_calendar_text_saturday_color_set(Evas_Object *obj, int pos) EINA_ARG_NONNULL(1);
2694    EINA_DEPRECATED EAPI void               elm_calendar_text_sunday_color_set(Evas_Object *obj, int pos) EINA_ARG_NONNULL(1);
2695    EINA_DEPRECATED EAPI void               elm_calendar_text_weekday_color_set(Evas_Object *obj, int pos) EINA_ARG_NONNULL(1);
2696    /* smart callbacks called:
2697     * changed - emitted when the user select a day or change the displayed
2698     * month.
2699     */
2700
2701    /* diskselector */
2702    typedef struct _Elm_Diskselector_Item Elm_Diskselector_Item;
2703
2704    EAPI Evas_Object           *elm_diskselector_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2705    EAPI Eina_Bool              elm_diskselector_round_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2706    EAPI void                   elm_diskselector_round_set(Evas_Object *obj, Eina_Bool round) EINA_ARG_NONNULL(1);
2707    EAPI int                    elm_diskselector_side_label_lenght_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2708    EAPI void                   elm_diskselector_side_label_lenght_set(Evas_Object *obj, int len) EINA_ARG_NONNULL(1);
2709    EAPI void                   elm_diskselector_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce) EINA_ARG_NONNULL(1);
2710    EAPI void                   elm_diskselector_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce) EINA_ARG_NONNULL(1);
2711    EAPI void                   elm_diskselector_scroller_policy_get(const Evas_Object *obj, Elm_Scroller_Policy *policy_h, Elm_Scroller_Policy *policy_v) EINA_ARG_NONNULL(1);
2712    EAPI void                   elm_diskselector_scroller_policy_set(Evas_Object *obj, Elm_Scroller_Policy policy_h, Elm_Scroller_Policy policy_v) EINA_ARG_NONNULL(1);
2713    EAPI void                   elm_diskselector_clear(Evas_Object *obj) EINA_ARG_NONNULL(1);
2714    EAPI const Eina_List       *elm_diskselector_items_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2715    EAPI Elm_Diskselector_Item *elm_diskselector_item_append(Evas_Object *obj, const char *label, Evas_Object *icon, Evas_Smart_Cb func, const void *data) EINA_ARG_NONNULL(1);
2716    EAPI void                   elm_diskselector_item_del(Elm_Diskselector_Item *item) EINA_ARG_NONNULL(1);
2717    EAPI void                   elm_diskselector_item_del_cb_set(Elm_Diskselector_Item *item, Evas_Smart_Cb func) EINA_ARG_NONNULL(1);
2718    EAPI void                  *elm_diskselector_item_data_get(const Elm_Diskselector_Item *item) EINA_ARG_NONNULL(1);
2719    EAPI Evas_Object           *elm_diskselector_item_icon_get(const Elm_Diskselector_Item *item) EINA_ARG_NONNULL(1);
2720    EAPI void                   elm_diskselector_item_icon_set(Elm_Diskselector_Item *item, Evas_Object *icon) EINA_ARG_NONNULL(1);
2721    EAPI const char            *elm_diskselector_item_label_get(const Elm_Diskselector_Item *item) EINA_ARG_NONNULL(1);
2722    EAPI void                   elm_diskselector_item_label_set(Elm_Diskselector_Item *item, const char *label) EINA_ARG_NONNULL(1);
2723    EAPI Elm_Diskselector_Item *elm_diskselector_selected_item_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2724    EAPI void                   elm_diskselector_item_selected_set(Elm_Diskselector_Item *item, Eina_Bool selected) EINA_ARG_NONNULL(1);
2725    EAPI Eina_Bool              elm_diskselector_item_selected_get(const Elm_Diskselector_Item *item) EINA_ARG_NONNULL(1);
2726    EAPI Elm_Diskselector_Item *elm_diskselector_first_item_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2727    EAPI Elm_Diskselector_Item *elm_diskselector_last_item_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2728    EAPI Elm_Diskselector_Item *elm_diskselector_item_prev_get(const Elm_Diskselector_Item *item) EINA_ARG_NONNULL(1);
2729    EAPI Elm_Diskselector_Item *elm_diskselector_item_next_get(const Elm_Diskselector_Item *item) EINA_ARG_NONNULL(1);
2730    EAPI void                   elm_diskselector_item_tooltip_text_set(Elm_Diskselector_Item *item, const char *text) EINA_ARG_NONNULL(1);
2731    EAPI void                   elm_diskselector_item_tooltip_content_cb_set(Elm_Diskselector_Item *item, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb) EINA_ARG_NONNULL(1);
2732    EAPI void                   elm_diskselector_item_tooltip_unset(Elm_Diskselector_Item *item) EINA_ARG_NONNULL(1);
2733    EAPI void                   elm_diskselector_item_tooltip_style_set(Elm_Diskselector_Item *item, const char *style) EINA_ARG_NONNULL(1);
2734    EAPI const char            *elm_diskselector_item_tooltip_style_get(const Elm_Diskselector_Item *item) EINA_ARG_NONNULL(1);
2735    EAPI void                   elm_diskselector_item_cursor_set(Elm_Diskselector_Item *item, const char *cursor) EINA_ARG_NONNULL(1);
2736    EAPI const char            *elm_diskselector_item_cursor_get(const Elm_Diskselector_Item *item) EINA_ARG_NONNULL(1);
2737    EAPI void                   elm_diskselector_item_cursor_unset(Elm_Diskselector_Item *item) EINA_ARG_NONNULL(1);
2738    EAPI void                   elm_diskselector_item_cursor_style_set(Elm_Diskselector_Item *item, const char *style) EINA_ARG_NONNULL(1);
2739    EAPI const char            *elm_diskselector_item_cursor_style_get(const Elm_Diskselector_Item *item) EINA_ARG_NONNULL(1);
2740    EAPI void                   elm_diskselector_item_cursor_engine_only_set(Elm_Diskselector_Item *item, Eina_Bool engine_only) EINA_ARG_NONNULL(1);
2741    EAPI Eina_Bool              elm_diskselector_item_cursor_engine_only_get(const Elm_Diskselector_Item *item) EINA_ARG_NONNULL(1);
2742    EAPI void                   elm_diskselector_display_item_num_set(Evas_Object *obj, int num) EINA_ARG_NONNULL(1);
2743    /* smart callbacks called:
2744     * "selected" - when item is selected (scroller stops)
2745     */
2746
2747    /* datefield */
2748    typedef enum _Elm_Datefield_Layout
2749      {
2750         ELM_DATEFIELD_LAYOUT_TIME,
2751         ELM_DATEFIELD_LAYOUT_DATE,
2752         ELM_DATEFIELD_LAYOUT_DATEANDTIME
2753      } Elm_Datefield_Layout;
2754
2755    EAPI Evas_Object *elm_datefield_add(Evas_Object *parent);
2756    EAPI void         elm_datefield_layout_set(Evas_Object *obj, Elm_Datefield_Layout layout);
2757    EAPI Elm_Datefield_Layout elm_datefield_layout_get(const Evas_Object *obj);
2758    EAPI void         elm_datefield_date_set(Evas_Object *obj, int year, int month, int day, int hour, int min);
2759    EAPI void         elm_datefield_date_get(const Evas_Object *obj, int *year, int *month, int *day, int *hour, int *min);
2760    EAPI Eina_Bool elm_datefield_date_max_set(Evas_Object *obj, int year, int month, int day);
2761    EAPI void         elm_datefield_date_max_get(const Evas_Object *obj, int *year, int *month, int *day);
2762    EAPI Eina_Bool elm_datefield_date_min_set(Evas_Object *obj, int year, int month, int day);
2763    EAPI void         elm_datefield_date_min_get(const Evas_Object *obj, int *year, int *month, int *day);
2764    EAPI void         elm_datefield_time_mode_set(Evas_Object *obj, Eina_Bool mode);
2765    EAPI Eina_Bool    elm_datefield_time_mode_get(const Evas_Object *obj);
2766    EAPI void         elm_datefield_date_format_set(Evas_Object *obj, const char *fmt);
2767    EAPI const char  *elm_datefield_date_format_get(const Evas_Object *obj);
2768    EAPI void         elm_datefield_input_panel_state_callback_add(Evas_Object *obj, void (*pEventCallbackFunc) (void *data, Evas_Object *obj, int value), void *data);
2769    EAPI void         elm_datefield_input_panel_state_callback_del(Evas_Object *obj, void (*pEventCallbackFunc) (void *data, Evas_Object *obj, int value));
2770    /* smart callbacks called:
2771    * "changed" - when datefield entry is changed, this signal is sent.
2772    */
2773
2774    /* popup */
2775    typedef enum _Elm_Popup_Response
2776      {
2777         ELM_POPUP_RESPONSE_NONE = -1,
2778         ELM_POPUP_RESPONSE_TIMEOUT = -2,
2779         ELM_POPUP_RESPONSE_OK = -3,
2780         ELM_POPUP_RESPONSE_CANCEL = -4,
2781         ELM_POPUP_RESPONSE_CLOSE = -5
2782      } Elm_Popup_Response;
2783
2784    typedef enum _Elm_Popup_Mode
2785      {
2786         ELM_POPUP_TYPE_NONE = 0,
2787         ELM_POPUP_TYPE_ALERT = (1 << 0)
2788      } Elm_Popup_Mode;
2789
2790    typedef enum _Elm_Popup_Orient
2791      {
2792         ELM_POPUP_ORIENT_TOP,
2793         ELM_POPUP_ORIENT_CENTER,
2794         ELM_POPUP_ORIENT_BOTTOM,
2795         ELM_POPUP_ORIENT_LEFT,
2796         ELM_POPUP_ORIENT_RIGHT,
2797         ELM_POPUP_ORIENT_TOP_LEFT,
2798         ELM_POPUP_ORIENT_TOP_RIGHT,
2799         ELM_POPUP_ORIENT_BOTTOM_LEFT,
2800         ELM_POPUP_ORIENT_BOTTOM_RIGHT
2801      } Elm_Popup_Orient;
2802
2803    /* smart callbacks called:
2804     * "response" - when ever popup is closed, this signal is sent with appropriate response id.".
2805     */
2806
2807    EAPI Evas_Object *elm_popup_add(Evas_Object *parent);
2808    EAPI void         elm_popup_desc_set(Evas_Object *obj, const char *text);
2809    EAPI const char  *elm_popup_desc_get(Evas_Object *obj);
2810    EAPI void         elm_popup_title_label_set(Evas_Object *obj, const char *text);
2811    EAPI const char  *elm_popup_title_label_get(Evas_Object *obj);
2812    EAPI void         elm_popup_title_icon_set(Evas_Object *obj, Evas_Object *icon);
2813    EAPI Evas_Object *elm_popup_title_icon_get(Evas_Object *obj);
2814    EAPI void         elm_popup_content_set(Evas_Object *obj, Evas_Object *content);
2815    EAPI Evas_Object *elm_popup_content_get(Evas_Object *obj);
2816    EAPI void         elm_popup_buttons_add(Evas_Object *obj,int no_of_buttons, const char *first_button_text,  ...);
2817    EAPI Evas_Object *elm_popup_with_buttons_add(Evas_Object *parent, const char *title, const char *desc_text,int no_of_buttons, const char *first_button_text, ... );
2818    EAPI void         elm_popup_timeout_set(Evas_Object *obj, double timeout);
2819    EAPI void         elm_popup_mode_set(Evas_Object *obj, Elm_Popup_Mode mode);
2820    EAPI void         elm_popup_response(Evas_Object *obj, int  response_id);
2821    EAPI void         elm_popup_orient_set(Evas_Object *obj, Elm_Popup_Orient orient);
2822    EAPI int          elm_popup_run(Evas_Object *obj);
2823
2824    /* NavigationBar */
2825    typedef enum
2826      {
2827         ELM_NAVIGATIONBAR_FUNCTION_BUTTON1,
2828         ELM_NAVIGATIONBAR_FUNCTION_BUTTON2,
2829         ELM_NAVIGATIONBAR_FUNCTION_BUTTON3,
2830         ELM_NAVIGATIONBAR_BACK_BUTTON
2831      } Elm_Navi_Button_Type;
2832
2833    EAPI Evas_Object *elm_navigationbar_add(Evas_Object *parent);
2834    EAPI void         elm_navigationbar_push(Evas_Object *obj, const char *title, Evas_Object *fn_btn1, Evas_Object *fn_btn2, Evas_Object *fn_btn3, Evas_Object *content);
2835    EAPI void         elm_navigationbar_pop(Evas_Object *obj);
2836    EAPI void         elm_navigationbar_to_content_pop(Evas_Object *obj, Evas_Object *content);
2837    EAPI void         elm_navigationbar_title_label_set(Evas_Object *obj, Evas_Object *content, const char *title);
2838    EAPI const char  *elm_navigationbar_title_label_get(Evas_Object *obj, Evas_Object *content);
2839    EAPI void         elm_navigationbar_title_object_add(Evas_Object *obj, Evas_Object *content, Evas_Object *title_obj);
2840    EAPI Eina_List   *elm_navigationbar_title_object_list_get(Evas_Object *obj, Evas_Object *content);
2841    EAPI Evas_Object *elm_navigationbar_content_top_get(Evas_Object *obj);
2842    EAPI Evas_Object *elm_navigationbar_content_bottom_get(Evas_Object *obj);
2843    EAPI void         elm_navigationbar_hidden_set(Evas_Object *obj, Eina_Bool hidden);
2844    EAPI void         elm_navigationbar_title_button_set(Evas_Object *obj, Evas_Object *content, Evas_Object *button, Elm_Navi_Button_Type button_type);
2845    EAPI Evas_Object *elm_navigationbar_title_button_get(Evas_Object *obj, Evas_Object *content, Elm_Navi_Button_Type button_type);
2846    EAPI const char  *elm_navigationbar_subtitle_label_get(Evas_Object *obj, Evas_Object *content);
2847    EAPI void         elm_navigationbar_subtitle_label_set(Evas_Object *obj, Evas_Object *content, const char *subtitle);
2848    EAPI void         elm_navigationbar_title_object_list_unset(Evas_Object *obj, Evas_Object *content, Eina_List **list);
2849    EAPI void         elm_navigationbar_animation_disabled_set(Evas_Object *obj, Eina_Bool disable);
2850    EAPI void         elm_navigationbar_title_object_visible_set(Evas_Object *obj, Evas_Object *content, Eina_Bool visible);
2851    Eina_Bool         elm_navigationbar_title_object_visible_get(Evas_Object *obj, Evas_Object *content);
2852    EAPI void         elm_navigationbar_title_icon_set(Evas_Object *obj, Evas_Object *content, Evas_Object *icon);
2853    EAPI Evas_Object *elm_navigationbar_title_icon_get(Evas_Object *obj, Evas_Object *content);
2854
2855      /* NavigationBar */
2856    typedef enum
2857      {
2858         ELM_NAVIGATIONBAR_EX_BACK_BUTTON,
2859         ELM_NAVIGATIONBAR_EX_FUNCTION_BUTTON1,
2860         ELM_NAVIGATIONBAR_EX_FUNCTION_BUTTON2,
2861         ELM_NAVIGATIONBAR_EX_FUNCTION_BUTTON3,
2862         ELM_NAVIGATIONBAR_EX_MAX
2863      } Elm_Navi_ex_Button_Type;
2864    typedef struct _Elm_Navigationbar_ex_Item Elm_Navigationbar_ex_Item;
2865
2866    EAPI Evas_Object *elm_navigationbar_ex_add(Evas_Object *parent);
2867    EAPI Elm_Navigationbar_ex_Item *elm_navigationbar_ex_item_push(Evas_Object *obj, Evas_Object *content, const char *item_style);
2868    EAPI void         elm_navigationbar_ex_item_pop(Evas_Object *obj);
2869    EAPI void         elm_navigationbar_ex_item_promote(Elm_Navigationbar_ex_Item* item);
2870    EAPI void         elm_navigationbar_ex_to_item_pop(Elm_Navigationbar_ex_Item* item);
2871    EAPI void         elm_navigationbar_ex_item_title_label_set(Elm_Navigationbar_ex_Item *item, const char *title);
2872    EAPI const char  *elm_navigationbar_ex_item_title_label_get(Elm_Navigationbar_ex_Item* item);
2873    EAPI Elm_Navigationbar_ex_Item *elm_navigationbar_ex_item_top_get(const Evas_Object *obj);
2874    EAPI Elm_Navigationbar_ex_Item *elm_navigationbar_ex_item_bottom_get(const Evas_Object *obj);
2875    EAPI void         elm_navigationbar_ex_item_title_button_set(Elm_Navigationbar_ex_Item* item, char *btn_label, Evas_Object *icon, int button_type, Evas_Smart_Cb func, const void *data);
2876    EAPI Evas_Object *elm_navigationbar_ex_item_title_button_get(Elm_Navigationbar_ex_Item* item, int button_type);
2877    EAPI void         elm_navigationbar_ex_item_title_object_set(Elm_Navigationbar_ex_Item* item, Evas_Object *title_obj);
2878    EAPI Evas_Object *elm_navigationbar_ex_item_title_object_unset(Elm_Navigationbar_ex_Item* item);
2879    EAPI void         elm_navigationbar_ex_item_title_hidden_set(Elm_Navigationbar_ex_Item* item, Eina_Bool hidden);
2880    EAPI Evas_Object *elm_navigationbar_ex_item_title_object_get(Elm_Navigationbar_ex_Item* item);
2881    EAPI const char  *elm_navigationbar_ex_item_subtitle_label_get(Elm_Navigationbar_ex_Item* item);
2882    EAPI void         elm_navigationbar_ex_item_subtitle_label_set( Elm_Navigationbar_ex_Item* item, const char *subtitle);
2883    EAPI void         elm_navigationbar_ex_item_style_set(Elm_Navigationbar_ex_Item* item, const char* item_style);
2884    EAPI const char  *elm_navigationbar_ex_item_style_get(Elm_Navigationbar_ex_Item* item);
2885    EAPI Evas_Object *elm_navigationbar_ex_item_content_unset(Elm_Navigationbar_ex_Item* item);
2886    EAPI Evas_Object *elm_navigationbar_ex_item_content_get(Elm_Navigationbar_ex_Item* item);
2887    EAPI void         elm_navigationbar_ex_delete_on_pop_set(Evas_Object *obj, Eina_Bool del_on_pop);
2888    EAPI Evas_Object *elm_navigationbar_ex_item_icon_get(Elm_Navigationbar_ex_Item* item);
2889    EAPI void         elm_navigationbar_ex_item_icon_set(Elm_Navigationbar_ex_Item* item, Evas_Object *icon);
2890    EAPI Evas_Object *elm_navigationbar_ex_item_title_button_unset(Elm_Navigationbar_ex_Item* item, int button_type);
2891    EAPI void         elm_navigationbar_ex_animation_disable_set(Evas_Object *obj, Eina_Bool disable);
2892    EAPI void         elm_navigationbar_ex_title_object_visible_set(Elm_Navigationbar_ex_Item* item, Eina_Bool visible);
2893    Eina_Bool         elm_navigationbar_ex_title_object_visible_get(Elm_Navigationbar_ex_Item* item);
2894
2895
2896    /* Control Bar */
2897    #define CONTROLBAR_SYSTEM_ICON_ALBUMS "controlbar_albums"
2898    #define CONTROLBAR_SYSTEM_ICON_ARTISTS "controlbar_artists"
2899    #define CONTROLBAR_SYSTEM_ICON_SONGS "controlbar_songs"
2900    #define CONTROLBAR_SYSTEM_ICON_PLAYLIST "controlbar_playlist"
2901    #define CONTROLBAR_SYSTEM_ICON_MORE "controlbar_more"
2902    #define CONTROLBAR_SYSTEM_ICON_CONTACTS "controlbar_contacts"
2903    #define CONTROLBAR_SYSTEM_ICON_DIALER "controlbar_dialer"
2904    #define CONTROLBAR_SYSTEM_ICON_FAVORITES "controlbar_favorites"
2905    #define CONTROLBAR_SYSTEM_ICON_LOGS "controlbar_logs"
2906
2907    typedef enum _Elm_Controlbar_Mode_Type
2908      {
2909         ELM_CONTROLBAR_MODE_DEFAULT = 0,
2910         ELM_CONTROLBAR_MODE_TRANSLUCENCE,
2911         ELM_CONTROLBAR_MODE_TRANSPARENCY,
2912         ELM_CONTROLBAR_MODE_LARGE,
2913         ELM_CONTROLBAR_MODE_SMALL,
2914         ELM_CONTROLBAR_MODE_LEFT,
2915         ELM_CONTROLBAR_MODE_RIGHT
2916      } Elm_Controlbar_Mode_Type;
2917
2918    typedef struct _Elm_Controlbar_Item Elm_Controlbar_Item;
2919
2920    EAPI Evas_Object *elm_controlbar_add(Evas_Object *parent);
2921    EAPI Elm_Controlbar_Item *elm_controlbar_tab_item_append(Evas_Object *obj, const char *icon_path, const char *label, Evas_Object *view);
2922    EAPI Elm_Controlbar_Item *elm_controlbar_tab_item_prepend(Evas_Object *obj, const char *icon_path, const char *label, Evas_Object *view);
2923    EAPI Elm_Controlbar_Item *elm_controlbar_tab_item_insert_before(Evas_Object *obj, Elm_Controlbar_Item *before, const char *icon_path, const char *label, Evas_Object *view);
2924    EAPI Elm_Controlbar_Item *elm_controlbar_tab_item_insert_after(Evas_Object *obj, Elm_Controlbar_Item *after, const char *icon_path, const char *label, Evas_Object *view);
2925    EAPI Elm_Controlbar_Item *elm_controlbar_tool_item_append(Evas_Object *obj, const char *icon_path, const char *label, void (*func) (void *data, Evas_Object *obj, void *event_info), void *data);
2926    EAPI Elm_Controlbar_Item *elm_controlbar_tool_item_prepend(Evas_Object *obj, const char *icon_path, const char *label, void (*func) (void *data, Evas_Object *obj, void *event_info), void *data);
2927    EAPI Elm_Controlbar_Item *elm_controlbar_tool_item_insert_before(Evas_Object *obj, Elm_Controlbar_Item *before, const char *icon_path, const char *label, void (*func) (void *data, Evas_Object *obj, void *event_info), void *data);
2928    EAPI Elm_Controlbar_Item *elm_controlbar_tool_item_insert_after(Evas_Object *obj, Elm_Controlbar_Item *after, const char *icon_path, const char *label, void (*func) (void *data, Evas_Object *obj, void *event_info), void *data);
2929    EAPI Elm_Controlbar_Item *elm_controlbar_object_item_append(Evas_Object *obj, Evas_Object *obj_item, const int sel);
2930    EAPI Elm_Controlbar_Item *elm_controlbar_object_item_prepend(Evas_Object *obj, Evas_Object *obj_item, const int sel);
2931    EAPI Elm_Controlbar_Item *elm_controlbar_object_item_insert_before(Evas_Object *obj, Elm_Controlbar_Item *before, Evas_Object *obj_item, const int sel);
2932    EAPI Elm_Controlbar_Item *elm_controlbar_object_item_insert_after(Evas_Object *obj, Elm_Controlbar_Item *after, Evas_Object *obj_item, const int sel);
2933    EAPI Evas_Object *elm_controlbar_object_item_object_get(Elm_Controlbar_Item *it);
2934    EAPI void         elm_controlbar_item_del(Elm_Controlbar_Item *it);
2935    EAPI void         elm_controlbar_item_select(Elm_Controlbar_Item *it);
2936    EAPI void         elm_controlbar_item_visible_set(Elm_Controlbar_Item *it, Eina_Bool bar);
2937    EAPI Eina_Bool    elm_controlbar_item_visible_get(Elm_Controlbar_Item * it);
2938    EAPI void         elm_controlbar_item_disable_set(Elm_Controlbar_Item * it, Eina_Bool disable);
2939    EAPI Eina_Bool    elm_controlbar_item_disable_get(Elm_Controlbar_Item * it);
2940    EAPI void         elm_controlbar_item_icon_set(Elm_Controlbar_Item *it, const char *icon_path);
2941    EAPI Evas_Object *elm_controlbar_item_icon_get(Elm_Controlbar_Item *it);
2942    EAPI void         elm_controlbar_item_label_set(Elm_Controlbar_Item *it, const char *label);
2943    EAPI const char  *elm_controlbar_item_label_get(Elm_Controlbar_Item *it);
2944    EAPI Elm_Controlbar_Item *elm_controlbar_selected_item_get(Evas_Object *obj);
2945    EAPI Elm_Controlbar_Item *elm_controlbar_first_item_get(Evas_Object *obj);
2946    EAPI Elm_Controlbar_Item *elm_controlbar_last_item_get(Evas_Object *obj);
2947    EAPI Eina_List   *elm_controlbar_items_get(Evas_Object *obj);
2948    EAPI Elm_Controlbar_Item *elm_controlbar_item_prev(Elm_Controlbar_Item *it);
2949    EAPI Elm_Controlbar_Item *elm_controlbar_item_next(Elm_Controlbar_Item *it);
2950    EAPI void         elm_controlbar_item_view_set(Elm_Controlbar_Item *it, Evas_Object * view);
2951    EAPI Evas_Object *elm_controlbar_item_view_get(Elm_Controlbar_Item *it);
2952    EAPI void         elm_controlbar_mode_set(Evas_Object *obj, int mode);
2953    EAPI void         elm_controlbar_alpha_set(Evas_Object *obj, int alpha);
2954    EAPI void         elm_controlbar_item_auto_align_set(Evas_Object *obj, Eina_Bool auto_align);
2955    EAPI void         elm_controlbar_vertical_set(Evas_Object *obj, Eina_Bool vertical);
2956    /*======= Please don't use this APIs =======*/
2957    EAPI void         elm_controlbar_animation_set(Evas_Object *obj, void (*func) (void *data, Evas_Object *obj, void *event_info), void *data);
2958    EAPI void         elm_controlbar_item_animation_set(Evas_Object *obj, Eina_Bool auto_animation, Eina_Bool selected_animation);
2959    /*======= Just for test =======*/
2960
2961    /* SearchBar */
2962    EAPI Evas_Object *elm_searchbar_add(Evas_Object *parent);
2963    EAPI void         elm_searchbar_text_set(Evas_Object *obj, const char *entry);
2964    EAPI const char  *elm_searchbar_text_get(Evas_Object *obj);
2965    EAPI Evas_Object *elm_searchbar_entry_get(Evas_Object *obj);
2966    EAPI void         elm_searchbar_cancel_button_animation_set(Evas_Object *obj, Eina_Bool cancel_btn_ani_flag);
2967    EAPI void         elm_searchbar_cancel_button_set(Evas_Object *obj, Eina_Bool visible);
2968    EAPI void         elm_searchbar_clear(Evas_Object *obj);
2969    EAPI void         elm_searchbar_boundary_rect_set(Evas_Object *obj, Eina_Bool boundary);
2970
2971    /* colorselector */
2972    EAPI Evas_Object *elm_colorselector_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2973    EAPI void         elm_colorselector_color_set(Evas_Object *obj, int r, int g , int b, int a) EINA_ARG_NONNULL(1);
2974    EAPI void         elm_colorselector_color_get(const Evas_Object *obj, int *r, int *g , int *b, int *a) EINA_ARG_NONNULL(1);
2975    /* smart callbacks called:
2976     * "changed" - when the color value changes
2977     */
2978
2979    /* Contextual Popup */
2980    typedef struct _Elm_Ctxpopup_Item Elm_Ctxpopup_Item;
2981
2982    typedef enum _Elm_Ctxpopup_Direction
2983      {
2984         ELM_CTXPOPUP_DIRECTION_DOWN,
2985         ELM_CTXPOPUP_DIRECTION_RIGHT,
2986         ELM_CTXPOPUP_DIRECTION_LEFT,
2987         ELM_CTXPOPUP_DIRECTION_UP,
2988      } Elm_Ctxpopup_Direction;
2989
2990    EAPI Evas_Object  *elm_ctxpopup_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
2991    EAPI Evas_Object  *elm_ctxpopup_item_icon_get(const Elm_Ctxpopup_Item *item) EINA_ARG_NONNULL(1);
2992    EAPI void          elm_ctxpopup_item_icon_set(Elm_Ctxpopup_Item *item, Evas_Object *icon) EINA_ARG_NONNULL(1);
2993    EAPI const char   *elm_ctxpopup_item_label_get(const Elm_Ctxpopup_Item *item) EINA_ARG_NONNULL(1);
2994    EAPI void          elm_ctxpopup_item_label_set(Elm_Ctxpopup_Item *item, const char *label) EINA_ARG_NONNULL(1);
2995    EAPI void          elm_ctxpopup_hover_parent_set(Evas_Object *obj, Evas_Object *parent) EINA_ARG_NONNULL(1, 2);
2996    EAPI Evas_Object  *elm_ctxpopup_hover_parent_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
2997    EAPI void          elm_ctxpopup_clear(Evas_Object *obj) EINA_ARG_NONNULL(1);
2998    EAPI void          elm_ctxpopup_horizontal_set(Evas_Object *obj, Eina_Bool horizontal) EINA_ARG_NONNULL(1);
2999    EAPI Eina_Bool     elm_ctxpopup_horizontal_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
3000    Elm_Ctxpopup_Item *elm_ctxpopup_item_append(Evas_Object *obj, const char *label, Evas_Object *icon, Evas_Smart_Cb func, const void *data) EINA_ARG_NONNULL(1);
3001    EAPI void          elm_ctxpopup_item_del(Elm_Ctxpopup_Item *item) EINA_ARG_NONNULL(1);
3002    EAPI void          elm_ctxpopup_item_disabled_set(Elm_Ctxpopup_Item *item, Eina_Bool disabled) EINA_ARG_NONNULL(1);
3003    EAPI Eina_Bool     elm_ctxpopup_item_disabled_get(const Elm_Ctxpopup_Item *item) EINA_ARG_NONNULL(1);
3004    EAPI void          elm_ctxpopup_content_set(Evas_Object *obj, Evas_Object *content) EINA_ARG_NONNULL(1, 2);
3005    EAPI Evas_Object  *elm_ctxpopup_content_unset(Evas_Object *obj) EINA_ARG_NONNULL(1);
3006    EAPI void          elm_ctxpopup_direction_priority_set(Evas_Object *obj, Elm_Ctxpopup_Direction first, Elm_Ctxpopup_Direction second, Elm_Ctxpopup_Direction third, Elm_Ctxpopup_Direction fourth) EINA_ARG_NONNULL(1);
3007    EAPI void          elm_ctxpopup_direction_priority_get(Evas_Object *obj, Elm_Ctxpopup_Direction *first, Elm_Ctxpopup_Direction *second, Elm_Ctxpopup_Direction *third, Elm_Ctxpopup_Direction *fourth) EINA_ARG_NONNULL(1);
3008    /* smart callbacks called:
3009     * "dismissed" - the ctxpopup was dismissed
3010     */
3011
3012    /* tansit */
3013    typedef enum
3014      {
3015         ELM_TRANSIT_TWEEN_MODE_LINEAR,
3016         ELM_TRANSIT_TWEEN_MODE_SINUSOIDAL,
3017         ELM_TRANSIT_TWEEN_MODE_DECELERATE,
3018         ELM_TRANSIT_TWEEN_MODE_ACCELERATE
3019      } Elm_Transit_Tween_Mode;
3020    typedef enum
3021      {
3022         ELM_TRANSIT_EFFECT_FLIP_AXIS_X,
3023         ELM_TRANSIT_EFFECT_FLIP_AXIS_Y
3024      } Elm_Transit_Effect_Flip_Axis;
3025    typedef enum
3026      {
3027         ELM_TRANSIT_EFFECT_WIPE_DIR_LEFT,
3028         ELM_TRANSIT_EFFECT_WIPE_DIR_RIGHT,
3029         ELM_TRANSIT_EFFECT_WIPE_DIR_UP,
3030         ELM_TRANSIT_EFFECT_WIPE_DIR_DOWN
3031      } Elm_Transit_Effect_Wipe_Dir;
3032    typedef enum
3033      {
3034         ELM_TRANSIT_EFFECT_WIPE_TYPE_HIDE,
3035         ELM_TRANSIT_EFFECT_WIPE_TYPE_SHOW
3036      } Elm_Transit_Effect_Wipe_Type;
3037
3038    typedef struct _Elm_Transit Elm_Transit;
3039    typedef void Elm_Transit_Effect;
3040    typedef void (*Elm_Transit_Effect_Transition_Cb) (Elm_Transit_Effect *effect, Elm_Transit *transit, double progress);
3041    typedef void (*Elm_Transit_Effect_End_Cb) (Elm_Transit_Effect *effect, Elm_Transit *transit);
3042
3043    EAPI Elm_Transit                *elm_transit_add(void);
3044    EAPI void                        elm_transit_del(Elm_Transit *transit) EINA_ARG_NONNULL(1);
3045    EAPI void                        elm_transit_effect_add(Elm_Transit *transit, Elm_Transit_Effect_Transition_Cb transition_cb, Elm_Transit_Effect *effect, Elm_Transit_Effect_End_Cb end_cb) EINA_ARG_NONNULL(1, 2);
3046    EAPI void                        elm_transit_effect_del(Elm_Transit *transit, Elm_Transit_Effect_Transition_Cb transition_cb, Elm_Transit_Effect *effect) EINA_ARG_NONNULL(1, 2);
3047    EAPI void                        elm_transit_object_add(Elm_Transit *transit, Evas_Object *obj) EINA_ARG_NONNULL(1, 2);
3048    EAPI void                        elm_transit_object_remove(Elm_Transit *transit, Evas_Object *obj) EINA_ARG_NONNULL(1, 2);
3049    EAPI const Eina_List            *elm_transit_objects_get(const Elm_Transit *transit) EINA_ARG_NONNULL(1);
3050    EAPI void                        elm_transit_objects_final_state_keep_set(Elm_Transit *transit, Eina_Bool state_keep) EINA_ARG_NONNULL(1);
3051    EAPI Eina_Bool                   elm_transit_objects_final_state_keep_get(const Elm_Transit *transit) EINA_ARG_NONNULL(1);
3052    EINA_DEPRECATED EAPI void                elm_transit_event_block_set(Elm_Transit *transit, Eina_Bool disabled) EINA_ARG_NONNULL(1);
3053    EINA_DEPRECATED EAPI Eina_Bool           elm_transit_event_block_get(const Elm_Transit *transit) EINA_ARG_NONNULL(1);
3054    EAPI void                        elm_transit_event_enabled_set(Elm_Transit *transit, Eina_Bool enabled) EINA_ARG_NONNULL(1);
3055    EAPI Eina_Bool                   elm_transit_event_enabled_get(const Elm_Transit *transit) EINA_ARG_NONNULL(1);
3056    EAPI void                        elm_transit_del_cb_set(Elm_Transit *transit, void (*cb)(void *data, Elm_Transit* transit), void *data) EINA_ARG_NONNULL(1);
3057    EAPI void                        elm_transit_auto_reverse_set(Elm_Transit *transit, Eina_Bool reverse) EINA_ARG_NONNULL(1);
3058    EAPI Eina_Bool                   elm_transit_auto_reverse_get(const Elm_Transit *transit) EINA_ARG_NONNULL(1);
3059    EAPI void                        elm_transit_repeat_times_set(Elm_Transit *transit, int repeat) EINA_ARG_NONNULL(1);
3060    EAPI int                         elm_transit_repeat_times_get(const Elm_Transit *transit) EINA_ARG_NONNULL(1);
3061    EAPI void                        elm_transit_tween_mode_set(Elm_Transit *transit, Elm_Transit_Tween_Mode tween_mode) EINA_ARG_NONNULL(1);
3062    EAPI Elm_Transit_Tween_Mode      elm_transit_tween_mode_get(const Elm_Transit *transit) EINA_ARG_NONNULL(1);
3063    EAPI void                        elm_transit_duration_set(Elm_Transit *transit, double duration) EINA_ARG_NONNULL(1);
3064    EAPI double                      elm_transit_duration_get(const Elm_Transit *transit) EINA_ARG_NONNULL(1);
3065    EAPI void                        elm_transit_go(Elm_Transit *transit) EINA_ARG_NONNULL(1);
3066    EAPI void                        elm_transit_paused_set(Elm_Transit *transit, Eina_Bool paused) EINA_ARG_NONNULL(1);
3067    EAPI Eina_Bool                   elm_transit_paused_get(const Elm_Transit *transit) EINA_ARG_NONNULL(1);
3068    EAPI double                      elm_transit_progress_value_get(const Elm_Transit *transit) EINA_ARG_NONNULL(1);
3069    EAPI void                        elm_transit_chain_transit_add(Elm_Transit *transit, Elm_Transit *chain_transit) EINA_ARG_NONNULL(1, 2);
3070    EAPI Eina_List                  *elm_transit_chain_transits_get(const Elm_Transit *transit);
3071
3072    EAPI Elm_Transit_Effect *elm_transit_effect_resizing_add(Elm_Transit* transit, Evas_Coord from_w, Evas_Coord from_h, Evas_Coord to_w, Evas_Coord to_h);
3073    EAPI Elm_Transit_Effect *elm_transit_effect_translation_add(Elm_Transit* transit, Evas_Coord from_dx, Evas_Coord dy, Evas_Coord to_dx, Evas_Coord to_dy);
3074    EAPI Elm_Transit_Effect *elm_transit_effect_zoom_add(Elm_Transit *transit, float from_rate, float to_rate);
3075    EAPI Elm_Transit_Effect *elm_transit_effect_flip_add(Elm_Transit *transit, Elm_Transit_Effect_Flip_Axis axis, Eina_Bool cw);
3076    EAPI Elm_Transit_Effect *elm_transit_effect_resizable_flip_add(Elm_Transit *transit, Elm_Transit_Effect_Flip_Axis axis, Eina_Bool cw);
3077    EAPI Elm_Transit_Effect *elm_transit_effect_wipe_add(Elm_Transit *transit, Elm_Transit_Effect_Wipe_Type type, Elm_Transit_Effect_Wipe_Dir dir);
3078    EAPI Elm_Transit_Effect *elm_transit_effect_color_add(Elm_Transit *transit, unsigned int from_r, unsigned int from_g, unsigned int from_b, unsigned int from_a, unsigned int to_r, unsigned int to_g, unsigned int to_b, unsigned int to_a);
3079    EAPI Elm_Transit_Effect *elm_transit_effect_fade_add(Elm_Transit *transit);
3080    EAPI Elm_Transit_Effect *elm_transit_effect_blend_add(Elm_Transit *transit);
3081    EAPI Elm_Transit_Effect *elm_transit_effect_rotation_add(Elm_Transit *transit, float from_degree, float to_degree);
3082    EAPI Elm_Transit_Effect *elm_transit_effect_image_animation_add(Elm_Transit *transit, Eina_List *images);
3083
3084    /* colorpalette */
3085    typedef struct _Colorpalette_Color Elm_Colorpalette_Color;
3086
3087    struct _Colorpalette_Color
3088      {
3089         unsigned int r, g, b;
3090      };
3091
3092    EAPI Evas_Object *elm_colorpalette_add(Evas_Object *parent);
3093    EAPI void         elm_colorpalette_color_set(Evas_Object *obj, int color_num, Elm_Colorpalette_Color *color);
3094    EAPI void         elm_colorpalette_row_column_set(Evas_Object *obj, int row, int col);
3095    /* smart callbacks called:
3096     * "clicked" - when image clicked
3097     */
3098
3099    /* editfield */
3100    EAPI Evas_Object *elm_editfield_add(Evas_Object *parent);
3101    EAPI void         elm_editfield_label_set(Evas_Object *obj, const char *label);
3102    EAPI const char  *elm_editfield_label_get(Evas_Object *obj);
3103    EAPI void         elm_editfield_guide_text_set(Evas_Object *obj, const char *text);
3104    EAPI const char  *elm_editfield_guide_text_get(Evas_Object *obj);
3105    EAPI Evas_Object *elm_editfield_entry_get(Evas_Object *obj);
3106 //   EAPI Evas_Object *elm_editfield_clear_button_show(Evas_Object *obj, Eina_Bool show);
3107    EAPI void         elm_editfield_right_icon_set(Evas_Object *obj, Evas_Object *icon);
3108    EAPI Evas_Object *elm_editfield_right_icon_get(Evas_Object *obj);
3109    EAPI void         elm_editfield_left_icon_set(Evas_Object *obj, Evas_Object *icon);
3110    EAPI Evas_Object *elm_editfield_left_icon_get(Evas_Object *obj);
3111    EAPI void         elm_editfield_entry_single_line_set(Evas_Object *obj, Eina_Bool single_line);
3112    EAPI Eina_Bool    elm_editfield_entry_single_line_get(Evas_Object *obj);
3113    EAPI void         elm_editfield_eraser_set(Evas_Object *obj, Eina_Bool visible);
3114    EAPI Eina_Bool    elm_editfield_eraser_get(Evas_Object *obj);
3115    /* smart callbacks called:
3116     * "clicked" - when an editfield is clicked
3117     * "unfocused" - when an editfield is unfocused
3118     */
3119
3120
3121    /* Sliding Drawer */
3122    typedef enum _Elm_SlidingDrawer_Pos
3123      {
3124         ELM_SLIDINGDRAWER_BOTTOM,
3125         ELM_SLIDINGDRAWER_LEFT,
3126         ELM_SLIDINGDRAWER_RIGHT,
3127         ELM_SLIDINGDRAWER_TOP
3128      } Elm_SlidingDrawer_Pos;
3129
3130    typedef struct _Elm_SlidingDrawer_Drag_Value
3131      {
3132         double x, y;
3133      } Elm_SlidingDrawer_Drag_Value;
3134
3135    EAPI Evas_Object *elm_slidingdrawer_add(Evas_Object *parent);
3136    EAPI void         elm_slidingdrawer_content_set (Evas_Object *obj, Evas_Object *content);
3137    EAPI Evas_Object *elm_slidingdrawer_content_unset(Evas_Object *obj);
3138    EAPI void         elm_slidingdrawer_pos_set(Evas_Object *obj, Elm_SlidingDrawer_Pos pos);
3139    EAPI void         elm_slidingdrawer_max_drag_value_set(Evas_Object *obj, double dw,  double dh);
3140    EAPI void         elm_slidingdrawer_drag_value_set(Evas_Object *obj, double dx, double dy);
3141
3142    /* multibuttonentry */
3143    typedef struct _Multibuttonentry_Item Elm_Multibuttonentry_Item;
3144    EAPI Evas_Object               *elm_multibuttonentry_add(Evas_Object *parent);
3145    EAPI const char                *elm_multibuttonentry_label_get(Evas_Object *obj);
3146    EAPI void                       elm_multibuttonentry_label_set(Evas_Object *obj, const char *label);
3147    EAPI Evas_Object               *elm_multibuttonentry_entry_get(Evas_Object *obj);
3148    EAPI const char *               elm_multibuttonentry_guide_text_get(Evas_Object *obj);
3149    EAPI void                       elm_multibuttonentry_guide_text_set(Evas_Object *obj, const char *guidetext);
3150    EAPI int                        elm_multibuttonentry_contracted_state_get(Evas_Object *obj);
3151    EAPI void                       elm_multibuttonentry_contracted_state_set(Evas_Object *obj, int contracted);
3152    EAPI Elm_Multibuttonentry_Item *elm_multibuttonentry_item_add_start(Evas_Object *obj, const char *label, void *data);
3153    EAPI Elm_Multibuttonentry_Item *elm_multibuttonentry_item_add_end(Evas_Object *obj, const char *label, void *data);
3154    EAPI Elm_Multibuttonentry_Item *elm_multibuttonentry_item_add_before(Evas_Object *obj, const char *label, Elm_Multibuttonentry_Item *before, void *data);
3155    EAPI Elm_Multibuttonentry_Item *elm_multibuttonentry_item_add_after(Evas_Object *obj, const char *label, Elm_Multibuttonentry_Item *after, void *data);
3156    EAPI const Eina_List           *elm_multibuttonentry_items_get(Evas_Object *obj);
3157    EAPI Elm_Multibuttonentry_Item *elm_multibuttonentry_item_first_get(Evas_Object *obj);
3158    EAPI Elm_Multibuttonentry_Item *elm_multibuttonentry_item_last_get(Evas_Object *obj);
3159    EAPI Elm_Multibuttonentry_Item *elm_multibuttonentry_item_selected_get(Evas_Object *obj);
3160    EAPI void                       elm_multibuttonentry_item_selected_set(Elm_Multibuttonentry_Item *item);
3161    EAPI void                       elm_multibuttonentry_item_unselect_all(Evas_Object *obj);
3162    EAPI void                       elm_multibuttonentry_item_del(Elm_Multibuttonentry_Item *item);
3163    EAPI void                       elm_multibuttonentry_items_del(Evas_Object *obj);
3164    EAPI const char                *elm_multibuttonentry_item_label_get(Elm_Multibuttonentry_Item *item);
3165    EAPI void                       elm_multibuttonentry_item_label_set(Elm_Multibuttonentry_Item *item, const char *str);
3166    EAPI Elm_Multibuttonentry_Item *elm_multibuttonentry_item_prev(Elm_Multibuttonentry_Item *item);
3167    EAPI Elm_Multibuttonentry_Item *elm_multibuttonentry_item_next(Elm_Multibuttonentry_Item *item);
3168    EAPI void                      *elm_multibuttonentry_item_data_get(Elm_Multibuttonentry_Item *item);
3169    EAPI void                       elm_multibuttonentry_item_data_set(Elm_Multibuttonentry_Item *item, void *data);
3170    /* smart callback called:
3171     * "selected" - This signal is emitted when the selected item of multibuttonentry is changed.
3172     * "added" - This signal is emitted when a new multibuttonentry item is added.
3173     * "deleted" - This signal is emitted when a multibuttonentry item is deleted.
3174     * "expanded" - This signal is emitted when a multibuttonentry is expanded.
3175     * "contracted" - This signal is emitted when a multibuttonentry is contracted.
3176     * "contracted,state,changed" - This signal is emitted when the contracted state of multibuttonentry is changed.
3177     * "item,selected" - This signal is emitted when the selected item of multibuttonentry is changed.
3178     * "item,added" - This signal is emitted when a new multibuttonentry item is added.
3179     * "item,deleted" - This signal is emitted when a multibuttonentry item is deleted.
3180     * "item,clicked" - This signal is emitted when a multibuttonentry item is clicked.
3181     * "clicked" - This signal is emitted when a multibuttonentry is clicked.
3182     * "unfocused" - This signal is emitted when a multibuttonentry is unfocused.
3183     */
3184    /* available styles:
3185     * default
3186     */
3187
3188    /* stackedicon */
3189    typedef struct _Stackedicon_Item Elm_Stackedicon_Item;
3190    EAPI Evas_Object          *elm_stackedicon_add(Evas_Object *parent);
3191    EAPI Elm_Stackedicon_Item *elm_stackedicon_item_append(Evas_Object *obj, const char *path);
3192    EAPI Elm_Stackedicon_Item *elm_stackedicon_item_prepend(Evas_Object *obj, const char *path);
3193    EAPI void                  elm_stackedicon_item_del(Elm_Stackedicon_Item *it);
3194    EAPI Eina_List            *elm_stackedicon_item_list_get(Evas_Object *obj);
3195    /* smart callback called:
3196     * "expanded" - This signal is emitted when a stackedicon is expanded.
3197     * "clicked" - This signal is emitted when a stackedicon is clicked.
3198     */
3199    /* available styles:
3200     * default
3201     */
3202
3203    /* dialoguegroup */
3204    typedef struct _Dialogue_Item Dialogue_Item;
3205
3206    typedef enum _Elm_Dialoguegourp_Item_Style
3207      {
3208         ELM_DIALOGUEGROUP_ITEM_STYLE_DEFAULT = 0,
3209         ELM_DIALOGUEGROUP_ITEM_STYLE_EDITFIELD = (1 << 0),
3210         ELM_DIALOGUEGROUP_ITEM_STYLE_EDITFIELD_WITH_TITLE = (1 << 1),
3211         ELM_DIALOGUEGROUP_ITEM_STYLE_EDIT_TITLE = (1 << 2),
3212         ELM_DIALOGUEGROUP_ITEM_STYLE_HIDDEN = (1 << 3),
3213         ELM_DIALOGUEGROUP_ITEM_STYLE_DATAVIEW = (1 << 4),
3214         ELM_DIALOGUEGROUP_ITEM_STYLE_NO_BG = (1 << 5),
3215         ELM_DIALOGUEGROUP_ITEM_STYLE_SUB = (1 << 6),
3216         ELM_DIALOGUEGROUP_ITEM_STYLE_EDIT = (1 << 7),
3217         ELM_DIALOGUEGROUP_ITEM_STYLE_EDIT_MERGE = (1 << 8),
3218         ELM_DIALOGUEGROUP_ITEM_STYLE_LAST = (1 << 9)
3219      } Elm_Dialoguegroup_Item_Style;
3220
3221    EINA_DEPRECATED EAPI Evas_Object   *elm_dialoguegroup_add(Evas_Object *parent);
3222    EINA_DEPRECATED EAPI Dialogue_Item *elm_dialoguegroup_append(Evas_Object *obj, Evas_Object *subobj, Elm_Dialoguegroup_Item_Style style);
3223    EINA_DEPRECATED EAPI Dialogue_Item *elm_dialoguegroup_prepend(Evas_Object *obj, Evas_Object *subobj, Elm_Dialoguegroup_Item_Style style);
3224    EINA_DEPRECATED EAPI Dialogue_Item *elm_dialoguegroup_insert_after(Evas_Object *obj, Evas_Object *subobj, Dialogue_Item *after, Elm_Dialoguegroup_Item_Style style);
3225    EINA_DEPRECATED EAPI Dialogue_Item *elm_dialoguegroup_insert_before(Evas_Object *obj, Evas_Object *subobj, Dialogue_Item *before, Elm_Dialoguegroup_Item_Style style);
3226    EINA_DEPRECATED EAPI void           elm_dialoguegroup_remove(Dialogue_Item *item);
3227    EINA_DEPRECATED EAPI void           elm_dialoguegroup_remove_all(Evas_Object *obj);
3228    EINA_DEPRECATED EAPI void           elm_dialoguegroup_title_set(Evas_Object *obj, const char *title);
3229    EINA_DEPRECATED EAPI const char    *elm_dialoguegroup_title_get(Evas_Object *obj);
3230    EINA_DEPRECATED EAPI void           elm_dialoguegroup_press_effect_set(Dialogue_Item *item, Eina_Bool press);
3231    EINA_DEPRECATED EAPI Eina_Bool      elm_dialoguegroup_press_effect_get(Dialogue_Item *item);
3232    EINA_DEPRECATED EAPI Evas_Object   *elm_dialoguegroup_item_content_get(Dialogue_Item *item);
3233    EINA_DEPRECATED EAPI void           elm_dialoguegroup_item_style_set(Dialogue_Item *item, Elm_Dialoguegroup_Item_Style style);
3234    EINA_DEPRECATED EAPI Elm_Dialoguegroup_Item_Style    elm_dialoguegroup_item_style_get(Dialogue_Item *item);
3235    EINA_DEPRECATED EAPI void           elm_dialoguegroup_item_disabled_set(Dialogue_Item *item, Eina_Bool disabled);
3236    EINA_DEPRECATED EAPI Eina_Bool      elm_dialoguegroup_item_disabled_get(Dialogue_Item *item);
3237
3238    /* Dayselector */
3239    typedef enum
3240      {
3241         ELM_DAYSELECTOR_SUN,
3242         ELM_DAYSELECTOR_MON,
3243         ELM_DAYSELECTOR_TUE,
3244         ELM_DAYSELECTOR_WED,
3245         ELM_DAYSELECTOR_THU,
3246         ELM_DAYSELECTOR_FRI,
3247         ELM_DAYSELECTOR_SAT
3248      } Elm_DaySelector_Day;
3249
3250    EAPI Evas_Object *elm_dayselector_add(Evas_Object *parent);
3251    EAPI Eina_Bool    elm_dayselector_check_state_get(Evas_Object *obj, Elm_DaySelector_Day day);
3252    EAPI void         elm_dayselector_check_state_set(Evas_Object *obj, Elm_DaySelector_Day day, Eina_Bool checked);
3253
3254    /* NoContents */
3255    EAPI Evas_Object *elm_nocontents_add(Evas_Object *parent);
3256    EAPI void         elm_nocontents_label_set(Evas_Object *obj, const char *label);
3257    EAPI const char  *elm_nocontents_label_get(const Evas_Object *obj);
3258    EAPI void         elm_nocontents_custom_set(const Evas_Object *obj, Evas_Object *custom);
3259    EAPI Evas_Object *elm_nocontents_custom_get(const Evas_Object *obj);
3260
3261    /* TickerNoti */
3262    typedef enum
3263      {
3264         ELM_TICKERNOTI_DEFAULT,
3265         ELM_TICKERNOTI_DETAILVIEW
3266      } Elm_Tickernoti_Mode;
3267
3268    EAPI Evas_Object         *elm_tickernoti_add (Evas_Object *parent);
3269    EAPI void                 elm_tickernoti_icon_set (const Evas_Object *obj, Evas_Object *icon);
3270    EAPI Evas_Object         *elm_tickernoti_icon_get (const Evas_Object *obj);
3271    EAPI void                 elm_tickernoti_label_set (Evas_Object *obj, const char *label);
3272    EAPI const char          *elm_tickernoti_label_get (const Evas_Object *obj);
3273    EAPI void                 elm_tickernoti_detailview_label_set (Evas_Object *obj, const char *label);
3274    EAPI const char          *elm_tickernoti_detailview_label_get (const Evas_Object *obj);
3275    EAPI void                 elm_tickernoti_detailview_button_set (const Evas_Object *obj, Evas_Object *button);
3276    EAPI Evas_Object         *elm_tickernoti_detailview_button_get (const Evas_Object *obj);
3277    EAPI void                 elm_tickernoti_detailview_icon_set (const Evas_Object *obj, Evas_Object *icon);
3278    EAPI Evas_Object         *elm_tickernoti_detailview_icon_get (const Evas_Object *obj);
3279    EAPI Evas_Object         *elm_tickernoti_detailview_get (const Evas_Object *obj);
3280    EAPI int                  elm_tickernoti_rotation_get (const Evas_Object *obj);
3281    EAPI void                 elm_tickernoti_rotation_set (const Evas_Object *obj, int angle);
3282    EAPI void                 elm_tickernoti_mode_set (const Evas_Object *obj, Elm_Tickernoti_Mode mode);
3283    EAPI Elm_Tickernoti_Mode  elm_tickernoti_mode_get (const Evas_Object *obj);
3284
3285    /* Image Slider */
3286    typedef struct _Imageslider_Item Elm_Imageslider_Item;
3287    typedef void (*Elm_Imageslider_Cb)(void *data, Evas_Object *obj, void *event_info);
3288    EAPI Evas_Object           *elm_imageslider_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
3289    EAPI Elm_Imageslider_Item  *elm_imageslider_item_append(Evas_Object *obj, const char *photo_file, Elm_Imageslider_Cb func, void *data) EINA_ARG_NONNULL(1);
3290    EAPI Elm_Imageslider_Item  *elm_imageslider_item_append_relative(Evas_Object *obj, const char *photo_file, Elm_Imageslider_Cb func, unsigned int index, void *data) EINA_ARG_NONNULL(1);
3291    EAPI Elm_Imageslider_Item  *elm_imageslider_item_prepend(Evas_Object *obj, const char *photo_file, Elm_Imageslider_Cb func, void *data) EINA_ARG_NONNULL(1);
3292    EAPI void                   elm_imageslider_item_del(Elm_Imageslider_Item *it) EINA_ARG_NONNULL(1);
3293    EAPI Elm_Imageslider_Item  *elm_imageslider_selected_item_get(Evas_Object *obj) EINA_ARG_NONNULL(1);
3294    EAPI Eina_Bool              elm_imageslider_item_selected_get(Elm_Imageslider_Item *it) EINA_ARG_NONNULL(1);
3295    EAPI void                   elm_imageslider_item_selected_set(Elm_Imageslider_Item *it) EINA_ARG_NONNULL(1);
3296    EAPI const char            *elm_imageslider_item_photo_file_get(Elm_Imageslider_Item *it) EINA_ARG_NONNULL(1);
3297    EAPI Elm_Imageslider_Item  *elm_imageslider_item_prev(Elm_Imageslider_Item *it) EINA_ARG_NONNULL(1);
3298    EAPI Elm_Imageslider_Item  *elm_imageslider_item_next(Elm_Imageslider_Item *it) EINA_ARG_NONNULL(1);
3299    EAPI void                   elm_imageslider_prev(Evas_Object *obj) EINA_ARG_NONNULL(1);
3300    EAPI void                   elm_imageslider_next(Evas_Object *obj) EINA_ARG_NONNULL(1);
3301
3302    /* Store */
3303    typedef struct _Elm_Store                      Elm_Store;
3304    typedef struct _Elm_Store_DBsystem             Elm_Store_DBsystem;
3305    typedef struct _Elm_Store_Filesystem           Elm_Store_Filesystem;
3306    typedef struct _Elm_Store_Item                 Elm_Store_Item;
3307    typedef struct _Elm_Store_Item_DBsystem        Elm_Store_Item_DBsystem;
3308    typedef struct _Elm_Store_Item_Filesystem      Elm_Store_Item_Filesystem;
3309    typedef struct _Elm_Store_Item_Info            Elm_Store_Item_Info;
3310    typedef struct _Elm_Store_Item_Info_Filesystem Elm_Store_Item_Info_Filesystem;
3311    typedef struct _Elm_Store_Item_Mapping         Elm_Store_Item_Mapping;
3312    typedef struct _Elm_Store_Item_Mapping_Empty   Elm_Store_Item_Mapping_Empty;
3313    typedef struct _Elm_Store_Item_Mapping_Icon    Elm_Store_Item_Mapping_Icon;
3314    typedef struct _Elm_Store_Item_Mapping_Photo   Elm_Store_Item_Mapping_Photo;
3315    typedef struct _Elm_Store_Item_Mapping_Custom  Elm_Store_Item_Mapping_Custom;
3316
3317    typedef Eina_Bool (*Elm_Store_Item_List_Cb) (void *data, Elm_Store_Item_Info *info);
3318    typedef void      (*Elm_Store_Item_Fetch_Cb) (void *data, Elm_Store_Item *sti, Elm_Store_Item_Info *info);
3319    typedef void      (*Elm_Store_Item_Unfetch_Cb) (void *data, Elm_Store_Item *sti, Elm_Store_Item_Info *info);
3320    typedef void      (*Elm_Store_Item_Select_Cb) (void *data, Elm_Store_Item *sti);
3321    typedef int       (*Elm_Store_Item_Sort_Cb) (void *data, Elm_Store_Item_Info *info1, Elm_Store_Item_Info *info2);
3322    typedef void      (*Elm_Store_Item_Free_Cb) (void *data, Elm_Store_Item_Info *info);
3323    typedef void     *(*Elm_Store_Item_Mapping_Cb) (void *data, Elm_Store_Item *sti, const char *part);
3324
3325    typedef enum
3326      {
3327         ELM_STORE_ITEM_MAPPING_NONE = 0,
3328         ELM_STORE_ITEM_MAPPING_LABEL, // const char * -> label
3329         ELM_STORE_ITEM_MAPPING_STATE, // Eina_Bool -> state
3330         ELM_STORE_ITEM_MAPPING_ICON, // char * -> icon path
3331         ELM_STORE_ITEM_MAPPING_PHOTO, // char * -> photo path
3332         ELM_STORE_ITEM_MAPPING_CUSTOM, // item->custom(it->data, it, part) -> void * (-> any)
3333         // can add more here as needed by common apps
3334         ELM_STORE_ITEM_MAPPING_LAST
3335      } Elm_Store_Item_Mapping_Type;
3336
3337    struct _Elm_Store_Item_Mapping_Icon
3338      {
3339         // FIXME: allow edje file icons
3340         int                   w, h;
3341         Elm_Icon_Lookup_Order lookup_order;
3342         Eina_Bool             standard_name : 1;
3343         Eina_Bool             no_scale : 1;
3344         Eina_Bool             smooth : 1;
3345         Eina_Bool             scale_up : 1;
3346         Eina_Bool             scale_down : 1;
3347      };
3348
3349    struct _Elm_Store_Item_Mapping_Empty
3350      {
3351         Eina_Bool             dummy;
3352      };
3353
3354    struct _Elm_Store_Item_Mapping_Photo
3355      {
3356         int                   size;
3357      };
3358
3359    struct _Elm_Store_Item_Mapping_Custom
3360      {
3361         Elm_Store_Item_Mapping_Cb func;
3362      };
3363
3364    struct _Elm_Store_Item_Mapping
3365      {
3366         Elm_Store_Item_Mapping_Type     type;
3367         const char                     *part;
3368         int                             offset;
3369         union {
3370              Elm_Store_Item_Mapping_Empty  empty;
3371              Elm_Store_Item_Mapping_Icon   icon;
3372              Elm_Store_Item_Mapping_Photo  photo;
3373              Elm_Store_Item_Mapping_Custom custom;
3374              // add more types here
3375         } details;
3376      };
3377
3378    struct _Elm_Store_Item_Info
3379      {
3380         int                           index;
3381         int                           item_type;
3382         int                           group_index;
3383         Eina_Bool                     rec_item;
3384         int                           pre_group_index;
3385
3386         Elm_Genlist_Item_Class       *item_class;
3387         const Elm_Store_Item_Mapping *mapping;
3388         void                         *data;
3389         char                         *sort_id;
3390      };
3391
3392    struct _Elm_Store_Item_Info_Filesystem
3393      {
3394         Elm_Store_Item_Info  base;
3395         char                *path;
3396      };
3397
3398 #define ELM_STORE_ITEM_MAPPING_END { ELM_STORE_ITEM_MAPPING_NONE, NULL, 0, { .empty = { EINA_TRUE } } }
3399 #define ELM_STORE_ITEM_MAPPING_OFFSET(st, it) offsetof(st, it)
3400
3401    EAPI Elm_Store              *elm_store_dbsystem_new(void);
3402    EAPI void                    elm_store_item_count_set(Elm_Store *st, int count) EINA_ARG_NONNULL(1);
3403    EAPI void                    elm_store_item_select_func_set(Elm_Store *st, Elm_Store_Item_Select_Cb func, const void *data) EINA_ARG_NONNULL(1);
3404    EAPI void                    elm_store_item_sort_func_set(Elm_Store *st, Elm_Store_Item_Sort_Cb func, const void *data) EINA_ARG_NONNULL(1);
3405    EAPI void                    elm_store_item_free_func_set(Elm_Store *st, Elm_Store_Item_Free_Cb func, const void *data) EINA_ARG_NONNULL(1);
3406    EAPI int                     elm_store_item_data_index_get(const Elm_Store_Item *sti) EINA_ARG_NONNULL(1);
3407    EAPI void                   *elm_store_dbsystem_db_get(const Elm_Store_Item *sti) EINA_ARG_NONNULL(1);
3408    EAPI void                    elm_store_dbsystem_db_set(Elm_Store *store, void *pDB) EINA_ARG_NONNULL(1);
3409    EAPI int                     elm_store_item_index_get(const Elm_Store_Item *sti) EINA_ARG_NONNULL(1);
3410    EAPI Elm_Store_Item         *elm_store_item_add(Elm_Store *st, Elm_Store_Item_Info *info) EINA_ARG_NONNULL(1);
3411    EAPI void                    elm_store_item_update(Elm_Store_Item *sti) EINA_ARG_NONNULL(1);
3412    EAPI void                    elm_store_visible_items_update(Elm_Store *st) EINA_ARG_NONNULL(1);
3413    EAPI void                    elm_store_item_del(Elm_Store_Item *sti) EINA_ARG_NONNULL(1);
3414    EAPI void                    elm_store_free(Elm_Store *st);
3415    EAPI Elm_Store              *elm_store_filesystem_new(void);
3416    EAPI void                    elm_store_filesystem_directory_set(Elm_Store *st, const char *dir) EINA_ARG_NONNULL(1);
3417    EAPI const char             *elm_store_filesystem_directory_get(const Elm_Store *st) EINA_ARG_NONNULL(1);
3418    EAPI const char             *elm_store_item_filesystem_path_get(const Elm_Store_Item *sti) EINA_ARG_NONNULL(1);
3419    EAPI void                    elm_store_target_genlist_set(Elm_Store *st, Evas_Object *obj) EINA_ARG_NONNULL(1);
3420    EAPI void                    elm_store_cache_set(Elm_Store *st, int max) EINA_ARG_NONNULL(1);
3421    EAPI int                     elm_store_cache_get(const Elm_Store *st) EINA_ARG_NONNULL(1);
3422    EAPI void                    elm_store_list_func_set(Elm_Store *st, Elm_Store_Item_List_Cb func, const void *data) EINA_ARG_NONNULL(1, 2);
3423    EAPI void                    elm_store_fetch_func_set(Elm_Store *st, Elm_Store_Item_Fetch_Cb func, const void *data) EINA_ARG_NONNULL(1, 2);
3424    EAPI void                    elm_store_fetch_thread_set(Elm_Store *st, Eina_Bool use_thread) EINA_ARG_NONNULL(1);
3425    EAPI Eina_Bool               elm_store_fetch_thread_get(const Elm_Store *st) EINA_ARG_NONNULL(1);
3426    EAPI void                    elm_store_unfetch_func_set(Elm_Store *st, Elm_Store_Item_Unfetch_Cb func, const void *data) EINA_ARG_NONNULL(1, 2);
3427    EAPI void                    elm_store_sorted_set(Elm_Store *st, Eina_Bool sorted) EINA_ARG_NONNULL(1);
3428    EAPI Eina_Bool               elm_store_sorted_get(const Elm_Store *st) EINA_ARG_NONNULL(1);
3429    EAPI void                    elm_store_item_data_set(Elm_Store_Item *sti, void *data) EINA_ARG_NONNULL(1);
3430    EAPI void                   *elm_store_item_data_get(Elm_Store_Item *sti) EINA_ARG_NONNULL(1);
3431    EAPI const Elm_Store        *elm_store_item_store_get(const Elm_Store_Item *sti) EINA_ARG_NONNULL(1);
3432    EAPI const Elm_Genlist_Item *elm_store_item_genlist_item_get(const Elm_Store_Item *sti) EINA_ARG_NONNULL(1);
3433
3434    /* SegmentControl */
3435    typedef struct _Elm_Segment_Item Elm_Segment_Item;
3436    EAPI Evas_Object      *elm_segment_control_add(Evas_Object *parent) EINA_ARG_NONNULL(1);
3437    EAPI Elm_Segment_Item *elm_segment_control_item_add(Evas_Object *obj, Evas_Object *icon, const char *label) EINA_ARG_NONNULL(1);
3438    EAPI Elm_Segment_Item *elm_segment_control_item_insert_at(Evas_Object *obj, Evas_Object *icon, const char *label, int index) EINA_ARG_NONNULL(1);
3439    EAPI void              elm_segment_control_item_del(Elm_Segment_Item *it) EINA_ARG_NONNULL(1);
3440    EAPI void              elm_segment_control_item_del_at(Evas_Object *obj, int index) EINA_ARG_NONNULL(1);
3441    EAPI int               elm_segment_control_item_count_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
3442    EAPI Elm_Segment_Item *elm_segment_control_item_get(const Evas_Object *obj, int index) EINA_ARG_NONNULL(1);
3443    EAPI const char       *elm_segment_control_item_label_get(Evas_Object *obj, int index) EINA_ARG_NONNULL(1);
3444    EAPI void              elm_segment_control_item_label_set(Elm_Segment_Item* it, const char* label) EINA_ARG_NONNULL(1);
3445    EAPI Evas_Object      *elm_segment_control_item_icon_get(const Evas_Object *obj, int index) EINA_ARG_NONNULL(1);
3446    EAPI void              elm_segment_control_item_icon_set(Elm_Segment_Item *it, Evas_Object *icon) EINA_ARG_NONNULL(1);
3447    EAPI int               elm_segment_control_item_index_get(const Elm_Segment_Item *it) EINA_ARG_NONNULL(1);
3448    EAPI Evas_Object      *elm_segment_control_item_object_get(const Elm_Segment_Item *it) EINA_ARG_NONNULL(1);
3449    EAPI Elm_Segment_Item *elm_segment_control_item_selected_get(const Evas_Object *obj) EINA_ARG_NONNULL(1);
3450    EAPI void              elm_segment_control_item_selected_set(Elm_Segment_Item *it, Eina_Bool select) EINA_ARG_NONNULL(1);
3451    /* smart callbacks called:
3452     * "changed" -when the user clicks on a segment item which is not previously
3453     *            selected and get selected. The event_info parameter is the
3454     *            segment item index.
3455     */
3456
3457 #ifdef __cplusplus
3458 }
3459 #endif
3460
3461 #endif