Photo

- Main Page
- Related Pages
- Data Structures
- Files
- Examples

Functions
Photo

## Functions
Evas_Object * | elm_photo_add (Evas_Object *parent)
| Add a new photo to the parent. More...
Eina_Bool | elm_photo_file_set (Eo *obj, const char *file)
| Set the file that will be used as the photo widget's image. More...

## 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_file_set | ( | Eo * | obj,
|  | const char * | file
| ) |  |

Set the file that will be used as the photo widget'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".

Parameters

  [in] | file | The path to file that will be used as obj's image.