[multibuttonentry]Fixed [Nabi S1-539]narrow region about internal entry
[framework/uifw/elementary.git] / src / lib / elm_button.h
index 3a1cec2..5893898 100644 (file)
@@ -1,5 +1,6 @@
 /**
  * @defgroup Button Button
+ * @ingroup Elementary
  *
  * @image html img/widget/button/preview-00.png
  * @image latex img/widget/button/preview-00.eps
  * This is a push-button. Press it and run some function. It can contain
  * a simple label and icon object and it also has an autorepeat feature.
  *
- * This widgets emits the following signals:
+ * This widget emits the following signals:
  * @li "clicked": the user clicked the button (press/release).
  * @li "repeated": the user pressed the button without releasing it.
  * @li "pressed": button was pressed.
  * @li "unpressed": button was released after being pressed.
- * In all three cases, the @c event parameter of the callback will be
+ * In all cases, the @c event parameter of the callback will be
  * @c NULL.
  *
  * Also, defined in the default theme, the button has the following styles
  * @li hoversel_vertical: Internally used by @ref Hoversel to give a
  * continuous look across its options.
  * @li hoversel_vertical_entry: Another internal for @ref Hoversel.
+ * @li naviframe: Internally used by @ref Naviframe for its back button.
+ * @li colorselector: Internally used by @ref Colorselector
+ * for its left and right buttons.
  *
- * Default contents parts of the button widget that you can use for are:
+ * Default content parts of the button widget that you can use for are:
  * @li "icon" - An icon of the button
  *
  * Default text parts of the button widget that you can use for are:
  * @li "default" - Label of the button
  *
- * Follow through a complete example @ref button_example_01 "here".
+ * Supported elm_object common APIs.
+ * @li @ref elm_object_part_text_set
+ * @li @ref elm_object_part_text_get
+ * @li @ref elm_object_part_content_set
+ * @li @ref elm_object_part_content_get
+ * @li @ref elm_object_part_content_unset
+ * @li @ref elm_object_signal_emit
+ * @li @ref elm_object_signal_callback_add
+ * @li @ref elm_object_signal_callback_del
+ *
+ * Here is some sample code using it:
+ * @li @ref button_example_00
+ * @li @ref button_example_01
+ */
+
+/**
+ * @addtogroup Button
  * @{
  */
 
@@ -43,6 +63,8 @@
  *
  * @param parent The parent object
  * @return The new object or NULL if it cannot be created
+ *
+ * @ingroup Button
  */
 EAPI Evas_Object                 *elm_button_add(Evas_Object *parent);
 
@@ -60,6 +82,8 @@ EAPI Evas_Object                 *elm_button_add(Evas_Object *parent);
  *
  * @param obj The button object
  * @param on  A bool to turn on/off the event
+ *
+ * @ingroup Button
  */
 EAPI void                         elm_button_autorepeat_set(Evas_Object *obj, Eina_Bool on);
 
@@ -70,6 +94,8 @@ EAPI void                         elm_button_autorepeat_set(Evas_Object *obj, Ei
  * @return EINA_TRUE if autorepeat is on, EINA_FALSE otherwise
  *
  * @see elm_button_autorepeat_set()
+ *
+ * @ingroup Button
  */
 EAPI Eina_Bool                    elm_button_autorepeat_get(const Evas_Object *obj);
 
@@ -78,7 +104,7 @@ EAPI Eina_Bool                    elm_button_autorepeat_get(const Evas_Object *o
  *
  * Sets the timeout, in seconds, since the button is pressed until the
  * first @c repeated signal is emitted. If @p t is 0.0 or less, there
- * won't be any delay and the even will be fired the moment the button is
+ * won't be any delay and the event will be fired the moment the button is
  * pressed.
  *
  * @param obj The button object
@@ -86,6 +112,8 @@ EAPI Eina_Bool                    elm_button_autorepeat_get(const Evas_Object *o
  *
  * @see elm_button_autorepeat_set()
  * @see elm_button_autorepeat_gap_timeout_set()
+ *
+ * @ingroup Button
  */
 EAPI void                         elm_button_autorepeat_initial_timeout_set(Evas_Object *obj, double t);
 
@@ -96,6 +124,8 @@ EAPI void                         elm_button_autorepeat_initial_timeout_set(Evas
  * @return Timeout in seconds
  *
  * @see elm_button_autorepeat_initial_timeout_set()
+ *
+ * @ingroup Button
  */
 EAPI double                       elm_button_autorepeat_initial_timeout_get(const Evas_Object *obj);
 
@@ -109,6 +139,8 @@ EAPI double                       elm_button_autorepeat_initial_timeout_get(cons
  * @param t   Interval in seconds
  *
  * @see elm_button_autorepeat_initial_timeout_set()
+ *
+ * @ingroup Button
  */
 EAPI void                         elm_button_autorepeat_gap_timeout_set(Evas_Object *obj, double t);
 
@@ -117,6 +149,8 @@ EAPI void                         elm_button_autorepeat_gap_timeout_set(Evas_Obj
  *
  * @param obj The button object
  * @return Interval in seconds
+ *
+ * @ingroup Button
  */
 EAPI double                       elm_button_autorepeat_gap_timeout_get(const Evas_Object *obj);