\section{Combobox}
\label{group__Elm__Combobox}\index{Combobox@{Combobox}}
\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
Evas\+\_\+\+Object $\ast$ \hyperlink{group__Elm__Combobox_ga9cb8df0558391dd94cee62842812ca21}{elm\+\_\+combobox\+\_\+add} (Evas\+\_\+\+Object $\ast$parent)
\begin{DoxyCompactList}\small\item\em Add a new Combobox object. \end{DoxyCompactList}\item 
E\+O\+A\+PI Eina\+\_\+\+Bool \hyperlink{group__Elm__Combobox_gae83e94069d829745bd309eeb62ab4eee}{elm\+\_\+obj\+\_\+combobox\+\_\+expanded\+\_\+get} (void)
\begin{DoxyCompactList}\small\item\em Returns whether the combobox is expanded. \end{DoxyCompactList}\item 
E\+O\+A\+PI void \hyperlink{group__Elm__Combobox_ga085b33e36ca5066408fb3052113e0629}{elm\+\_\+obj\+\_\+combobox\+\_\+hover\+\_\+begin} (void)
\begin{DoxyCompactList}\small\item\em This triggers the combobox popup from code, the same as if the user had clicked the button. \end{DoxyCompactList}\item 
E\+O\+A\+PI void \hyperlink{group__Elm__Combobox_ga31ff7e8f836c9b93463063b6a6d65d9f}{elm\+\_\+obj\+\_\+combobox\+\_\+hover\+\_\+end} (void)
\begin{DoxyCompactList}\small\item\em This dismisses the combobox popup as if the user had clicked outside the hover. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Combobox_ga77c54522ff2768aa62b2490c4764001b}{elm\+\_\+combobox\+\_\+expanded\+\_\+get} (const Elm\+\_\+\+Combobox $\ast$obj)
\begin{DoxyCompactList}\small\item\em Returns whether the combobox is expanded. \end{DoxyCompactList}\item 
void \hyperlink{group__Elm__Combobox_gae3e4c7aac99c89b8c6867e7603bd434e}{elm\+\_\+combobox\+\_\+hover\+\_\+begin} (Elm\+\_\+\+Combobox $\ast$obj)
\begin{DoxyCompactList}\small\item\em This triggers the combobox popup from code, the same as if the user had clicked the button. \end{DoxyCompactList}\item 
void \hyperlink{group__Elm__Combobox_gabc4b0d043ea3caf64f9bb2d3d3071da6}{elm\+\_\+combobox\+\_\+hover\+\_\+end} (Elm\+\_\+\+Combobox $\ast$obj)
\begin{DoxyCompactList}\small\item\em This dismisses the combobox popup as if the user had clicked outside the hover. \end{DoxyCompactList}\end{DoxyCompactItemize}


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


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


A combobox is a button displaying an entry that pops up a list of items (automatically choosing the direction to display). It is a convenience widget to avoid the need to do all the piecing together yourself. It is intended for manipulating a large number of items in the combobox menu.

This widget inherits from the Button, Genlist and Entry one, so that all the functions acting on it also work for combobox objects.

This widget emits the following signals, besides the ones sent from Button\+:
\begin{DoxyItemize}
\item {\ttfamily \char`\"{}clicked\char`\"{}} -\/ the user clicked the combobox button and popped up the sel
\item {\ttfamily \char`\"{}selected\char`\"{}} -\/ an item in the combobox list is selected. event\+\_\+info is the selected item
\item {\ttfamily \char`\"{}dismissed\char`\"{}} -\/ the hover is dismissed
\item {\ttfamily \char`\"{}expanded\char`\"{}} -\/ This is called on clicking combobox and \hyperlink{group__Elm__Combobox_gae3e4c7aac99c89b8c6867e7603bd434e}{elm\+\_\+combobox\+\_\+hover\+\_\+begin()}.
\item {\ttfamily \char`\"{}language,changed\char`\"{}} -\/ the program\textquotesingle{}s language changed.
\item {\ttfamily \char`\"{}item,pressed\char`\"{}} -\/ When the combobox item is pressed.
\item {\ttfamily \char`\"{}filter,done\char`\"{}} -\/ When the combobox completes the filter process.
\end{DoxyItemize}

Default content parts of the combobox widget that you can use are the the same that you use with the Button

Default text parts of the combobox widget that you can use are the the same that you use with the Entry

Supported elm\+\_\+object common A\+P\+Is. \begin{DoxyItemize}
\item \hyperlink{group__Elm__General_ga6849a57df3316eabad5bec443bf87597}{elm\+\_\+object\+\_\+disabled\+\_\+set} \item \hyperlink{group__Elm__General_ga3ecb0d6b4e76ff39006f218942c7950d}{elm\+\_\+object\+\_\+disabled\+\_\+get} \item \hyperlink{group__Elm__General_ga9c088563c442670796564d2e5158f154}{elm\+\_\+object\+\_\+part\+\_\+text\+\_\+set} \item \hyperlink{group__Elm__General_ga965e34858eb4b80b7a4b5feda732bf27}{elm\+\_\+object\+\_\+part\+\_\+text\+\_\+get} \item \hyperlink{group__Elm__General_ga0531ec8867c72def7c780601764ca642}{elm\+\_\+object\+\_\+part\+\_\+content\+\_\+set} \item \hyperlink{group__Elm__General_gadc5a1df25fe17e31739841133b53b5fc}{elm\+\_\+object\+\_\+part\+\_\+content\+\_\+unset}\end{DoxyItemize}
Supported elm\+\_\+object\+\_\+item common A\+P\+Is. \begin{DoxyItemize}
\item elm\+\_\+object\+\_\+item\+\_\+del \item elm\+\_\+object\+\_\+item\+\_\+part\+\_\+text\+\_\+get \item elm\+\_\+object\+\_\+item\+\_\+signal\+\_\+emit -\/ this works only when the item is created. \item elm\+\_\+object\+\_\+item\+\_\+style\+\_\+set -\/ this works only when the item is created. \item elm\+\_\+object\+\_\+item\+\_\+style\+\_\+get -\/ this works only when the item is created.\end{DoxyItemize}
See \hyperlink{tutorial_combobox}{Combobox example} for an example. 

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


Add a new Combobox object. 


\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\+\_\+combobox\+\_\+hover\+\_\+begin(), elm\+\_\+entry\+\_\+cursor\+\_\+end\+\_\+set(), elm\+\_\+entry\+\_\+scrollable\+\_\+set(), elm\+\_\+entry\+\_\+single\+\_\+line\+\_\+set(), elm\+\_\+genlist\+\_\+filter\+\_\+set(), elm\+\_\+genlist\+\_\+first\+\_\+item\+\_\+get(), elm\+\_\+genlist\+\_\+homogeneous\+\_\+set(), elm\+\_\+genlist\+\_\+last\+\_\+item\+\_\+get(), elm\+\_\+genlist\+\_\+mode\+\_\+set(), elm\+\_\+hover\+\_\+dismiss(), elm\+\_\+hover\+\_\+target\+\_\+set(), elm\+\_\+layout\+\_\+data\+\_\+get(), elm\+\_\+layout\+\_\+signal\+\_\+callback\+\_\+add(), elm\+\_\+obj\+\_\+genlist\+\_\+filter\+\_\+set(), elm\+\_\+object\+\_\+focus\+\_\+set(), elm\+\_\+object\+\_\+parent\+\_\+widget\+\_\+get(), elm\+\_\+object\+\_\+part\+\_\+content\+\_\+set(), elm\+\_\+object\+\_\+part\+\_\+text\+\_\+get(), elm\+\_\+object\+\_\+part\+\_\+text\+\_\+set(), elm\+\_\+object\+\_\+style\+\_\+set(), E\+L\+M\+\_\+\+S\+C\+R\+O\+L\+L\+E\+R\+\_\+\+P\+O\+L\+I\+C\+Y\+\_\+\+O\+FF, elm\+\_\+scroller\+\_\+policy\+\_\+set(), elm\+\_\+table\+\_\+add(), and elm\+\_\+table\+\_\+pack().

\index{Combobox@{Combobox}!elm\+\_\+combobox\+\_\+expanded\+\_\+get@{elm\+\_\+combobox\+\_\+expanded\+\_\+get}}
\index{elm\+\_\+combobox\+\_\+expanded\+\_\+get@{elm\+\_\+combobox\+\_\+expanded\+\_\+get}!Combobox@{Combobox}}
\subsubsection[{\texorpdfstring{elm\+\_\+combobox\+\_\+expanded\+\_\+get(const Elm\+\_\+\+Combobox $\ast$obj)}{elm_combobox_expanded_get(const Elm_Combobox *obj)}}]{\setlength{\rightskip}{0pt plus 5cm}Eina\+\_\+\+Bool elm\+\_\+combobox\+\_\+expanded\+\_\+get (
\begin{DoxyParamCaption}
\item[{const Elm\+\_\+\+Combobox $\ast$}]{obj}
\end{DoxyParamCaption}
)}\label{group__Elm__Combobox_ga77c54522ff2768aa62b2490c4764001b}


Returns whether the combobox is expanded. 

This will return E\+I\+N\+A\+\_\+\+T\+R\+UE if the combobox is expanded or E\+I\+N\+A\+\_\+\+F\+A\+L\+SE if it is not expanded.

\begin{DoxySince}{Since}
1.\+17 
\end{DoxySince}


References elm\+\_\+obj\+\_\+combobox\+\_\+expanded\+\_\+get().

\index{Combobox@{Combobox}!elm\+\_\+combobox\+\_\+hover\+\_\+begin@{elm\+\_\+combobox\+\_\+hover\+\_\+begin}}
\index{elm\+\_\+combobox\+\_\+hover\+\_\+begin@{elm\+\_\+combobox\+\_\+hover\+\_\+begin}!Combobox@{Combobox}}
\subsubsection[{\texorpdfstring{elm\+\_\+combobox\+\_\+hover\+\_\+begin(\+Elm\+\_\+\+Combobox $\ast$obj)}{elm_combobox_hover_begin(Elm_Combobox *obj)}}]{\setlength{\rightskip}{0pt plus 5cm}void elm\+\_\+combobox\+\_\+hover\+\_\+begin (
\begin{DoxyParamCaption}
\item[{Elm\+\_\+\+Combobox $\ast$}]{obj}
\end{DoxyParamCaption}
)}\label{group__Elm__Combobox_gae3e4c7aac99c89b8c6867e7603bd434e}


This triggers the combobox popup from code, the same as if the user had clicked the button. 

\begin{DoxySince}{Since}
1.\+17 
\end{DoxySince}


References elm\+\_\+obj\+\_\+combobox\+\_\+hover\+\_\+begin().



Referenced by elm\+\_\+combobox\+\_\+add().

\index{Combobox@{Combobox}!elm\+\_\+combobox\+\_\+hover\+\_\+end@{elm\+\_\+combobox\+\_\+hover\+\_\+end}}
\index{elm\+\_\+combobox\+\_\+hover\+\_\+end@{elm\+\_\+combobox\+\_\+hover\+\_\+end}!Combobox@{Combobox}}
\subsubsection[{\texorpdfstring{elm\+\_\+combobox\+\_\+hover\+\_\+end(\+Elm\+\_\+\+Combobox $\ast$obj)}{elm_combobox_hover_end(Elm_Combobox *obj)}}]{\setlength{\rightskip}{0pt plus 5cm}void elm\+\_\+combobox\+\_\+hover\+\_\+end (
\begin{DoxyParamCaption}
\item[{Elm\+\_\+\+Combobox $\ast$}]{obj}
\end{DoxyParamCaption}
)}\label{group__Elm__Combobox_gabc4b0d043ea3caf64f9bb2d3d3071da6}


This dismisses the combobox popup as if the user had clicked outside the hover. 

\begin{DoxySince}{Since}
1.\+17 
\end{DoxySince}


References elm\+\_\+obj\+\_\+combobox\+\_\+hover\+\_\+end().

\index{Combobox@{Combobox}!elm\+\_\+obj\+\_\+combobox\+\_\+expanded\+\_\+get@{elm\+\_\+obj\+\_\+combobox\+\_\+expanded\+\_\+get}}
\index{elm\+\_\+obj\+\_\+combobox\+\_\+expanded\+\_\+get@{elm\+\_\+obj\+\_\+combobox\+\_\+expanded\+\_\+get}!Combobox@{Combobox}}
\subsubsection[{\texorpdfstring{elm\+\_\+obj\+\_\+combobox\+\_\+expanded\+\_\+get(void)}{elm_obj_combobox_expanded_get(void)}}]{\setlength{\rightskip}{0pt plus 5cm}E\+O\+A\+PI Eina\+\_\+\+Bool elm\+\_\+obj\+\_\+combobox\+\_\+expanded\+\_\+get (
\begin{DoxyParamCaption}
\item[{void}]{}
\end{DoxyParamCaption}
)}\label{group__Elm__Combobox_gae83e94069d829745bd309eeb62ab4eee}


Returns whether the combobox is expanded. 

This will return E\+I\+N\+A\+\_\+\+T\+R\+UE if the combobox is expanded or E\+I\+N\+A\+\_\+\+F\+A\+L\+SE if it is not expanded.

\begin{DoxySince}{Since}
1.\+17 
\end{DoxySince}


Referenced by elm\+\_\+combobox\+\_\+expanded\+\_\+get().

\index{Combobox@{Combobox}!elm\+\_\+obj\+\_\+combobox\+\_\+hover\+\_\+begin@{elm\+\_\+obj\+\_\+combobox\+\_\+hover\+\_\+begin}}
\index{elm\+\_\+obj\+\_\+combobox\+\_\+hover\+\_\+begin@{elm\+\_\+obj\+\_\+combobox\+\_\+hover\+\_\+begin}!Combobox@{Combobox}}
\subsubsection[{\texorpdfstring{elm\+\_\+obj\+\_\+combobox\+\_\+hover\+\_\+begin(void)}{elm_obj_combobox_hover_begin(void)}}]{\setlength{\rightskip}{0pt plus 5cm}E\+O\+A\+PI void elm\+\_\+obj\+\_\+combobox\+\_\+hover\+\_\+begin (
\begin{DoxyParamCaption}
\item[{void}]{}
\end{DoxyParamCaption}
)}\label{group__Elm__Combobox_ga085b33e36ca5066408fb3052113e0629}


This triggers the combobox popup from code, the same as if the user had clicked the button. 

\begin{DoxySince}{Since}
1.\+17 
\end{DoxySince}


Referenced by elm\+\_\+combobox\+\_\+hover\+\_\+begin().

\index{Combobox@{Combobox}!elm\+\_\+obj\+\_\+combobox\+\_\+hover\+\_\+end@{elm\+\_\+obj\+\_\+combobox\+\_\+hover\+\_\+end}}
\index{elm\+\_\+obj\+\_\+combobox\+\_\+hover\+\_\+end@{elm\+\_\+obj\+\_\+combobox\+\_\+hover\+\_\+end}!Combobox@{Combobox}}
\subsubsection[{\texorpdfstring{elm\+\_\+obj\+\_\+combobox\+\_\+hover\+\_\+end(void)}{elm_obj_combobox_hover_end(void)}}]{\setlength{\rightskip}{0pt plus 5cm}E\+O\+A\+PI void elm\+\_\+obj\+\_\+combobox\+\_\+hover\+\_\+end (
\begin{DoxyParamCaption}
\item[{void}]{}
\end{DoxyParamCaption}
)}\label{group__Elm__Combobox_ga31ff7e8f836c9b93463063b6a6d65d9f}


This dismisses the combobox popup as if the user had clicked outside the hover. 

\begin{DoxySince}{Since}
1.\+17 
\end{DoxySince}


Referenced by elm\+\_\+combobox\+\_\+hover\+\_\+end().

