How to use the elm_icon_standard_set()

How to use the elm_icon_standard_set()

BY 20 Aug 2015 Native Application Development

As below, the elm_icon_standard_set api proto.

/**
 * @brief Sets the icon by icon standard names.
 *
 * @since_tizen 2.3
 *
 * @remarks For example, freedesktop.org defines the standard icon names such as "home",
 *          "network", etc. There can be different icon sets to match those icon
 *          keys. The @a name given as a parameter is one of these "keys", and is
 *          used to look in the freedesktop.org paths and elementary theme. One can
 *          change the lookup order with elm_icon_order_lookup_set().
 *
 * @remarks If @a name is not found in any of the expected locations and it is the
 *          absolute path of an image file, this image is used.
 *
 * @remarks The icon image set by this function can be changed by
 *          elm_image_file_set().
 *
 * @param[in] obj The icon object
 * @param[in] name The icon name
 *
 * @return (@c EINA_TRUE = success, @c EINA_FALSE = error)
 *
 * @see elm_icon_standard_get()
 * @see elm_image_file_set()
 */
EAPI Eina_Bool             elm_icon_standard_set(Evas_Object *obj, const char *name);

I’ve found sample code from the IDE help,

Evas_Object *icon;
Elm_Map_Overlay *forest_class = elm_map_overlay_class_add(map);

// Set min zoom level at which class is displayed
elm_map_overlay_displayed_zoom_min_set(forest_class, 8);

// Create a Home icon object and set it to the forest class 
icon = elm_icon_add(map);
elm_icon_standard_set(icon, "home");
elm_map_overlay_icon_set(forest_class, icon);

Seems the icon standard name “home” should be predefined in somewhere, and the name should map to a real path of an image. Right?

Or, tizen will try to search such image by name (here it’s “home”) in some default folders (such as res/images, or shared/res, etc.).

Actually, I’ve put some images into the res/images and shared/res, and call elm_icon_standard_set(icon, “image_name”), but seems it’s not working, I don’t know why?

Is anybody know the root cause? Or how to configure/predefine the standard icon name(where to define it?). Many thanks!!!

Written by