Icon¶

Widget description¶
An icon object is used to display standard icon images (“delete”, “edit”, “arrows”, etc.) or images coming from a custom file (PNG, JPG, EDJE, etc.), on icon contexts.
The icon image requested can be in the Elementary theme in use, or in
the freedesktop.org
theme paths. It’s possible to set the order of
preference from where an image will be fetched.
This widget inherits from the Image
one, so
that all the functions acting on it also work for icon objects.
You should be using an icon, instead of an image, whenever one of the following apply:
you need a thumbnail version of an original image
you need freedesktop.org provided icon images
you need theme provided icon images (Edje groups)
Default images provided by Elementary’s default theme are described below.
These are names that follow (more or less) the Freedesktop icon naming specification. Use of these names are preferred, at least if you want to give your user the ability to use other themes. All these icons can be seen in the elementary_test application, the test is called “Icon Standard”.
folder
(since 1.13)user-home
(since 1.13)user-trash
(since 1.13)view-close
(since 1.13)view-refresh
(since 1.13)window-close
1.13)document-close
(since 1.13)document-edit
(since 1.13)dialog-info
(since 1.13)dialog-close
(since 1.13)arrow-up
(since 1.13)arrow-down
(since 1.13)arrow-left
(since 1.13)arrow-right
(since 1.13)arrow-up-left
(since 1.13)arrow-up-right
(since 1.13)arrow-down-left
(since 1.13)arrow-down-right
(since 1.13)edit-delete
(since 1.13)application-chat
(since 1.13)application-clock
(since 1.13)media-seek-forward
1.13)media-seek-backward
(since 1.13)media-skip-forward
(since 1.13)media-skip-backward
(since 1.13)media-playback-pause
(since 1.13)media-playback-start
(since 1.13)media-playback-stop
(since 1.13)media-eject
(since 1.13)audio-volume
(since 1.13)audio-volume-muted
(since 1.13)
These are names for icons that were first intended to be used in toolbars, but can be used in many other places too:
home
close
apps
arrow_up
arrow_down
arrow_left
arrow_right
chat
clock
delete
edit
refresh
folder
file
These are names for icons that were designed to be used in menus (but again, you can use them anywhere else):
menu/home
menu/close
menu/apps
menu/arrow_up
menu/arrow_down
menu/arrow_left
menu/arrow_right
menu/chat
menu/clock
menu/delete
menu/edit
menu/refresh
menu/folder
menu/file
And these are names for some media player specific icons:
media_player/forward
media_player/info
media_player/next
media_player/pause
media_player/play
media_player/prev
media_player/rewind
media_player/stop
Emitted signals¶
thumb,done
- Settingthumb
has completed with successthumb,error
- Settingthumb
has failed
Enumerations¶
Icon lookup modes¶
- efl.elementary.ELM_ICON_LOOKUP_FDO_THEME¶
freedesktop, theme
- efl.elementary.ELM_ICON_LOOKUP_THEME_FDO¶
theme, freedesktop
- efl.elementary.ELM_ICON_LOOKUP_FDO¶
freedesktop
- efl.elementary.ELM_ICON_LOOKUP_THEME¶
theme
Icon type¶
- efl.elementary.ELM_ICON_NONE¶
No icon
- efl.elementary.ELM_ICON_FILE¶
Icon is a file
- efl.elementary.ELM_ICON_STANDARD¶
Icon is set with standards name