Functions | |
Evas_Object * | elm_photo_add (Evas_Object *parent) |
Add a new photo to the parent. | |
Eina_Bool | elm_photo_file_set (Evas_Object *obj, const char *file) |
Set the file that will be used as the photo widget's image. | |
void | elm_photo_thumb_set (const Evas_Object *obj, const char *file, const char *group) |
Set the file that will be used as thumbnail in the photo. | |
void | elm_photo_size_set (Evas_Object *obj, int size) |
Set the size that will be used on the photo. | |
void | elm_photo_fill_inside_set (Evas_Object *obj, Eina_Bool fill) |
Set if the photo should be completely visible or not. | |
void | elm_photo_editable_set (Evas_Object *obj, Eina_Bool set) |
Set editability of the photo. | |
void | elm_photo_aspect_fixed_set (Evas_Object *obj, Eina_Bool fixed) |
Set whether the original aspect ratio of the photo should be kept on resize. | |
Eina_Bool | elm_photo_aspect_fixed_get (const Evas_Object *obj) |
Get if the object keeps the original aspect ratio. |
Detailed Description

The Elementary photo widget is intended for displaying a photo, for ex., a person's image (contact). Simple, yet with a very specific purpose. It has a decorative frame around the inner image itself, on the default theme. If and while no photo is set on it, it displays a person icon, indicating it's a photo placeholder.
This widget relies on an internal Icon, so that the APIs of these two widgets are similar (drag and drop is also possible here, for example).
Signals that you can add callbacks for are:
"clicked"
- This is called when a user has clicked the photo"drag,start"
- One has started dragging the inner image out of the photo's frame"drag,end"
- One has dropped the dragged image somewhere
Function Documentation
Evas_Object* elm_photo_add | ( | Evas_Object * | parent | ) |
Add a new photo to the parent.
- Parameters:
-
parent The parent object
- Returns:
- The new object or NULL if it cannot be created
Eina_Bool elm_photo_aspect_fixed_get | ( | const Evas_Object * | obj | ) |
Get if the object keeps the original aspect ratio.
- Parameters:
-
obj The photo object.
- Returns:
EINA_TRUE
if the object keeps the original aspect,EINA_FALSE
otherwise.
References elm_image_aspect_fixed_get().
void elm_photo_aspect_fixed_set | ( | Evas_Object * | obj, |
Eina_Bool | fixed | ||
) |
Set whether the original aspect ratio of the photo should be kept on resize.
- Parameters:
-
obj The photo object. fixed EINA_TRUE
if the photo should fix the aspect,EINA_FALSE
otherwise.
The original aspect ratio (width / height) of the photo is usually distorted to match the object's size. Enabling this option will fix this original aspect, and the way that the photo is fit into the object's area
- See also:
- elm_photo_aspect_fixed_get()
References elm_image_aspect_fixed_set().
void elm_photo_editable_set | ( | Evas_Object * | obj, |
Eina_Bool | set | ||
) |
Set editability of the photo.
An editable photo can be dragged to or from, and can be cut or pasted too. Note that pasting an image or dropping an item on the image will delete the existing content.
- Parameters:
-
obj The photo object. set To set of clear editability.
References elm_image_editable_set().
Eina_Bool elm_photo_file_set | ( | Evas_Object * | obj, |
const char * | file | ||
) |
Set the file that will be used as the photo widget's image.
- Parameters:
-
obj The photo object file The path to file that will be used as obj's image.
- Returns:
EINA_TRUE
on success,EINA_FALSE
otherwise
- Note:
- Use
NULL
on file to set the photo widget back to it's initial state, which indicates "no photo".
References elm_icon_standard_set(), and elm_image_file_set().
void elm_photo_fill_inside_set | ( | Evas_Object * | obj, |
Eina_Bool | fill | ||
) |
Set if the photo should be completely visible or not.
- Parameters:
-
obj The photo object fill if true the photo will be completely visible
References elm_image_fill_outside_set().
void elm_photo_size_set | ( | Evas_Object * | obj, |
int | size | ||
) |
Set the size that will be used on the photo.
- Parameters:
-
obj The photo object size The size of the photo
References elm_image_prescale_set().
void elm_photo_thumb_set | ( | const Evas_Object * | obj, |
const char * | file, | ||
const char * | group | ||
) |
Set the file that will be used as thumbnail in the photo.
- Parameters:
-
obj The photo object. file The path to file that will be used as thumbnail. group The key used in case of an EET file.
References elm_icon_thumb_set().