A vertical layout manager similar to java.awt.FlowLayout : Layout « Swing JFC « Java






A vertical layout manager similar to java.awt.FlowLayout

       


/**
THIS PROGRAM IS PROVIDED "AS IS" WITHOUT ANY WARRANTIES (OR CONDITIONS),
EXPRESS OR IMPLIED WITH RESPECT TO THE PROGRAM, INCLUDING THE IMPLIED WARRANTIES (OR CONDITIONS)
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK ARISING OUT OF USE OR
PERFORMANCE OF THE PROGRAM AND DOCUMENTATION REMAINS WITH THE USER.
*/
import java.awt.*; import java.util.*;
/**
 *
 * A vertical layout manager similar to java.awt.FlowLayout.
 * Like FlowLayout components do not expand to fill available space except when the horizontal alignment
 * is <code>BOTH</code>
 * in which case components are stretched horizontally. Unlike FlowLayout, components will not wrap to form another
 * column if there isn't enough space vertically. VerticalLayout can optionally anchor components to the top or bottom
 * of the display area or center them between the top and bottom.
 *
 * Revision date 12th July 2001
 *
 * @author Colin Mummery  e-mail: colin_mummery@yahoo.com Homepage:www.kagi.com/equitysoft -
 * Based on 'FlexLayout' in Java class libraries Vol 2 Chan/Lee Addison-Wesley 1998
 */

public class VerticalLayout implements LayoutManager{

/**
* The horizontal alignment constant that designates centering. Also used to designate center anchoring.
*/
  public final static int CENTER=0;
/**
* The horizontal alignment constant that designates right justification.
*/
  public final static int RIGHT=1;
/**
* The horizontal alignment constant that designates left justification.
*/
  public final static int LEFT=2;
/**
* The horizontal alignment constant that designates stretching the component horizontally.
*/
  public final static int BOTH=3;

/**
* The anchoring constant that designates anchoring to the top of the display area
*/
  public final static int TOP=1;
/**
* The anchoring constant that designates anchoring to the bottom of the display area
*/
  public final static int BOTTOM=2;
  private int vgap; //the vertical vgap between components...defaults to 5
  private int alignment; //LEFT, RIGHT, CENTER or BOTH...how the components are justified
  private int anchor; //TOP, BOTTOM or CENTER ...where are the components positioned in an overlarge space
  private Hashtable comps;

//Constructors
/**
* Constructs an instance of VerticalLayout with a vertical vgap of 5 pixels, horizontal centering and anchored to
* the top of the display area.
*/
   public VerticalLayout(){
  this(5,CENTER,TOP);
   }
/**
* Constructs a VerticalLayout instance with horizontal centering, anchored to the top with the specified vgap
*
* @param vgap An int value indicating the vertical seperation of the components
*/
   public VerticalLayout(int vgap){
  this(vgap,CENTER,TOP);
   }
/**
* Constructs a VerticalLayout instance anchored to the top with the specified vgap and horizontal alignment
*
* @param vgap An int value indicating the vertical seperation of the components
* @param alignment An int value which is one of <code>RIGHT, LEFT, CENTER, BOTH</code> for the horizontal alignment.
*/
   public VerticalLayout(int vgap,int alignment){
  this(vgap,alignment,TOP);
   }
/**
* Constructs a VerticalLayout instance with the specified vgap, horizontal alignment and anchoring
*
* @param vgap An int value indicating the vertical seperation of the components
* @param alignment An int value which is one of <code>RIGHT, LEFT, CENTER, BOTH</code> for the horizontal alignment.
* @param anchor An int value which is one of <code>TOP, BOTTOM, CENTER</code> indicating where the components are
* to appear if the display area exceeds the minimum necessary.
*/
   public VerticalLayout(int vgap,int alignment,int anchor){
  this.vgap=vgap; this.alignment=alignment; this.anchor=anchor;
   }
//----------------------------------------------------------------------------
   private Dimension layoutSize(Container parent,boolean minimum){
  Dimension dim=new Dimension(0,0);
  Dimension d;
  synchronized(parent.getTreeLock()){
    int n=parent.getComponentCount();
    for(int i=0;i<n;i++){
      Component c=parent.getComponent(i);
      if(c.isVisible()){
        d=minimum ? c.getMinimumSize() : c.getPreferredSize();
        dim.width=Math.max(dim.width,d.width); dim.height+=d.height;
        if(i>0)dim.height+=vgap;
      }
    }
  }
  Insets insets=parent.getInsets();
  dim.width+=insets.left+insets.right;
  dim.height+=insets.top+insets.bottom+vgap+vgap;
  return dim;
   }
//-----------------------------------------------------------------------------
/**
 * Lays out the container.
 */
   public void layoutContainer(Container parent){
  Insets insets=parent.getInsets();
  synchronized(parent.getTreeLock()){
    int n=parent.getComponentCount();
    Dimension pd=parent.getSize(); int y=0;
//work out the total size
    for(int i=0;i<n;i++){
      Component c=parent.getComponent(i);
      Dimension d=c.getPreferredSize();
      y+=d.height+vgap;
    }
    y-=vgap; //otherwise there's a vgap too many
//Work out the anchor paint
    if(anchor==TOP)y=insets.top;
    else if(anchor==CENTER)y=(pd.height-y)/2;
    else y=pd.height-y-insets.bottom;
//do layout
    for(int i=0;i<n;i++){
      Component c=parent.getComponent(i);
      Dimension d=c.getPreferredSize();
      int x=insets.left; int wid=d.width;
      if(alignment==CENTER)x=(pd.width-d.width)/2;
      else if(alignment==RIGHT)x=pd.width-d.width-insets.right;
      else if(alignment==BOTH)wid=pd.width-insets.left-insets.right;
      c.setBounds(x,y,wid,d.height);
      y+=d.height+vgap;
    }
  }
   }
//-----------------------------------------------------------------------------
   public Dimension minimumLayoutSize(Container parent){return layoutSize(parent,false);}
//-----------------------------------------------------------------------------
   public Dimension preferredLayoutSize(Container parent){return layoutSize(parent,false);}
//----------------------------------------------------------------------------
/**
 * Not used by this class
 */
   public void addLayoutComponent(String name,Component comp){}
//-----------------------------------------------------------------------------
/**
 * Not used by this class
 */
   public void removeLayoutComponent(Component comp){}
//-----------------------------------------------------------------------------
   public String toString(){return getClass().getName()+"[vgap="+vgap+" align="+alignment+" anchor="+anchor+"]";}
}


          
    
    
    
    
    
  








Related examples in the same category

1.Laying Out Components in a Flow (Left-to-Right, Top-to-Bottom)
2.Use FlowLayout to hold checkBox, Label and TextField
3.Vertical and horizontal BoxLayoutsVertical and horizontal BoxLayouts
4.Box Layout: Adding struts.Box Layout: Adding struts.
5.Using GlueUsing Glue
6.Rigid areas are like pairs of strutsRigid areas are like pairs of struts
7.Demonstrates BorderLayoutDemonstrates BorderLayout
8.Demonstrates GridLayoutDemonstrates GridLayout
9.Demonstrates FlowLayoutDemonstrates FlowLayout
10.A test of the BoxLayout manager using the Box utility classA test of the BoxLayout manager using the Box utility class
11.A test of the box layout manager using the Box utility class 2A test of the box layout manager using the Box utility class 2
12.A test of the OverlayLayout manager allowing experimentationA test of the OverlayLayout manager allowing experimentation
13.Box layout manager using the Box utility classBox layout manager using the Box utility class
14.BoxLayout demo 1BoxLayout demo 1
15.A demonstration of the SpringLayout class
16.A test of the BoxLayout manager using the Box utility class 3A test of the BoxLayout manager using the Box utility class 3
17.BoxLayout AlignmentBoxLayout Alignment
18.BoxLayout alignment 2BoxLayout alignment 2
19.BoxLayout Component alignmentBoxLayout Component alignment
20.BoxLayout X Y alignmentBoxLayout X Y alignment
21.BoxLayout: Glue SampleBoxLayout: Glue Sample
22.Layout: Overlay SampleLayout: Overlay Sample
23.BoxLayout: setAlignmentX setAlignmentYBoxLayout: setAlignmentX setAlignmentY
24.Component AlignmentComponent Alignment
25.GridLayout Demo 3GridLayout Demo 3
26.BoxLayout SampleBoxLayout Sample
27.BoxLayout Demo 3BoxLayout Demo 3
28.Various layoutsVarious layouts
29.BoxLayout Demo 4BoxLayout Demo 4
30.GridLayout DemoGridLayout Demo
31.CardLayout DemoCardLayout Demo
32.Using CardLayout
33.Laying Out a Screen with CardLayoutLaying Out a Screen with CardLayout
34.Laying out a screen with SpringLayoutLaying out a screen with SpringLayout
35.BorderLayout PaneBorderLayout Pane
36.Add buttons to all parts of a BorderLayout
37.A BorderLayout divides the space into five regions: North, West, South, East and Centre.
38.A typical usage of a border layout manager.
39.BoxLayout PaneBoxLayout Pane
40.FlowLayout PaneFlowLayout Pane
41.GridLayout PaneGridLayout Pane
42.Laying Out Components in a Grid
43.NullLayout PaneNullLayout Pane
44.Without layout manager, we position components using absolute values.
45.Simpler CardLayout demo
46.Use SpringLayout to create a single row of componentsUse SpringLayout to create a single row of components
47. Spring Demo 1 Spring Demo 1
48.Spring Demo 2Spring Demo 2
49.Spring Demo 3Spring Demo 3
50.Spring Demo 4Spring Demo 4
51.Spring Compact GridSpring Compact Grid
52.Spring Form Spring Form
53.SpringLayout Utilities
54.Absolute Layout DemoAbsolute Layout Demo
55.A horizontal layout layout manager that allocates horizontal space in specified proportions
56.Laying Out Components Using Absolute Coordinates
57.A JTextField for displaying insets.
58.A layout manager that lays out components along a circleA layout manager that lays out components along a circle
59.A frame that uses a group layout to arrange font selection components
60.Utility methods for creating form- or grid-style layouts with SpringLayout.
61.A vertical flow layout is similar to a flow layuot but it layouts the components vertically instead of horizontally.