A container widget to arrange other widgets in a table where items can span multiple columns or rows - even overlap (and then be raised or lowered accordingly to adjust stacking if they do overlap).

The row and column count is not fixed. The table widget adjusts itself when subobjects are added to it dynamically.

The most common way to use a table is:

 table = elm_table_add(win);
 evas_object_show(table);
 elm_table_padding_set(table, space_between_columns, space_between_rows);
 elm_table_pack(table, table_content_object, column, row, colspan, rowspan);
 elm_table_pack(table, table_content_object, next_column, next_row, colspan, rowspan);
 elm_table_pack(table, table_content_object, other_column, other_row, colspan, rowspan);

The following are examples of how to use a table:

Functions
Evas_Object *	elm_table_add (Evas_Object *parent)
	Add a new table to the parent.
void	elm_table_pack_set (Evas_Object *subobj, int col, int row, int colspan, int rowspan)
	Set the packing location of an existing child of the table.
void	elm_table_pack_get (Evas_Object subobj, int col, int row, int colspan, int *rowspan)
	Get the packing location of an existing child of the table.

Function Documentation

Evas_Object* elm_table_add ( Evas_Object * parent )

Add a new table to the parent.

Parameters:

parent The parent object

Returns:: The new object or NULL if it cannot be created

Since :: 2.3

Examples:: mapbuf_example.c, table_example_01.c, and table_example_02.c.

void elm_table_pack_get	(	Evas_Object *	subobj,
		int *	col,
		int *	row,
		int *	colspan,
		int *	rowspan
	)

Get the packing location of an existing child of the table.

Parameters:

subobj	The subobject to be modified in the table
col	Column number
row	Row number
colspan	colspan
rowspan	rowspan

See also:: elm_table_pack_set()

Since :: 2.3

void elm_table_pack_set	(	Evas_Object *	subobj,
		int	col,
		int	row,
		int	colspan,
		int	rowspan
	)

Set the packing location of an existing child of the table.

Parameters:

subobj	The subobject to be modified in the table
col	Column number
row	Row number
colspan	colspan
rowspan	rowspan

Modifies the position of an object already in the table.

Note:: All positioning inside the table is relative to rows and columns, so a value of 0 for col and row, means the top left cell of the table, and a value of 1 for colspan and rowspan means subobj only takes that 1 cell.

Since :: 2.3

Functions

Function Documentation