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
bool elm_photo::aspect_fixed_get |
( |
| ) |
const |
|
inline |
Get if the object keeps the original aspect ratio.
- Returns
EINA_TRUE
if the object keeps the original aspect, EINA_FALSE
otherwise.
- Parameters
-
fixed | EINA_TRUE if the photo should fix the aspect, EINA_FALSE otherwise. |
void elm_photo::aspect_fixed_set |
( |
bool |
fixed_ | ) |
const |
|
inline |
Get if the object keeps the original aspect ratio.
- Returns
EINA_TRUE
if the object keeps the original aspect, EINA_FALSE
otherwise.
- Parameters
-
fixed | EINA_TRUE if the photo should fix the aspect, EINA_FALSE otherwise. |
Evas_Object* elm_photo_add |
( |
Evas_Object * |
parent | ) |
|
Add a new photo to the parent.
- Parameters
-
- 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. |
void elm_photo::thumb_set |
( |
std::string |
file_, |
|
|
std::string |
group_ |
|
) |
| const |
|
inline |
Set the file that will be used as thumbnail in the photo.
- Parameters
-
file | The path to file that will be used as thumbnail. |
group | The key used in case of an EET file. |