2 * @defgroup Tooltips Tooltips
4 * The Tooltip is an (internal, for now) smart object used to show a
5 * content in a frame on mouse hover of objects(or widgets), with
6 * tips/information about them.
12 * Called back when a widget's tooltip is activated and needs content.
13 * @param data user-data given to elm_object_tooltip_content_cb_set()
14 * @param obj owner widget.
15 * @param tooltip The tooltip object (affix content to this!)
17 typedef Evas_Object *(*Elm_Tooltip_Content_Cb)(void *data, Evas_Object *obj, Evas_Object *tooltip);
20 * Called back when a widget's item tooltip is activated and needs content.
21 * @param data user-data given to elm_object_tooltip_content_cb_set()
22 * @param obj owner widget.
23 * @param tooltip The tooltip object (affix content to this!)
24 * @param item context dependent item. As an example, if tooltip was
25 * set on elm_list item, then it is of this type.
27 typedef Evas_Object *(*Elm_Tooltip_Item_Content_Cb)(void *data, Evas_Object *obj, Evas_Object *tooltip, void *item);
29 EAPI void elm_object_tooltip_show(Evas_Object *obj);
30 EAPI void elm_object_tooltip_hide(Evas_Object *obj);
33 * Set the text to be displayed inside the tooltip.
35 * @param obj The tooltip object.
36 * @param text The text to be displayed.
38 EAPI void elm_object_tooltip_text_set(Evas_Object *obj, const char *text);
39 EAPI void elm_object_tooltip_domain_translatable_text_set(Evas_Object *obj, const char *domain, const char *text);
40 #define elm_object_tooltip_translatable_text_set(obj, text) elm_object_tooltip_domain_translatable_text_set((obj), NULL, (text))
41 EAPI void elm_object_tooltip_content_cb_set(Evas_Object *obj, Elm_Tooltip_Content_Cb func, const void *data, Evas_Smart_Cb del_cb);
42 EAPI void elm_object_tooltip_unset(Evas_Object *obj);
45 * Sets a different style for this object tooltip.
47 * @note before you set a style you should define a tooltip with
48 * elm_object_tooltip_content_cb_set() or
49 * elm_object_tooltip_text_set().
51 * @param obj an object with tooltip already set.
52 * @param style the theme style to use (default, transparent, ...)
54 EAPI void elm_object_tooltip_style_set(Evas_Object *obj, const char *style);
57 * Get the style for this object tooltip.
59 * @param obj an object with tooltip already set.
60 * @return style the theme style in use, defaults to "default". If the
61 * object does not have a tooltip set, then NULL is returned.
63 EAPI const char *elm_object_tooltip_style_get(const Evas_Object *obj);
66 * @brief Disable size restrictions on an object's tooltip
67 * @param obj The tooltip's anchor object
68 * @param disable If EINA_TRUE, size restrictions are disabled
69 * @return EINA_FALSE on failure, EINA_TRUE on success
71 * This function allows a tooltip to expand beyond its parent window's canvas.
72 * It will instead be limited only by the size of the display.
74 EAPI Eina_Bool elm_object_tooltip_window_mode_set(Evas_Object *obj, Eina_Bool disable);
77 * @brief Retrieve size restriction state of an object's tooltip
78 * @param obj The tooltip's anchor object
79 * @return If EINA_TRUE, size restrictions are disabled
81 * This function returns whether a tooltip is allowed to expand beyond
82 * its parent window's canvas.
83 * It will instead be limited only by the size of the display.
85 EAPI Eina_Bool elm_object_tooltip_window_mode_get(const Evas_Object *obj);