SAS/GRAPH(R) 9.2: Graph Template Language Reference

Options

AUTOALIGN=NONE | AUTO | (location-list)

specifies whether this layout is automatically aligned within its parent when nested within an overlay-type layout. For more information on how child positions are determined in an overlay-type layout, see the LAYOUT OVERLAY's "Example Program and Statement Details".

Default: NONE

NONE

Do not automatically align this layout within its parent layout. This layout's position within its parent layout will be set by the HALIGN= and VALIGN= options.

AUTO

Within the parent layout, attempt to center this layout in the area that is farthest from any surrounding markers.

(location-list)

Within the parent layout, restrict this layout's possible locations to those locations in the specified location-list , and use the location-list position that least collides with the parent layout's other grahpics features. The location-list is blank-separated and can contain any of these locations: TOPLEFT, TOP, TOPRIGHT, LEFT, CENTER, RIGHT, BOTTOMLEFT, BOTTOM, and BOTTOMRIGHT.

Restriction: This option is only available when this layout statement is nested within an overlay-type layout. This option is ignored if this statement is the outermost layout or if the parent layout is not an overlay-type layout.

Interaction: If this option is enabled, it overrides the HALIGN= and VALIGN= options.

Interaction: This option is ignored if LOCATION=OUTSIDE.

BACKGROUNDCOLOR=style-reference | color

specifies the color of the layout background.

Default: The GraphBackground:Color style reference.

style-reference

A reference in the form style-element:style-attribute . Only the style-attribute named COLOR is used.

Interaction: OPAQUE=TRUE must be in effect for the color to be seen. By default, OPAQUE=FALSE.

BORDER=boolean

specifies whether a border is drawn around the layout.

Default: FALSE

Interaction: If this option is set to FALSE, the BORDERATTRS option is ignored.

BORDERATTRS=style-element | style-element (line-options) | (line-options)

specifies the attributes of the border line around the layout. See "General Syntax for Attribute Options" for the syntax on using a style-element and "Line Options" for available line-options .

Default: The GraphBorderLines style element.

Interaction: BORDER=TRUE must be set for this option to have any effect.

COLUMNGUTTER=dimension

specifies the amount of empty space between the columns.

Default: 0

Tip: If there are n columns, then there are n-1 gutters.

COLUMNS=integer

specifies the number of columns in the layout.

Default: If ORDER=ROWMAJOR, the default is 1.
If ORDER=COLUMNMAJOR, as many columns are created as needed to satisfy the ROWS= request.

Restriction: Assuming ORDER=ROWMAJOR, if COLUMNS=n and there are m cells defined, and n > m , then only m columns will be created (there are n - m cells with zero size).

Tip: This option is used to create a grid with a fixed number of columns, without concern for how many rows. For example, the following settings ensure that columns 1 and 2 in the first row are filled with content, as shown in the figure:

  
 layout gridded / columns=2 order=rowmajor border=true ; 
   entry '1' /border=true; 
   entry '2' /border=true; 
   entry '3' /border=true; 
 endlayout;
 

HALIGN=CENTER | LEFT | RIGHT

specifies this layout's horizontal alignment within its parent when nested within an overlay-type layout. For more information on how child positions are determined in an overlay-type layout, see the LAYOUT OVERLAY's "Example Program and Statement Details".

Default: CENTER

Restriction: This option is only available when this statement is nested within an overlay-type layout. It is ignored if this statement is the outermost layout or if the parent layout is not an overlay-type layout.

Interaction: If the AUTOALIGN= option is enabled, this option is ignored.

LOCATION=INSIDE | OUTSIDE

specifies whether the legend appears inside or outside the plot area when nested within an overlay-type layout.

Default: INSIDE

Restriction: This option has effect only when the GRIDDED layout block appears within an overlay-type layout. For more information on how child positions are determined in an overlay-type layout, see the LAYOUT OVERLAY's "Example Program and Statement Details".

Interaction: The actual position is determined by this option's setting plus the settings for the AUTOALIGN= or HALIGN= and VALIGN= options.

OPAQUE= boolean

specifies whether the layout background is opaque (TRUE) or transparent (FALSE).

Default: FALSE

Interaction: When this option is set to FALSE, the background color is not used.

ORDER=ROWMAJOR | COLUMNMAJOR

specifies whether cells are populated using column priority or by row priority.

Default: ROWMAJOR

ROWMAJOR	fills all the columns in a row, from left to right, before going to the next row.
COLUMNMAJOR	fills all the rows in a column, from top to bottom, before going to the next column.

Requirement: When this option is set to COLUMNMAJOR, the ROWS= option must be specified to indicate how many rows to fill before wrapping to the next column. The default number of rows is 1.

Requirement: When this option is set to ROWMAJOR, the COLUMNS= option must be specified to indicate how many columns to fill before wrapping to the next row. The default number of columns is 1.

Interaction: The ROWS= option is ignored when ORDER=ROWMAJOR.
The COLUMNS= option is ignored when ORDER=COLUMNMAJOR.

PAD=dimension | (pad-options)

specifies the amount of extra space that is added inside the layout border.

Default: The default padding for all sides is 0. Values without units are in pixels (px). A unit must be provided if other than pixels.

dimension

Specifies a dimension to use for the extra space at the left, right, top, and bottom of the layout border.

(pad-options)

Enables separate settings for the left, right, top, and bottom padding dimensions. Use the pad-options to create non-uniform padding. These options must be enclosed in parentheses. Each option is specified as a name = value pair. Sides not assigned padding are padded with the default amount.

Values without units are in pixels (px). A unit must be provided if other than pixels.

LEFT=dimension

specifies the amount of extra space added to the left side.

RIGHT=dimension

specifies the amount of extra space added to the right side.

TOP=dimension

specifies the amount of extra space added to the top.

BOTTOM=dimension

specifies the amount of extra space added to the bottom.

ROWGUTTER= dimension

specifies the amount of empty space between the rows.

Default: 0

Tip: If there are n rows, then there are n-1 gutters.

ROWS=integer

specifies the number of rows in the layout.

Default: If ORDER=COLUMNMAJOR, the default is 1.
If ORDER=ROWMAJOR, this option is ignored and as many rows are created as needed to satisfy the COLUMNS= request.

Restriction: Assuming ORDER=COLUMNMAJOR, if ROWS=n and there are m cells defined, and n > m , then only m rows will be created (there are n - m cells with zero size).

Tip: This option is used to create a grid with a fixed number of rows, without concern for how many columns. For example, the following settings ensure that rows 1 and 2 in the first column are filled with content, as shown in the figure:

  
 layout gridded / rows=2 order=columnmajor border=true ; 
   entry '1' /border=true; 
   entry '2' /border=true; 
   entry '3' /border=true; 
 endlayout;
 

VALIGN=CENTER | TOP | BOTTOM

specifies this layout's vertical alignment within its parent when nested within an overlay-type layout. For more information on how child positions are determined in an overlay-type layout, see the LAYOUT OVERLAY's "Example Program and Statement Details".

Default: CENTER

Restriction: This option is only available when this statement is nested within an overlay-type layout. It is ignored if this statement is the outermost layout or if the parent layout is not an overlay-type layout.

Interaction: If the AUTOALIGN= option is enabled, this option is ignored.

Copyright © 2007 by SAS Institute Inc., Cary, NC, USA. All rights reserved.