• name - The icon name


Get the icon name of image set by icon standard names.

If the image was set using efl_file_set() instead of Efl.Ui.Image.icon.set, then this function will return null.


Set the image by icon standards names.

For example, defines standard icon names such as "home" and "network". There can be different icon sets to match those icon keys. The "name" given as parameter is one of these "keys" and will be used to look in the paths and elementary theme.

If the name is not found in any of the expected locations and is the absolute path of an image file, this image will be used. Lookup order used by Efl.Ui.Image.icon.set can be set using "icon_theme" in config.

The image set by this function can be changed by Efl.File.file.set.
This function does not accept relative icon path.

See also Efl.Ui.Image.icon.get.


@property icon {
    get {
        values {
            name: free(string, free);
    set {
        values {
            name: free(string, free);
        return: bool;

C signature

const char *efl_ui_image_icon_get(const Eo *obj);
Eina_Bool efl_ui_image_icon_set(Eo *obj, const char *name);

Implemented by

  • Efl.Ui.Image.icon