\doxysubsection{Multibuttonentry}
\hypertarget{group__Multibuttonentry}{}\label{group__Multibuttonentry}\index{Multibuttonentry@{Multibuttonentry}}
\doxysubsubsubsection*{Typedefs}
\begin{DoxyCompactItemize}
\item 
typedef \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}}(\texorpdfstring{$\ast$}{*} \mbox{\hyperlink{group__Multibuttonentry_gaea7457d0a06f93e456073314c19647f9}{Elm\+\_\+\+Multibuttonentry\+\_\+\+Item\+\_\+\+Filter\+\_\+\+Cb}}) (Evas\+\_\+\+Object \texorpdfstring{$\ast$}{*}obj, const char \texorpdfstring{$\ast$}{*}item\+\_\+label, void \texorpdfstring{$\ast$}{*}item\+\_\+data, void \texorpdfstring{$\ast$}{*}data)
\begin{DoxyCompactList}\small\item\em Callback to be invoked when an item is added to the multibuttonentry. \end{DoxyCompactList}\end{DoxyCompactItemize}
\doxysubsubsubsection*{Functions}
\begin{DoxyCompactItemize}
\item 
Evas\+\_\+\+Object \texorpdfstring{$\ast$}{*} \mbox{\hyperlink{group__Multibuttonentry_gad3b3ee54808f6f39903dffe392e83f0f}{elm\+\_\+multibuttonentry\+\_\+add}} (Evas\+\_\+\+Object \texorpdfstring{$\ast$}{*}parent)
\begin{DoxyCompactList}\small\item\em Add a new multibuttonentry to the parent. \end{DoxyCompactList}\item 
void \mbox{\hyperlink{group__Multibuttonentry_gad83913cdfff11f67bfb094e74adf6b36}{elm\+\_\+multibuttonentry\+\_\+format\+\_\+function\+\_\+set}} (Eo \texorpdfstring{$\ast$}{*}obj, Elm\+\_\+\+Multibuttonentry\+\_\+\+Format\+\_\+\+Cb format\+\_\+function, const void \texorpdfstring{$\ast$}{*}data)
\begin{DoxyCompactList}\small\item\em Set a function to format the string that will be used to display the hidden items counter. \end{DoxyCompactList}\end{DoxyCompactItemize}


\doxysubsubsection{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 a user enter text and each chunk of text managed as a set of buttons. Each text button is inserted by pressing the "{}return"{} 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 \doxylink{group__Elm__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 \doxylink{group__Elm__Layout}{Layout} \+:
\begin{DoxyItemize}
\item {\ttfamily "{}item,selected"{}} -\/ 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 "{}item,added"{}} -\/ when a new multi-\/button entry item is added.
\item {\ttfamily "{}item,deleted"{}} -\/ when a multi-\/button entry item is deleted.
\item {\ttfamily "{}item,clicked"{}} -\/ this is called when an item is clicked by user interaction. Both "{}item,selected"{} and "{}item,clicked"{} are needed.
\item {\ttfamily "{}item,longpressed"{}} -\/ when multi-\/button entry item is pressed for a long time.
\item {\ttfamily "{}clicked"{}} -\/ when multi-\/button entry is clicked.
\item {\ttfamily "{}focused"{}} -\/ when multi-\/button entry is focused.
\item {\ttfamily "{}unfocused"{}} -\/ when multi-\/button entry is unfocused.
\item {\ttfamily "{}expanded"{}} -\/ when multi-\/button entry is expanded.
\item {\ttfamily "{}contracted"{}} -\/ when multi-\/button entry is contracted.
\item {\ttfamily "{}expand,state,changed"{}} -\/ 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 "{}default"{} -\/ 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 "{}default"{} -\/ A label of the multi-\/button entry item\end{DoxyItemize}
Supported elm\+\_\+object\+\_\+item common APIs. \begin{DoxyItemize}
\item \doxylink{group__Elm__General_gad1b5a0d41fa322b28000a290154ec3a4}{elm\+\_\+object\+\_\+item\+\_\+del} \item \doxylink{group__Elm__General_ga990f25208c4ef0e5c9c404cfb482d813}{elm\+\_\+object\+\_\+item\+\_\+part\+\_\+text\+\_\+set} \item \doxylink{group__Elm__General_ga453ec97f657bae0588fd4cd4e78ec918}{elm\+\_\+object\+\_\+item\+\_\+part\+\_\+text\+\_\+get} \end{DoxyItemize}


\doxysubsubsection{Typedef Documentation}
\Hypertarget{group__Multibuttonentry_gaea7457d0a06f93e456073314c19647f9}\label{group__Multibuttonentry_gaea7457d0a06f93e456073314c19647f9} 
\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}}
\doxysubsubsubsection{\texorpdfstring{Elm\_Multibuttonentry\_Item\_Filter\_Cb}{Elm\_Multibuttonentry\_Item\_Filter\_Cb}}
{\footnotesize\ttfamily typedef \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}}(\texorpdfstring{$\ast$}{*} Elm\+\_\+\+Multibuttonentry\+\_\+\+Item\+\_\+\+Filter\+\_\+\+Cb) (Evas\+\_\+\+Object \texorpdfstring{$\ast$}{*}obj, const char \texorpdfstring{$\ast$}{*}item\+\_\+label, void \texorpdfstring{$\ast$}{*}item\+\_\+data, void \texorpdfstring{$\ast$}{*}data)}



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 EINA\+\_\+\+TRUE} {\ttfamily EINA\+\_\+\+FALSE} otherwise. 
\end{DoxyReturn}


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



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 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__Multibuttonentry_gad83913cdfff11f67bfb094e74adf6b36}\label{group__Multibuttonentry_gad83913cdfff11f67bfb094e74adf6b36} 
\index{Multibuttonentry@{Multibuttonentry}!elm\_multibuttonentry\_format\_function\_set@{elm\_multibuttonentry\_format\_function\_set}}
\index{elm\_multibuttonentry\_format\_function\_set@{elm\_multibuttonentry\_format\_function\_set}!Multibuttonentry@{Multibuttonentry}}
\doxysubsubsubsection{\texorpdfstring{elm\_multibuttonentry\_format\_function\_set()}{elm\_multibuttonentry\_format\_function\_set()}}
{\footnotesize\ttfamily void elm\+\_\+multibuttonentry\+\_\+format\+\_\+function\+\_\+set (\begin{DoxyParamCaption}\item[{Eo \texorpdfstring{$\ast$}{*}}]{obj,  }\item[{Elm\+\_\+\+Multibuttonentry\+\_\+\+Format\+\_\+\+Cb}]{format\+\_\+function,  }\item[{const void \texorpdfstring{$\ast$}{*}}]{data }\end{DoxyParamCaption})}



Set a function to format the string that will be used to display the hidden items counter. 

If {\ttfamily format\+\_\+function} is {\ttfamily NULL}, the default format will be used, which is \$"{}... + \%d"{}.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em format\+\_\+function} & Format\+\_\+function The actual format function \\
\hline
\mbox{\texttt{ in}}  & {\em data} & Data User data to passed to {\ttfamily format\+\_\+function} \\
\hline
\end{DoxyParams}
\begin{DoxySince}{Since}
1.\+9 
\end{DoxySince}
