Y1 Axis Options

How to:

Y1 Axis options are available in the Graph Editor menu for all graph types except pie graphs.

The Y1 Axis Options enable you to define:


Top of page

x
Procedure: How to Define the Location and Format of the Y1 Axis
  1. Select the General tab from Y1 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 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).

  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 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 );


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

    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.

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

Top of page

x
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);


x
Procedure: How to Define Y1 Axis Labels
  1. Select the Labels tab from Y1 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 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).

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

Top of page

x
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 );


x
Procedure: How to Define Y1 Axis Grids
  1. Select the Grids tab from Y1 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. 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.

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

Top of page

x
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 );

WebFOCUS