\section{Multibuttonentry}
\label{group__Multibuttonentry}\index{Multibuttonentry@{Multibuttonentry}}
\subsection*{Typedefs}
\begin{DoxyCompactItemize}
\item 
typedef Eina\+\_\+\+Bool($\ast$ \hyperlink{group__Multibuttonentry_gaea7457d0a06f93e456073314c19647f9}{Elm\+\_\+\+Multibuttonentry\+\_\+\+Item\+\_\+\+Filter\+\_\+\+Cb}) (Evas\+\_\+\+Object $\ast$obj, const char $\ast$item\+\_\+label, void $\ast$item\+\_\+data, void $\ast$data)
\begin{DoxyCompactList}\small\item\em Callback to be invoked when an item is added to the multibuttonentry. \end{DoxyCompactList}\item 
typedef char $\ast$($\ast$ \hyperlink{group__Multibuttonentry_ga94a20b76924bb4c0e679ec8266cc1ae2}{Elm\+\_\+\+Multibuttonentry\+\_\+\+Format\+\_\+\+Cb}) (int count, void $\ast$data)
\begin{DoxyCompactList}\small\item\em This callback type is used to format the string that will be used to display the hidden items counter, when not in expanded mode. \end{DoxyCompactList}\end{DoxyCompactItemize}
\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
Evas\+\_\+\+Object $\ast$ \hyperlink{group__Multibuttonentry_gaddf4d0ecbe8ecfbd47a22d3258edc409}{elm\+\_\+multibuttonentry\+\_\+add} (Evas\+\_\+\+Object $\ast$parent)
\begin{DoxyCompactList}\small\item\em Add a new multibuttonentry to the parent. \end{DoxyCompactList}\end{DoxyCompactItemize}


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


A multi-\/button entry is a widget letting an user enter text and each chunk of text managed as a set of buttons. Each text button is inserted by pressing the \char`\"{}return\char`\"{} key. If there is no space in the current row, a new button is added to the next row. When a text button is pressed, it will become focused. Backspace removes the focus. When the multi-\/button entry loses focus, items longer than one line are shrunk to one line.

The typical use case of multi-\/button entry is composing emails/messages to a group of addresses, each of which is an item that can be clicked for further actions.

This widget inherits from the \hyperlink{group__Layout}{Layout} one, so that all the functions acting on it also work for multi-\/button entry objects (since 1.\+8).

This widget emits the following signals, besides the ones sent from Layout\+:
\begin{DoxyItemize}
\item {\ttfamily \char`\"{}item,selected\char`\"{}} -\/ this is called when an item is selected by api, user interaction, and etc. this is also called when a user press back space while cursor is on the first field of entry.
\item {\ttfamily \char`\"{}item,added\char`\"{}} -\/ when a new multi-\/button entry item is added.
\item {\ttfamily \char`\"{}item,deleted\char`\"{}} -\/ when a multi-\/button entry item is deleted.
\item {\ttfamily \char`\"{}item,clicked\char`\"{}} -\/ this is called when an item is clicked by user interaction. Both \char`\"{}item,selected\char`\"{} and \char`\"{}item,clicked\char`\"{} are needed.
\item {\ttfamily \char`\"{}item,longpressed\char`\"{}} -\/ when multi-\/button entry item is pressed for a long time.
\item {\ttfamily \char`\"{}clicked\char`\"{}} -\/ when multi-\/button entry is clicked.
\item {\ttfamily \char`\"{}focused\char`\"{}} -\/ when multi-\/button entry is focused.
\item {\ttfamily \char`\"{}unfocused\char`\"{}} -\/ when multi-\/button entry is unfocused.
\item {\ttfamily \char`\"{}expanded\char`\"{}} -\/ when multi-\/button entry is expanded.
\item {\ttfamily \char`\"{}contracted\char`\"{}} -\/ when multi-\/button entry is contracted.
\item {\ttfamily \char`\"{}expand,state,changed\char`\"{}} -\/ when shrink mode state of multi-\/button entry is changed.
\end{DoxyItemize}

Default text parts of the multi-\/button entry widget that you can use are\+: \begin{DoxyItemize}
\item \char`\"{}default\char`\"{} -\/ A label of the multi-\/button entry\end{DoxyItemize}
Default text parts of multi-\/button entry {\bfseries items} that you can use are\+: \begin{DoxyItemize}
\item \char`\"{}default\char`\"{} -\/ A label of the multi-\/button entry item\end{DoxyItemize}
Supported elm\+\_\+object\+\_\+item common A\+P\+Is. \begin{DoxyItemize}
\item elm\+\_\+object\+\_\+item\+\_\+del \item elm\+\_\+object\+\_\+item\+\_\+part\+\_\+text\+\_\+set \item elm\+\_\+object\+\_\+item\+\_\+part\+\_\+text\+\_\+get \end{DoxyItemize}


\subsection{Typedef Documentation}
\index{Multibuttonentry@{Multibuttonentry}!Elm\+\_\+\+Multibuttonentry\+\_\+\+Format\+\_\+\+Cb@{Elm\+\_\+\+Multibuttonentry\+\_\+\+Format\+\_\+\+Cb}}
\index{Elm\+\_\+\+Multibuttonentry\+\_\+\+Format\+\_\+\+Cb@{Elm\+\_\+\+Multibuttonentry\+\_\+\+Format\+\_\+\+Cb}!Multibuttonentry@{Multibuttonentry}}
\subsubsection[{Elm\+\_\+\+Multibuttonentry\+\_\+\+Format\+\_\+\+Cb}]{\setlength{\rightskip}{0pt plus 5cm}Elm\+\_\+\+Multibuttonentry\+\_\+\+Format\+\_\+\+Cb}\label{group__Multibuttonentry_ga94a20b76924bb4c0e679ec8266cc1ae2}


This callback type is used to format the string that will be used to display the hidden items counter, when not in expanded mode. 


\begin{DoxyParams}{Parameters}
{\em count} & Number of hidden items \\
\hline
{\em data} & The (context) data passed in to elm\+\_\+multibuttonentry\+\_\+format\+\_\+function\+\_\+set() \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
String representing the counter that will be set to multibuttonentry\textquotesingle{}s counter item\textquotesingle{}s text.
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
elm\+\_\+multibuttonentry\+\_\+format\+\_\+function\+\_\+set() 

elm\+\_\+multibuttonentry\+\_\+expanded\+\_\+set() 
\end{DoxySeeAlso}
\index{Multibuttonentry@{Multibuttonentry}!Elm\+\_\+\+Multibuttonentry\+\_\+\+Item\+\_\+\+Filter\+\_\+\+Cb@{Elm\+\_\+\+Multibuttonentry\+\_\+\+Item\+\_\+\+Filter\+\_\+\+Cb}}
\index{Elm\+\_\+\+Multibuttonentry\+\_\+\+Item\+\_\+\+Filter\+\_\+\+Cb@{Elm\+\_\+\+Multibuttonentry\+\_\+\+Item\+\_\+\+Filter\+\_\+\+Cb}!Multibuttonentry@{Multibuttonentry}}
\subsubsection[{Elm\+\_\+\+Multibuttonentry\+\_\+\+Item\+\_\+\+Filter\+\_\+\+Cb}]{\setlength{\rightskip}{0pt plus 5cm}typedef Eina\+\_\+\+Bool($\ast$ Elm\+\_\+\+Multibuttonentry\+\_\+\+Item\+\_\+\+Filter\+\_\+\+Cb) (Evas\+\_\+\+Object $\ast$obj, const char $\ast$item\+\_\+label, void $\ast$item\+\_\+data, void $\ast$data)}\label{group__Multibuttonentry_gaea7457d0a06f93e456073314c19647f9}


Callback to be invoked when an item is added to the multibuttonentry. 


\begin{DoxyParams}{Parameters}
{\em obj} & The parent object \\
\hline
{\em item\+\_\+label} & The label corresponding to the added item. \\
\hline
{\em item\+\_\+data} & data specific to this item. \\
\hline
{\em data} & data specific to the multibuttonentry.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+U\+E} {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E} otherwise. 
\end{DoxyReturn}


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


Add a new multibuttonentry to the parent. 


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