Y2 Axis Options

How to:

Y2 Axis options are available in the Graph Editor menu for all dual-axis graph types.

The Y2 Axis Options enable you to define:


Top of page

x
Procedure: How to Define the Location and Format of the Y2 Axis
  1. Select the General tab from Y2 Axis Options.
  2. 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 or disable display of the axis base line and zero line.
    Left Side of Chart

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

    Right Side of Chart

    Select this field if you want the Y2 numeric axis to be imaged at the right of a vertical chart or the top of a horizontal chart. This is the default value.

    Both Sides of Chart

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

    Descending Axis

    This field is used to select descending or ascending values on the Y2 numeric. The default value is ascending (this field is not selected).

    Axis Line

    Enables and disables the display of the Y2 axis base line. The default value is enabled (this field is selected).

    Zero Line

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

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

Top of page

x
Syntax: How to Add Properties and Methods for the Location and Format of the Y2 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 ( getY2Axis(), 0 );

Right Side of Chart

setAxisSide ( getY2Axis(), 1 );

Both Sides of Chart

setAxisSide ( getY2Axis(), 2 );

Descending Axis

setAxisDescending ( getY2Axis(), true | false );

Axis Line

setDisplay ( getY2AxisLine(), true | false);

Zero Line

setDisplay ( getY2ZeroLine(), true | false );


x
Procedure: How to Define Y2 Axis Scale Settings
  1. Select the Scale tab from Y2 Axis Options.
  2. 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

    Selects whether or not the Y2 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

    Selects logarithmic or linear scale for the numeric Y2 axis. When the scale range is set to automatic, any data items with Y2 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

    Selects manual or automatic calculation of the maximum scale value on the Y2 axis in the chart. If this field is selected (ž), enter the maximum allowable scale value on the Y2 axis in the Max Value field. The default value is not selected (let the charting engine automatically calculate the maximum value on the Y2 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 Y2 axis. The default value is 70.0.

    Use Manual Setting for Minimum

    Selects manual or automatic calculation of the minimum scale value on the Y2 axis in the chart. If this field is selected (ž), enter the minimum allowable scale value on the Y2 axis in the Min Value field. The default value is not selected (let the charting engine automatically calculate the minimum value on the Y2 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 Y2 axis. The default value is 0.0.

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

Top of page

x
Syntax: How to Add Properties and Methods for Y2 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 (getY2Axis(), true | false );

Log Scale

setLogScale ( getY2Axis(), true | false );

Use Manual setting for Maximum

setScaleMaxAuto ( getY2Axis(), true | false );

Max Value

setScaleMax ( getY2Axis(), value);

Use Manual setting for Minimum

setScaleMinAuto ( getY2Axis(), true | false );

Min Value

setScaleMin ( getY2Axis(), value);


x
Procedure: How to Define Y2 Axis Labels
  1. Select the Labels tab from Y2 Axis Options.
  2. 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 Y2 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 or exclude the minimum value on the Y2 axis. The default value is not selected (the minimum label is included).

    Hide Maximum Value

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

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

Top of page

x
Syntax: How to Add Properties and Methods for Y2 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 ( getY2Label(), true | false );

Format

setTextFormatPreset ( getY2Label(), value );

Hide Minimum Value

setExcludeMinLabel ( getY2Label(), true | false );

Hide Maximum Value

setExcludeMaxLabel ( getY2Label(), true | false );


x
Procedure: How to Define Y2 Axis Grids
  1. Select the Grids tab from Y2 Axis Options.
  2. 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. The Automatic Grids option buttons enable/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 Y2 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 Y2 axis.

    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 Y2 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 Y2 axis. The default value is disabled.

    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 Y2 axis.

    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 Y2 axis. Do not use a negative value or a value that results in greater than 50 grid lines.

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

Top of page

x
Syntax: How to Add Properties and Methods for Y2 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 ( getY2MajorGrid(), true | false );

Style

setGridStyle ( getY2MajorGrid(), value );

Automatic Grids

setGridStepAuto ( getY2MajorGrid(), true | false );

Manual Intervals

setGridStep ( getY2MajorGrid(), value );

Show Minor Grid Lines

setDisplay ( getY2MinorGrid(), true | false );

Style

setGridStyle ( getY2MinorGrid(), value );

Automatic Grids

setGridStepAuto ( getY2MinorGrid(), true | false );

Manual Intervals

setGridStep ( getY2MinorGrid(), value );

WebFOCUS