\section{Inwin}
\label{group__Inwin}\index{Inwin@{Inwin}}
\subsection*{Macros}
\begin{DoxyCompactItemize}
\item 
\#define \hyperlink{group__Inwin_gab012d82296d95838de133569dc3fd9ea}{elm\-\_\-obj\-\_\-win\-\_\-inwin\-\_\-activate}()~E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-W\-I\-N\-\_\-\-I\-N\-W\-I\-N\-\_\-\-I\-D(E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-W\-I\-N\-\_\-\-I\-N\-W\-I\-N\-\_\-\-S\-U\-B\-\_\-\-I\-D\-\_\-\-A\-C\-T\-I\-V\-A\-T\-E)
\end{DoxyCompactItemize}
\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
Evas\-\_\-\-Object $\ast$ \hyperlink{group__Inwin_gaf99e0cf10681793f3ae153723de0156b}{elm\-\_\-win\-\_\-inwin\-\_\-add} (Evas\-\_\-\-Object $\ast$parent)
\begin{DoxyCompactList}\small\item\em Adds an inwin to the current window. \end{DoxyCompactList}\item 
void \hyperlink{group__Inwin_gad4f9606686c730afd6a6c89c7c59526b}{elm\-\_\-win\-\_\-inwin\-\_\-activate} (Evas\-\_\-\-Object $\ast$obj)
\begin{DoxyCompactList}\small\item\em Activates an inwin object, ensuring its visibility. \end{DoxyCompactList}\item 
void \hyperlink{group__Inwin_gaeb4bd299e4d9b4dc040ac29e1b1d6b1e}{elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-set} (Evas\-\_\-\-Object $\ast$obj, Evas\-\_\-\-Object $\ast$content)
\begin{DoxyCompactList}\small\item\em Set the content of an inwin object. \end{DoxyCompactList}\item 
Evas\-\_\-\-Object $\ast$ \hyperlink{group__Inwin_gadb45fb65aa0b076116e02d0e2b34346c}{elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-get} (const Evas\-\_\-\-Object $\ast$obj)
\begin{DoxyCompactList}\small\item\em Get the content of an inwin object. \end{DoxyCompactList}\item 
Evas\-\_\-\-Object $\ast$ \hyperlink{group__Inwin_ga4df7cab00fe961526b4558e26f25faeb}{elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-unset} (Evas\-\_\-\-Object $\ast$obj)
\begin{DoxyCompactList}\small\item\em Unset the content of an inwin object. \end{DoxyCompactList}\end{DoxyCompactItemize}


\subsection{Detailed Description}
 
\begin{DoxyImageNoCaption}
  \mbox{\includegraphics{inwin_inheritance_tree}}
\end{DoxyImageNoCaption}


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


An inwin is a window inside a window that is useful for a quick popup. It does not hover.

It works by creating an object that will occupy the entire window, so it must be created using an \hyperlink{group__Win}{elm\-\_\-win} as parent only. The inwin object can be hidden or restacked below every other object if it's needed to show what's behind it without destroying it. If this is done, the \hyperlink{group__Inwin_gad4f9606686c730afd6a6c89c7c59526b}{elm\-\_\-win\-\_\-inwin\-\_\-activate()} function can be used to bring it back to full visibility again.

There are three styles available in the default theme. These are\-: \begin{DoxyItemize}
\item default\-: The inwin is sized to take over most of the window it's placed in. \item minimal\-: The size of the inwin will be the minimum necessary to show its contents. \item minimal\-\_\-vertical\-: Horizontally, the inwin takes as much space as possible, but it's sized vertically the most it needs to fit its\textbackslash{} contents.\end{DoxyItemize}
This widget inherits from the \hyperlink{group__Layout}{Layout} one, so that all the functions acting on it also work for inner windown objects. It also emits the signals inherited from \hyperlink{group__Layout}{Layout}.

Some examples of Inwin can be found in the following\-: \begin{DoxyItemize}
\item \hyperlink{inwin_example_01}{Inwin -\/ General overview} \end{DoxyItemize}


\subsection{Macro Definition Documentation}
\index{Inwin@{Inwin}!elm\-\_\-obj\-\_\-win\-\_\-inwin\-\_\-activate@{elm\-\_\-obj\-\_\-win\-\_\-inwin\-\_\-activate}}
\index{elm\-\_\-obj\-\_\-win\-\_\-inwin\-\_\-activate@{elm\-\_\-obj\-\_\-win\-\_\-inwin\-\_\-activate}!Inwin@{Inwin}}
\subsubsection[{elm\-\_\-obj\-\_\-win\-\_\-inwin\-\_\-activate}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-win\-\_\-inwin\-\_\-activate(
\begin{DoxyParamCaption}
{}
\end{DoxyParamCaption}
)~E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-W\-I\-N\-\_\-\-I\-N\-W\-I\-N\-\_\-\-I\-D(E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-W\-I\-N\-\_\-\-I\-N\-W\-I\-N\-\_\-\-S\-U\-B\-\_\-\-I\-D\-\_\-\-A\-C\-T\-I\-V\-A\-T\-E)}\label{group__Inwin_gab012d82296d95838de133569dc3fd9ea}
\begin{DoxySince}{Since}
1.\-8
\end{DoxySince}
No description supplied by the E\-A\-P\-I. 

Referenced by elm\-\_\-win\-\_\-inwin\-\_\-activate().



\subsection{Function Documentation}
\index{Inwin@{Inwin}!elm\-\_\-win\-\_\-inwin\-\_\-activate@{elm\-\_\-win\-\_\-inwin\-\_\-activate}}
\index{elm\-\_\-win\-\_\-inwin\-\_\-activate@{elm\-\_\-win\-\_\-inwin\-\_\-activate}!Inwin@{Inwin}}
\subsubsection[{elm\-\_\-win\-\_\-inwin\-\_\-activate}]{\setlength{\rightskip}{0pt plus 5cm}void elm\-\_\-win\-\_\-inwin\-\_\-activate (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{obj}
\end{DoxyParamCaption}
)}\label{group__Inwin_gad4f9606686c730afd6a6c89c7c59526b}


Activates an inwin object, ensuring its visibility. 

This function will make sure that the inwin {\ttfamily obj} is completely visible by calling evas\-\_\-object\-\_\-show() and evas\-\_\-object\-\_\-raise() on it, to bring it to the front. It also sets the keyboard focus to it, which will be passed onto its content.

The object's theme will also receive the signal \char`\"{}elm,action,show\char`\"{} with source \char`\"{}elm\char`\"{}.


\begin{DoxyParams}{Parameters}
{\em obj} & The inwin to activate \\
\hline
\end{DoxyParams}


References elm\-\_\-obj\-\_\-win\-\_\-inwin\-\_\-activate.

\index{Inwin@{Inwin}!elm\-\_\-win\-\_\-inwin\-\_\-add@{elm\-\_\-win\-\_\-inwin\-\_\-add}}
\index{elm\-\_\-win\-\_\-inwin\-\_\-add@{elm\-\_\-win\-\_\-inwin\-\_\-add}!Inwin@{Inwin}}
\subsubsection[{elm\-\_\-win\-\_\-inwin\-\_\-add}]{\setlength{\rightskip}{0pt plus 5cm}Evas\-\_\-\-Object$\ast$ elm\-\_\-win\-\_\-inwin\-\_\-add (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{parent}
\end{DoxyParamCaption}
)}\label{group__Inwin_gaf99e0cf10681793f3ae153723de0156b}


Adds an inwin to the current window. 

The {\ttfamily obj} used as parent {\bfseries M\-U\-S\-T} be an \hyperlink{group__Win}{Elementary Window}. Never call this function with anything other than the top-\/most window as its parameter, unless you are fond of undefined behavior.

After creating the object, the widget will set itself as resize object for the window with \hyperlink{group__Win_ga505d6bd217e5ee01e82b548ec35986eb}{elm\-\_\-win\-\_\-resize\-\_\-object\-\_\-add()}, so when shown it will appear to cover almost the entire window (how much of it depends on its content and the style used). It must not be added into other container objects and it needs not be moved or resized manually.


\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}
\index{Inwin@{Inwin}!elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-get@{elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-get}}
\index{elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-get@{elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-get}!Inwin@{Inwin}}
\subsubsection[{elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}Evas\-\_\-\-Object$\ast$ elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-get (
\begin{DoxyParamCaption}
\item[{const Evas\-\_\-\-Object $\ast$}]{obj}
\end{DoxyParamCaption}
)}\label{group__Inwin_gadb45fb65aa0b076116e02d0e2b34346c}


Get the content of an inwin object. 

Return the content object for this widget.

The returned object is valid as long as the inwin is still alive and no other content is set on it. Deleting the object will notify the inwin about it and this one will be left empty.

If you need to remove an inwin's content to be reused somewhere else, see \hyperlink{group__Inwin_ga4df7cab00fe961526b4558e26f25faeb}{elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-unset()}.


\begin{DoxyParams}{Parameters}
{\em obj} & The inwin object \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The content that is being used 
\end{DoxyReturn}
\index{Inwin@{Inwin}!elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-set@{elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-set}}
\index{elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-set@{elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-set}!Inwin@{Inwin}}
\subsubsection[{elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}void elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-set (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{obj, }
\item[{Evas\-\_\-\-Object $\ast$}]{content}
\end{DoxyParamCaption}
)}\label{group__Inwin_gaeb4bd299e4d9b4dc040ac29e1b1d6b1e}


Set the content of an inwin object. 

Once the content object is set, a previously set one will be deleted. If you want to keep that old content object, use the \hyperlink{group__Inwin_ga4df7cab00fe961526b4558e26f25faeb}{elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-unset()} function.


\begin{DoxyParams}{Parameters}
{\em obj} & The inwin object \\
\hline
{\em content} & The object to set as content \\
\hline
\end{DoxyParams}
\index{Inwin@{Inwin}!elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-unset@{elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-unset}}
\index{elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-unset@{elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-unset}!Inwin@{Inwin}}
\subsubsection[{elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-unset}]{\setlength{\rightskip}{0pt plus 5cm}Evas\-\_\-\-Object$\ast$ elm\-\_\-win\-\_\-inwin\-\_\-content\-\_\-unset (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{obj}
\end{DoxyParamCaption}
)}\label{group__Inwin_ga4df7cab00fe961526b4558e26f25faeb}


Unset the content of an inwin object. 

Unparent and return the content object which was set for this widget.


\begin{DoxyParams}{Parameters}
{\em obj} & The inwin object \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The content that was being used 
\end{DoxyReturn}
