The visible signal should be called when it is reloaded in _theme_hook_item.

[framework/uifw/elementary.git] / src / lib / elm_toolbar.h

diff --git a/src/lib/elm_toolbar.h b/src/lib/elm_toolbar.h
index f78a86b..87fda24 100644 (file)
--- a/src/lib/elm_toolbar.h
+++ b/src/lib/elm_toolbar.h
@@ -18,7 +18,8 @@
  *
  * Smart callbacks one can listen to:
  * - "clicked" - when the user clicks on a toolbar item and becomes selected.
- * - "language,changed" - when the program language changes
+ * - "longpressed" - when the toolbar is pressed for a certain amount of time.
+ * - "language,changed" - when the program language changes.
  *
  * Available styles for it:
  * - @c "default"
@@ -28,10 +29,10 @@
  * @li "default" - label of the toolbar item
  *
  * Supported elm_object_item common APIs.
- * @li elm_object_item_disabled_set
- * @li elm_object_item_disabled_get
- * @li elm_object_item_part_text_set
- * @li elm_object_item_part_text_get
+ * @li @ref elm_object_item_disabled_set
+ * @li @ref elm_object_item_disabled_get
+ * @li @ref elm_object_item_part_text_set
+ * @li @ref elm_object_item_part_text_get
  *
  * List of examples:
  * @li @ref toolbar_example_01
@@ -437,6 +438,19 @@ EAPI void                         elm_toolbar_item_selected_set(Elm_Object_Item
 EAPI Elm_Object_Item             *elm_toolbar_selected_item_get(const Evas_Object *obj);
 
 /**
+ * Get the more item.
+ *
+ * @param obj The toolbar object.
+ * @return The toolbar more item.
+ *
+ * The more item can be changed with function
+ * elm_object_item_text_set() and elm_object_item_content_set.
+ *
+ * @ingroup Toolbar
+ */
+EAPI Elm_Object_Item             *elm_toolbar_more_item_get(const Evas_Object *obj);
+
+/**
  * Set the icon associated with @p item.
  *
  * @param it The toolbar item.
@@ -830,7 +844,6 @@ EAPI Elm_Toolbar_Item_State      *elm_toolbar_item_state_next(Elm_Object_Item *i
  */
 EAPI Elm_Toolbar_Item_State      *elm_toolbar_item_state_prev(Elm_Object_Item *it);
 
-
 /**
  * Change a toolbar's orientation
  * @param obj The toolbar object
@@ -858,18 +871,43 @@ EAPI Eina_Bool                    elm_toolbar_horizontal_get(const Evas_Object *
 EAPI unsigned int                 elm_toolbar_items_count(const Evas_Object *obj);
 
 /**
+ * Set the standard priority of visible items in a toolbar
+ * @param obj The toolbar object
+ * @param priority The standard_priority of visible items
+ *
+ * When it is the ELM_TOOLBAR_SHRINK_EXPAND mode, the items are shown only up to standard priority.
+ * The other items are located in more panel. The more panel can be shown when the more item is clicked.
+ *
+ * @see elm_toolbar_standard_priority_get()
+ *
+ * @ingroup Toolbar
+ */
+EAPI void                         elm_toolbar_standard_priority_set(Evas_Object *obj, int priority);
+
+/**
+ * Get the standard_priority of visible items in a toolbar
+ * @param obj The toolbar object
+ * @return The standard priority of items in @p obj toolbar
+ *
+ * @see elm_toolbar_standard_priority_set()
+ *
+ * @ingroup Toolbar
+ */
+EAPI int                          elm_toolbar_standard_priority_get(const Evas_Object *obj);
+
+/**
  * Set the toolbar select mode.
  *
  * @param obj The toolbar object
  * @param mode The select mode
  *
  * elm_toolbar_select_mode_set() changes item select mode in the toolbar widget.
- * - ELM_OBJECT_NORMAL_SELECT : Items will only call their selection func and
+ * - ELM_OBJECT_SELECT_MODE_DEFAULT : Items will only call their selection func and
  *      callback when first becoming selected. Any further clicks will
  *      do nothing, unless you set always select mode.
- * - ELM_OBJECT_ALWAYS_SELECT :  This means that, even if selected,
+ * - ELM_OBJECT_SELECT_MODE_ALWAYS :  This means that, even if selected,
  *      every click will make the selected callbacks be called.
- * - ELM_OBJECT_NO_SELECT : This will turn off the ability to select items
+ * - ELM_OBJECT_SELECT_MODE_NONE : This will turn off the ability to select items
  *      entirely and they will neither appear selected nor call selected
  *      callback functions.
  *
@@ -878,7 +916,7 @@ EAPI unsigned int                 elm_toolbar_items_count(const Evas_Object *obj
  * @ingroup Toolbar
  */
 EAPI void
-elm_toolbar_select_mode_set(Evas_Object *obj, Elm_Object_Select_Mode_Type mode);
+elm_toolbar_select_mode_set(Evas_Object *obj, Elm_Object_Select_Mode mode);
 
 /**
  * Get the toolbar select mode.
@@ -891,7 +929,7 @@ elm_toolbar_select_mode_set(Evas_Object *obj, Elm_Object_Select_Mode_Type mode);
  *
  * @ingroup Toolbar
  */
-EAPI Elm_Object_Select_Mode_Type
+EAPI Elm_Object_Select_Mode
 elm_toolbar_select_mode_get(const Evas_Object *obj);
 
 /**