\section{Button}
\label{group__Button}\index{Button@{Button}}
\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
Evas\+\_\+\+Object $\ast$ \hyperlink{group__Button_ga0021b9d86d822367035843ed18bc6ea9}{elm\+\_\+button\+\_\+add} (Evas\+\_\+\+Object $\ast$parent)
\begin{DoxyCompactList}\small\item\em Add a new button to the parent\textquotesingle{}s canvas. \end{DoxyCompactList}\end{DoxyCompactItemize}


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


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


This is a push-\/button. Press it and run some function. It can contain a simple label and icon object and it also has an autorepeat feature.

This widget inherits from the \hyperlink{group__Layout}{Layout} one, so that all the functions acting on it also work for button objects.

This widget emits the following signals, besides the ones sent from Layout\+: \begin{DoxyItemize}
\item \char`\"{}clicked\char`\"{}\+: the user clicked the button (press/release). \item \char`\"{}repeated\char`\"{}\+: the user pressed the button without releasing it. \item \char`\"{}pressed\char`\"{}\+: button was pressed. \item \char`\"{}unpressed\char`\"{}\+: button was released after being pressed. \item {\ttfamily \char`\"{}focused\char`\"{}} \+: When the button has received focus. (since 1.\+8) \item {\ttfamily \char`\"{}unfocused\char`\"{}} \+: When the button has lost focus. (since 1.\+8) In all cases, the {\ttfamily event} parameter of the callback will be {\ttfamily N\+U\+LL}.\end{DoxyItemize}
Also, defined in the default theme, the button has the following styles available\+: \begin{DoxyItemize}
\item default\+: a normal button. \item anchor\+: Like default, but the button fades away when the mouse is not over it, leaving only the text or icon. \item hoversel\+\_\+vertical\+: Internally used by \hyperlink{group__Hoversel}{Hoversel} to give a continuous look across its options. \item hoversel\+\_\+vertical\+\_\+entry\+: Another internal for \hyperlink{group__Hoversel}{Hoversel}. \item naviframe\+: Internally used by \hyperlink{group__Naviframe}{Naviframe} for its back button. \item colorselector\+: Internally used by \hyperlink{group__Colorselector}{Colorselector} for its left and right buttons.\end{DoxyItemize}
Default content parts of the button widget that you can use for are\+: \begin{DoxyItemize}
\item \char`\"{}icon\char`\"{} -\/ An icon of the button\end{DoxyItemize}
Default text parts of the button widget that you can use for are\+: \begin{DoxyItemize}
\item \char`\"{}default\char`\"{} -\/ A label of the button\end{DoxyItemize}
Supported elm\+\_\+object common A\+P\+Is. \begin{DoxyItemize}
\item \hyperlink{group__General_ga9c088563c442670796564d2e5158f154}{elm\+\_\+object\+\_\+part\+\_\+text\+\_\+set} \item \hyperlink{group__General_ga965e34858eb4b80b7a4b5feda732bf27}{elm\+\_\+object\+\_\+part\+\_\+text\+\_\+get} \item \hyperlink{group__General_ga0531ec8867c72def7c780601764ca642}{elm\+\_\+object\+\_\+part\+\_\+content\+\_\+set} \item \hyperlink{group__General_ga32413f4d59d8232cd362a922a281abf1}{elm\+\_\+object\+\_\+part\+\_\+content\+\_\+get} \item \hyperlink{group__General_gadc5a1df25fe17e31739841133b53b5fc}{elm\+\_\+object\+\_\+part\+\_\+content\+\_\+unset} \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 some sample code using it\+: \begin{DoxyItemize}
\item \hyperlink{button_example_00}{Button -\/ Hello, Button!} \item \hyperlink{button_example_01}{Button -\/ Complete example} \end{DoxyItemize}


\subsection{Function Documentation}
\index{Button@{Button}!elm\+\_\+button\+\_\+add@{elm\+\_\+button\+\_\+add}}
\index{elm\+\_\+button\+\_\+add@{elm\+\_\+button\+\_\+add}!Button@{Button}}
\subsubsection[{\texorpdfstring{elm\+\_\+button\+\_\+add(\+Evas\+\_\+\+Object $\ast$parent)}{elm_button_add(Evas_Object *parent)}}]{\setlength{\rightskip}{0pt plus 5cm}Evas\+\_\+\+Object$\ast$ elm\+\_\+button\+\_\+add (
\begin{DoxyParamCaption}
\item[{Evas\+\_\+\+Object $\ast$}]{parent}
\end{DoxyParamCaption}
)}\label{group__Button_ga0021b9d86d822367035843ed18bc6ea9}


Add a new button to the parent\textquotesingle{}s canvas. 


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


References \+\_\+\+Elm\+\_\+\+Button\+\_\+\+Data\+::ar\+\_\+gap\+\_\+timeout, \+\_\+\+Elm\+\_\+\+Button\+\_\+\+Data\+::ar\+\_\+initial\+\_\+timeout, \+\_\+\+Elm\+\_\+\+Button\+\_\+\+Data\+::autorepeat, \+\_\+\+Elm\+\_\+\+Button\+\_\+\+Data\+::repeating, and \+\_\+\+Elm\+\_\+\+Button\+\_\+\+Data\+::timer.



Referenced by elm\+\_\+color\+\_\+class\+\_\+editor\+\_\+add(), elm\+\_\+fileselector\+\_\+folder\+\_\+only\+\_\+get(), elm\+\_\+hoversel\+\_\+add(), and elm\+\_\+quicklaunch\+\_\+seed().

