some documentation

svn changeset:3124/svn branch:trunk

diff --git a/src/com/itmill/toolkit/demo/featurebrowser/ValueInputExample.java b/src/com/itmill/toolkit/demo/featurebrowser/ValueInputExample.java
index 3cdcafc719ccaf36ed817c5a98a8147c192b72ed..e0c21dd77847b5cec6bdb0c957847e43e1a970cf 100644 (file)
--- a/src/com/itmill/toolkit/demo/featurebrowser/ValueInputExample.java
+++ b/src/com/itmill/toolkit/demo/featurebrowser/ValueInputExample.java
@@ -12,19 +12,20 @@ import com.itmill.toolkit.ui.Slider;
 import com.itmill.toolkit.ui.TextField;\r
 \r
 /**\r
- * Shows a few variations of Buttons and Links.\r
+ * Shows some basic fields for value input; TextField, DateField, Slider...\r
  * \r
  * @author IT Mill Ltd.\r
  */\r
 public class ValueInputExample extends CustomComponent {\r
 \r
+    // used to show the last entered value in the textfields\r
     Label textfieldValue;\r
 \r
     public ValueInputExample() {\r
-\r
         OrderedLayout main = new OrderedLayout();\r
         main.setMargin(true);\r
         setCompositionRoot(main);\r
+\r
         // TextField\r
         OrderedLayout horiz = new OrderedLayout(\r
                 OrderedLayout.ORIENTATION_HORIZONTAL);\r
@@ -35,23 +36,23 @@ public class ValueInputExample extends CustomComponent {
         Panel right = new Panel("Last input");\r
         right.setStyleName(Panel.STYLE_LIGHT);\r
         horiz.addComponent(right);\r
-\r
+        // "last entered" -label\r
         textfieldValue = new Label();\r
         textfieldValue.setContentMode(Label.CONTENT_PREFORMATTED);\r
         right.addComponent(textfieldValue);\r
-\r
+        // listener that will update the last entered value for the TextFields\r
         Field.ValueChangeListener listener = new Field.ValueChangeListener() {\r
             public void valueChange(ValueChangeEvent event) {\r
                 textfieldValue.setValue(event.getProperty().getValue());\r
             }\r
         };\r
-\r
+        // basic TextField\r
         TextField tf = new TextField("Basic");\r
         tf.setColumns(15);\r
         tf.setImmediate(true);\r
         tf.addListener(listener);\r
         left.addComponent(tf);\r
-\r
+        // multiline TextField a.k.a TextArea\r
         tf = new TextField("Area");\r
         tf.setColumns(15);\r
         tf.setRows(5);\r
@@ -59,7 +60,7 @@ public class ValueInputExample extends CustomComponent {
         tf.addListener(listener);\r
         left.addComponent(tf);\r
 \r
-        // DateField\r
+        // DateFields\r
         horiz = new OrderedLayout(OrderedLayout.ORIENTATION_HORIZONTAL);\r
         main.addComponent(horiz);\r
         left = new Panel("DateField");\r
@@ -91,12 +92,13 @@ public class ValueInputExample extends CustomComponent {
         left = new Panel("Slider");\r
         left.setStyleName(Panel.STYLE_LIGHT);\r
         main.addComponent(left);\r
-\r
+        // int slider\r
         Slider slider = new Slider(0, 100);\r
         slider.setSize(300);\r
         slider.setImmediate(true);\r
         slider.addListener(new Slider.ValueChangeListener() {\r
             public void valueChange(ValueChangeEvent event) {\r
+                // update caption when value changes\r
                 Slider s = (Slider) event.getProperty();\r
                 s.setCaption("Value: " + s.getValue());\r
             }\r
@@ -107,11 +109,12 @@ public class ValueInputExample extends CustomComponent {
             e.printStackTrace(System.err);\r
         }\r
         left.addComponent(slider);\r
-\r
+        // double slider\r
         slider = new Slider(0.0, 1.0, 1);\r
         slider.setImmediate(true);\r
         slider.addListener(new Slider.ValueChangeListener() {\r
             public void valueChange(ValueChangeEvent event) {\r
+                // update caption when value changes\r
                 Slider s = (Slider) event.getProperty();\r
                 s.setCaption("Value: " + s.getValue());\r
             }\r