2011-12-29 23:20:48 -08:00
|
|
|
/**
|
|
|
|
* @defgroup Clock Clock
|
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 clock_inheritance_tree.png
|
|
|
|
* @image latex clock_inheritance_tree.eps
|
|
|
|
*
|
2011-12-29 23:20:48 -08:00
|
|
|
* @image html img/widget/clock/preview-00.png
|
|
|
|
* @image latex img/widget/clock/preview-00.eps
|
|
|
|
*
|
|
|
|
* This is a @b digital clock widget. In its default theme, it has a
|
|
|
|
* vintage "flipping numbers clock" appearance, which will animate
|
2012-10-24 05:51:34 -07:00
|
|
|
* sheets of individual algorisms individually as time goes by.
|
2011-12-29 23:20:48 -08:00
|
|
|
*
|
|
|
|
* A newly created clock will fetch system's time (already
|
|
|
|
* considering local time adjustments) to start with, and will tick
|
2012-02-14 00:50:26 -08:00
|
|
|
* accordingly. It may or may not show seconds.
|
2011-12-29 23:20:48 -08:00
|
|
|
*
|
2012-03-04 21:31:49 -08:00
|
|
|
* Clocks have an @b edition mode. When in it, the sheets will
|
2011-12-29 23:20:48 -08:00
|
|
|
* display extra arrow indications on the top and bottom and the
|
|
|
|
* user may click on them to raise or lower the time values. After
|
|
|
|
* it's told to exit edition mode, it will keep ticking with that
|
|
|
|
* new time set (it keeps the difference from local time).
|
|
|
|
*
|
|
|
|
* Also, when under edition mode, user clicks on the cited arrows
|
|
|
|
* which are @b held for some time will make the clock to flip the
|
2012-02-14 00:50:26 -08:00
|
|
|
* sheet, thus editing the time, continuously and automatically for
|
2012-10-24 05:51:34 -07:00
|
|
|
* the user. The interval between sheet flips will keep reducing in
|
2011-12-29 23:20:48 -08:00
|
|
|
* time, so that it helps the user to reach a time which is distant
|
|
|
|
* from the one set.
|
|
|
|
*
|
|
|
|
* The time display is, by default, in military mode (24h), but an
|
|
|
|
* am/pm indicator may be optionally shown, too, when it will
|
|
|
|
* switch to 12h.
|
|
|
|
*
|
2012-05-03 15:42:09 -07:00
|
|
|
* This widget inherits from the @ref Layout one, so that all the
|
|
|
|
* functions acting on it also work for clock objects.
|
|
|
|
*
|
|
|
|
* This widget emits the following signals, besides the ones sent from
|
|
|
|
* @ref Layout:
|
|
|
|
* - @c "changed" - the clock's user changed the time
|
elm: fixed focused and unfocused documentation.
1. ctxpopup, fileselector_entry, naviframe, popup, bubble, button, calendar, check, clock, colorselector, datetime, diskselector, flipselector, gengrid.
2. since 1.8
2013-06-09 21:44:25 -07:00
|
|
|
* - @c "focused" - When the clock ehas received focus. (since 1.8)
|
|
|
|
* - @c "unfocused" - When the clock has lost focus. (since 1.8)
|
2014-01-23 03:07:20 -08:00
|
|
|
* - @c "language,changed" - the program's language changed (since 1.9)
|
2011-12-29 23:20:48 -08:00
|
|
|
*
|
2012-01-02 04:53:29 -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
|
2012-01-02 04:53:29 -08:00
|
|
|
*
|
2011-12-29 23:20:48 -08:00
|
|
|
* Here is an example on its usage:
|
|
|
|
* @li @ref clock_example
|
|
|
|
*/
|
2011-12-29 22:49:28 -08:00
|
|
|
|
2011-12-29 23:20:48 -08:00
|
|
|
/**
|
|
|
|
* @addtogroup Clock
|
|
|
|
* @{
|
|
|
|
*/
|
2011-12-29 22:49:28 -08:00
|
|
|
|
2013-04-27 23:54:26 -07:00
|
|
|
#ifdef EFL_EO_API_SUPPORT
|
|
|
|
#include "elm_clock_eo.h"
|
|
|
|
#endif
|
|
|
|
#ifndef EFL_NOLEGACY_API_SUPPORT
|
|
|
|
#include "elm_clock_legacy.h"
|
|
|
|
#endif
|
2011-12-29 23:20:48 -08:00
|
|
|
/**
|
|
|
|
* @}
|
|
|
|
*/
|