Functions
void	evas_object_table_homogeneous_set (Evas_Table *obj, Evas_Object_Table_Homogeneous_Mode homogeneous)
	Set how this table should layout children.
Evas_Object_Table_Homogeneous_Mode	evas_object_table_homogeneous_get (const Evas_Table *obj)
	Get the current layout homogeneous mode.
void	evas_object_table_align_set (Evas_Table *obj, double horizontal, double vertical)
	Set the alignment of the whole bounding box of contents.
void	evas_object_table_align_get (const Evas_Table obj, double horizontal, double *vertical)
	Get alignment of the whole bounding box of contents.
void	evas_object_table_padding_set (Evas_Table *obj, Evas_Coord horizontal, Evas_Coord vertical)
	Set padding between cells.
void	evas_object_table_padding_get (const Evas_Table obj, Evas_Coord horizontal, Evas_Coord *vertical)
	Get padding between cells.
void	evas_object_table_mirrored_set (Evas_Table *obj, Eina_Bool mirrored)
	Sets the mirrored mode of the table. In mirrored mode the table items go from right to left instead of left to right. That is, 1,1 is top right, not top left.
Eina_Bool	evas_object_table_mirrored_get (const Evas_Table *obj)
	Gets the mirrored mode of the table.
void	evas_object_table_col_row_size_get (const Evas_Table obj, int cols, int *rows)
	Get the number of columns and rows this table takes.
Eina_List *	evas_object_table_children_get (const Evas_Table *obj)
	Get the list of children for the table.
Evas_Object *	evas_object_table_child_get (const Evas_Table *obj, unsigned short col, unsigned short row)
	Get the child of the table at the given coordinates.
void	evas_object_table_clear (Evas_Table *obj, Eina_Bool clear)
	Faster way to remove all child objects from a table object.
Eina_Accessor *	evas_object_table_accessor_new (const Evas_Table *obj)
	Get an accessor to get random access to the list of children for the table.
Eina_Iterator *	evas_object_table_iterator_new (const Evas_Table *obj)
	Get an iterator to walk the list of children for the table.
Evas_Object *	evas_object_table_add_to (Evas_Table *obj)
	Create a table that is child of a given element parent.
Eina_Bool	evas_object_table_pack_get (const Evas_Table obj, Evas_Object child, unsigned short col, unsigned short row, unsigned short colspan, unsigned short rowspan)
	Get packing location of a child of table.
Eina_Bool	evas_object_table_pack (Evas_Table obj, Evas_Object child, unsigned short col, unsigned short row, unsigned short colspan, unsigned short rowspan)
	Add a new child to a table object or set its current packing.
Eina_Bool	evas_object_table_unpack (Evas_Table obj, Evas_Object child)
	Remove child from table.
Typedefs
typedef enum _Evas_Object_Table_Homogeneous_Mode	Evas_Object_Table_Homogeneous_Mode

Convenience smart object that packs children using a tabular layout using children size hints to define their size and alignment inside their cell space.

Table Smart Object example shows how to use this Evas_Object.

See also:: Size Hints

Typedef Documentation

typedef enum _Evas_Object_Table_Homogeneous_Mode Evas_Object_Table_Homogeneous_Mode

How to pack items into cells in a table.

See also:: evas_object_table_homogeneous_set() for an explanation of the function of each one. Table cell pack mode.

Enumeration Type Documentation

enum _Evas_Object_Table_Homogeneous_Mode

How to pack items into cells in a table.

See also:: evas_object_table_homogeneous_set() for an explanation of the function of each one.

Function Documentation

Eina_Accessor* evas_object_table_accessor_new ( const Evas_Table * obj )

Get an accessor to get random access to the list of children for the table.

Since :: 2.3

Note:: Do not remove or delete objects while walking the list.

Parameters:

[in] obj The table object

Evas_Object* evas_object_table_add ( Evas * evas )

Create a new table.

Since :: 2.3

Parameters:

[in] evas Canvas in which table will be added.

Evas_Object* evas_object_table_add_to ( Evas_Table * obj )

Create a table that is child of a given element parent.

Since :: 2.3

See also:: evas_object_table_add()

Parameters:

[in] obj The table object

void evas_object_table_align_get	(	const Evas_Table *	obj,
		double *	horizontal,
		double *	vertical
	)

Get alignment of the whole bounding box of contents.

Since :: 2.3

Parameters:

[in]	obj	The table object
[out]	horizontal	No description supplied.
[out]	vertical	No description supplied.

void evas_object_table_align_set	(	Evas_Table *	obj,
		double	horizontal,
		double	vertical
	)

Set the alignment of the whole bounding box of contents.

Since :: 2.3

Parameters:

[in]	obj	The table object
[in]	horizontal	No description supplied.
[in]	vertical	No description supplied.

Evas_Object* evas_object_table_child_get	(	const Evas_Table *	obj,
		unsigned short	col,
		unsigned short	row
	)

Get the child of the table at the given coordinates.

Since :: 2.3

Remarks:: This does not take into account col/row spanning

Parameters:

[in]	obj	The table object
[in]	col	No description supplied.
[in]	row	No description supplied.

Eina_List* evas_object_table_children_get ( const Evas_Table * obj )

Get the list of children for the table.

Since :: 2.3

Remarks:: This is a duplicate of the list kept by the table internally. It's up to the user to destroy it when it no longer needs it. It's possible to remove objects from the table when walking this list, but these removals won't be reflected on it.

Parameters:

[in] obj The table object

void evas_object_table_clear	(	Evas_Table *	obj,
		Eina_Bool	clear
	)

Faster way to remove all child objects from a table object.

Since :: 2.3

Parameters:

[in]	obj	The table object
[in]	clear	if true, it will delete just removed children.

void evas_object_table_col_row_size_get	(	const Evas_Table *	obj,
		int *	cols,
		int *	rows
	)

Get the number of columns and rows this table takes.

Since :: 2.3

Remarks:: columns and rows are virtual entities, one can specify a table with a single object that takes 4 columns and 5 rows. The only difference for a single cell table is that paddings will be accounted proportionally.

Parameters:

[in]	obj	The table object
[out]	cols	No description supplied.
[out]	rows	No description supplied.

Evas_Object_Table_Homogeneous_Mode evas_object_table_homogeneous_get ( const Evas_Table * obj )

Get the current layout homogeneous mode.

Since :: 2.3

See also:: evas_object_table_homogeneous_set()

Parameters:

[in] obj The table object

void evas_object_table_homogeneous_set	(	Evas_Table *	obj,
		Evas_Object_Table_Homogeneous_Mode	homogeneous
	)

Set how this table should layout children.

Since :: 2.3

EVAS_OBJECT_TABLE_HOMOGENEOUS_NONE

Remarks:: If table does not use homogeneous mode then columns and rows will be calculated based on hints of individual cells. This operation mode is more flexible, but more complex and heavy to calculate as well. Weight properties are handled as a boolean expand. Negative alignment will be considered as 0.5. This is the default.

EVAS_OBJECT_TABLE_HOMOGENEOUS_TABLE

Remarks:: When homogeneous is relative to table the own table size is divided equally among children, filling the whole table area. That is, if table has WIDTH and COLUMNS, each cell will get WIDTH / COLUMNS pixels. If children have minimum size that is larger than this amount (including padding), then it will overflow and be aligned respecting the alignment hint, possible overlapping sibling cells. Weight hint is used as a boolean, if greater than zero it will make the child expand in that axis, taking as much space as possible (bounded to maximum size hint). Negative alignment will be considered as 0.5.

EVAS_OBJECT_TABLE_HOMOGENEOUS_ITEM

Remarks:: When homogeneous is relative to item it means the greatest minimum cell size will be used. That is, if no element is set to expand, the table will have its contents to a minimum size, the bounding box of all these children will be aligned relatively to the table object using evas_object_table_align_get(). If the table area is too small to hold this minimum bounding box, then the objects will keep their size and the bounding box will overflow the box area, still respecting the alignment. Weight hint is used as a boolean, if greater than zero it will make that cell expand in that axis, toggling the expand mode, which makes the table behave much like EVAS_OBJECT_TABLE_HOMOGENEOUS_TABLE, except that the bounding box will overflow and items will not overlap siblings. If no minimum size is provided at all then the table will fallback to expand mode as well.

Parameters:

[in]	obj	The table object
[in]	homogeneous	No description supplied.

Eina_Iterator* evas_object_table_iterator_new ( const Evas_Table * obj )

Get an iterator to walk the list of children for the table.

Since :: 2.3

Remarks:: Do not remove or delete objects while walking the list.

Parameters:

[in] obj The table object

Eina_Bool evas_object_table_mirrored_get ( const Evas_Table * obj )

Gets the mirrored mode of the table.

Since :: 2.3

Returns:: EINA_TRUE if it's a mirrored table, EINA_FALSE otherwise.

Since (EFL) :: 1.1

See also:: evas_object_table_mirrored_set()

Parameters:

[in] obj The table object

void evas_object_table_mirrored_set	(	Evas_Table *	obj,
		Eina_Bool	mirrored
	)

Sets the mirrored mode of the table. In mirrored mode the table items go from right to left instead of left to right. That is, 1,1 is top right, not top left.

Since :: 2.3

Since (EFL) :: 1.1

Parameters:

[in]	obj	The table object
[in]	mirrored	the mirrored mode to set

Eina_Bool evas_object_table_pack	(	Evas_Table *	obj,
		Evas_Object *	child,
		unsigned short	col,
		unsigned short	row,
		unsigned short	colspan,
		unsigned short	rowspan
	)

Add a new child to a table object or set its current packing.

Since :: 2.3

Remarks:: Note that columns and rows only guarantee 16bit unsigned values at best. That means that col + colspan AND row + rowspan must fit inside 16bit unsigned values cleanly. You will be warned once values exceed 15bit storage, and attempting to use values not able to fit in 16bits will result in failure.

Returns:: 1 on success, 0 on failure.

Parameters:

[in]	obj	The table object
[in]	child	The child object to add.
[in]	col	relative-horizontal position to place child.
[in]	row	relative-vertical position to place child.
[in]	colspan	how many relative-horizontal position to use for this child.
[in]	rowspan	how many relative-vertical position to use for this child.

Eina_Bool evas_object_table_pack_get	(	const Evas_Table *	obj,
		Evas_Object *	child,
		unsigned short *	col,
		unsigned short *	row,
		unsigned short *	colspan,
		unsigned short *	rowspan
	)

Get packing location of a child of table.

Since :: 2.3

Returns:: 1 on success, 0 on failure.

Since (EFL) :: 1.1

Parameters:

[in]	obj	The table object
[in]	child	The child object to add.
[out]	col	pointer to store relative-horizontal position to place child.
[out]	row	pointer to store relative-vertical position to place child.
[out]	colspan	pointer to store how many relative-horizontal position to use for this child.
[out]	rowspan	pointer to store how many relative-vertical position to use for this child.

void evas_object_table_padding_get	(	const Evas_Table *	obj,
		Evas_Coord *	horizontal,
		Evas_Coord *	vertical
	)

Get padding between cells.

Since :: 2.3

Parameters:

[in]	obj	The table object
[out]	horizontal	No description supplied.
[out]	vertical	No description supplied.

void evas_object_table_padding_set	(	Evas_Table *	obj,
		Evas_Coord	horizontal,
		Evas_Coord	vertical
	)

Set padding between cells.

Since :: 2.3

Parameters:

[in]	obj	The table object
[in]	horizontal	No description supplied.
[in]	vertical	No description supplied.

Eina_Bool evas_object_table_unpack	(	Evas_Table *	obj,
		Evas_Object *	child
	)

Remove child from table.

Since :: 2.3

Remarks:: removing a child will immediately call a walk over children in order to recalculate numbers of columns and rows. If you plan to remove all children, use evas_object_table_clear() instead.

Returns:: 1 on success, 0 on failure.

Parameters:

[in]	obj	The table object
[in]	child	No description supplied.

Functions

Typedefs

Typedef Documentation

Enumeration Type Documentation

Function Documentation