\section{Clock}
\label{group__Clock}\index{Clock@{Clock}}
\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
Evas\+\_\+\+Object $\ast$ \hyperlink{group__Clock_gaaa9f775111dedb6487a61f382aaab41b}{elm\+\_\+clock\+\_\+add} (Evas\+\_\+\+Object $\ast$parent)
\begin{DoxyCompactList}\small\item\em Add a new clock widget to the given parent Elementary (container) object. \end{DoxyCompactList}\end{DoxyCompactItemize}


\subsection{Detailed Description}
 
\begin{DoxyImageNoCaption}
  \mbox{\includegraphics[width=\textwidth,height=\textheight/2,keepaspectratio=true]{clock_inheritance_tree}}
\end{DoxyImageNoCaption}


 
\begin{DoxyImageNoCaption}
  \mbox{\includegraphics[width=\textwidth,height=\textheight/2,keepaspectratio=true]{img/widget/clock/preview-00}}
\end{DoxyImageNoCaption}


This is a {\bfseries digital} clock widget. In its default theme, it has a vintage \char`\"{}flipping numbers clock\char`\"{} appearance, which will animate sheets of individual algorisms individually as time goes by.

A newly created clock will fetch system\textquotesingle{}s time (already considering local time adjustments) to start with, and will tick accordingly. It may or may not show seconds.

Clocks have an {\bfseries edition} mode. When in it, the sheets will 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\textquotesingle{}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 {\bfseries held} for some time will make the clock to flip the sheet, thus editing the time, continuously and automatically for the user. The interval between sheet flips will keep reducing in 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.

This widget inherits from the \hyperlink{group__Layout}{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 Layout\+:
\begin{DoxyItemize}
\item {\ttfamily \char`\"{}changed\char`\"{}} -\/ the clock\textquotesingle{}s user changed the time
\item {\ttfamily \char`\"{}focused\char`\"{}} -\/ When the clock ehas received focus. (since 1.\+8)
\item {\ttfamily \char`\"{}unfocused\char`\"{}} -\/ When the clock has lost focus. (since 1.\+8)
\item {\ttfamily \char`\"{}language,changed\char`\"{}} -\/ the program\textquotesingle{}s language changed (since 1.\+9)
\end{DoxyItemize}

Supported elm\+\_\+object common A\+P\+Is. \begin{DoxyItemize}
\item \hyperlink{group__General_ga1beada7edf5d714c0dba5459bcc993fc}{elm\+\_\+object\+\_\+signal\+\_\+emit} \item \hyperlink{group__General_ga6f9574b798efcd454afdac6f2904f633}{elm\+\_\+object\+\_\+signal\+\_\+callback\+\_\+add} \item \hyperlink{group__General_ga3c76b5447be522d647e352cb7ff7c9e6}{elm\+\_\+object\+\_\+signal\+\_\+callback\+\_\+del}\end{DoxyItemize}
Here is an example on its usage\+: \begin{DoxyItemize}
\item \hyperlink{clock_example}{Clock widget example} \end{DoxyItemize}


\subsection{Function Documentation}
\index{Clock@{Clock}!elm\+\_\+clock\+\_\+add@{elm\+\_\+clock\+\_\+add}}
\index{elm\+\_\+clock\+\_\+add@{elm\+\_\+clock\+\_\+add}!Clock@{Clock}}
\subsubsection[{elm\+\_\+clock\+\_\+add(\+Evas\+\_\+\+Object $\ast$parent)}]{\setlength{\rightskip}{0pt plus 5cm}Evas\+\_\+\+Object$\ast$ elm\+\_\+clock\+\_\+add (
\begin{DoxyParamCaption}
\item[{Evas\+\_\+\+Object $\ast$}]{parent}
\end{DoxyParamCaption}
)}\label{group__Clock_gaaa9f775111dedb6487a61f382aaab41b}


Add a new clock widget to the given parent Elementary (container) object. 


\begin{DoxyParams}{Parameters}
{\em parent} & The parent object \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a new clock widget handle or {\ttfamily N\+U\+L\+L}, on errors
\end{DoxyReturn}
This function inserts a new clock widget on the canvas. 