\section{Bubble}
\label{group__Bubble}\index{Bubble@{Bubble}}


The Bubble is a widget to show text similar to how speech is represented in comics.  


\subsection*{Macros}
\begin{DoxyCompactItemize}
\item 
\#define \hyperlink{group__Bubble_ga84503249ec4fc6750490d83faba45cfb}{elm\-\_\-obj\-\_\-bubble\-\_\-pos\-\_\-set}(pos)~E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-B\-U\-B\-B\-L\-E\-\_\-\-I\-D(E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-B\-U\-B\-B\-L\-E\-\_\-\-S\-U\-B\-\_\-\-I\-D\-\_\-\-P\-O\-S\-\_\-\-S\-E\-T), E\-O\-\_\-\-T\-Y\-P\-E\-C\-H\-E\-C\-K(Elm\-\_\-\-Bubble\-\_\-\-Pos, pos)
\item 
\#define \hyperlink{group__Bubble_ga7f80a9557ae30efd36aaca3f841c22e7}{elm\-\_\-obj\-\_\-bubble\-\_\-pos\-\_\-get}(ret)~E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-B\-U\-B\-B\-L\-E\-\_\-\-I\-D(E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-B\-U\-B\-B\-L\-E\-\_\-\-S\-U\-B\-\_\-\-I\-D\-\_\-\-P\-O\-S\-\_\-\-G\-E\-T), E\-O\-\_\-\-T\-Y\-P\-E\-C\-H\-E\-C\-K(Elm\-\_\-\-Bubble\-\_\-\-Pos $\ast$, ret)
\end{DoxyCompactItemize}
\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
Evas\-\_\-\-Object $\ast$ \hyperlink{group__Bubble_gab0726d45dae23200bf1613e2e8985f56}{elm\-\_\-bubble\-\_\-add} (Evas\-\_\-\-Object $\ast$parent)
\begin{DoxyCompactList}\small\item\em Add a new bubble to the parent. \end{DoxyCompactList}\item 
void \hyperlink{group__Bubble_ga93b983fd1136510a2b42e9df898223d5}{elm\-\_\-bubble\-\_\-pos\-\_\-set} (Evas\-\_\-\-Object $\ast$obj, Elm\-\_\-\-Bubble\-\_\-\-Pos pos)
\begin{DoxyCompactList}\small\item\em Set the corner of the bubble. \end{DoxyCompactList}\item 
Elm\-\_\-\-Bubble\-\_\-\-Pos \hyperlink{group__Bubble_ga880a507a2e417b8da61a09356857dfdb}{elm\-\_\-bubble\-\_\-pos\-\_\-get} (const Evas\-\_\-\-Object $\ast$obj)
\begin{DoxyCompactList}\small\item\em Get the corner of the bubble. \end{DoxyCompactList}\end{DoxyCompactItemize}


\subsection{Detailed Description}
The Bubble is a widget to show text similar to how speech is represented in comics.  
\begin{DoxyImageNoCaption}
  \mbox{\includegraphics{bubble_inheritance_tree}}
\end{DoxyImageNoCaption}


 
\begin{DoxyImageNoCaption}
  \mbox{\includegraphics{img/widget/bubble/preview-00}}
\end{DoxyImageNoCaption}
  
\begin{DoxyImageNoCaption}
  \mbox{\includegraphics{img/widget/bubble/preview-01}}
\end{DoxyImageNoCaption}
  
\begin{DoxyImageNoCaption}
  \mbox{\includegraphics{img/widget/bubble/preview-02}}
\end{DoxyImageNoCaption}


The bubble widget contains 5 important visual elements\-: \begin{DoxyItemize}
\item The frame is a rectangle with rounded edjes and an \char`\"{}arrow\char`\"{}. \item The {\ttfamily icon} is an image to which the frame's arrow points to. \item The {\ttfamily label} is a text which appears to the right of the icon if the corner is \char`\"{}top\-\_\-left\char`\"{} or \char`\"{}bottom\-\_\-left\char`\"{} and is right aligned to the frame otherwise. \item The {\ttfamily info} is a text which appears to the right of the label. Info's font is of a lighter color than label. \item The {\ttfamily content} is an evas object that is shown inside the frame.\end{DoxyItemize}
The position of the arrow, icon, label and info depends on which corner is selected. The four available corners are\-: \begin{DoxyItemize}
\item \char`\"{}top\-\_\-left\char`\"{} -\/ Default \item \char`\"{}top\-\_\-right\char`\"{} \item \char`\"{}bottom\-\_\-left\char`\"{} \item \char`\"{}bottom\-\_\-right\char`\"{}\end{DoxyItemize}
This widget inherits from the \hyperlink{group__Layout}{Layout} one, so that all the functions acting on it also work for bubble objects.

This widget emits the following signals, besides the ones sent from Layout\-: \begin{DoxyItemize}
\item {\ttfamily \char`\"{}clicked\char`\"{}} -\/ This is called when a user has clicked the bubble. \item {\ttfamily \char`\"{}focused\char`\"{}} -\/ When the bubble has received focus. (since 1.\-8) \item {\ttfamily \char`\"{}unfocused\char`\"{}} -\/ When the bubble has lost focus. (since 1.\-8)\end{DoxyItemize}
Default content parts of the bubble that you can use for are\-: \begin{DoxyItemize}
\item \char`\"{}default\char`\"{} -\/ A content of the bubble \item \char`\"{}icon\char`\"{} -\/ An icon of the bubble\end{DoxyItemize}
Default text parts of the button widget that you can use for are\-: \begin{DoxyItemize}
\item \char`\"{}default\char`\"{} -\/ Label of the bubble \item \char`\"{}info\char`\"{} -\/ info of the bubble\end{DoxyItemize}
Supported elm\-\_\-object common A\-P\-Is. \begin{DoxyItemize}
\item \hyperlink{group__General_ga9c088563c442670796564d2e5158f154}{elm\-\_\-object\-\_\-part\-\_\-text\-\_\-set} \item \hyperlink{group__General_ga965e34858eb4b80b7a4b5feda732bf27}{elm\-\_\-object\-\_\-part\-\_\-text\-\_\-get} \item \hyperlink{group__General_ga0531ec8867c72def7c780601764ca642}{elm\-\_\-object\-\_\-part\-\_\-content\-\_\-set} \item \hyperlink{group__General_ga32413f4d59d8232cd362a922a281abf1}{elm\-\_\-object\-\_\-part\-\_\-content\-\_\-get} \item \hyperlink{group__General_gadc5a1df25fe17e31739841133b53b5fc}{elm\-\_\-object\-\_\-part\-\_\-content\-\_\-unset}\end{DoxyItemize}
For an example of using a bubble see \hyperlink{bubble_01_example_page}{this}. 

\subsection{Macro Definition Documentation}
\index{Bubble@{Bubble}!elm\-\_\-obj\-\_\-bubble\-\_\-pos\-\_\-get@{elm\-\_\-obj\-\_\-bubble\-\_\-pos\-\_\-get}}
\index{elm\-\_\-obj\-\_\-bubble\-\_\-pos\-\_\-get@{elm\-\_\-obj\-\_\-bubble\-\_\-pos\-\_\-get}!Bubble@{Bubble}}
\subsubsection[{elm\-\_\-obj\-\_\-bubble\-\_\-pos\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-bubble\-\_\-pos\-\_\-get(
\begin{DoxyParamCaption}
\item[{}]{ret}
\end{DoxyParamCaption}
)~E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-B\-U\-B\-B\-L\-E\-\_\-\-I\-D(E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-B\-U\-B\-B\-L\-E\-\_\-\-S\-U\-B\-\_\-\-I\-D\-\_\-\-P\-O\-S\-\_\-\-G\-E\-T), E\-O\-\_\-\-T\-Y\-P\-E\-C\-H\-E\-C\-K(Elm\-\_\-\-Bubble\-\_\-\-Pos $\ast$, ret)}\label{group__Bubble_ga7f80a9557ae30efd36aaca3f841c22e7}
\begin{DoxySince}{Since}
1.\-8
\end{DoxySince}
Get the corner of the bubble


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt out}  & {\em ret} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Bubble_ga880a507a2e417b8da61a09356857dfdb}{elm\-\_\-bubble\-\_\-pos\-\_\-get} 
\end{DoxySeeAlso}


Referenced by elm\-\_\-bubble\-\_\-pos\-\_\-get().

\index{Bubble@{Bubble}!elm\-\_\-obj\-\_\-bubble\-\_\-pos\-\_\-set@{elm\-\_\-obj\-\_\-bubble\-\_\-pos\-\_\-set}}
\index{elm\-\_\-obj\-\_\-bubble\-\_\-pos\-\_\-set@{elm\-\_\-obj\-\_\-bubble\-\_\-pos\-\_\-set}!Bubble@{Bubble}}
\subsubsection[{elm\-\_\-obj\-\_\-bubble\-\_\-pos\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-bubble\-\_\-pos\-\_\-set(
\begin{DoxyParamCaption}
\item[{}]{pos}
\end{DoxyParamCaption}
)~E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-B\-U\-B\-B\-L\-E\-\_\-\-I\-D(E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-B\-U\-B\-B\-L\-E\-\_\-\-S\-U\-B\-\_\-\-I\-D\-\_\-\-P\-O\-S\-\_\-\-S\-E\-T), E\-O\-\_\-\-T\-Y\-P\-E\-C\-H\-E\-C\-K(Elm\-\_\-\-Bubble\-\_\-\-Pos, pos)}\label{group__Bubble_ga84503249ec4fc6750490d83faba45cfb}
\begin{DoxySince}{Since}
1.\-8
\end{DoxySince}
Set the corner of the bubble


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em pos} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Bubble_ga93b983fd1136510a2b42e9df898223d5}{elm\-\_\-bubble\-\_\-pos\-\_\-set} 
\end{DoxySeeAlso}


Referenced by elm\-\_\-bubble\-\_\-pos\-\_\-set().



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


Add a new bubble 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}
This function adds a text bubble to the given parent evas object. \index{Bubble@{Bubble}!elm\-\_\-bubble\-\_\-pos\-\_\-get@{elm\-\_\-bubble\-\_\-pos\-\_\-get}}
\index{elm\-\_\-bubble\-\_\-pos\-\_\-get@{elm\-\_\-bubble\-\_\-pos\-\_\-get}!Bubble@{Bubble}}
\subsubsection[{elm\-\_\-bubble\-\_\-pos\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}Elm\-\_\-\-Bubble\-\_\-\-Pos elm\-\_\-bubble\-\_\-pos\-\_\-get (
\begin{DoxyParamCaption}
\item[{const Evas\-\_\-\-Object $\ast$}]{obj}
\end{DoxyParamCaption}
)}\label{group__Bubble_ga880a507a2e417b8da61a09356857dfdb}


Get the corner of the bubble. 


\begin{DoxyParams}{Parameters}
{\em obj} & The bubble object. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The given corner for the bubble.
\end{DoxyReturn}
This function gets the selected corner of the bubble. 

References elm\-\_\-obj\-\_\-bubble\-\_\-pos\-\_\-get.

\index{Bubble@{Bubble}!elm\-\_\-bubble\-\_\-pos\-\_\-set@{elm\-\_\-bubble\-\_\-pos\-\_\-set}}
\index{elm\-\_\-bubble\-\_\-pos\-\_\-set@{elm\-\_\-bubble\-\_\-pos\-\_\-set}!Bubble@{Bubble}}
\subsubsection[{elm\-\_\-bubble\-\_\-pos\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}void elm\-\_\-bubble\-\_\-pos\-\_\-set (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{obj, }
\item[{Elm\-\_\-\-Bubble\-\_\-\-Pos}]{pos}
\end{DoxyParamCaption}
)}\label{group__Bubble_ga93b983fd1136510a2b42e9df898223d5}


Set the corner of the bubble. 


\begin{DoxyParams}{Parameters}
{\em obj} & The bubble object. \\
\hline
{\em pos} & The given corner for the bubble.\\
\hline
\end{DoxyParams}
This function sets the corner of the bubble. The corner will be used to determine where the arrow in the frame points to and where label, icon and info are shown. 

References elm\-\_\-obj\-\_\-bubble\-\_\-pos\-\_\-set.

