The grid is a grid layout widget that lays out a series of children as a fixed "grid" of widgets using a given percentage of the grid width and height each using the child object.

The Grid uses a "Virtual resolution" that is stretched to fill the grid widgets size itself. The default is 100 x 100, so that means the position and sizes of children are effectively percentages (0 to 100) of the width or height of the grid widget.

Functions
Evas_Object *	elm_grid_add (Evas_Object *parent)
	Adds a new grid to the parent.
void	elm_grid_size_set (Evas_Object *obj, Evas_Coord w, Evas_Coord h)
	Sets the virtual size of the grid.
void	elm_grid_size_get (const Evas_Object obj, Evas_Coord w, Evas_Coord *h)
	Gets the virtual size of the grid.
void	elm_grid_pack (Evas_Object obj, Evas_Object subobj, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord h)
	Packs the child at a given position and size.
void	elm_grid_unpack (Evas_Object obj, Evas_Object subobj)
	Unpacks a child from a grid object.
void	elm_grid_clear (Evas_Object *obj, Eina_Bool clear)
	Removes all child objects from a grid object.
void	elm_grid_pack_set (Evas_Object *subobj, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord h)
	Sets packing of an existing child at a given position and size.
void	elm_grid_pack_get (Evas_Object subobj, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord *h)
	Gets packing of a child.
Eina_List *	elm_grid_children_get (const Evas_Object *obj)
	Gets the list of the children for the grid.

Function Documentation

Evas_Object* elm_grid_add ( Evas_Object * parent )

Adds a new grid to the parent.

Since :: 2.3.1

Parameters:

[in] parent The parent object

Returns:: The new object, otherwise NULL if it cannot be created

Eina_List* elm_grid_children_get ( const Evas_Object * obj )

Gets the list of the children for the grid.

Since :: 2.3.1

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

Parameters:

[in] obj The grid object

Returns:: The children list

void elm_grid_clear	(	Evas_Object *	obj,
		Eina_Bool	clear
	)

Removes all child objects from a grid object.

Since :: 2.3.1

Parameters:

[in]	obj	The grid object
[in]	clear	If `true` it deletes the just removed children, otherwise `false`

void elm_grid_pack	(	Evas_Object *	obj,
		Evas_Object *	subobj,
		Evas_Coord	x,
		Evas_Coord	y,
		Evas_Coord	w,
		Evas_Coord	h
	)

Packs the child at a given position and size.

Since :: 2.3.1

Parameters:

[in]	obj	The grid object
[in]	subobj	The child to pack
[in]	x	The virtual x coordinate at which to pack it
[in]	y	The virtual y coordinate at which to pack it
[in]	w	The virtual width at which to pack it
[in]	h	The virtual height at which to pack it

void elm_grid_pack_get	(	Evas_Object *	subobj,
		Evas_Coord *	x,
		Evas_Coord *	y,
		Evas_Coord *	w,
		Evas_Coord *	h
	)

Gets packing of a child.

Since :: 2.3.1

Parameters:

[in]	subobj	The child to query
[out]	x	A pointer to an integer to store the virtual x coordinate
[out]	y	A pointer to an integer to store the virtual y coordinate
[out]	w	A pointer to an integer to store the virtual width
[out]	h	A pointer to an integer to store the virtual height

void elm_grid_pack_set	(	Evas_Object *	subobj,
		Evas_Coord	x,
		Evas_Coord	y,
		Evas_Coord	w,
		Evas_Coord	h
	)

Sets packing of an existing child at a given position and size.

Since :: 2.3.1

Parameters:

[in]	subobj	The child to set packing of
[in]	x	The virtual x coordinate at which to pack it
[in]	y	The virtual y coordinate at which to pack it
[in]	w	The virtual width at which to pack it
[in]	h	The virtual height at which to pack it

void elm_grid_size_get	(	const Evas_Object *	obj,
		Evas_Coord *	w,
		Evas_Coord *	h
	)

Gets the virtual size of the grid.

Since :: 2.3.1

Parameters:

[in]	obj	The grid object
[out]	w	A pointer to an integer to store the virtual width of the grid
[out]	h	A pointer to an integer to store the virtual height of the grid

void elm_grid_size_set	(	Evas_Object *	obj,
		Evas_Coord	w,
		Evas_Coord	h
	)

Sets the virtual size of the grid.

Since :: 2.3.1

Parameters:

[in]	obj	The grid object
[in]	w	The virtual width of the grid
[in]	h	The virtual height of the grid

void elm_grid_unpack	(	Evas_Object *	obj,
		Evas_Object *	subobj
	)

Unpacks a child from a grid object.

Since :: 2.3.1

Parameters:

[in]	obj	The grid object
[in]	subobj	The child to unpack

Functions

Function Documentation