Enlightenment CVS committal
Author : moom
Project : e17
Module : libs/etk
Dir : e17/libs/etk/src/lib
Modified Files:
etk_scrollbar.c etk_slider.c
Log Message:
* [Doc] Document the slider's API
===================================================================
RCS file: /cvs/e/e17/libs/etk/src/lib/etk_scrollbar.c,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -3 -r1.17 -r1.18
--- etk_scrollbar.c 28 Nov 2006 21:40:07 -0000 1.17
+++ etk_scrollbar.c 20 Feb 2007 21:55:25 -0000 1.18
@@ -92,9 +92,9 @@
* @param lower the lower bound of the scrollbar
* @param upper the upper bound of the scrollbar
* @param value the initial value of the scrollbar
- * @param step_increment the step increment value. This value is added or
substracted to the current value of the
+ * @param step_increment the step-increment value. This value is added or
substracted to the current value of the
* scrollbar when an arrow button of the scrollbar is clicked, or when the
mouse wheel is used
- * @param page_increment the page increment value. This value is added or
substracted to the current value of the
+ * @param page_increment the page-increment value. This value is added or
substracted to the current value of the
* scrollbar when the page up/down keys are pressed or when the user clicks on
the trough of the scrollbar
* @param page_size the page size value: this value will determine the size of
the drag button of the scrollbar
* @return Returns the new horizontal scrollbar widget
@@ -110,9 +110,9 @@
* @param lower the lower bound of the scrollbar
* @param upper the upper bound of the scrollbar
* @param value the initial value of the scrollbar
- * @param step_increment the step increment value. This value is added or
substracted to the current value of the
+ * @param step_increment the-step increment value. This value is added or
substracted to the current value of the
* scrollbar when an arrow button of the scrollbar is clicked, or when the
mouse wheel is used
- * @param page_increment the page increment value. This value is added or
substracted to the current value of the
+ * @param page_increment the page-increment value. This value is added or
substracted to the current value of the
* scrollbar when the page up/down keys are pressed or when the user clicks on
the trough of the scrollbar
* @param page_size the page size value: this value will determine the size of
the drag button of the scrollbar
* @return Returns the new vertical scrollbar widget
===================================================================
RCS file: /cvs/e/e17/libs/etk/src/lib/etk_slider.c,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -3 -r1.14 -r1.15
--- etk_slider.c 20 Feb 2007 20:50:19 -0000 1.14
+++ etk_slider.c 20 Feb 2007 21:55:25 -0000 1.15
@@ -93,6 +93,13 @@
/**
* @brief Creates a new horizontal slider
+ * @param lower the lower bound of the slider
+ * @param upper the upper bound of the slider
+ * @param value the initial value of the slider
+ * @param step_increment the step-increment value. This value is added or
substracted to the current value of the
+ * slider when an arrow key is pressed, or when the mouse wheel is used
+ * @param page_increment the page-increment value. This value is added or
substracted to the current value of the
+ * slider when the page up/down keys are pressed
* @return Returns the new horizontal slider widget
*/
Etk_Widget *etk_hslider_new(double lower, double upper, double value, double
step_increment, double page_increment)
@@ -104,6 +111,13 @@
/**
* @brief Creates a new vertical slider
+ * @param lower the lower bound of the slider
+ * @param upper the upper bound of the slider
+ * @param value the initial value of the slider
+ * @param step_increment the step-increment value. This value is added or
substracted to the current value of the
+ * slider when an arrow key is pressed, or when the mouse wheel is used
+ * @param page_increment the page-increment value. This value is added or
substracted to the current value of the
+ * slider when the page up/down keys are pressed
* @return Returns the new vertical slider widget
*/
Etk_Widget *etk_vslider_new(double lower, double upper, double value, double
step_increment, double page_increment)
@@ -367,3 +381,39 @@
}
/** @} */
+
+/**************************
+ *
+ * Documentation
+ *
+ **************************/
+
+/**
+ * @addtogroup Etk_Slider
+ *
+ * @image html widgets/slider.png
+ * Etk_Slider is the base class for Etk_HSlider (for horizontal sliders) and
Etk_VSlider (for vertical sliders). @n
+ * Since Etk_Slider inherits from Etk_Range, you can use all the @a
etk_range_*() functions to get or set the value of
+ * a slider, or to change its bounds. You can also use the @a "value_changed"
signal to be notified when the value
+ * of a slider is changed. @n
+ * Sliders can also have their own label. For example, if you want to use a
slider to control a value in centimeters,
+ * you can add the associated label with:
+ * @code
+ * //Display the value of the slider with the format "2.17 cm"
+ * etk_slider_label_set(slider, "%.2f cm");
+ * @endcode @n
+ *
+ * \par Object Hierarchy:
+ * - Etk_Object
+ * - Etk_Widget
+ * - Etk_Range
+ * - Etk_Slider
+ * - Etk_HSlider
+ * - Etk_VSlider
+ *
+ * \par Properties:
+ * @prop_name "label_format": The format of the slider's label, or NULL if the
label is hidden
+ * @prop_type String (char *)
+ * @prop_rw
+ * @prop_val NULL
+ */
-------------------------------------------------------------------------
Take Surveys. Earn Cash. Influence the Future of IT
Join SourceForge.net's Techsay panel and you'll get the chance to share your
opinions on IT & business topics through brief surveys-and earn cash
http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
_______________________________________________
enlightenment-cvs mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/enlightenment-cvs