\hypertarget{group__Multibuttonentry}{}\doxysection{Multibuttonentry}
\label{group__Multibuttonentry}\index{Multibuttonentry@{Multibuttonentry}}
\doxysubsection*{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}
\doxysubsection*{Functions}
\begin{DoxyCompactItemize}
\item 
\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$ \mbox{\hyperlink{group__Multibuttonentry_gad3b3ee54808f6f39903dffe392e83f0f}{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}\item 
void \mbox{\hyperlink{group__Multibuttonentry_gad83913cdfff11f67bfb094e74adf6b36}{elm\+\_\+multibuttonentry\+\_\+format\+\_\+function\+\_\+set}} (Eo $\ast$obj, \mbox{\hyperlink{group__Multibuttonentry_ga94a20b76924bb4c0e679ec8266cc1ae2}{Elm\+\_\+\+Multibuttonentry\+\_\+\+Format\+\_\+\+Cb}} format\+\_\+function, const void $\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}


\doxysubsection{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 \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 \mbox{\hyperlink{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 \mbox{\hyperlink{group__Elm__Layout}{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 APIs. \begin{DoxyItemize}
\item \mbox{\hyperlink{group__Elm__General_gad1b5a0d41fa322b28000a290154ec3a4}{elm\+\_\+object\+\_\+item\+\_\+del}} \item \mbox{\hyperlink{group__Elm__General_ga990f25208c4ef0e5c9c404cfb482d813}{elm\+\_\+object\+\_\+item\+\_\+part\+\_\+text\+\_\+set}} \item \mbox{\hyperlink{group__Elm__General_ga453ec97f657bae0588fd4cd4e78ec918}{elm\+\_\+object\+\_\+item\+\_\+part\+\_\+text\+\_\+get}} \end{DoxyItemize}


\doxysubsection{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}}
\doxysubsubsection{\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 EINA\+\_\+\+TRUE} {\ttfamily EINA\+\_\+\+FALSE} 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}}
\doxysubsubsection{\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 \mbox{\hyperlink{group__Multibuttonentry_gad83913cdfff11f67bfb094e74adf6b36}{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}
\mbox{\hyperlink{group__Multibuttonentry_gad83913cdfff11f67bfb094e74adf6b36}{elm\+\_\+multibuttonentry\+\_\+format\+\_\+function\+\_\+set()}} 

elm\+\_\+multibuttonentry\+\_\+expanded\+\_\+set() 
\end{DoxySeeAlso}


\doxysubsection{Function Documentation}
\mbox{\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}}
\doxysubsubsection{\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 NULL if it cannot be created 
\end{DoxyReturn}


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

\mbox{\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}}
\doxysubsubsection{\texorpdfstring{elm\_multibuttonentry\_format\_function\_set()}{elm\_multibuttonentry\_format\_function\_set()}}
{\footnotesize\ttfamily void elm\+\_\+multibuttonentry\+\_\+format\+\_\+function\+\_\+set (\begin{DoxyParamCaption}\item[{Eo $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Multibuttonentry_ga94a20b76924bb4c0e679ec8266cc1ae2}{Elm\+\_\+\+Multibuttonentry\+\_\+\+Format\+\_\+\+Cb}}}]{format\+\_\+function,  }\item[{const void $\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 \$\char`\"{}... + \%d\char`\"{}.


\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}
