\hypertarget{group__Multibuttonentry}{}\section{Multibuttonentry}
\label{group__Multibuttonentry}\index{Multibuttonentry@{Multibuttonentry}}
\subsection*{Typedefs}
\begin{DoxyCompactItemize}
\item 
typedef \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}}($\ast$ \mbox{\hyperlink{group__Multibuttonentry_gaea7457d0a06f93e456073314c19647f9}{Elm\+\_\+\+Multibuttonentry\+\_\+\+Item\+\_\+\+Filter\+\_\+\+Cb}}) (\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{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$ \mbox{\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 
\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$ \mbox{\hyperlink{group__Multibuttonentry_gaddf4d0ecbe8ecfbd47a22d3258edc409}{elm\+\_\+multibuttonentry\+\_\+add}} (\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{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 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}
\mbox{\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}}
\subsubsection{\texorpdfstring{Elm\+\_\+\+Multibuttonentry\+\_\+\+Item\+\_\+\+Filter\+\_\+\+Cb}{Elm\_Multibuttonentry\_Item\_Filter\_Cb}}
{\footnotesize\ttfamily typedef \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}}($\ast$ Elm\+\_\+\+Multibuttonentry\+\_\+\+Item\+\_\+\+Filter\+\_\+\+Cb) (\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$obj, const char $\ast$item\+\_\+label, void $\ast$item\+\_\+data, void $\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 E\+I\+N\+A\+\_\+\+T\+R\+UE} {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} otherwise. 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Multibuttonentry_ga94a20b76924bb4c0e679ec8266cc1ae2}\label{group__Multibuttonentry_ga94a20b76924bb4c0e679ec8266cc1ae2}} 
\index{Multibuttonentry@{Multibuttonentry}!Elm\+\_\+\+Multibuttonentry\+\_\+\+Format\+\_\+\+Cb@{Elm\+\_\+\+Multibuttonentry\+\_\+\+Format\+\_\+\+Cb}}
\index{Elm\+\_\+\+Multibuttonentry\+\_\+\+Format\+\_\+\+Cb@{Elm\+\_\+\+Multibuttonentry\+\_\+\+Format\+\_\+\+Cb}!Multibuttonentry@{Multibuttonentry}}
\subsubsection{\texorpdfstring{Elm\+\_\+\+Multibuttonentry\+\_\+\+Format\+\_\+\+Cb}{Elm\_Multibuttonentry\_Format\_Cb}}
{\footnotesize\ttfamily Elm\+\_\+\+Multibuttonentry\+\_\+\+Format\+\_\+\+Cb}



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}


\subsection{Function Documentation}
\mbox{\Hypertarget{group__Multibuttonentry_gaddf4d0ecbe8ecfbd47a22d3258edc409}\label{group__Multibuttonentry_gaddf4d0ecbe8ecfbd47a22d3258edc409}} 
\index{Multibuttonentry@{Multibuttonentry}!elm\+\_\+multibuttonentry\+\_\+add@{elm\+\_\+multibuttonentry\+\_\+add}}
\index{elm\+\_\+multibuttonentry\+\_\+add@{elm\+\_\+multibuttonentry\+\_\+add}!Multibuttonentry@{Multibuttonentry}}
\subsubsection{\texorpdfstring{elm\+\_\+multibuttonentry\+\_\+add()}{elm\_multibuttonentry\_add()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}}$\ast$ elm\+\_\+multibuttonentry\+\_\+add (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\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 N\+U\+LL if it cannot be created 
\end{DoxyReturn}
