\section{Hover}
\label{group__Hover}\index{Hover@{Hover}}
\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
Evas\+\_\+\+Object $\ast$ \hyperlink{group__Hover_ga89c2eecb8d6e8ff12f70c2f3c74212f3}{elm\+\_\+hover\+\_\+add} (Evas\+\_\+\+Object $\ast$parent)
\begin{DoxyCompactList}\small\item\em Adds a hover object to {\ttfamily parent}. \end{DoxyCompactList}\item 
void \hyperlink{group__Hover_ga816c57f831e81de55492c0bddc3e59a9}{elm\+\_\+hover\+\_\+parent\+\_\+set} (Evas\+\_\+\+Object $\ast$obj, Evas\+\_\+\+Object $\ast$parent)
\begin{DoxyCompactList}\small\item\em Sets the parent object for the hover. \end{DoxyCompactList}\item 
Evas\+\_\+\+Object $\ast$ \hyperlink{group__Hover_gadd5c8502168fccd0994a33c6cee6c45b}{elm\+\_\+hover\+\_\+parent\+\_\+get} (const Evas\+\_\+\+Object $\ast$obj)
\begin{DoxyCompactList}\small\item\em Get the parent object for the hover. \end{DoxyCompactList}\end{DoxyCompactItemize}


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


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


A Hover object will hover over its {\ttfamily parent} object at the {\ttfamily target} location. Anything in the background will be given a darker coloring to indicate that the hover object is on top (at the default theme). When the hover is clicked it is dismissed(hidden), if the contents of the hover are clicked that {\bfseries doesn\textquotesingle{}t} cause the hover to be dismissed.

A Hover object has two parents. One parent that owns it during creation and the other parent being the one over which the hover object spans.

\begin{DoxyNote}{Note}
The hover object will take up the entire space of {\ttfamily target} object.
\end{DoxyNote}
Elementary has the following styles for the hover widget\+: \begin{DoxyItemize}
\item default \item popout \item menu \item hoversel\+\_\+vertical\end{DoxyItemize}
This widget inherits from the \hyperlink{group__Layout}{Layout} one, so that all the functions acting on it also work for hover objects.

This widget emits the following signals, besides the ones sent from Layout\+: \begin{DoxyItemize}
\item {\ttfamily \char`\"{}clicked\char`\"{}} -\/ the user clicked the empty space in the hover to dismiss \item {\ttfamily \char`\"{}dismissed\char`\"{}} -\/ the user clicked the empty space in the hover to dismiss (since 1.\+8) \item {\ttfamily \char`\"{}smart,changed\char`\"{}} -\/ a content object placed under the \char`\"{}smart\char`\"{} policy was replaced to a new slot direction. \item {\ttfamily \char`\"{}focused\char`\"{}} -\/ When the hover has received focus. (since 1.\+8) \item {\ttfamily \char`\"{}unfocused\char`\"{}} -\/ When the hover has lost focus. (since 1.\+8)\end{DoxyItemize}
Default content parts of the hover widget that you can use for are\+: \begin{DoxyItemize}
\item {\ttfamily \char`\"{}left\char`\"{}} \item {\ttfamily \char`\"{}top-\/left\char`\"{}} \item {\ttfamily \char`\"{}top\char`\"{}} \item {\ttfamily \char`\"{}top-\/right\char`\"{}} \item {\ttfamily \char`\"{}right\char`\"{}} \item {\ttfamily \char`\"{}bottom-\/right\char`\"{}} \item {\ttfamily \char`\"{}bottom\char`\"{}} \item {\ttfamily \char`\"{}bottom-\/left\char`\"{}} \item {\ttfamily \char`\"{}middle\char`\"{}} \item {\ttfamily \char`\"{}smart\char`\"{}} \end{DoxyItemize}
\begin{DoxyNote}{Note}
These content parts indicates the direction that the content will be displayed
\end{DoxyNote}
All directions may have contents at the same time, except for \char`\"{}smart\char`\"{}. This is a special placement hint and its use case depends of the calculations coming from elm\+\_\+hover\+\_\+best\+\_\+content\+\_\+location\+\_\+get(). Its use is for cases when one desires only one hover content, but with a dynamic special placement within the hover area. The content\textquotesingle{}s geometry, whenever it changes, will be used to decide on a best location, not extrapolating the hover\textquotesingle{}s parent object view to show it in (still being the hover\textquotesingle{}s target determinant of its medium part -- move and resize it to simulate finger sizes, for example). If one of the directions other than \char`\"{}smart\char`\"{} are used, a previously content set using it will be deleted, and vice-\/versa.

Supported elm\+\_\+object common A\+P\+Is. \begin{DoxyItemize}
\item \hyperlink{group__General_ga1beada7edf5d714c0dba5459bcc993fc}{elm\+\_\+object\+\_\+signal\+\_\+emit} \item \hyperlink{group__General_ga6f9574b798efcd454afdac6f2904f633}{elm\+\_\+object\+\_\+signal\+\_\+callback\+\_\+add} \item \hyperlink{group__General_ga3c76b5447be522d647e352cb7ff7c9e6}{elm\+\_\+object\+\_\+signal\+\_\+callback\+\_\+del} \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}
See \hyperlink{tutorial_hover}{Hover example} for more information. 

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


Adds a hover object to {\ttfamily parent}. 


\begin{DoxyParams}{Parameters}
{\em parent} & The parent object \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The hover object or N\+U\+LL if one could not be created 
\end{DoxyReturn}
\index{Hover@{Hover}!elm\+\_\+hover\+\_\+parent\+\_\+get@{elm\+\_\+hover\+\_\+parent\+\_\+get}}
\index{elm\+\_\+hover\+\_\+parent\+\_\+get@{elm\+\_\+hover\+\_\+parent\+\_\+get}!Hover@{Hover}}
\subsubsection[{\texorpdfstring{elm\+\_\+hover\+\_\+parent\+\_\+get(const Evas\+\_\+\+Object $\ast$obj)}{elm_hover_parent_get(const Evas_Object *obj)}}]{\setlength{\rightskip}{0pt plus 5cm}Evas\+\_\+\+Object$\ast$ elm\+\_\+hover\+\_\+parent\+\_\+get (
\begin{DoxyParamCaption}
\item[{const Evas\+\_\+\+Object $\ast$}]{obj}
\end{DoxyParamCaption}
)}\label{group__Hover_gadd5c8502168fccd0994a33c6cee6c45b}


Get the parent object for the hover. 


\begin{DoxyParams}{Parameters}
{\em obj} & The hover object \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The parent object to locate the hover over.
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Hover_ga816c57f831e81de55492c0bddc3e59a9}{elm\+\_\+hover\+\_\+parent\+\_\+set()} 
\end{DoxySeeAlso}
\index{Hover@{Hover}!elm\+\_\+hover\+\_\+parent\+\_\+set@{elm\+\_\+hover\+\_\+parent\+\_\+set}}
\index{elm\+\_\+hover\+\_\+parent\+\_\+set@{elm\+\_\+hover\+\_\+parent\+\_\+set}!Hover@{Hover}}
\subsubsection[{\texorpdfstring{elm\+\_\+hover\+\_\+parent\+\_\+set(\+Evas\+\_\+\+Object $\ast$obj, Evas\+\_\+\+Object $\ast$parent)}{elm_hover_parent_set(Evas_Object *obj, Evas_Object *parent)}}]{\setlength{\rightskip}{0pt plus 5cm}void elm\+\_\+hover\+\_\+parent\+\_\+set (
\begin{DoxyParamCaption}
\item[{Evas\+\_\+\+Object $\ast$}]{obj, }
\item[{Evas\+\_\+\+Object $\ast$}]{parent}
\end{DoxyParamCaption}
)}\label{group__Hover_ga816c57f831e81de55492c0bddc3e59a9}


Sets the parent object for the hover. 


\begin{DoxyParams}{Parameters}
{\em obj} & The hover object \\
\hline
{\em parent} & The object to locate the hover over.\\
\hline
\end{DoxyParams}
This function will cause the hover to take up the entire space that the parent object fills. 

Referenced by elm\+\_\+menu\+\_\+parent\+\_\+set().

