\doxysubsection{Check}
\hypertarget{group__Elm__Check}{}\label{group__Elm__Check}\index{Check@{Check}}


The check widget allows for toggling a value between true and false.  


\doxysubsubsubsection*{Functions}
\begin{DoxyCompactItemize}
\item 
Evas\+\_\+\+Object \texorpdfstring{$\ast$}{*} \mbox{\hyperlink{group__Elm__Check_ga467a6a6215c116a18664aa40fc95f4e3}{elm\+\_\+check\+\_\+add}} (Evas\+\_\+\+Object \texorpdfstring{$\ast$}{*}parent)
\begin{DoxyCompactList}\small\item\em Add a new Check object. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} \mbox{\hyperlink{group__Elm__Check_ga011ed8bd33b24ab9be27d7f162b80846}{elm\+\_\+check\+\_\+state\+\_\+get}} (const Evas\+\_\+\+Object \texorpdfstring{$\ast$}{*}obj)
\begin{DoxyCompactList}\small\item\em Get the state of the check object. \end{DoxyCompactList}\item 
void \mbox{\hyperlink{group__Elm__Check_gaa011e6d86f82142698760cf0cc4fd0a4}{elm\+\_\+check\+\_\+state\+\_\+set}} (Evas\+\_\+\+Object \texorpdfstring{$\ast$}{*}obj, \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} state)
\begin{DoxyCompactList}\small\item\em Set the on/off state of the check object. \end{DoxyCompactList}\item 
void \mbox{\hyperlink{group__Elm__Check_gaca05f511b004338c4d7fb35c8ec0d826}{elm\+\_\+check\+\_\+state\+\_\+pointer\+\_\+set}} (Evas\+\_\+\+Object \texorpdfstring{$\ast$}{*}obj, \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} \texorpdfstring{$\ast$}{*}statep)
\begin{DoxyCompactList}\small\item\em Set a convenience pointer to a boolean to change. \end{DoxyCompactList}\end{DoxyCompactItemize}


\doxysubsubsection{Detailed Description}
The check widget allows for toggling a value between true and false. 

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


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


Check objects are a lot like radio objects in layout and functionality, except they do not work as a group, but independently, and only toggle the value of a boolean between false and true. \doxylink{group__Elm__Check_gaa011e6d86f82142698760cf0cc4fd0a4}{elm\+\_\+check\+\_\+state\+\_\+set()} sets the boolean state and \doxylink{group__Elm__Check_ga011ed8bd33b24ab9be27d7f162b80846}{elm\+\_\+check\+\_\+state\+\_\+get()} returns the current state. For convenience, like the radio objects, you can set a pointer to a boolean directly with \doxylink{group__Elm__Check_gaca05f511b004338c4d7fb35c8ec0d826}{elm\+\_\+check\+\_\+state\+\_\+pointer\+\_\+set()} for it to modify.

This widget inherits from the \doxylink{group__Elm__Layout}{Layout} one, so that all the functions acting on it also work for check objects.

This widget emits the following signals, besides the ones sent from \doxylink{group__Elm__Layout}{Layout} \+:
\begin{DoxyItemize}
\item {\ttfamily "{}changed"{}} -\/ This is called whenever the user changes the state of the check objects ({\ttfamily event\+\_\+info} is always {\ttfamily NULL}).
\item {\ttfamily "{}focused"{}} -\/ When the check has received focus. (since 1.\+8)
\item {\ttfamily "{}unfocused"{}} -\/ When the check has lost focus. (since 1.\+8)
\item {\ttfamily "{}language,changed"{}} -\/ the program\textquotesingle{}s language changed (since 1.\+9)
\end{DoxyItemize}

Default content parts of the check widget that you can use for are\+: \begin{DoxyItemize}
\item "{}icon"{} -\/ An icon of the check\end{DoxyItemize}
Default text parts of the check widget that you can use for are\+: \begin{DoxyItemize}
\item "{}default"{} -\/ A label of the check \item "{}on"{} -\/ On state label of the check (only valid for "{}toggle"{} style.) \item "{}off"{} -\/ Off state label of the check (only valid for "{}toggle"{} style.)\end{DoxyItemize}
Supported elm\+\_\+object common APIs. \begin{DoxyItemize}
\item \doxylink{group__Elm__General_ga6849a57df3316eabad5bec443bf87597}{elm\+\_\+object\+\_\+disabled\+\_\+set} \item \doxylink{group__Elm__General_ga3ecb0d6b4e76ff39006f218942c7950d}{elm\+\_\+object\+\_\+disabled\+\_\+get} \item \doxylink{group__Elm__General_ga9c088563c442670796564d2e5158f154}{elm\+\_\+object\+\_\+part\+\_\+text\+\_\+set} \item \doxylink{group__Elm__General_ga6f5eac98644d176723b809c2c9d8db80}{elm\+\_\+object\+\_\+part\+\_\+text\+\_\+get} \item \doxylink{group__Elm__General_ga0531ec8867c72def7c780601764ca642}{elm\+\_\+object\+\_\+part\+\_\+content\+\_\+set} \item \doxylink{group__Elm__General_ga86b0088bbf018964a980f56e02ee2248}{elm\+\_\+object\+\_\+part\+\_\+content\+\_\+get} \item \doxylink{group__Elm__General_ga73862b640f3f362a130c2824ef570046}{elm\+\_\+object\+\_\+part\+\_\+content\+\_\+unset} \item \doxylink{group__Elm__General_ga1beada7edf5d714c0dba5459bcc993fc}{elm\+\_\+object\+\_\+signal\+\_\+emit} \item \doxylink{group__Elm__General_ga6f9574b798efcd454afdac6f2904f633}{elm\+\_\+object\+\_\+signal\+\_\+callback\+\_\+add} \item \doxylink{group__Elm__General_ga53603e56456542237d777bdc8ec59440}{elm\+\_\+object\+\_\+signal\+\_\+callback\+\_\+del}\end{DoxyItemize}
\doxysectlink{tutorial_check}{Check example}{0} should give you a firm grasp of how to use this widget. 

\doxysubsubsection{Function Documentation}
\Hypertarget{group__Elm__Check_ga467a6a6215c116a18664aa40fc95f4e3}\label{group__Elm__Check_ga467a6a6215c116a18664aa40fc95f4e3} 
\index{Check@{Check}!elm\_check\_add@{elm\_check\_add}}
\index{elm\_check\_add@{elm\_check\_add}!Check@{Check}}
\doxysubsubsubsection{\texorpdfstring{elm\_check\_add()}{elm\_check\_add()}}
{\footnotesize\ttfamily Evas\+\_\+\+Object \texorpdfstring{$\ast$}{*} elm\+\_\+check\+\_\+add (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Object \texorpdfstring{$\ast$}{*}}]{parent }\end{DoxyParamCaption})}



Add a new Check object. 


\begin{DoxyParams}{Parameters}
{\em parent} & The parent object \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The new object or NULL if it cannot be created 
\end{DoxyReturn}


References \mbox{\hyperlink{group__Eina__Safety__Checks__Group_gab2b07061fc6500dedd9cd41c8d16f95d}{EINA\+\_\+\+SAFETY\+\_\+\+ON\+\_\+\+NULL\+\_\+\+RETURN\+\_\+\+VAL}}.

\Hypertarget{group__Elm__Check_ga011ed8bd33b24ab9be27d7f162b80846}\label{group__Elm__Check_ga011ed8bd33b24ab9be27d7f162b80846} 
\index{Check@{Check}!elm\_check\_state\_get@{elm\_check\_state\_get}}
\index{elm\_check\_state\_get@{elm\_check\_state\_get}!Check@{Check}}
\doxysubsubsubsection{\texorpdfstring{elm\_check\_state\_get()}{elm\_check\_state\_get()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} elm\+\_\+check\+\_\+state\+\_\+get (\begin{DoxyParamCaption}\item[{const Evas\+\_\+\+Object \texorpdfstring{$\ast$}{*}}]{obj }\end{DoxyParamCaption})}



Get the state of the check object. 


\begin{DoxyParams}{Parameters}
{\em obj} & The check object \\
\hline
\end{DoxyParams}
\Hypertarget{group__Elm__Check_gaa011e6d86f82142698760cf0cc4fd0a4}\label{group__Elm__Check_gaa011e6d86f82142698760cf0cc4fd0a4} 
\index{Check@{Check}!elm\_check\_state\_set@{elm\_check\_state\_set}}
\index{elm\_check\_state\_set@{elm\_check\_state\_set}!Check@{Check}}
\doxysubsubsubsection{\texorpdfstring{elm\_check\_state\_set()}{elm\_check\_state\_set()}}
{\footnotesize\ttfamily void elm\+\_\+check\+\_\+state\+\_\+set (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Object \texorpdfstring{$\ast$}{*}}]{obj,  }\item[{\mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}}}]{state }\end{DoxyParamCaption})}



Set the on/off state of the check object. 

This sets the state of the check. If set with .state\+\_\+pointer.\+set, the state of that variable is also changed. Calling this doesn\textquotesingle{}t cause the "{}changed"{} signal to be emitted.


\begin{DoxyParams}{Parameters}
{\em obj} & The check object \\
\hline
{\em state} & The state to use (1 == on, 0 == off) \\
\hline
\end{DoxyParams}
\Hypertarget{group__Elm__Check_gaca05f511b004338c4d7fb35c8ec0d826}\label{group__Elm__Check_gaca05f511b004338c4d7fb35c8ec0d826} 
\index{Check@{Check}!elm\_check\_state\_pointer\_set@{elm\_check\_state\_pointer\_set}}
\index{elm\_check\_state\_pointer\_set@{elm\_check\_state\_pointer\_set}!Check@{Check}}
\doxysubsubsubsection{\texorpdfstring{elm\_check\_state\_pointer\_set()}{elm\_check\_state\_pointer\_set()}}
{\footnotesize\ttfamily void elm\+\_\+check\+\_\+state\+\_\+pointer\+\_\+set (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Object \texorpdfstring{$\ast$}{*}}]{obj,  }\item[{\mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} \texorpdfstring{$\ast$}{*}}]{statep }\end{DoxyParamCaption})}



Set a convenience pointer to a boolean to change. 

This sets a pointer to a boolean, that, in addition to the check objects state will also be modified directly. To stop setting the object pointed to simply use null as the "{}statep"{} parameter. If "{}statep"{} is not null, then when this is called, the check objects state will also be modified to reflect the value of the boolean "{}statep"{} points to, just like calling .state.\+set.


\begin{DoxyParams}{Parameters}
{\em obj} & The check object \\
\hline
{\em statep} & pointer to the boolean to modify \\
\hline
\end{DoxyParams}
