Y1 Axis Options

Procedure: How to Define the Location and Format of the Y1 Axis

Select the General tab from Y1 Axis Options.

Select the location in the chart where you want the axis imaged. Descending Axis draws the axis labels in ascending or descending order. The Axis Line and Zero Line check boxes enable and disable display of the axis base line and zero line.
Left Side of Chart

Select this field if you want the Y1 numeric axis to be imaged at the left side of a vertical chart or on the bottom side of a horizontal chart. This is the default value.

Right Side of Chart

Select this field if you want the Y1 numeric axis to be imaged at the right of a vertical chart or the top of a horizontal chart.

Both Sides of Chart

Select this field if you want the Y1 numeric axis to be imaged at the left and right sides of a vertical chart or bottom and top of a horizontal chart.

Descending Axis

Selects descending or ascending values on the Y1 numeric. The default value is ascending (this field is not selected). For example, assume the values 0, 10, 20 ... 70 appear from bottom to top on the left side of a standard 2D bar chart. If this field is selected and applied to the chart, these values would appear from top to bottom and the risers are also imaged from the top of the chart rather than the bottom.

Axis Line

Enables and disables the display of the Y1 axis base line. The default value is enabled (ž).

Zero Line

Enables and disables the display of a zero line on the Y1 axis. The default value is disabled (this field is not selected).

Select the Apply button to add these selections to the chart.

Syntax: How to Add Properties and Methods for the Location and Format of the Y1 Axis

Selections in the associated dialog boxes add the following properties and methods to the code that defines this chart:

Editor Field	Property/Method
Left Side of Chart	setAxisSide ( getY1Axis(), 0 );
Right Side of Chart	setAxisSide ( getY1Axis(), 1 );
Both Sides of Chart	setAxisSide ( getY1Axis(), 2 );
Descending Axis	setAxisDescending ( getY1Axis(), true \| false );
Axis Line	setDisplay ( getY1AxisLine(), true \| false);
Zero Line	setDisplay ( getY1ZeroLine(), true \| false );

Top of page

Procedure: How to Define Y1 Axis Scale Settings

Select the Scale tab from Y1 Axis Options.

Use the check boxes to enable or disable Always include Zero, log scale, and manual maximum and minimum scaling. When manual maximum and/or minimum scaling is enabled, enter values in the Max Value and/or Min Value fields.
Always Include Zero on Scale

This field selects whether or not the Y1 axis must include a zero value. If the Log Scale field is selected or the Max Value or Min Value is greater than zero, this will be grayed-out. It is not valid when the logarithmic scale is used or Min and Max Values are greater than zero. The default value is not selected.

Log Scale

This field selects logarithmic or linear scale for the numeric Y1 axis. When the scale range is set to automatic, any data items with Y1 values less than or equal to zero are graphed as null for log scale. If a manual scale range is specified to include negative values (Min Value is less than or equal to zero), the request for log scale is ignored. The default value is linear scale (this field is not selected).

Use Manual Setting for Maximum

This field selects manual/automatic calculation of the maximum scale value on the Y1 axis in the chart. If this field is selected (ž), enter the maximum allowable scale value on the Y1 axis in the Max Value field. The default value is not selected (let the charting engine automatically calculate the maximum value on the Y1 axis).

Max Value

When the Use Manual Setting for Maximum field is selected (ž), use this field to specify the maximum allowable scale value on the Y1 axis. The default value is 70.0.

Use Manual Setting for Minimum

This field selects manual or automatic calculation of the minimum scale value on the Y1 axis in the chart. If this field is selected (ž), enter the minimum allowable scale value on the Y1 axis in the Min Value field. The default value is not selected (let the charting engine automatically calculate the minimum value on the Y1 axis).

Min Value

When the Use Manual Setting for Minimum field is selected (ž), use this field to specify the minimum allowable scale value on the Y1 axis. The default value is 0.0.

Select the Apply button to add these selections to the chart.

Top of page

Syntax: How to Add Properties and Methods for Y1 Axis Scale Settings

Selections in the associated dialog boxes add the following properties and methods to the code that defines this chart:

Editor Field	Property/Method
Always Include Zero	setScaleMustIncludeZero (getY1Axis(), true \| false );
Log Scale	setLogScale ( getY1Axis(), true \| false );
Use Manual setting for Maximum	setScaleMaxAuto ( getY1Axis(), true \| false );
Max Value	setScaleMax ( getY1Axis(), value);
Use Manual setting for Minimum	setScaleMinAuto ( getY1Axis(), true \| false );
Min Value	setScaleMin ( getY1Axis(), value);

Top of page

Procedure: How to Define Y1 Axis Labels

Select the Labels tab from Y1 Axis Options.

Use the check boxes to enable or disable the display of all axis labels, the minimum axis label, or the maximum axis label. When Show Axis Labels is selected, select a label format in the Format field.
Show Axis Labels

Enables and disables the display of labels on the Y1 axis in the chart. The default value is enabled (axis labels appear). Use the Format field to define the format of numeric labels. When this box is checked the setting in the general tab determines where the labels appear (left, right, both).

Format

When Show Axis Labels is selected, select the drop-down list box in this field to select a label format: General, 0%, 0.0%, $0, $0.00, and so on. The default value is General.

Hide Minimum Value

When Show Axis Labels is selected (ž), this field can be used to include/exclude the minimum value on the Y1 axis. The default value is not selected (include the minimum label).

Hide Maximum Value

When Show Axis Labels is selected (ž), this field can be used to include/exclude the maximum value on the Y1 axis. The default value is not selected (include the maximum label).

Select the Apply button to add these selections to the chart.

Top of page

Syntax: How to Add Properties and Methods for Y1 Axis Labels

Selections in the associated dialog boxes add the following properties and methods to the code that defines this chart:

Editor Field	Property/Method
Show Axis Labels	setDisplay ( getY1Label(), true \| false );
Format	setTextFormatPreset ( getY1Label(), value );
Hide Minimum Value	setExcludeMinLabel ( getY1Label(), true \| false );
Hide Maximum Value	setExcludeMaxLabel ( getY1Label(), true \| false );

Top of page

Procedure: How to Define Y1 Axis Grids

Select the Grids tab from Y1 Axis Options.

Use the check boxes in this dialog to enable or disable the display of major and minor grid lines. When either check box is selected, use the Style field to select the format of major and minor grid lines. Use the Automatic Grids option buttons to enable or disable automatic calculation of the number of major and minor grid lines. When these option buttons are not selected, select a number of major or minor grid lines in the Manual Intervals fields.
Show Major Grid Lines

Enables and disables the display of the major grid lines for the Y1 axis. The default value is enabled (ž).

Style

When Show Major Grid Lines is selected (ž), use this field to select the style of the major grid lines: Regular Grids, Grids and Ticks, Inner Ticks, Outer Ticks, or Spanning Ticks. The default value is Regular Grids.

Automatic Grids

Enables and disables automatic calculation of the number of major grid lines on the Y1 axis. The default value is enabled (the number of major grid lines is automatically calculated).

Manual Intervals

When Automatic Grids is not selected (ž), use this field to set the number of major grid lines/steps that will be imaged on the Y1 axis. For example, grid steps 1, 6, 11, 16, ...51 will be imaged if the range of values in the chart is 1...51 and this property is set to 5. If this property is set to 10, grid steps 1, 11, 21, 31...51 would appear. Do not use a negative value or a value that results in greater than 50 grid lines.

Show Minor Grid Lines

Enables and disables the display of the minor grid lines for the Y1 axis. The default value is disabled (minor grid lines do not appear on the Y1 axis).

Style

When Show Minor Grid Lines is selected (ž), use this field to select the style of the minor grid lines: Regular Grids, Grids and Ticks, Inner Ticks, Outer Ticks, or Spanning Ticks. The default value is Regular Grids.

Automatic Grids

Enables and disables automatic calculation of the number of minor grid lines on the Y1 axis. The default value is enabled (the number of minor grid lines is automatically calculated).

Manual Intervals

When Automatic Grids is not selected, use this field to set the number of minor grid lines/steps that will be imaged on the Y1 axis. Do not use a negative value or a value that results in greater than 50 grid lines.

Select the Apply button to add these selections to the chart.

Top of page

Syntax: How to Add Properties and Methods for Y1 Axis Grids

Selections in the associated dialog boxes add the following properties and methods to the code that defines this chart:

Editor Field	Property/Method
Show Major Grid Lines	setDisplay ( getY1MajorGrid(), true \| false );
Style	setGridStyle ( getY1MajorGrid(), value );
Automatic Grids	setGridStepAuto ( getY1MajorGrid(), true \| false );
Manual Intervals	setGridStep ( getY1MajorGrid(), value );
Show Minor Grid Lines	setDisplay ( getY1MinorGrid(), true \| false );
Style	setGridStyle ( getY1MinorGrid(), value );
Automatic Grids	setGridStepAuto ( getY1MinorGrid(), true \| false );
Manual Intervals	setGridStep ( getY1MinorGrid(), value );