\section{Elementary Prefs}
\label{group__Elm__Prefs}\index{Elementary Prefs@{Elementary Prefs}}


Elementary provides a prefs (for \char`\"{}preferences\char`\"{}) infrastructure, which consists of two sets of A\+P\+Is\+:  


\subsection*{Data Structures}
\begin{DoxyCompactItemize}
\item 
struct \hyperlink{struct__Elm__Prefs__Item__Iface}{\+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Iface}
\begin{DoxyCompactList}\small\item\em Interface between items of the \hyperlink{group__Elm__Prefs_elm-prefs-widget}{Prefs} widget and the real widgets implementing them. \end{DoxyCompactList}\item 
struct \hyperlink{struct__Elm__Prefs__Item__Iface__Info}{\+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Iface\+\_\+\+Info}
\begin{DoxyCompactList}\small\item\em Convenience struct used to mass-\/register widgets implementing prefs {\bfseries items} interfaces. \end{DoxyCompactList}\item 
struct \hyperlink{struct__Elm__Prefs__Page__Iface}{\+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Page\+\_\+\+Iface}
\begin{DoxyCompactList}\small\item\em Interface between pages of the \hyperlink{group__Elm__Prefs_elm-prefs-widget}{Prefs} widget and the real widgets implementing them. \end{DoxyCompactList}\item 
struct \hyperlink{struct__Elm__Prefs__Page__Iface__Info}{\+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Page\+\_\+\+Iface\+\_\+\+Info}
\begin{DoxyCompactList}\small\item\em Convenience struct used to mass-\/register widgets implementing prefs {\bfseries pages} interfaces. \end{DoxyCompactList}\end{DoxyCompactItemize}
\subsection*{Macros}
\begin{DoxyCompactItemize}
\item 
\mbox{\label{group__Elm__Prefs_ga7e551f36382f52a23a00491096e50aaf}} 
\#define \hyperlink{group__Elm__Prefs_ga7e551f36382f52a23a00491096e50aaf}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+E\+V\+E\+N\+T\+\_\+\+P\+A\+G\+E\+\_\+\+C\+H\+A\+N\+G\+ED}~(\&(\+\_\+\+E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+E\+V\+E\+N\+T\+\_\+\+P\+A\+G\+E\+\_\+\+C\+H\+A\+N\+G\+ED))
\begin{DoxyCompactList}\small\item\em s \end{DoxyCompactList}\item 
\mbox{\label{group__Elm__Prefs_ga4d22adec6c62a90824087df3ab955de9}} 
\#define \hyperlink{group__Elm__Prefs_ga4d22adec6c62a90824087df3ab955de9}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+E\+V\+E\+N\+T\+\_\+\+P\+A\+G\+E\+\_\+\+S\+A\+V\+ED}~(\&(\+\_\+\+E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+E\+V\+E\+N\+T\+\_\+\+P\+A\+G\+E\+\_\+\+S\+A\+V\+ED))
\begin{DoxyCompactList}\small\item\em s \end{DoxyCompactList}\item 
\mbox{\label{group__Elm__Prefs_ga2f041d8d25f1ad626a6a475f5615c48c}} 
\#define \hyperlink{group__Elm__Prefs_ga2f041d8d25f1ad626a6a475f5615c48c}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+E\+V\+E\+N\+T\+\_\+\+P\+A\+G\+E\+\_\+\+R\+E\+S\+ET}~(\&(\+\_\+\+E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+E\+V\+E\+N\+T\+\_\+\+P\+A\+G\+E\+\_\+\+R\+E\+S\+ET))
\begin{DoxyCompactList}\small\item\em s \end{DoxyCompactList}\item 
\mbox{\label{group__Elm__Prefs_ga91cf0abd1ec78e6697fb02437b64f489}} 
\#define \hyperlink{group__Elm__Prefs_ga91cf0abd1ec78e6697fb02437b64f489}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+E\+V\+E\+N\+T\+\_\+\+P\+A\+G\+E\+\_\+\+L\+O\+A\+D\+ED}~(\&(\+\_\+\+E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+E\+V\+E\+N\+T\+\_\+\+P\+A\+G\+E\+\_\+\+L\+O\+A\+D\+ED))
\begin{DoxyCompactList}\small\item\em s \end{DoxyCompactList}\item 
\mbox{\label{group__Elm__Prefs_ga5415bef6ae304d4d532eca0583eb0325}} 
\#define \hyperlink{group__Elm__Prefs_ga5415bef6ae304d4d532eca0583eb0325}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+E\+V\+E\+N\+T\+\_\+\+I\+T\+E\+M\+\_\+\+C\+H\+A\+N\+G\+ED}~(\&(\+\_\+\+E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+E\+V\+E\+N\+T\+\_\+\+I\+T\+E\+M\+\_\+\+C\+H\+A\+N\+G\+ED))
\begin{DoxyCompactList}\small\item\em s \end{DoxyCompactList}\item 
\mbox{\label{group__Elm__Prefs_gaf421428c8cbe93906786ed9dba2e368f}} 
\#define \hyperlink{group__Elm__Prefs_gaf421428c8cbe93906786ed9dba2e368f}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+E\+V\+E\+N\+T\+\_\+\+A\+C\+T\+I\+ON}~(\&(\+\_\+\+E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+E\+V\+E\+N\+T\+\_\+\+A\+C\+T\+I\+ON))
\begin{DoxyCompactList}\small\item\em ss \end{DoxyCompactList}\end{DoxyCompactItemize}
\subsection*{Typedefs}
\begin{DoxyCompactItemize}
\item 
\mbox{\label{group__Elm__Prefs_ga47ee0cfc6e4dad8fb4fc1960c78a1b6b}} 
typedef void($\ast$ \hyperlink{group__Elm__Prefs_ga47ee0cfc6e4dad8fb4fc1960c78a1b6b}{Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Changed\+\_\+\+Cb}) (Evas\+\_\+\+Object $\ast$it\+\_\+obj)
\begin{DoxyCompactList}\small\item\em Elementary prefs\textquotesingle{} item widget changed function signature. \end{DoxyCompactList}\item 
typedef enum \hyperlink{group__Elm__Prefs_ga1cc357f952ededa3d8743bb9bedc2549}{\+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type} \hyperlink{group__Elm__Prefs_ga1b10884ca8cd0b3626f437aad775e2f5}{Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type}
\begin{DoxyCompactList}\small\item\em Elm Prefs item types. \end{DoxyCompactList}\item 
typedef struct \+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Data \hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data}
\begin{DoxyCompactList}\small\item\em An Elm Prefs Data handle. \end{DoxyCompactList}\item 
typedef struct \+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Changed \hyperlink{group__Elm__Prefs_gac195106489391e7d3d46d4b81636539e}{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Changed}
\begin{DoxyCompactList}\small\item\em An Elm Prefs \hyperlink{group__Elm__Prefs_ggaed08ad6911d81c2bfb37200d2fada377a2d063dae5719dca11f5f458042e2bfca}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+I\+T\+E\+M\+\_\+\+C\+H\+A\+N\+G\+ED} event info data blob. \end{DoxyCompactList}\end{DoxyCompactItemize}
\subsection*{Enumerations}
\begin{DoxyCompactItemize}
\item 
enum \hyperlink{group__Elm__Prefs_ga15d0fab20f5ec2f85fd628c25e5b62e0}{Elm\+\_\+\+Prefs\+\_\+\+Reset\+\_\+\+Mode} \{ \newline
\hyperlink{group__Elm__Prefs_gga15d0fab20f5ec2f85fd628c25e5b62e0aaf5d2a29c537b4cecd2dad2d0e24ff1f}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+R\+E\+S\+E\+T\+\_\+\+D\+E\+F\+A\+U\+L\+TS}, 
\newline
\hyperlink{group__Elm__Prefs_gga15d0fab20f5ec2f85fd628c25e5b62e0a640734919e7d972320bb2a69e93ea2f0}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+R\+E\+S\+E\+T\+\_\+\+L\+A\+ST}
 \}\begin{DoxyCompactList}\small\item\em Modes of resetting a prefs widget. \end{DoxyCompactList}
\item 
enum \hyperlink{group__Elm__Prefs_ga1cc357f952ededa3d8743bb9bedc2549}{\+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type} \{ , \newline
\hyperlink{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549a07b1f0d5b50d3781183c0c103ae7acab}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+B\+O\+OL}, 
\newline
\hyperlink{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549ad23bb8b0c88eded9dacbf4dc05f6de25}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+I\+NT}, 
\newline
\hyperlink{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549a77c2dd8eea761daf46746ec242b482e5}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+F\+L\+O\+AT}, 
\newline
\hyperlink{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549a3ccecbd12d4cade7240bf652b138f886}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+L\+A\+B\+EL}, 
\newline
\hyperlink{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549afb2780bf92c67498d5cdb3cd043d5ed3}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+D\+A\+TE}, 
\newline
\hyperlink{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549a801e093061e4015ebb268c3966642cc7}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+T\+E\+XT}, 
\newline
\hyperlink{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549ae60e813e630393efdb1264bd2c6f6064}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+T\+E\+X\+T\+A\+R\+EA}, 
\newline
\hyperlink{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549af2737ebd1cdc0152aea2fc5c977cb778}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+P\+A\+GE}, 
\newline
\hyperlink{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549a88c65a578f1bee5a1daf952b32db32ed}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+R\+E\+S\+ET}, 
\newline
\hyperlink{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549aed45e66469b4d9176edaac3c2d6693f9}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+A\+VE}, 
\newline
\hyperlink{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549acbef5c7a2fbdb5e7243e58856238efcb}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+E\+P\+A\+R\+A\+T\+OR}, 
\newline
\hyperlink{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549a366003fb4c850653b296769b9de04e31}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+W\+A\+L\+L\+OW}
 \}\begin{DoxyCompactList}\small\item\em Elm Prefs item types. \end{DoxyCompactList}
\item 
enum \hyperlink{group__Elm__Prefs_gaed08ad6911d81c2bfb37200d2fada377}{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Type} \{ , \newline
\hyperlink{group__Elm__Prefs_ggaed08ad6911d81c2bfb37200d2fada377a2d063dae5719dca11f5f458042e2bfca}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+I\+T\+E\+M\+\_\+\+C\+H\+A\+N\+G\+ED}, 
\newline
\hyperlink{group__Elm__Prefs_ggaed08ad6911d81c2bfb37200d2fada377a99414132275037683257dc257407f72c}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+L\+A\+ST}
 \}\begin{DoxyCompactList}\small\item\em Types of events a given prefs data handle may issue. \end{DoxyCompactList}
\end{DoxyCompactItemize}
\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
E\+O\+A\+PI Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_ga8758d173b841d9e3d7652b14120d73a7}{elm\+\_\+obj\+\_\+prefs\+\_\+data\+\_\+set} (\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$data)
\begin{DoxyCompactList}\small\item\em Set user data for a given prefs widget. \end{DoxyCompactList}\item 
E\+O\+A\+PI \hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$ \hyperlink{group__Elm__Prefs_ga655edea20ec6d9314ab8f8273cff187d}{elm\+\_\+obj\+\_\+prefs\+\_\+data\+\_\+get} (void)
\begin{DoxyCompactList}\small\item\em Set user data for a given prefs widget. \end{DoxyCompactList}\item 
E\+O\+A\+PI void \hyperlink{group__Elm__Prefs_ga45d22111f8a6980bd8c422d084c9b7ca}{elm\+\_\+obj\+\_\+prefs\+\_\+autosave\+\_\+set} (Eina\+\_\+\+Bool autosave)
\begin{DoxyCompactList}\small\item\em Control whether a given prefs widget should save its values back (on the user data file, if set) automatically on every UI element changes. \end{DoxyCompactList}\item 
E\+O\+A\+PI Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_ga3bb08a02153ee2950e071d60af0ef752}{elm\+\_\+obj\+\_\+prefs\+\_\+autosave\+\_\+get} (void)
\begin{DoxyCompactList}\small\item\em Control whether a given prefs widget should save its values back (on the user data file, if set) automatically on every UI element changes. \end{DoxyCompactList}\item 
E\+O\+A\+PI void \hyperlink{group__Elm__Prefs_gaaa43890c0d465d51087569330801a1bb}{elm\+\_\+obj\+\_\+prefs\+\_\+reset} (\hyperlink{group__Elm__Prefs_ga15d0fab20f5ec2f85fd628c25e5b62e0}{Elm\+\_\+\+Prefs\+\_\+\+Reset\+\_\+\+Mode} mode)
\begin{DoxyCompactList}\small\item\em Reset the values of a given prefs widget to a previous state. \end{DoxyCompactList}\item 
E\+O\+A\+PI Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_ga5f7fa008248fcf98c2ff2e1f0a1711b7}{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set} (const char $\ast$name, const Eina\+\_\+\+Value $\ast$value)
\begin{DoxyCompactList}\small\item\em Set the value on a given prefs widget\textquotesingle{}s item. \end{DoxyCompactList}\item 
E\+O\+A\+PI Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_gad73155fb47d5ef1caac36f94bc03c2ac}{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+value\+\_\+get} (const char $\ast$name, Eina\+\_\+\+Value $\ast$value)
\begin{DoxyCompactList}\small\item\em Get the value of a given prefs widget\textquotesingle{}s item. \end{DoxyCompactList}\item 
E\+O\+A\+PI const Evas\+\_\+\+Object $\ast$ \hyperlink{group__Elm__Prefs_gaed85a599dde3a3da425a7b1c01bdc861}{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+object\+\_\+get} (const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Get the Elementary widget bound to a given prefs widget\textquotesingle{}s item. \end{DoxyCompactList}\item 
E\+O\+A\+PI void \hyperlink{group__Elm__Prefs_ga500e580dec675ecf34aba8041fe638df}{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+set} (const char $\ast$name, Eina\+\_\+\+Bool disabled)
\begin{DoxyCompactList}\small\item\em Set whether the widget bound to a given prefs widget\textquotesingle{}s item is disabled or not. \end{DoxyCompactList}\item 
E\+O\+A\+PI Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_ga7a81ad2e75ca86d57f65fb851cbc0300}{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+get} (const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Get whether the widget bound to a given prefs widget\textquotesingle{}s item is disabled or not. \end{DoxyCompactList}\item 
E\+O\+A\+PI Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_ga6b6bda358b28055bf3051ce14f1a21a5}{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+swallow} (const char $\ast$name, Evas\+\_\+\+Object $\ast$child)
\begin{DoxyCompactList}\small\item\em \char`\"{}\+Swallows\char`\"{} an object into a S\+W\+A\+L\+L\+OW item of a prefs widget. \end{DoxyCompactList}\item 
E\+O\+A\+PI void \hyperlink{group__Elm__Prefs_ga1bfdd021281a248031c8ebb591f170f8}{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+set} (const char $\ast$name, Eina\+\_\+\+Bool editable)
\begin{DoxyCompactList}\small\item\em Set whether the widget bound to a given prefs widget\textquotesingle{}s item is editable or not. \end{DoxyCompactList}\item 
E\+O\+A\+PI Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_ga95d0b4184bb6b9cbcf6d9f21ac3229db}{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+get} (const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Get whether the widget bound to a given prefs widget\textquotesingle{}s item is editable or not. \end{DoxyCompactList}\item 
E\+O\+A\+PI Evas\+\_\+\+Object $\ast$ \hyperlink{group__Elm__Prefs_ga5b6957fe5b2d7bd1f34ca2652dad4993}{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+unswallow} (const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Unswallow an object from a S\+W\+A\+L\+L\+OW item of a prefs widget. \end{DoxyCompactList}\item 
E\+O\+A\+PI void \hyperlink{group__Elm__Prefs_gaad772fecf7ed9d798f9abdd35499e842}{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+set} (const char $\ast$name, Eina\+\_\+\+Bool visible)
\begin{DoxyCompactList}\small\item\em Set whether the widget bound to given prefs widget\textquotesingle{}s item should be visible or not. \end{DoxyCompactList}\item 
E\+O\+A\+PI Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_gaf0026ade56dd6cb1bfea21d56d815da8}{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+get} (const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Get whether the widget bound to a given prefs widget\textquotesingle{}s item is visible or not. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_ga0f8265b17c3ba8a0cead439ada991fe2}{elm\+\_\+prefs\+\_\+data\+\_\+set} (Elm\+\_\+\+Prefs $\ast$obj, \hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$data)
\begin{DoxyCompactList}\small\item\em Set user data for a given prefs widget. \end{DoxyCompactList}\item 
\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$ \hyperlink{group__Elm__Prefs_gae43d20852f4e15f49b71c837c0e32c32}{elm\+\_\+prefs\+\_\+data\+\_\+get} (const Elm\+\_\+\+Prefs $\ast$obj)
\begin{DoxyCompactList}\small\item\em Set user data for a given prefs widget. \end{DoxyCompactList}\item 
void \hyperlink{group__Elm__Prefs_ga647d0d59b675cd302ca3bbd76a7c9c84}{elm\+\_\+prefs\+\_\+autosave\+\_\+set} (Elm\+\_\+\+Prefs $\ast$obj, Eina\+\_\+\+Bool autosave)
\begin{DoxyCompactList}\small\item\em Control whether a given prefs widget should save its values back (on the user data file, if set) automatically on every UI element changes. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_ga908b3b3a7fcf188c00732a53fa414c09}{elm\+\_\+prefs\+\_\+autosave\+\_\+get} (const Elm\+\_\+\+Prefs $\ast$obj)
\begin{DoxyCompactList}\small\item\em Control whether a given prefs widget should save its values back (on the user data file, if set) automatically on every UI element changes. \end{DoxyCompactList}\item 
void \hyperlink{group__Elm__Prefs_ga7ea163672578b75174eccc016903fd98}{elm\+\_\+prefs\+\_\+reset} (Elm\+\_\+\+Prefs $\ast$obj, \hyperlink{group__Elm__Prefs_ga15d0fab20f5ec2f85fd628c25e5b62e0}{Elm\+\_\+\+Prefs\+\_\+\+Reset\+\_\+\+Mode} mode)
\begin{DoxyCompactList}\small\item\em Reset the values of a given prefs widget to a previous state. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_ga2f7eda4e6d18f9dba4d8939492db1ad0}{elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set} (Elm\+\_\+\+Prefs $\ast$obj, const char $\ast$name, const Eina\+\_\+\+Value $\ast$value)
\begin{DoxyCompactList}\small\item\em Set the value on a given prefs widget\textquotesingle{}s item. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_gafac54e900317874a1bdd46405fdfd6fd}{elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+get} (const Elm\+\_\+\+Prefs $\ast$obj, const char $\ast$name, Eina\+\_\+\+Value $\ast$value)
\begin{DoxyCompactList}\small\item\em Get the value of a given prefs widget\textquotesingle{}s item. \end{DoxyCompactList}\item 
const Evas\+\_\+\+Object $\ast$ \hyperlink{group__Elm__Prefs_ga2d39a06a2456eb2c16949996c0f3d9f9}{elm\+\_\+prefs\+\_\+item\+\_\+object\+\_\+get} (Elm\+\_\+\+Prefs $\ast$obj, const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Get the Elementary widget bound to a given prefs widget\textquotesingle{}s item. \end{DoxyCompactList}\item 
void \hyperlink{group__Elm__Prefs_ga69016b9b4d4056daa484399bd81e3901}{elm\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+set} (Elm\+\_\+\+Prefs $\ast$obj, const char $\ast$name, Eina\+\_\+\+Bool disabled)
\begin{DoxyCompactList}\small\item\em Set whether the widget bound to a given prefs widget\textquotesingle{}s item is disabled or not. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_gae419ce29ff424f9fe734703b42b9119e}{elm\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+get} (const Elm\+\_\+\+Prefs $\ast$obj, const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Get whether the widget bound to a given prefs widget\textquotesingle{}s item is disabled or not. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_gace138f2e0e4d0b7a789a683d83033e27}{elm\+\_\+prefs\+\_\+item\+\_\+swallow} (Elm\+\_\+\+Prefs $\ast$obj, const char $\ast$name, Evas\+\_\+\+Object $\ast$child)
\begin{DoxyCompactList}\small\item\em \char`\"{}\+Swallows\char`\"{} an object into a S\+W\+A\+L\+L\+OW item of a prefs widget. \end{DoxyCompactList}\item 
void \hyperlink{group__Elm__Prefs_ga9a187b4783ee17049e0c08d10c5fc95c}{elm\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+set} (Elm\+\_\+\+Prefs $\ast$obj, const char $\ast$name, Eina\+\_\+\+Bool editable)
\begin{DoxyCompactList}\small\item\em Set whether the widget bound to a given prefs widget\textquotesingle{}s item is editable or not. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_ga601b6e0543289bb592cf3748ed83f13f}{elm\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+get} (const Elm\+\_\+\+Prefs $\ast$obj, const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Get whether the widget bound to a given prefs widget\textquotesingle{}s item is editable or not. \end{DoxyCompactList}\item 
Evas\+\_\+\+Object $\ast$ \hyperlink{group__Elm__Prefs_ga0905c04e1d826b95c34ebbac13bc8f17}{elm\+\_\+prefs\+\_\+item\+\_\+unswallow} (Elm\+\_\+\+Prefs $\ast$obj, const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Unswallow an object from a S\+W\+A\+L\+L\+OW item of a prefs widget. \end{DoxyCompactList}\item 
void \hyperlink{group__Elm__Prefs_gaf025c4a0d6d5fb9a39634f5b7da915b5}{elm\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+set} (Elm\+\_\+\+Prefs $\ast$obj, const char $\ast$name, Eina\+\_\+\+Bool visible)
\begin{DoxyCompactList}\small\item\em Set whether the widget bound to given prefs widget\textquotesingle{}s item should be visible or not. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_ga18244d071c11db73dc73755a89ef74c5}{elm\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+get} (const Elm\+\_\+\+Prefs $\ast$obj, const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Get whether the widget bound to a given prefs widget\textquotesingle{}s item is visible or not. \end{DoxyCompactList}\item 
Evas\+\_\+\+Object $\ast$ \hyperlink{group__Elm__Prefs_ga6736d5f9363dd7acbcb39938668b3e45}{elm\+\_\+prefs\+\_\+add} (Evas\+\_\+\+Object $\ast$parent)
\begin{DoxyCompactList}\small\item\em Add a new prefs widget. \end{DoxyCompactList}\item 
void \hyperlink{group__Elm__Prefs_gae7fab97e239ccdb719d6eae0ee3fd5c0}{elm\+\_\+prefs\+\_\+item\+\_\+iface\+\_\+register} (const \hyperlink{struct__Elm__Prefs__Item__Iface__Info}{Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Iface\+\_\+\+Info} $\ast$array)
\begin{DoxyCompactList}\small\item\em Mass-\/register widgets implementing prefs {\bfseries items} interfaces. \end{DoxyCompactList}\item 
void \hyperlink{group__Elm__Prefs_ga7dbd06fad8e44bc6143b5a637ab4f899}{elm\+\_\+prefs\+\_\+item\+\_\+iface\+\_\+unregister} (const \hyperlink{struct__Elm__Prefs__Item__Iface__Info}{Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Iface\+\_\+\+Info} $\ast$array)
\begin{DoxyCompactList}\small\item\em Mass-\/unregister widgets implementing prefs {\bfseries items} interfaces. \end{DoxyCompactList}\item 
void \hyperlink{group__Elm__Prefs_gad2390b92c0d279545f78ff7224560949}{elm\+\_\+prefs\+\_\+page\+\_\+iface\+\_\+register} (const \hyperlink{struct__Elm__Prefs__Page__Iface__Info}{Elm\+\_\+\+Prefs\+\_\+\+Page\+\_\+\+Iface\+\_\+\+Info} $\ast$array)
\begin{DoxyCompactList}\small\item\em Mass-\/register widgets implementing prefs {\bfseries pages} interfaces. \end{DoxyCompactList}\item 
void \hyperlink{group__Elm__Prefs_ga3e005848ad4cbfc19e4fcc2c34ecbebe}{elm\+\_\+prefs\+\_\+page\+\_\+iface\+\_\+unregister} (const \hyperlink{struct__Elm__Prefs__Page__Iface__Info}{Elm\+\_\+\+Prefs\+\_\+\+Page\+\_\+\+Iface\+\_\+\+Info} $\ast$array)
\begin{DoxyCompactList}\small\item\em Mass-\/unregister widgets implementing prefs {\bfseries pages} interfaces. \end{DoxyCompactList}\item 
\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$ \hyperlink{group__Elm__Prefs_ga58895cf0ae0fd70db018fbe8eb7ba5c2}{elm\+\_\+prefs\+\_\+data\+\_\+new} (const char $\ast$data\+\_\+file, const char $\ast$key, Eet\+\_\+\+File\+\_\+\+Mode mode)
\begin{DoxyCompactList}\small\item\em Create a new prefs data handle. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_gab0c465a39f83015f99e4cca9c66b39f2}{elm\+\_\+prefs\+\_\+data\+\_\+version\+\_\+set} (\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$prefs\+\_\+data, unsigned int version)
\begin{DoxyCompactList}\small\item\em Set the version field of a given prefs data handle. \end{DoxyCompactList}\item 
unsigned int \hyperlink{group__Elm__Prefs_gadd1b60b4af2e2937883bf0fff751fd78}{elm\+\_\+prefs\+\_\+data\+\_\+version\+\_\+get} (const \hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$prefs\+\_\+data)
\begin{DoxyCompactList}\small\item\em Get the version field of a given prefs data handle. \end{DoxyCompactList}\item 
\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$ \hyperlink{group__Elm__Prefs_gae3ce2f210698699a376d3fd6a9c3d327}{elm\+\_\+prefs\+\_\+data\+\_\+ref} (\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$prefs\+\_\+data)
\begin{DoxyCompactList}\small\item\em Increment reference count on a given prefs data handle. \end{DoxyCompactList}\item 
void \hyperlink{group__Elm__Prefs_ga6a6905e5914a263a4e0195bae6c0b37d}{elm\+\_\+prefs\+\_\+data\+\_\+unref} (\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$prefs\+\_\+data)
\begin{DoxyCompactList}\small\item\em Decrement reference count on a given prefs data handle. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_gaae2c2d085d8c0e9d6c24ff580807a54e}{elm\+\_\+prefs\+\_\+data\+\_\+value\+\_\+set} (\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$prefs\+\_\+data, const char $\ast$path, const \hyperlink{group__Elm__Prefs_ga1b10884ca8cd0b3626f437aad775e2f5}{Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type} type, const Eina\+\_\+\+Value $\ast$value)
\begin{DoxyCompactList}\small\item\em Set (or delete) one value of a given prefs data handle. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_ga2b692083e7d307512858f1adc2563519}{elm\+\_\+prefs\+\_\+data\+\_\+value\+\_\+get} (const \hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$prefs\+\_\+data, const char $\ast$path, \hyperlink{group__Elm__Prefs_ga1b10884ca8cd0b3626f437aad775e2f5}{Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type} $\ast$type, Eina\+\_\+\+Value $\ast$value)
\begin{DoxyCompactList}\small\item\em Get one value of a given prefs data handle (by key). \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_ga2435876857d1a36d379e23040e389172}{elm\+\_\+prefs\+\_\+data\+\_\+event\+\_\+callback\+\_\+add} (\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$prefs\+\_\+data, \hyperlink{group__Elm__Prefs_gaed08ad6911d81c2bfb37200d2fada377}{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Type} type, Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Cb cb, const void $\ast$cb\+\_\+data)
\begin{DoxyCompactList}\small\item\em Register a callback for one of the prefs data events. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_gafeffd07fade957a5c92e217e4436de99}{elm\+\_\+prefs\+\_\+data\+\_\+event\+\_\+callback\+\_\+del} (\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$prefs\+\_\+data, \hyperlink{group__Elm__Prefs_gaed08ad6911d81c2bfb37200d2fada377}{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Type} type, Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Cb cb, const void $\ast$cb\+\_\+data)
\begin{DoxyCompactList}\small\item\em Unregister a callback for one of the prefs data events. \end{DoxyCompactList}\item 
void \hyperlink{group__Elm__Prefs_ga8f845185f5505ac07369e89c5d2abcad}{elm\+\_\+prefs\+\_\+data\+\_\+autosave\+\_\+set} (\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$prefs\+\_\+data, Eina\+\_\+\+Bool autosave)
\begin{DoxyCompactList}\small\item\em Set whether a given elm prefs data handle should save its values back automatically on changes. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_ga92e6caef11911cc461959c545f7397d6}{elm\+\_\+prefs\+\_\+data\+\_\+autosave\+\_\+get} (const \hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$prefs\+\_\+data)
\begin{DoxyCompactList}\small\item\em Get whether a given elm prefs data handle is saving its values back automatically on changes. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_ga8e1e70c36f02027d6446c6188b9f954e}{elm\+\_\+prefs\+\_\+data\+\_\+save} (const \hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$prefs\+\_\+data, const char $\ast$file, const char $\ast$key)
\begin{DoxyCompactList}\small\item\em Save, manually, a given elm prefs data handle data back, on the given file and key. \end{DoxyCompactList}\end{DoxyCompactItemize}
\begin{DoxyCompactItemize}
\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_gaec5a0c4ea7f8e54909c5cdbc05e9b064}{elm\+\_\+prefs\+\_\+file\+\_\+set} (Eo $\ast$obj, const char $\ast$file, const char $\ast$page)
\begin{DoxyCompactList}\small\item\em Set file and page to populate a given prefs widget\textquotesingle{}s interface. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Elm__Prefs_gaa9220046adf093b046c2002c751c0501}{elm\+\_\+prefs\+\_\+file\+\_\+get} (const Eo $\ast$obj, const char $\ast$$\ast$file, const char $\ast$$\ast$page)
\begin{DoxyCompactList}\small\item\em Get file and page bound to a given prefs widget. \end{DoxyCompactList}\end{DoxyCompactItemize}


\subsection{Detailed Description}
Elementary provides a prefs (for \char`\"{}preferences\char`\"{}) infrastructure, which consists of two sets of A\+P\+Is\+: 


\begin{DoxyItemize}
\item prefs data and
\item prefs view.
\end{DoxyItemize}\hypertarget{group__Elm__Prefs_elm-prefs-data}{}\subsection{Prefs Data}\label{group__Elm__Prefs_elm-prefs-data}
Prefs data are simple key/value storage handles. One is able to set/get their values, which are {\ttfamily Eina\+\_\+\+Value} blobs (i.\+e. dynamically typed). You may also control the version of this data set, for updating purposes. Finally, you may register callbacks on changes on these data.

The main user of prefs data is the prefs {\bfseries widget}. After its creation, it\textquotesingle{}s bound to a given prefs data handle (if not, if gets its values from its definition file, which may have defaults). An elm prefs widget has its visuals defined by an {\ttfamily }.epb file, which is a compiled form of a {\ttfamily }.edc counterpart -- a textual definition much like Edje {\ttfamily }.edc files. On these files, one defines the values (items) a prefs widget hold, which translate to other Elementary widgets. In other words, it does the mapping between UI widgets into prefs data values, and it keeps the synchrony between its child widgets\textquotesingle{} states and their corresponding prefs data values.\hypertarget{group__Elm__Prefs_elm-prefs-widget}{}\subsection{Prefs}\label{group__Elm__Prefs_elm-prefs-widget}
 
\begin{DoxyImageNoCaption}
  \mbox{\includegraphics[width=\textwidth]{img/widget/prefs/preview-00}}
\end{DoxyImageNoCaption}


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


Prefs is a special widget inside Elementary. It is mainly targeted to configuration dialogs. Its viewport is blank until you associate a definition file to it. That file (usually with {\bfseries }.epb extension), is a binary format (Eet) one, coming from a human-\/readable textual declaration. This textual form, an {\bfseries Elementary prefs collection} (usually with {\bfseries }.epc extension), is translated to the binary form by means of the {\bfseries prefs\+\_\+cc} compiler.

On it one declares UI elements to populate prefs widgets, which are contained in {\bfseries pages} (a prefs widget is always bound to one page). Those elements get properties like\+:
\begin{DoxyItemize}
\item default value,
\item maximum and minimum ranges,
\item acceptance and denial regular expressions, for strings,
\item visibility,
\item persistence,
\item editability, etc.
\end{DoxyItemize}

Once a prefs widget is created, after \hyperlink{group__Elm__Prefs_gaec5a0c4ea7f8e54909c5cdbc05e9b064}{elm\+\_\+prefs\+\_\+file\+\_\+set()} is issued on it, all of its UI elements will get default values, declared on that file. To fetch an user\textquotesingle{}s own, personal set of those values, one gets to pair an {\bfseries \hyperlink{group__Elm__Prefs_elm-prefs-data}{Prefs Data}} handle to the prefs widget.

Personal, prefs data values with keys matching the ones present on the file passed on \hyperlink{group__Elm__Prefs_gaec5a0c4ea7f8e54909c5cdbc05e9b064}{elm\+\_\+prefs\+\_\+file\+\_\+set()} to will have their values applied to the respective UI elements of the widget.

When a prefs widget dies, the values of the elements declared on its {\bfseries }.epb file marked as permanent {\bfseries will be written back} to the user prefs data handle, if it is writable. One is also able to make this writing event to take place automatically after each UI element modification by using \hyperlink{group__Elm__Prefs_ga647d0d59b675cd302ca3bbd76a7c9c84}{elm\+\_\+prefs\+\_\+autosave\+\_\+set()}.

This widget emits the following signals\+:
\begin{DoxyItemize}
\item {\ttfamily \char`\"{}page,saved\char`\"{}}\+: a given page has had its values saved back on user config file (event info is the page\textquotesingle{}s name)
\item {\ttfamily \char`\"{}page,reset\char`\"{}}\+: a given page has had its values reset (event info is the page\textquotesingle{}s name)
\item {\ttfamily \char`\"{}page,changed\char`\"{}}\+: a given page has been loaded {\bfseries with user ({\ttfamily }.cfg) values} (event info is the page\textquotesingle{}s name)
\item {\ttfamily \char`\"{}page,loaded\char`\"{}}\+: a given page has been loaded {\bfseries with system ({\ttfamily }.epb) values} (event info is the page\textquotesingle{}s name)
\item {\ttfamily \char`\"{}item,changed\char`\"{}}\+: a given page\textquotesingle{}s item has changed (event info is the item\textquotesingle{}s full hierarchical name, in the form {\ttfamily \char`\"{}page\+:subpage\+:subsubpage\+:item\char`\"{}})
\item {\ttfamily \char`\"{}action\char`\"{}}\+: an action item has been triggered (event info is the item\textquotesingle{}s full hierarchical name, in the form {\ttfamily \char`\"{}page\+:subpage\+:subsubpage\+:item\char`\"{}})
\end{DoxyItemize}

\begin{DoxyItemize}
\item \hyperlink{epcref}{Elementary Prefs Data Collection Reference}\end{DoxyItemize}
The following are examples on how to use prefs\+: \begin{DoxyItemize}
\item \hyperlink{prefs_example_01}{Prefs Example 01} \item \hyperlink{prefs_example_02}{Prefs Example 02} \item \hyperlink{prefs_example_03}{Prefs Example 03} \end{DoxyItemize}


\subsection{Typedef Documentation}
\mbox{\label{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}} 
\index{Elementary Prefs@{Elementary Prefs}!Elm\+\_\+\+Prefs\+\_\+\+Data@{Elm\+\_\+\+Prefs\+\_\+\+Data}}
\index{Elm\+\_\+\+Prefs\+\_\+\+Data@{Elm\+\_\+\+Prefs\+\_\+\+Data}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{Elm\+\_\+\+Prefs\+\_\+\+Data}{Elm\_Prefs\_Data}}
{\footnotesize\ttfamily \hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data}}



An Elm Prefs Data handle. 

\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\mbox{\label{group__Elm__Prefs_gac195106489391e7d3d46d4b81636539e}} 
\index{Elementary Prefs@{Elementary Prefs}!Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Changed@{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Changed}}
\index{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Changed@{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Changed}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Changed}{Elm\_Prefs\_Data\_Event\_Changed}}
{\footnotesize\ttfamily \hyperlink{group__Elm__Prefs_gac195106489391e7d3d46d4b81636539e}{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Changed}}



An Elm Prefs \hyperlink{group__Elm__Prefs_ggaed08ad6911d81c2bfb37200d2fada377a2d063dae5719dca11f5f458042e2bfca}{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+I\+T\+E\+M\+\_\+\+C\+H\+A\+N\+G\+ED} event info data blob. 

\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\mbox{\label{group__Elm__Prefs_ga1b10884ca8cd0b3626f437aad775e2f5}} 
\index{Elementary Prefs@{Elementary Prefs}!Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type@{Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type}}
\index{Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type@{Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type}{Elm\_Prefs\_Item\_Type}}
{\footnotesize\ttfamily typedef enum \hyperlink{group__Elm__Prefs_ga1cc357f952ededa3d8743bb9bedc2549}{\+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type}  \hyperlink{group__Elm__Prefs_ga1b10884ca8cd0b3626f437aad775e2f5}{Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type}}



Elm Prefs item types. 

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


\subsection{Enumeration Type Documentation}
\mbox{\label{group__Elm__Prefs_ga1cc357f952ededa3d8743bb9bedc2549}} 
\index{Elementary Prefs@{Elementary Prefs}!\+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type@{\+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type}}
\index{\+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type@{\+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{\+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type}{\_Elm\_Prefs\_Item\_Type}}
{\footnotesize\ttfamily enum \hyperlink{group__Elm__Prefs_ga1cc357f952ededa3d8743bb9bedc2549}{\+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type}}



Elm Prefs item types. 

\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\begin{DoxyEnumFields}{Enumerator}
\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+B\+O\+OL@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+B\+O\+OL}!Elementary Prefs@{Elementary Prefs}}\index{Elementary Prefs@{Elementary Prefs}!E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+B\+O\+OL@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+B\+O\+OL}}}\mbox{\label{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549a07b1f0d5b50d3781183c0c103ae7acab}} 
E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+B\+O\+OL&boolean type, bound to checkbox-\/like UI elements \\
\hline

\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+I\+NT@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+I\+NT}!Elementary Prefs@{Elementary Prefs}}\index{Elementary Prefs@{Elementary Prefs}!E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+I\+NT@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+I\+NT}}}\mbox{\label{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549ad23bb8b0c88eded9dacbf4dc05f6de25}} 
E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+I\+NT&integer type, bound to spinner-\/like UI elements \\
\hline

\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+F\+L\+O\+AT@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+F\+L\+O\+AT}!Elementary Prefs@{Elementary Prefs}}\index{Elementary Prefs@{Elementary Prefs}!E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+F\+L\+O\+AT@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+F\+L\+O\+AT}}}\mbox{\label{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549a77c2dd8eea761daf46746ec242b482e5}} 
E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+F\+L\+O\+AT&floating point type, bound to spinner-\/like UI elements \\
\hline

\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+L\+A\+B\+EL@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+L\+A\+B\+EL}!Elementary Prefs@{Elementary Prefs}}\index{Elementary Prefs@{Elementary Prefs}!E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+L\+A\+B\+EL@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+L\+A\+B\+EL}}}\mbox{\label{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549a3ccecbd12d4cade7240bf652b138f886}} 
E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+L\+A\+B\+EL&label type, bound to read-\/only, label UI elements \\
\hline

\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+D\+A\+TE@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+D\+A\+TE}!Elementary Prefs@{Elementary Prefs}}\index{Elementary Prefs@{Elementary Prefs}!E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+D\+A\+TE@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+D\+A\+TE}}}\mbox{\label{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549afb2780bf92c67498d5cdb3cd043d5ed3}} 
E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+D\+A\+TE&date type, bound to date selection UI elements \\
\hline

\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+T\+E\+XT@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+T\+E\+XT}!Elementary Prefs@{Elementary Prefs}}\index{Elementary Prefs@{Elementary Prefs}!E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+T\+E\+XT@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+T\+E\+XT}}}\mbox{\label{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549a801e093061e4015ebb268c3966642cc7}} 
E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+T\+E\+XT&text type, bound to single-\/line, text entry UI elements \\
\hline

\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+T\+E\+X\+T\+A\+R\+EA@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+T\+E\+X\+T\+A\+R\+EA}!Elementary Prefs@{Elementary Prefs}}\index{Elementary Prefs@{Elementary Prefs}!E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+T\+E\+X\+T\+A\+R\+EA@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+T\+E\+X\+T\+A\+R\+EA}}}\mbox{\label{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549ae60e813e630393efdb1264bd2c6f6064}} 
E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+T\+E\+X\+T\+A\+R\+EA&text area type, bound to multi-\/line, text entry UI elements \\
\hline

\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+P\+A\+GE@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+P\+A\+GE}!Elementary Prefs@{Elementary Prefs}}\index{Elementary Prefs@{Elementary Prefs}!E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+P\+A\+GE@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+P\+A\+GE}}}\mbox{\label{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549af2737ebd1cdc0152aea2fc5c977cb778}} 
E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+P\+A\+GE&page type, used to nest pages \\
\hline

\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+R\+E\+S\+ET@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+R\+E\+S\+ET}!Elementary Prefs@{Elementary Prefs}}\index{Elementary Prefs@{Elementary Prefs}!E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+R\+E\+S\+ET@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+R\+E\+S\+ET}}}\mbox{\label{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549a88c65a578f1bee5a1daf952b32db32ed}} 
E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+R\+E\+S\+ET&values resetting trigger type, bound to button-\/like UI elements \\
\hline

\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+A\+VE@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+A\+VE}!Elementary Prefs@{Elementary Prefs}}\index{Elementary Prefs@{Elementary Prefs}!E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+A\+VE@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+A\+VE}}}\mbox{\label{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549aed45e66469b4d9176edaac3c2d6693f9}} 
E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+A\+VE&saving trigger type, bound to button-\/like UI elements \\
\hline

\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+E\+P\+A\+R\+A\+T\+OR@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+E\+P\+A\+R\+A\+T\+OR}!Elementary Prefs@{Elementary Prefs}}\index{Elementary Prefs@{Elementary Prefs}!E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+E\+P\+A\+R\+A\+T\+OR@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+E\+P\+A\+R\+A\+T\+OR}}}\mbox{\label{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549acbef5c7a2fbdb5e7243e58856238efcb}} 
E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+E\+P\+A\+R\+A\+T\+OR&separator type, bound to separator-\/like UI elements \\
\hline

\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+W\+A\+L\+L\+OW@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+W\+A\+L\+L\+OW}!Elementary Prefs@{Elementary Prefs}}\index{Elementary Prefs@{Elementary Prefs}!E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+W\+A\+L\+L\+OW@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+W\+A\+L\+L\+OW}}}\mbox{\label{group__Elm__Prefs_gga1cc357f952ededa3d8743bb9bedc2549a366003fb4c850653b296769b9de04e31}} 
E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+S\+W\+A\+L\+L\+OW&swallow type, bound to an empty \textquotesingle{}spot\textquotesingle{} on the UI meant to receive and display external content \\
\hline

\end{DoxyEnumFields}
\mbox{\label{group__Elm__Prefs_gaed08ad6911d81c2bfb37200d2fada377}} 
\index{Elementary Prefs@{Elementary Prefs}!Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Type@{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Type}}
\index{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Type@{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Type}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Type}{Elm\_Prefs\_Data\_Event\_Type}}
{\footnotesize\ttfamily enum \hyperlink{group__Elm__Prefs_gaed08ad6911d81c2bfb37200d2fada377}{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Type}}



Types of events a given prefs data handle may issue. 

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Elm__Prefs_ga2435876857d1a36d379e23040e389172}{elm\+\_\+prefs\+\_\+data\+\_\+event\+\_\+callback\+\_\+add()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\begin{DoxyEnumFields}{Enumerator}
\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+I\+T\+E\+M\+\_\+\+C\+H\+A\+N\+G\+ED@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+I\+T\+E\+M\+\_\+\+C\+H\+A\+N\+G\+ED}!Elementary Prefs@{Elementary Prefs}}\index{Elementary Prefs@{Elementary Prefs}!E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+I\+T\+E\+M\+\_\+\+C\+H\+A\+N\+G\+ED@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+I\+T\+E\+M\+\_\+\+C\+H\+A\+N\+G\+ED}}}\mbox{\label{group__Elm__Prefs_ggaed08ad6911d81c2bfb37200d2fada377a2d063dae5719dca11f5f458042e2bfca}} 
E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+I\+T\+E\+M\+\_\+\+C\+H\+A\+N\+G\+ED&The group of values has been automatically saved (event info is the group\textquotesingle{}s name (key)) \\
\hline

\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+L\+A\+ST@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+L\+A\+ST}!Elementary Prefs@{Elementary Prefs}}\index{Elementary Prefs@{Elementary Prefs}!E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+L\+A\+ST@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+L\+A\+ST}}}\mbox{\label{group__Elm__Prefs_ggaed08ad6911d81c2bfb37200d2fada377a99414132275037683257dc257407f72c}} 
E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+L\+A\+ST&A given item (prefs data value) has been changed (event info is an \hyperlink{group__Elm__Prefs_gac195106489391e7d3d46d4b81636539e}{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Changed} pointer) sentinel value, don\textquotesingle{}t use it \\
\hline

\end{DoxyEnumFields}
\mbox{\label{group__Elm__Prefs_ga15d0fab20f5ec2f85fd628c25e5b62e0}} 
\index{Elementary Prefs@{Elementary Prefs}!Elm\+\_\+\+Prefs\+\_\+\+Reset\+\_\+\+Mode@{Elm\+\_\+\+Prefs\+\_\+\+Reset\+\_\+\+Mode}}
\index{Elm\+\_\+\+Prefs\+\_\+\+Reset\+\_\+\+Mode@{Elm\+\_\+\+Prefs\+\_\+\+Reset\+\_\+\+Mode}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{Elm\+\_\+\+Prefs\+\_\+\+Reset\+\_\+\+Mode}{Elm\_Prefs\_Reset\_Mode}}
{\footnotesize\ttfamily enum \hyperlink{group__Elm__Prefs_ga15d0fab20f5ec2f85fd628c25e5b62e0}{Elm\+\_\+\+Prefs\+\_\+\+Reset\+\_\+\+Mode}}



Modes of resetting a prefs widget. 

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Elm__Prefs_ga7ea163672578b75174eccc016903fd98}{elm\+\_\+prefs\+\_\+reset()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\begin{DoxyEnumFields}{Enumerator}
\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+R\+E\+S\+E\+T\+\_\+\+D\+E\+F\+A\+U\+L\+TS@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+R\+E\+S\+E\+T\+\_\+\+D\+E\+F\+A\+U\+L\+TS}!Elementary Prefs@{Elementary Prefs}}\index{Elementary Prefs@{Elementary Prefs}!E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+R\+E\+S\+E\+T\+\_\+\+D\+E\+F\+A\+U\+L\+TS@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+R\+E\+S\+E\+T\+\_\+\+D\+E\+F\+A\+U\+L\+TS}}}\mbox{\label{group__Elm__Prefs_gga15d0fab20f5ec2f85fd628c25e5b62e0aaf5d2a29c537b4cecd2dad2d0e24ff1f}} 
E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+R\+E\+S\+E\+T\+\_\+\+D\+E\+F\+A\+U\+L\+TS&reset to default values, declared in its {\bfseries }.epb file \\
\hline

\raisebox{\heightof{T}}[0pt][0pt]{\index{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+R\+E\+S\+E\+T\+\_\+\+L\+A\+ST@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+R\+E\+S\+E\+T\+\_\+\+L\+A\+ST}!Elementary Prefs@{Elementary Prefs}}\index{Elementary Prefs@{Elementary Prefs}!E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+R\+E\+S\+E\+T\+\_\+\+L\+A\+ST@{E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+R\+E\+S\+E\+T\+\_\+\+L\+A\+ST}}}\mbox{\label{group__Elm__Prefs_gga15d0fab20f5ec2f85fd628c25e5b62e0a640734919e7d972320bb2a69e93ea2f0}} 
E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+R\+E\+S\+E\+T\+\_\+\+L\+A\+ST&prefs will keep a small history of changes, so this resets back to last batch of changes on the UI elements. it does {\bfseries not} work on autosave mode \\
\hline

\end{DoxyEnumFields}


\subsection{Function Documentation}
\mbox{\label{group__Elm__Prefs_ga3bb08a02153ee2950e071d60af0ef752}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+obj\+\_\+prefs\+\_\+autosave\+\_\+get@{elm\+\_\+obj\+\_\+prefs\+\_\+autosave\+\_\+get}}
\index{elm\+\_\+obj\+\_\+prefs\+\_\+autosave\+\_\+get@{elm\+\_\+obj\+\_\+prefs\+\_\+autosave\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+obj\+\_\+prefs\+\_\+autosave\+\_\+get()}{elm\_obj\_prefs\_autosave\_get()}}
{\footnotesize\ttfamily E\+O\+A\+PI Eina\+\_\+\+Bool elm\+\_\+obj\+\_\+prefs\+\_\+autosave\+\_\+get (\begin{DoxyParamCaption}\item[{void}]{ }\end{DoxyParamCaption})}



Control whether a given prefs widget should save its values back (on the user data file, if set) automatically on every UI element changes. 

If {\ttfamily autosave} is {\ttfamily true}, every call to \hyperlink{group__Elm__Prefs_ga2f7eda4e6d18f9dba4d8939492db1ad0}{elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set()}, every Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Type.\+E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+I\+T\+E\+M\+\_\+\+C\+H\+A\+N\+G\+ED event coming for its prefs data and every UI element direct value changing will implicitly make the prefs values to be flushed back to it prefs data. If a prefs data handle with no writing permissions or no prefs data is set on {\ttfamily prefs}, naturally nothing will happen.

\begin{DoxyReturn}{Returns}
{\ttfamily true} to save automatically, {\ttfamily false} otherwise.
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


Referenced by elm\+\_\+prefs\+\_\+autosave\+\_\+get().

\mbox{\label{group__Elm__Prefs_ga45d22111f8a6980bd8c422d084c9b7ca}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+obj\+\_\+prefs\+\_\+autosave\+\_\+set@{elm\+\_\+obj\+\_\+prefs\+\_\+autosave\+\_\+set}}
\index{elm\+\_\+obj\+\_\+prefs\+\_\+autosave\+\_\+set@{elm\+\_\+obj\+\_\+prefs\+\_\+autosave\+\_\+set}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+obj\+\_\+prefs\+\_\+autosave\+\_\+set()}{elm\_obj\_prefs\_autosave\_set()}}
{\footnotesize\ttfamily E\+O\+A\+PI void elm\+\_\+obj\+\_\+prefs\+\_\+autosave\+\_\+set (\begin{DoxyParamCaption}\item[{Eina\+\_\+\+Bool}]{autosave }\end{DoxyParamCaption})}



Control whether a given prefs widget should save its values back (on the user data file, if set) automatically on every UI element changes. 

If {\ttfamily autosave} is {\ttfamily true}, every call to \hyperlink{group__Elm__Prefs_ga2f7eda4e6d18f9dba4d8939492db1ad0}{elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set()}, every Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Type.\+E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+I\+T\+E\+M\+\_\+\+C\+H\+A\+N\+G\+ED event coming for its prefs data and every UI element direct value changing will implicitly make the prefs values to be flushed back to it prefs data. If a prefs data handle with no writing permissions or no prefs data is set on {\ttfamily prefs}, naturally nothing will happen.


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em autosave} & {\ttfamily true} to save automatically, {\ttfamily false} otherwise.\\
\hline
\end{DoxyParams}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


Referenced by elm\+\_\+prefs\+\_\+autosave\+\_\+set().

\mbox{\label{group__Elm__Prefs_ga655edea20ec6d9314ab8f8273cff187d}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+obj\+\_\+prefs\+\_\+data\+\_\+get@{elm\+\_\+obj\+\_\+prefs\+\_\+data\+\_\+get}}
\index{elm\+\_\+obj\+\_\+prefs\+\_\+data\+\_\+get@{elm\+\_\+obj\+\_\+prefs\+\_\+data\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+obj\+\_\+prefs\+\_\+data\+\_\+get()}{elm\_obj\_prefs\_data\_get()}}
{\footnotesize\ttfamily E\+O\+A\+PI \hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data}$\ast$ elm\+\_\+obj\+\_\+prefs\+\_\+data\+\_\+get (\begin{DoxyParamCaption}\item[{void}]{ }\end{DoxyParamCaption})}



Set user data for a given prefs widget. 

Once a prefs widget is created, after \hyperlink{group__Elm__Prefs_gaec5a0c4ea7f8e54909c5cdbc05e9b064}{elm\+\_\+prefs\+\_\+file\+\_\+set()} is issued on it, all of its UI elements will get default values, when declared on that file. To fetch an user\textquotesingle{}s own, personal set of those values, one gets to pair a prefs data handle to the prefs widget. This is what this call is intended for.

Prefs data values from {\ttfamily prefs\+\_\+data} with keys matching the ones present on the file passed on \hyperlink{group__Elm__Prefs_gaec5a0c4ea7f8e54909c5cdbc05e9b064}{elm\+\_\+prefs\+\_\+file\+\_\+set()} to {\ttfamily obj} will have their values applied to the respective UI elements of the widget.

When {\ttfamily obj} dies, the values of the elements declared on its .epb file (the one set on \hyperlink{group__Elm__Prefs_gaec5a0c4ea7f8e54909c5cdbc05e9b064}{elm\+\_\+prefs\+\_\+file\+\_\+set()}) marked as permanent will be written back to prefs\+\_\+data, if it is writable. One is also able to make this writing event to take place automatically after each UI element modification by using \hyperlink{group__Elm__Prefs_ga647d0d59b675cd302ca3bbd76a7c9c84}{elm\+\_\+prefs\+\_\+autosave\+\_\+set()}.

\begin{DoxyNote}{Note}
{\ttfamily obj} will keep a reference of its own for {\ttfamily prefs\+\_\+data}, but you should still unreference it by yourself, after the widget is gone.
\end{DoxyNote}
\begin{DoxyReturn}{Returns}
A valid prefs\+\_\+data handle
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


Referenced by elm\+\_\+prefs\+\_\+data\+\_\+get().

\mbox{\label{group__Elm__Prefs_ga8758d173b841d9e3d7652b14120d73a7}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+obj\+\_\+prefs\+\_\+data\+\_\+set@{elm\+\_\+obj\+\_\+prefs\+\_\+data\+\_\+set}}
\index{elm\+\_\+obj\+\_\+prefs\+\_\+data\+\_\+set@{elm\+\_\+obj\+\_\+prefs\+\_\+data\+\_\+set}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+obj\+\_\+prefs\+\_\+data\+\_\+set()}{elm\_obj\_prefs\_data\_set()}}
{\footnotesize\ttfamily E\+O\+A\+PI Eina\+\_\+\+Bool elm\+\_\+obj\+\_\+prefs\+\_\+data\+\_\+set (\begin{DoxyParamCaption}\item[{\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$}]{data }\end{DoxyParamCaption})}



Set user data for a given prefs widget. 

Once a prefs widget is created, after \hyperlink{group__Elm__Prefs_gaec5a0c4ea7f8e54909c5cdbc05e9b064}{elm\+\_\+prefs\+\_\+file\+\_\+set()} is issued on it, all of its UI elements will get default values, when declared on that file. To fetch an user\textquotesingle{}s own, personal set of those values, one gets to pair a prefs data handle to the prefs widget. This is what this call is intended for.

Prefs data values from {\ttfamily prefs\+\_\+data} with keys matching the ones present on the file passed on \hyperlink{group__Elm__Prefs_gaec5a0c4ea7f8e54909c5cdbc05e9b064}{elm\+\_\+prefs\+\_\+file\+\_\+set()} to {\ttfamily obj} will have their values applied to the respective UI elements of the widget.

When {\ttfamily obj} dies, the values of the elements declared on its .epb file (the one set on \hyperlink{group__Elm__Prefs_gaec5a0c4ea7f8e54909c5cdbc05e9b064}{elm\+\_\+prefs\+\_\+file\+\_\+set()}) marked as permanent will be written back to prefs\+\_\+data, if it is writable. One is also able to make this writing event to take place automatically after each UI element modification by using \hyperlink{group__Elm__Prefs_ga647d0d59b675cd302ca3bbd76a7c9c84}{elm\+\_\+prefs\+\_\+autosave\+\_\+set()}.

\begin{DoxyNote}{Note}
{\ttfamily obj} will keep a reference of its own for {\ttfamily prefs\+\_\+data}, but you should still unreference it by yourself, after the widget is gone.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em data} & A valid prefs\+\_\+data handle\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily true}, on success, {\ttfamily false} otherwise
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


Referenced by elm\+\_\+prefs\+\_\+data\+\_\+set().

\mbox{\label{group__Elm__Prefs_ga7a81ad2e75ca86d57f65fb851cbc0300}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+get@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+get}}
\index{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+get@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+get()}{elm\_obj\_prefs\_item\_disabled\_get()}}
{\footnotesize\ttfamily E\+O\+A\+PI Eina\+\_\+\+Bool elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+get (\begin{DoxyParamCaption}\item[{const char $\ast$}]{name }\end{DoxyParamCaption})}



Get whether the widget bound to a given prefs widget\textquotesingle{}s item is disabled or not. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & The name of the item (as declared in the prefs collection) to get disabled state from\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily true}, if it is disabled, {\ttfamily false} otherwise
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


Referenced by elm\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+get().

\mbox{\label{group__Elm__Prefs_ga500e580dec675ecf34aba8041fe638df}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+set@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+set}}
\index{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+set@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+set}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+set()}{elm\_obj\_prefs\_item\_disabled\_set()}}
{\footnotesize\ttfamily E\+O\+A\+PI void elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+set (\begin{DoxyParamCaption}\item[{const char $\ast$}]{name,  }\item[{Eina\+\_\+\+Bool}]{disabled }\end{DoxyParamCaption})}



Set whether the widget bound to a given prefs widget\textquotesingle{}s item is disabled or not. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em disabled} & {\ttfamily true}, to make it disabled, {\ttfamily false} otherwise\\
\hline
\end{DoxyParams}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


Referenced by elm\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+set().

\mbox{\label{group__Elm__Prefs_ga95d0b4184bb6b9cbcf6d9f21ac3229db}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+get@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+get}}
\index{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+get@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+get()}{elm\_obj\_prefs\_item\_editable\_get()}}
{\footnotesize\ttfamily E\+O\+A\+PI Eina\+\_\+\+Bool elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+get (\begin{DoxyParamCaption}\item[{const char $\ast$}]{name }\end{DoxyParamCaption})}



Get whether the widget bound to a given prefs widget\textquotesingle{}s item is editable or not. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & The name of the item (as declared in the prefs collection) to get editable state from\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily true}, if it is editable, {\ttfamily false} otherwise
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


Referenced by elm\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+get().

\mbox{\label{group__Elm__Prefs_ga1bfdd021281a248031c8ebb591f170f8}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+set@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+set}}
\index{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+set@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+set}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+set()}{elm\_obj\_prefs\_item\_editable\_set()}}
{\footnotesize\ttfamily E\+O\+A\+PI void elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+set (\begin{DoxyParamCaption}\item[{const char $\ast$}]{name,  }\item[{Eina\+\_\+\+Bool}]{editable }\end{DoxyParamCaption})}



Set whether the widget bound to a given prefs widget\textquotesingle{}s item is editable or not. 

\begin{DoxyNote}{Note}
Only {\ttfamily T\+E\+XT} or {\ttfamily T\+E\+X\+T\+A\+R\+EA} items\textquotesingle{} default widgets implement the \textquotesingle{}editable\textquotesingle{} property. Custom registered widgets may as well implement them.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em editable} & {\ttfamily true}, to make it editable, {\ttfamily false} otherwise\\
\hline
\end{DoxyParams}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


Referenced by elm\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+set().

\mbox{\label{group__Elm__Prefs_gaed85a599dde3a3da425a7b1c01bdc861}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+object\+\_\+get@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+object\+\_\+get}}
\index{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+object\+\_\+get@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+object\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+object\+\_\+get()}{elm\_obj\_prefs\_item\_object\_get()}}
{\footnotesize\ttfamily E\+O\+A\+PI const Evas\+\_\+\+Object$\ast$ elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+object\+\_\+get (\begin{DoxyParamCaption}\item[{const char $\ast$}]{name }\end{DoxyParamCaption})}



Get the Elementary widget bound to a given prefs widget\textquotesingle{}s item. 

This will retrieve a handle to the real widget implementing a given item of {\ttfamily prefs}, {\bfseries for read-\/only} actions.

\begin{DoxyWarning}{Warning}
You should never modify the state of the returned widget, because it\textquotesingle{}s meant to be managed by {\ttfamily prefs}, solely.
\end{DoxyWarning}

\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & The name of the item (as declared in the prefs collection) to get object from\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
A valid widget handle, on success, or {\ttfamily N\+U\+LL}, otherwise
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


Referenced by elm\+\_\+prefs\+\_\+item\+\_\+object\+\_\+get().

\mbox{\label{group__Elm__Prefs_ga6b6bda358b28055bf3051ce14f1a21a5}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+swallow@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+swallow}}
\index{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+swallow@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+swallow}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+swallow()}{elm\_obj\_prefs\_item\_swallow()}}
{\footnotesize\ttfamily E\+O\+A\+PI Eina\+\_\+\+Bool elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+swallow (\begin{DoxyParamCaption}\item[{const char $\ast$}]{name,  }\item[{Evas\+\_\+\+Object $\ast$}]{child }\end{DoxyParamCaption})}



\char`\"{}\+Swallows\char`\"{} an object into a S\+W\+A\+L\+L\+OW item of a prefs widget. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em child} & The object to occupy the item\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily true}, on success, {\ttfamily false} otherwise
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


Referenced by elm\+\_\+prefs\+\_\+item\+\_\+swallow().

\mbox{\label{group__Elm__Prefs_ga5b6957fe5b2d7bd1f34ca2652dad4993}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+unswallow@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+unswallow}}
\index{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+unswallow@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+unswallow}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+unswallow()}{elm\_obj\_prefs\_item\_unswallow()}}
{\footnotesize\ttfamily E\+O\+A\+PI Evas\+\_\+\+Object$\ast$ elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+unswallow (\begin{DoxyParamCaption}\item[{const char $\ast$}]{name }\end{DoxyParamCaption})}



Unswallow an object from a S\+W\+A\+L\+L\+OW item of a prefs widget. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & the name of the S\+W\+A\+L\+L\+OW item (as declared in the prefs collection)\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The unswallowed object, or N\+U\+LL on errors
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


Referenced by elm\+\_\+prefs\+\_\+item\+\_\+unswallow().

\mbox{\label{group__Elm__Prefs_gad73155fb47d5ef1caac36f94bc03c2ac}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+value\+\_\+get@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+value\+\_\+get}}
\index{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+value\+\_\+get@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+value\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+value\+\_\+get()}{elm\_obj\_prefs\_item\_value\_get()}}
{\footnotesize\ttfamily E\+O\+A\+PI Eina\+\_\+\+Bool elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+value\+\_\+get (\begin{DoxyParamCaption}\item[{const char $\ast$}]{name,  }\item[{Eina\+\_\+\+Value $\ast$}]{value }\end{DoxyParamCaption})}



Get the value of a given prefs widget\textquotesingle{}s item. 

This will retrieve the value of item named {\ttfamily name}.


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt out}  & {\em value} & Where to store the value of the item. It will be overwritten and setup with the type the item is bound to\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily true}, on success, {\ttfamily false} otherwise
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


Referenced by elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+get().

\mbox{\label{group__Elm__Prefs_ga5f7fa008248fcf98c2ff2e1f0a1711b7}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set}}
\index{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set()}{elm\_obj\_prefs\_item\_value\_set()}}
{\footnotesize\ttfamily E\+O\+A\+PI Eina\+\_\+\+Bool elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set (\begin{DoxyParamCaption}\item[{const char $\ast$}]{name,  }\item[{const Eina\+\_\+\+Value $\ast$}]{value }\end{DoxyParamCaption})}



Set the value on a given prefs widget\textquotesingle{}s item. 

This will change the value of item named {\ttfamily name} programatically.


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em value} & The value to set on the item. It should be typed as the item expects, preferably, or a conversion will take place\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily true}, on success, {\ttfamily false} otherwise
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


Referenced by elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set().

\mbox{\label{group__Elm__Prefs_gaf0026ade56dd6cb1bfea21d56d815da8}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+get@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+get}}
\index{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+get@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+get()}{elm\_obj\_prefs\_item\_visible\_get()}}
{\footnotesize\ttfamily E\+O\+A\+PI Eina\+\_\+\+Bool elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+get (\begin{DoxyParamCaption}\item[{const char $\ast$}]{name }\end{DoxyParamCaption})}



Get whether the widget bound to a given prefs widget\textquotesingle{}s item is visible or not. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & The name of the item (as declared in the prefs collection) to get visibility state from\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily true}, if it is visible, {\ttfamily false} otherwise
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


Referenced by elm\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+get().

\mbox{\label{group__Elm__Prefs_gaad772fecf7ed9d798f9abdd35499e842}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+set@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+set}}
\index{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+set@{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+set}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+set()}{elm\_obj\_prefs\_item\_visible\_set()}}
{\footnotesize\ttfamily E\+O\+A\+PI void elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+set (\begin{DoxyParamCaption}\item[{const char $\ast$}]{name,  }\item[{Eina\+\_\+\+Bool}]{visible }\end{DoxyParamCaption})}



Set whether the widget bound to given prefs widget\textquotesingle{}s item should be visible or not. 

Each prefs item may have a default visibility state, declared on the \$.epb {\ttfamily prefs} it was loaded with. By this call one may alter that state, programatically.


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em visible} & {\ttfamily true}, to make it visible, {\ttfamily false} otherwise\\
\hline
\end{DoxyParams}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


Referenced by elm\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+set().

\mbox{\label{group__Elm__Prefs_gaaa43890c0d465d51087569330801a1bb}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+obj\+\_\+prefs\+\_\+reset@{elm\+\_\+obj\+\_\+prefs\+\_\+reset}}
\index{elm\+\_\+obj\+\_\+prefs\+\_\+reset@{elm\+\_\+obj\+\_\+prefs\+\_\+reset}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+obj\+\_\+prefs\+\_\+reset()}{elm\_obj\_prefs\_reset()}}
{\footnotesize\ttfamily E\+O\+A\+PI void elm\+\_\+obj\+\_\+prefs\+\_\+reset (\begin{DoxyParamCaption}\item[{\hyperlink{group__Elm__Prefs_ga15d0fab20f5ec2f85fd628c25e5b62e0}{Elm\+\_\+\+Prefs\+\_\+\+Reset\+\_\+\+Mode}}]{mode }\end{DoxyParamCaption})}



Reset the values of a given prefs widget to a previous state. 

As can be seen on \hyperlink{group__Elm__Prefs_ga15d0fab20f5ec2f85fd628c25e5b62e0}{Elm\+\_\+\+Prefs\+\_\+\+Reset\+\_\+\+Mode}, there are two possible actions to be taken by this call -- either to reset {\ttfamily prefs\textquotesingle{}} values to the defaults (declared on the \$.epb file it is bound to) or to reset to the state they were before the last modification it got.


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em mode} & The reset mode to apply on {\ttfamily prefs} \\
\hline
\end{DoxyParams}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


Referenced by elm\+\_\+prefs\+\_\+reset().

\mbox{\label{group__Elm__Prefs_ga6736d5f9363dd7acbcb39938668b3e45}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+add@{elm\+\_\+prefs\+\_\+add}}
\index{elm\+\_\+prefs\+\_\+add@{elm\+\_\+prefs\+\_\+add}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+add()}{elm\_prefs\_add()}}
{\footnotesize\ttfamily Evas\+\_\+\+Object$\ast$ elm\+\_\+prefs\+\_\+add (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Object $\ast$}]{parent }\end{DoxyParamCaption})}



Add a new prefs widget. 


\begin{DoxyParams}{Parameters}
{\em parent} & The parent widget to hold the new one \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The new object or {\ttfamily N\+U\+LL}, on errors
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\mbox{\label{group__Elm__Prefs_ga908b3b3a7fcf188c00732a53fa414c09}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+autosave\+\_\+get@{elm\+\_\+prefs\+\_\+autosave\+\_\+get}}
\index{elm\+\_\+prefs\+\_\+autosave\+\_\+get@{elm\+\_\+prefs\+\_\+autosave\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+autosave\+\_\+get()}{elm\_prefs\_autosave\_get()}}
{\footnotesize\ttfamily Eina\+\_\+\+Bool elm\+\_\+prefs\+\_\+autosave\+\_\+get (\begin{DoxyParamCaption}\item[{const Elm\+\_\+\+Prefs $\ast$}]{obj }\end{DoxyParamCaption})}



Control whether a given prefs widget should save its values back (on the user data file, if set) automatically on every UI element changes. 

If {\ttfamily autosave} is {\ttfamily true}, every call to \hyperlink{group__Elm__Prefs_ga2f7eda4e6d18f9dba4d8939492db1ad0}{elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set()}, every Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Type.\+E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+I\+T\+E\+M\+\_\+\+C\+H\+A\+N\+G\+ED event coming for its prefs data and every UI element direct value changing will implicitly make the prefs values to be flushed back to it prefs data. If a prefs data handle with no writing permissions or no prefs data is set on {\ttfamily prefs}, naturally nothing will happen.

\begin{DoxyReturn}{Returns}
{\ttfamily true} to save automatically, {\ttfamily false} otherwise.
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References elm\+\_\+obj\+\_\+prefs\+\_\+autosave\+\_\+get().

\mbox{\label{group__Elm__Prefs_ga647d0d59b675cd302ca3bbd76a7c9c84}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+autosave\+\_\+set@{elm\+\_\+prefs\+\_\+autosave\+\_\+set}}
\index{elm\+\_\+prefs\+\_\+autosave\+\_\+set@{elm\+\_\+prefs\+\_\+autosave\+\_\+set}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+autosave\+\_\+set()}{elm\_prefs\_autosave\_set()}}
{\footnotesize\ttfamily void elm\+\_\+prefs\+\_\+autosave\+\_\+set (\begin{DoxyParamCaption}\item[{Elm\+\_\+\+Prefs $\ast$}]{obj,  }\item[{Eina\+\_\+\+Bool}]{autosave }\end{DoxyParamCaption})}



Control whether a given prefs widget should save its values back (on the user data file, if set) automatically on every UI element changes. 

If {\ttfamily autosave} is {\ttfamily true}, every call to \hyperlink{group__Elm__Prefs_ga2f7eda4e6d18f9dba4d8939492db1ad0}{elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set()}, every Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Type.\+E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+I\+T\+E\+M\+\_\+\+C\+H\+A\+N\+G\+ED event coming for its prefs data and every UI element direct value changing will implicitly make the prefs values to be flushed back to it prefs data. If a prefs data handle with no writing permissions or no prefs data is set on {\ttfamily prefs}, naturally nothing will happen.


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em autosave} & {\ttfamily true} to save automatically, {\ttfamily false} otherwise.\\
\hline
\end{DoxyParams}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References elm\+\_\+obj\+\_\+prefs\+\_\+autosave\+\_\+set().

\mbox{\label{group__Elm__Prefs_ga92e6caef11911cc461959c545f7397d6}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+data\+\_\+autosave\+\_\+get@{elm\+\_\+prefs\+\_\+data\+\_\+autosave\+\_\+get}}
\index{elm\+\_\+prefs\+\_\+data\+\_\+autosave\+\_\+get@{elm\+\_\+prefs\+\_\+data\+\_\+autosave\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+data\+\_\+autosave\+\_\+get()}{elm\_prefs\_data\_autosave\_get()}}
{\footnotesize\ttfamily Eina\+\_\+\+Bool elm\+\_\+prefs\+\_\+data\+\_\+autosave\+\_\+get (\begin{DoxyParamCaption}\item[{const \hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$}]{prefs\+\_\+data }\end{DoxyParamCaption})}



Get whether a given elm prefs data handle is saving its values back automatically on changes. 


\begin{DoxyParams}{Parameters}
{\em prefs\+\_\+data} & A valid prefs data handle \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE} if {\itshape prefs\+\_\+data} is saving automatically, {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} otherwise.
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Elm__Prefs_ga8f845185f5505ac07369e89c5d2abcad}{elm\+\_\+prefs\+\_\+data\+\_\+autosave\+\_\+set()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\mbox{\label{group__Elm__Prefs_ga8f845185f5505ac07369e89c5d2abcad}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+data\+\_\+autosave\+\_\+set@{elm\+\_\+prefs\+\_\+data\+\_\+autosave\+\_\+set}}
\index{elm\+\_\+prefs\+\_\+data\+\_\+autosave\+\_\+set@{elm\+\_\+prefs\+\_\+data\+\_\+autosave\+\_\+set}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+data\+\_\+autosave\+\_\+set()}{elm\_prefs\_data\_autosave\_set()}}
{\footnotesize\ttfamily void elm\+\_\+prefs\+\_\+data\+\_\+autosave\+\_\+set (\begin{DoxyParamCaption}\item[{\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$}]{prefs\+\_\+data,  }\item[{Eina\+\_\+\+Bool}]{autosave }\end{DoxyParamCaption})}



Set whether a given elm prefs data handle should save its values back automatically on changes. 


\begin{DoxyParams}{Parameters}
{\em prefs\+\_\+data} & A valid prefs data handle \\
\hline
{\em autosave} & {\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE} to save automatically, {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} otherwise.\\
\hline
\end{DoxyParams}
If {\itshape autosave} is {\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE}, every call to \hyperlink{group__Elm__Prefs_gaae2c2d085d8c0e9d6c24ff580807a54e}{elm\+\_\+prefs\+\_\+data\+\_\+value\+\_\+set()} will implicitly issue \hyperlink{group__Elm__Prefs_ga8e1e70c36f02027d6446c6188b9f954e}{elm\+\_\+prefs\+\_\+data\+\_\+save()} too.

\begin{DoxyWarning}{Warning}
This call will do nothing if {\itshape prefs\+\_\+data} was created with mode E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+AD -- auto saving will be always disabled in this mode, as it can\textquotesingle{}t write back.
\end{DoxyWarning}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Elm__Prefs_ga92e6caef11911cc461959c545f7397d6}{elm\+\_\+prefs\+\_\+data\+\_\+autosave\+\_\+get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\mbox{\label{group__Elm__Prefs_ga2435876857d1a36d379e23040e389172}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+data\+\_\+event\+\_\+callback\+\_\+add@{elm\+\_\+prefs\+\_\+data\+\_\+event\+\_\+callback\+\_\+add}}
\index{elm\+\_\+prefs\+\_\+data\+\_\+event\+\_\+callback\+\_\+add@{elm\+\_\+prefs\+\_\+data\+\_\+event\+\_\+callback\+\_\+add}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+data\+\_\+event\+\_\+callback\+\_\+add()}{elm\_prefs\_data\_event\_callback\_add()}}
{\footnotesize\ttfamily Eina\+\_\+\+Bool elm\+\_\+prefs\+\_\+data\+\_\+event\+\_\+callback\+\_\+add (\begin{DoxyParamCaption}\item[{\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$}]{prefs\+\_\+data,  }\item[{\hyperlink{group__Elm__Prefs_gaed08ad6911d81c2bfb37200d2fada377}{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Type}}]{type,  }\item[{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Cb}]{cb,  }\item[{const void $\ast$}]{cb\+\_\+data }\end{DoxyParamCaption})}



Register a callback for one of the prefs data events. 


\begin{DoxyParams}{Parameters}
{\em prefs\+\_\+data} & A valid prefs data handle \\
\hline
{\em type} & The type of event to register to \\
\hline
{\em cb} & The callback function to issue on this event \\
\hline
{\em cb\+\_\+data} & The data pointer to pass to {\itshape cb} on this event \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE} on success, {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} otherwise
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Elm__Prefs_gaed08ad6911d81c2bfb37200d2fada377}{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Type} for more details on the events. 

\hyperlink{group__Elm__Prefs_gafeffd07fade957a5c92e217e4436de99}{elm\+\_\+prefs\+\_\+data\+\_\+event\+\_\+callback\+\_\+del()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\mbox{\label{group__Elm__Prefs_gafeffd07fade957a5c92e217e4436de99}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+data\+\_\+event\+\_\+callback\+\_\+del@{elm\+\_\+prefs\+\_\+data\+\_\+event\+\_\+callback\+\_\+del}}
\index{elm\+\_\+prefs\+\_\+data\+\_\+event\+\_\+callback\+\_\+del@{elm\+\_\+prefs\+\_\+data\+\_\+event\+\_\+callback\+\_\+del}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+data\+\_\+event\+\_\+callback\+\_\+del()}{elm\_prefs\_data\_event\_callback\_del()}}
{\footnotesize\ttfamily Eina\+\_\+\+Bool elm\+\_\+prefs\+\_\+data\+\_\+event\+\_\+callback\+\_\+del (\begin{DoxyParamCaption}\item[{\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$}]{prefs\+\_\+data,  }\item[{\hyperlink{group__Elm__Prefs_gaed08ad6911d81c2bfb37200d2fada377}{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Type}}]{type,  }\item[{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Cb}]{cb,  }\item[{const void $\ast$}]{cb\+\_\+data }\end{DoxyParamCaption})}



Unregister a callback for one of the prefs data events. 


\begin{DoxyParams}{Parameters}
{\em prefs\+\_\+data} & A valid prefs data handle \\
\hline
{\em type} & The type of event to unregister \\
\hline
{\em cb} & The callback function being used to this event \\
\hline
{\em cb\+\_\+data} & The data pointer being passed to {\itshape cb} on this event \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE} on success, {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} otherwise
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Elm__Prefs_gaed08ad6911d81c2bfb37200d2fada377}{Elm\+\_\+\+Prefs\+\_\+\+Data\+\_\+\+Event\+\_\+\+Type} for more details on the events. 

\hyperlink{group__Elm__Prefs_ga2435876857d1a36d379e23040e389172}{elm\+\_\+prefs\+\_\+data\+\_\+event\+\_\+callback\+\_\+add()}
\end{DoxySeeAlso}
\begin{DoxyNote}{Note}
If a same event callback (with matching type, callback function and data pointers) was added more than once on {\itshape prefs\+\_\+data}, them same number of matching calls of this type have to issued to delete all them.
\end{DoxyNote}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\mbox{\label{group__Elm__Prefs_gae43d20852f4e15f49b71c837c0e32c32}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+data\+\_\+get@{elm\+\_\+prefs\+\_\+data\+\_\+get}}
\index{elm\+\_\+prefs\+\_\+data\+\_\+get@{elm\+\_\+prefs\+\_\+data\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+data\+\_\+get()}{elm\_prefs\_data\_get()}}
{\footnotesize\ttfamily \hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data}$\ast$ elm\+\_\+prefs\+\_\+data\+\_\+get (\begin{DoxyParamCaption}\item[{const Elm\+\_\+\+Prefs $\ast$}]{obj }\end{DoxyParamCaption})}



Set user data for a given prefs widget. 

Once a prefs widget is created, after \hyperlink{group__Elm__Prefs_gaec5a0c4ea7f8e54909c5cdbc05e9b064}{elm\+\_\+prefs\+\_\+file\+\_\+set()} is issued on it, all of its UI elements will get default values, when declared on that file. To fetch an user\textquotesingle{}s own, personal set of those values, one gets to pair a prefs data handle to the prefs widget. This is what this call is intended for.

Prefs data values from {\ttfamily prefs\+\_\+data} with keys matching the ones present on the file passed on \hyperlink{group__Elm__Prefs_gaec5a0c4ea7f8e54909c5cdbc05e9b064}{elm\+\_\+prefs\+\_\+file\+\_\+set()} to {\ttfamily obj} will have their values applied to the respective UI elements of the widget.

When {\ttfamily obj} dies, the values of the elements declared on its .epb file (the one set on \hyperlink{group__Elm__Prefs_gaec5a0c4ea7f8e54909c5cdbc05e9b064}{elm\+\_\+prefs\+\_\+file\+\_\+set()}) marked as permanent will be written back to prefs\+\_\+data, if it is writable. One is also able to make this writing event to take place automatically after each UI element modification by using \hyperlink{group__Elm__Prefs_ga647d0d59b675cd302ca3bbd76a7c9c84}{elm\+\_\+prefs\+\_\+autosave\+\_\+set()}.

\begin{DoxyNote}{Note}
{\ttfamily obj} will keep a reference of its own for {\ttfamily prefs\+\_\+data}, but you should still unreference it by yourself, after the widget is gone.
\end{DoxyNote}
\begin{DoxyReturn}{Returns}
A valid prefs\+\_\+data handle
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References elm\+\_\+obj\+\_\+prefs\+\_\+data\+\_\+get().

\mbox{\label{group__Elm__Prefs_ga58895cf0ae0fd70db018fbe8eb7ba5c2}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+data\+\_\+new@{elm\+\_\+prefs\+\_\+data\+\_\+new}}
\index{elm\+\_\+prefs\+\_\+data\+\_\+new@{elm\+\_\+prefs\+\_\+data\+\_\+new}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+data\+\_\+new()}{elm\_prefs\_data\_new()}}
{\footnotesize\ttfamily \hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data}$\ast$ elm\+\_\+prefs\+\_\+data\+\_\+new (\begin{DoxyParamCaption}\item[{const char $\ast$}]{data\+\_\+file,  }\item[{const char $\ast$}]{key,  }\item[{Eet\+\_\+\+File\+\_\+\+Mode}]{mode }\end{DoxyParamCaption})}



Create a new prefs data handle. 


\begin{DoxyParams}{Parameters}
{\em data\+\_\+file} & The (user) file where to read data from \\
\hline
{\em key} & The key where the data is stored under \\
\hline
{\em mode} & The mode of access to the given file \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
A new prefs data handle
\end{DoxyReturn}
If {\itshape data\+\_\+file} is {\ttfamily N\+U\+LL}, efreet\+\_\+config\+\_\+home\+\_\+get()/$<$appname$>$/preferences.cfg will be used, by default. If {\itshape key} is {\ttfamily N\+U\+LL}, it is considered a default key -- \char`\"{}main\char`\"{}.

If {\itshape mode} is {\ttfamily E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+R\+E\+AD}, autosave will be always false for this elm\+\_\+prefs\+\_\+data handle. If {\itshape mode} is {\ttfamily E\+E\+T\+\_\+\+F\+I\+L\+E\+\_\+\+M\+O\+D\+E\+\_\+\+W\+R\+I\+TE}, than {\itshape data\+\_\+file} {\bfseries won\textquotesingle{}t} be read, but just written to.

\begin{DoxyNote}{Note}
An elm prefs data handle starts with a reference count of {\bfseries 1} (see \hyperlink{group__Elm__Prefs_gae3ce2f210698699a376d3fd6a9c3d327}{elm\+\_\+prefs\+\_\+data\+\_\+ref()}). Use \hyperlink{group__Elm__Prefs_ga6a6905e5914a263a4e0195bae6c0b37d}{elm\+\_\+prefs\+\_\+data\+\_\+unref()} to delete it.
\end{DoxyNote}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\mbox{\label{group__Elm__Prefs_gae3ce2f210698699a376d3fd6a9c3d327}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+data\+\_\+ref@{elm\+\_\+prefs\+\_\+data\+\_\+ref}}
\index{elm\+\_\+prefs\+\_\+data\+\_\+ref@{elm\+\_\+prefs\+\_\+data\+\_\+ref}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+data\+\_\+ref()}{elm\_prefs\_data\_ref()}}
{\footnotesize\ttfamily \hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data}$\ast$ elm\+\_\+prefs\+\_\+data\+\_\+ref (\begin{DoxyParamCaption}\item[{\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$}]{prefs\+\_\+data }\end{DoxyParamCaption})}



Increment reference count on a given prefs data handle. 


\begin{DoxyParams}{Parameters}
{\em prefs\+\_\+data} & A valid prefs data handle \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The same prefs data handle, {\itshape prefs\+\_\+data} 
\end{DoxyReturn}
This increments the reference count of {\itshape by} 1. Use this to pass the handle safely to contexts other than the creation one, for example. Only when the reference count on a prefs data handle reaches {\bfseries 0} (see \hyperlink{group__Elm__Prefs_ga6a6905e5914a263a4e0195bae6c0b37d}{elm\+\_\+prefs\+\_\+data\+\_\+unref()}) will it be deleted.

\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\mbox{\label{group__Elm__Prefs_ga8e1e70c36f02027d6446c6188b9f954e}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+data\+\_\+save@{elm\+\_\+prefs\+\_\+data\+\_\+save}}
\index{elm\+\_\+prefs\+\_\+data\+\_\+save@{elm\+\_\+prefs\+\_\+data\+\_\+save}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+data\+\_\+save()}{elm\_prefs\_data\_save()}}
{\footnotesize\ttfamily Eina\+\_\+\+Bool elm\+\_\+prefs\+\_\+data\+\_\+save (\begin{DoxyParamCaption}\item[{const \hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$}]{prefs\+\_\+data,  }\item[{const char $\ast$}]{file,  }\item[{const char $\ast$}]{key }\end{DoxyParamCaption})}



Save, manually, a given elm prefs data handle data back, on the given file and key. 


\begin{DoxyParams}{Parameters}
{\em prefs\+\_\+data} & A valid prefs data handle \\
\hline
{\em file} & The file (path) to save to ({\ttfamily N\+U\+LL} means same file as it was opened with) \\
\hline
{\em key} & The under which to save values ({\ttfamily N\+U\+LL} means the same key as it was opened with) \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE} on success, {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} otherwise.
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Elm__Prefs_ga8f845185f5505ac07369e89c5d2abcad}{elm\+\_\+prefs\+\_\+data\+\_\+autosave\+\_\+set()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\mbox{\label{group__Elm__Prefs_ga0f8265b17c3ba8a0cead439ada991fe2}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+data\+\_\+set@{elm\+\_\+prefs\+\_\+data\+\_\+set}}
\index{elm\+\_\+prefs\+\_\+data\+\_\+set@{elm\+\_\+prefs\+\_\+data\+\_\+set}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+data\+\_\+set()}{elm\_prefs\_data\_set()}}
{\footnotesize\ttfamily Eina\+\_\+\+Bool elm\+\_\+prefs\+\_\+data\+\_\+set (\begin{DoxyParamCaption}\item[{Elm\+\_\+\+Prefs $\ast$}]{obj,  }\item[{\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$}]{data }\end{DoxyParamCaption})}



Set user data for a given prefs widget. 

Once a prefs widget is created, after \hyperlink{group__Elm__Prefs_gaec5a0c4ea7f8e54909c5cdbc05e9b064}{elm\+\_\+prefs\+\_\+file\+\_\+set()} is issued on it, all of its UI elements will get default values, when declared on that file. To fetch an user\textquotesingle{}s own, personal set of those values, one gets to pair a prefs data handle to the prefs widget. This is what this call is intended for.

Prefs data values from {\ttfamily prefs\+\_\+data} with keys matching the ones present on the file passed on \hyperlink{group__Elm__Prefs_gaec5a0c4ea7f8e54909c5cdbc05e9b064}{elm\+\_\+prefs\+\_\+file\+\_\+set()} to {\ttfamily obj} will have their values applied to the respective UI elements of the widget.

When {\ttfamily obj} dies, the values of the elements declared on its .epb file (the one set on \hyperlink{group__Elm__Prefs_gaec5a0c4ea7f8e54909c5cdbc05e9b064}{elm\+\_\+prefs\+\_\+file\+\_\+set()}) marked as permanent will be written back to prefs\+\_\+data, if it is writable. One is also able to make this writing event to take place automatically after each UI element modification by using \hyperlink{group__Elm__Prefs_ga647d0d59b675cd302ca3bbd76a7c9c84}{elm\+\_\+prefs\+\_\+autosave\+\_\+set()}.

\begin{DoxyNote}{Note}
{\ttfamily obj} will keep a reference of its own for {\ttfamily prefs\+\_\+data}, but you should still unreference it by yourself, after the widget is gone.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em data} & A valid prefs\+\_\+data handle\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily true}, on success, {\ttfamily false} otherwise
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References elm\+\_\+obj\+\_\+prefs\+\_\+data\+\_\+set().

\mbox{\label{group__Elm__Prefs_ga6a6905e5914a263a4e0195bae6c0b37d}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+data\+\_\+unref@{elm\+\_\+prefs\+\_\+data\+\_\+unref}}
\index{elm\+\_\+prefs\+\_\+data\+\_\+unref@{elm\+\_\+prefs\+\_\+data\+\_\+unref}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+data\+\_\+unref()}{elm\_prefs\_data\_unref()}}
{\footnotesize\ttfamily void elm\+\_\+prefs\+\_\+data\+\_\+unref (\begin{DoxyParamCaption}\item[{\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$}]{prefs\+\_\+data }\end{DoxyParamCaption})}



Decrement reference count on a given prefs data handle. 


\begin{DoxyParams}{Parameters}
{\em prefs\+\_\+data} & A valid prefs data handle\\
\hline
\end{DoxyParams}
This decrements the reference count of {\itshape by} 1. When the reference count on {\itshape reach} {\bfseries 0}, it will it be deleted.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Elm__Prefs_gae3ce2f210698699a376d3fd6a9c3d327}{elm\+\_\+prefs\+\_\+data\+\_\+ref()} for more details.
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\mbox{\label{group__Elm__Prefs_ga2b692083e7d307512858f1adc2563519}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+data\+\_\+value\+\_\+get@{elm\+\_\+prefs\+\_\+data\+\_\+value\+\_\+get}}
\index{elm\+\_\+prefs\+\_\+data\+\_\+value\+\_\+get@{elm\+\_\+prefs\+\_\+data\+\_\+value\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+data\+\_\+value\+\_\+get()}{elm\_prefs\_data\_value\_get()}}
{\footnotesize\ttfamily Eina\+\_\+\+Bool elm\+\_\+prefs\+\_\+data\+\_\+value\+\_\+get (\begin{DoxyParamCaption}\item[{const \hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$}]{prefs\+\_\+data,  }\item[{const char $\ast$}]{path,  }\item[{\hyperlink{group__Elm__Prefs_ga1b10884ca8cd0b3626f437aad775e2f5}{Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type} $\ast$}]{type,  }\item[{Eina\+\_\+\+Value $\ast$}]{value }\end{DoxyParamCaption})}



Get one value of a given prefs data handle (by key). 


\begin{DoxyParams}{Parameters}
{\em prefs\+\_\+data} & A valid prefs data handle \\
\hline
{\em path} & The (unique) name (key) of the given value \\
\hline
{\em type} & The item type associated with the value \\
\hline
{\em value} & A valid {\ttfamily Eina\+\_\+\+Value} handle, where to store the value, itself. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE} on success, {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} otherwise
\end{DoxyReturn}
This will retrieve one of {\itshape }\textquotesingle{}s values, by name. The value itself will be written to {\itshape value}, which will be overriden.

\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\mbox{\label{group__Elm__Prefs_gaae2c2d085d8c0e9d6c24ff580807a54e}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+data\+\_\+value\+\_\+set@{elm\+\_\+prefs\+\_\+data\+\_\+value\+\_\+set}}
\index{elm\+\_\+prefs\+\_\+data\+\_\+value\+\_\+set@{elm\+\_\+prefs\+\_\+data\+\_\+value\+\_\+set}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+data\+\_\+value\+\_\+set()}{elm\_prefs\_data\_value\_set()}}
{\footnotesize\ttfamily Eina\+\_\+\+Bool elm\+\_\+prefs\+\_\+data\+\_\+value\+\_\+set (\begin{DoxyParamCaption}\item[{\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$}]{prefs\+\_\+data,  }\item[{const char $\ast$}]{path,  }\item[{const \hyperlink{group__Elm__Prefs_ga1b10884ca8cd0b3626f437aad775e2f5}{Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Type}}]{type,  }\item[{const Eina\+\_\+\+Value $\ast$}]{value }\end{DoxyParamCaption})}



Set (or delete) one value of a given prefs data handle. 


\begin{DoxyParams}{Parameters}
{\em prefs\+\_\+data} & A valid prefs data handle \\
\hline
{\em path} & The (unique) name (key) of the given value \\
\hline
{\em type} & The item type to which the value is to be associated \\
\hline
{\em value} & The value, itself. It must be a valid {\ttfamily Eina\+\_\+\+Value} handle, bound to a given type and value or {\ttfamily N\+U\+LL}. On the second case, the call will actually {\bfseries delete} the given key from {\itshape prefs\+\_\+data}. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE} on success, {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} otherwise
\end{DoxyReturn}
A prefs data handle holds a list of key/value entries. This will set one of {\itshape }\textquotesingle{}s values, by name. The value itself may be any valid and filled up {\ttfamily Eina\+\_\+\+Value} handle.

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


References E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+D\+A\+T\+A\+\_\+\+E\+V\+E\+N\+T\+\_\+\+I\+T\+E\+M\+\_\+\+C\+H\+A\+N\+G\+ED.

\mbox{\label{group__Elm__Prefs_gadd1b60b4af2e2937883bf0fff751fd78}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+data\+\_\+version\+\_\+get@{elm\+\_\+prefs\+\_\+data\+\_\+version\+\_\+get}}
\index{elm\+\_\+prefs\+\_\+data\+\_\+version\+\_\+get@{elm\+\_\+prefs\+\_\+data\+\_\+version\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+data\+\_\+version\+\_\+get()}{elm\_prefs\_data\_version\_get()}}
{\footnotesize\ttfamily unsigned int elm\+\_\+prefs\+\_\+data\+\_\+version\+\_\+get (\begin{DoxyParamCaption}\item[{const \hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$}]{prefs\+\_\+data }\end{DoxyParamCaption})}



Get the version field of a given prefs data handle. 


\begin{DoxyParams}{Parameters}
{\em prefs\+\_\+data} & A valid prefs data handle \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The version of {\itshape prefs\+\_\+data} or -\/1, on errors.
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Elm__Prefs_gab0c465a39f83015f99e4cca9c66b39f2}{elm\+\_\+prefs\+\_\+data\+\_\+version\+\_\+set()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References E\+L\+M\+\_\+\+P\+R\+E\+F\+S\+\_\+\+T\+Y\+P\+E\+\_\+\+P\+A\+GE.

\mbox{\label{group__Elm__Prefs_gab0c465a39f83015f99e4cca9c66b39f2}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+data\+\_\+version\+\_\+set@{elm\+\_\+prefs\+\_\+data\+\_\+version\+\_\+set}}
\index{elm\+\_\+prefs\+\_\+data\+\_\+version\+\_\+set@{elm\+\_\+prefs\+\_\+data\+\_\+version\+\_\+set}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+data\+\_\+version\+\_\+set()}{elm\_prefs\_data\_version\_set()}}
{\footnotesize\ttfamily Eina\+\_\+\+Bool elm\+\_\+prefs\+\_\+data\+\_\+version\+\_\+set (\begin{DoxyParamCaption}\item[{\hyperlink{group__Elm__Prefs_ga7e2cbea5a9696262669748533f578a53}{Elm\+\_\+\+Prefs\+\_\+\+Data} $\ast$}]{prefs\+\_\+data,  }\item[{unsigned int}]{version }\end{DoxyParamCaption})}



Set the version field of a given prefs data handle. 


\begin{DoxyParams}{Parameters}
{\em prefs\+\_\+data} & A valid prefs data handle \\
\hline
{\em version} & The version number \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE} on success, {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} otherwise
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Elm__Prefs_gadd1b60b4af2e2937883bf0fff751fd78}{elm\+\_\+prefs\+\_\+data\+\_\+version\+\_\+get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\mbox{\label{group__Elm__Prefs_gaa9220046adf093b046c2002c751c0501}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+file\+\_\+get@{elm\+\_\+prefs\+\_\+file\+\_\+get}}
\index{elm\+\_\+prefs\+\_\+file\+\_\+get@{elm\+\_\+prefs\+\_\+file\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+file\+\_\+get()}{elm\_prefs\_file\_get()}}
{\footnotesize\ttfamily Eina\+\_\+\+Bool elm\+\_\+prefs\+\_\+file\+\_\+get (\begin{DoxyParamCaption}\item[{const Eo $\ast$}]{obj,  }\item[{const char $\ast$$\ast$}]{file,  }\item[{const char $\ast$$\ast$}]{page }\end{DoxyParamCaption})}



Get file and page bound to a given prefs widget. 

\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE}, on success, {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} otherwise
\end{DoxyReturn}
\begin{DoxyNote}{Note}
Use {\ttfamily N\+U\+LL} pointers on the components you\textquotesingle{}re not interested in\+: they\textquotesingle{}ll be ignored by the function.
\end{DoxyNote}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Elm__Prefs_gaec5a0c4ea7f8e54909c5cdbc05e9b064}{elm\+\_\+prefs\+\_\+file\+\_\+set()} for more information
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+8
\end{DoxySince}

\begin{DoxyParams}[1]{Parameters}
\mbox{\tt out}  & {\em file} & The {\bfseries }.epb (binary) file to get contents from \\
\hline
\mbox{\tt out}  & {\em page} & The page, inside {\itshape file}, where to get item contents from \\
\hline
\end{DoxyParams}
\mbox{\label{group__Elm__Prefs_gaec5a0c4ea7f8e54909c5cdbc05e9b064}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+file\+\_\+set@{elm\+\_\+prefs\+\_\+file\+\_\+set}}
\index{elm\+\_\+prefs\+\_\+file\+\_\+set@{elm\+\_\+prefs\+\_\+file\+\_\+set}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+file\+\_\+set()}{elm\_prefs\_file\_set()}}
{\footnotesize\ttfamily Eina\+\_\+\+Bool elm\+\_\+prefs\+\_\+file\+\_\+set (\begin{DoxyParamCaption}\item[{Eo $\ast$}]{obj,  }\item[{const char $\ast$}]{file,  }\item[{const char $\ast$}]{page }\end{DoxyParamCaption})}



Set file and page to populate a given prefs widget\textquotesingle{}s interface. 

\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE}, on success, {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} otherwise
\end{DoxyReturn}
Elm prefs widgets start blank, with no child widgets. It\textquotesingle{}s meant to have its viewport populated with child elements coming from a declaration file. That file (usually with {\bfseries }.epb extension), is a binary format (Eet) one, coming from a human-\/readable textual declaration. This textual form (usually with {\bfseries }.epc extension) is translated to the binary form by means of the {\bfseries prefs\+\_\+cc} compiler.

With this function, one thus populates a prefs widget with UI elements.

If {\itshape file} is {\ttfamily N\+U\+LL}, \char`\"{}elm\+\_\+app\+\_\+data\+\_\+dir\+\_\+get()/preferences.\+epb\char`\"{} will be used, by default. If {\itshape file} is a {\bfseries relative} path, the prefix \char`\"{}elm\+\_\+app\+\_\+data\+\_\+dir\+\_\+get()/\char`\"{} will be implicitly used with it. If {\itshape page} is {\ttfamily N\+U\+LL}, it is considered \char`\"{}main\char`\"{}, as default.

\begin{DoxyWarning}{Warning}
If your binary is not properly installed and \hyperlink{group__Elm__App_ga92a09dbf88cc1ca3eab51c51dea589d0}{elm\+\_\+app\+\_\+data\+\_\+dir\+\_\+get()} can\textquotesingle{}t be figured out, a fallback value of \char`\"{}.\char`\"{} will be tryed, instead.
\end{DoxyWarning}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Elm__Prefs_gaa9220046adf093b046c2002c751c0501}{elm\+\_\+prefs\+\_\+file\+\_\+get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+8
\end{DoxySince}

\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em file} & The {\bfseries }.epb (binary) file to get contents from \\
\hline
\mbox{\tt in}  & {\em page} & The page, inside {\itshape file}, where to get item contents from \\
\hline
\end{DoxyParams}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{prefs_example_01_8c-example}{prefs\+\_\+example\+\_\+01.\+c}, \hyperlink{prefs_example_02_8c-example}{prefs\+\_\+example\+\_\+02.\+c}, and \hyperlink{prefs_example_03_8c-example}{prefs\+\_\+example\+\_\+03.\+c}.\end{Desc}
\mbox{\label{group__Elm__Prefs_gae419ce29ff424f9fe734703b42b9119e}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+get@{elm\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+get}}
\index{elm\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+get@{elm\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+get()}{elm\_prefs\_item\_disabled\_get()}}
{\footnotesize\ttfamily Eina\+\_\+\+Bool elm\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+get (\begin{DoxyParamCaption}\item[{const Elm\+\_\+\+Prefs $\ast$}]{obj,  }\item[{const char $\ast$}]{name }\end{DoxyParamCaption})}



Get whether the widget bound to a given prefs widget\textquotesingle{}s item is disabled or not. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & The name of the item (as declared in the prefs collection) to get disabled state from\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily true}, if it is disabled, {\ttfamily false} otherwise
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+get().

\mbox{\label{group__Elm__Prefs_ga69016b9b4d4056daa484399bd81e3901}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+set@{elm\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+set}}
\index{elm\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+set@{elm\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+set}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+set()}{elm\_prefs\_item\_disabled\_set()}}
{\footnotesize\ttfamily void elm\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+set (\begin{DoxyParamCaption}\item[{Elm\+\_\+\+Prefs $\ast$}]{obj,  }\item[{const char $\ast$}]{name,  }\item[{Eina\+\_\+\+Bool}]{disabled }\end{DoxyParamCaption})}



Set whether the widget bound to a given prefs widget\textquotesingle{}s item is disabled or not. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em disabled} & {\ttfamily true}, to make it disabled, {\ttfamily false} otherwise\\
\hline
\end{DoxyParams}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+disabled\+\_\+set().

\mbox{\label{group__Elm__Prefs_ga601b6e0543289bb592cf3748ed83f13f}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+get@{elm\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+get}}
\index{elm\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+get@{elm\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+get()}{elm\_prefs\_item\_editable\_get()}}
{\footnotesize\ttfamily Eina\+\_\+\+Bool elm\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+get (\begin{DoxyParamCaption}\item[{const Elm\+\_\+\+Prefs $\ast$}]{obj,  }\item[{const char $\ast$}]{name }\end{DoxyParamCaption})}



Get whether the widget bound to a given prefs widget\textquotesingle{}s item is editable or not. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & The name of the item (as declared in the prefs collection) to get editable state from\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily true}, if it is editable, {\ttfamily false} otherwise
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+get().

\mbox{\label{group__Elm__Prefs_ga9a187b4783ee17049e0c08d10c5fc95c}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+set@{elm\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+set}}
\index{elm\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+set@{elm\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+set}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+set()}{elm\_prefs\_item\_editable\_set()}}
{\footnotesize\ttfamily void elm\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+set (\begin{DoxyParamCaption}\item[{Elm\+\_\+\+Prefs $\ast$}]{obj,  }\item[{const char $\ast$}]{name,  }\item[{Eina\+\_\+\+Bool}]{editable }\end{DoxyParamCaption})}



Set whether the widget bound to a given prefs widget\textquotesingle{}s item is editable or not. 

\begin{DoxyNote}{Note}
Only {\ttfamily T\+E\+XT} or {\ttfamily T\+E\+X\+T\+A\+R\+EA} items\textquotesingle{} default widgets implement the \textquotesingle{}editable\textquotesingle{} property. Custom registered widgets may as well implement them.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em editable} & {\ttfamily true}, to make it editable, {\ttfamily false} otherwise\\
\hline
\end{DoxyParams}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+editable\+\_\+set().

\mbox{\label{group__Elm__Prefs_gae7fab97e239ccdb719d6eae0ee3fd5c0}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+item\+\_\+iface\+\_\+register@{elm\+\_\+prefs\+\_\+item\+\_\+iface\+\_\+register}}
\index{elm\+\_\+prefs\+\_\+item\+\_\+iface\+\_\+register@{elm\+\_\+prefs\+\_\+item\+\_\+iface\+\_\+register}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+item\+\_\+iface\+\_\+register()}{elm\_prefs\_item\_iface\_register()}}
{\footnotesize\ttfamily void elm\+\_\+prefs\+\_\+item\+\_\+iface\+\_\+register (\begin{DoxyParamCaption}\item[{const \hyperlink{struct__Elm__Prefs__Item__Iface__Info}{Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Iface\+\_\+\+Info} $\ast$}]{array }\end{DoxyParamCaption})}



Mass-\/register widgets implementing prefs {\bfseries items} interfaces. 


\begin{DoxyParams}{Parameters}
{\em array} & An array of \#\+Elm\+\_\+\+Prefs\+\_\+\+Iface\+\_\+\+Info structs, {\ttfamily N\+U\+LL} terminated.\\
\hline
\end{DoxyParams}
This will register all item interfaces declared on {\itshape array} in Elementary, so that the prefs widget will recognize them on {\ttfamily }.epc files {\ttfamily \textquotesingle{}widget\+:\textquotesingle{}} (item) declarations.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Elm__Prefs_ga7dbd06fad8e44bc6143b5a637ab4f899}{elm\+\_\+prefs\+\_\+item\+\_\+iface\+\_\+unregister()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References \+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Iface\+::abi\+\_\+version, \+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Iface\+\_\+\+Info\+::info, \+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Iface\+::types, and \+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Iface\+\_\+\+Info\+::widget\+\_\+name.

\mbox{\label{group__Elm__Prefs_ga7dbd06fad8e44bc6143b5a637ab4f899}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+item\+\_\+iface\+\_\+unregister@{elm\+\_\+prefs\+\_\+item\+\_\+iface\+\_\+unregister}}
\index{elm\+\_\+prefs\+\_\+item\+\_\+iface\+\_\+unregister@{elm\+\_\+prefs\+\_\+item\+\_\+iface\+\_\+unregister}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+item\+\_\+iface\+\_\+unregister()}{elm\_prefs\_item\_iface\_unregister()}}
{\footnotesize\ttfamily void elm\+\_\+prefs\+\_\+item\+\_\+iface\+\_\+unregister (\begin{DoxyParamCaption}\item[{const \hyperlink{struct__Elm__Prefs__Item__Iface__Info}{Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Iface\+\_\+\+Info} $\ast$}]{array }\end{DoxyParamCaption})}



Mass-\/unregister widgets implementing prefs {\bfseries items} interfaces. 


\begin{DoxyParams}{Parameters}
{\em array} & An array of \#\+Elm\+\_\+\+Prefs\+\_\+\+Iface\+\_\+\+Info structs, {\ttfamily N\+U\+LL} terminated.\\
\hline
\end{DoxyParams}
This will unregister all item interfaces declared on {\itshape array} in Elementary, given they had been previously registered.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Elm__Prefs_gae7fab97e239ccdb719d6eae0ee3fd5c0}{elm\+\_\+prefs\+\_\+item\+\_\+iface\+\_\+register()} for more details
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References \+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Iface\+\_\+\+Info\+::info, \+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Iface\+::types, and \+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Item\+\_\+\+Iface\+\_\+\+Info\+::widget\+\_\+name.

\mbox{\label{group__Elm__Prefs_ga2d39a06a2456eb2c16949996c0f3d9f9}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+item\+\_\+object\+\_\+get@{elm\+\_\+prefs\+\_\+item\+\_\+object\+\_\+get}}
\index{elm\+\_\+prefs\+\_\+item\+\_\+object\+\_\+get@{elm\+\_\+prefs\+\_\+item\+\_\+object\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+item\+\_\+object\+\_\+get()}{elm\_prefs\_item\_object\_get()}}
{\footnotesize\ttfamily const Evas\+\_\+\+Object$\ast$ elm\+\_\+prefs\+\_\+item\+\_\+object\+\_\+get (\begin{DoxyParamCaption}\item[{Elm\+\_\+\+Prefs $\ast$}]{obj,  }\item[{const char $\ast$}]{name }\end{DoxyParamCaption})}



Get the Elementary widget bound to a given prefs widget\textquotesingle{}s item. 

This will retrieve a handle to the real widget implementing a given item of {\ttfamily prefs}, {\bfseries for read-\/only} actions.

\begin{DoxyWarning}{Warning}
You should never modify the state of the returned widget, because it\textquotesingle{}s meant to be managed by {\ttfamily prefs}, solely.
\end{DoxyWarning}

\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & The name of the item (as declared in the prefs collection) to get object from\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
A valid widget handle, on success, or {\ttfamily N\+U\+LL}, otherwise
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+object\+\_\+get().

\mbox{\label{group__Elm__Prefs_gace138f2e0e4d0b7a789a683d83033e27}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+item\+\_\+swallow@{elm\+\_\+prefs\+\_\+item\+\_\+swallow}}
\index{elm\+\_\+prefs\+\_\+item\+\_\+swallow@{elm\+\_\+prefs\+\_\+item\+\_\+swallow}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+item\+\_\+swallow()}{elm\_prefs\_item\_swallow()}}
{\footnotesize\ttfamily Eina\+\_\+\+Bool elm\+\_\+prefs\+\_\+item\+\_\+swallow (\begin{DoxyParamCaption}\item[{Elm\+\_\+\+Prefs $\ast$}]{obj,  }\item[{const char $\ast$}]{name,  }\item[{Evas\+\_\+\+Object $\ast$}]{child }\end{DoxyParamCaption})}



\char`\"{}\+Swallows\char`\"{} an object into a S\+W\+A\+L\+L\+OW item of a prefs widget. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em child} & The object to occupy the item\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily true}, on success, {\ttfamily false} otherwise
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+swallow().

\mbox{\label{group__Elm__Prefs_ga0905c04e1d826b95c34ebbac13bc8f17}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+item\+\_\+unswallow@{elm\+\_\+prefs\+\_\+item\+\_\+unswallow}}
\index{elm\+\_\+prefs\+\_\+item\+\_\+unswallow@{elm\+\_\+prefs\+\_\+item\+\_\+unswallow}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+item\+\_\+unswallow()}{elm\_prefs\_item\_unswallow()}}
{\footnotesize\ttfamily Evas\+\_\+\+Object$\ast$ elm\+\_\+prefs\+\_\+item\+\_\+unswallow (\begin{DoxyParamCaption}\item[{Elm\+\_\+\+Prefs $\ast$}]{obj,  }\item[{const char $\ast$}]{name }\end{DoxyParamCaption})}



Unswallow an object from a S\+W\+A\+L\+L\+OW item of a prefs widget. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & the name of the S\+W\+A\+L\+L\+OW item (as declared in the prefs collection)\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The unswallowed object, or N\+U\+LL on errors
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+unswallow().

\mbox{\label{group__Elm__Prefs_gafac54e900317874a1bdd46405fdfd6fd}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+get@{elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+get}}
\index{elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+get@{elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+get()}{elm\_prefs\_item\_value\_get()}}
{\footnotesize\ttfamily Eina\+\_\+\+Bool elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+get (\begin{DoxyParamCaption}\item[{const Elm\+\_\+\+Prefs $\ast$}]{obj,  }\item[{const char $\ast$}]{name,  }\item[{Eina\+\_\+\+Value $\ast$}]{value }\end{DoxyParamCaption})}



Get the value of a given prefs widget\textquotesingle{}s item. 

This will retrieve the value of item named {\ttfamily name}.


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt out}  & {\em value} & Where to store the value of the item. It will be overwritten and setup with the type the item is bound to\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily true}, on success, {\ttfamily false} otherwise
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+value\+\_\+get().

\mbox{\label{group__Elm__Prefs_ga2f7eda4e6d18f9dba4d8939492db1ad0}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set@{elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set}}
\index{elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set@{elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set()}{elm\_prefs\_item\_value\_set()}}
{\footnotesize\ttfamily Eina\+\_\+\+Bool elm\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set (\begin{DoxyParamCaption}\item[{Elm\+\_\+\+Prefs $\ast$}]{obj,  }\item[{const char $\ast$}]{name,  }\item[{const Eina\+\_\+\+Value $\ast$}]{value }\end{DoxyParamCaption})}



Set the value on a given prefs widget\textquotesingle{}s item. 

This will change the value of item named {\ttfamily name} programatically.


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em value} & The value to set on the item. It should be typed as the item expects, preferably, or a conversion will take place\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily true}, on success, {\ttfamily false} otherwise
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+value\+\_\+set().

\mbox{\label{group__Elm__Prefs_ga18244d071c11db73dc73755a89ef74c5}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+get@{elm\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+get}}
\index{elm\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+get@{elm\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+get}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+get()}{elm\_prefs\_item\_visible\_get()}}
{\footnotesize\ttfamily Eina\+\_\+\+Bool elm\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+get (\begin{DoxyParamCaption}\item[{const Elm\+\_\+\+Prefs $\ast$}]{obj,  }\item[{const char $\ast$}]{name }\end{DoxyParamCaption})}



Get whether the widget bound to a given prefs widget\textquotesingle{}s item is visible or not. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & The name of the item (as declared in the prefs collection) to get visibility state from\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily true}, if it is visible, {\ttfamily false} otherwise
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+get().

\mbox{\label{group__Elm__Prefs_gaf025c4a0d6d5fb9a39634f5b7da915b5}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+set@{elm\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+set}}
\index{elm\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+set@{elm\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+set}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+set()}{elm\_prefs\_item\_visible\_set()}}
{\footnotesize\ttfamily void elm\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+set (\begin{DoxyParamCaption}\item[{Elm\+\_\+\+Prefs $\ast$}]{obj,  }\item[{const char $\ast$}]{name,  }\item[{Eina\+\_\+\+Bool}]{visible }\end{DoxyParamCaption})}



Set whether the widget bound to given prefs widget\textquotesingle{}s item should be visible or not. 

Each prefs item may have a default visibility state, declared on the \$.epb {\ttfamily prefs} it was loaded with. By this call one may alter that state, programatically.


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em visible} & {\ttfamily true}, to make it visible, {\ttfamily false} otherwise\\
\hline
\end{DoxyParams}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References elm\+\_\+obj\+\_\+prefs\+\_\+item\+\_\+visible\+\_\+set().

\mbox{\label{group__Elm__Prefs_gad2390b92c0d279545f78ff7224560949}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+page\+\_\+iface\+\_\+register@{elm\+\_\+prefs\+\_\+page\+\_\+iface\+\_\+register}}
\index{elm\+\_\+prefs\+\_\+page\+\_\+iface\+\_\+register@{elm\+\_\+prefs\+\_\+page\+\_\+iface\+\_\+register}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+page\+\_\+iface\+\_\+register()}{elm\_prefs\_page\_iface\_register()}}
{\footnotesize\ttfamily void elm\+\_\+prefs\+\_\+page\+\_\+iface\+\_\+register (\begin{DoxyParamCaption}\item[{const \hyperlink{struct__Elm__Prefs__Page__Iface__Info}{Elm\+\_\+\+Prefs\+\_\+\+Page\+\_\+\+Iface\+\_\+\+Info} $\ast$}]{array }\end{DoxyParamCaption})}



Mass-\/register widgets implementing prefs {\bfseries pages} interfaces. 


\begin{DoxyParams}{Parameters}
{\em array} & An array of \#\+Elm\+\_\+\+Prefs\+\_\+\+Iface\+\_\+\+Info structs, {\ttfamily N\+U\+LL} terminated.\\
\hline
\end{DoxyParams}
This will register all page interfaces declared on {\itshape array} in Elementary, so that the prefs widget will recognize them on {\ttfamily }.epc files {\ttfamily \textquotesingle{}widget\+:\textquotesingle{}} (page) declarations.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Elm__Prefs_ga3e005848ad4cbfc19e4fcc2c34ecbebe}{elm\+\_\+prefs\+\_\+page\+\_\+iface\+\_\+unregister()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References \+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Page\+\_\+\+Iface\+::abi\+\_\+version, \+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Page\+\_\+\+Iface\+\_\+\+Info\+::info, and \+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Page\+\_\+\+Iface\+\_\+\+Info\+::widget\+\_\+name.

\mbox{\label{group__Elm__Prefs_ga3e005848ad4cbfc19e4fcc2c34ecbebe}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+page\+\_\+iface\+\_\+unregister@{elm\+\_\+prefs\+\_\+page\+\_\+iface\+\_\+unregister}}
\index{elm\+\_\+prefs\+\_\+page\+\_\+iface\+\_\+unregister@{elm\+\_\+prefs\+\_\+page\+\_\+iface\+\_\+unregister}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+page\+\_\+iface\+\_\+unregister()}{elm\_prefs\_page\_iface\_unregister()}}
{\footnotesize\ttfamily void elm\+\_\+prefs\+\_\+page\+\_\+iface\+\_\+unregister (\begin{DoxyParamCaption}\item[{const \hyperlink{struct__Elm__Prefs__Page__Iface__Info}{Elm\+\_\+\+Prefs\+\_\+\+Page\+\_\+\+Iface\+\_\+\+Info} $\ast$}]{array }\end{DoxyParamCaption})}



Mass-\/unregister widgets implementing prefs {\bfseries pages} interfaces. 


\begin{DoxyParams}{Parameters}
{\em array} & An array of \#\+Elm\+\_\+\+Prefs\+\_\+\+Iface\+\_\+\+Info structs, {\ttfamily N\+U\+LL} terminated.\\
\hline
\end{DoxyParams}
This will unregister all page interfaces declared on {\itshape array} in Elementary, given they had been previously registered.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Elm__Prefs_gad2390b92c0d279545f78ff7224560949}{elm\+\_\+prefs\+\_\+page\+\_\+iface\+\_\+register()} for more details
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References \+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Page\+\_\+\+Iface\+\_\+\+Info\+::info, and \+\_\+\+Elm\+\_\+\+Prefs\+\_\+\+Page\+\_\+\+Iface\+\_\+\+Info\+::widget\+\_\+name.

\mbox{\label{group__Elm__Prefs_ga7ea163672578b75174eccc016903fd98}} 
\index{Elementary Prefs@{Elementary Prefs}!elm\+\_\+prefs\+\_\+reset@{elm\+\_\+prefs\+\_\+reset}}
\index{elm\+\_\+prefs\+\_\+reset@{elm\+\_\+prefs\+\_\+reset}!Elementary Prefs@{Elementary Prefs}}
\subsubsection{\texorpdfstring{elm\+\_\+prefs\+\_\+reset()}{elm\_prefs\_reset()}}
{\footnotesize\ttfamily void elm\+\_\+prefs\+\_\+reset (\begin{DoxyParamCaption}\item[{Elm\+\_\+\+Prefs $\ast$}]{obj,  }\item[{\hyperlink{group__Elm__Prefs_ga15d0fab20f5ec2f85fd628c25e5b62e0}{Elm\+\_\+\+Prefs\+\_\+\+Reset\+\_\+\+Mode}}]{mode }\end{DoxyParamCaption})}



Reset the values of a given prefs widget to a previous state. 

As can be seen on \hyperlink{group__Elm__Prefs_ga15d0fab20f5ec2f85fd628c25e5b62e0}{Elm\+\_\+\+Prefs\+\_\+\+Reset\+\_\+\+Mode}, there are two possible actions to be taken by this call -- either to reset {\ttfamily prefs\textquotesingle{}} values to the defaults (declared on the \$.epb file it is bound to) or to reset to the state they were before the last modification it got.


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em mode} & The reset mode to apply on {\ttfamily prefs} \\
\hline
\end{DoxyParams}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


References elm\+\_\+obj\+\_\+prefs\+\_\+reset().

