\hypertarget{group__Evas__Smart__Object__Group}{}\section{Smart Object Functions}
\label{group__Evas__Smart__Object__Group}\index{Smart Object Functions@{Smart Object Functions}}


Functions dealing with Evas smart objects (instances).  


\subsection*{Modules}
\begin{DoxyCompactItemize}
\item 
\hyperlink{group__Evas__Smart__Object__Clipped}{Clipped Smart Object}
\begin{DoxyCompactList}\small\item\em Clipped smart object is a base to construct other smart objects based on the concept of having an internal clipper that is applied to all children objects. \end{DoxyCompactList}\item 
\hyperlink{group__Evas__Object__Box}{Box Smart Object}
\begin{DoxyCompactList}\small\item\em A box is a convenience smart object that packs children inside it in {\bfseries sequence}, using a layouting function specified by the user. \end{DoxyCompactList}\item 
\hyperlink{group__Evas__Object__Table}{Table Smart Object.}
\begin{DoxyCompactList}\small\item\em Convenience smart object that packs children using a tabular layout using children size hints to define their size and alignment inside their cell space. \end{DoxyCompactList}\item 
\hyperlink{group__Evas__Object__Grid}{Grid Smart Object.}
\begin{DoxyCompactList}\small\item\em Convenience smart object that packs children under a regular grid layout, using their virtual grid location and size to determine children\textquotesingle{}s positions inside the grid object\textquotesingle{}s area. \end{DoxyCompactList}\end{DoxyCompactItemize}
\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
void \hyperlink{group__Evas__Smart__Object__Group_ga84964c53d1d5f1fb59d9799d1d47e9a9}{evas\+\_\+smart\+\_\+legacy\+\_\+type\+\_\+register} (const char $\ast$type, const \hyperlink{group__Eo_ga88d29df76a2921aa5478803156d83be5}{Eo\+\_\+\+Class} $\ast$klass)
\begin{DoxyCompactList}\small\item\em Registers an object type and its associated class. \end{DoxyCompactList}\end{DoxyCompactItemize}
\begin{DoxyCompactItemize}
\item 
\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$ \hyperlink{group__Evas__Smart__Object__Group_gad80de73a33446f902d4b39141a8d0a05}{evas\+\_\+object\+\_\+smart\+\_\+add} (\hyperlink{group__Evas__Canvas_ga5ff87cc4ce6bc43e3b640a6d37f73043}{Evas} $\ast$e, \hyperlink{Evas__Common_8h_a7cdfd1afece1cad64c413eb9a778ddbb}{Evas\+\_\+\+Smart} $\ast$s)
\begin{DoxyCompactList}\small\item\em Instantiates a new smart object described by {\ttfamily s}. \end{DoxyCompactList}\item 
void \hyperlink{group__Evas__Smart__Object__Group_ga6845c17effe796430cb4fc5f2cfccef0}{evas\+\_\+object\+\_\+smart\+\_\+member\+\_\+add} (\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj, \hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$smart\+\_\+obj)
\begin{DoxyCompactList}\small\item\em Set an Evas object as a member of a given smart object. \end{DoxyCompactList}\item 
void \hyperlink{group__Evas__Smart__Object__Group_ga12034359ab780a3a0e8b20b83475ed15}{evas\+\_\+object\+\_\+smart\+\_\+member\+\_\+del} (\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj)
\begin{DoxyCompactList}\small\item\em Removes a member object from a given smart object. \end{DoxyCompactList}\item 
void \hyperlink{group__Evas__Smart__Object__Group_ga18a8b179f94d21b2b09e19db11741061}{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+add} (\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj, const char $\ast$event, \hyperlink{Evas__Common_8h_afbde245aa36db11d8280b266235c25b2}{Evas\+\_\+\+Smart\+\_\+\+Cb} func, const void $\ast$data)
\begin{DoxyCompactList}\small\item\em Add (register) a callback function to the smart event specified by {\ttfamily event} on the smart object {\ttfamily obj}. \end{DoxyCompactList}\item 
void \hyperlink{group__Evas__Smart__Object__Group_gac0332a965f191376d30786a624bfad41}{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+priority\+\_\+add} (\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj, const char $\ast$event, \hyperlink{Evas__Common_8h_a569c486e7bbb47ad28baaec79eb1ff3b}{Evas\+\_\+\+Callback\+\_\+\+Priority} priority, \hyperlink{Evas__Common_8h_afbde245aa36db11d8280b266235c25b2}{Evas\+\_\+\+Smart\+\_\+\+Cb} func, const void $\ast$data)
\begin{DoxyCompactList}\small\item\em Add (register) a callback function to the smart event specified by {\ttfamily event} on the smart object {\ttfamily obj}. \end{DoxyCompactList}\item 
void $\ast$ \hyperlink{group__Evas__Smart__Object__Group_gaa79948c7d1bee9a75baa01e72dc4ef63}{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+del} (\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj, const char $\ast$event, \hyperlink{Evas__Common_8h_afbde245aa36db11d8280b266235c25b2}{Evas\+\_\+\+Smart\+\_\+\+Cb} func)
\begin{DoxyCompactList}\small\item\em Delete (unregister) a callback function from the smart event specified by {\ttfamily event} on the smart object {\ttfamily obj}. \end{DoxyCompactList}\item 
void $\ast$ \hyperlink{group__Evas__Smart__Object__Group_ga2163df56f3c1759f83b2996572e94fef}{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+del\+\_\+full} (\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj, const char $\ast$event, \hyperlink{Evas__Common_8h_afbde245aa36db11d8280b266235c25b2}{Evas\+\_\+\+Smart\+\_\+\+Cb} func, const void $\ast$data)
\begin{DoxyCompactList}\small\item\em Delete (unregister) a callback function from the smart event specified by {\ttfamily event} on the smart object {\ttfamily obj}. \end{DoxyCompactList}\item 
void \hyperlink{group__Evas__Smart__Object__Group_gaa81bbe0af70df6c90b8fc781c59237bc}{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+call} (\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj, const char $\ast$event, void $\ast$event\+\_\+info)
\begin{DoxyCompactList}\small\item\em Call a given smart callback on the smart object {\ttfamily obj}. \end{DoxyCompactList}\item 
int \hyperlink{group__Evas__Smart__Object__Group_gadaa928acbfcb9a91e9abb810fcbfb953}{evas\+\_\+smart\+\_\+objects\+\_\+calculate\+\_\+count\+\_\+get} (const \hyperlink{group__Evas__Canvas_ga5ff87cc4ce6bc43e3b640a6d37f73043}{Evas} $\ast$e)
\begin{DoxyCompactList}\small\item\em This gets the internal counter that counts the number of smart calculations. \end{DoxyCompactList}\item 
const void $\ast$ \hyperlink{group__Evas__Smart__Object__Group_ga726849e13d3bbc0c7ce182e3f82ce07f}{evas\+\_\+object\+\_\+smart\+\_\+interface\+\_\+get} (const \hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj, const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Retrieve an Evas smart object\textquotesingle{}s interface, by name string pointer. \end{DoxyCompactList}\item 
void $\ast$ \hyperlink{group__Evas__Smart__Object__Group_gaed3359faaae2d7cffd3e24441591da04}{evas\+\_\+object\+\_\+smart\+\_\+interface\+\_\+data\+\_\+get} (const \hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj, const \hyperlink{group__Evas__Smart__Group_gaef9b6443e1fdb6ffd3acd39981e91fee}{Evas\+\_\+\+Smart\+\_\+\+Interface} $\ast$iface)
\begin{DoxyCompactList}\small\item\em Retrieve an Evas smart object interface\textquotesingle{}s {\bfseries private data}. \end{DoxyCompactList}\end{DoxyCompactItemize}


\subsection{Detailed Description}
Functions dealing with Evas smart objects (instances). 

Smart objects are groupings of primitive Evas objects that behave as a cohesive group. For instance, a file manager icon may be a smart object composed of an image object, a text label and two rectangles that appear behind the image and text when the icon is selected. As a smart object, the normal Evas object A\+P\+I could be used on the icon object.

Besides that, generally smart objects implement a {\bfseries specific A\+P\+I}, so that users interact with its own custom features. The A\+P\+I takes form of explicit exported functions one may call and {\bfseries smart callbacks}.\hypertarget{group__Evas__Smart__Object__Group_Evas_Smart_Object_Group_Callbacks}{}\subsection{Smart events and callbacks}\label{group__Evas__Smart__Object__Group_Evas_Smart_Object_Group_Callbacks}
Smart objects can elect events (smart events, from now on) occurring inside of them to be reported back to their users via callback functions (smart callbacks). This way, you can extend Evas\textquotesingle{} own object events. They are defined by an {\bfseries event string}, which identifies them uniquely. There\textquotesingle{}s also a function prototype definition for the callback functions\+: \hyperlink{Evas__Common_8h_afbde245aa36db11d8280b266235c25b2}{Evas\+\_\+\+Smart\+\_\+\+Cb}.

When defining an \hyperlink{group__Evas__Smart__Group_gaea15f67e901bf5380cdb67dc1bb43391}{Evas\+\_\+\+Smart\+\_\+\+Class}, smart object implementors are strongly encouraged to properly set the \hyperlink{struct__Evas__Smart__Class_af7074494030024c3d0e502bca7b19067}{Evas\+\_\+\+Smart\+\_\+\+Class\+::callbacks} callbacks description array, so that the users of the smart object can have introspection on its events A\+P\+I {\bfseries at run time}.

See some \hyperlink{Example_Evas_Smart_Objects}{examples} of this group of functions.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Evas__Smart__Group}{Smart Functions} for class definitions. 
\end{DoxySeeAlso}


\subsection{Function Documentation}
\hypertarget{group__Evas__Smart__Object__Group_ga84964c53d1d5f1fb59d9799d1d47e9a9}{}\index{Smart Object Functions@{Smart Object Functions}!evas\+\_\+smart\+\_\+legacy\+\_\+type\+\_\+register@{evas\+\_\+smart\+\_\+legacy\+\_\+type\+\_\+register}}
\index{evas\+\_\+smart\+\_\+legacy\+\_\+type\+\_\+register@{evas\+\_\+smart\+\_\+legacy\+\_\+type\+\_\+register}!Smart Object Functions@{Smart Object Functions}}
\subsubsection[{evas\+\_\+smart\+\_\+legacy\+\_\+type\+\_\+register(const char $\ast$type, const Eo\+\_\+\+Class $\ast$klass)}]{\setlength{\rightskip}{0pt plus 5cm}void evas\+\_\+smart\+\_\+legacy\+\_\+type\+\_\+register (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{type, }
\item[{const {\bf Eo\+\_\+\+Class} $\ast$}]{klass}
\end{DoxyParamCaption}
)}\label{group__Evas__Smart__Object__Group_ga84964c53d1d5f1fb59d9799d1d47e9a9}


Registers an object type and its associated class. 

L\+E\+G\+A\+C\+Y M\+E\+C\+H\+A\+N\+I\+S\+M S\+U\+P\+P\+O\+R\+T.

This function is invoked in the class constructor of smart classes. It will add the type and the class into a hash table that will then be used to check the type of an object. This function has been implemented to support legacy mechanism that checks objects types by name. U\+S\+E I\+T O\+N\+L\+Y F\+O\+R L\+E\+G\+A\+C\+Y S\+U\+P\+P\+O\+R\+T. Otherwise, it is H\+I\+G\+H\+L\+Y recommended to use eo\+\_\+isa.


\begin{DoxyParams}{Parameters}
{\em type} & The type (name string) to add. \\
\hline
{\em klass} & The class to associate to the type.\\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Eo__Class_gab057ebb0171e6079a438b95184dd2498}{eo\+\_\+isa} 
\end{DoxySeeAlso}


References eina\+\_\+hash\+\_\+set().

\hypertarget{group__Evas__Smart__Object__Group_gad80de73a33446f902d4b39141a8d0a05}{}\index{Smart Object Functions@{Smart Object Functions}!evas\+\_\+object\+\_\+smart\+\_\+add@{evas\+\_\+object\+\_\+smart\+\_\+add}}
\index{evas\+\_\+object\+\_\+smart\+\_\+add@{evas\+\_\+object\+\_\+smart\+\_\+add}!Smart Object Functions@{Smart Object Functions}}
\subsubsection[{evas\+\_\+object\+\_\+smart\+\_\+add(\+Evas $\ast$e, Evas\+\_\+\+Smart $\ast$s)}]{\setlength{\rightskip}{0pt plus 5cm}{\bf Evas\+\_\+\+Object}$\ast$ evas\+\_\+object\+\_\+smart\+\_\+add (
\begin{DoxyParamCaption}
\item[{{\bf Evas} $\ast$}]{e, }
\item[{{\bf Evas\+\_\+\+Smart} $\ast$}]{s}
\end{DoxyParamCaption}
)}\label{group__Evas__Smart__Object__Group_gad80de73a33446f902d4b39141a8d0a05}


Instantiates a new smart object described by {\ttfamily s}. 


\begin{DoxyParams}{Parameters}
{\em e} & the canvas on which to add the object \\
\hline
{\em s} & the \hyperlink{Evas__Common_8h_a7cdfd1afece1cad64c413eb9a778ddbb}{Evas\+\_\+\+Smart} describing the smart object \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a new \hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} handle
\end{DoxyReturn}
This is the function one should use when defining the public function {\bfseries adding} an instance of the new smart object to a given canvas. It will take care of setting all of its internals to work as they should, if the user set things properly, as seem on the \hyperlink{group__Evas__Smart__Group_ga58dc94af6f064b39b2bf0155908fbe52}{E\+V\+A\+S\+\_\+\+S\+M\+A\+R\+T\+\_\+\+S\+U\+B\+C\+L\+A\+S\+S\+\_\+\+N\+E\+W}, for example. 

References eo\+\_\+add.

\hypertarget{group__Evas__Smart__Object__Group_ga6845c17effe796430cb4fc5f2cfccef0}{}\index{Smart Object Functions@{Smart Object Functions}!evas\+\_\+object\+\_\+smart\+\_\+member\+\_\+add@{evas\+\_\+object\+\_\+smart\+\_\+member\+\_\+add}}
\index{evas\+\_\+object\+\_\+smart\+\_\+member\+\_\+add@{evas\+\_\+object\+\_\+smart\+\_\+member\+\_\+add}!Smart Object Functions@{Smart Object Functions}}
\subsubsection[{evas\+\_\+object\+\_\+smart\+\_\+member\+\_\+add(\+Evas\+\_\+\+Object $\ast$obj, Evas\+\_\+\+Object $\ast$smart\+\_\+obj)}]{\setlength{\rightskip}{0pt plus 5cm}void evas\+\_\+object\+\_\+smart\+\_\+member\+\_\+add (
\begin{DoxyParamCaption}
\item[{{\bf Evas\+\_\+\+Object} $\ast$}]{obj, }
\item[{{\bf Evas\+\_\+\+Object} $\ast$}]{smart\+\_\+obj}
\end{DoxyParamCaption}
)}\label{group__Evas__Smart__Object__Group_ga6845c17effe796430cb4fc5f2cfccef0}


Set an Evas object as a member of a given smart object. 


\begin{DoxyParams}{Parameters}
{\em obj} & The member object \\
\hline
{\em smart\+\_\+obj} & The smart object\\
\hline
\end{DoxyParams}
Members will automatically be stacked and layered together with the smart object. The various stacking functions will operate on members relative to the other members instead of the entire canvas, since they now live on an exclusive layer (see \hyperlink{group__Evas__Font__Group_ga27584456485bb95792568ddc2a40f55a}{evas\+\_\+object\+\_\+stack\+\_\+above()}, for more details).

Any {\ttfamily smart\+\_\+obj} object\textquotesingle{}s specific implementation of the {\ttfamily member\+\_\+add()} smart function will take place too, naturally.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Evas__Smart__Object__Group_ga12034359ab780a3a0e8b20b83475ed15}{evas\+\_\+object\+\_\+smart\+\_\+member\+\_\+del()} 

evas\+\_\+object\+\_\+smart\+\_\+members\+\_\+get() 
\end{DoxySeeAlso}
\hypertarget{group__Evas__Smart__Object__Group_ga12034359ab780a3a0e8b20b83475ed15}{}\index{Smart Object Functions@{Smart Object Functions}!evas\+\_\+object\+\_\+smart\+\_\+member\+\_\+del@{evas\+\_\+object\+\_\+smart\+\_\+member\+\_\+del}}
\index{evas\+\_\+object\+\_\+smart\+\_\+member\+\_\+del@{evas\+\_\+object\+\_\+smart\+\_\+member\+\_\+del}!Smart Object Functions@{Smart Object Functions}}
\subsubsection[{evas\+\_\+object\+\_\+smart\+\_\+member\+\_\+del(\+Evas\+\_\+\+Object $\ast$obj)}]{\setlength{\rightskip}{0pt plus 5cm}void evas\+\_\+object\+\_\+smart\+\_\+member\+\_\+del (
\begin{DoxyParamCaption}
\item[{{\bf Evas\+\_\+\+Object} $\ast$}]{obj}
\end{DoxyParamCaption}
)}\label{group__Evas__Smart__Object__Group_ga12034359ab780a3a0e8b20b83475ed15}


Removes a member object from a given smart object. 


\begin{DoxyParams}{Parameters}
{\em obj} & the member object\\
\hline
\end{DoxyParams}
This removes a member object from a smart object, if it was added to any. The object will still be on the canvas, but no longer associated with whichever smart object it was associated with.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Evas__Smart__Object__Group_ga6845c17effe796430cb4fc5f2cfccef0}{evas\+\_\+object\+\_\+smart\+\_\+member\+\_\+add()} for more details 

evas\+\_\+object\+\_\+smart\+\_\+members\+\_\+get() 
\end{DoxySeeAlso}


References eo\+\_\+data\+\_\+scope\+\_\+get().

\hypertarget{group__Evas__Smart__Object__Group_ga18a8b179f94d21b2b09e19db11741061}{}\index{Smart Object Functions@{Smart Object Functions}!evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+add@{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+add}}
\index{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+add@{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+add}!Smart Object Functions@{Smart Object Functions}}
\subsubsection[{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+add(\+Evas\+\_\+\+Object $\ast$obj, const char $\ast$event, Evas\+\_\+\+Smart\+\_\+\+Cb func, const void $\ast$data)}]{\setlength{\rightskip}{0pt plus 5cm}void evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+add (
\begin{DoxyParamCaption}
\item[{{\bf Evas\+\_\+\+Object} $\ast$}]{obj, }
\item[{const char $\ast$}]{event, }
\item[{{\bf Evas\+\_\+\+Smart\+\_\+\+Cb}}]{func, }
\item[{const void $\ast$}]{data}
\end{DoxyParamCaption}
)}\label{group__Evas__Smart__Object__Group_ga18a8b179f94d21b2b09e19db11741061}


Add (register) a callback function to the smart event specified by {\ttfamily event} on the smart object {\ttfamily obj}. 


\begin{DoxyParams}{Parameters}
{\em obj} & a smart object \\
\hline
{\em event} & the event\textquotesingle{}s name string \\
\hline
{\em func} & the callback function \\
\hline
{\em data} & user data to be passed to the callback function\\
\hline
\end{DoxyParams}
Smart callbacks look very similar to Evas callbacks, but are implemented as smart object\textquotesingle{}s custom ones.

This function adds a function callback to an smart object when the event named {\ttfamily event} occurs in it. The function is {\ttfamily func}.

In the event of a memory allocation error during addition of the callback to the object, \hyperlink{group__Evas__Main__Group_gacfae4f589c777003f58d51e502c52835}{evas\+\_\+alloc\+\_\+error()} should be used to determine the nature of the error, if any, and the program should sensibly try and recover.

A smart callback function must have the \hyperlink{Evas__Common_8h_afbde245aa36db11d8280b266235c25b2}{Evas\+\_\+\+Smart\+\_\+\+Cb} prototype definition. The first parameter ({\ttfamily data}) in this definition will have the same value passed to \hyperlink{group__Evas__Smart__Object__Group_ga18a8b179f94d21b2b09e19db11741061}{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+add()} as the {\ttfamily data} parameter, at runtime. The second parameter {\ttfamily obj} is a handle to the object on which the event occurred. The third parameter, {\ttfamily event\+\_\+info}, is a pointer to data which is totally dependent on the smart object\textquotesingle{}s implementation and semantic for the given event.

There is an infrastructure for introspection on smart objects\textquotesingle{} events (see \hyperlink{group__Evas__Smart__Group_ga21bfd8ca489ecc08a0c3c9f66764f06d}{evas\+\_\+smart\+\_\+callbacks\+\_\+descriptions\+\_\+get()}), but no internal smart objects on Evas implement them yet.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Evas__Smart__Object__Group_Evas_Smart_Object_Group_Callbacks}{Smart events and callbacks} for more details.

\hyperlink{group__Evas__Smart__Object__Group_gaa79948c7d1bee9a75baa01e72dc4ef63}{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+del()} 
\end{DoxySeeAlso}


References E\+V\+A\+S\+\_\+\+C\+A\+L\+L\+B\+A\+C\+K\+\_\+\+P\+R\+I\+O\+R\+I\+T\+Y\+\_\+\+D\+E\+F\+A\+U\+L\+T, and evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+priority\+\_\+add().

\hypertarget{group__Evas__Smart__Object__Group_gac0332a965f191376d30786a624bfad41}{}\index{Smart Object Functions@{Smart Object Functions}!evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+priority\+\_\+add@{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+priority\+\_\+add}}
\index{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+priority\+\_\+add@{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+priority\+\_\+add}!Smart Object Functions@{Smart Object Functions}}
\subsubsection[{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+priority\+\_\+add(\+Evas\+\_\+\+Object $\ast$obj, const char $\ast$event, Evas\+\_\+\+Callback\+\_\+\+Priority priority, Evas\+\_\+\+Smart\+\_\+\+Cb func, const void $\ast$data)}]{\setlength{\rightskip}{0pt plus 5cm}void evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+priority\+\_\+add (
\begin{DoxyParamCaption}
\item[{{\bf Evas\+\_\+\+Object} $\ast$}]{obj, }
\item[{const char $\ast$}]{event, }
\item[{{\bf Evas\+\_\+\+Callback\+\_\+\+Priority}}]{priority, }
\item[{{\bf Evas\+\_\+\+Smart\+\_\+\+Cb}}]{func, }
\item[{const void $\ast$}]{data}
\end{DoxyParamCaption}
)}\label{group__Evas__Smart__Object__Group_gac0332a965f191376d30786a624bfad41}


Add (register) a callback function to the smart event specified by {\ttfamily event} on the smart object {\ttfamily obj}. 

Except for the priority field, it\textquotesingle{}s exactly the same as \hyperlink{group__Evas__Smart__Object__Group_ga18a8b179f94d21b2b09e19db11741061}{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+add}


\begin{DoxyParams}{Parameters}
{\em obj} & a smart object \\
\hline
{\em event} & the event\textquotesingle{}s name string \\
\hline
{\em priority} & The priority of the callback, lower values called first. \\
\hline
{\em func} & the callback function \\
\hline
{\em data} & user data to be passed to the callback function\\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Evas__Smart__Object__Group_ga18a8b179f94d21b2b09e19db11741061}{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+add} 
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+1 
\end{DoxySince}


References eina\+\_\+inlist\+\_\+append(), E\+I\+N\+A\+\_\+\+I\+N\+L\+I\+S\+T\+\_\+\+G\+E\+T, eo\+\_\+base\+\_\+legacy\+\_\+only\+\_\+event\+\_\+description\+\_\+get(), and eo\+\_\+data\+\_\+scope\+\_\+get().



Referenced by evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+add().

\hypertarget{group__Evas__Smart__Object__Group_gaa79948c7d1bee9a75baa01e72dc4ef63}{}\index{Smart Object Functions@{Smart Object Functions}!evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+del@{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+del}}
\index{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+del@{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+del}!Smart Object Functions@{Smart Object Functions}}
\subsubsection[{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+del(\+Evas\+\_\+\+Object $\ast$obj, const char $\ast$event, Evas\+\_\+\+Smart\+\_\+\+Cb func)}]{\setlength{\rightskip}{0pt plus 5cm}void$\ast$ evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+del (
\begin{DoxyParamCaption}
\item[{{\bf Evas\+\_\+\+Object} $\ast$}]{obj, }
\item[{const char $\ast$}]{event, }
\item[{{\bf Evas\+\_\+\+Smart\+\_\+\+Cb}}]{func}
\end{DoxyParamCaption}
)}\label{group__Evas__Smart__Object__Group_gaa79948c7d1bee9a75baa01e72dc4ef63}


Delete (unregister) a callback function from the smart event specified by {\ttfamily event} on the smart object {\ttfamily obj}. 


\begin{DoxyParams}{Parameters}
{\em obj} & a smart object \\
\hline
{\em event} & the event\textquotesingle{}s name string \\
\hline
{\em func} & the callback function \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
the data pointer
\end{DoxyReturn}
This function removes {\bfseries the first} added smart callback on the object {\ttfamily obj} matching the event name {\ttfamily event} and the registered function pointer {\ttfamily func}. If the removal is successful it will also return the data pointer that was passed to \hyperlink{group__Evas__Smart__Object__Group_ga18a8b179f94d21b2b09e19db11741061}{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+add()} (that will be the same as the parameter) when the callback(s) was(were) added to the canvas. If not successful {\ttfamily N\+U\+L\+L} will be returned.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Evas__Smart__Object__Group_ga18a8b179f94d21b2b09e19db11741061}{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+add()} for more details. 
\end{DoxySeeAlso}


References E\+I\+N\+A\+\_\+\+I\+N\+L\+I\+S\+T\+\_\+\+F\+O\+R\+E\+A\+C\+H, E\+I\+N\+A\+\_\+\+I\+N\+L\+I\+S\+T\+\_\+\+G\+E\+T, eina\+\_\+inlist\+\_\+remove(), eo\+\_\+base\+\_\+legacy\+\_\+only\+\_\+event\+\_\+description\+\_\+get(), and eo\+\_\+data\+\_\+scope\+\_\+get().

\hypertarget{group__Evas__Smart__Object__Group_ga2163df56f3c1759f83b2996572e94fef}{}\index{Smart Object Functions@{Smart Object Functions}!evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+del\+\_\+full@{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+del\+\_\+full}}
\index{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+del\+\_\+full@{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+del\+\_\+full}!Smart Object Functions@{Smart Object Functions}}
\subsubsection[{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+del\+\_\+full(\+Evas\+\_\+\+Object $\ast$obj, const char $\ast$event, Evas\+\_\+\+Smart\+\_\+\+Cb func, const void $\ast$data)}]{\setlength{\rightskip}{0pt plus 5cm}void$\ast$ evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+del\+\_\+full (
\begin{DoxyParamCaption}
\item[{{\bf Evas\+\_\+\+Object} $\ast$}]{obj, }
\item[{const char $\ast$}]{event, }
\item[{{\bf Evas\+\_\+\+Smart\+\_\+\+Cb}}]{func, }
\item[{const void $\ast$}]{data}
\end{DoxyParamCaption}
)}\label{group__Evas__Smart__Object__Group_ga2163df56f3c1759f83b2996572e94fef}


Delete (unregister) a callback function from the smart event specified by {\ttfamily event} on the smart object {\ttfamily obj}. 


\begin{DoxyParams}{Parameters}
{\em obj} & a smart object \\
\hline
{\em event} & the event\textquotesingle{}s name string \\
\hline
{\em func} & the callback function \\
\hline
{\em data} & the data pointer that was passed to the callback \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
the data pointer
\end{DoxyReturn}
This function removes {\bfseries the first} added smart callback on the object {\ttfamily obj} matching the event name {\ttfamily event}, the registered function pointer {\ttfamily func} and the callback data pointer {\ttfamily data}. If the removal is successful it will also return the data pointer that was passed to \hyperlink{group__Evas__Smart__Object__Group_ga18a8b179f94d21b2b09e19db11741061}{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+add()} (that will be the same as the parameter) when the callback(s) was(were) added to the canvas. If not successful {\ttfamily N\+U\+L\+L} will be returned. A common use would be to remove an exact match of a callback

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Evas__Smart__Object__Group_ga18a8b179f94d21b2b09e19db11741061}{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+add()} for more details. 
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+2
\end{DoxySince}
\begin{DoxyNote}{Note}
To delete all smart event callbacks which match {\ttfamily type} and {\ttfamily func}, use \hyperlink{group__Evas__Smart__Object__Group_gaa79948c7d1bee9a75baa01e72dc4ef63}{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+del()}. 
\end{DoxyNote}


References E\+I\+N\+A\+\_\+\+I\+N\+L\+I\+S\+T\+\_\+\+F\+O\+R\+E\+A\+C\+H, E\+I\+N\+A\+\_\+\+I\+N\+L\+I\+S\+T\+\_\+\+G\+E\+T, eina\+\_\+inlist\+\_\+remove(), eo\+\_\+base\+\_\+legacy\+\_\+only\+\_\+event\+\_\+description\+\_\+get(), and eo\+\_\+data\+\_\+scope\+\_\+get().

\hypertarget{group__Evas__Smart__Object__Group_gaa81bbe0af70df6c90b8fc781c59237bc}{}\index{Smart Object Functions@{Smart Object Functions}!evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+call@{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+call}}
\index{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+call@{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+call}!Smart Object Functions@{Smart Object Functions}}
\subsubsection[{evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+call(\+Evas\+\_\+\+Object $\ast$obj, const char $\ast$event, void $\ast$event\+\_\+info)}]{\setlength{\rightskip}{0pt plus 5cm}void evas\+\_\+object\+\_\+smart\+\_\+callback\+\_\+call (
\begin{DoxyParamCaption}
\item[{{\bf Evas\+\_\+\+Object} $\ast$}]{obj, }
\item[{const char $\ast$}]{event, }
\item[{void $\ast$}]{event\+\_\+info}
\end{DoxyParamCaption}
)}\label{group__Evas__Smart__Object__Group_gaa81bbe0af70df6c90b8fc781c59237bc}


Call a given smart callback on the smart object {\ttfamily obj}. 


\begin{DoxyParams}{Parameters}
{\em obj} & the smart object \\
\hline
{\em event} & the event\textquotesingle{}s name string \\
\hline
{\em event\+\_\+info} & pointer to an event specific struct or information to pass to the callback functions registered on this smart event\\
\hline
\end{DoxyParams}
This should be called {\bfseries internally}, from the smart object\textquotesingle{}s own code, when some specific event has occurred and the implementor wants is to pertain to the object\textquotesingle{}s events A\+P\+I (see \hyperlink{group__Evas__Smart__Object__Group_Evas_Smart_Object_Group_Callbacks}{Smart events and callbacks}). The documentation for the smart object should include a list of possible events and what type of {\ttfamily event\+\_\+info} to expect for each of them. Also, when defining an \hyperlink{group__Evas__Smart__Group_gaea15f67e901bf5380cdb67dc1bb43391}{Evas\+\_\+\+Smart\+\_\+\+Class}, smart object implementors are strongly encouraged to properly set the \hyperlink{struct__Evas__Smart__Class_af7074494030024c3d0e502bca7b19067}{Evas\+\_\+\+Smart\+\_\+\+Class\+::callbacks} callbacks description array, so that the users of the smart object can have introspection on its events A\+P\+I {\bfseries at run time}. 

References eo\+\_\+base\+\_\+legacy\+\_\+only\+\_\+event\+\_\+description\+\_\+get().

\hypertarget{group__Evas__Smart__Object__Group_gadaa928acbfcb9a91e9abb810fcbfb953}{}\index{Smart Object Functions@{Smart Object Functions}!evas\+\_\+smart\+\_\+objects\+\_\+calculate\+\_\+count\+\_\+get@{evas\+\_\+smart\+\_\+objects\+\_\+calculate\+\_\+count\+\_\+get}}
\index{evas\+\_\+smart\+\_\+objects\+\_\+calculate\+\_\+count\+\_\+get@{evas\+\_\+smart\+\_\+objects\+\_\+calculate\+\_\+count\+\_\+get}!Smart Object Functions@{Smart Object Functions}}
\subsubsection[{evas\+\_\+smart\+\_\+objects\+\_\+calculate\+\_\+count\+\_\+get(const Evas $\ast$e)}]{\setlength{\rightskip}{0pt plus 5cm}int evas\+\_\+smart\+\_\+objects\+\_\+calculate\+\_\+count\+\_\+get (
\begin{DoxyParamCaption}
\item[{const {\bf Evas} $\ast$}]{e}
\end{DoxyParamCaption}
)}\label{group__Evas__Smart__Object__Group_gadaa928acbfcb9a91e9abb810fcbfb953}


This gets the internal counter that counts the number of smart calculations. 


\begin{DoxyParams}{Parameters}
{\em e} & The canvas to get the calculate counter from\\
\hline
\end{DoxyParams}
Whenever evas performs smart object calculations on the whole canvas it increments a counter by 1. This is the smart object calculate counter that this function returns the value of. It starts at the value of 0 and will increase (and eventually wrap around to negative values and so on) by 1 every time objects are calculated. You can use this counter to ensure you don\textquotesingle{}t re-\/do calculations withint the same calculation generation/run if the calculations maybe cause self-\/feeding effects.

\begin{DoxySince}{Since}
1.\+1
\end{DoxySince}
Whenever evas performs smart object calculations on the whole canvas it increments a counter by 1. This is the smart object calculate counter that this function returns the value of. It starts at the value of 0 and will increase (and eventually wrap around to negative values and so on) by 1 every time objects are calculated. You can use this counter to ensure you don\textquotesingle{}t re-\/do calculations withint the same calculation generation/run if the calculations maybe cause self-\/feeding effects.

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


References evas\+\_\+canvas\+\_\+smart\+\_\+objects\+\_\+calculate\+\_\+count\+\_\+get().

\hypertarget{group__Evas__Smart__Object__Group_ga726849e13d3bbc0c7ce182e3f82ce07f}{}\index{Smart Object Functions@{Smart Object Functions}!evas\+\_\+object\+\_\+smart\+\_\+interface\+\_\+get@{evas\+\_\+object\+\_\+smart\+\_\+interface\+\_\+get}}
\index{evas\+\_\+object\+\_\+smart\+\_\+interface\+\_\+get@{evas\+\_\+object\+\_\+smart\+\_\+interface\+\_\+get}!Smart Object Functions@{Smart Object Functions}}
\subsubsection[{evas\+\_\+object\+\_\+smart\+\_\+interface\+\_\+get(const Evas\+\_\+\+Object $\ast$obj, const char $\ast$name)}]{\setlength{\rightskip}{0pt plus 5cm}const void$\ast$ evas\+\_\+object\+\_\+smart\+\_\+interface\+\_\+get (
\begin{DoxyParamCaption}
\item[{const {\bf Evas\+\_\+\+Object} $\ast$}]{obj, }
\item[{const char $\ast$}]{name}
\end{DoxyParamCaption}
)}\label{group__Evas__Smart__Object__Group_ga726849e13d3bbc0c7ce182e3f82ce07f}


Retrieve an Evas smart object\textquotesingle{}s interface, by name string pointer. 


\begin{DoxyParams}{Parameters}
{\em obj} & An Evas smart object. \\
\hline
{\em name} & Name string of the desired interface, which must be the same pointer used at the interface\textquotesingle{}s declarion, when creating the smart object {\itshape obj}.\\
\hline
\end{DoxyParams}
\begin{DoxySince}{Since}
1.\+7
\end{DoxySince}
\begin{DoxyReturn}{Returns}
The interface\textquotesingle{}s handle pointer, if found, {\ttfamily N\+U\+L\+L} otherwise. 
\end{DoxyReturn}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{evas-smart-interface_8c-example}{evas-\/smart-\/interface.\+c}.\end{Desc}


References eo\+\_\+isa(), and \+\_\+\+Evas\+\_\+\+Smart\+\_\+\+Interface\+::name.

\hypertarget{group__Evas__Smart__Object__Group_gaed3359faaae2d7cffd3e24441591da04}{}\index{Smart Object Functions@{Smart Object Functions}!evas\+\_\+object\+\_\+smart\+\_\+interface\+\_\+data\+\_\+get@{evas\+\_\+object\+\_\+smart\+\_\+interface\+\_\+data\+\_\+get}}
\index{evas\+\_\+object\+\_\+smart\+\_\+interface\+\_\+data\+\_\+get@{evas\+\_\+object\+\_\+smart\+\_\+interface\+\_\+data\+\_\+get}!Smart Object Functions@{Smart Object Functions}}
\subsubsection[{evas\+\_\+object\+\_\+smart\+\_\+interface\+\_\+data\+\_\+get(const Evas\+\_\+\+Object $\ast$obj, const Evas\+\_\+\+Smart\+\_\+\+Interface $\ast$iface)}]{\setlength{\rightskip}{0pt plus 5cm}void$\ast$ evas\+\_\+object\+\_\+smart\+\_\+interface\+\_\+data\+\_\+get (
\begin{DoxyParamCaption}
\item[{const {\bf Evas\+\_\+\+Object} $\ast$}]{obj, }
\item[{const {\bf Evas\+\_\+\+Smart\+\_\+\+Interface} $\ast$}]{iface}
\end{DoxyParamCaption}
)}\label{group__Evas__Smart__Object__Group_gaed3359faaae2d7cffd3e24441591da04}


Retrieve an Evas smart object interface\textquotesingle{}s {\bfseries private data}. 


\begin{DoxyParams}{Parameters}
{\em obj} & An Evas smart object. \\
\hline
{\em iface} & The given object\textquotesingle{}s interface handle.\\
\hline
\end{DoxyParams}
\begin{DoxySince}{Since}
1.\+7
\end{DoxySince}
\begin{DoxyReturn}{Returns}
The object interface\textquotesingle{}s private data blob pointer, if found, {\ttfamily N\+U\+L\+L} otherwise. 
\end{DoxyReturn}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{evas-smart-interface_8c-example}{evas-\/smart-\/interface.\+c}.\end{Desc}


References eo\+\_\+data\+\_\+scope\+\_\+get().

