comparison java/src/uk/ac/qmul/eecs/ccmi/utils/GridBagUtilities.java @ 3:9e67171477bc

PHANTOM Omni Heptic device release

 	public GridBagUtilities(){
 		 labelPad = DEFAULT_LABEL_PAD;
 		 row = 0;
 	}
 	
+	/**
+	 * Provides the {@code GridBagConstrains} for a label. The label is placed
+	 * on the left
+	 * @param pad the pad between the label and the left margin of the component containing
+	 * it 
+	 * @return a {@code GridBagConstrains} object to pass to the {@code add} method of {@code JComponent}
+	 */
 	public GridBagConstraints label(int pad){
 		GridBagConstraints c ;
 		
 		c = new GridBagConstraints();
 		c.anchor = GridBagConstraints.WEST;

 		c.insets = new java.awt.Insets(PAD,PAD,PAD,pad);
 		
 		return c;
 	}
 	
+	/**
+	 * Equivalent to {@link #label(int)} passing as argument the value previously 
+	 * set by {@link #setLabelPad(int)} or {@link #DEFAULT_LABEL_PAD} otherwise.
+	 * @return
+	 */
 	public GridBagConstraints label(){
 		return label(labelPad);
 	}
 	
+	/**
+	 * Sets the value used by {@link #label()} as the pad between the label 
+	 * and the left margin of the component containing it 
+	 * @param labelPad the label pad 
+	 */
 	public void setLabelPad(int labelPad){
 		this.labelPad = labelPad;
 	}
 	
 	public GridBagConstraints field(){