X1 Axis Options

How to:

X1 Axis options are available in the Graph Editor menu for graph types that have an X-axis (for example, XY scatter charts, polar charts, and histograms).

The X1 Axis Options enable you to define:


Top of page

x
Procedure: How to Define the Location and Format of the X1 Axis
  1. Select the General tab from X1 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 X1 numeric axis to be imaged at the left side of a horizontal chart or on the bottom side of a vertical chart. This is the default value.

    Right Side of Chart

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

    Both Sides of Chart

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

    Descending Axis

    Selects descending or ascending values on the X1 numeric. The default value is ascending (this field is not selected). For example, assume the values 0, 10, 20, ... 70 appear from left to right across the bottom of an XY Scatter chart. If this field is selected and applied to the chart, these values would appear from right to left across the bottom of the chart (70, 60, 50...0).

    Axis Line

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

    Zero Line

    Enables and disables the display of a zero line on the X1 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 X1 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 ( getX1Axis(), 0 );

Right Side of Chart

setAxisSide ( getX1Axis(), 1 );

Both Sides of Chart

setAxisSide ( getX1Axis(), 2 );

Descending Axis

setAxisDescending ( getX1Axis(), true | false );

Axis Line

setDisplay ( getX1AxisLine(), true | false);

Zero Line

setDisplay ( getX1ZeroLine(), true | false );


x
Procedure: How to Define X1 Axis Scale Settings
  1. Select the Scale tab from X1 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 X1 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 (a zero is not required on the X1 axis).

    Log Scale

    Selects logarithmic or linear scale for the numeric X1 axis. When the scale range is set to automatic, any data items with X1 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 X1 axis in the chart. If this field is selected (ž), enter the maximum allowable scale value on the X1 axis in the Max Value field. The default value is not selected (let the charting engine automatically calculate the maximum value on the X1 axis).

    Max Value

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

    Use Manual Setting for Minimum

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

setScaleMustIncludeZero (getX1Axis(), true | false );

Log Scale

setLogScale ( getX1Axis(), true | false );

Use Manual setting for Maximum

setScaleMaxAuto ( getX1Axis(), true | false );

Max Value

setScaleMax ( getX1Axis(), value);

Use Manual setting for Minimum

setScaleMinAuto ( getX1Axis(), true | false );

Min Value

setScaleMin ( getX1Axis(), value);


x
Procedure: How to Define X1 Axis Labels
  1. Select the Labels tab from X1 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 X1 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 X1 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 X1 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 X1 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 ( getX1Label(), true | false );

Format

setTextFormatPreset ( getX1Label(), value );

Hide Minimum Value

setExcludeMinLabel ( getX1Label(), true | false );

Hide Maximum Value

setExcludeMaxLabel ( getX1Label(), true | false );


x
Procedure: How to Define X1 Axis Grids
  1. Select the Grids tab from the X1 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 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 major grid lines for the X1 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 X1 axis. The default value is enabled (the number of major grid lines on the X1 axis is automatically calculated). When this field is not selected, specify the number grid steps in the Manual Intervals field.

    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 X1 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 field is set to 5. If this field 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 minor grid lines for the X1 axis. The default value is disabled (minor grid lines do not appear on the X1 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 X1 axis. The default value is enabled (the number of minor grid lines on the X1 axis is automatically calculated). When this field is not selected, specify the number grid steps in the Manual Intervals field.

    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 X1 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 X1 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 ( getX1MajorGrid(), true | false );

Style

setGridStyle ( getX1MajorGrid(), value );

Automatic Grids

setGridStepAuto ( getX1MajorGrid(), true | false );

Manual Intervals

setGridStep ( getX1MajorGrid(), value );

Show Minor Grid Lines

setDisplay ( getX1MinorGrid(), true | false );

Style

setGridStyle ( getX1MinorGrid(), value );

Automatic Grids

setGridStepAuto ( getX1MinorGrid(), true | false );

Manual Intervals

setGridStep ( getX1MinorGrid(), value );

WebFOCUS