Package ucar.unidata.ui

Class GraphPaperLayout

java.lang.Object
ucar.unidata.ui.GraphPaperLayout
All Implemented Interfaces:
LayoutManager, LayoutManager2
public class GraphPaperLayout extends Object implements LayoutManager2
The GraphPaperLayout class is a layout manager that lays out a container's components in a rectangular grid, similar to GridLayout. Unlike GridLayout, however, components can take up multiple rows and/or columns. The layout manager acts as a sheet of graph paper. When a component is added to the layout manager, the location and relative size of the component are simply supplied by the constraints as a Rectangle. 

 import java.awt.*;
 import java.applet.Applet;
 public class ButtonGrid extends Applet {
     public void init() {
         setLayout(new GraphPaperLayout(new Dimension(5,5)));
         // Add a 1x1 Rect at (0,0)
         add(new Button("1"), new Rectangle(0,0,1,1));
         // Add a 2x1 Rect at (2,0)
         add(new Button("2"), new Rectangle(2,0,2,1));
         // Add a 1x2 Rect at (1,1)
         add(new Button("3"), new Rectangle(1,1,1,2));
         // Add a 2x2 Rect at (3,2)
         add(new Button("4"), new Rectangle(3,2,2,2));
         // Add a 1x1 Rect at (0,4)
         add(new Button("5"), new Rectangle(0,4,1,1));
         // Add a 1x2 Rect at (2,3)
         add(new Button("6"), new Rectangle(2,3,1,2));
     }
 }
Author:
Michael Martak

  • Constructor Details

    • GraphPaperLayout

      public GraphPaperLayout()
      Creates a graph paper layout with a default of a 1 x 1 graph, with no vertical or horizontal padding.

    • GraphPaperLayout

      public GraphPaperLayout(Dimension gridSize)
      Creates a graph paper layout with the given grid size, with no vertical or horizontal padding.
      Parameters:
      gridSize -

    • GraphPaperLayout

      public GraphPaperLayout(Dimension gridSize, int hgap, int vgap)
      Creates a graph paper layout with the given grid size and padding.
      Parameters:
      gridSize - size of the graph paper in logical units (n x m)
      hgap - horizontal padding
      vgap - vertical padding

  • Method Details

    • getGridSize

      public Dimension getGridSize()
      Returns:
      the size of the graph paper in logical units (n x m)

    • setGridSize

      public void setGridSize(Dimension d)
      Set the size of the graph paper in logical units (n x m)
      Parameters:
      d -

    • setGridSize

      public void setGridSize(int width, int height)
      Set the size of the graph paper in logical units (n x m)
      Parameters:
      width -
      height -

    • setConstraints

      public void setConstraints(Component comp, Rectangle constraints)
      _more_
      Parameters:
      comp -
      constraints -

    • addLayoutComponent

      public void addLayoutComponent(String name, Component comp)
      Adds the specified component with the specified name to the layout. This does nothing in GraphPaperLayout, since constraints are required.
      Specified by:
      addLayoutComponent in interface LayoutManager
      Parameters:
      name -
      comp -

    • removeLayoutComponent

      public void removeLayoutComponent(Component comp)
      Removes the specified component from the layout.
      Specified by:
      removeLayoutComponent in interface LayoutManager
      Parameters:
      comp - the component to be removed

    • preferredLayoutSize

      public Dimension preferredLayoutSize(Container parent)
      Calculates the preferred size dimensions for the specified panel given the components in the specified parent container.
      Specified by:
      preferredLayoutSize in interface LayoutManager
      Parameters:
      parent - the component to be laid out
      Returns:
      _more_
      See Also:

    • minimumLayoutSize

      public Dimension minimumLayoutSize(Container parent)
      Calculates the minimum size dimensions for the specified panel given the components in the specified parent container.
      Specified by:
      minimumLayoutSize in interface LayoutManager
      Parameters:
      parent - the component to be laid out
      Returns:
      _more_
      See Also:

    • getLayoutSize

      protected Dimension getLayoutSize(Container parent, boolean isPreferred)
      Algorithm for calculating layout size (minimum or preferred).

      The width of a graph paper layout is the largest cell width (calculated in getLargestCellSize() times the number of columns, plus the horizontal padding times the number of columns plus one, plus the left and right insets of the target container.

      The height of a graph paper layout is the largest cell height (calculated in getLargestCellSize() times the number of rows, plus the vertical padding times the number of rows plus one, plus the top and bottom insets of the target container.

      Parameters:
      parent - the container in which to do the layout.
      isPreferred - true for calculating preferred size, false for calculating minimum size.
      Returns:
      the dimensions to lay out the subcomponents of the specified container.
      See Also:

    • getLargestCellSize

      protected Dimension getLargestCellSize(Container parent, boolean isPreferred)
      Algorithm for calculating the largest minimum or preferred cell size.

      Largest cell size is calculated by getting the applicable size of each component and keeping the maximum value, dividing the component's width by the number of columns it is specified to occupy and dividing the component's height by the number of rows it is specified to occupy.

      Parameters:
      parent - the container in which to do the layout.
      isPreferred - true for calculating preferred size, false for calculating minimum size.
      Returns:
      the largest cell size required.

    • layoutContainer

      public void layoutContainer(Container parent)
      Lays out the container in the specified container.
      Specified by:
      layoutContainer in interface LayoutManager
      Parameters:
      parent - the component which needs to be laid out

    • addLayoutComponent

      public void addLayoutComponent(Component comp, Object constraints)
      Adds the specified component to the layout, using the specified constraint object.
      Specified by:
      addLayoutComponent in interface LayoutManager2
      Parameters:
      comp - the component to be added
      constraints - where/how the component is added to the layout.

    • maximumLayoutSize

      public Dimension maximumLayoutSize(Container target)
      Returns the maximum size of this component.
      Specified by:
      maximumLayoutSize in interface LayoutManager2
      Parameters:
      target -
      Returns:
      _more_
      See Also:

    • getLayoutAlignmentX

      public float getLayoutAlignmentX(Container target)
      Returns the alignment along the x axis. This specifies how the component would like to be aligned relative to other components. The value should be a number between 0 and 1 where 0 represents alignment along the origin, 1 is aligned the furthest away from the origin, 0.5 is centered, etc.
      Specified by:
      getLayoutAlignmentX in interface LayoutManager2
      Parameters:
      target -
      Returns:
      _more_

    • getLayoutAlignmentY

      public float getLayoutAlignmentY(Container target)
      Returns the alignment along the y axis. This specifies how the component would like to be aligned relative to other components. The value should be a number between 0 and 1 where 0 represents alignment along the origin, 1 is aligned the furthest away from the origin, 0.5 is centered, etc.
      Specified by:
      getLayoutAlignmentY in interface LayoutManager2
      Parameters:
      target -
      Returns:
      _more_

    • invalidateLayout

      public void invalidateLayout(Container target)
      Invalidates the layout, indicating that if the layout manager has cached information it should be discarded.
      Specified by:
      invalidateLayout in interface LayoutManager2
      Parameters:
      target -

    • getDimensions

      public static Dimension getDimensions(List locations)
      _more_
      Parameters:
      locations - _more_
      Returns:
      _more_

    • layout

      public static JComponent layout(List locations)
      _more_
      Parameters:
      locations - _more_
      Returns:
      _more_

    • showDialog

      public static void showDialog(List locations, String title)
      _more_
      Parameters:
      locations - _more_
      title - _more_

    • main

      public static void main(String[] args)
      _more_
      Parameters:
      args - _more_