2011-12-29 23:20:48 -08:00
|
|
|
/**
|
|
|
|
* @defgroup Hover Hover
|
2012-04-16 18:35:46 -07:00
|
|
|
* @ingroup Elementary
|
2011-12-29 23:20:48 -08:00
|
|
|
*
|
2012-06-05 15:41:21 -07:00
|
|
|
* @image html hover_inheritance_tree.png
|
|
|
|
* @image latex hover_inheritance_tree.eps
|
|
|
|
*
|
2011-12-29 23:20:48 -08:00
|
|
|
* @image html img/widget/hover/preview-00.png
|
|
|
|
* @image latex img/widget/hover/preview-00.eps
|
|
|
|
*
|
|
|
|
* A Hover object will hover over its @p parent object at the @p target
|
|
|
|
* location. Anything in the background will be given a darker coloring to
|
|
|
|
* indicate that the hover object is on top (at the default theme). When the
|
|
|
|
* hover is clicked it is dismissed(hidden), if the contents of the hover are
|
|
|
|
* clicked that @b doesn't cause the hover to be dismissed.
|
|
|
|
*
|
|
|
|
* A Hover object has two parents. One parent that owns it during creation
|
|
|
|
* and the other parent being the one over which the hover object spans.
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* @note The hover object will take up the entire space of @p target
|
|
|
|
* object.
|
|
|
|
*
|
|
|
|
* Elementary has the following styles for the hover widget:
|
|
|
|
* @li default
|
|
|
|
* @li popout
|
|
|
|
* @li menu
|
|
|
|
* @li hoversel_vertical
|
|
|
|
*
|
2012-05-03 15:42:49 -07:00
|
|
|
* This widget inherits from the @ref Layout one, so that all the
|
|
|
|
* functions acting on it also work for hover objects.
|
|
|
|
*
|
|
|
|
* This widget emits the following signals, besides the ones sent from
|
|
|
|
* @ref Layout:
|
|
|
|
* @li @c "clicked" - the user clicked the empty space in the hover to dismiss
|
2013-09-21 03:28:04 -07:00
|
|
|
* @li @c "dismissed" - the user clicked the empty space in the hover to dismiss (since 1.8)
|
2012-05-03 15:42:49 -07:00
|
|
|
* @li @c "smart,changed" - a content object placed under the "smart"
|
2011-12-29 23:20:48 -08:00
|
|
|
* policy was replaced to a new slot direction.
|
elm: added more "focused" and "unfocused" documentations.
genlist, hover, index, list, map, photocam, progressbar, radio, scroller, slider, slideshow, spinner, toolbar, win.
2013-06-09 22:12:51 -07:00
|
|
|
* @li @c "focused" - When the hover has received focus. (since 1.8)
|
|
|
|
* @li @c "unfocused" - When the hover has lost focus. (since 1.8)
|
2011-12-29 23:20:48 -08:00
|
|
|
*
|
2012-02-27 18:39:31 -08:00
|
|
|
* Default content parts of the hover widget that you can use for are:
|
2012-05-03 15:42:49 -07:00
|
|
|
* @li @c "left"
|
|
|
|
* @li @c "top-left"
|
|
|
|
* @li @c "top"
|
|
|
|
* @li @c "top-right"
|
|
|
|
* @li @c "right"
|
|
|
|
* @li @c "bottom-right"
|
|
|
|
* @li @c "bottom"
|
|
|
|
* @li @c "bottom-left"
|
|
|
|
* @li @c "middle"
|
|
|
|
* @li @c "smart"
|
2012-01-09 00:37:29 -08:00
|
|
|
*
|
2012-02-27 18:39:31 -08:00
|
|
|
* @note These content parts indicates the direction that the content will be
|
2012-01-09 00:37:29 -08:00
|
|
|
* displayed
|
|
|
|
*
|
|
|
|
* All directions may have contents at the same time, except for
|
|
|
|
* "smart". This is a special placement hint and its use case
|
2012-02-14 00:50:37 -08:00
|
|
|
* depends of the calculations coming from
|
2012-01-09 00:37:29 -08:00
|
|
|
* elm_hover_best_content_location_get(). Its use is for cases when
|
|
|
|
* one desires only one hover content, but with a dynamic special
|
|
|
|
* placement within the hover area. The content's geometry, whenever
|
|
|
|
* it changes, will be used to decide on a best location, not
|
|
|
|
* extrapolating the hover's parent object view to show it in (still
|
|
|
|
* being the hover's target determinant of its medium part -- move and
|
|
|
|
* resize it to simulate finger sizes, for example). If one of the
|
|
|
|
* directions other than "smart" are used, a previously content set
|
|
|
|
* using it will be deleted, and vice-versa.
|
|
|
|
*
|
2012-01-08 22:55:51 -08:00
|
|
|
* Supported elm_object common APIs.
|
2012-04-17 13:33:59 -07:00
|
|
|
* @li @ref elm_object_signal_emit
|
|
|
|
* @li @ref elm_object_signal_callback_add
|
|
|
|
* @li @ref elm_object_signal_callback_del
|
|
|
|
* @li @ref elm_object_part_content_set
|
|
|
|
* @li @ref elm_object_part_content_get
|
|
|
|
* @li @ref elm_object_part_content_unset
|
2012-01-08 22:55:51 -08:00
|
|
|
*
|
2011-12-29 23:20:48 -08:00
|
|
|
* See @ref tutorial_hover for more information.
|
|
|
|
*
|
|
|
|
* @{
|
|
|
|
*/
|
2012-04-09 17:12:33 -07:00
|
|
|
|
Elementary: header split for DateTime, DaySelector, DiskSelector, Entry,
Flip, Flip Selector, Frame, Gesture Layer, GLView, Hover, Icon,
Inwin, Label.
2013-04-28 00:23:15 -07:00
|
|
|
#ifdef EFL_EO_API_SUPPORT
|
|
|
|
#include "elm_hover_eo.h"
|
|
|
|
#endif
|
|
|
|
#ifndef EFL_NOLEGACY_API_SUPPORT
|
|
|
|
#include "elm_hover_legacy.h"
|
|
|
|
#endif
|
2011-12-29 23:20:48 -08:00
|
|
|
/**
|
|
|
|
* @}
|
|
|
|
*/
|