Optional Arguments

The options in an HBAR, HBAR3D, VBAR, and VBAR3D statement affect all bars that are produced by the statement. You can specify as many options as you want and list them in any order.

CFRAME=background-color

specifies a background color for the graph. The specified color must be a valid SAS/GRAPH color name.

Alias:CFR=

Style reference:Color attribute of the GraphBackground element

Restriction:Not supported by Java

CONTINUOUS

specifies that the graph data be treated as continuous. Continuous data can take any of an infinite number of values between whole numbers, and so might not be measured accurately. The default is discrete.

Restriction:Not supported by Java

COUTLINE=bar-outline-color | SAME

outlines all of the bars with the color specified. SAME specifies that the outline color of a bar is the same as the interior pattern color. The default color is the outline color of the current style.

Alias:CO=

Style reference:Color attribute of the GraphOutlines element

Restriction:Not supported by Java

CTEXT=text-color

specifies a color for all text on the chart. The GAREABAR procedure looks for the text color in the following order:

1. colors specified for labels and values on assigned LEGEND statements, which override the CTEXT= option specified in the GAREABAR statement
2. the color specified by the CTEXT= option in the GAREABAR statement
3. the color specified by the CTEXT= option in a GOPTIONS statement
4. the color specified in the current style

Alias:CT=

Style reference:Color attribute of the GraphLabelText and GraphValueText elements

Restriction:Not supported by Java

DESCRIPTION=“description”

specifies the description of the plot. The maximum length for description is 256 characters. The description does not appear in the output. The descriptive text is displayed as follows:

• the chart description for Web output (depending on the device driver). See Chart Descriptions for Web Presentations for more information
• the Table of Contents that is generated when you use the CONTENTS= option on an ODS HTML statement, assuming that the output is generated while the contents page is open
• the description and the properties for the output in the Results window
• the description and properties for the catalog entry in the SAS Explorer
• the Description field of the PROC GREPLAY window

The description can include the #BYLINE, #BYVAL, and #BYVAR substitution options, which work as they do when used on statements such as TITLE, FOOTNOTE, and NOTE. Refer to Substituting BY Line Values in a Text String. The 256-character limit applies before the substitution takes place for these options. Thus, if in the SAS program the description text exceeds 256 characters, it is truncated to 256 characters, and then the substitution is performed.

Alias:DES=

Default:GAREABAR of chart-variable

Restriction:Not supported by Java

DISCRETE

treats the chart variable axis data as discrete data. Discrete data is characterized as data in which the variable can take only one of a finite set of values. The GAREABAR procedure creates a separate bar for each unique value of the chart variable. If the chart variable has a format associated with it, each formatted value is treated as a unique value. The default is discrete.

Restriction:Not supported by Java

FRAME | NOFRAME

specifies whether the two-dimensional axis area frame or the three-dimensional backplane is drawn. The default is FRAME, which draws a frame around the axis areas (in two-dimensional bar charts) or generates a colored three-dimensional backplane (in three-dimensional bar charts). For three-dimensional charts, NOFRAME removes the backplane color, and leaves the backplane grid, the vertical axis and plane, and the horizontal axis and plane.

The NOFRAME option overrides the CFRAME= option.

Alias:FR | NOFR

Restriction:Not supported by Java

LEGEND=LEGEND<1...99>

assigns the specified LEGEND definition to the legend generated by the SUBGROUP= option. The LEGEND= option itself does not generate a legend.

LEGEND= is ignored if any of the following are true:

• The SUBGROUP= option is not used.
• The specified LEGEND definition is not in effect.
• The NOLEGEND option is used.

Restrictions:The LEGEND statement options are partially supported by ActiveX.

Not supported by Java

See:LEGEND Statement

NAME=“name”

specifies the name of the graphics output file. The name can be up to 256 characters long. Uppercase characters are converted to lowercase. The default name is graph.png. If the name duplicates and existing name, then SAS/GRAPH adds a number to the name to create a unique name, for example, graph1.png.

Restriction:Not supported by Java

See:About Filename Indexing

NOLEGEND

suppresses the legend that is automatically generated by the SUBGROUP= option. The NOLEGEND option is ignored if the SUBGROUP= option is not used.

Restriction:Not supported by Java

SUBGROUP=subgroup-variable

divides the bars into segments according to the values of the subgroup-variable column. The subgroup-variable column can be either character or numeric, and is always treated as a discrete variable. The SUBGROUP= option creates a separate segment within each bar for each unique value of the subgroup variable.

Restriction:Not supported by Java

WIDTHSTAT= FIRST | LAST | SUM | PCT | PERCENT

specifies the statistic to be applied to the width-variable. Values for WIDTHSTAT= are as follows:

FIRST	specifies that the width of each bar is determined solely by the value of the first observation of the width-variable in the data for that bar.
LAST	specifies that the width of each bar is determined solely by the value of the last observation of the width-variable in the data for that bar.
SUM	specifies that the width of each bar is the sum of the values of the width-variable for that bar.
PCT | PERCENT	specifies that the width of each bar is the sum of the values of the width-variable for that bar. The width is expressed as a percentage of the sum of the values of the width-variable for all of the bars.

Alias:WSTAT=

Default:SUM

Restriction:Not supported by Java