\hypertarget{group__Elm__Naviframe__Group}{}\doxysection{Naviframe}
\label{group__Elm__Naviframe__Group}\index{Naviframe@{Naviframe}}


Naviframe stands for navigation frame. It\textquotesingle{}s a views manager for applications.  


\doxysubsection*{Functions}
\begin{DoxyCompactItemize}
\item 
\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$ \mbox{\hyperlink{group__Elm__Naviframe__Group_ga8c53b29789e38864d6f5c455ddd71a0e}{elm\+\_\+naviframe\+\_\+add}} (\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$parent)
\begin{DoxyCompactList}\small\item\em Add a new Naviframe object to the parent. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__Elm__General_ga13a0c231414b86e62f68afe3c6fb462b}{Elm\+\_\+\+Object\+\_\+\+Item}} $\ast$ \mbox{\hyperlink{group__Elm__Naviframe__Group_gab2f96eb7f243641206051e9deeea17ec}{elm\+\_\+naviframe\+\_\+item\+\_\+push}} (\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$obj, const char $\ast$title\+\_\+label, \mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$prev\+\_\+btn, \mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$next\+\_\+btn, \mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$content, const char $\ast$item\+\_\+style)
\begin{DoxyCompactList}\small\item\em Push a new item to the top of the naviframe stack (and show it). \end{DoxyCompactList}\item 
void \mbox{\hyperlink{group__Elm__Naviframe__Group_ga157827438f21f888e5fce512f640e608}{elm\+\_\+naviframe\+\_\+event\+\_\+enabled\+\_\+set}} (Elm\+\_\+\+Naviframe $\ast$obj, \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} enabled)
\begin{DoxyCompactList}\small\item\em Control the event enabled when pushing/popping items. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} \mbox{\hyperlink{group__Elm__Naviframe__Group_ga1fa93c604044f1ee4c7b284694d64ba7}{elm\+\_\+naviframe\+\_\+event\+\_\+enabled\+\_\+get}} (const Elm\+\_\+\+Naviframe $\ast$obj)
\begin{DoxyCompactList}\small\item\em Control the event enabled when pushing/popping items. \end{DoxyCompactList}\item 
void \mbox{\hyperlink{group__Elm__Naviframe__Group_ga0f35d9fbb34488b5185a468383e20ee5}{elm\+\_\+naviframe\+\_\+content\+\_\+preserve\+\_\+on\+\_\+pop\+\_\+set}} (Elm\+\_\+\+Naviframe $\ast$obj, \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} preserve)
\begin{DoxyCompactList}\small\item\em Preserve the content objects when items are popped. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} \mbox{\hyperlink{group__Elm__Naviframe__Group_ga17fe8f1a8d266290461e9a201956bf3a}{elm\+\_\+naviframe\+\_\+content\+\_\+preserve\+\_\+on\+\_\+pop\+\_\+get}} (const Elm\+\_\+\+Naviframe $\ast$obj)
\begin{DoxyCompactList}\small\item\em Preserve the content objects when items are popped. \end{DoxyCompactList}\item 
void \mbox{\hyperlink{group__Elm__Naviframe__Group_ga35cd99068d34d135d4ca3cfe716c1b70}{elm\+\_\+naviframe\+\_\+prev\+\_\+btn\+\_\+auto\+\_\+pushed\+\_\+set}} (Elm\+\_\+\+Naviframe $\ast$obj, \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} auto\+\_\+pushed)
\begin{DoxyCompactList}\small\item\em Control if creating prev button automatically or not. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} \mbox{\hyperlink{group__Elm__Naviframe__Group_ga432f5ad18cc469879bf233a5d362ba14}{elm\+\_\+naviframe\+\_\+prev\+\_\+btn\+\_\+auto\+\_\+pushed\+\_\+get}} (const Elm\+\_\+\+Naviframe $\ast$obj)
\begin{DoxyCompactList}\small\item\em Control if creating prev button automatically or not. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__Eina__List__Group_ga3295e1210efea1fb0fd6acbf3cbc1f29}{Eina\+\_\+\+List}} $\ast$ \mbox{\hyperlink{group__Elm__Naviframe__Group_gacf3a896b72843de1b363cd189d8b006e}{elm\+\_\+naviframe\+\_\+items\+\_\+get}} (const Elm\+\_\+\+Naviframe $\ast$obj)
\begin{DoxyCompactList}\small\item\em Get a list of all the naviframe items. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__Elm__General_ga9a9ae618832fd9732d59650931a9db08}{Elm\+\_\+\+Widget\+\_\+\+Item}} $\ast$ \mbox{\hyperlink{group__Elm__Naviframe__Group_gaee644f83c49bc4b40098df793c14fe04}{elm\+\_\+naviframe\+\_\+top\+\_\+item\+\_\+get}} (const Elm\+\_\+\+Naviframe $\ast$obj)
\begin{DoxyCompactList}\small\item\em Get a top item on the naviframe stack. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__Elm__General_ga9a9ae618832fd9732d59650931a9db08}{Elm\+\_\+\+Widget\+\_\+\+Item}} $\ast$ \mbox{\hyperlink{group__Elm__Naviframe__Group_gaa73a5e3156207d2ac3cdd9b77bc051e8}{elm\+\_\+naviframe\+\_\+bottom\+\_\+item\+\_\+get}} (const Elm\+\_\+\+Naviframe $\ast$obj)
\begin{DoxyCompactList}\small\item\em Get a bottom item on the naviframe stack. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$ \mbox{\hyperlink{group__Elm__Naviframe__Group_gada93ec39b055dbd136e8386c228ffac9}{elm\+\_\+naviframe\+\_\+item\+\_\+pop}} (Elm\+\_\+\+Naviframe $\ast$obj)
\begin{DoxyCompactList}\small\item\em Pop an item that is on top of the stack. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__Elm__General_ga9a9ae618832fd9732d59650931a9db08}{Elm\+\_\+\+Widget\+\_\+\+Item}} $\ast$ \mbox{\hyperlink{group__Elm__Naviframe__Group_ga677403d64116c6a9cf0f8a71b950d171}{elm\+\_\+naviframe\+\_\+item\+\_\+insert\+\_\+before}} (Elm\+\_\+\+Naviframe $\ast$obj, \mbox{\hyperlink{group__Elm__General_ga9a9ae618832fd9732d59650931a9db08}{Elm\+\_\+\+Widget\+\_\+\+Item}} $\ast$before, const char $\ast$title\+\_\+label, \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$prev\+\_\+btn, \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$next\+\_\+btn, \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$content, const char $\ast$item\+\_\+style)
\begin{DoxyCompactList}\small\item\em Insert a new item into the naviframe before item {\ttfamily before}. \end{DoxyCompactList}\item 
void \mbox{\hyperlink{group__Elm__Naviframe__Group_gada1d362c52eed9f09e5f4cc3d1b270ab}{elm\+\_\+naviframe\+\_\+item\+\_\+simple\+\_\+promote}} (Elm\+\_\+\+Naviframe $\ast$obj, \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$content)
\begin{DoxyCompactList}\small\item\em Simple version of item\+\_\+promote. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__Elm__General_ga9a9ae618832fd9732d59650931a9db08}{Elm\+\_\+\+Widget\+\_\+\+Item}} $\ast$ \mbox{\hyperlink{group__Elm__Naviframe__Group_ga3d0d788134bae958634198561fbd32dc}{elm\+\_\+naviframe\+\_\+item\+\_\+insert\+\_\+after}} (Elm\+\_\+\+Naviframe $\ast$obj, \mbox{\hyperlink{group__Elm__General_ga9a9ae618832fd9732d59650931a9db08}{Elm\+\_\+\+Widget\+\_\+\+Item}} $\ast$after, const char $\ast$title\+\_\+label, \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$prev\+\_\+btn, \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$next\+\_\+btn, \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$content, const char $\ast$item\+\_\+style)
\begin{DoxyCompactList}\small\item\em Insert a new item into the naviframe after item {\ttfamily after}. \end{DoxyCompactList}\end{DoxyCompactItemize}


\doxysubsection{Detailed Description}
Naviframe stands for navigation frame. It\textquotesingle{}s a views manager for applications. 

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


A naviframe holds views (or pages) as its items. Those items are organized in a stack, so that new items get pushed on top of the old, and only the topmost view is displayed at one time. Due to the characteristics of a stack, even though you push a new item, previous item is not deleted. Previous item will be shown when you pop new item. The transition between views is animated, depending on the theme applied to the widget.

Naviframe views hold spaces to various elements, which are\+:
\begin{DoxyItemize}
\item back button, used to navigate to previous views,
\item next button, used to navigate to next views in the stack,
\item title label,
\item sub-\/title label,
\item title icon and
\item content area.
\end{DoxyItemize}

One can use \mbox{\hyperlink{group__Elm__General_ga79ff1bf2d04a5a730fdca21ccc2067c1}{elm\+\_\+object\+\_\+item\+\_\+part\+\_\+content\+\_\+set}}, \mbox{\hyperlink{group__Elm__General_gab9484cb6aaa388c5e98e63d12f39b8ef}{elm\+\_\+object\+\_\+item\+\_\+part\+\_\+content\+\_\+get}}, \mbox{\hyperlink{group__Elm__General_ga09b294bd263b9aedfe111412b61b019c}{elm\+\_\+object\+\_\+item\+\_\+part\+\_\+content\+\_\+unset}} functions to handle the contents. The swallow part name should be one of these\+: \begin{DoxyItemize}
\item {\ttfamily \char`\"{}default\char`\"{}} -\/ The main content of the current page \item {\ttfamily \char`\"{}icon\char`\"{}} -\/ An icon in the title area of the current page \item {\ttfamily \char`\"{}prev\+\_\+btn\char`\"{}} -\/ A button of the current page to go to the previous page \item {\ttfamily \char`\"{}next\+\_\+btn\char`\"{}} -\/ A button of the current page to go to the next page\end{DoxyItemize}
One can use \mbox{\hyperlink{group__Elm__General_ga990f25208c4ef0e5c9c404cfb482d813}{elm\+\_\+object\+\_\+item\+\_\+part\+\_\+text\+\_\+set}}, \mbox{\hyperlink{group__Elm__General_ga453ec97f657bae0588fd4cd4e78ec918}{elm\+\_\+object\+\_\+item\+\_\+part\+\_\+text\+\_\+get}} to handle the text parts. The swallow part name should be one of these\+: \begin{DoxyItemize}
\item {\ttfamily \char`\"{}default\char`\"{}} -\/ A title label in the title area of the current page \item {\ttfamily \char`\"{}subtitle\char`\"{}} -\/ A sub-\/title label in the title area of the current page\end{DoxyItemize}
Most of those content objects can be passed at the time of an item creation (see \mbox{\hyperlink{group__Elm__Naviframe__Group_gab2f96eb7f243641206051e9deeea17ec}{elm\+\_\+naviframe\+\_\+item\+\_\+push()}}).

Naviframe items can have different styles, which affect the transition between views, for example. On the default theme, two of them are supported\+:
\begin{DoxyItemize}
\item {\ttfamily \char`\"{}basic\char`\"{}} -\/ views are switched sliding horizontally, one after the other
\item {\ttfamily \char`\"{}overlap\char`\"{}} -\/ like the previous one, but the previous view stays at its place and is overlapped by the new
\end{DoxyItemize}

This widget emits the following signals, besides the ones sent from \mbox{\hyperlink{group__Elm__Layout}{Layout}} \+: \begin{DoxyItemize}
\item {\ttfamily \char`\"{}transition,finished\char`\"{}} -\/ When the transition is finished in changing the item \item {\ttfamily \char`\"{}title,transition,finished\char`\"{}} -\/ When the title area\textquotesingle{}s transition is finished in changing the state of the title \item {\ttfamily \char`\"{}title,clicked\char`\"{}} -\/ User clicked title area \item {\ttfamily \char`\"{}focused\char`\"{}} -\/ When the naviframe has received focus. (since 1.\+8) \item {\ttfamily \char`\"{}unfocused\char`\"{}} -\/ When the naviframe has lost focus. (since 1.\+8) \item {\ttfamily \char`\"{}language,changed\char`\"{}} -\/ the program\textquotesingle{}s language changed (since 1.\+9)\end{DoxyItemize}
All the parts, for content and text, described here will also be reachable by naviframe {\bfseries{items}} direct calls\+: \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}} \item \mbox{\hyperlink{group__Elm__General_ga79ff1bf2d04a5a730fdca21ccc2067c1}{elm\+\_\+object\+\_\+item\+\_\+part\+\_\+content\+\_\+set}} \item \mbox{\hyperlink{group__Elm__General_gab9484cb6aaa388c5e98e63d12f39b8ef}{elm\+\_\+object\+\_\+item\+\_\+part\+\_\+content\+\_\+get}} \item \mbox{\hyperlink{group__Elm__General_ga09b294bd263b9aedfe111412b61b019c}{elm\+\_\+object\+\_\+item\+\_\+part\+\_\+content\+\_\+unset}} \item \mbox{\hyperlink{group__Elm__General_gabdb3e5328a1e3c367c3fc3536e4a2e5c}{elm\+\_\+object\+\_\+item\+\_\+signal\+\_\+emit}}\end{DoxyItemize}
What happens is that the topmost item of a naviframe will be the widget\textquotesingle{}s target layout, when accessed directly. Items lying below the top one can be interacted with this way.

Here is an example on its usage\+: \begin{DoxyItemize}
\item naviframe\+\_\+example \end{DoxyItemize}


\doxysubsection{Function Documentation}
\mbox{\Hypertarget{group__Elm__Naviframe__Group_ga8c53b29789e38864d6f5c455ddd71a0e}\label{group__Elm__Naviframe__Group_ga8c53b29789e38864d6f5c455ddd71a0e}} 
\index{Naviframe@{Naviframe}!elm\_naviframe\_add@{elm\_naviframe\_add}}
\index{elm\_naviframe\_add@{elm\_naviframe\_add}!Naviframe@{Naviframe}}
\doxysubsubsection{\texorpdfstring{elm\_naviframe\_add()}{elm\_naviframe\_add()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$ elm\+\_\+naviframe\+\_\+add (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$}]{parent }\end{DoxyParamCaption})}



Add a new Naviframe object to the parent. 


\begin{DoxyParams}{Parameters}
{\em parent} & Parent object \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
New object or {\ttfamily 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__Elm__Naviframe__Group_gab2f96eb7f243641206051e9deeea17ec}\label{group__Elm__Naviframe__Group_gab2f96eb7f243641206051e9deeea17ec}} 
\index{Naviframe@{Naviframe}!elm\_naviframe\_item\_push@{elm\_naviframe\_item\_push}}
\index{elm\_naviframe\_item\_push@{elm\_naviframe\_item\_push}!Naviframe@{Naviframe}}
\doxysubsubsection{\texorpdfstring{elm\_naviframe\_item\_push()}{elm\_naviframe\_item\_push()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__Elm__General_ga13a0c231414b86e62f68afe3c6fb462b}{Elm\+\_\+\+Object\+\_\+\+Item}} $\ast$ elm\+\_\+naviframe\+\_\+item\+\_\+push (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$}]{obj,  }\item[{const char $\ast$}]{title\+\_\+label,  }\item[{\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$}]{prev\+\_\+btn,  }\item[{\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$}]{next\+\_\+btn,  }\item[{\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$}]{content,  }\item[{const char $\ast$}]{item\+\_\+style }\end{DoxyParamCaption})}



Push a new item to the top of the naviframe stack (and show it). 

The item pushed becomes one page of the naviframe, this item will be deleted when it is popped.

When push transition animation is in progress, pop operation is blocked until push is complete.

The following styles are available for this item\+: \char`\"{}default\char`\"{}


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em title\+\_\+label} & The label in the title area. The name of the title label part is \char`\"{}elm.\+text.\+title\char`\"{} \\
\hline
\mbox{\texttt{ in}}  & {\em prev\+\_\+btn} & The button to go to the previous item. If it is NULL, then naviframe will create a back button automatically. The name of the prev\+\_\+btn part is \char`\"{}elm.\+swallow.\+prev\+\_\+btn\char`\"{} \\
\hline
\mbox{\texttt{ in}}  & {\em next\+\_\+btn} & The button to go to the next item. Or It could be just an extra function button. The name of the next\+\_\+btn part is \char`\"{}elm.\+swallow.\+next\+\_\+btn\char`\"{} \\
\hline
\mbox{\texttt{ in}}  & {\em content} & The main content object. The name of content part is \char`\"{}elm.\+swallow.\+content\char`\"{} \\
\hline
\mbox{\texttt{ in}}  & {\em item\+\_\+style} & The current item style name. {\ttfamily NULL} would be default.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The created item or {\ttfamily NULL} upon failure. 
\end{DoxyReturn}
\begin{Desc}
\item[Examples]\par
\mbox{\hyperlink{naviframe_example_8c-example}{naviframe\+\_\+example.\+c}}.\end{Desc}
\mbox{\Hypertarget{group__Elm__Naviframe__Group_ga157827438f21f888e5fce512f640e608}\label{group__Elm__Naviframe__Group_ga157827438f21f888e5fce512f640e608}} 
\index{Naviframe@{Naviframe}!elm\_naviframe\_event\_enabled\_set@{elm\_naviframe\_event\_enabled\_set}}
\index{elm\_naviframe\_event\_enabled\_set@{elm\_naviframe\_event\_enabled\_set}!Naviframe@{Naviframe}}
\doxysubsubsection{\texorpdfstring{elm\_naviframe\_event\_enabled\_set()}{elm\_naviframe\_event\_enabled\_set()}}
{\footnotesize\ttfamily void elm\+\_\+naviframe\+\_\+event\+\_\+enabled\+\_\+set (\begin{DoxyParamCaption}\item[{Elm\+\_\+\+Naviframe $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}}}]{enabled }\end{DoxyParamCaption})}



Control the event enabled when pushing/popping items. 

If {\ttfamily enabled} is {\ttfamily true}, the contents of the naviframe item will receives events from mouse and keyboard during view changing such as item push/pop.

\begin{DoxyWarning}{Warning}
Events will be blocked by calling \mbox{\hyperlink{group__Evas__Object__Group_ga6560a55b531cf8effef33c9481e75035}{evas\+\_\+object\+\_\+freeze\+\_\+events\+\_\+set()}} internally. So don\textquotesingle{}t call the API whiling pushing/popping items.
\end{DoxyWarning}

\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em enabled} & Events are received when enabled is {\ttfamily true}, and ignored otherwise. \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Elm__Naviframe__Group_ga1fa93c604044f1ee4c7b284694d64ba7}\label{group__Elm__Naviframe__Group_ga1fa93c604044f1ee4c7b284694d64ba7}} 
\index{Naviframe@{Naviframe}!elm\_naviframe\_event\_enabled\_get@{elm\_naviframe\_event\_enabled\_get}}
\index{elm\_naviframe\_event\_enabled\_get@{elm\_naviframe\_event\_enabled\_get}!Naviframe@{Naviframe}}
\doxysubsubsection{\texorpdfstring{elm\_naviframe\_event\_enabled\_get()}{elm\_naviframe\_event\_enabled\_get()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} elm\+\_\+naviframe\+\_\+event\+\_\+enabled\+\_\+get (\begin{DoxyParamCaption}\item[{const Elm\+\_\+\+Naviframe $\ast$}]{obj }\end{DoxyParamCaption})}



Control the event enabled when pushing/popping items. 

If {\ttfamily enabled} is {\ttfamily true}, the contents of the naviframe item will receives events from mouse and keyboard during view changing such as item push/pop.

\begin{DoxyWarning}{Warning}
Events will be blocked by calling \mbox{\hyperlink{group__Evas__Object__Group_ga6560a55b531cf8effef33c9481e75035}{evas\+\_\+object\+\_\+freeze\+\_\+events\+\_\+set()}} internally. So don\textquotesingle{}t call the API whiling pushing/popping items.
\end{DoxyWarning}

\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
Events are received when enabled is {\ttfamily true}, and ignored otherwise. 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Elm__Naviframe__Group_ga0f35d9fbb34488b5185a468383e20ee5}\label{group__Elm__Naviframe__Group_ga0f35d9fbb34488b5185a468383e20ee5}} 
\index{Naviframe@{Naviframe}!elm\_naviframe\_content\_preserve\_on\_pop\_set@{elm\_naviframe\_content\_preserve\_on\_pop\_set}}
\index{elm\_naviframe\_content\_preserve\_on\_pop\_set@{elm\_naviframe\_content\_preserve\_on\_pop\_set}!Naviframe@{Naviframe}}
\doxysubsubsection{\texorpdfstring{elm\_naviframe\_content\_preserve\_on\_pop\_set()}{elm\_naviframe\_content\_preserve\_on\_pop\_set()}}
{\footnotesize\ttfamily void elm\+\_\+naviframe\+\_\+content\+\_\+preserve\+\_\+on\+\_\+pop\+\_\+set (\begin{DoxyParamCaption}\item[{Elm\+\_\+\+Naviframe $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}}}]{preserve }\end{DoxyParamCaption})}



Preserve the content objects when items are popped. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em preserve} & Enable the preserve mode if {\ttfamily true}, disable otherwise \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Elm__Naviframe__Group_ga17fe8f1a8d266290461e9a201956bf3a}\label{group__Elm__Naviframe__Group_ga17fe8f1a8d266290461e9a201956bf3a}} 
\index{Naviframe@{Naviframe}!elm\_naviframe\_content\_preserve\_on\_pop\_get@{elm\_naviframe\_content\_preserve\_on\_pop\_get}}
\index{elm\_naviframe\_content\_preserve\_on\_pop\_get@{elm\_naviframe\_content\_preserve\_on\_pop\_get}!Naviframe@{Naviframe}}
\doxysubsubsection{\texorpdfstring{elm\_naviframe\_content\_preserve\_on\_pop\_get()}{elm\_naviframe\_content\_preserve\_on\_pop\_get()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} elm\+\_\+naviframe\+\_\+content\+\_\+preserve\+\_\+on\+\_\+pop\+\_\+get (\begin{DoxyParamCaption}\item[{const Elm\+\_\+\+Naviframe $\ast$}]{obj }\end{DoxyParamCaption})}



Preserve the content objects when items are popped. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
Enable the preserve mode if {\ttfamily true}, disable otherwise 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Elm__Naviframe__Group_ga35cd99068d34d135d4ca3cfe716c1b70}\label{group__Elm__Naviframe__Group_ga35cd99068d34d135d4ca3cfe716c1b70}} 
\index{Naviframe@{Naviframe}!elm\_naviframe\_prev\_btn\_auto\_pushed\_set@{elm\_naviframe\_prev\_btn\_auto\_pushed\_set}}
\index{elm\_naviframe\_prev\_btn\_auto\_pushed\_set@{elm\_naviframe\_prev\_btn\_auto\_pushed\_set}!Naviframe@{Naviframe}}
\doxysubsubsection{\texorpdfstring{elm\_naviframe\_prev\_btn\_auto\_pushed\_set()}{elm\_naviframe\_prev\_btn\_auto\_pushed\_set()}}
{\footnotesize\ttfamily void elm\+\_\+naviframe\+\_\+prev\+\_\+btn\+\_\+auto\+\_\+pushed\+\_\+set (\begin{DoxyParamCaption}\item[{Elm\+\_\+\+Naviframe $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}}}]{auto\+\_\+pushed }\end{DoxyParamCaption})}



Control if creating prev button automatically or not. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em auto\+\_\+pushed} & If {\ttfamily true}, the previous button(back button) will be created internally when you pass the {\ttfamily NULL} to the prev\+\_\+btn parameter in elm\+\_\+naviframe\+\_\+item\+\_\+push \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Elm__Naviframe__Group_ga432f5ad18cc469879bf233a5d362ba14}\label{group__Elm__Naviframe__Group_ga432f5ad18cc469879bf233a5d362ba14}} 
\index{Naviframe@{Naviframe}!elm\_naviframe\_prev\_btn\_auto\_pushed\_get@{elm\_naviframe\_prev\_btn\_auto\_pushed\_get}}
\index{elm\_naviframe\_prev\_btn\_auto\_pushed\_get@{elm\_naviframe\_prev\_btn\_auto\_pushed\_get}!Naviframe@{Naviframe}}
\doxysubsubsection{\texorpdfstring{elm\_naviframe\_prev\_btn\_auto\_pushed\_get()}{elm\_naviframe\_prev\_btn\_auto\_pushed\_get()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} elm\+\_\+naviframe\+\_\+prev\+\_\+btn\+\_\+auto\+\_\+pushed\+\_\+get (\begin{DoxyParamCaption}\item[{const Elm\+\_\+\+Naviframe $\ast$}]{obj }\end{DoxyParamCaption})}



Control if creating prev button automatically or not. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
If {\ttfamily true}, the previous button(back button) will be created internally when you pass the {\ttfamily NULL} to the prev\+\_\+btn parameter in elm\+\_\+naviframe\+\_\+item\+\_\+push 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Elm__Naviframe__Group_gacf3a896b72843de1b363cd189d8b006e}\label{group__Elm__Naviframe__Group_gacf3a896b72843de1b363cd189d8b006e}} 
\index{Naviframe@{Naviframe}!elm\_naviframe\_items\_get@{elm\_naviframe\_items\_get}}
\index{elm\_naviframe\_items\_get@{elm\_naviframe\_items\_get}!Naviframe@{Naviframe}}
\doxysubsubsection{\texorpdfstring{elm\_naviframe\_items\_get()}{elm\_naviframe\_items\_get()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__Eina__List__Group_ga3295e1210efea1fb0fd6acbf3cbc1f29}{Eina\+\_\+\+List}} $\ast$ elm\+\_\+naviframe\+\_\+items\+\_\+get (\begin{DoxyParamCaption}\item[{const Elm\+\_\+\+Naviframe $\ast$}]{obj }\end{DoxyParamCaption})}



Get a list of all the naviframe items. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
A list of naviframe items, \mbox{\hyperlink{group__Elm__General_ga9a9ae618832fd9732d59650931a9db08}{Elm\+\_\+\+Widget\+\_\+\+Item}}, or {\ttfamily NULL} on failure. Note\+: The returned list MUST be freed. 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Elm__Naviframe__Group_gaee644f83c49bc4b40098df793c14fe04}\label{group__Elm__Naviframe__Group_gaee644f83c49bc4b40098df793c14fe04}} 
\index{Naviframe@{Naviframe}!elm\_naviframe\_top\_item\_get@{elm\_naviframe\_top\_item\_get}}
\index{elm\_naviframe\_top\_item\_get@{elm\_naviframe\_top\_item\_get}!Naviframe@{Naviframe}}
\doxysubsubsection{\texorpdfstring{elm\_naviframe\_top\_item\_get()}{elm\_naviframe\_top\_item\_get()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__Elm__General_ga9a9ae618832fd9732d59650931a9db08}{Elm\+\_\+\+Widget\+\_\+\+Item}} $\ast$ elm\+\_\+naviframe\+\_\+top\+\_\+item\+\_\+get (\begin{DoxyParamCaption}\item[{const Elm\+\_\+\+Naviframe $\ast$}]{obj }\end{DoxyParamCaption})}



Get a top item on the naviframe stack. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The top item on the naviframe stack or {\ttfamily NULL}, if the stack is empty 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Elm__Naviframe__Group_gaa73a5e3156207d2ac3cdd9b77bc051e8}\label{group__Elm__Naviframe__Group_gaa73a5e3156207d2ac3cdd9b77bc051e8}} 
\index{Naviframe@{Naviframe}!elm\_naviframe\_bottom\_item\_get@{elm\_naviframe\_bottom\_item\_get}}
\index{elm\_naviframe\_bottom\_item\_get@{elm\_naviframe\_bottom\_item\_get}!Naviframe@{Naviframe}}
\doxysubsubsection{\texorpdfstring{elm\_naviframe\_bottom\_item\_get()}{elm\_naviframe\_bottom\_item\_get()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__Elm__General_ga9a9ae618832fd9732d59650931a9db08}{Elm\+\_\+\+Widget\+\_\+\+Item}} $\ast$ elm\+\_\+naviframe\+\_\+bottom\+\_\+item\+\_\+get (\begin{DoxyParamCaption}\item[{const Elm\+\_\+\+Naviframe $\ast$}]{obj }\end{DoxyParamCaption})}



Get a bottom item on the naviframe stack. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The bottom item on the naviframe stack or {\ttfamily NULL}, if the stack is empty 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Elm__Naviframe__Group_gada93ec39b055dbd136e8386c228ffac9}\label{group__Elm__Naviframe__Group_gada93ec39b055dbd136e8386c228ffac9}} 
\index{Naviframe@{Naviframe}!elm\_naviframe\_item\_pop@{elm\_naviframe\_item\_pop}}
\index{elm\_naviframe\_item\_pop@{elm\_naviframe\_item\_pop}!Naviframe@{Naviframe}}
\doxysubsubsection{\texorpdfstring{elm\_naviframe\_item\_pop()}{elm\_naviframe\_item\_pop()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$ elm\+\_\+naviframe\+\_\+item\+\_\+pop (\begin{DoxyParamCaption}\item[{Elm\+\_\+\+Naviframe $\ast$}]{obj }\end{DoxyParamCaption})}



Pop an item that is on top of the stack. 

This pops an item that is on the top(visible) of the naviframe, makes it disappear, then deletes the item. The item that was underneath it on the stack will become visible.

When pop transition animation is in progress, new pop operation is blocked until current pop operation is complete.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily NULL} or the content object(if the elm\+\_\+naviframe\+\_\+content\+\_\+preserve\+\_\+on\+\_\+pop\+\_\+get is true). 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Elm__Naviframe__Group_ga677403d64116c6a9cf0f8a71b950d171}\label{group__Elm__Naviframe__Group_ga677403d64116c6a9cf0f8a71b950d171}} 
\index{Naviframe@{Naviframe}!elm\_naviframe\_item\_insert\_before@{elm\_naviframe\_item\_insert\_before}}
\index{elm\_naviframe\_item\_insert\_before@{elm\_naviframe\_item\_insert\_before}!Naviframe@{Naviframe}}
\doxysubsubsection{\texorpdfstring{elm\_naviframe\_item\_insert\_before()}{elm\_naviframe\_item\_insert\_before()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__Elm__General_ga9a9ae618832fd9732d59650931a9db08}{Elm\+\_\+\+Widget\+\_\+\+Item}} $\ast$ elm\+\_\+naviframe\+\_\+item\+\_\+insert\+\_\+before (\begin{DoxyParamCaption}\item[{Elm\+\_\+\+Naviframe $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Elm__General_ga9a9ae618832fd9732d59650931a9db08}{Elm\+\_\+\+Widget\+\_\+\+Item}} $\ast$}]{before,  }\item[{const char $\ast$}]{title\+\_\+label,  }\item[{\mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$}]{prev\+\_\+btn,  }\item[{\mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$}]{next\+\_\+btn,  }\item[{\mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$}]{content,  }\item[{const char $\ast$}]{item\+\_\+style }\end{DoxyParamCaption})}



Insert a new item into the naviframe before item {\ttfamily before}. 

The item is inserted into the naviframe straight away without any transition operations. This item will be deleted when it is popped.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em before} & The naviframe item to insert before. \\
\hline
\mbox{\texttt{ in}}  & {\em title\+\_\+label} & The label in the title area. The name of the title label part is \char`\"{}elm.\+text.\+title\char`\"{} \\
\hline
\mbox{\texttt{ in}}  & {\em prev\+\_\+btn} & The button to go to the previous item. If it is NULL, then naviframe will create a back button automatically. The name of the prev\+\_\+btn part is \char`\"{}elm.\+swallow.\+prev\+\_\+btn\char`\"{} \\
\hline
\mbox{\texttt{ in}}  & {\em next\+\_\+btn} & The button to go to the next item. Or It could be just an extra function button. The name of the next\+\_\+btn part is \char`\"{}elm.\+swallow.\+next\+\_\+btn\char`\"{} \\
\hline
\mbox{\texttt{ in}}  & {\em content} & The main content object. The name of content part is \char`\"{}elm.\+swallow.\+content\char`\"{} \\
\hline
\mbox{\texttt{ in}}  & {\em item\+\_\+style} & The current item style name. {\ttfamily NULL} would be default.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The created item or {\ttfamily NULL} upon failure. 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Elm__Naviframe__Group_gada1d362c52eed9f09e5f4cc3d1b270ab}\label{group__Elm__Naviframe__Group_gada1d362c52eed9f09e5f4cc3d1b270ab}} 
\index{Naviframe@{Naviframe}!elm\_naviframe\_item\_simple\_promote@{elm\_naviframe\_item\_simple\_promote}}
\index{elm\_naviframe\_item\_simple\_promote@{elm\_naviframe\_item\_simple\_promote}!Naviframe@{Naviframe}}
\doxysubsubsection{\texorpdfstring{elm\_naviframe\_item\_simple\_promote()}{elm\_naviframe\_item\_simple\_promote()}}
{\footnotesize\ttfamily void elm\+\_\+naviframe\+\_\+item\+\_\+simple\+\_\+promote (\begin{DoxyParamCaption}\item[{Elm\+\_\+\+Naviframe $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$}]{content }\end{DoxyParamCaption})}



Simple version of item\+\_\+promote. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em content} & Item to promote \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Elm__Naviframe__Group_ga3d0d788134bae958634198561fbd32dc}\label{group__Elm__Naviframe__Group_ga3d0d788134bae958634198561fbd32dc}} 
\index{Naviframe@{Naviframe}!elm\_naviframe\_item\_insert\_after@{elm\_naviframe\_item\_insert\_after}}
\index{elm\_naviframe\_item\_insert\_after@{elm\_naviframe\_item\_insert\_after}!Naviframe@{Naviframe}}
\doxysubsubsection{\texorpdfstring{elm\_naviframe\_item\_insert\_after()}{elm\_naviframe\_item\_insert\_after()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__Elm__General_ga9a9ae618832fd9732d59650931a9db08}{Elm\+\_\+\+Widget\+\_\+\+Item}} $\ast$ elm\+\_\+naviframe\+\_\+item\+\_\+insert\+\_\+after (\begin{DoxyParamCaption}\item[{Elm\+\_\+\+Naviframe $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Elm__General_ga9a9ae618832fd9732d59650931a9db08}{Elm\+\_\+\+Widget\+\_\+\+Item}} $\ast$}]{after,  }\item[{const char $\ast$}]{title\+\_\+label,  }\item[{\mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$}]{prev\+\_\+btn,  }\item[{\mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$}]{next\+\_\+btn,  }\item[{\mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$}]{content,  }\item[{const char $\ast$}]{item\+\_\+style }\end{DoxyParamCaption})}



Insert a new item into the naviframe after item {\ttfamily after}. 

The item is inserted into the naviframe straight away without any transition operations. This item will be deleted when it is popped.

The following styles are available for this item\+: \char`\"{}default\char`\"{}


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em after} & The naviframe item to insert after. \\
\hline
\mbox{\texttt{ in}}  & {\em title\+\_\+label} & The label in the title area. The name of the title label part is \char`\"{}elm.\+text.\+title\char`\"{} \\
\hline
\mbox{\texttt{ in}}  & {\em prev\+\_\+btn} & The button to go to the previous item. If it is NULL, then naviframe will create a back button automatically. The name of the prev\+\_\+btn part is \char`\"{}elm.\+swallow.\+prev\+\_\+btn\char`\"{} \\
\hline
\mbox{\texttt{ in}}  & {\em next\+\_\+btn} & The button to go to the next item. Or It could be just an extra function button. The name of the next\+\_\+btn part is \char`\"{}elm.\+swallow.\+next\+\_\+btn\char`\"{} \\
\hline
\mbox{\texttt{ in}}  & {\em content} & The main content object. The name of content part is \char`\"{}elm.\+swallow.\+content\char`\"{} \\
\hline
\mbox{\texttt{ in}}  & {\em item\+\_\+style} & The current item style name. {\ttfamily NULL} would be default.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The created item or {\ttfamily NULL} upon failure. 
\end{DoxyReturn}
