• Print  |
  • Feedback  |

TEMPLATE Procedure: Layout Statements (Experimental)

LAYOUT GRIDDED Statement

Assembles the results of nested ODS graphics statements into a grid. The results of the ODS graphics statements are placed into the grid based on the value specified by the ORDER= option.
LAYOUT GRIDDED </ option(s)> ;
statgraph-statements;
ENDLAYOUT;

Usage Information

Tip:

You can use the LAYOUT GRIDDED statement to:

  • position a text entry (title, footnote, legend) outside of the graph area.

  • provide numerous areas for presenting graphs and annotations.

  • span and center a single entry such as a title, over a set of grids

  • display multiple graphs when there is no need to scale the data ranges on the axes or to align the parts of the graphs across cells.

Main discussion:

Gridded Layouts

Options

LAYOUT GRIDDED Options
Option Description
BACKGROUND= color | style-reference Specifies the background color of the graph.
BACKTRANSPARENCY= number Specifies the degree of the transparency of the background color.
BORDER=boolean
 Displays the border around the layout.
BORDERCOLOR= color | style-reference Specifies the border color of the layout.
BORDERPATTERN=line | style-reference Specifies the border pattern of the layout.
BORDERTHICKNESS=dimension Specifies the border thickness of the layout.
COLUMN= (integer-list) Specifies a column order for filling cells.
COLUMNGRID= (dimension-list) Specifies the thickness of the grid lines that are before the first column, between the columns, and after the last column.
COLUMNGUTTER= (dimension-list) Specifies the amount of empty space that is before the first column, between the columns, and after the last column.
COLUMNS= integer Specifies the number of columns in the layout.
COLUMNSPAN= (integer-list) Specifies the number of columns a cell should span.
HEIGHT= dimension Specifies the height of the layout area.
ORDER= ROWMAJOR | COLUMNMAJOR Specifies whether cells are filled by column or by row.
PADBOTTOM= dimension Specifies the amount of empty space that is at the bottom of the layout.
PADLEFT= dimension Specifies the amount of empty space that is on the left side of the layout.
PADRIGHT= dimension Specifies the amount of empty space that is on the right side of the layout.
PADTOP= boolean Specifies the amount of empty space that is at the top of the layout.
ROW= (integer-list) Specifies a row order for filling cells.
ROWGRID= (dimension-list) Specifies the thickness of the grid lines that are before the first row, between the rows, and after the last row.
ROWGUTTER= (dimension-list) Specifies the amount of empty space that is before the first row, between the rows, and after the last row.
ROWS= integer Specifies the number of rows in the layout.
ROWSPAN= (integer-list) Specifies the number of rows a cell should span.
WIDTH= dimension Specifies the width of the layout area.

BACKGROUND= color | style-reference

specifies the background color of the graph.

Default: Specified by the GraphBackground:Background style reference.
BACKTRANSPARENCY= number

specifies the degree of the transparency of the background color.

Default: 0
Range: 0 (opaque) to 1 (entirely transparent)
Interaction: The BACKTRANSPARENCY= option overrides the TRANSPARENCY= option for the background.
See also: TRANSPARENCY= option
BORDER= boolean

displays the border around the layout.

Default: TRUE for the outermost layout statement. FALSE for nested layout statements.
Interaction: Values specified by the padding options are applied in addition to the border.
BORDERCOLOR= color | style-reference

specifies the border color of the layout.

Default: Specified by the GraphBorderLines:Foreground style reference.
BORDERPATTERN= line | style-reference

specifies the line pattern of the layout border.

Default: Specified by the GraphBorderLines:LineStyle style reference.
BORDERTHICKNESS= dimension

specifies the border thickness of the layout.

Default: 1 px
COLUMN= (integer-list)

specifies the column order for filling cells.

Default: specified by the ORDER= option
Requirement: integer-list must be enclosed in parentheses.
Requirement: All values in the integer list must be greater than 0.
Interaction: If the COLUMN= option is used, then the ORDER= option is ignored.
Tip: If the integer list contains more values than there are cells to fill, then the extra values are ignored.

If the integer list contains fewer values than there are cells to fill, then the omitted cells use the default fill order.

Main discussion: Specifying the Location of Columns and Rows

COLUMNGRID= (dimension-list)

specifies the thickness of the grid lines that are before the first column, between the columns, and after the last column.

Default: No column grid is displayed.
Requirement: dimension-list must be enclosed in parentheses.
Interaction: If a grid line is thicker than the gutter, the gutter is increased to fit the grid line.
Tip: If there are n columns, then there can be up to n+1 grid lines. If the dimension list contains more values than n+1 values, then the extra values are ignored.

If the dimension list contains fewer values than n+1 values, then the omitted values use the default grid thickness.

COLUMNGUTTER= (dimension-list)

specifies the amount of empty space that is before the first column, between the columns, and after the last column.

Default: 0
Requirement: dimension-list must be enclosed in parentheses.
Tip: If there are n columns, then there can be up to n+1 gutters. If the dimension list contains more values than n+1 values, then the extra values are ignored.

If the dimension list contains fewer values than n+1 values, then the omitted values use the default gutter spacing.

COLUMNS= integer

specifies the number of columns in the layout.

Default: If the ROWS= option is used, then as many rows are created as are needed. If neither the ROWS= option nor the COLUMNS= option are specified, then there is one column.
COLUMNSPAN= (integer-list)

specifies the number of columns a cell should span.

Default: 1
Requirement: integer-list must be enclosed in parentheses.
Interaction: If the COLUMNSPAN= option is used, then the ORDER= option is ignored.
Tip: If the integer list specifies more values than there are columns to span, then the extra values are ignored.

If the integer list specifies fewer values than there are columns to span, then the omitted cells use the default value.

Main discussion: Spanning Columns

HEIGHT= dimension

specifies the height of the layout area.

Restriction: You can only specify the HEIGHT= option on the outermost layout statement.
ORDER= ROWMAJOR | COLUMNMAJOR

specifies whether cells are filled by column or by row.

COLUMNMAJOR

fills the cells by column, from the top down.

Requirement: The ROWS= option must be specified to indicate how many rows to fill before wrapping to the next column.
ROWMAJOR

fills the cells by row, from left to right.

Default: ROWMAJOR
PADBOTTOM= dimension

specifies the amount of empty space that is at the bottom of the layout.

Default: 5px for the outermost layout statement, 0 for nested layout statements.
PADLEFT= dimension

specifies the amount of empty space on the left side of the layout.

Default: 5px for the outermost layout statement, 0 for nested layout statements.
PADRIGHT= dimension

specifies the amount of empty space that is on the right side of the layout.

Default: 5px for the outermost layout statement, 0 for nested layout statements.
PADTOP= dimension

specifies the amount of empty space that is at the top of the layout.

Default: 5px for the outermost layout statement, 0 for nested layout statements.
ROW= (integer-list)

specifies a row order for filling cells.

Default: Determined by the ORDER= option.
Requirement: integer-list must be enclosed in parentheses.
Requirement: All values in the integer-list must be greater than 0.
Interaction: If the ROW= option is used, then the ORDER= option is ignored.
Tip: If the integer list contains more values than there are cells to fill, then the extra values are ignored.

If the integer list contains fewer values than there are cells to fill, then the omitted cells use the default fill order.

Main discussion: Specifying the Location of Columns and Rows

ROWGRID= (dimension-list )

specifies the thickness of the grid lines that are before the first row, between the rows, and after the last row.

Default: No grid is displayed.
Requirement: dimension-listmust be enclosed in parentheses.
Tip: If there are n rows, then there can be up to n+1 grid lines. If the dimension list contains more values than n+1 values, then the extra values are ignored.

If the dimension list contains fewer values than n+1 values, then the omitted values use the default grid thickness.

ROWGUTTER= (dimension-list)

specifies the amount of empty space that is before the first row, between the rows, and after the last row.

Default: 0
Requirement: dimension-list must be enclosed in parentheses.
Tip: If there are n rows, then there can be up to n+1 gutters. If the dimension list contains more values than n+1 values, then the extra values are ignored.

If the dimension list contains fewer values than n+1 values, then the omitted values use the default gutter spacing.

ROWS= integer

specifies the number of rows in the layout.

Default: As many rows are created as are needed.
ROWSPAN= (integer-list)

specifies the number of rows a cell will span.

Default: 1
Requirement: integer-list must be enclosed in parentheses.
Interaction: If the COLUMNSPAN= option is used, then the ORDER= option is ignored.
Tip: If the integer list specifies more values than there are rows to span, then the extra values are ignored.

If the integer list specifies fewer values than there are rows to span, then the omitted cells use the default value.

Main discussion: Spanning Rows

WIDTH= dimension

specifies the width of the layout area.

Restriction: You can only specify the WIDTH= option on the outermost layout statement.

Previous Page | Next Page | Top of Page