Tizen Native API  5.5

table_inheritance_tree.png

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_Objectelm_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

Add a new table to the parent.

Parameters:
parentThe parent object
Returns:
The new object or NULL if it cannot be created
Since :
2.3.1
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:
subobjThe subobject to be modified in the table
colColumn number
rowRow number
colspancolspan
rowspanrowspan
See also:
elm_table_pack_set()
Since :
2.3.1
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:
subobjThe subobject to be modified in the table
colColumn number
rowRow number
colspancolspan
rowspanrowspan

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.1