Declaration Keywords

A declaration identifies a chart property followed by its value. Table 24 lists the declaration keywords available for the ATTRIBUTES argument.

Table 24. ATTRIBUTES Declaration Keywords

Declaration Keyword

Choices

Description

3D‑DEPTH

0 – 100

Default = 10

Depth of the three-dimensional display in percent.

Note: You must set the 3d-EFFECTS argument to YES for this keyword to work.

Example:

ATTRIBUTES=('All','3D-DEPTH',15)

Displays all three-dimensional charts with a depth of 15 percent.

3D‑ELEVATION

0 – 180

Default = 45

Elevation of the three-dimensional display in degrees.

Note: You must set the 3D-EFFECTS argument to YES for this keyword to work.

Example:

ATTRIBUTES=('All','3D-ELEVATION',45)

Displays all three-dimensional charts with an elevation of 45 degrees.

3D‑ROTATION

0 – 90

Default = 40

Rotation of the three-dimensional display in degrees.

Note: You must set the 3D-EFFECTS argument to YES for this keyword to work.

Example:

ATTRIBUTES=('All','3D-ROTATION',50)

Displays all three-dimensional charts with a rotation of 50 degrees.

BACKGROUND

Named color or value in the range of RGB.

Default = Transparent

See DECLARE-COLOR-MAP for an explanation of RGB values.

Background color of a selected chart area.

Example:

ATTRIBUTES=('All','BackGround',('White'))

Sets the background color for all charts to white.

Note: Along with FOREGROUND, BACKGROUND replaces the functionality provided by COLOR-PALETTE.

CLUSTER-OVERLAP

-100 – 100

Default = 0

Percentage of bar overlap. Negative values add space between bars. Positive values cause bars to overlap.

Example:

ATTRIBUTES=('All','CLUSTER-OVERLAP',45)

Displays all bar charts with a cluster overlap of 45 percent.

CLUSTER‑WIDTH

0 – 100

Default = 80

Percentage of available space between each bar cluster.

Example:

ATTRIBUTES=('All','CLUSTER-WIDTH',60)

Displays all bar charts with a width of 60 percent between each bar cluster.

COLOR

List generated from CREATE-LIST, or an in-line list of values.

When referencing a list, the keyword LIST: must prefix the name of the list. When using a named_color_palette, the keyword PALETTE: must prefix the name of the color palette.

Defines a single color or a group of colors for an individual chart element.

COLOR values are used in presentation order and are reused once the current list is exhausted. The COLOR keyword overrides the default values established for the color property of a chart.

An error occurs if the contents of the list do not match the data type expected.

COLOR can reference a color palette or a single color.

Example:

ATTRIBUTES=('CHART2.LINE','COLOR', LIST:(('red'),('yellow'),('maroon')))

Creates a group of line colors of ‘red’, ‘yellow’ and ‘maroon’ for chart2.

ATTRIBUTES=('OTHER','COLOR',('red'))

Sets the color for the ’Other’ pie chart slice to ’red’ for all pie charts.

Note: COLOR replaces the functionality provided by ITEM-COLOR.

FONT

Values specified under [Fonts] in SQR.INI.

Each entry consists of a font number assigned to a named font. For example, 3 may represent Courier.

Default = Times New Roman

Font for all text and/or for specific text areas in a chart image.

Example:

ATTRIBUTES=('ALL','Font',3,'Point-Size',12)

Sets the font typeface to the corresponding value from SQR.INI in the [Fonts] section for value 3 and the size to 12 point for all text items for all charts.

FONT‑STYLE

PLAIN | BOLD | ITALIC | UNDERLINE

Default = PLAIN

Style of the font for all text and/or for specific text areas in a chart image. Separate multiple values with a space.

Example:

ATTRIBUTES=('Title','Font-Style','Bold Underline')

Sets the font style to ‘BOLD’ and ‘Underline’ for all charts.

FOREGROUND

Named color or values in the range of RGB.

Default = Black

See DECLARE-COLOR-MAP in the for an explanation of RGB values.

Text, outline, and line color for a chart area.

Example:

ATTRIBUTES=('X-Axis.Label','ForeGround', ('Yellow'))

Sets the X-Axis label for all charts to yellow.

Note: Along with BACKGROUND, FOREGROUND replaces the functionality provided by COLOR-PALETTE.

HALF-RANGEYES | NO

Default = NO

Determines how the x-axis is displayed in Polar charts.

NO—X-axis is displayed as one full range fro 0 to 360 degrees.

YES—X-axis is displayed as two half-ranges from —180 to 180 degrees.

Example:

ATTRIBUTES=('Chart1', 'HALF-RANGE','Yes')

Sets the axis label range from ‑180 to 180 degrees.

HOLE-VALUE

A value between the following minimum and maximum values:

Min Value: ‑1.7976931348623157E+308

Max Value: 1.7976931348623157E+308

Default = None

Value in the data to ignore. You can only have one HOLE‑VALUE per chart.

Example:

ATTRIBUTES=('All','HOLE-VALUE',-1)

Sets the HOLE-VALUE to -1. This means that if DECLARE‑CHART or PRINT-CHART finds a value of -1 in the data to chart, the ‑1 value is ignored.

LABEL-LOCATION

INNER | OUTER | AUTO

Default = AUTO

Location of labels in pie charts.

INNER—Labels are placed within the chart area.

OUTER—Labels are placed outside the chart area.

AUTO—The label location is controlled by the charting application.

Example:

ATTRIBUTES=('All','LABEL-LOCATION’','OUTER')

Displays the pie chart labels outside of the chart area.

LEGEND-COLUMNS

Any numeric value.

Default = 0

A value of 0 means the charting application will determine the proper value.

Number of columns to use when generating the chart legend. You can only have one LEGEND‑COLUMNS value per chart.

Example:

ATTRIBUTES=('All','LEGEND-COLUMNS',4)

Displays the chart legend with four columns.

LEGEND-ROWS

Any numeric value.

Default = 0

A value of 0 means the charting application will determine the proper value.

Number of rows to use when generating the chart legend. You can only have one LEGEND-ROWS value per chart.

Example:

ATTRIBUTES=('All','LEGEND-ROWS',2)

Displays the chart legend with two rows.

LOCATION

LOWER-RIGHT | CENTER-RIGHT | UPPER-RIGHT | LOWER-LEFT | CENTER-LEFT | UPPER-LEFT | LOWER-CENTER | UPPER-CENTER

Note:CENTER-CENTER is reserved for ChartArea.

Positions the main chart elements of the Header, Footer, and Legend in pixels, or controls the specific location for the Legend.

Each positional object is considered a rectangle, and the (x,y) pixel location of (1,1) relates to the upper left-hand coordinate of an image. The charting application positions the upper left-hand corner of the rectangle at the pixel location specified.

Example:

ATTRIBUTES=('Legend’','LOCATION','CENTER-RIGHT')

Positions the chart legend in the center vertical and right horizontal location of the chart.

Note: LOCATION replaces the functionality provided by LEGEND-PLACEMENT.

ORIGIN-BASE-ANGLE0 – 360

Default = 0

Position of the x-axis for Polar, Radar, and Area Radar charts in degrees.

Example:

ATTRIBUTES=('CHART1','ORIGIN-BASE-ANGLE','90')

Sets the ORIGIN-BASE-ANGLE to 90 degrees.

OTHER-LABELAny value.

Default = Other

Name of the label used for the “Other” pie chart segment.

Example:

ATTRIBUTES=('ALL','OTHER-LABEL','OTHER-PRODUCTS')

Declares the label used for the “Other” pie chart segment is “Other-Products”.

PATTERNCIRCULAR | WEBBED

Default = CIRCULAR

Sets the gridlines in Radar and Area Radar charts to circular or webbed.

Example:

ATTRIBUTES=('CHART1.GRID','PATTERN','WEBBED')

Sets the Radar chart grid to webbed..

PERCENTAGE-PRECISION

0 – 15

Default = 2

Number of digits to the right of the decimal point in a pie chart.

Example:

ATTRIBUTES=('All','PERCENTAGE-PRECISION',5)

Displays the pie chart percentage with five digits to the right of the decimal point.

POINT‑SIZE

Any point size.

Default = 12

Font size (in points) for all areas in a chart image. Control can be for all text on a chart and/or for specific text areas on a chart.

Example:

ATTRIBUTES=('Title','Style','Bold Underline', 'Point-Size',16)

Sets the font style to ‘Bold’ and ‘Underline’ and font size to 16 point for the ‘Title’ text item for all charts.

Note: POINT-SIZE replaces the functionality provided by ITEM-SIZE.

SIZE

Depends on the SUB-SELECTOR:

  • LINE – 1 to 10 pixels

  • SYMBOL – 1 to 100 pixels

  • GRID – 1 to 10 pixels

Size of the lines, symbols, and grids for a chart element.

The SIZE keyword overrides the default values established for the size property of a chart.

The default line and grid width is 1 pixel. The default symbol width is a bounding box of 6x6 pixels.

Example:

ATTRIBUTES=('CHART1.LINE','SIZE',2)

Sets the line size for all lines to 2 pixels for chart1.

SORT‑ORDER

LARGEST | SMALLEST | DATAORDER

Default = DATAORDER

Defines whether to display pie-chart slices largest-to-smallest, smallest-to-largest, or the order they appear in the data.

  • LARGEST—Largest-to-smallest

  • SMALLEST—Smallest-to-largest

  • DATAORDER—Order they appear in the data.

Example:

ATTRIBUTES=('All','SORT-ORDER','Largest’')

Sets the display order of the pie slices from largest to smallest for all charts.

START‑ANGLE

0 – 359

Default = 0

For Pie Charts:

Position in the pie chart where the first pie slice is drawn.

A value of zero degrees represents a horizontal line from the center of the pie to the right-hand side of the pie chart.

A value of 90 degrees represents a vertical line from the center to the top of the pie.

Slices are drawn clockwise from the specified angle.

The default position for the first pie segment is 90 degrees.

Example:

ATTRIBUTES=('All','START-ANGLE',45)

Sets the starting location of the first pie slice to a line 45 degrees to the right and down of a horizontal line.

For Polar, Radar, and Area Radar Charts:

Angle that the y-axis makes with the ORIGIN-BASE-ANGLE.

Example:

ATTRIBUTES=('Chart1','START-ANGLE',135)

Sets the START-ANGLE to 135 degrees.

STYLE

Depends on the SUB-SELECTOR:

  • LINE – Solid | LongDash | ShortDash | LongShort | DashDot

  • SYMBOL – None | Dot | Box | Triangle | Diamond | Star | VerticalLine | HorizontalLine | Cross | Circle | Square

  • FILL – None | Solid | 25Per | 50Per | 75Per | HorizontalStripe | VerticalStripe | 45Stripe | 135Stripe | DiagonalHatch | CrossHatch

Group of styles for an individual chart element.

This keyword can use the list generated from CREATE-LIST, or you can enter an in-line list of values. When using a named list, the keyword LIST: must prefix the name of the list. An error occurs if the contents of the list do not match the data type expected.

STYLE values are used in presentation order and are reused once the current list is exhausted. The STYLE keyword overrides the default values established for the style property of a chart.

The default line and fill style is Solid. The default symbol style is Dot.

Example:

ATTRIBUTES=('Chart1.Line','Style',LIST: ('shortdash','longdash','solid'))

Creates a group of line styles of ‘shortdash’, ’longdash’, and ‘solid’ for chart1.

Note: STYLE replaces the functionality provided by FILL.

THRESHOLD‑METHOD

VALUE | PERCENT

Default = VALUE

Grouping method to use for the Other slice in a pie chart.

  • VALUE —Use when you know the data value to group into the Other slice. Value places only those items that are less than the Threshold-Value into the Other slice.

  • PERCENT—Use when you want to devote a certain percentage of the pie to the Other slice. Percent places only those items that are accumulatively less than the Threshold-Value into the Other slice.

Example:

ATTRIBUTES=('All','THRESHOLD-METHOD', 'Value')

Sets the THRESHOLD-METHOD to indicate that the THRESHOLD‑VALUE is a data value for all charts.

THRESHOLD- VALUE

Depends on the THRESHOLD-METHOD:

  • When THRESHOLD-METHOD is set to Value, valid values are numbers greater than or equal to 0.

  • When THRESHOLD-METHOD is set to Percent, valid values are from 0 to 100.

Default = 0 (No Other Slice)

Data value to group into the Other slice in a pie chart.

Example:

ATTRIBUTES=('All','THRESHOLD-VALUE',10)

Together with THRESHOLD-MEHTOD establishes that values less than 10 will be grouped into the ‘Other’ pie slice for all charts.

UNITSDEGREES | RADIANS | GRADS

Default = DEGREES

Angular units used for Polar, Radar, and Area Radar charts. Affects the ORIGIN-BASE-ANGLE and START-ANGLE.

Example:

ATTRIBUTES=('Chart1','UNITS','Radians')

Displays the ORIGIN-BASE-ANGLE and START-ANGLE in radians.

In certain instances, the declaration value must be a list (either an inline list, or a named list previously created using CREATE-LIST). 

ATTRIBUTES=('Chart1.Fill', 'Style',
           LIST:('Solid','45Stripe','DiagonalHatch'))
ATTRIBUTES=('Chart2.Line', 'Style',
           LIST:('LongDash','DashDot','Solid'))
ATTRIBUTES=('Symbol', 'Style',
           LIST:('Square','Diamond','Triangle'))
ATTRIBUTES=('Chart1.Symbol', 'Color', 
           LIST:(('Red'), ('Blue'),(100, 200, 130)))