\hypertarget{group__Evas__Object__Box__Group}{}\doxysection{Box Smart Object}
\label{group__Evas__Object__Box__Group}\index{Box Smart Object@{Box Smart Object}}


A box is a convenience smart object that packs children inside it in {\bfseries{sequence}}, using a layouting function specified by the user.  


\doxysubsection*{Data Structures}
\begin{DoxyCompactItemize}
\item 
struct \mbox{\hyperlink{struct__Evas__Object__Box__Api}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api}}
\begin{DoxyCompactList}\small\item\em This structure should be used by any smart class inheriting from the box\textquotesingle{}s one, to provide custom box behavior that could not be achieved only by providing a layout function, with \mbox{\hyperlink{group__Evas__Object__Box__Group_gacabb47de0d8706b4c8628b519b2d1494}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+set()}}. \end{DoxyCompactList}\item 
struct \mbox{\hyperlink{struct__Evas__Object__Box__Data}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}}
\begin{DoxyCompactList}\small\item\em This structure augments clipped smart object\textquotesingle{}s instance data, providing extra members required by generic box implementation. \end{DoxyCompactList}\item 
struct \mbox{\hyperlink{struct__Evas__Object__Box__Option}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}}
\begin{DoxyCompactList}\small\item\em \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} struct fields \end{DoxyCompactList}\end{DoxyCompactItemize}
\doxysubsection*{Macros}
\begin{DoxyCompactItemize}
\item 
\mbox{\Hypertarget{group__Evas__Object__Box__Group_gadb2f736aab172787d705baab2699dfe4}\label{group__Evas__Object__Box__Group_gadb2f736aab172787d705baab2699dfe4}} 
\#define {\bfseries EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+VERSION}~1
\begin{DoxyCompactList}\small\item\em Current version for Evas box object smart class, a value that goes to \mbox{\hyperlink{struct__Evas__Object__Box__Api_a7d6c66ca4c27f54096276677ba54a38a}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api\+::version}}. \end{DoxyCompactList}\item 
\#define \mbox{\hyperlink{group__Evas__Object__Box__Group_ga118b1b5bc278185207e7651911637ac8}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT}}(smart\+\_\+class\+\_\+init)~\{smart\+\_\+class\+\_\+init, \mbox{\hyperlink{group__Evas__Object__Box__Group_gadb2f736aab172787d705baab2699dfe4}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+VERSION}}, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL\}
\begin{DoxyCompactList}\small\item\em Initializer for a whole \mbox{\hyperlink{group__Evas__Object__Box__Group_ga2a8fbeeab4f5ae23e7bc1b291e27c5e1}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api}} structure, with {\ttfamily NULL} values on its specific fields. \end{DoxyCompactList}\item 
\#define \mbox{\hyperlink{group__Evas__Object__Box__Group_gacfe469ef2fc811ab4af8c77105bf4baa}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT\+\_\+\+NULL}}~\mbox{\hyperlink{group__Evas__Object__Box__Group_ga118b1b5bc278185207e7651911637ac8}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT}}(\mbox{\hyperlink{group__Evas__Smart__Group_ga223f5d420c1e22275cd6490cd77c85f0}{EVAS\+\_\+\+SMART\+\_\+\+CLASS\+\_\+\+INIT\+\_\+\+NULL}})
\begin{DoxyCompactList}\small\item\em Initialize to zero out a whole \mbox{\hyperlink{group__Evas__Object__Box__Group_ga2a8fbeeab4f5ae23e7bc1b291e27c5e1}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api}} structure. \end{DoxyCompactList}\item 
\#define \mbox{\hyperlink{group__Evas__Object__Box__Group_gabab7b773ecb31ecbf661646d5db1bea1}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT\+\_\+\+VERSION}}~\mbox{\hyperlink{group__Evas__Object__Box__Group_ga118b1b5bc278185207e7651911637ac8}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT}}(\mbox{\hyperlink{group__Evas__Smart__Group_gaaa610a135c79167162405b56cffe8562}{EVAS\+\_\+\+SMART\+\_\+\+CLASS\+\_\+\+INIT\+\_\+\+VERSION}})
\begin{DoxyCompactList}\small\item\em Initialize to zero out a whole \mbox{\hyperlink{group__Evas__Object__Box__Group_ga2a8fbeeab4f5ae23e7bc1b291e27c5e1}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api}} structure and set a specific version on it. \end{DoxyCompactList}\item 
\#define \mbox{\hyperlink{group__Evas__Object__Box__Group_gad35b8c6b395f976397abbb6f964878e7}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT\+\_\+\+NAME\+\_\+\+VERSION}}(name)~\mbox{\hyperlink{group__Evas__Object__Box__Group_ga118b1b5bc278185207e7651911637ac8}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT}}(\mbox{\hyperlink{group__Evas__Smart__Group_gaff2bbd5bb79e51ad8d31f98106caff77}{EVAS\+\_\+\+SMART\+\_\+\+CLASS\+\_\+\+INIT\+\_\+\+NAME\+\_\+\+VERSION}}(name))
\begin{DoxyCompactList}\small\item\em Initialize to zero out a whole \mbox{\hyperlink{group__Evas__Object__Box__Group_ga2a8fbeeab4f5ae23e7bc1b291e27c5e1}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api}} structure and set its name and version. \end{DoxyCompactList}\end{DoxyCompactItemize}
\doxysubsection*{Typedefs}
\begin{DoxyCompactItemize}
\item 
\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga2a8fbeeab4f5ae23e7bc1b291e27c5e1}\label{group__Evas__Object__Box__Group_ga2a8fbeeab4f5ae23e7bc1b291e27c5e1}} 
typedef struct \mbox{\hyperlink{struct__Evas__Object__Box__Api}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api}} {\bfseries Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api}
\begin{DoxyCompactList}\small\item\em Smart class extension, providing extra box object requirements. \end{DoxyCompactList}\item 
\mbox{\Hypertarget{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}\label{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}} 
typedef struct \mbox{\hyperlink{struct__Evas__Object__Box__Data}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} {\bfseries Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}
\begin{DoxyCompactList}\small\item\em Smart object instance data, providing box object requirements. \end{DoxyCompactList}\item 
typedef struct \mbox{\hyperlink{struct__Evas__Object__Box__Option}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}}
\begin{DoxyCompactList}\small\item\em The base structure for a box option. \end{DoxyCompactList}\item 
typedef void($\ast$ \mbox{\hyperlink{group__Evas__Object__Box__Group_gad3ef5177a00dcda0c08c86287419d5b5}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Layout}}) (\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$o, \mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$priv, void $\ast$user\+\_\+data)
\begin{DoxyCompactList}\small\item\em Function signature for an Evas box object layouting routine. \end{DoxyCompactList}\end{DoxyCompactItemize}
\doxysubsection*{Functions}
\begin{DoxyCompactItemize}
\item 
EVAS\+\_\+\+API void \mbox{\hyperlink{group__Evas__Object__Box__Group_gab363f1603f6897dc1ebb8271b7917d2b}{evas\+\_\+object\+\_\+box\+\_\+align\+\_\+set}} (Evas\+\_\+\+Box $\ast$obj, double horizontal, double vertical)
\begin{DoxyCompactList}\small\item\em Set the alignment of the whole bounding box of contents, for a given box object. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API void \mbox{\hyperlink{group__Evas__Object__Box__Group_ga0feb8b7c8bef4b7e60884a885a9778e7}{evas\+\_\+object\+\_\+box\+\_\+align\+\_\+get}} (const Evas\+\_\+\+Box $\ast$obj, double $\ast$horizontal, double $\ast$vertical)
\begin{DoxyCompactList}\small\item\em Get the alignment of the whole bounding box of contents, for a given box object. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API void \mbox{\hyperlink{group__Evas__Object__Box__Group_gab220426e0cd46980ee7b8fde662bfb19}{evas\+\_\+object\+\_\+box\+\_\+padding\+\_\+set}} (Evas\+\_\+\+Box $\ast$obj, int horizontal, int vertical)
\begin{DoxyCompactList}\small\item\em Set the (space) padding between cells set for a given box object. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API void \mbox{\hyperlink{group__Evas__Object__Box__Group_gad462c975b42819fdd4e81a8f4fe06116}{evas\+\_\+object\+\_\+box\+\_\+padding\+\_\+get}} (const Evas\+\_\+\+Box $\ast$obj, int $\ast$horizontal, int $\ast$vertical)
\begin{DoxyCompactList}\small\item\em Get the (space) padding between cells set for a given box object. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API void \mbox{\hyperlink{group__Evas__Object__Box__Group_gacabb47de0d8706b4c8628b519b2d1494}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+set}} (Evas\+\_\+\+Box $\ast$obj, \mbox{\hyperlink{group__Evas__Object__Box__Group_gad3ef5177a00dcda0c08c86287419d5b5}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Layout}} cb, const void $\ast$data, \mbox{\hyperlink{group__Eina__Types__Group_gadbac560ba2bca5c61d97bfbb542018f3}{Eina\+\_\+\+Free\+\_\+\+Cb}} free\+\_\+data)
\begin{DoxyCompactList}\small\item\em Set a new layouting function to a given box object. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API void \mbox{\hyperlink{group__Evas__Object__Box__Group_gaaaaf1c9ba2bd49e51108c1202aea9c3c}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+horizontal}} (Evas\+\_\+\+Box $\ast$obj, \mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$priv, void $\ast$data)
\begin{DoxyCompactList}\small\item\em Layout function which sets the box o to a (basic) horizontal box. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API void \mbox{\hyperlink{group__Evas__Object__Box__Group_ga8836b5287edf32f687e2ad05a140e836}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+vertical}} (Evas\+\_\+\+Box $\ast$obj, \mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$priv, void $\ast$data)
\begin{DoxyCompactList}\small\item\em Layout function which sets the box o to a (basic) vertical box. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API void \mbox{\hyperlink{group__Evas__Object__Box__Group_ga2e519c420f94629ef313a009f68391bb}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+homogeneous\+\_\+max\+\_\+size\+\_\+horizontal}} (Evas\+\_\+\+Box $\ast$obj, \mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$priv, void $\ast$data)
\begin{DoxyCompactList}\small\item\em Layout function which sets the box o to a maximum size, homogeneous horizontal box. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API void \mbox{\hyperlink{group__Evas__Object__Box__Group_ga5e4ae5bcafc724706824418969faeb7f}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+flow\+\_\+vertical}} (Evas\+\_\+\+Box $\ast$obj, \mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$priv, void $\ast$data)
\begin{DoxyCompactList}\small\item\em Layout function which sets the box o to a flow vertical box. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$ \mbox{\hyperlink{group__Evas__Object__Box__Group_gaa2bdebeed69e85ca92778823a1e221fa}{evas\+\_\+object\+\_\+box\+\_\+insert\+\_\+after}} (Evas\+\_\+\+Box $\ast$obj, \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$child, const \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$reference)
\begin{DoxyCompactList}\small\item\em Insert a new child object after another existing one, in a given box object o. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} \mbox{\hyperlink{group__Evas__Object__Box__Group_ga99a76c1e4da6f54a72358ae0f56cf541}{evas\+\_\+object\+\_\+box\+\_\+remove\+\_\+all}} (Evas\+\_\+\+Box $\ast$obj, \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} clear)
\begin{DoxyCompactList}\small\item\em Remove all child objects from a box object, unparenting them again. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Iterator__Group_ga15b975bb881d955249ce13d4ebc96948}{Eina\+\_\+\+Iterator}} $\ast$ \mbox{\hyperlink{group__Evas__Object__Box__Group_gaf42e4d1d631ff8b62c2d9ce41862f877}{evas\+\_\+object\+\_\+box\+\_\+iterator\+\_\+new}} (const Evas\+\_\+\+Box $\ast$obj)
\begin{DoxyCompactList}\small\item\em Get an iterator to walk the list of children of a given box object. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$ \mbox{\hyperlink{group__Evas__Object__Box__Group_ga9592012d38d1ca93fbf83b07dabcbfd8}{evas\+\_\+object\+\_\+box\+\_\+add\+\_\+to}} (Evas\+\_\+\+Box $\ast$obj)
\begin{DoxyCompactList}\small\item\em Add a new box as a child of a given smart object. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$ \mbox{\hyperlink{group__Evas__Object__Box__Group_ga901a603e429bdf752f8c184b418070ae}{evas\+\_\+object\+\_\+box\+\_\+append}} (Evas\+\_\+\+Box $\ast$obj, \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$child)
\begin{DoxyCompactList}\small\item\em Append a new child object to the given box object o. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API int \mbox{\hyperlink{group__Evas__Object__Box__Group_ga400335f929e0bf549a90210ce9555a43}{evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+id\+\_\+get}} (const Evas\+\_\+\+Box $\ast$obj, const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Get the numerical identifier of the property of the child elements of the box o which have name as name string. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$ \mbox{\hyperlink{group__Evas__Object__Box__Group_gab93c958930a9283fb1eb88924eafbab4}{evas\+\_\+object\+\_\+box\+\_\+prepend}} (Evas\+\_\+\+Box $\ast$obj, \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$child)
\begin{DoxyCompactList}\small\item\em Prepend a new child object to the given box object o. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Accessor__Group_ga65199ea5201a1867471028477dc26744}{Eina\+\_\+\+Accessor}} $\ast$ \mbox{\hyperlink{group__Evas__Object__Box__Group_ga8d1dbf1d436fdac739fc4111e09bed6e}{evas\+\_\+object\+\_\+box\+\_\+accessor\+\_\+new}} (const Evas\+\_\+\+Box $\ast$obj)
\begin{DoxyCompactList}\small\item\em Get an accessor (a structure providing random items access) to the list of children of a given box object. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} \mbox{\hyperlink{group__Evas__Object__Box__Group_ga701997cf7633cfeb78255a325f91bc58}{evas\+\_\+object\+\_\+box\+\_\+remove\+\_\+at}} (Evas\+\_\+\+Box $\ast$obj, unsigned int pos)
\begin{DoxyCompactList}\small\item\em Remove an object, bound to a given position in a box object, unparenting it again. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$ \mbox{\hyperlink{group__Evas__Object__Box__Group_ga9c45873e25e5829784878cc6ab265b77}{evas\+\_\+object\+\_\+box\+\_\+insert\+\_\+before}} (Evas\+\_\+\+Box $\ast$obj, \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$child, const \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$reference)
\begin{DoxyCompactList}\small\item\em Insert a new child object before another existing one, in a given box object o. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API const char $\ast$ \mbox{\hyperlink{group__Evas__Object__Box__Group_gaaa53c616b63fad6cc723a60f448e9376}{evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+name\+\_\+get}} (const Evas\+\_\+\+Box $\ast$obj, int property)
\begin{DoxyCompactList}\small\item\em Get the name of the property of the child elements of the box o which have id as identifier. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API void \mbox{\hyperlink{group__Evas__Object__Box__Group_ga5fe32364de114ac27926faf36a92565f}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+homogeneous\+\_\+horizontal}} (Evas\+\_\+\+Box $\ast$obj, \mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$priv, void $\ast$data)
\begin{DoxyCompactList}\small\item\em Layout function which sets the box o to a homogeneous horizontal box. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API void \mbox{\hyperlink{group__Evas__Object__Box__Group_gaf3f0222bd27fc5e89efc9b317668d0e1}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+homogeneous\+\_\+max\+\_\+size\+\_\+vertical}} (Evas\+\_\+\+Box $\ast$obj, \mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$priv, void $\ast$data)
\begin{DoxyCompactList}\small\item\em Layout function which sets the box o to a maximum size, homogeneous vertical box. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$ \mbox{\hyperlink{group__Evas__Object__Box__Group_gaa14c9550800631ba1ab4c899a3100b7d}{evas\+\_\+object\+\_\+box\+\_\+insert\+\_\+at}} (Evas\+\_\+\+Box $\ast$obj, \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$child, unsigned int pos)
\begin{DoxyCompactList}\small\item\em Insert a new child object at a given position, in a given box object {\ttfamily o}. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} \mbox{\hyperlink{group__Evas__Object__Box__Group_ga9f78a2e010ebd5e4e273ec1f0ab953a7}{evas\+\_\+object\+\_\+box\+\_\+remove}} (Evas\+\_\+\+Box $\ast$obj, \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$child)
\begin{DoxyCompactList}\small\item\em Remove a given object from a box object, unparenting it again. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API void \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbf12730358c40b99a4152dbe104b35e}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+stack}} (Evas\+\_\+\+Box $\ast$obj, \mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$priv, void $\ast$data)
\begin{DoxyCompactList}\small\item\em Layout function which sets the box o to a stacking box. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API void \mbox{\hyperlink{group__Evas__Object__Box__Group_ga02e09abf4c39068f6922f9077149c131}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+homogeneous\+\_\+vertical}} (Evas\+\_\+\+Box $\ast$obj, \mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$priv, void $\ast$data)
\begin{DoxyCompactList}\small\item\em Layout function which sets the box o to a homogeneous vertical box. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API void \mbox{\hyperlink{group__Evas__Object__Box__Group_ga92c45845c149cc21fab4fcfd4e7839eb}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+flow\+\_\+horizontal}} (Evas\+\_\+\+Box $\ast$obj, \mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$priv, void $\ast$data)
\begin{DoxyCompactList}\small\item\em Layout function which sets the box o to a flow horizontal box. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API void \mbox{\hyperlink{group__Evas__Object__Box__Group_ga23177f65ba160a22584fcdd680cbfe37}{evas\+\_\+object\+\_\+box\+\_\+smart\+\_\+set}} (\mbox{\hyperlink{group__Evas__Object__Box__Group_ga2a8fbeeab4f5ae23e7bc1b291e27c5e1}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api}} $\ast$api)
\begin{DoxyCompactList}\small\item\em Set the default box {\itshape api} struct (Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api) with the default values. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API const \mbox{\hyperlink{group__Evas__Object__Box__Group_ga2a8fbeeab4f5ae23e7bc1b291e27c5e1}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api}} $\ast$ \mbox{\hyperlink{group__Evas__Object__Box__Group_gaeafd91c71d3aeb8ff18e2bba2021c208}{evas\+\_\+object\+\_\+box\+\_\+smart\+\_\+class\+\_\+get}} (void)
\begin{DoxyCompactList}\small\item\em Get the Evas box smart class, for inheritance purposes. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API \mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$ \mbox{\hyperlink{group__Evas__Object__Box__Group_ga79c13db775cfad42ac5500dd2607bdc6}{evas\+\_\+object\+\_\+box\+\_\+add}} (\mbox{\hyperlink{group__Evas__Canvas_ga5ff87cc4ce6bc43e3b640a6d37f73043}{Evas}} $\ast$evas)
\begin{DoxyCompactList}\small\item\em Add a new box object on the provided canvas. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} \mbox{\hyperlink{group__Evas__Object__Box__Group_gab25fa33a8c550a9761fcf1660f1ccb47}{evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+vget}} (const \mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$o, \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$opt, int property, va\+\_\+list args)
\begin{DoxyCompactList}\small\item\em Get a property\textquotesingle{}s value (by its given numerical identifier), on a given box child element -- by a variable argument list. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} \mbox{\hyperlink{group__Evas__Object__Box__Group_ga4d60571f70fc69e32b6cd083e0727458}{evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+vset}} (\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$o, \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$opt, int property, va\+\_\+list args)
\begin{DoxyCompactList}\small\item\em Set a property value (by its given numerical identifier), on a given box child element -- by a variable argument list. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} \mbox{\hyperlink{group__Evas__Object__Box__Group_gaa1f895a0011630e5cfa06362f90ab0b6}{evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+set}} (\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$o, \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$opt, int property,...)
\begin{DoxyCompactList}\small\item\em Set a property value (by its given numerical identifier), on a given box child element. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} \mbox{\hyperlink{group__Evas__Object__Box__Group_ga93520f6107fdfd9fc3453574b447c082}{evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+get}} (const \mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$o, \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$opt, int property,...)
\begin{DoxyCompactList}\small\item\em Get a property\textquotesingle{}s value (by its given numerical identifier), on a given box child element. \end{DoxyCompactList}\item 
EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__List__Group_ga3295e1210efea1fb0fd6acbf3cbc1f29}{Eina\+\_\+\+List}} $\ast$ \mbox{\hyperlink{group__Evas__Object__Box__Group_gad70d6bbbbf4a0e093010a9a23c3a32e9}{evas\+\_\+object\+\_\+box\+\_\+children\+\_\+get}} (const \mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$o)
\begin{DoxyCompactList}\small\item\em Get the list of children objects in a given box object. \end{DoxyCompactList}\end{DoxyCompactItemize}


\doxysubsection{Detailed Description}
A box is a convenience smart object that packs children inside it in {\bfseries{sequence}}, using a layouting function specified by the user. 

There are a couple of pre-\/made layouting functions {\bfseries{built-\/in in Evas}}, all of them using children size hints to define their size and alignment inside their cell space.

Examples on this smart object\textquotesingle{}s usage\+:
\begin{DoxyItemize}
\item \mbox{\hyperlink{Example_Evas_Box}{Evas box example}}
\item \mbox{\hyperlink{Example_Evas_Size_Hints}{Evas alignment, minimum size, maximum size, padding and weight hints example}}
\end{DoxyItemize}

\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__Evas__Object__Group__Size__Hints}{Size Hints}} 
\end{DoxySeeAlso}


\doxysubsection{Macro Definition Documentation}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga118b1b5bc278185207e7651911637ac8}\label{group__Evas__Object__Box__Group_ga118b1b5bc278185207e7651911637ac8}} 
\index{Box Smart Object@{Box Smart Object}!EVAS\_OBJECT\_BOX\_API\_INIT@{EVAS\_OBJECT\_BOX\_API\_INIT}}
\index{EVAS\_OBJECT\_BOX\_API\_INIT@{EVAS\_OBJECT\_BOX\_API\_INIT}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{EVAS\_OBJECT\_BOX\_API\_INIT}{EVAS\_OBJECT\_BOX\_API\_INIT}}
{\footnotesize\ttfamily \#define EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT(\begin{DoxyParamCaption}\item[{}]{smart\+\_\+class\+\_\+init }\end{DoxyParamCaption})~\{smart\+\_\+class\+\_\+init, \mbox{\hyperlink{group__Evas__Object__Box__Group_gadb2f736aab172787d705baab2699dfe4}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+VERSION}}, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL\}}



Initializer for a whole \mbox{\hyperlink{group__Evas__Object__Box__Group_ga2a8fbeeab4f5ae23e7bc1b291e27c5e1}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api}} structure, with {\ttfamily NULL} values on its specific fields. 


\begin{DoxyParams}{Parameters}
{\em smart\+\_\+class\+\_\+init} & initializer to use for the \char`\"{}base\char`\"{} field (\mbox{\hyperlink{group__Evas__Smart__Group_gaea15f67e901bf5380cdb67dc1bb43391}{Evas\+\_\+\+Smart\+\_\+\+Class}}).\\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__Evas__Smart__Group_ga223f5d420c1e22275cd6490cd77c85f0}{EVAS\+\_\+\+SMART\+\_\+\+CLASS\+\_\+\+INIT\+\_\+\+NULL}} 

\mbox{\hyperlink{group__Evas__Smart__Group_gaaa610a135c79167162405b56cffe8562}{EVAS\+\_\+\+SMART\+\_\+\+CLASS\+\_\+\+INIT\+\_\+\+VERSION}} 

\mbox{\hyperlink{group__Evas__Smart__Group_gaff2bbd5bb79e51ad8d31f98106caff77}{EVAS\+\_\+\+SMART\+\_\+\+CLASS\+\_\+\+INIT\+\_\+\+NAME\+\_\+\+VERSION}} 

\mbox{\hyperlink{group__Evas__Object__Box__Group_gacfe469ef2fc811ab4af8c77105bf4baa}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT\+\_\+\+NULL}} 

\mbox{\hyperlink{group__Evas__Object__Box__Group_gabab7b773ecb31ecbf661646d5db1bea1}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT\+\_\+\+VERSION}} 

\mbox{\hyperlink{group__Evas__Object__Box__Group_gad35b8c6b395f976397abbb6f964878e7}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT\+\_\+\+NAME\+\_\+\+VERSION}} 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_gacfe469ef2fc811ab4af8c77105bf4baa}\label{group__Evas__Object__Box__Group_gacfe469ef2fc811ab4af8c77105bf4baa}} 
\index{Box Smart Object@{Box Smart Object}!EVAS\_OBJECT\_BOX\_API\_INIT\_NULL@{EVAS\_OBJECT\_BOX\_API\_INIT\_NULL}}
\index{EVAS\_OBJECT\_BOX\_API\_INIT\_NULL@{EVAS\_OBJECT\_BOX\_API\_INIT\_NULL}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{EVAS\_OBJECT\_BOX\_API\_INIT\_NULL}{EVAS\_OBJECT\_BOX\_API\_INIT\_NULL}}
{\footnotesize\ttfamily \#define EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT\+\_\+\+NULL~\mbox{\hyperlink{group__Evas__Object__Box__Group_ga118b1b5bc278185207e7651911637ac8}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT}}(\mbox{\hyperlink{group__Evas__Smart__Group_ga223f5d420c1e22275cd6490cd77c85f0}{EVAS\+\_\+\+SMART\+\_\+\+CLASS\+\_\+\+INIT\+\_\+\+NULL}})}



Initialize to zero out a whole \mbox{\hyperlink{group__Evas__Object__Box__Group_ga2a8fbeeab4f5ae23e7bc1b291e27c5e1}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api}} structure. 

\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__Evas__Object__Box__Group_gabab7b773ecb31ecbf661646d5db1bea1}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT\+\_\+\+VERSION}} 

\mbox{\hyperlink{group__Evas__Object__Box__Group_gad35b8c6b395f976397abbb6f964878e7}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT\+\_\+\+NAME\+\_\+\+VERSION}} 

\mbox{\hyperlink{group__Evas__Object__Box__Group_ga118b1b5bc278185207e7651911637ac8}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT}} 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_gabab7b773ecb31ecbf661646d5db1bea1}\label{group__Evas__Object__Box__Group_gabab7b773ecb31ecbf661646d5db1bea1}} 
\index{Box Smart Object@{Box Smart Object}!EVAS\_OBJECT\_BOX\_API\_INIT\_VERSION@{EVAS\_OBJECT\_BOX\_API\_INIT\_VERSION}}
\index{EVAS\_OBJECT\_BOX\_API\_INIT\_VERSION@{EVAS\_OBJECT\_BOX\_API\_INIT\_VERSION}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{EVAS\_OBJECT\_BOX\_API\_INIT\_VERSION}{EVAS\_OBJECT\_BOX\_API\_INIT\_VERSION}}
{\footnotesize\ttfamily \#define EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT\+\_\+\+VERSION~\mbox{\hyperlink{group__Evas__Object__Box__Group_ga118b1b5bc278185207e7651911637ac8}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT}}(\mbox{\hyperlink{group__Evas__Smart__Group_gaaa610a135c79167162405b56cffe8562}{EVAS\+\_\+\+SMART\+\_\+\+CLASS\+\_\+\+INIT\+\_\+\+VERSION}})}



Initialize to zero out a whole \mbox{\hyperlink{group__Evas__Object__Box__Group_ga2a8fbeeab4f5ae23e7bc1b291e27c5e1}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api}} structure and set a specific version on it. 

This is similar to \mbox{\hyperlink{group__Evas__Object__Box__Group_gacfe469ef2fc811ab4af8c77105bf4baa}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT\+\_\+\+NULL}}, but it will set the version field of \mbox{\hyperlink{group__Evas__Smart__Group_gaea15f67e901bf5380cdb67dc1bb43391}{Evas\+\_\+\+Smart\+\_\+\+Class}} (base field) to the latest \mbox{\hyperlink{group__Evas__Smart__Group_ga1ca1514302a47188c921b232d6ce42db}{EVAS\+\_\+\+SMART\+\_\+\+CLASS\+\_\+\+VERSION}}.

\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__Evas__Object__Box__Group_gacfe469ef2fc811ab4af8c77105bf4baa}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT\+\_\+\+NULL}} 

\mbox{\hyperlink{group__Evas__Object__Box__Group_gad35b8c6b395f976397abbb6f964878e7}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT\+\_\+\+NAME\+\_\+\+VERSION}} 

\mbox{\hyperlink{group__Evas__Object__Box__Group_ga118b1b5bc278185207e7651911637ac8}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT}} 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_gad35b8c6b395f976397abbb6f964878e7}\label{group__Evas__Object__Box__Group_gad35b8c6b395f976397abbb6f964878e7}} 
\index{Box Smart Object@{Box Smart Object}!EVAS\_OBJECT\_BOX\_API\_INIT\_NAME\_VERSION@{EVAS\_OBJECT\_BOX\_API\_INIT\_NAME\_VERSION}}
\index{EVAS\_OBJECT\_BOX\_API\_INIT\_NAME\_VERSION@{EVAS\_OBJECT\_BOX\_API\_INIT\_NAME\_VERSION}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{EVAS\_OBJECT\_BOX\_API\_INIT\_NAME\_VERSION}{EVAS\_OBJECT\_BOX\_API\_INIT\_NAME\_VERSION}}
{\footnotesize\ttfamily \#define EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT\+\_\+\+NAME\+\_\+\+VERSION(\begin{DoxyParamCaption}\item[{}]{name }\end{DoxyParamCaption})~\mbox{\hyperlink{group__Evas__Object__Box__Group_ga118b1b5bc278185207e7651911637ac8}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT}}(\mbox{\hyperlink{group__Evas__Smart__Group_gaff2bbd5bb79e51ad8d31f98106caff77}{EVAS\+\_\+\+SMART\+\_\+\+CLASS\+\_\+\+INIT\+\_\+\+NAME\+\_\+\+VERSION}}(name))}



Initialize to zero out a whole \mbox{\hyperlink{group__Evas__Object__Box__Group_ga2a8fbeeab4f5ae23e7bc1b291e27c5e1}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api}} structure and set its name and version. 

This is similar to \mbox{\hyperlink{group__Evas__Object__Box__Group_gacfe469ef2fc811ab4af8c77105bf4baa}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT\+\_\+\+NULL}}, but it will also set the version field of \mbox{\hyperlink{group__Evas__Smart__Group_gaea15f67e901bf5380cdb67dc1bb43391}{Evas\+\_\+\+Smart\+\_\+\+Class}} (base field) to the latest \mbox{\hyperlink{group__Evas__Smart__Group_ga1ca1514302a47188c921b232d6ce42db}{EVAS\+\_\+\+SMART\+\_\+\+CLASS\+\_\+\+VERSION}} and name it to the specific value.

It will keep a reference to the name field as a {\ttfamily \char`\"{}const char $\ast$\char`\"{}}, i.\+e., the name must be available while the structure is used (hint\+: static or global variable!) and must not be modified.

\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__Evas__Object__Box__Group_gacfe469ef2fc811ab4af8c77105bf4baa}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT\+\_\+\+NULL}} 

\mbox{\hyperlink{group__Evas__Object__Box__Group_gabab7b773ecb31ecbf661646d5db1bea1}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT\+\_\+\+VERSION}} 

\mbox{\hyperlink{group__Evas__Object__Box__Group_ga118b1b5bc278185207e7651911637ac8}{EVAS\+\_\+\+OBJECT\+\_\+\+BOX\+\_\+\+API\+\_\+\+INIT}} 
\end{DoxySeeAlso}


\doxysubsection{Typedef Documentation}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}\label{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}} 
\index{Box Smart Object@{Box Smart Object}!Evas\_Object\_Box\_Option@{Evas\_Object\_Box\_Option}}
\index{Evas\_Object\_Box\_Option@{Evas\_Object\_Box\_Option}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{Evas\_Object\_Box\_Option}{Evas\_Object\_Box\_Option}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}}}



The base structure for a box option. 

Box options are a way of extending box items properties, which will be taken into account for layouting decisions. The box layouting functions provided by Evas will only rely on objects\textquotesingle{} canonical size hints to layout them, so the basic box option has {\bfseries{no}} (custom) property set.

Users creating their own layouts, but not depending on extra child items\textquotesingle{} properties, would be fine just using \mbox{\hyperlink{group__Evas__Object__Box__Group_gacabb47de0d8706b4c8628b519b2d1494}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+set()}}. But if one desires a layout depending on extra child properties, he/she has to {\bfseries{subclass}} the box smart object. Thus, by using \mbox{\hyperlink{group__Evas__Object__Box__Group_gaeafd91c71d3aeb8ff18e2bba2021c208}{evas\+\_\+object\+\_\+box\+\_\+smart\+\_\+class\+\_\+get()}} and \mbox{\hyperlink{group__Evas__Object__Box__Group_ga23177f65ba160a22584fcdd680cbfe37}{evas\+\_\+object\+\_\+box\+\_\+smart\+\_\+set()}}, the {\ttfamily option\+\_\+new()} and {\ttfamily option\+\_\+free()} smart class functions should be properly redefined/extended.

Object properties are bound to an integer identifier and must have a name string. Their values are open to any data. See the API on option properties for more details. \mbox{\Hypertarget{group__Evas__Object__Box__Group_gad3ef5177a00dcda0c08c86287419d5b5}\label{group__Evas__Object__Box__Group_gad3ef5177a00dcda0c08c86287419d5b5}} 
\index{Box Smart Object@{Box Smart Object}!Evas\_Object\_Box\_Layout@{Evas\_Object\_Box\_Layout}}
\index{Evas\_Object\_Box\_Layout@{Evas\_Object\_Box\_Layout}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{Evas\_Object\_Box\_Layout}{Evas\_Object\_Box\_Layout}}
{\footnotesize\ttfamily Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Layout}



Function signature for an Evas box object layouting routine. 

By {\itshape o} it will be passed the box object in question, by {\itshape priv} it will be passed the box\textquotesingle{}s internal data and, by {\itshape user\+\_\+data}, it will be passed any custom data one could have set to a given box layouting function, with \mbox{\hyperlink{group__Evas__Object__Box__Group_gacabb47de0d8706b4c8628b519b2d1494}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+set()}}. \begin{Desc}
\item[Examples]\par
\mbox{\hyperlink{box_example_02_8c-example}{box\+\_\+example\+\_\+02.\+c}}.\end{Desc}


\doxysubsection{Function Documentation}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_gab363f1603f6897dc1ebb8271b7917d2b}\label{group__Evas__Object__Box__Group_gab363f1603f6897dc1ebb8271b7917d2b}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_align\_set@{evas\_object\_box\_align\_set}}
\index{evas\_object\_box\_align\_set@{evas\_object\_box\_align\_set}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_align\_set()}{evas\_object\_box\_align\_set()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API void evas\+\_\+object\+\_\+box\+\_\+align\+\_\+set (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{double}]{horizontal,  }\item[{double}]{vertical }\end{DoxyParamCaption})}



Set the alignment of the whole bounding box of contents, for a given box object. 

This will influence how a box object is to align its bounding box of contents within its own area. The values must be in the range \$0.0 -\/ \$1.0, or undefined behavior is expected. For horizontal alignment, \$0.0 means to the left, with \$1.0 meaning to the right. For vertical alignment, \$0.0 means to the top, with \$1.0 meaning to the bottom.

\begin{DoxyNote}{Note}
The default values for both alignments is \$0.5.
\end{DoxyNote}
See also \mbox{\hyperlink{group__Evas__Object__Box__Group_ga0feb8b7c8bef4b7e60884a885a9778e7}{evas\+\_\+object\+\_\+box\+\_\+align\+\_\+get}}.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em horizontal} & The horizontal alignment, in pixels. \\
\hline
\mbox{\texttt{ in}}  & {\em vertical} & The vertical alignment, in pixels. \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga0feb8b7c8bef4b7e60884a885a9778e7}\label{group__Evas__Object__Box__Group_ga0feb8b7c8bef4b7e60884a885a9778e7}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_align\_get@{evas\_object\_box\_align\_get}}
\index{evas\_object\_box\_align\_get@{evas\_object\_box\_align\_get}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_align\_get()}{evas\_object\_box\_align\_get()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API void evas\+\_\+object\+\_\+box\+\_\+align\+\_\+get (\begin{DoxyParamCaption}\item[{const Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{double $\ast$}]{horizontal,  }\item[{double $\ast$}]{vertical }\end{DoxyParamCaption})}



Get the alignment of the whole bounding box of contents, for a given box object. 

See also \mbox{\hyperlink{group__Evas__Object__Box__Group_gab363f1603f6897dc1ebb8271b7917d2b}{evas\+\_\+object\+\_\+box\+\_\+align\+\_\+set}} for more information.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ out}}  & {\em horizontal} & The horizontal alignment, in pixels. \\
\hline
\mbox{\texttt{ out}}  & {\em vertical} & The vertical alignment, in pixels. \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_gab220426e0cd46980ee7b8fde662bfb19}\label{group__Evas__Object__Box__Group_gab220426e0cd46980ee7b8fde662bfb19}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_padding\_set@{evas\_object\_box\_padding\_set}}
\index{evas\_object\_box\_padding\_set@{evas\_object\_box\_padding\_set}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_padding\_set()}{evas\_object\_box\_padding\_set()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API void evas\+\_\+object\+\_\+box\+\_\+padding\+\_\+set (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{int}]{horizontal,  }\item[{int}]{vertical }\end{DoxyParamCaption})}



Set the (space) padding between cells set for a given box object. 

\begin{DoxyNote}{Note}
The default values for both padding components is \$0.
\end{DoxyNote}
See also \mbox{\hyperlink{group__Evas__Object__Box__Group_gad462c975b42819fdd4e81a8f4fe06116}{evas\+\_\+object\+\_\+box\+\_\+padding\+\_\+get}}.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em horizontal} & The horizontal padding, in pixels. \\
\hline
\mbox{\texttt{ in}}  & {\em vertical} & The vertical padding, in pixels. \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_gad462c975b42819fdd4e81a8f4fe06116}\label{group__Evas__Object__Box__Group_gad462c975b42819fdd4e81a8f4fe06116}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_padding\_get@{evas\_object\_box\_padding\_get}}
\index{evas\_object\_box\_padding\_get@{evas\_object\_box\_padding\_get}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_padding\_get()}{evas\_object\_box\_padding\_get()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API void evas\+\_\+object\+\_\+box\+\_\+padding\+\_\+get (\begin{DoxyParamCaption}\item[{const Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{int $\ast$}]{horizontal,  }\item[{int $\ast$}]{vertical }\end{DoxyParamCaption})}



Get the (space) padding between cells set for a given box object. 

See also \mbox{\hyperlink{group__Evas__Object__Box__Group_gab220426e0cd46980ee7b8fde662bfb19}{evas\+\_\+object\+\_\+box\+\_\+padding\+\_\+set}}.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ out}}  & {\em horizontal} & The horizontal padding, in pixels. \\
\hline
\mbox{\texttt{ out}}  & {\em vertical} & The vertical padding, in pixels. \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_gacabb47de0d8706b4c8628b519b2d1494}\label{group__Evas__Object__Box__Group_gacabb47de0d8706b4c8628b519b2d1494}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_layout\_set@{evas\_object\_box\_layout\_set}}
\index{evas\_object\_box\_layout\_set@{evas\_object\_box\_layout\_set}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_layout\_set()}{evas\_object\_box\_layout\_set()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API void evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+set (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Evas__Object__Box__Group_gad3ef5177a00dcda0c08c86287419d5b5}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Layout}}}]{cb,  }\item[{const void $\ast$}]{data,  }\item[{\mbox{\hyperlink{group__Eina__Types__Group_gadbac560ba2bca5c61d97bfbb542018f3}{Eina\+\_\+\+Free\+\_\+\+Cb}}}]{free\+\_\+data }\end{DoxyParamCaption})}



Set a new layouting function to a given box object. 

A box layout function affects how a box object displays child elements within its area. The list of pre-\/defined box layouts available in Evas are \mbox{\hyperlink{group__Evas__Object__Box__Group_gaaaaf1c9ba2bd49e51108c1202aea9c3c}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+horizontal}}, \mbox{\hyperlink{group__Evas__Object__Box__Group_ga8836b5287edf32f687e2ad05a140e836}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+vertical}}, \mbox{\hyperlink{group__Evas__Object__Box__Group_ga5fe32364de114ac27926faf36a92565f}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+homogeneous\+\_\+horizontal}}, \mbox{\hyperlink{group__Evas__Object__Box__Group_ga02e09abf4c39068f6922f9077149c131}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+homogeneous\+\_\+vertical}}, \mbox{\hyperlink{group__Evas__Object__Box__Group_ga2e519c420f94629ef313a009f68391bb}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+homogeneous\+\_\+max\+\_\+size\+\_\+horizontal}}, \mbox{\hyperlink{group__Evas__Object__Box__Group_gaf3f0222bd27fc5e89efc9b317668d0e1}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+homogeneous\+\_\+max\+\_\+size\+\_\+vertical}}, \mbox{\hyperlink{group__Evas__Object__Box__Group_ga92c45845c149cc21fab4fcfd4e7839eb}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+flow\+\_\+horizontal}}, \mbox{\hyperlink{group__Evas__Object__Box__Group_ga5e4ae5bcafc724706824418969faeb7f}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+flow\+\_\+vertical}} and \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbf12730358c40b99a4152dbe104b35e}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+stack}}

Refer to each of their documentation texts for details on them.

\begin{DoxyNote}{Note}
A box layouting function will be triggered by the \$\textquotesingle{}calculate\textquotesingle{} smart callback of the box\textquotesingle{}s smart class.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em cb} & The new layout function to set on {\ttfamily o}. \\
\hline
\mbox{\texttt{ in}}  & {\em data} & Data pointer to be passed to {\ttfamily cb}. \\
\hline
\mbox{\texttt{ in}}  & {\em free\+\_\+data} & Function to free {\ttfamily data}, if need be. \\
\hline
\end{DoxyParams}


Referenced by \mbox{\hyperlink{group__Elm__Box__Group_ga964ff6e51c328ed9e9a64c73f9e2a21f}{elm\+\_\+box\+\_\+layout\+\_\+set()}}.

\mbox{\Hypertarget{group__Evas__Object__Box__Group_gaaaaf1c9ba2bd49e51108c1202aea9c3c}\label{group__Evas__Object__Box__Group_gaaaaf1c9ba2bd49e51108c1202aea9c3c}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_layout\_horizontal@{evas\_object\_box\_layout\_horizontal}}
\index{evas\_object\_box\_layout\_horizontal@{evas\_object\_box\_layout\_horizontal}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_layout\_horizontal()}{evas\_object\_box\_layout\_horizontal()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API void evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+horizontal (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$}]{priv,  }\item[{void $\ast$}]{data }\end{DoxyParamCaption})}



Layout function which sets the box o to a (basic) horizontal box. 

In this layout, the box object\textquotesingle{}s overall behavior is controlled by its padding/alignment properties, which are set by the evas\+\_\+object\+\_\+box\+\_\+\{h,v\}\+\_\+\{align,padding\}\+\_\+set family of functions. The size hints of the elements in the box -- set by the evas\+\_\+object\+\_\+size\+\_\+hint\+\_\+\{align,padding,weight\}\+\_\+set functions -- also control the way this function works.

Box\textquotesingle{}s properties\+: {\ttfamily align\+\_\+h} controls the horizontal alignment of the child objects relative to the containing box. When set to \$0.0, children are aligned to the left. A value of \$1.0 makes them aligned to the right border. Values in between align them proportionally. Note that if the size required by the children, which is given by their widths and the {\ttfamily padding\+\_\+h} property of the box, is bigger than the their container\textquotesingle{}s width, the children will be displayed out of the box\textquotesingle{}s bounds. A negative value of {\ttfamily align\+\_\+h} makes the box to justify its children. The padding between them, in this case, is corrected so that the leftmost one touches the left border and the rightmost one touches the right border (even if they must overlap). The {\ttfamily align\+\_\+v} and {\ttfamily padding\+\_\+v} properties of the box don\textquotesingle{}t contribute to its behaviour when this layout is chosen.

Child element\textquotesingle{}s properties\+: {\ttfamily align\+\_\+x} does not influence the box\textquotesingle{}s behavior. {\ttfamily padding\+\_\+l} and {\ttfamily padding\+\_\+r} sum up to the container\textquotesingle{}s horizontal padding between elements. The child\textquotesingle{}s {\ttfamily padding\+\_\+t}, {\ttfamily padding\+\_\+b} and {\ttfamily align\+\_\+y} properties apply for padding/alignment relative to the overall height of the box. Finally, there is the {\ttfamily weight\+\_\+x} property, which, if set to a non-\/zero value, tells the container that the child width is not pre-\/defined. If the container can\textquotesingle{}t accommodate all its children, it sets the widths of the ones with weights to sizes as small as they can all fit into it. If the size required by the children is less than the available, the box increases its childrens\textquotesingle{} (which have weights) widths as to fit the remaining space. The {\ttfamily weight\+\_\+x} property, besides telling the element is resizable, gives a weight for the resizing process. The parent box will try to distribute (or take off) widths accordingly to the normalized list of weights\+: most weighted children remain/get larger in this process than the least ones. {\ttfamily weight\+\_\+y} does not influence the layout.

If one desires that, besides having weights, child elements must be resized bounded to a minimum or maximum size, those size hints must be set, by the evas\+\_\+object\+\_\+size\+\_\+hint\+\_\+\{min,max\}\+\_\+set functions.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em priv} & Private data pointer \\
\hline
\mbox{\texttt{ in}}  & {\em data} & Data pointer \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga8836b5287edf32f687e2ad05a140e836}\label{group__Evas__Object__Box__Group_ga8836b5287edf32f687e2ad05a140e836}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_layout\_vertical@{evas\_object\_box\_layout\_vertical}}
\index{evas\_object\_box\_layout\_vertical@{evas\_object\_box\_layout\_vertical}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_layout\_vertical()}{evas\_object\_box\_layout\_vertical()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API void evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+vertical (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$}]{priv,  }\item[{void $\ast$}]{data }\end{DoxyParamCaption})}



Layout function which sets the box o to a (basic) vertical box. 

This function behaves analogously to evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+horizontal. The description of its behaviour can be derived from that function\textquotesingle{}s documentation.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em priv} & Private data pointer \\
\hline
\mbox{\texttt{ in}}  & {\em data} & Data pointer \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga2e519c420f94629ef313a009f68391bb}\label{group__Evas__Object__Box__Group_ga2e519c420f94629ef313a009f68391bb}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_layout\_homogeneous\_max\_size\_horizontal@{evas\_object\_box\_layout\_homogeneous\_max\_size\_horizontal}}
\index{evas\_object\_box\_layout\_homogeneous\_max\_size\_horizontal@{evas\_object\_box\_layout\_homogeneous\_max\_size\_horizontal}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_layout\_homogeneous\_max\_size\_horizontal()}{evas\_object\_box\_layout\_homogeneous\_max\_size\_horizontal()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API void evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+homogeneous\+\_\+max\+\_\+size\+\_\+horizontal (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$}]{priv,  }\item[{void $\ast$}]{data }\end{DoxyParamCaption})}



Layout function which sets the box o to a maximum size, homogeneous horizontal box. 

In a maximum size, homogeneous horizontal box, besides having cells of equal size reserved for the child objects, this size will be defined by the size of the largest child in the box (in width). The box\textquotesingle{}s overall behavior is controlled by its properties, which are set by the evas\+\_\+object\+\_\+box\+\_\+\{h,v\}\+\_\+\{align,padding\}\+\_\+set family of functions. The size hints of the elements in the box -- set by the evas\+\_\+object\+\_\+size\+\_\+hint\+\_\+\{align,padding,weight\}\+\_\+set functions -- also control the way this function works.

Box\textquotesingle{}s properties\+: {\ttfamily padding\+\_\+h} tells the box to draw empty spaces of that size, in pixels, between the child objects\textquotesingle{} cells. {\ttfamily align\+\_\+h} controls the horizontal alignment of the child objects, relative to the containing box. When set to \$0.0, children are aligned to the left. A value of \$1.0 lets them aligned to the right border. Values in between align them proportionally. A negative value of {\ttfamily align\+\_\+h} makes the box to justify its children cells. The padding between them, in this case, is corrected so that the leftmost one touches the left border and the rightmost one touches the right border (even if they must overlap). The {\ttfamily align\+\_\+v} and {\ttfamily padding\+\_\+v} properties of the box don\textquotesingle{}t contribute to its behaviour when this layout is chosen.

Child element\textquotesingle{}s properties\+: {\ttfamily padding\+\_\+l} and {\ttfamily padding\+\_\+r} sum up to the required width of the child element. The {\ttfamily align\+\_\+x} property tells the relative position of this overall child width in its allocated cell (\$0.0 to extreme left, \$1.0 to extreme right). A value of \$-\/1.\+0 to {\ttfamily align\+\_\+x} makes the box try to resize this child element to the exact width of its cell (respecting the minimum and maximum size hints on the child\textquotesingle{}s width and accounting for its horizontal padding hints). The child\textquotesingle{}s {\ttfamily padding\+\_\+t}, {\ttfamily padding\+\_\+b} and {\ttfamily align\+\_\+y} properties apply for padding/alignment relative to the overall height of the box. A value of \$-\/1.\+0 to {\ttfamily align\+\_\+y} makes the box try to resize this child element to the exact height of its parent (respecting the max hint on the child\textquotesingle{}s height).


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em priv} & Private data pointer \\
\hline
\mbox{\texttt{ in}}  & {\em data} & Data pointer \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga5e4ae5bcafc724706824418969faeb7f}\label{group__Evas__Object__Box__Group_ga5e4ae5bcafc724706824418969faeb7f}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_layout\_flow\_vertical@{evas\_object\_box\_layout\_flow\_vertical}}
\index{evas\_object\_box\_layout\_flow\_vertical@{evas\_object\_box\_layout\_flow\_vertical}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_layout\_flow\_vertical()}{evas\_object\_box\_layout\_flow\_vertical()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API void evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+flow\+\_\+vertical (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$}]{priv,  }\item[{void $\ast$}]{data }\end{DoxyParamCaption})}



Layout function which sets the box o to a flow vertical box. 

This function behaves analogously to evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+flow\+\_\+horizontal. The description of its behaviour can be derived from that function\textquotesingle{}s documentation.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em priv} & Private data pointer \\
\hline
\mbox{\texttt{ in}}  & {\em data} & Data pointer \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_gaa2bdebeed69e85ca92778823a1e221fa}\label{group__Evas__Object__Box__Group_gaa2bdebeed69e85ca92778823a1e221fa}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_insert\_after@{evas\_object\_box\_insert\_after}}
\index{evas\_object\_box\_insert\_after@{evas\_object\_box\_insert\_after}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_insert\_after()}{evas\_object\_box\_insert\_after()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$ evas\+\_\+object\+\_\+box\+\_\+insert\+\_\+after (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$}]{child,  }\item[{const \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$}]{reference }\end{DoxyParamCaption})}



Insert a new child object after another existing one, in a given box object o. 

On success, the \$\char`\"{}child,added\char`\"{} smart event will take place.

\begin{DoxyNote}{Note}
This function will fail if {\ttfamily reference} is not a member of {\ttfamily o}.

The actual placing of the item relative to {\ttfamily o\textquotesingle{}s} area will depend on the layout set to it.

This call will trigger the box\textquotesingle{}s \mbox{\hyperlink{struct__Evas__Object__Box__Api_ae66a292efa14a75f1a216b4e50377138}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api.\+insert\+\_\+after}} smart function.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em child} & A child Evas object to be made a member of {\ttfamily o}. \\
\hline
\mbox{\texttt{ in}}  & {\em reference} & The child object to place this new one after.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
A box option bound to the recently added box item or {\ttfamily null}, on errors 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga99a76c1e4da6f54a72358ae0f56cf541}\label{group__Evas__Object__Box__Group_ga99a76c1e4da6f54a72358ae0f56cf541}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_remove\_all@{evas\_object\_box\_remove\_all}}
\index{evas\_object\_box\_remove\_all@{evas\_object\_box\_remove\_all}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_remove\_all()}{evas\_object\_box\_remove\_all()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} evas\+\_\+object\+\_\+box\+\_\+remove\+\_\+all (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}}}]{clear }\end{DoxyParamCaption})}



Remove all child objects from a box object, unparenting them again. 

This has the same effect of calling evas\+\_\+object\+\_\+box\+\_\+remove on each of {\ttfamily o\textquotesingle{}s} child objects, in sequence. If, and only if, all those calls succeed, so does this one.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em clear} & If {\ttfamily true}, it will delete just removed children.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily true} on success, {\ttfamily false} otherwise. 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_gaf42e4d1d631ff8b62c2d9ce41862f877}\label{group__Evas__Object__Box__Group_gaf42e4d1d631ff8b62c2d9ce41862f877}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_iterator\_new@{evas\_object\_box\_iterator\_new}}
\index{evas\_object\_box\_iterator\_new@{evas\_object\_box\_iterator\_new}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_iterator\_new()}{evas\_object\_box\_iterator\_new()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Iterator__Group_ga15b975bb881d955249ce13d4ebc96948}{Eina\+\_\+\+Iterator}} $\ast$ evas\+\_\+object\+\_\+box\+\_\+iterator\+\_\+new (\begin{DoxyParamCaption}\item[{const Evas\+\_\+\+Box $\ast$}]{obj }\end{DoxyParamCaption})}



Get an iterator to walk the list of children of a given box object. 

\begin{DoxyNote}{Note}
Do not remove or delete objects while walking the list.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
An iterator on {\ttfamily o\textquotesingle{}s} child objects, on success, or {\ttfamily null}, on errors. 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga9592012d38d1ca93fbf83b07dabcbfd8}\label{group__Evas__Object__Box__Group_ga9592012d38d1ca93fbf83b07dabcbfd8}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_add\_to@{evas\_object\_box\_add\_to}}
\index{evas\_object\_box\_add\_to@{evas\_object\_box\_add\_to}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_add\_to()}{evas\_object\_box\_add\_to()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$ evas\+\_\+object\+\_\+box\+\_\+add\+\_\+to (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj }\end{DoxyParamCaption})}



Add a new box as a child of a given smart object. 

This is a helper function that has the same effect of putting a new box object into {\ttfamily parent} by use of evas\+\_\+object\+\_\+smart\+\_\+member\+\_\+add.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily null} on error, a pointer to a new box object on success. 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga901a603e429bdf752f8c184b418070ae}\label{group__Evas__Object__Box__Group_ga901a603e429bdf752f8c184b418070ae}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_append@{evas\_object\_box\_append}}
\index{evas\_object\_box\_append@{evas\_object\_box\_append}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_append()}{evas\_object\_box\_append()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$ evas\+\_\+object\+\_\+box\+\_\+append (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$}]{child }\end{DoxyParamCaption})}



Append a new child object to the given box object o. 

On success, the \$\char`\"{}child,added\char`\"{} smart event will take place.

\begin{DoxyNote}{Note}
The actual placing of the item relative to {\ttfamily o\textquotesingle{}s} area will depend on the layout set to it. For example, on horizontal layouts an item in the end of the box\textquotesingle{}s list of children will appear on its right.

This call will trigger the box\textquotesingle{}s \mbox{\hyperlink{struct__Evas__Object__Box__Api_a147e56339ed93d18c41c4d16855712bf}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api.\+append}} smart function.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em child} & A child Evas object to be made a member of {\ttfamily o}.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
A box option bound to the recently added box item or {\ttfamily null}, on errors. 
\end{DoxyReturn}


Referenced by \mbox{\hyperlink{group__Elm__Win__Group_ga505d6bd217e5ee01e82b548ec35986eb}{elm\+\_\+win\+\_\+resize\+\_\+object\+\_\+add()}}.

\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga400335f929e0bf549a90210ce9555a43}\label{group__Evas__Object__Box__Group_ga400335f929e0bf549a90210ce9555a43}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_option\_property\_id\_get@{evas\_object\_box\_option\_property\_id\_get}}
\index{evas\_object\_box\_option\_property\_id\_get@{evas\_object\_box\_option\_property\_id\_get}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_option\_property\_id\_get()}{evas\_object\_box\_option\_property\_id\_get()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API int evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+id\+\_\+get (\begin{DoxyParamCaption}\item[{const Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{const char $\ast$}]{name }\end{DoxyParamCaption})}



Get the numerical identifier of the property of the child elements of the box o which have name as name string. 

\begin{DoxyNote}{Note}
This call won\textquotesingle{}t do anything for a canonical Evas box. Only users which have subclassed it, setting custom box items options (see \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}}) on it, would benefit from this function. They\textquotesingle{}d have to implement it and set it to be the \mbox{\hyperlink{struct__Evas__Object__Box__Api_a01dbcc24f2d82615f2f7c24455c34411}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api.\+property\+\_\+id\+\_\+get}} smart class function of the box, which is originally set to {\ttfamily null}.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em name} & The name string of the option being searched, for its ID.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The numerical ID of the given property or \$-\/1, on errors. 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_gab93c958930a9283fb1eb88924eafbab4}\label{group__Evas__Object__Box__Group_gab93c958930a9283fb1eb88924eafbab4}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_prepend@{evas\_object\_box\_prepend}}
\index{evas\_object\_box\_prepend@{evas\_object\_box\_prepend}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_prepend()}{evas\_object\_box\_prepend()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$ evas\+\_\+object\+\_\+box\+\_\+prepend (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$}]{child }\end{DoxyParamCaption})}



Prepend a new child object to the given box object o. 

On success, the \$\char`\"{}child,added\char`\"{} smart event will take place.

\begin{DoxyNote}{Note}
The actual placing of the item relative to {\ttfamily o\textquotesingle{}s} area will depend on the layout set to it. For example, on horizontal layouts an item in the beginning of the box\textquotesingle{}s list of children will appear on its left.

This call will trigger the box\textquotesingle{}s \mbox{\hyperlink{struct__Evas__Object__Box__Api_ada99b5a51deef34ac86728812faeb2d0}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api.\+prepend}} smart function.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em child} & A child Evas object to be made a member of {\ttfamily o}.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
A box option bound to the recently added box item or {\ttfamily null}, on errors. 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga8d1dbf1d436fdac739fc4111e09bed6e}\label{group__Evas__Object__Box__Group_ga8d1dbf1d436fdac739fc4111e09bed6e}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_accessor\_new@{evas\_object\_box\_accessor\_new}}
\index{evas\_object\_box\_accessor\_new@{evas\_object\_box\_accessor\_new}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_accessor\_new()}{evas\_object\_box\_accessor\_new()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Accessor__Group_ga65199ea5201a1867471028477dc26744}{Eina\+\_\+\+Accessor}} $\ast$ evas\+\_\+object\+\_\+box\+\_\+accessor\+\_\+new (\begin{DoxyParamCaption}\item[{const Evas\+\_\+\+Box $\ast$}]{obj }\end{DoxyParamCaption})}



Get an accessor (a structure providing random items access) to the list of children of a given box object. 

\begin{DoxyNote}{Note}
Do not remove or delete objects while walking the list.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
An accessor on {\ttfamily o\textquotesingle{}s} child objects, on success, or {\ttfamily null}, on errors. 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga701997cf7633cfeb78255a325f91bc58}\label{group__Evas__Object__Box__Group_ga701997cf7633cfeb78255a325f91bc58}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_remove\_at@{evas\_object\_box\_remove\_at}}
\index{evas\_object\_box\_remove\_at@{evas\_object\_box\_remove\_at}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_remove\_at()}{evas\_object\_box\_remove\_at()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} evas\+\_\+object\+\_\+box\+\_\+remove\+\_\+at (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{unsigned int}]{pos }\end{DoxyParamCaption})}



Remove an object, bound to a given position in a box object, unparenting it again. 

On removal, you\textquotesingle{}ll get an unparented object again, just as it was before you inserted it in the box. The {\ttfamily option\+\_\+free} box smart callback will be called automatically for you and, also, the \$\char`\"{}child,removed\char`\"{} smart event will take place.

\begin{DoxyNote}{Note}
This function will fail if the given position is invalid, given {\ttfamily o\textquotesingle{}s} internal list of elements.

This call will trigger the box\textquotesingle{}s \mbox{\hyperlink{struct__Evas__Object__Box__Api_a9053be25f7728e546e9edba776bebd20}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api.\+remove\+\_\+at}} smart function.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em pos} & The numeric position (starting from \$0) of the child object to be removed.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily true} on success, {\ttfamily false} on failure. 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga9c45873e25e5829784878cc6ab265b77}\label{group__Evas__Object__Box__Group_ga9c45873e25e5829784878cc6ab265b77}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_insert\_before@{evas\_object\_box\_insert\_before}}
\index{evas\_object\_box\_insert\_before@{evas\_object\_box\_insert\_before}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_insert\_before()}{evas\_object\_box\_insert\_before()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$ evas\+\_\+object\+\_\+box\+\_\+insert\+\_\+before (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$}]{child,  }\item[{const \mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$}]{reference }\end{DoxyParamCaption})}



Insert a new child object before another existing one, in a given box object o. 

On success, the \$\char`\"{}child,added\char`\"{} smart event will take place.

\begin{DoxyNote}{Note}
This function will fail if {\ttfamily reference} is not a member of {\ttfamily o}.

The actual placing of the item relative to {\ttfamily o\textquotesingle{}s} area will depend on the layout set to it.

This call will trigger the box\textquotesingle{}s \mbox{\hyperlink{struct__Evas__Object__Box__Api_a47c815378311339ead8d277f3d21aabd}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api.\+insert\+\_\+before}} smart function.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em child} & A child Evas object to be made a member of {\ttfamily o}. \\
\hline
\mbox{\texttt{ in}}  & {\em reference} & The child object to place this new one before.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
A box option bound to the recently added box item or {\ttfamily null}, on errors. 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_gaaa53c616b63fad6cc723a60f448e9376}\label{group__Evas__Object__Box__Group_gaaa53c616b63fad6cc723a60f448e9376}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_option\_property\_name\_get@{evas\_object\_box\_option\_property\_name\_get}}
\index{evas\_object\_box\_option\_property\_name\_get@{evas\_object\_box\_option\_property\_name\_get}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_option\_property\_name\_get()}{evas\_object\_box\_option\_property\_name\_get()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API const char $\ast$ evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+name\+\_\+get (\begin{DoxyParamCaption}\item[{const Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{int}]{property }\end{DoxyParamCaption})}



Get the name of the property of the child elements of the box o which have id as identifier. 

\begin{DoxyNote}{Note}
This call won\textquotesingle{}t do anything for a canonical Evas box. Only users which have subclassed it, setting custom box items options (see \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}}) on it, would benefit from this function. They\textquotesingle{}d have to implement it and set it to be the \mbox{\hyperlink{struct__Evas__Object__Box__Api_a0ac36c42e5377e1dcbbdd060ed90076c}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api.\+property\+\_\+name\+\_\+get}} smart class function of the box, which is originally set to {\ttfamily null}.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em property} & The numerical identifier of the option being searched, for its name.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The name of the given property or {\ttfamily null}, on errors. 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga5fe32364de114ac27926faf36a92565f}\label{group__Evas__Object__Box__Group_ga5fe32364de114ac27926faf36a92565f}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_layout\_homogeneous\_horizontal@{evas\_object\_box\_layout\_homogeneous\_horizontal}}
\index{evas\_object\_box\_layout\_homogeneous\_horizontal@{evas\_object\_box\_layout\_homogeneous\_horizontal}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_layout\_homogeneous\_horizontal()}{evas\_object\_box\_layout\_homogeneous\_horizontal()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API void evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+homogeneous\+\_\+horizontal (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$}]{priv,  }\item[{void $\ast$}]{data }\end{DoxyParamCaption})}



Layout function which sets the box o to a homogeneous horizontal box. 

In a homogeneous horizontal box, its width is divided equally between the contained objects. The box\textquotesingle{}s overall behavior is controlled by its padding/alignment properties, which are set by the evas\+\_\+object\+\_\+box\+\_\+\{h,v\}\+\_\+\{align,padding\}\+\_\+set family of functions. The size hints the elements in the box -- set by the evas\+\_\+object\+\_\+size\+\_\+hint\+\_\+\{align,padding,weight\}\+\_\+set functions -- also control the way this function works.

Box\textquotesingle{}s properties\+: {\ttfamily align\+\_\+h} has no influence on the box for this layout. {\ttfamily padding\+\_\+h} tells the box to draw empty spaces of that size, in pixels, between the (equal) child objects\textquotesingle{} cells. The {\ttfamily align\+\_\+v} and {\ttfamily padding\+\_\+v} properties of the box don\textquotesingle{}t contribute to its behaviour when this layout is chosen.

Child element\textquotesingle{}s properties\+: {\ttfamily padding\+\_\+l} and {\ttfamily padding\+\_\+r} sum up to the required width of the child element. The {\ttfamily align\+\_\+x} property tells the relative position of this overall child width in its allocated cell (\$0.0 to extreme left, \$1.0 to extreme right). A value of \$-\/1.\+0 to {\ttfamily align\+\_\+x} makes the box try to resize this child element to the exact width of its cell (respecting the minimum and maximum size hints on the child\textquotesingle{}s width and accounting for its horizontal padding hints). The child\textquotesingle{}s {\ttfamily padding\+\_\+t}, {\ttfamily padding\+\_\+b} and {\ttfamily align\+\_\+y} properties apply for padding/alignment relative to the overall height of the box. A value of \$-\/1.\+0 to {\ttfamily align\+\_\+y} makes the box try to resize this child element to the exact height of its parent (respecting the maximum size hint on the child\textquotesingle{}s height).


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em priv} & Private data pointer \\
\hline
\mbox{\texttt{ in}}  & {\em data} & Data pointer \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_gaf3f0222bd27fc5e89efc9b317668d0e1}\label{group__Evas__Object__Box__Group_gaf3f0222bd27fc5e89efc9b317668d0e1}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_layout\_homogeneous\_max\_size\_vertical@{evas\_object\_box\_layout\_homogeneous\_max\_size\_vertical}}
\index{evas\_object\_box\_layout\_homogeneous\_max\_size\_vertical@{evas\_object\_box\_layout\_homogeneous\_max\_size\_vertical}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_layout\_homogeneous\_max\_size\_vertical()}{evas\_object\_box\_layout\_homogeneous\_max\_size\_vertical()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API void evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+homogeneous\+\_\+max\+\_\+size\+\_\+vertical (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$}]{priv,  }\item[{void $\ast$}]{data }\end{DoxyParamCaption})}



Layout function which sets the box o to a maximum size, homogeneous vertical box. 

This function behaves analogously to evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+homogeneous\+\_\+max\+\_\+size\+\_\+horizontal. The description of its behaviour can be derived from that function\textquotesingle{}s documentation.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em priv} & Private data pointer \\
\hline
\mbox{\texttt{ in}}  & {\em data} & Data pointer \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_gaa14c9550800631ba1ab4c899a3100b7d}\label{group__Evas__Object__Box__Group_gaa14c9550800631ba1ab4c899a3100b7d}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_insert\_at@{evas\_object\_box\_insert\_at}}
\index{evas\_object\_box\_insert\_at@{evas\_object\_box\_insert\_at}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_insert\_at()}{evas\_object\_box\_insert\_at()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$ evas\+\_\+object\+\_\+box\+\_\+insert\+\_\+at (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$}]{child,  }\item[{unsigned int}]{pos }\end{DoxyParamCaption})}



Insert a new child object at a given position, in a given box object {\ttfamily o}. 

On success, the \$\char`\"{}child,added\char`\"{} smart event will take place.

\begin{DoxyNote}{Note}
This function will fail if the given position is invalid, given {\ttfamily o\textquotesingle{}s} internal list of elements.

The actual placing of the item relative to {\ttfamily o\textquotesingle{}s} area will depend on the layout set to it.

This call will trigger the box\textquotesingle{}s \mbox{\hyperlink{struct__Evas__Object__Box__Api_ace374dc11c226a4924519c9992c8c205}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api.\+insert\+\_\+at}} smart function.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em child} & A child Evas object to be made a member of {\ttfamily o}. \\
\hline
\mbox{\texttt{ in}}  & {\em pos} & The numeric position (starting from \$0) to place the new child object at.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
A box option bound to the recently added box item or {\ttfamily null}, on errors. 
\end{DoxyReturn}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga9f78a2e010ebd5e4e273ec1f0ab953a7}\label{group__Evas__Object__Box__Group_ga9f78a2e010ebd5e4e273ec1f0ab953a7}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_remove@{evas\_object\_box\_remove}}
\index{evas\_object\_box\_remove@{evas\_object\_box\_remove}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_remove()}{evas\_object\_box\_remove()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} evas\+\_\+object\+\_\+box\+\_\+remove (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Evas__Object__Group_gaa5c3ea447e776040a102c696cd715574}{Efl\+\_\+\+Canvas\+\_\+\+Object}} $\ast$}]{child }\end{DoxyParamCaption})}



Remove a given object from a box object, unparenting it again. 

On removal, you\textquotesingle{}ll get an unparented object again, just as it was before you inserted it in the box. The \mbox{\hyperlink{struct__Evas__Object__Box__Api_a464f5f58963e274cefda263196415593}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api.\+option\+\_\+free}} box smart callback will be called automatically for you and, also, the \$\char`\"{}child,removed\char`\"{} smart event will take place.

\begin{DoxyNote}{Note}
This call will trigger the box\textquotesingle{}s \mbox{\hyperlink{struct__Evas__Object__Box__Api_a091611400de350cc2a5ad3d56a0fc306}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api.\+remove}} smart function.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em child} & The handle to the child object to be removed.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily true} on success, {\ttfamily false} otherwise. 
\end{DoxyReturn}


Referenced by \mbox{\hyperlink{group__Elm__Win__Group_ga964f7381061b72bdad381612047fde1a}{elm\+\_\+win\+\_\+resize\+\_\+object\+\_\+del()}}.

\mbox{\Hypertarget{group__Evas__Object__Box__Group_gabbf12730358c40b99a4152dbe104b35e}\label{group__Evas__Object__Box__Group_gabbf12730358c40b99a4152dbe104b35e}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_layout\_stack@{evas\_object\_box\_layout\_stack}}
\index{evas\_object\_box\_layout\_stack@{evas\_object\_box\_layout\_stack}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_layout\_stack()}{evas\_object\_box\_layout\_stack()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API void evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+stack (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$}]{priv,  }\item[{void $\ast$}]{data }\end{DoxyParamCaption})}



Layout function which sets the box o to a stacking box. 

In a stacking box, all children will be given the same size -- the box\textquotesingle{}s own size -- and they will be stacked one above the other, so that the first object in {\ttfamily o\textquotesingle{}s} internal list of child elements will be the bottommost in the stack.

Box\textquotesingle{}s properties\+: No box properties are used.

Child element\textquotesingle{}s properties\+: {\ttfamily padding\+\_\+l} and {\ttfamily padding\+\_\+r} sum up to the required width of the child element. The {\ttfamily align\+\_\+x} property tells the relative position of this overall child width in its allocated cell (\$0.0 to extreme left, \$1.0 to extreme right). A value of \$-\/1.\+0 to {\ttfamily align\+\_\+x} makes the box try to resize this child element to the exact width of its cell (respecting the min and max hints on the child\textquotesingle{}s width and accounting for its horizontal padding properties). The same applies to the vertical axis.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em priv} & Private data pointer \\
\hline
\mbox{\texttt{ in}}  & {\em data} & Data pointer \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga02e09abf4c39068f6922f9077149c131}\label{group__Evas__Object__Box__Group_ga02e09abf4c39068f6922f9077149c131}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_layout\_homogeneous\_vertical@{evas\_object\_box\_layout\_homogeneous\_vertical}}
\index{evas\_object\_box\_layout\_homogeneous\_vertical@{evas\_object\_box\_layout\_homogeneous\_vertical}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_layout\_homogeneous\_vertical()}{evas\_object\_box\_layout\_homogeneous\_vertical()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API void evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+homogeneous\+\_\+vertical (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$}]{priv,  }\item[{void $\ast$}]{data }\end{DoxyParamCaption})}



Layout function which sets the box o to a homogeneous vertical box. 

This function behaves analogously to evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+homogeneous\+\_\+horizontal. The description of its behaviour can be derived from that function\textquotesingle{}s documentation.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em priv} & Private data pointer \\
\hline
\mbox{\texttt{ in}}  & {\em data} & Data pointer \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga92c45845c149cc21fab4fcfd4e7839eb}\label{group__Evas__Object__Box__Group_ga92c45845c149cc21fab4fcfd4e7839eb}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_layout\_flow\_horizontal@{evas\_object\_box\_layout\_flow\_horizontal}}
\index{evas\_object\_box\_layout\_flow\_horizontal@{evas\_object\_box\_layout\_flow\_horizontal}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_layout\_flow\_horizontal()}{evas\_object\_box\_layout\_flow\_horizontal()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API void evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+flow\+\_\+horizontal (\begin{DoxyParamCaption}\item[{Evas\+\_\+\+Box $\ast$}]{obj,  }\item[{\mbox{\hyperlink{group__Evas__Object__Box__Group_gac9047b7cff95df59f61c7321967caf7b}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Data}} $\ast$}]{priv,  }\item[{void $\ast$}]{data }\end{DoxyParamCaption})}



Layout function which sets the box o to a flow horizontal box. 

In a flow horizontal box, the box\textquotesingle{}s child elements are placed in rows (think of text as an analogy). A row has as many elements as can fit into the box\textquotesingle{}s width. The box\textquotesingle{}s overall behavior is controlled by its properties, which are set by the evas\+\_\+object\+\_\+box\+\_\+\{h,v\}\+\_\+\{align,padding\}\+\_\+set family of functions. The size hints of the elements in the box -- set by the evas\+\_\+object\+\_\+size\+\_\+hint\+\_\+\{align,padding,weight\}\+\_\+set functions -- also control the way this function works.

Box\textquotesingle{}s properties\+: {\ttfamily padding\+\_\+h} tells the box to draw empty spaces of that size, in pixels, between the child objects\textquotesingle{} cells. {\ttfamily align\+\_\+h} dictates the horizontal alignment of the rows (\$0.0 to left align them, \$1.0 to right align). A value of \$-\/1.\+0 to {\ttfamily align\+\_\+h} lets the rows justified horizontally. {\ttfamily align\+\_\+v} controls the vertical alignment of the entire set of rows (\$0.0 to top, \$1.0 to bottom). A value of \$-\/1.\+0 to {\ttfamily align\+\_\+v} makes the box to justify the rows vertically. The padding between them in this case is corrected so that the first row touches the top border and the last one touches the bottom border (even if they must overlap). {\ttfamily padding\+\_\+v} has no influence on the layout.

Child element\textquotesingle{}s properties\+: {\ttfamily padding\+\_\+l} and {\ttfamily padding\+\_\+r} sum up to the required width of the child element. The {\ttfamily align\+\_\+x} property has no influence on the layout. The child\textquotesingle{}s {\ttfamily padding\+\_\+t} and {\ttfamily padding\+\_\+b} sum up to the required height of the child element and is the only means (besides row justifying) of setting space between rows. Note, however, that {\ttfamily align\+\_\+y} dictates positioning relative to the largest height required by a child object in the actual row.


\begin{DoxyParams}[1]{Parameters}
\mbox{\texttt{ in}}  & {\em obj} & The object. \\
\hline
\mbox{\texttt{ in}}  & {\em priv} & Private data pointer \\
\hline
\mbox{\texttt{ in}}  & {\em data} & Data pointer \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga23177f65ba160a22584fcdd680cbfe37}\label{group__Evas__Object__Box__Group_ga23177f65ba160a22584fcdd680cbfe37}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_smart\_set@{evas\_object\_box\_smart\_set}}
\index{evas\_object\_box\_smart\_set@{evas\_object\_box\_smart\_set}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_smart\_set()}{evas\_object\_box\_smart\_set()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API void evas\+\_\+object\+\_\+box\+\_\+smart\+\_\+set (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__Evas__Object__Box__Group_ga2a8fbeeab4f5ae23e7bc1b291e27c5e1}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api}} $\ast$}]{api }\end{DoxyParamCaption})}



Set the default box {\itshape api} struct (Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api) with the default values. 

May be used to extend that API.


\begin{DoxyParams}{Parameters}
{\em api} & The box API struct to set back, most probably with overridden fields (on class extensions scenarios) \\
\hline
\end{DoxyParams}
\mbox{\Hypertarget{group__Evas__Object__Box__Group_gaeafd91c71d3aeb8ff18e2bba2021c208}\label{group__Evas__Object__Box__Group_gaeafd91c71d3aeb8ff18e2bba2021c208}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_smart\_class\_get@{evas\_object\_box\_smart\_class\_get}}
\index{evas\_object\_box\_smart\_class\_get@{evas\_object\_box\_smart\_class\_get}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_smart\_class\_get()}{evas\_object\_box\_smart\_class\_get()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API const \mbox{\hyperlink{group__Evas__Object__Box__Group_ga2a8fbeeab4f5ae23e7bc1b291e27c5e1}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api}} $\ast$ evas\+\_\+object\+\_\+box\+\_\+smart\+\_\+class\+\_\+get (\begin{DoxyParamCaption}\item[{void}]{ }\end{DoxyParamCaption})}



Get the Evas box smart class, for inheritance purposes. 

\begin{DoxyReturn}{Returns}
the (canonical) Evas box smart class.
\end{DoxyReturn}
The returned value is {\bfseries{not}} to be modified, just use it as your parent class. \mbox{\Hypertarget{group__Evas__Object__Box__Group_ga79c13db775cfad42ac5500dd2607bdc6}\label{group__Evas__Object__Box__Group_ga79c13db775cfad42ac5500dd2607bdc6}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_add@{evas\_object\_box\_add}}
\index{evas\_object\_box\_add@{evas\_object\_box\_add}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_add()}{evas\_object\_box\_add()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API \mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$ evas\+\_\+object\+\_\+box\+\_\+add (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__Evas__Canvas_ga5ff87cc4ce6bc43e3b640a6d37f73043}{Evas}} $\ast$}]{evas }\end{DoxyParamCaption})}



Add a new box object on the provided canvas. 


\begin{DoxyParams}{Parameters}
{\em evas} & The canvas to create the box object on. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily NULL} on error, a pointer to a new box object on success.
\end{DoxyReturn}
After instantiation, if a box object hasn\textquotesingle{}t its layout function set, via \mbox{\hyperlink{group__Evas__Object__Box__Group_gacabb47de0d8706b4c8628b519b2d1494}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+set()}}, it will have it by default set to \mbox{\hyperlink{group__Evas__Object__Box__Group_gaaaaf1c9ba2bd49e51108c1202aea9c3c}{evas\+\_\+object\+\_\+box\+\_\+layout\+\_\+horizontal()}}. The remaining properties of the box must be set/retrieved via {\ttfamily evas\+\_\+object\+\_\+box\+\_\+\{h,v\}\+\_\+\{align,padding\}\+\_\+\{get,set)()}. 

References \mbox{\hyperlink{group__Eina__Safety__Checks__Group_gae7cf7b1d66fa9022242e09fd53c06bb2}{EINA\+\_\+\+SAFETY\+\_\+\+ON\+\_\+\+FALSE\+\_\+\+RETURN\+\_\+\+VAL}}, and \mbox{\hyperlink{group__Evas__Canvas_ga7987306d8b2c49352b9d2c41585d0ce9}{EVAS\+\_\+\+CANVAS\+\_\+\+CLASS}}.

\mbox{\Hypertarget{group__Evas__Object__Box__Group_gab25fa33a8c550a9761fcf1660f1ccb47}\label{group__Evas__Object__Box__Group_gab25fa33a8c550a9761fcf1660f1ccb47}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_option\_property\_vget@{evas\_object\_box\_option\_property\_vget}}
\index{evas\_object\_box\_option\_property\_vget@{evas\_object\_box\_option\_property\_vget}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_option\_property\_vget()}{evas\_object\_box\_option\_property\_vget()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+vget (\begin{DoxyParamCaption}\item[{const \mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$}]{o,  }\item[{\mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$}]{opt,  }\item[{int}]{property,  }\item[{va\+\_\+list}]{args }\end{DoxyParamCaption})}



Get a property\textquotesingle{}s value (by its given numerical identifier), on a given box child element -- by a variable argument list. 


\begin{DoxyParams}{Parameters}
{\em o} & The box parenting the child element \\
\hline
{\em opt} & The box option structure bound to the child box element to get a property from \\
\hline
{\em property} & The numerical ID of the given property \\
\hline
{\em args} & The variable argument list with pointers to where to store the values of this property. They {\bfseries{must}} point to variables of the same type the user has defined for them. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily EINA\+\_\+\+TRUE} on success, {\ttfamily EINA\+\_\+\+FALSE} on failure.
\end{DoxyReturn}
This is a variable argument list variant of the \mbox{\hyperlink{group__Evas__Object__Box__Group_ga93520f6107fdfd9fc3453574b447c082}{evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+get()}}. See its documentation for more details. 

Referenced by \mbox{\hyperlink{group__Evas__Object__Box__Group_ga93520f6107fdfd9fc3453574b447c082}{evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+get()}}.

\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga4d60571f70fc69e32b6cd083e0727458}\label{group__Evas__Object__Box__Group_ga4d60571f70fc69e32b6cd083e0727458}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_option\_property\_vset@{evas\_object\_box\_option\_property\_vset}}
\index{evas\_object\_box\_option\_property\_vset@{evas\_object\_box\_option\_property\_vset}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_option\_property\_vset()}{evas\_object\_box\_option\_property\_vset()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+vset (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$}]{o,  }\item[{\mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$}]{opt,  }\item[{int}]{property,  }\item[{va\+\_\+list}]{args }\end{DoxyParamCaption})}



Set a property value (by its given numerical identifier), on a given box child element -- by a variable argument list. 


\begin{DoxyParams}{Parameters}
{\em o} & The box parenting the child element \\
\hline
{\em opt} & The box option structure bound to the child box element to set a property on \\
\hline
{\em property} & The numerical ID of the given property \\
\hline
{\em args} & The variable argument list implementing the value to be set for this property. It {\bfseries{must}} be of the same type the user has defined for it. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily EINA\+\_\+\+TRUE} on success, {\ttfamily EINA\+\_\+\+FALSE} on failure.
\end{DoxyReturn}
This is a variable argument list variant of the \mbox{\hyperlink{group__Evas__Object__Box__Group_gaa1f895a0011630e5cfa06362f90ab0b6}{evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+set()}}. See its documentation for more details. 

Referenced by \mbox{\hyperlink{group__Evas__Object__Box__Group_gaa1f895a0011630e5cfa06362f90ab0b6}{evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+set()}}.

\mbox{\Hypertarget{group__Evas__Object__Box__Group_gaa1f895a0011630e5cfa06362f90ab0b6}\label{group__Evas__Object__Box__Group_gaa1f895a0011630e5cfa06362f90ab0b6}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_option\_property\_set@{evas\_object\_box\_option\_property\_set}}
\index{evas\_object\_box\_option\_property\_set@{evas\_object\_box\_option\_property\_set}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_option\_property\_set()}{evas\_object\_box\_option\_property\_set()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+set (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$}]{o,  }\item[{\mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$}]{opt,  }\item[{int}]{property,  }\item[{}]{... }\end{DoxyParamCaption})}



Set a property value (by its given numerical identifier), on a given box child element. 


\begin{DoxyParams}{Parameters}
{\em o} & The box parenting the child element \\
\hline
{\em opt} & The box option structure bound to the child box element to set a property on \\
\hline
{\em property} & The numerical ID of the given property \\
\hline
{\em ...} & (List of) actual value(s) to be set for this property. It (they) {\bfseries{must}} be of the same type the user has defined for it (them). \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily EINA\+\_\+\+TRUE} on success, {\ttfamily EINA\+\_\+\+FALSE} on failure.
\end{DoxyReturn}
\begin{DoxyNote}{Note}
This call won\textquotesingle{}t do anything for a canonical Evas box. Only users which have {\bfseries{subclassed}} it, setting custom box items options (see \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}}) on it, would benefit from this function. They\textquotesingle{}d have to implement it and set it to be the \mbox{\hyperlink{struct__Evas__Object__Box__Api_ad50dd1dbc79e084c90736bb988e7f370}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api\+::property\+\_\+set}} smart class function of the box, which is originally set to {\ttfamily NULL}.

This function will internally create a variable argument list, with the values passed after {\ttfamily property}, and call \mbox{\hyperlink{group__Evas__Object__Box__Group_ga4d60571f70fc69e32b6cd083e0727458}{evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+vset()}} with this list and the same previous arguments. 
\end{DoxyNote}


References \mbox{\hyperlink{group__Evas__Object__Box__Group_ga4d60571f70fc69e32b6cd083e0727458}{evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+vset()}}.

\mbox{\Hypertarget{group__Evas__Object__Box__Group_ga93520f6107fdfd9fc3453574b447c082}\label{group__Evas__Object__Box__Group_ga93520f6107fdfd9fc3453574b447c082}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_option\_property\_get@{evas\_object\_box\_option\_property\_get}}
\index{evas\_object\_box\_option\_property\_get@{evas\_object\_box\_option\_property\_get}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_option\_property\_get()}{evas\_object\_box\_option\_property\_get()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool}} evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+get (\begin{DoxyParamCaption}\item[{const \mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$}]{o,  }\item[{\mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}} $\ast$}]{opt,  }\item[{int}]{property,  }\item[{}]{... }\end{DoxyParamCaption})}



Get a property\textquotesingle{}s value (by its given numerical identifier), on a given box child element. 


\begin{DoxyParams}{Parameters}
{\em o} & The box parenting the child element \\
\hline
{\em opt} & The box option structure bound to the child box element to get a property from \\
\hline
{\em property} & The numerical ID of the given property \\
\hline
{\em ...} & (List of) pointer(s) where to store the value(s) set for this property. It (they) {\bfseries{must}} point to variable(s) of the same type the user has defined for it (them). \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily EINA\+\_\+\+TRUE} on success, {\ttfamily EINA\+\_\+\+FALSE} on failure.
\end{DoxyReturn}
\begin{DoxyNote}{Note}
This call won\textquotesingle{}t do anything for a canonical Evas box. Only users which have {\bfseries{subclassed}} it, getting custom box items options (see \mbox{\hyperlink{group__Evas__Object__Box__Group_gabbeb05bf47aaf7681e9d83a1b0055d20}{Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option}}) on it, would benefit from this function. They\textquotesingle{}d have to implement it and get it to be the \mbox{\hyperlink{struct__Evas__Object__Box__Api_a8806f7152a812017034d4bf0a444963b}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Api\+::property\+\_\+get}} smart class function of the box, which is originally get to {\ttfamily NULL}.

This function will internally create a variable argument list, with the values passed after {\ttfamily property}, and call \mbox{\hyperlink{group__Evas__Object__Box__Group_gab25fa33a8c550a9761fcf1660f1ccb47}{evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+vget()}} with this list and the same previous arguments. 
\end{DoxyNote}


References \mbox{\hyperlink{group__Evas__Object__Box__Group_gab25fa33a8c550a9761fcf1660f1ccb47}{evas\+\_\+object\+\_\+box\+\_\+option\+\_\+property\+\_\+vget()}}.

\mbox{\Hypertarget{group__Evas__Object__Box__Group_gad70d6bbbbf4a0e093010a9a23c3a32e9}\label{group__Evas__Object__Box__Group_gad70d6bbbbf4a0e093010a9a23c3a32e9}} 
\index{Box Smart Object@{Box Smart Object}!evas\_object\_box\_children\_get@{evas\_object\_box\_children\_get}}
\index{evas\_object\_box\_children\_get@{evas\_object\_box\_children\_get}!Box Smart Object@{Box Smart Object}}
\doxysubsubsection{\texorpdfstring{evas\_object\_box\_children\_get()}{evas\_object\_box\_children\_get()}}
{\footnotesize\ttfamily EVAS\+\_\+\+API \mbox{\hyperlink{group__Eina__List__Group_ga3295e1210efea1fb0fd6acbf3cbc1f29}{Eina\+\_\+\+List}} $\ast$ evas\+\_\+object\+\_\+box\+\_\+children\+\_\+get (\begin{DoxyParamCaption}\item[{const \mbox{\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object}} $\ast$}]{o }\end{DoxyParamCaption})}



Get the list of children objects in a given box object. 


\begin{DoxyParams}{Parameters}
{\em o} & The box to retrieve an items list from \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
A list of {\ttfamily o\textquotesingle{}s} child objects, on success, or {\ttfamily NULL}, on errors (or if it has no child objects)
\end{DoxyReturn}
The returned list should be freed with {\ttfamily \mbox{\hyperlink{group__Eina__List__Group_ga82a1bfa543e21853f9ea3ff88dd1250b}{eina\+\_\+list\+\_\+free()}}} when you no longer need it.

\begin{DoxyNote}{Note}
This is a duplicate of the list kept by the box internally. It\textquotesingle{}s up to the user to destroy it when it no longer needs it. It\textquotesingle{}s possible to remove objects from the box when walking this list, but these removals won\textquotesingle{}t be reflected on it. 
\end{DoxyNote}


References \mbox{\hyperlink{group__Eina__List__Group_ga625698a383dda8fc0db245a1c7608c49}{eina\+\_\+list\+\_\+append()}}, \mbox{\hyperlink{group__Eina__List__Group_gac6efafc19f526d916cdb9757240a8773}{EINA\+\_\+\+LIST\+\_\+\+FOREACH}}, and \mbox{\hyperlink{struct__Evas__Object__Box__Option_af01dd3e815a84ac6c7cbfbd3a6dbc148}{\+\_\+\+Evas\+\_\+\+Object\+\_\+\+Box\+\_\+\+Option\+::obj}}.

