src/lib/elm_icon.h

   1 /**
   2  * @defgroup Icon Icon
   3  * @ingroup elm_widget_group
   4  *
   5  * @image html icon_inheritance_tree.png
   6  * @image latex icon_inheritance_tree.eps
   7  *
   8  *
   9  * An icon object is used to display standard icon images ("delete",
  10  * "edit", "arrows", etc.) or images coming from a custom file (PNG,
  11  * JPG, EDJE, etc.), on icon contexts.
  12  *
  13  * The icon image requested can be in the Elementary theme in use, or
  14  * in the @c freedesktop.org theme paths. It's possible to set the
  15  * order of preference from where an image will be fetched.
  16  *
  17  * This widget inherits from the @ref Image one, so that all the
  18  * functions acting on it also work for icon objects.
  19  *
  20  * You should be using an icon, instead of an image, whenever one of
  21  * the following apply:
  22  * - you need a @b thumbnail version of an original image
  23  * - you need freedesktop.org provided icon images
  24  * - you need theme provided icon images (Edje groups)
  25  *
  26  * Various calls on the icon's API are marked as @b deprecated, as
  27  * they just wrap the image counterpart functions. Use the ones we
  28  * point you to, for each case of deprecation here, instead --
  29  * eventually the deprecated ones will be discarded (next major
  30  * release).
  31  *
  32  * Default images provided by Elementary's default theme are described
  33  * below.
  34  *
  35  * These are names that follow (more or less) the @b Freedesktop icon naming
  36  * specification. Use of these names are @b preferred, at least if you want to
  37  * give your user the ability to use other themes. All these icons can be
  38  * seen in the elementary_test application, the test is called "Icon Standard".
  39  *
  40  * @li @c "folder" (since 1.13)
  41  * @li @c "user-home" (since 1.13)
  42  * @li @c "user-trash" (since 1.13)
  43  *
  44  * @li @c "view-close" (since 1.13)
  45  * @li @c "view-refresh" (since 1.13)
  46  *
  47  * @li @c "window-close" (since 1.13)
  48  *
  49  * @li @c "document-close" (since 1.13)
  50  * @li @c "document-edit" (since 1.13)
  51  *
  52  * @li @c "dialog-info" (since 1.13)
  53  * @li @c "dialog-close" (since 1.13)
  54  *
  55  * @li @c "arrow-up" (since 1.13)
  56  * @li @c "arrow-down" (since 1.13)
  57  * @li @c "arrow-left" (since 1.13)
  58  * @li @c "arrow-right" (since 1.13)
  59  * @li @c "arrow-up-left" (since 1.13)
  60  * @li @c "arrow-up-right" (since 1.13)
  61  * @li @c "arrow-down-left" (since 1.13)
  62  * @li @c "arrow-down-right" (since 1.13)
  63  *
  64  * @li @c "edit-delete" (since 1.13)
  65  *
  66  * @li @c "application-chat" (since 1.13)
  67  * @li @c "application-clock" (since 1.13)
  68  *
  69  * @li @c "media-seek-forward" (since 1.13)
  70  * @li @c "media-seek-backward" (since 1.13)
  71  * @li @c "media-skip-forward" (since 1.13)
  72  * @li @c "media-skip-backward" (since 1.13)
  73  * @li @c "media-playback-pause" (since 1.13)
  74  * @li @c "media-playback-start" (since 1.13)
  75  * @li @c "media-playback-stop" (since 1.13)
  76  * @li @c "media-eject" (since 1.13)
  77  *
  78  * @li @c "audio-volume" (since 1.13)
  79  * @li @c "audio-volume-muted" (since 1.13)
  80  *
  81  * These are names for icons that were first intended to be used in
  82  * toolbars, but can be used in many other places too:
  83  * @li @c "home"
  84  * @li @c "close"
  85  * @li @c "apps"
  86  * @li @c "arrow_up"
  87  * @li @c "arrow_down"
  88  * @li @c "arrow_left"
  89  * @li @c "arrow_right"
  90  * @li @c "chat"
  91  * @li @c "clock"
  92  * @li @c "delete"
  93  * @li @c "edit"
  94  * @li @c "refresh"
  95  * @li @c "folder"
  96  * @li @c "file"
  97  *
  98  * These are names for icons that were designed to be used in menus
  99  * (but again, you can use them anywhere else):
 100  * @li @c "menu/home"
 101  * @li @c "menu/close"
 102  * @li @c "menu/apps"
 103  * @li @c "menu/arrow_up"
 104  * @li @c "menu/arrow_down"
 105  * @li @c "menu/arrow_left"
 106  * @li @c "menu/arrow_right"
 107  * @li @c "menu/chat"
 108  * @li @c "menu/clock"
 109  * @li @c "menu/delete"
 110  * @li @c "menu/edit"
 111  * @li @c "menu/refresh"
 112  * @li @c "menu/folder"
 113  * @li @c "menu/file"
 114  *
 115  * And these are names for some media player specific icons:
 116  * @li @c "media_player/forward"
 117  * @li @c "media_player/info"
 118  * @li @c "media_player/next"
 119  * @li @c "media_player/pause"
 120  * @li @c "media_player/play"
 121  * @li @c "media_player/prev"
 122  * @li @c "media_player/rewind"
 123  * @li @c "media_player/stop"
 124  *
 125  * This widget emits the following signals, besides the ones sent from
 126  * @ref Image:
 127  * - @c "thumb,done" - elm_icon_thumb_set() has completed with success
 128  *                     (since 1.7)
 129  * - @c "thumb,error" - elm_icon_thumb_set() has failed (since 1.7)
 130  *
 131  * Elementary icon objects support the following API calls:
 132  * @li elm_object_signal_emit()
 133  * @li elm_object_signal_callback_add()
 134  * @li elm_object_signal_callback_del()
 135  * for emmiting and listening to signals on the object, when the
 136  * internal image comes from an Edje object. This behavior was added
 137  * unintentionally, though, and is @b deprecated. Expect it to be
 138  * dropped on future releases.
 139  *
 140  */
 141
 142 #include "elm_icon_common.h"
 143 #ifdef EFL_EO_API_SUPPORT
 144 #include "elm_icon_eo.h"
 145 #endif
 146 #ifndef EFL_NOLEGACY_API_SUPPORT
 147 #include "elm_icon_legacy.h"
 148 #endif
 149 /**
 150  * @}
 151  */