GridLayout Properties

Properties in View Designer

cellPadding
Interval of the UI element to the grid cell edge for all cells of the GridLayout.
cellSpacing
Interval between the individual grid cells for all cells of the GridLayout.
colCount
Number of grid columns
layoutFixed

Specifies whether the sizes of the GridLayout cells are fixed or whether they can be expanded by their content.

If the property is not set (ABAP_FALSE), the GridLayout cells are always big enough that their whole content is visible. If the selected size of the GridLayout cell (width and height of the GridData) is smaller than the size of the content, the content expands the cell size.

If the property is set (ABAP_TRUE), the width of a GridLayout cell (property width of the GridData) is retained when it is rendered even if a smaller size than the width of the content was selected. As in FormLayout, content that is bigger than the surrounding GridLayout cell is truncated. Provided the browser allows, an ellipsis (...) is displayed (for example, Label, TextView, Caption).

For more information, see Truncation of Contents in FormLayouts.

In some browsers and rendering modes the height (property height of GridData) is retained and the content is truncated. But since this is not always the case, you should not use property layoutFixed for the height.

Note

The column widths of the GridLayout are defined when the first row is rendered. If not all the columns are used in the first row (colSpan > 1), errors may occur in the next rows.

Example

You can find an example in Web Dynpro ABAP application WDR_TEST_LAYOUTS under "GridLayout fixed“.

The panel "fixed GridLayout: simple“ shows an example in which the column widths are the same for all rows. All columns are used in the first row, and therefore the column widths are defined.

For the other two panels, the distribution of column widths for the second row is to be different to the first row.

The panel "fixed GridLayout: without header row“ contains an example where not all the columns were used in the first row (the image has colSpan=2). This means that a problem occurs in the second column. For property width of the three GridLayout cells values 50%, 35%, and 15% were set, but a width of 50% and twice 25% is displayed.

To avoid the unexpected display, the panel "fixed GridLayout: with header row“ has a first row with no height and content (3 InvisibleElements with width = 50%, 35%, and 15%).
legendId
ID of the assigned Legend.
stretchedHorizontally
Specifies whether or not the UI elements match the container size of the horizontal alignment.
stretchedVertically
Specifies whether or not the UI elements match the container size of the vertical alignment.

The following diagram illustrates how the GridLayout properties work: