The background widget can be used to set a solid background decoration to a window or to a container object. It works like an image, but has some background specific properties, for example it can be set to tiled, centered, scaled or stretched mode. There are no specific signals relative to background object
Background Examples | ||
---|---|---|
Plain color background | Image background | Background preperties |
A background is created with the elm_bg_add()
.
Evas_Object *bg; // Creating a background bg = elm_bg_add(parent);
You can set the color of the bg with elm_bg_color_set()
. Here we set the
background color to red.
Evas_Object *bg; // Use red color for background elm_bg_color_set(bg, 0xFF, 0x00, 0x00);
It is also possible to set an image or an Edje group with
elm_bg_file_set()
.
The display mode of the image in the background can be chosen with
elm_bg_option_set()
, where the following modes are available:
ELM_BG_OPTION_CENTER
: center the background imageELM_BG_OPTION_SCALE
: scale the background image, retaining aspect ratioELM_BG_OPTION_STRETCH
: stretch the background image to fill the widget's areaELM_BG_OPTION_TILE
: tile background image at its original sizeEvas_Object *bg; // Set a file on the disk as background image elm_bg_file_set(bg, "/path/to/the/image", NULL); // Set an edje group as background image elm_bg_file_set(bg, "/path/to/the/edje", "edje_group"); elm_bg_option_set(bg, ELM_BG_OPTION_STRETCH)
An overlay can be set using the “overlay” part name.
elm_object_part_content_set(bg, "overlay", over);
Here, over is an Edje object that will be displayed on top of the current bg object.
Background Examples | ||
---|---|---|
Plain color background | Image background | Background preperties |