1 /** 2 * @defgroup Elm_Toolbar Toolbar 3 * @ingroup Elementary 4 * 5 * @image html toolbar_inheritance_tree.png 6 * @image latex toolbar_inheritance_tree.eps 7 * 8 * @image html img/widget/toolbar/preview-00.png 9 * @image latex img/widget/toolbar/preview-00.eps width=\textwidth 10 * 11 * @image html img/toolbar.png 12 * @image latex img/toolbar.eps width=\textwidth 13 * 14 * A toolbar is a widget that displays a list of items inside 15 * a box. It can be scrollable, show a menu with items that don't fit 16 * to toolbar size or even crop them. 17 * 18 * Only one item can be selected at a time. 19 * 20 * Items can have multiple states, or show menus when selected by the user. 21 * 22 * This widget implements the @ref elm-scrollable-interface 23 * interface, so that all (non-deprecated) functions for the base 24 * @ref Scroller widget also work for toolbars (since 1.8) 25 * 26 * Smart callbacks one can listen to: 27 * - @c "clicked" - when the user clicks on a toolbar item and becomes 28 * selected. 29 * - @c "longpressed" - when the toolbar is pressed for a certain 30 * amount of time. 31 * - @c "language,changed" - when the program language changes. 32 * - @c "focused" - When the toolbar has received focus. (since 1.8) 33 * - @c "unfocused" - When the toolbar has lost focus. (since 1.8) 34 * - @c "item,focused" - When the toolbar item has received focus. (since 1.10) 35 * - @c "item,unfocused" - When the toolbar item has lost focus. (since 1.10) 36 * - @c "selected" - when an item is selected. @p event_info is a selected 37 * item. (since 1.11) 38 * - @c "unselected" - when an item is unselected. @p event_info is a 39 * unselected item. (since 1.11) 40 * 41 * Available styles for it: 42 * - @c "default" 43 * - @c "transparent" - no background or shadow, just show the content 44 * 45 * Default text parts of the toolbar items that you can use for are: 46 * @li "default" - A label of the toolbar item 47 * 48 * Supported elm_object_item common APIs. 49 * @li @ref elm_object_item_del 50 * @li @ref elm_object_item_disabled_set 51 * @li @ref elm_object_item_disabled_get 52 * @li @ref elm_object_item_part_text_set 53 * @li @ref elm_object_item_part_text_get 54 * @li @ref elm_object_item_part_content_set 55 * @li @ref elm_object_item_part_content_get 56 * @li @ref elm_object_item_part_content_unset 57 * @li @ref elm_object_item_focus_set 58 * @li @ref elm_object_item_focus_get 59 * 60 * List of examples: 61 * @li @ref toolbar_example_01 62 * @li @ref toolbar_example_02 63 * @li @ref toolbar_example_03 64 */ 65 66 /** 67 * @addtogroup Elm_Toolbar 68 * @{ 69 */ 70 71 #include <elm_toolbar_common.h> 72 #ifndef EFL_NOLEGACY_API_SUPPORT 73 #include <elm_toolbar_legacy.h> 74 #endif 75 76 /** 77 * @} 78 */ 79