RowColumnLayout (MDSplus jScope 7.138.0 API)

java.lang.Object
- mds.wave.RowColumnLayout

All Implemented Interfaces:: LayoutManager

public class RowColumnLayout
extends Object
implements LayoutManager

RowColumnLayout is a layout manager that dispose added component in a grid defined by number of column and number of components in column. Column width and component height can be modified by pointer interaction. An Example explaine how to use it:

 
 class RowColumnExample extends Panel {

    protected RowColumnLayout    row_col_layout;
    protected int rows[] = {2, 2};

    //Resize button class
    class ResizeButton extends Canvas {

                ResizeButton()
                {
                    setBackground(Color.lightGray);
                    setCursor(new Cursor(Cursor.CROSSHAIR_CURSOR));
                }

                public void paint(Graphics g)
                {
                    Rectangle d = getBounds();
                    g.draw3DRect(0, 0, d.width-1, d.height-1, true);
                    g.dispose();
                }
                public void print(Graphics g){}
                public void printAll(Graphics g){}
     }


     public RowColumnExample()
     {
        row_col_layout = new RowColumnLayout(rows);
        setLayout(row_col_layout);

                //The number of component to add to panel are 4 (2 column each colum 2 component)
                //Before add component we must add num_component - 1 canvas objet that are used
                //to interact with layout manager for interactive resize of width and height of
                //the grid
        ResizeButton b;
        for(int i = 0; i < 4 - 1; i++) {
                    add(b = new ResizeButton());
                    b.addMouseListener(new MouseAdapter()
                   {
   //Action used to resize column width or component height
                      public  void mouseReleased(MouseEvent e)
                      {
                           Component ob = e.getComponent();
                           if(ob instanceof ResizeButton)
                                    row_col_layout.ResizeRowColumn(ob, e.getPoint().x, e.getPoint().y);
                      }
                   });
                    b.addMouseMotionListener(new MouseMotionAdapter()
                   {
   //Action used to draw resiaze line on the component, only if component impement double buffering
                      public  void mouseDragged(MouseEvent e)
                      {
                          Component ob = e.getComponent();
                          row_col_layout.DrawResize(ob, e.getPoint().x, e.getPoint().y);
                      }
                   });
        }

        for(int i = 0, k = 0; i < columns; i++)
        {
                    for(int j = 0; j < rows[i]; j++)
                    {
                            add();
                            k++;
                    }
        }

        validate();
    }
  }

See Also:: RowColumnContainer

Constructor Summary

Constructors
Constructor and Description
`RowColumnLayout(int[] row)` Costruct a RowColumnLayout with a column number defined by _column argument and number of object per culomn defined by row[] vector
`RowColumnLayout(int[] row, float[] ph, float[] pw)` Costruct a RowColumnLayout with a column number defined by _column argument and number of object per column defined by row[] vector.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addLayoutComponent(String name, Component comp)` Do nothing Required by LayoutManager.
`void`	`DrawResize(Component _b, int x, int y)` Method to draw orizontal or vertical line during resize componet or column.
`int`	`GetColumns()` Return number of column
`float[]`	`getPercentHeight()`
`float`	`getPercentHeight(int i)` Return normalize height of ith componet
`float[]`	`getPercentWidth()`
`float`	`getPercentWidth(int i)` Return width of ith column
`int[]`	`GetRows()` Return integer vector of number of component in each column
`void`	`layoutContainer(Container parent)` Required by LayoutManager.
`Dimension`	`minimumLayoutSize(Container parent)` Required by LayoutManager
`Dimension`	`preferredLayoutSize(Container parent)` Required by LayoutManager
`void`	`removeLayoutComponent(Component comp)` Do nothing Required by LayoutManager.
`void`	`ResizeRowColumn(Component _b)` Calculate equal space of column and equal width of component in column
`void`	`ResizeRowColumn(Component _b, int x, int y)` Culomn width and component height resize on x or y value.
`void`	`SetPanelSize(float[] ph, float[] pw)` Set normalize size of column width and component height
`void`	`SetRowColumn(int[] row)` Set number of column an number of component for column
`void`	`SetRowColumn(int[] row, float[] ph, float[] pw)` Method used to update number of column end number of componet for column
`String`	`toString()` Returns a string representation of this RowColumnLayout and its values.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - RowColumnLayout
```
public RowColumnLayout(int[] row)
```
    Costruct a RowColumnLayout with a column number defined by _column argument and number of object per culomn defined by row[] vector
    
    Parameters:
    
    column - Number of column
    
    row - row[i] define number of component in column i
  - RowColumnLayout
```
public RowColumnLayout(int[] row,
                       float[] ph,
                       float[] pw)
```
    Costruct a RowColumnLayout with a column number defined by _column argument and number of object per column defined by row[] vector. The width size of ith column is defined by pw[i] value and height size of jth component is defuned by pw[j]. The pw[i] and ph[j] value are normalize value in rangeform 0 to 1.
    
    Parameters:
    
    row - row[i] define number of component in column i
    
    ph - Vector of normalize height of component. The sum of ph[x] of the objects in a column must be 1.
    
    pw - Vector of normalize width of the culomn. The sum of pw[x] must be 1
- Method Detail
  - addLayoutComponent
```
public void addLayoutComponent(String name,
                               Component comp)
```
    Do nothing Required by LayoutManager.
    
    Specified by:
    
    addLayoutComponent in interface LayoutManager
    
    Parameters:
    
    name - Component name
    
    comp - Component
  - DrawResize
```
public void DrawResize(Component _b,
                       int x,
                       int y)
```
    Method to draw orizontal or vertical line during resize componet or column. Line/s are drow on the component only if double buffering is supported on component. RowColumnLayout manager check double buffering component capability by isDoubleBuffered() method of component.
    
    Parameters:
    
    _b - Canvas object used to interact with mouse drag
    
    x - Canvas x position
    
    y - Canvas y position
    
    See Also:
    
    RowColumnComponet
  - GetColumns
```
public int GetColumns()
```
    Return number of column
    
    Returns:
    
    Integer number of column
  - getPercentHeight
```
public float[] getPercentHeight()
```
  - getPercentHeight
```
public float getPercentHeight(int i)
```
    Return normalize height of ith componet
    
    Parameters:
    
    i - index of component
    
    Returns:
    
    Normalize Height
  - getPercentWidth
```
public float[] getPercentWidth()
```
  - getPercentWidth
```
public float getPercentWidth(int i)
```
    Return width of ith column
    
    Parameters:
    
    i - index of column
    
    Returns:
    
    Normalize column width
  - GetRows
```
public int[] GetRows()
```
    Return integer vector of number of component in each column
    
    Returns:
    
    Integer vector where ith value is number of component in ith column
  - layoutContainer
```
public void layoutContainer(Container parent)
```
    Required by LayoutManager. This is called when the panel is first displayed, and every time its size changes. Note: You CAN'T assume preferredLayoutSize() or minimumLayoutSize() will be called -- in the case of applets, at least, they probably won't be.
    
    Specified by:
    
    layoutContainer in interface LayoutManager
    
    Parameters:
    
    parent - component container
  - minimumLayoutSize
```
public Dimension minimumLayoutSize(Container parent)
```
    Required by LayoutManager
    
    Specified by:
    
    minimumLayoutSize in interface LayoutManager
    
    Parameters:
    
    parent - component container
    
    Returns:
    
    component container dimension
  - preferredLayoutSize
```
public Dimension preferredLayoutSize(Container parent)
```
    Required by LayoutManager
    
    Specified by:
    
    preferredLayoutSize in interface LayoutManager
    
    Parameters:
    
    parent - component container
    
    Returns:
    
    component container dimension
  - removeLayoutComponent
```
public void removeLayoutComponent(Component comp)
```
    Do nothing Required by LayoutManager.
    
    Specified by:
    
    removeLayoutComponent in interface LayoutManager
    
    Parameters:
    
    comp - component
  - ResizeRowColumn
```
public void ResizeRowColumn(Component _b)
```
    Calculate equal space of column and equal width of component in column
    
    Parameters:
    
    _b - Canvas object used to interact with mouse if _b is column resize canvas equal width culomn are performed if _b is componet column resize all component in column are resized to equal height.
  - ResizeRowColumn
```
public void ResizeRowColumn(Component _b,
                            int x,
                            int y)
```
    Culomn width and component height resize on x or y value.
    
    Parameters:
    
    _b - Canvas object used to interact with mouse if _b is column resize canvas columns width are resize on x value if _b is componet column resize component height are resize on y value.
    
    x - x position
    
    y - y position
  - SetPanelSize
```
public void SetPanelSize(float[] ph,
                         float[] pw)
```
    Set normalize size of column width and component height
    
    Parameters:
    
    ph - Vector of normalize height of component. The sum of ph[x] for objet in a column must be 1.
    
    pw - Vector of normalize width of the culomn. Sum of pw[x] must be 1
  - SetRowColumn
```
public void SetRowColumn(int[] row)
```
    Set number of column an number of component for column
    
    Parameters:
    
    row - row[i] define number of component in column i
  - SetRowColumn
```
public void SetRowColumn(int[] row,
                         float[] ph,
                         float[] pw)
```
    Method used to update number of column end number of componet for column
    
    Parameters:
    
    row - row[i] define number of component in column i
    
    ph - Vector of normalize height of component. The sum of ph[x] for objet in a column must be 1.
    
    pw - Vector of normalize width of the culomn. Sum of pw[x] must be 1
  - toString
```
public String toString()
```
    Returns a string representation of this RowColumnLayout and its values.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    a string representation of this layout.

Class RowColumnLayout

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

RowColumnLayout

RowColumnLayout

Method Detail

addLayoutComponent

DrawResize

GetColumns

getPercentHeight

getPercentHeight

getPercentWidth

getPercentWidth

GetRows

layoutContainer

minimumLayoutSize

preferredLayoutSize

removeLayoutComponent

ResizeRowColumn

ResizeRowColumn

SetPanelSize

SetRowColumn

SetRowColumn

toString