import java.awt.*;

/**
  * Sets up a panel that is a 2-column grid with field labels in the first
  * column and AWT components in the second column.
  * @author		Paul Hyde
  */
public class LabelCompPanel extends Panel {

	GridBagLayout gbl = new GridBagLayout();

	GridBagConstraints labelGBC = new GridBagConstraints();
	GridBagConstraints compGBC = new GridBagConstraints();
	
	/**
	  * Create a panel with defaults that labels are right/top justified 
	  * and components are left/top justtified in a GridBagLayout.
	  */
	public LabelCompPanel () {
		// these panels use the Grid Bag layout
		setLayout(gbl);

		// labels are top and right justified in cell
		labelGBC.anchor = GridBagConstraints.NORTHEAST;
		labelGBC.insets = new Insets(2, 2, 2, 2);

		// components are top and left justified in cell, last element in row
		compGBC.anchor = GridBagConstraints.NORTHWEST;
		compGBC.gridwidth = GridBagConstraints.REMAINDER;
		compGBC.insets = new Insets(2, 2, 2, 2);
	}

	/**
	  * Adds a label and a generic component to this panel
	  */
	public LabelCompPair addLabelComp(Label l, Component c) {
		// tell the layout how each of these should be placed
		gbl.setConstraints(l, labelGBC);
		gbl.setConstraints(c, compGBC);

		// add components to panel in proper order
		add(l);
		add(c);

		// allow caller to access newly created components
		return new LabelCompPair(l, c);
	}

	/**
	  * Adds a label and textfield pair to this panel
	  */
	public LabelCompPair addTextField(String labelText, int fieldLen) {
		Label l = new Label(labelText);
		TextField tf = new TextField(fieldLen);
		return addLabelComp(l, tf);
	}
}