WebFOCUS Online Help > Creating Charts With Graph Tools > Customizing Graphs With the Graph Editor > X1 Axis Options
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:
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.
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.
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.
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).
Enables and disables the display of the X1 axis base line. The default value is enabled (ž).
Enables and disables the display of a zero line on the X1 axis. The default value is disabled (this field is not selected).
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 ); |
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).
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).
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).
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.
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).
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.
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); |
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).
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.
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).
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).
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 ); |
Enables and disables the display of major grid lines for the X1 axis. The default value is enabled (ž).
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.
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.
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.
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).
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.
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.
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.
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 |