\section{Prefs}
\label{group__Prefs}\index{Prefs@{Prefs}}
\begin{DoxyCompactItemize}
\item 
\#define \hyperlink{group__Prefs_ga5b2a1da4630f0f0e1722f7932879f87e}{elm\-\_\-obj\-\_\-prefs\-\_\-file\-\_\-set}(file, page, ret)
\begin{DoxyCompactList}\small\item\em Set file and page to populate a given prefs widget's interface. \end{DoxyCompactList}\item 
\#define \hyperlink{group__Prefs_gac0d964e8346f5cdc57b2a75cac0ac3c9}{elm\-\_\-obj\-\_\-prefs\-\_\-file\-\_\-get}(file, page, ret)
\begin{DoxyCompactList}\small\item\em Retrieve file and page bound to a given prefs widget. \end{DoxyCompactList}\item 
\#define \hyperlink{group__Prefs_ga975e366cd46481b2253c8db137d2f16c}{elm\-\_\-obj\-\_\-prefs\-\_\-data\-\_\-set}(data, ret)
\begin{DoxyCompactList}\small\item\em Set user data for a given prefs widget. \end{DoxyCompactList}\item 
\#define \hyperlink{group__Prefs_ga4d8980fddcbab0a1ea20b25ff69cf697}{elm\-\_\-obj\-\_\-prefs\-\_\-data\-\_\-get}(ret)
\begin{DoxyCompactList}\small\item\em Retrieve user data for a given prefs widget. \end{DoxyCompactList}\item 
\#define \hyperlink{group__Prefs_ga62b569b75ce4c4a93c4166691a2665e1}{elm\-\_\-obj\-\_\-prefs\-\_\-autosave\-\_\-set}(autosave)
\begin{DoxyCompactList}\small\item\em Set whether a given prefs widget should save its values back (on the user data file, if set) automatically on every U\-I element changes. \end{DoxyCompactList}\item 
\#define \hyperlink{group__Prefs_gac65f64fc183d08de098cf18bb36da6d9}{elm\-\_\-obj\-\_\-prefs\-\_\-autosave\-\_\-get}(ret)
\begin{DoxyCompactList}\small\item\em Get whether a given prefs widget is saving its values back automatically on changes. \end{DoxyCompactList}\item 
\#define \hyperlink{group__Prefs_gafacc41ca1c1fe0767bd87d77806682b2}{elm\-\_\-obj\-\_\-prefs\-\_\-reset}(mode)
\begin{DoxyCompactList}\small\item\em Reset the values of a given prefs widget to a previous state. \end{DoxyCompactList}\item 
\#define \hyperlink{group__Prefs_ga3f63b04de4b97dbf8c61769496058997}{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-value\-\_\-set}(name, value, ret)
\begin{DoxyCompactList}\small\item\em Set the value on a given prefs widget's item. \end{DoxyCompactList}\item 
\#define \hyperlink{group__Prefs_ga2bfbc7dfc1ce7eefcd1cc7978655db31}{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-value\-\_\-get}(name, value, ret)
\begin{DoxyCompactList}\small\item\em Retrieve the value of a given prefs widget's item. \end{DoxyCompactList}\item 
\#define \hyperlink{group__Prefs_ga1b5737e16f6f98ac344cf40f017ad013}{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-object\-\_\-get}(name, ret)
\begin{DoxyCompactList}\small\item\em Retrieve the Elementary widget bound to a given prefs widget's item. \end{DoxyCompactList}\item 
\#define \hyperlink{group__Prefs_gade0f506a483d73d7c359b9837b289199}{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-set}(name, visible)
\begin{DoxyCompactList}\small\item\em Set whether the widget bound to given prefs widget's item should be visible or not. \end{DoxyCompactList}\item 
\#define \hyperlink{group__Prefs_ga1574e7f8f475987bfb1883f35aff23d3}{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-get}(name, ret)
\begin{DoxyCompactList}\small\item\em Retrieve whether the widget bound to a given prefs widget's item is visible or not. \end{DoxyCompactList}\item 
\#define \hyperlink{group__Prefs_ga490e972670f16d4ed14d36a332470333}{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-set}(name, disabled)
\begin{DoxyCompactList}\small\item\em Set whether the widget bound to a given prefs widget's item is disabled or not. \end{DoxyCompactList}\item 
\#define \hyperlink{group__Prefs_ga278e5630d92c23070c3a5a42362bb280}{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-get}(name, ret)
\begin{DoxyCompactList}\small\item\em Retrieve whether the widget bound to a given prefs widget's item is disabled or not. \end{DoxyCompactList}\item 
\#define \hyperlink{group__Prefs_ga29d2dd6056dfd1d76f9bb52983f2d30a}{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-set}(name, editable)
\begin{DoxyCompactList}\small\item\em Set whether the widget bound to a given prefs widget's item is editable or not. \end{DoxyCompactList}\item 
\#define \hyperlink{group__Prefs_ga5a8fb1f5db4fe1d3dadf2538dad91d79}{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-get}(name, ret)
\begin{DoxyCompactList}\small\item\em Retrieve whether the widget bound to a given prefs widget's item is editable or not. \end{DoxyCompactList}\item 
\#define \hyperlink{group__Prefs_ga4effb84cc34ce4b1425e093b8722b138}{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-swallow}(name, child, ret)
\begin{DoxyCompactList}\small\item\em \char`\"{}\-Swallows\char`\"{} an object into a S\-W\-A\-L\-L\-O\-W item of a prefs widget. \end{DoxyCompactList}\item 
\#define \hyperlink{group__Prefs_ga9c94db6749a29c98985a495b6d2f2ea4}{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-unswallow}(name, ret)
\begin{DoxyCompactList}\small\item\em Unswallow an object from a S\-W\-A\-L\-L\-O\-W item of a prefs widget. \end{DoxyCompactList}\end{DoxyCompactItemize}
\begin{DoxyCompactItemize}
\item 
Eina\-\_\-\-Bool \hyperlink{group__Prefs_ga70edc82294a0f1419dfbc2971c67a06f}{elm\-\_\-prefs\-\_\-file\-\_\-set} (Evas\-\_\-\-Object $\ast$o, const char $\ast$file, const char $\ast$page)
\begin{DoxyCompactList}\small\item\em Set file and page to populate a given prefs widget's interface. \end{DoxyCompactList}\item 
Eina\-\_\-\-Bool \hyperlink{group__Prefs_ga8f15094bbaf93937b411342b3e47639c}{elm\-\_\-prefs\-\_\-file\-\_\-get} (const Evas\-\_\-\-Object $\ast$o, const char $\ast$$\ast$file, const char $\ast$$\ast$page)
\begin{DoxyCompactList}\small\item\em Retrieve file and page bound to a given prefs widget. \end{DoxyCompactList}\item 
Eina\-\_\-\-Bool \hyperlink{group__Prefs_ga352f9d72cbad3c60584d9316b0aeb3ac}{elm\-\_\-prefs\-\_\-data\-\_\-set} (Evas\-\_\-\-Object $\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__Prefs_ga93e575ffb5fb186bcd579a0bd054753a}{elm\-\_\-prefs\-\_\-data\-\_\-get} (const Evas\-\_\-\-Object $\ast$o)
\begin{DoxyCompactList}\small\item\em Retrieve user data for a given prefs widget. \end{DoxyCompactList}\item 
void \hyperlink{group__Prefs_ga5e9852eaeeb38ea2c9500bc13e302a32}{elm\-\_\-prefs\-\_\-autosave\-\_\-set} (Evas\-\_\-\-Object $\ast$prefs, Eina\-\_\-\-Bool autosave)
\begin{DoxyCompactList}\small\item\em Set whether a given prefs widget should save its values back (on the user data file, if set) automatically on every U\-I element changes. \end{DoxyCompactList}\item 
Eina\-\_\-\-Bool \hyperlink{group__Prefs_ga2bee625e6ede05cc060ddac666224155}{elm\-\_\-prefs\-\_\-autosave\-\_\-get} (const Evas\-\_\-\-Object $\ast$prefs)
\begin{DoxyCompactList}\small\item\em Get whether a given prefs widget is saving its values back automatically on changes. \end{DoxyCompactList}\item 
void \hyperlink{group__Prefs_gab81c088fa73f6c57c4e3bb4ff241a06b}{elm\-\_\-prefs\-\_\-reset} (Evas\-\_\-\-Object $\ast$prefs, 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__Prefs_gac6e7412705bd8fbcb12d549220be507c}{elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-set} (Evas\-\_\-\-Object $\ast$prefs, const char $\ast$name, const Eina\-\_\-\-Value $\ast$value)
\begin{DoxyCompactList}\small\item\em Set the value on a given prefs widget's item. \end{DoxyCompactList}\item 
Eina\-\_\-\-Bool \hyperlink{group__Prefs_ga47214c95da3b7feb3959a536cff8c118}{elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-get} (const Evas\-\_\-\-Object $\ast$prefs, const char $\ast$name, Eina\-\_\-\-Value $\ast$value)
\begin{DoxyCompactList}\small\item\em Retrieve the value of a given prefs widget's item. \end{DoxyCompactList}\item 
const Evas\-\_\-\-Object $\ast$ \hyperlink{group__Prefs_ga216034614938486f744ae61a9b6bc310}{elm\-\_\-prefs\-\_\-item\-\_\-object\-\_\-get} (Evas\-\_\-\-Object $\ast$prefs, const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Retrieve the Elementary widget bound to a given prefs widget's item. \end{DoxyCompactList}\item 
void \hyperlink{group__Prefs_ga5a42baf71dced86ca56cbb553f85559e}{elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-set} (Evas\-\_\-\-Object $\ast$prefs, const char $\ast$name, Eina\-\_\-\-Bool visible)
\begin{DoxyCompactList}\small\item\em Set whether the widget bound to given prefs widget's item should be visible or not. \end{DoxyCompactList}\item 
Eina\-\_\-\-Bool \hyperlink{group__Prefs_ga2ac3f22d3d21bc183f34a11ebe641aef}{elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-get} (const Evas\-\_\-\-Object $\ast$prefs, const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Retrieve whether the widget bound to a given prefs widget's item is visible or not. \end{DoxyCompactList}\item 
void \hyperlink{group__Prefs_gaf90aba5889393057196bd22d4ad0f187}{elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-set} (Evas\-\_\-\-Object $\ast$prefs, const char $\ast$name, Eina\-\_\-\-Bool disabled)
\begin{DoxyCompactList}\small\item\em Set whether the widget bound to a given prefs widget's item is disabled or not. \end{DoxyCompactList}\item 
Eina\-\_\-\-Bool \hyperlink{group__Prefs_ga8c06635bf08310da778902a2c78e8acc}{elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-get} (const Evas\-\_\-\-Object $\ast$prefs, const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Retrieve whether the widget bound to a given prefs widget's item is disabled or not. \end{DoxyCompactList}\item 
void \hyperlink{group__Prefs_gaa3b3a4000db6faec48567325cd67e090}{elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-set} (Evas\-\_\-\-Object $\ast$prefs, const char $\ast$name, Eina\-\_\-\-Bool editable)
\begin{DoxyCompactList}\small\item\em Set whether the widget bound to a given prefs widget's item is editable or not. \end{DoxyCompactList}\item 
Eina\-\_\-\-Bool \hyperlink{group__Prefs_ga05bb973c133e52c817f04655ce92f49c}{elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-get} (const Evas\-\_\-\-Object $\ast$prefs, const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Retrieve whether the widget bound to a given prefs widget's item is editable or not. \end{DoxyCompactList}\item 
Eina\-\_\-\-Bool \hyperlink{group__Prefs_gaf597945e996bdfbce15ec0d3650a7c3d}{elm\-\_\-prefs\-\_\-item\-\_\-swallow} (Evas\-\_\-\-Object $\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\-O\-W item of a prefs widget. \end{DoxyCompactList}\item 
Evas\-\_\-\-Object $\ast$ \hyperlink{group__Prefs_gac3836d03ecb6c14c6ee4febe7bace236}{elm\-\_\-prefs\-\_\-item\-\_\-unswallow} (Evas\-\_\-\-Object $\ast$obj, const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Unswallow an object from a S\-W\-A\-L\-L\-O\-W item of a prefs widget. \end{DoxyCompactList}\end{DoxyCompactItemize}


\subsection{Detailed Description}
\hypertarget{group__Prefs_elm-prefs-widget}{}\subsection{Prefs}\label{group__Prefs_elm-prefs-widget}
 
\begin{DoxyImage}
\includegraphics{img/widget/prefs/preview-00}
\caption{width=}
\end{DoxyImage}


 
\begin{DoxyImageNoCaption}
  \mbox{\includegraphics{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 U\-I 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 minumum 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__Prefs_ga70edc82294a0f1419dfbc2971c67a06f}{elm\-\_\-prefs\-\_\-file\-\_\-set()} is issued on it, all of its U\-I elements will get default values, declared on that file. To fetch an user'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__Prefs_ga70edc82294a0f1419dfbc2971c67a06f}{elm\-\_\-prefs\-\_\-file\-\_\-set()} to will have their values applied to the respective U\-I 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 U\-I element modification by using \hyperlink{group__Prefs_ga5e9852eaeeb38ea2c9500bc13e302a32}{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's name)
\item {\ttfamily \char`\"{}page,reset\char`\"{}}\-: a given page has had its values reset (event info is the page'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'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's name)
\item {\ttfamily \char`\"{}item,changed\char`\"{}}\-: a given page's item has changed (event info is the item'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'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{Macro Definition Documentation}
\index{Prefs@{Prefs}!elm\-\_\-obj\-\_\-prefs\-\_\-autosave\-\_\-get@{elm\-\_\-obj\-\_\-prefs\-\_\-autosave\-\_\-get}}
\index{elm\-\_\-obj\-\_\-prefs\-\_\-autosave\-\_\-get@{elm\-\_\-obj\-\_\-prefs\-\_\-autosave\-\_\-get}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-autosave\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-autosave\-\_\-get(
\begin{DoxyParamCaption}
\item[{}]{ret}
\end{DoxyParamCaption}
)}\label{group__Prefs_gac65f64fc183d08de098cf18bb36da6d9}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_AUTOSAVE\_GET), \(\backslash\)
        EO\_TYPECHECK(Eina\_Bool *, ret)
\end{DoxyCode}


Get whether a given prefs widget is saving its values back automatically on changes. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt out}  & {\em ret} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga5e9852eaeeb38ea2c9500bc13e302a32}{elm\-\_\-prefs\-\_\-autosave\-\_\-set()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


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

\index{Prefs@{Prefs}!elm\-\_\-obj\-\_\-prefs\-\_\-autosave\-\_\-set@{elm\-\_\-obj\-\_\-prefs\-\_\-autosave\-\_\-set}}
\index{elm\-\_\-obj\-\_\-prefs\-\_\-autosave\-\_\-set@{elm\-\_\-obj\-\_\-prefs\-\_\-autosave\-\_\-set}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-autosave\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-autosave\-\_\-set(
\begin{DoxyParamCaption}
\item[{}]{autosave}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga62b569b75ce4c4a93c4166691a2665e1}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_AUTOSAVE\_SET), \(\backslash\)
        EO\_TYPECHECK(Eina\_Bool, autosave)
\end{DoxyCode}


Set whether a given prefs widget should save its values back (on the user data file, if set) automatically on every U\-I element changes. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em autosave} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga2bee625e6ede05cc060ddac666224155}{elm\-\_\-prefs\-\_\-autosave\-\_\-get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


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

\index{Prefs@{Prefs}!elm\-\_\-obj\-\_\-prefs\-\_\-data\-\_\-get@{elm\-\_\-obj\-\_\-prefs\-\_\-data\-\_\-get}}
\index{elm\-\_\-obj\-\_\-prefs\-\_\-data\-\_\-get@{elm\-\_\-obj\-\_\-prefs\-\_\-data\-\_\-get}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-data\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-data\-\_\-get(
\begin{DoxyParamCaption}
\item[{}]{ret}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga4d8980fddcbab0a1ea20b25ff69cf697}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_DATA\_GET), \(\backslash\)
        EO\_TYPECHECK(Elm_Prefs_Data **, ret)
\end{DoxyCode}


Retrieve user data for a given prefs widget. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt out}  & {\em ret} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga93e575ffb5fb186bcd579a0bd054753a}{elm\-\_\-prefs\-\_\-data\-\_\-get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


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

\index{Prefs@{Prefs}!elm\-\_\-obj\-\_\-prefs\-\_\-data\-\_\-set@{elm\-\_\-obj\-\_\-prefs\-\_\-data\-\_\-set}}
\index{elm\-\_\-obj\-\_\-prefs\-\_\-data\-\_\-set@{elm\-\_\-obj\-\_\-prefs\-\_\-data\-\_\-set}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-data\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-data\-\_\-set(
\begin{DoxyParamCaption}
\item[{}]{data, }
\item[{}]{ret}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga975e366cd46481b2253c8db137d2f16c}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_DATA\_SET), \(\backslash\)
        EO\_TYPECHECK(Elm_Prefs_Data *, data),            \(\backslash\)
        EO\_TYPECHECK(Eina\_Bool *, ret)
\end{DoxyCode}


Set user data for a given prefs widget. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em data} & \\
\hline
\mbox{\tt out}  & {\em ret} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga352f9d72cbad3c60584d9316b0aeb3ac}{elm\-\_\-prefs\-\_\-data\-\_\-set()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


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

\index{Prefs@{Prefs}!elm\-\_\-obj\-\_\-prefs\-\_\-file\-\_\-get@{elm\-\_\-obj\-\_\-prefs\-\_\-file\-\_\-get}}
\index{elm\-\_\-obj\-\_\-prefs\-\_\-file\-\_\-get@{elm\-\_\-obj\-\_\-prefs\-\_\-file\-\_\-get}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-file\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-file\-\_\-get(
\begin{DoxyParamCaption}
\item[{}]{file, }
\item[{}]{page, }
\item[{}]{ret}
\end{DoxyParamCaption}
)}\label{group__Prefs_gac0d964e8346f5cdc57b2a75cac0ac3c9}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_FILE\_GET), \(\backslash\)
        EO\_TYPECHECK(\textcolor{keyword}{const} \textcolor{keywordtype}{char} **, file),               \(\backslash\)
        EO\_TYPECHECK(\textcolor{keyword}{const} \textcolor{keywordtype}{char} **, page),               \(\backslash\)
        EO\_TYPECHECK(Eina\_Bool *, ret)
\end{DoxyCode}


Retrieve file and page bound to a given prefs widget. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt out}  & {\em file} & \\
\hline
\mbox{\tt out}  & {\em page} & \\
\hline
\mbox{\tt out}  & {\em ret} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga8f15094bbaf93937b411342b3e47639c}{elm\-\_\-prefs\-\_\-file\-\_\-get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


Referenced by elm\-\_\-prefs\-\_\-file\-\_\-get().

\index{Prefs@{Prefs}!elm\-\_\-obj\-\_\-prefs\-\_\-file\-\_\-set@{elm\-\_\-obj\-\_\-prefs\-\_\-file\-\_\-set}}
\index{elm\-\_\-obj\-\_\-prefs\-\_\-file\-\_\-set@{elm\-\_\-obj\-\_\-prefs\-\_\-file\-\_\-set}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-file\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-file\-\_\-set(
\begin{DoxyParamCaption}
\item[{}]{file, }
\item[{}]{page, }
\item[{}]{ret}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga5b2a1da4630f0f0e1722f7932879f87e}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_FILE\_SET), \(\backslash\)
        EO\_TYPECHECK(\textcolor{keyword}{const} \textcolor{keywordtype}{char} *, file),                \(\backslash\)
        EO\_TYPECHECK(\textcolor{keyword}{const} \textcolor{keywordtype}{char} *, page),                \(\backslash\)
        EO\_TYPECHECK(Eina\_Bool *, ret)
\end{DoxyCode}


Set file and page to populate a given prefs widget's interface. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em file} & \\
\hline
\mbox{\tt in}  & {\em page} & \\
\hline
\mbox{\tt out}  & {\em ret} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga70edc82294a0f1419dfbc2971c67a06f}{elm\-\_\-prefs\-\_\-file\-\_\-set()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


Referenced by elm\-\_\-prefs\-\_\-file\-\_\-set().

\index{Prefs@{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}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-get(
\begin{DoxyParamCaption}
\item[{}]{name, }
\item[{}]{ret}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga278e5630d92c23070c3a5a42362bb280}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_ITEM\_DISABLED\_GET), \(\backslash\)
        EO\_TYPECHECK(\textcolor{keyword}{const} \textcolor{keywordtype}{char} *, name),                         \(\backslash\)
        EO\_TYPECHECK(Eina\_Bool *, ret)
\end{DoxyCode}


Retrieve whether the widget bound to a given prefs widget's item is disabled or not. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & \\
\hline
\mbox{\tt out}  & {\em ret} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga8c06635bf08310da778902a2c78e8acc}{elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


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

\index{Prefs@{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}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-set(
\begin{DoxyParamCaption}
\item[{}]{name, }
\item[{}]{disabled}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga490e972670f16d4ed14d36a332470333}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_ITEM\_DISABLED\_SET), \(\backslash\)
        EO\_TYPECHECK(\textcolor{keyword}{const} \textcolor{keywordtype}{char} *, name),                         \(\backslash\)
        EO\_TYPECHECK(Eina\_Bool, disabled)
\end{DoxyCode}


Set whether the widget bound to a given prefs widget's item is disabled or not. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & \\
\hline
\mbox{\tt in}  & {\em disabled} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_gaf90aba5889393057196bd22d4ad0f187}{elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-set()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


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

\index{Prefs@{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}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-get(
\begin{DoxyParamCaption}
\item[{}]{name, }
\item[{}]{ret}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga5a8fb1f5db4fe1d3dadf2538dad91d79}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_ITEM\_EDITABLE\_GET), \(\backslash\)
        EO\_TYPECHECK(\textcolor{keyword}{const} \textcolor{keywordtype}{char} *, name),                         \(\backslash\)
        EO\_TYPECHECK(Eina\_Bool *, ret)
\end{DoxyCode}


Retrieve whether the widget bound to a given prefs widget's item is editable or not. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & \\
\hline
\mbox{\tt out}  & {\em ret} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga05bb973c133e52c817f04655ce92f49c}{elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


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

\index{Prefs@{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}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-set(
\begin{DoxyParamCaption}
\item[{}]{name, }
\item[{}]{editable}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga29d2dd6056dfd1d76f9bb52983f2d30a}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_ITEM\_EDITABLE\_SET), \(\backslash\)
        EO\_TYPECHECK(\textcolor{keyword}{const} \textcolor{keywordtype}{char} *, name),                         \(\backslash\)
        EO\_TYPECHECK(Eina\_Bool, editable)
\end{DoxyCode}


Set whether the widget bound to a given prefs widget's item is editable or not. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & \\
\hline
\mbox{\tt in}  & {\em editable} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_gaa3b3a4000db6faec48567325cd67e090}{elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-set()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


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

\index{Prefs@{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}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-object\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-object\-\_\-get(
\begin{DoxyParamCaption}
\item[{}]{name, }
\item[{}]{ret}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga1b5737e16f6f98ac344cf40f017ad013}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_ITEM\_OBJECT\_GET), \(\backslash\)
        EO\_TYPECHECK(\textcolor{keyword}{const} \textcolor{keywordtype}{char} *, name),                       \(\backslash\)
        EO\_TYPECHECK(\textcolor{keyword}{const} Evas\_Object **, ret)
\end{DoxyCode}


Retrieve the Elementary widget bound to a given prefs widget's item. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & \\
\hline
\mbox{\tt out}  & {\em ret} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga47214c95da3b7feb3959a536cff8c118}{elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


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

\index{Prefs@{Prefs}!elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-swallow@{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-swallow}}
\index{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-swallow@{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-swallow}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-swallow}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-swallow(
\begin{DoxyParamCaption}
\item[{}]{name, }
\item[{}]{child, }
\item[{}]{ret}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga4effb84cc34ce4b1425e093b8722b138}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_ITEM\_SWALLOW), \(\backslash\)
        EO\_TYPECHECK(\textcolor{keyword}{const} \textcolor{keywordtype}{char} *, name),                    \(\backslash\)
        EO\_TYPECHECK(Evas\_Object *, child),                  \(\backslash\)
        EO\_TYPECHECK(Eina\_Bool *, ret)
\end{DoxyCode}


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


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & \\
\hline
\mbox{\tt in}  & {\em child} & \\
\hline
\mbox{\tt out}  & {\em ret} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_gaf597945e996bdfbce15ec0d3650a7c3d}{elm\-\_\-prefs\-\_\-item\-\_\-swallow()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


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

\index{Prefs@{Prefs}!elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-unswallow@{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-unswallow}}
\index{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-unswallow@{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-unswallow}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-unswallow}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-unswallow(
\begin{DoxyParamCaption}
\item[{}]{name, }
\item[{}]{ret}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga9c94db6749a29c98985a495b6d2f2ea4}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_ITEM\_UNSWALLOW), \(\backslash\)
        EO\_TYPECHECK(\textcolor{keyword}{const} \textcolor{keywordtype}{char} *,name),                       \(\backslash\)
        EO\_TYPECHECK(Evas\_Object **, ret)
\end{DoxyCode}


Unswallow an object from a S\-W\-A\-L\-L\-O\-W item of a prefs widget. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & \\
\hline
\mbox{\tt out}  & {\em ret} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_gac3836d03ecb6c14c6ee4febe7bace236}{elm\-\_\-prefs\-\_\-item\-\_\-unswallow()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


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

\index{Prefs@{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}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-value\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-value\-\_\-get(
\begin{DoxyParamCaption}
\item[{}]{name, }
\item[{}]{value, }
\item[{}]{ret}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga2bfbc7dfc1ce7eefcd1cc7978655db31}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_ITEM\_VALUE\_GET), \(\backslash\)
        EO\_TYPECHECK(\textcolor{keyword}{const} \textcolor{keywordtype}{char} *, name),                      \(\backslash\)
        EO\_TYPECHECK(Eina\_Value *, value),                     \(\backslash\)
        EO\_TYPECHECK(Eina\_Bool *, ret)
\end{DoxyCode}


Retrieve the value of a given prefs widget's item. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & \\
\hline
\mbox{\tt out}  & {\em value} & \\
\hline
\mbox{\tt out}  & {\em ret} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_gac6e7412705bd8fbcb12d549220be507c}{elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-set()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


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

\index{Prefs@{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}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-value\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-value\-\_\-set(
\begin{DoxyParamCaption}
\item[{}]{name, }
\item[{}]{value, }
\item[{}]{ret}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga3f63b04de4b97dbf8c61769496058997}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_ITEM\_VALUE\_SET), \(\backslash\)
        EO\_TYPECHECK(\textcolor{keyword}{const} \textcolor{keywordtype}{char} *, name),                      \(\backslash\)
        EO\_TYPECHECK(\textcolor{keyword}{const} Eina\_Value *, value),               \(\backslash\)
        EO\_TYPECHECK(Eina\_Bool *, ret)
\end{DoxyCode}


Set the value on a given prefs widget's item. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & \\
\hline
\mbox{\tt in}  & {\em value} & \\
\hline
\mbox{\tt out}  & {\em ret} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga47214c95da3b7feb3959a536cff8c118}{elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


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

\index{Prefs@{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}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-get(
\begin{DoxyParamCaption}
\item[{}]{name, }
\item[{}]{ret}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga1574e7f8f475987bfb1883f35aff23d3}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_ITEM\_VISIBLE\_GET), \(\backslash\)
        EO\_TYPECHECK(\textcolor{keyword}{const} \textcolor{keywordtype}{char} *,name),                         \(\backslash\)
        EO\_TYPECHECK(Eina\_Bool *, ret)
\end{DoxyCode}


Retrieve whether the widget bound to a given prefs widget's item is visible or not. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & \\
\hline
\mbox{\tt out}  & {\em ret} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga2ac3f22d3d21bc183f34a11ebe641aef}{elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


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

\index{Prefs@{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}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-set(
\begin{DoxyParamCaption}
\item[{}]{name, }
\item[{}]{visible}
\end{DoxyParamCaption}
)}\label{group__Prefs_gade0f506a483d73d7c359b9837b289199}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_ITEM\_VISIBLE\_SET), \(\backslash\)
        EO\_TYPECHECK(\textcolor{keyword}{const} \textcolor{keywordtype}{char} *, name),                        \(\backslash\)
        EO\_TYPECHECK(Eina\_Bool, visible)
\end{DoxyCode}


Set whether the widget bound to given prefs widget's item should be visible or not. 


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em name} & \\
\hline
\mbox{\tt in}  & {\em visible} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga5a42baf71dced86ca56cbb553f85559e}{elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-set()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


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

\index{Prefs@{Prefs}!elm\-\_\-obj\-\_\-prefs\-\_\-reset@{elm\-\_\-obj\-\_\-prefs\-\_\-reset}}
\index{elm\-\_\-obj\-\_\-prefs\-\_\-reset@{elm\-\_\-obj\-\_\-prefs\-\_\-reset}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-obj\-\_\-prefs\-\_\-reset}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-prefs\-\_\-reset(
\begin{DoxyParamCaption}
\item[{}]{mode}
\end{DoxyParamCaption}
)}\label{group__Prefs_gafacc41ca1c1fe0767bd87d77806682b2}
{\bfseries Value\-:}
\begin{DoxyCode}
ELM\_OBJ\_PREFS\_ID(ELM\_OBJ\_PREFS\_SUB\_ID\_RESET), \(\backslash\)
        EO\_TYPECHECK(Elm\_Prefs\_Reset\_Mode, mode)
\end{DoxyCode}


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


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em mode} & \\
\hline
\end{DoxyParams}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


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



\subsection{Function Documentation}
\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-autosave\-\_\-get@{elm\-\_\-prefs\-\_\-autosave\-\_\-get}}
\index{elm\-\_\-prefs\-\_\-autosave\-\_\-get@{elm\-\_\-prefs\-\_\-autosave\-\_\-get}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-autosave\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}Eina\-\_\-\-Bool elm\-\_\-prefs\-\_\-autosave\-\_\-get (
\begin{DoxyParamCaption}
\item[{const Evas\-\_\-\-Object $\ast$}]{prefs}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga2bee625e6ede05cc060ddac666224155}


Get whether a given prefs widget is saving its values back automatically on changes. 


\begin{DoxyParams}{Parameters}
{\em prefs} & A valid prefs widget handle \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\-I\-N\-A\-\_\-\-T\-R\-U\-E} if {\itshape prefs} is saving automatically, {\ttfamily E\-I\-N\-A\-\_\-\-F\-A\-L\-S\-E} otherwise.
\end{DoxyReturn}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga5e9852eaeeb38ea2c9500bc13e302a32}{elm\-\_\-prefs\-\_\-autosave\-\_\-set()}, for more details
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


References elm\-\_\-obj\-\_\-prefs\-\_\-autosave\-\_\-get.

\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-autosave\-\_\-set@{elm\-\_\-prefs\-\_\-autosave\-\_\-set}}
\index{elm\-\_\-prefs\-\_\-autosave\-\_\-set@{elm\-\_\-prefs\-\_\-autosave\-\_\-set}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-autosave\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}void elm\-\_\-prefs\-\_\-autosave\-\_\-set (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{prefs, }
\item[{Eina\-\_\-\-Bool}]{autosave}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga5e9852eaeeb38ea2c9500bc13e302a32}


Set whether a given prefs widget should save its values back (on the user data file, if set) automatically on every U\-I element changes. 


\begin{DoxyParams}{Parameters}
{\em prefs} & A valid prefs widget handle \\
\hline
{\em autosave} & {\ttfamily E\-I\-N\-A\-\_\-\-T\-R\-U\-E} to save automatically, {\ttfamily E\-I\-N\-A\-\_\-\-F\-A\-L\-S\-E} otherwise.\\
\hline
\end{DoxyParams}
If {\itshape autosave} is {\ttfamily E\-I\-N\-A\-\_\-\-T\-R\-U\-E}, every call to \hyperlink{group__Prefs_gac6e7412705bd8fbcb12d549220be507c}{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\-E\-D event coming for its prefs data and every U\-I 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 {\itshape prefs}, naturally nothing will happen.

\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga2bee625e6ede05cc060ddac666224155}{elm\-\_\-prefs\-\_\-autosave\-\_\-get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}
\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}


References elm\-\_\-obj\-\_\-prefs\-\_\-autosave\-\_\-set.

\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-data\-\_\-get@{elm\-\_\-prefs\-\_\-data\-\_\-get}}
\index{elm\-\_\-prefs\-\_\-data\-\_\-get@{elm\-\_\-prefs\-\_\-data\-\_\-get}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-data\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}{\bf Elm\-\_\-\-Prefs\-\_\-\-Data}$\ast$ elm\-\_\-prefs\-\_\-data\-\_\-get (
\begin{DoxyParamCaption}
\item[{const Evas\-\_\-\-Object $\ast$}]{o}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga93e575ffb5fb186bcd579a0bd054753a}


Retrieve user data for a given prefs widget. 


\begin{DoxyParams}{Parameters}
{\em obj} & A prefs widget handle \\
\hline
{\em prefs\-\_\-data} & A valid prefs\-\_\-data handle \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
A pointer to the user data of a given prefs widget on success. {\ttfamily N\-U\-L\-L} otherwise.
\end{DoxyReturn}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga352f9d72cbad3c60584d9316b0aeb3ac}{elm\-\_\-prefs\-\_\-data\-\_\-set()} for more details
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


References elm\-\_\-obj\-\_\-prefs\-\_\-data\-\_\-get.

\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-data\-\_\-set@{elm\-\_\-prefs\-\_\-data\-\_\-set}}
\index{elm\-\_\-prefs\-\_\-data\-\_\-set@{elm\-\_\-prefs\-\_\-data\-\_\-set}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-data\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}Eina\-\_\-\-Bool elm\-\_\-prefs\-\_\-data\-\_\-set (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{obj, }
\item[{{\bf Elm\-\_\-\-Prefs\-\_\-\-Data} $\ast$}]{data}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga352f9d72cbad3c60584d9316b0aeb3ac}


Set user data for a given prefs widget. 


\begin{DoxyParams}{Parameters}
{\em obj} & A prefs widget handle \\
\hline
{\em prefs\-\_\-data} & A valid prefs\-\_\-data handle \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\-I\-N\-A\-\_\-\-T\-R\-U\-E}, on success, {\ttfamily E\-I\-N\-A\-\_\-\-F\-A\-L\-S\-E} otherwise
\end{DoxyReturn}
Once a prefs widget is created, after \hyperlink{group__Prefs_ga70edc82294a0f1419dfbc2971c67a06f}{elm\-\_\-prefs\-\_\-file\-\_\-set()} is issued on it, all of its U\-I elements will get default values, when declared on that file. To fetch an user's own, personal set of those values, one gets to pair a {\bfseries prefs data} handle to the prefs widget. This is what this call is intended for.

Prefs data values from {\itshape prefs\-\_\-data} with keys matching the ones present on the file passed on \hyperlink{group__Prefs_ga70edc82294a0f1419dfbc2971c67a06f}{elm\-\_\-prefs\-\_\-file\-\_\-set()} to {\itshape obj} will have their values applied to the respective U\-I elements of the widget.

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

\begin{DoxyNote}{Note}
{\itshape obj} will keep a reference of its own for {\itshape prefs\-\_\-data}, but you should still unreference it by yourself, after the widget is gone.
\end{DoxyNote}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga93e575ffb5fb186bcd579a0bd054753a}{elm\-\_\-prefs\-\_\-data\-\_\-get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}
\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}


References elm\-\_\-obj\-\_\-prefs\-\_\-data\-\_\-set.

\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-file\-\_\-get@{elm\-\_\-prefs\-\_\-file\-\_\-get}}
\index{elm\-\_\-prefs\-\_\-file\-\_\-get@{elm\-\_\-prefs\-\_\-file\-\_\-get}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-file\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}Eina\-\_\-\-Bool elm\-\_\-prefs\-\_\-file\-\_\-get (
\begin{DoxyParamCaption}
\item[{const Evas\-\_\-\-Object $\ast$}]{o, }
\item[{const char $\ast$$\ast$}]{file, }
\item[{const char $\ast$$\ast$}]{page}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga8f15094bbaf93937b411342b3e47639c}


Retrieve file and page bound to a given prefs widget. 


\begin{DoxyParams}{Parameters}
{\em o} & A prefs widget handle \\
\hline
{\em file} & Where to store the file {\itshape o} is bound to \\
\hline
{\em page} & Where to store the page {\itshape o} is bound to \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\-I\-N\-A\-\_\-\-T\-R\-U\-E}, on success, {\ttfamily E\-I\-N\-A\-\_\-\-F\-A\-L\-S\-E} otherwise
\end{DoxyReturn}
\begin{DoxyNote}{Note}
Use {\ttfamily N\-U\-L\-L} pointers on the components you're not interested in\-: they'll be ignored by the function.
\end{DoxyNote}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga70edc82294a0f1419dfbc2971c67a06f}{elm\-\_\-prefs\-\_\-file\-\_\-set()} for more information
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


References elm\-\_\-obj\-\_\-prefs\-\_\-file\-\_\-get.

\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-file\-\_\-set@{elm\-\_\-prefs\-\_\-file\-\_\-set}}
\index{elm\-\_\-prefs\-\_\-file\-\_\-set@{elm\-\_\-prefs\-\_\-file\-\_\-set}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-file\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}Eina\-\_\-\-Bool elm\-\_\-prefs\-\_\-file\-\_\-set (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{o, }
\item[{const char $\ast$}]{file, }
\item[{const char $\ast$}]{page}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga70edc82294a0f1419dfbc2971c67a06f}


Set file and page to populate a given prefs widget's interface. 


\begin{DoxyParams}{Parameters}
{\em o} & A prefs widget handle \\
\hline
{\em file} & The {\bfseries }.epb (binary) file to get contents from \\
\hline
{\em page} & The page, inside {\itshape file}, where to get item contents from \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\-I\-N\-A\-\_\-\-T\-R\-U\-E}, on success, {\ttfamily E\-I\-N\-A\-\_\-\-F\-A\-L\-S\-E} otherwise
\end{DoxyReturn}
Elm prefs widgets start blank, with no child widgets. It'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 U\-I elements.

If {\itshape file} is {\ttfamily N\-U\-L\-L}, \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\-L\-L}, it is considered \char`\"{}main\char`\"{}, as default.

\begin{DoxyWarning}{Warning}
If your binary is not properly installed and \hyperlink{group__App_ga92a09dbf88cc1ca3eab51c51dea589d0}{elm\-\_\-app\-\_\-data\-\_\-dir\-\_\-get()} can't be figured out, a fallback value of \char`\"{}.\char`\"{} will be tryed, instead.
\end{DoxyWarning}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga8f15094bbaf93937b411342b3e47639c}{elm\-\_\-prefs\-\_\-file\-\_\-get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}
\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}


References elm\-\_\-obj\-\_\-prefs\-\_\-file\-\_\-set.

\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-get@{elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-get}}
\index{elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-get@{elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-get}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}Eina\-\_\-\-Bool elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-get (
\begin{DoxyParamCaption}
\item[{const Evas\-\_\-\-Object $\ast$}]{prefs, }
\item[{const char $\ast$}]{name}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga8c06635bf08310da778902a2c78e8acc}


Retrieve whether the widget bound to a given prefs widget's item is disabled or not. 


\begin{DoxyParams}{Parameters}
{\em prefs} & A valid prefs widget handle \\
\hline
{\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 E\-I\-N\-A\-\_\-\-T\-R\-U\-E}, if it is disabled, {\ttfamily E\-I\-N\-A\-\_\-\-F\-A\-L\-S\-E} otherwise
\end{DoxyReturn}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_gaf90aba5889393057196bd22d4ad0f187}{elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-set()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


References elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-get.

\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-set@{elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-set}}
\index{elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-set@{elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-set}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}void elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-set (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{prefs, }
\item[{const char $\ast$}]{name, }
\item[{Eina\-\_\-\-Bool}]{disabled}
\end{DoxyParamCaption}
)}\label{group__Prefs_gaf90aba5889393057196bd22d4ad0f187}


Set whether the widget bound to a given prefs widget's item is disabled or not. 


\begin{DoxyParams}{Parameters}
{\em prefs} & A valid prefs widget handle \\
\hline
{\em name} & The name of the item (as declared in the prefs collection) to act on \\
\hline
{\em disabled} & {\ttfamily E\-I\-N\-A\-\_\-\-T\-R\-U\-E}, to make it disabled, {\ttfamily E\-I\-N\-A\-\_\-\-F\-A\-L\-S\-E} otherwise\\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga8c06635bf08310da778902a2c78e8acc}{elm\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}
\begin{Desc}
\item[Examples\-: ]\par
\hyperlink{prefs_example_02_8c-example}{prefs\-\_\-example\-\_\-02.\-c}.\end{Desc}


References elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-disabled\-\_\-set.

\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-get@{elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-get}}
\index{elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-get@{elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-get}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}Eina\-\_\-\-Bool elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-get (
\begin{DoxyParamCaption}
\item[{const Evas\-\_\-\-Object $\ast$}]{prefs, }
\item[{const char $\ast$}]{name}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga05bb973c133e52c817f04655ce92f49c}


Retrieve whether the widget bound to a given prefs widget's item is editable or not. 


\begin{DoxyParams}{Parameters}
{\em prefs} & A valid prefs widget handle \\
\hline
{\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 E\-I\-N\-A\-\_\-\-T\-R\-U\-E}, if it is editable, {\ttfamily E\-I\-N\-A\-\_\-\-F\-A\-L\-S\-E} otherwise
\end{DoxyReturn}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_gaa3b3a4000db6faec48567325cd67e090}{elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-set()} for more details
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


References elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-get.

\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-set@{elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-set}}
\index{elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-set@{elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-set}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}void elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-set (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{prefs, }
\item[{const char $\ast$}]{name, }
\item[{Eina\-\_\-\-Bool}]{editable}
\end{DoxyParamCaption}
)}\label{group__Prefs_gaa3b3a4000db6faec48567325cd67e090}


Set whether the widget bound to a given prefs widget's item is editable or not. 


\begin{DoxyParams}{Parameters}
{\em prefs} & A valid prefs widget handle \\
\hline
{\em name} & The name of the item (as declared in the prefs collection) to act on \\
\hline
{\em editable} & {\ttfamily E\-I\-N\-A\-\_\-\-T\-R\-U\-E}, to make it editable, {\ttfamily E\-I\-N\-A\-\_\-\-F\-A\-L\-S\-E} otherwise\\
\hline
\end{DoxyParams}
\begin{DoxyNote}{Note}
Only {\ttfamily T\-E\-X\-T} or {\ttfamily T\-E\-X\-T\-A\-R\-E\-A} items' default widgets implement the 'editable' property. Custom registered widgets may as well implement them.
\end{DoxyNote}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga05bb973c133e52c817f04655ce92f49c}{elm\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}
\begin{Desc}
\item[Examples\-: ]\par
\hyperlink{prefs_example_02_8c-example}{prefs\-\_\-example\-\_\-02.\-c}.\end{Desc}


References elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-editable\-\_\-set.

\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-item\-\_\-object\-\_\-get@{elm\-\_\-prefs\-\_\-item\-\_\-object\-\_\-get}}
\index{elm\-\_\-prefs\-\_\-item\-\_\-object\-\_\-get@{elm\-\_\-prefs\-\_\-item\-\_\-object\-\_\-get}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-item\-\_\-object\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}const Evas\-\_\-\-Object$\ast$ elm\-\_\-prefs\-\_\-item\-\_\-object\-\_\-get (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{prefs, }
\item[{const char $\ast$}]{name}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga216034614938486f744ae61a9b6bc310}


Retrieve the Elementary widget bound to a given prefs widget's item. 


\begin{DoxyParams}{Parameters}
{\em prefs} & A valid prefs widget handle \\
\hline
{\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\-L\-L}, otherwise
\end{DoxyReturn}
This will retrieve a handle to the real widget implementing a given item of {\itshape prefs}, {\bfseries for read-\/only} actions.

\begin{DoxyWarning}{Warning}
You should {\bfseries never} modify the state of the returned widget, because it's meant to be managed by {\itshape prefs}, solely.
\end{DoxyWarning}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_gac6e7412705bd8fbcb12d549220be507c}{elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-set()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


References elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-object\-\_\-get.

\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-item\-\_\-swallow@{elm\-\_\-prefs\-\_\-item\-\_\-swallow}}
\index{elm\-\_\-prefs\-\_\-item\-\_\-swallow@{elm\-\_\-prefs\-\_\-item\-\_\-swallow}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-item\-\_\-swallow}]{\setlength{\rightskip}{0pt plus 5cm}Eina\-\_\-\-Bool elm\-\_\-prefs\-\_\-item\-\_\-swallow (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{obj, }
\item[{const char $\ast$}]{name, }
\item[{Evas\-\_\-\-Object $\ast$}]{child}
\end{DoxyParamCaption}
)}\label{group__Prefs_gaf597945e996bdfbce15ec0d3650a7c3d}


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


\begin{DoxyParams}{Parameters}
{\em obj} & A valid prefs widget handle \\
\hline
{\em name} & the name of the S\-W\-A\-L\-L\-O\-W item (as declared in the prefs collection) \\
\hline
{\em child} & The object to occupy the item \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\-I\-N\-A\-\_\-\-T\-R\-U\-E}, on success, {\ttfamily E\-I\-N\-A\-\_\-\-F\-A\-L\-S\-E} otherwise
\end{DoxyReturn}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_gaf597945e996bdfbce15ec0d3650a7c3d}{elm\-\_\-prefs\-\_\-item\-\_\-swallow()} for more details
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}
\begin{Desc}
\item[Examples\-: ]\par
\hyperlink{prefs_example_03_8c-example}{prefs\-\_\-example\-\_\-03.\-c}.\end{Desc}


References elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-swallow.

\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-item\-\_\-unswallow@{elm\-\_\-prefs\-\_\-item\-\_\-unswallow}}
\index{elm\-\_\-prefs\-\_\-item\-\_\-unswallow@{elm\-\_\-prefs\-\_\-item\-\_\-unswallow}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-item\-\_\-unswallow}]{\setlength{\rightskip}{0pt plus 5cm}Evas\-\_\-\-Object$\ast$ elm\-\_\-prefs\-\_\-item\-\_\-unswallow (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{obj, }
\item[{const char $\ast$}]{name}
\end{DoxyParamCaption}
)}\label{group__Prefs_gac3836d03ecb6c14c6ee4febe7bace236}


Unswallow an object from a S\-W\-A\-L\-L\-O\-W item of a prefs widget. 


\begin{DoxyParams}{Parameters}
{\em obj} & A valid prefs widget handle \\
\hline
{\em name} & the name of the S\-W\-A\-L\-L\-O\-W item (as declared in the prefs collection) \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The unswallowed object, or N\-U\-L\-L on errors
\end{DoxyReturn}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_gac3836d03ecb6c14c6ee4febe7bace236}{elm\-\_\-prefs\-\_\-item\-\_\-unswallow()} for more details
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


References elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-unswallow.

\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-get@{elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-get}}
\index{elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-get@{elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-get}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}Eina\-\_\-\-Bool elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-get (
\begin{DoxyParamCaption}
\item[{const Evas\-\_\-\-Object $\ast$}]{prefs, }
\item[{const char $\ast$}]{name, }
\item[{Eina\-\_\-\-Value $\ast$}]{value}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga47214c95da3b7feb3959a536cff8c118}


Retrieve the value of a given prefs widget's item. 


\begin{DoxyParams}{Parameters}
{\em prefs} & A valid prefs widget handle \\
\hline
{\em name} & The name of the item (as declared in the prefs collection) to get value from \\
\hline
{\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 E\-I\-N\-A\-\_\-\-T\-R\-U\-E}, on success, {\ttfamily E\-I\-N\-A\-\_\-\-F\-A\-L\-S\-E} otherwise
\end{DoxyReturn}
This will retrieve the value of item named {\itshape name}.

\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_gac6e7412705bd8fbcb12d549220be507c}{elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-set()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}
\begin{Desc}
\item[Examples\-: ]\par
\hyperlink{prefs_example_03_8c-example}{prefs\-\_\-example\-\_\-03.\-c}.\end{Desc}


References elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-value\-\_\-get.

\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-set@{elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-set}}
\index{elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-set@{elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-set}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}Eina\-\_\-\-Bool elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-set (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{prefs, }
\item[{const char $\ast$}]{name, }
\item[{const Eina\-\_\-\-Value $\ast$}]{value}
\end{DoxyParamCaption}
)}\label{group__Prefs_gac6e7412705bd8fbcb12d549220be507c}


Set the value on a given prefs widget's item. 


\begin{DoxyParams}{Parameters}
{\em prefs} & A valid prefs widget handle \\
\hline
{\em name} & The name of the item (as declared in the prefs collection) \\
\hline
{\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 E\-I\-N\-A\-\_\-\-T\-R\-U\-E}, on success, {\ttfamily E\-I\-N\-A\-\_\-\-F\-A\-L\-S\-E} otherwise
\end{DoxyReturn}
This will change the value of item named {\itshape name} programatically.

\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga47214c95da3b7feb3959a536cff8c118}{elm\-\_\-prefs\-\_\-item\-\_\-value\-\_\-get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


References elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-value\-\_\-set.

\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-get@{elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-get}}
\index{elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-get@{elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-get}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}Eina\-\_\-\-Bool elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-get (
\begin{DoxyParamCaption}
\item[{const Evas\-\_\-\-Object $\ast$}]{prefs, }
\item[{const char $\ast$}]{name}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga2ac3f22d3d21bc183f34a11ebe641aef}


Retrieve whether the widget bound to a given prefs widget's item is visible or not. 


\begin{DoxyParams}{Parameters}
{\em prefs} & A valid prefs widget handle \\
\hline
{\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 E\-I\-N\-A\-\_\-\-T\-R\-U\-E}, if it is visible, {\ttfamily E\-I\-N\-A\-\_\-\-F\-A\-L\-S\-E} otherwise
\end{DoxyReturn}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga5a42baf71dced86ca56cbb553f85559e}{elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-set()} for more details
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


References elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-get.

\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-set@{elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-set}}
\index{elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-set@{elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-set}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}void elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-set (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{prefs, }
\item[{const char $\ast$}]{name, }
\item[{Eina\-\_\-\-Bool}]{visible}
\end{DoxyParamCaption}
)}\label{group__Prefs_ga5a42baf71dced86ca56cbb553f85559e}


Set whether the widget bound to given prefs widget's item should be visible or not. 


\begin{DoxyParams}{Parameters}
{\em prefs} & A valid prefs widget handle \\
\hline
{\em name} & The name of the item (as declared in the prefs collection) to change visibility of \\
\hline
{\em visible} & {\ttfamily E\-I\-N\-A\-\_\-\-T\-R\-U\-E}, to make it visible, {\ttfamily E\-I\-N\-A\-\_\-\-F\-A\-L\-S\-E} otherwise\\
\hline
\end{DoxyParams}
Each prefs item may have a default visibility state, declared on the {\ttfamily }.epb {\itshape prefs} it was loaded with. By this call one may alter that state, programatically.

\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Prefs_ga2ac3f22d3d21bc183f34a11ebe641aef}{elm\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}
\begin{Desc}
\item[Examples\-: ]\par
\hyperlink{prefs_example_02_8c-example}{prefs\-\_\-example\-\_\-02.\-c}.\end{Desc}


References elm\-\_\-obj\-\_\-prefs\-\_\-item\-\_\-visible\-\_\-set.

\index{Prefs@{Prefs}!elm\-\_\-prefs\-\_\-reset@{elm\-\_\-prefs\-\_\-reset}}
\index{elm\-\_\-prefs\-\_\-reset@{elm\-\_\-prefs\-\_\-reset}!Prefs@{Prefs}}
\subsubsection[{elm\-\_\-prefs\-\_\-reset}]{\setlength{\rightskip}{0pt plus 5cm}void elm\-\_\-prefs\-\_\-reset (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{prefs, }
\item[{Elm\-\_\-\-Prefs\-\_\-\-Reset\-\_\-\-Mode}]{mode}
\end{DoxyParamCaption}
)}\label{group__Prefs_gab81c088fa73f6c57c4e3bb4ff241a06b}


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


\begin{DoxyParams}{Parameters}
{\em prefs} & A valid prefs widget handle \\
\hline
{\em mode} & The reset mode to apply on {\itshape prefs} \\
\hline
\end{DoxyParams}
As can be seen on \#\-Elm\-\_\-\-Prefs\-\_\-\-Reset\-\_\-\-Mode, there are two possible actions to be taken by this call -- either to reset {\itshape prefs'} values to the defaults (declared on the {\ttfamily }.epb file it is bound to) or to reset to the state they were before the last modification it got.

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


References elm\-\_\-obj\-\_\-prefs\-\_\-reset.

