Version 8.3.2	SEARCH   CONTENTS   |   PDF BOOKS   |   HOME   UP   PREV   NEXT

In the previous sections, you saw the basics that make a flexible grid:

• ROWTABLEAREA2, REPEAT, STR as controls for defining a grid structure.

• GRIDCOLHEADER for defining header columns and getting move, resize events.

• FLEXLINE for defining a column's layout (both for header and for items).

• SELECTOR for selecting rows.

Even though each control has its dedicated task and is itself fairly uncomplex, the combination of all controls is not easy for developers to cope with in order to build flexible grids.

The FLEXGRID control is a pre-packaged arrangement of all these controls, combined with a server-side processing that is available using the corresponding FLEXGRIDInfo class. With a FLEXGRID control, you can easily (and dynamically) set up the layout of a grid - and all the advantages such as reacting on moving columns are automatically available.

Have a look at the following grid:

It looks like a normal grid - the corresponding layout definition shows the difference:

<rowarea name="Demo">
    <flexgrid infoprop="grid" selectprop="selected" rowcount="10" singleselect="false">
    </flexgrid>
</rowarea>

The definition of the grid is very compact - only pointing to a certain property on the server side (gridinfoprop), defining a selection property (selectprop) and a row count.

The server-side code is also quite simple:

package com.softwareag.cis.test40;

import java.util.*;
import com.softwareag.cis.server.*;
import com.softwareag.cis.server.util.*;
import com.softwareag.cis.util.*;

public class FlexGrid2Adapter
    extends Adapter
{
    public class MyLine extends SelectableLine
    {
        String m_firstName;
        String m_lastName;
        boolean m_released;
        public String getFirstName() { return m_firstName; }
        public void setFirstName(String firstName) { m_firstName = firstName; }
        public String getLastName() { return m_lastName; }
        public void setLastName(String lastName) { m_lastName = lastName; }
        public boolean getReleased() { return m_released; }
        public void setReleased(boolean released) { m_released = released; }
    }

    FLEXGRIDInfo m_grid = new FLEXGRIDInfo(this);
    public FLEXGRIDInfo getGrid() { return m_grid; }
    public void setGrid(FLEXGRIDInfo value) { m_grid = value; }

    public void init()
    {
        m_grid.clearColumnStructure();
        m_grid.addFieldColumn("firstName","50%","name;First Name","transparentbackground;true");
        m_grid.addCheckboxColumn("released","30","name;Rel","transparentbackground;true");
        m_grid.addFieldColumn("lastName","50%","name;Last Name","transparentbackground;true");
        m_grid.addButtonColumn("100","name;","name;OK");
        for (int i=0; i<8; i++)
        {
            MyLine ml = new MyLine();
            ml.setFirstName("FN " + i);
            ml.setLastName("LN " + i);
            m_grid.getLines().add(ml);
        }
    }
}

There is a property grid of type FLEXGRIDInfo that is referenced by the control. In the init() method of the adapter, the grid is prepared: diverse controls are added (the same controls as with FLEXLINE are available for dynamic adding).

Have a look at the following Java statement:

m_grid.addFieldColumn("firstName","50%","name;First Name","transparentbackground;true");

There are four parameters that are passed:

• The name of the "valueprop" for the FIELD control that is internally generated.

• The width of the control.

• The additional properties of the GRIDCOLHEADER control that is internally generated as header column.

• The additional properties of the FIELD control that is generated as content.

At any point of time, you can change the column layout inside your adapter by calling the method clearColumnStructure() and then recalling the addField/addCheckbox etc. methods.

This document covers the following topics:

• FLEXGRID Properties

• Overriding FLEXGRIDInfo

FLEXGRID Properties

Overriding FLEXGRIDInfo

You can override the FLEXGRIDInfo class at any time and build up your own, extended class. See the Java API documentation for more details.

www.softwareag.com

Copyright © 2005-2013 Software AG, Darmstadt, Germany.

SEARCH   CONTENTS   |   PDF BOOKS   |   HOME   UP   PREV   NEXT