|
This property is used to change the direction of the X-axis. When false, values ascend normally -- from left to right on the X-axis. When true, values are reversed and descend from left-to-right on the graph. Note that this property also reverses the order of the axis labels and changes all data-related objects (e.g., markers) from their previous state. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Draw axis labels in descending order |
|
false= |
Draw axis labels in ascending order |
Default: |
false |
|
Syntax: |
setX1AxisDescending ( true | false ); |
|
|
boolean = getX1AxisDescending(); |
|
Example: |
perspective1.setX1AxisDescending(true); |
|
|
|
|
|
perspective1.setX1AxisDescending(false); |
|
|
|
|
Also See: |
|
This property enables (true) / disables (false) the display of the X1-axis line. The X1AxisSide property determines where the X1-axis line is drawn. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Draw X1 axis base line |
|
false= |
Do not draw X1 axis base line |
Default: |
true |
|
Syntax: |
setX1AxisLineDisplay ( true | false ); |
|
|
boolean = getX1AxisLineDisplay(); |
|
Example: |
perspective1.setY1MajorGridDisplay(false); |
|
|
|
|
|
perspective1.setX1AxisLineDisplay(true); |
|
|
|
|
Notes: |
In the default configuration for this chart type, the X1AxisLine is the same width and location as the bottom of the chart frame. When this line size is used, this property does not change the appearance of the chart. To make a thicker, more visible axis line, use getX1AxisLine()to get the object ID of the line and setLineWidth() method to increase the width of the line. |
|
Also See: |
|
This property controls which side of the graph where the X-axis base line, labels, and titles will be imaged. |
|
Data Type: |
Integer |
|
Range: |
0...2 |
|
|
0= |
Image to low side of graph (bottom or left). |
|
1= |
Image to high side of graph (top or right). |
|
2= |
Image to both sides. |
Default: |
Zero |
|
Syntax: |
setX1AxisSide ( value ); |
|
|
value = getX1AxisSide(); |
|
Example: |
perspective1.setMarkerSizeDefault(60); |
|
|
|
|
|
perspective1.setX1AxisSide(1); |
|
|
|
|
Also See: |
|
This property excludes (true) or includes (false) the maximum label on the X1-axis. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Exclude maximum label |
|
false= |
Include maximum label |
Default: |
false |
|
Syntax: |
setX1ExcludeMaxLabel ( true | false ); |
|
|
boolean = getX1ExcludeMaxLabel(); |
|
Example: |
perspective1.setX1ExcludeMaxLabel(true); |
|
|
|
|
|
perspective1.setX1ExcludeMaxLabel(false); |
|
|
|
|
Notes: |
This property will not affect the appearance of the graph if drawing of X1-axis labels has been disabled with setX1LabelDisplay(false); When setX1LabelDisplay(true) is used, the maximum label will be included or excluded as defined by X1ExcludeMaxLabel. |
|
Also See: |
|
This property excludes or includes the minimum label on the X1-axis. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Exclude maximum label |
|
false= |
Include maximum label |
Default: |
false |
|
Syntax: |
setX1ExcludeMinLabel ( true | false ); |
|
|
boolean = getX1ExcludeMinLabel(); |
|
Example: |
perspective1.setMarkerSizeDefault(60); |
|
|
|
|
|
perspective1.setX1ExcludeMinLabel(false); |
|
|
|
|
Notes: |
This property will not affect the appearance of the graph if drawing of X1-axis labels has been disabled with setX1LabelDisplay(false); When setX1LabelDisplay(true) is used, the minimum label will be included or excluded as defined by X1ExcludeMinLabel. |
|
Also See: |
|
This property is used to automatically fit/size all numeric axis labels on the numeric X-axis. When automatic fit/size is enabled (the default), the font size of these objects cannot be changed to a size that is larger than the relative location/size of the object and objects around it. When automatic fitting is disabled, the font size can be set to any value allowing very large font sizes to overlap other objects in the graph. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
enable automatic fit/size |
|
false= |
disable automatic fit/size |
Default: |
true |
|
Syntax: |
setX1LabelAutofit ( true | false ); |
|
|
boolean = getX1LabelAutofit(); |
|
Example: |
perspective1.setGraphType(61); |
|
|
|
|
|
perspective1.setX1LabelAutofit(false); |
|
|
|
|
Also See: |
|
This property enables (true) / disables (false) the display of labels on the X-axis. When this property is enabled, the X1AxisSide property determines the location where the labels are displayed. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Display X1-axis labels and title |
|
false= |
Do not display X1-axis labels and title |
Default: |
true |
|
Syntax: |
setX1LabelDisplay ( true | false ); |
|
|
boolean = getX1LabelDisplay(); |
|
Example: |
perspective1.setMarkerSizeDefault(60); |
|
|
|
|
|
perspective1.setX1LabelDisplay(false); |
|
|
|
|
Also See: |
|
This property defines the format of numeric data labels on the X1 axis. |
|
Data Type: |
Integer |
|
Range: |
-1...17 |
|
|
Value |
Format (Example) |
|
-1 |
Use format set by X1LabelFormatPattern |
|
0= |
General (Example: 123 = 123) |
|
1= |
# (Example: 123 = 123) |
|
2= |
#% (Example: 123 = 12,300%) |
|
3= |
#.#% (Example: 123 = 12,300.0%) |
|
4= |
#.##% (Example: 123 = 12,300.00%) |
|
5= |
$#.## (Example: 123 = $123.00) |
|
6= |
$# (Example: 123 = $123) |
|
7= |
#K (Example: 1,234 = 1K) |
|
8= |
$#K (Example: 1,234 = $1K) |
|
9= |
#M (Example: 1,234,567 = 1M) |
|
10= |
$#M (Example: 1,234,567 = $1M) |
|
11= |
#B (Example: 1,234,567,891 = 1B) |
|
12= |
$#B (Example: 1,234,567,891 = $1B) |
|
13= |
#T (Example: 1,234,567,891,234 = 1T) |
|
14= |
$#T (Example: 1,234,567,891,234 = $1T) |
|
15= |
show number with thousand separators no decimals (Example: 1,234=1K) |
|
16= |
show number with thousand separators two decimals (Example: 1,234=1.23K) |
|
17= |
General currency format for current Locale |
Default: |
0 (General) |
|
Syntax: |
setX1LabelFormat ( value ); |
|
|
value = getX1LabelFormat(); |
|
Example: |
perspective1.setX1MajorGridDisplay(false); |
|
|
|
|
Also See: |
|
When X1LabelFormat is set to minus one, use this property to define a standard Java data text format. |
Data Type: |
String |
Range: |
A pattern string in the following format: |
|
pattern:= subpattern{;subpattern} |
|
subpattern:= {prefix}integer{.fraction}{suffix} |
|
prefix:= '\\u0000'..'\\uFFFD' - specialCharacters |
|
suffix:= '\\u0000'..'\\uFFFD' - specialCharacters |
|
integer:= '#'* '0'* '0' |
|
fraction:= '0'* '#'* |
|
See Chapter 3 for more detailed information about this format pattern. |
Default: |
"#.#" |
Syntax: |
setX1LabelFormatPattern ( pattern ); |
|
pattern = getX1LabelFormatPattern(); |
Example: |
perspective1.setGraphType(61); |
|
|
|
perspective1.setX1LabelFormatPattern("(#.#)"); |
|
|
Also See: |
|
This property can be used to rotate labels on the X-axis. |
|
Data Type: |
Integer |
|
Range: |
0...2 |
|
|
0= |
No text rotation |
|
1= |
Rotate text 90 degrees (reads top to bottom) |
|
2= |
Rotate text 270 degrees (reads bottom to top) |
Default: |
Zero (no text rotation) |
|
Syntax: |
setX1LabelRotate ( value ); |
|
|
value = getX1LabelRotate(); |
|
Example: |
perspective1.setX1LabelRotate(2); |
|
|
|
|
|
perspective1.setX1LabelRotate(2); |
|
|
|
|
Also See: |
X1LabelAutofit, X1LabelDisplay, X1LabelFormat, X1LabelStagger |
|
This property specifies whether or not text for this graph axis should be staggered. Staggered labels are drawn in a zigzag fashion, with labels weaving in and under each other. This property affects all X-axis labels. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Stagger labels |
|
false= |
Draw labels on one line |
Default: |
false |
|
Syntax: |
setX1LabelStagger ( true | false ); |
|
|
boolean = getX1LabelStagger(); |
|
Example: |
perspective1.setX1LabelStagger(true); |
|
|
|
|
|
perspective1.setX1LabelStagger(false); |
|
|
|
|
Also See: |
X1LabelAutofit, X1LabelDisplay, X1LabelFormat, X1LabelRotate, getLabelStagger(), setLabelStagger() |
|
This property specifies the scale (logarithmic or linear) for the numeric X-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 (X1ScaleMin less than or equal to zero), the request for log scale is ignored. X1LogScale is automatically set to false (linear scale). |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Use logarithmic scale |
|
false= |
Use linear scale |
Default: |
false |
|
Syntax: |
setX1LogScale ( true | false ); |
|
|
boolean = getX1LogScale(); |
|
Example: |
perspective1.setMarkerSizeDefault(60); |
|
|
|
|
|
perspective1.setX1LogScale(false); |
|
|
|
|
Also See: |
getLogScale(), setLogScale() |
|
This property controls whether or not major grid lines are displayed on the numeric X-axis. The X-axis can have major and minor grid lines. In the default configuration, major grid lines are drawn and minor grid lines are not drawn. Use the X1MajorGridStep property to control the number of grid lines that are drawn when this property is enabled. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Draw major grid lines on the X-axis |
|
false= |
Do not draw major grid lines on the X-axis |
Default: |
true |
|
Syntax: |
setX1MajorGridDisplay ( true | false ); |
|
|
boolean = getX1MajorGridDisplay (); |
|
Example: |
perspective1.setMarkerSizeDefault(60); |
|
|
|
|
|
perspective1.setX1MajorGridDisplay(false); |
|
|
|
|
Also See: |
X1MajorGridStep, X1MajorGridStyle, X1MinorGridDisplay, X1MinorGridStyle |
|
This property can be used to control the number of major grid lines/steps that will be imaged on the X-axis of the chart. 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 be displayed. Assigning a value to this property will automatically set the X1MajorGridStepAuto property to false. |
Data Type: |
Double |
Range: |
Any Positive Number (See Notes) |
Default: |
15.0 |
Syntax: |
setX1MajorGridStep ( value ); |
|
value = getX1MajorGridStep(); |
Example: |
perspective1.setX1MajorGridStep(5.0); |
|
|
|
perspective1.setX1MajorGridStep(20.0); |
|
|
Notes: |
If the value assigned to X1MajorGridStep is negative or results in greater than 50 grid lines, the X1MajorGridStepAuto property is automatically set to true and the X1MajorGridStep value is ignored. |
Also See: |
X1MajorGridStepAuto, X1MinorGridStep, X1MinorGridStepAuto, getGridStep(), setGridStep(), getGridStepAuto(), setGridStepAuto() |
|
This property enables (true) / disables (false) automatic calculation of the number of major grid lines on the X-axis. When this property is set to true, the value assigned to X1MajorGridStep is ignored. Also see Notes below. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Automatically calculate the number of grid steps on the X-axis |
|
false= |
Use the value set by X1MajorGridStep |
Default: |
true |
|
Syntax: |
setX1MajorGridStepAuto ( true | false ); |
|
|
boolean = getX1MajorGridStepAuto (); |
|
Example: |
perspective1.setMarkerSizeDefault(60); |
|
|
|
|
|
perspective1.setX1MajorGridStepAuto(false); |
|
|
|
|
Notes: |
If the value assigned to X1MajorGridStep is negative or results in greater than 50 grid lines, the X1MajorGridStepAuto property is automatically set to true and the X1MajorGridStep value is ignored. |
|
Also See: |
X1MajorGridStep, X1MinorGridStep, X1MinorGridStepAuto, |
|
This property controls the appearance of major grid lines on the numeric X-axis of a chart. Grid lines can be small ticks at the base of the axis line or lines that extend to the height of the chart frame. Major grid lines are normally set to a different style than minor grid lines so that the user can distinguish between the two. |
|
Data Type: |
Integer |
|
Range: |
0...4 |
|
|
0= |
Normal grid lines, height of frame |
|
1= |
Normal grid lines extend beyond the height of frame |
|
2= |
Small tick marks from frame edge inward |
|
3= |
Small tick marks from frame edge outward |
|
4= |
Small tick marks span across the frame edge |
Default: |
Zero |
|
Syntax: |
setX1MajorGridStyle ( value ); |
|
|
value = getX1MajorGridStyle (); |
|
Example: |
perspective1.setY1MajorGridDisplay(false); |
|
|
|
|
|
perspective1.setX1MajorGridStyle(4); |
|
|
|
|
Also See: |
X1MajorGridDisplay, X1MinorGridDisplay, X1MinorGridStyle, |
|
This property enables (true) / disables (false) the display of minor grid lines on the X-axis. The X-axis can have major and minor grid lines. In the default configuration, major grid lines are drawn and minor grid lines are not drawn. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Draw minor grid lines on the X-axis |
|
false= |
Do not draw minor grid lines on the X-axis |
Default: |
false |
|
Syntax: |
setX1MinorGridDisplay ( true | false ); |
|
|
boolean = getX1MinorGridDisplay (); |
|
Example: |
perspective1.setMarkerSizeDefault(60); |
|
|
|
|
|
perspective1.setX1MinorGridDisplay(false); |
|
|
|
|
Also See: |
X1MajorGridDisplay, X1MinorGridStep, X1MinorGridStepAuto, X1MinorGridStyle, getGridStyle(), setGridStyle() |
|
This property sets a number of minor grid steps on the X-axis of the chart. Minor grid lines are drawn between the major grid lines (when they are displayed) and the location of the minor gridlines depend very much on the setting for the major grid lines. When a value is assigned to this property, the X1MinorGridStepAuto property is automatically set to false. If the value assigned to this property results in greater than 50 minor grid lines between each major grid line, the X1MinorGridStepAuto property is automatically set to true. |
Data Type: |
Double |
Range: |
Any Positive Number (See Note) |
Default: |
15.0 |
Syntax: |
setX1MinorGridStep ( value ); |
|
value = getX1MinorGridStep(); |
Example: |
perspective1.setGraphType(61); |
|
|
|
perspective1.setX1MinorGridStep(4); |
|
|
Notes: |
If X1MinorGridStep is set to a negative value or a value that results in greater than 50 minor grid lines between each major grid line, the X1MinorGridStepAuto property is automatically set to true. |
Also See: |
X1MinorGridStepAuto, X1MajorGridStep, X1MajorGridStepAuto, getGridStep(), setGridStep(), getGridStepAuto(), setGridStepAuto() |
|
This property enables/disables automatic grid steps for the X-axis minor grid lines. When this property is set to true, the value assigned to the X1MinorGridStep property is ignored. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Automatically calculated the number of grid lines on the X-axis |
|
false= |
Use the value set by X1MinorGridStep |
Default: |
true |
|
Syntax: |
setX1MinorGridStepAuto ( true | false ); |
|
|
boolean = getX1MinorGridStepAuto(); |
|
Example: |
perspective1.setX1MinorGridStyle(2); |
|
|
|
|
|
perspective1.setX1MinorGridStepAuto(false); |
|
|
|
|
Notes: |
If X1MinorGridStep is set to a negative value or a value that results in greater than 50 minor grid lines between each major grid line, the X1MinorGridStepAuto property is automatically set to true. |
|
Also See: |
X1MinorGridStep, X1MajorGridStep, X1MajorGridStepAuto, |
|
This property controls the appearance of minor grid lines on the numeric X-axis of a chart. Grid lines can be small ticks at the base of the axis line or lines that extend to the height of the chart frame. Minor grid lines are normally set to a different style than major grid lines so that the user can distinguish between the two. |
|
Data Type: |
Integer |
|
Range: |
0...4 |
|
|
0= |
Normal grid lines, height of frame |
|
1= |
Normal grid lines extend beyond the height of frame |
|
2= |
Small tick marks from frame edge inward |
|
3= |
Small tick marks from frame edge outward |
|
4= |
Small tick marks span across the frame edge |
Default: |
Zero (Normal Grid) |
|
Syntax: |
setX1MinorGridStyle ( value ); |
|
|
value = getX1MinorGridStyle(); |
|
Example: |
perspective1.setX1MinorGridStyle(2); |
|
|
|
|
|
perspective1.setX1MinorGridStyle(3); |
|
|
|
|
Also See: |
X1MinorGridDisplay, X1MinorGridStep, X1MinorGridStepAuto, X1MajorGridStyle, X1MajorGridDisplay, getGridStyle(), setGridStyle() |
|
|||
Data Type: |
Boolean |
||
Range: |
true / false |
||
|
true= |
Include Zero |
|
|
false= |
Exclude Zero if it is not within the given automatic scale range. |
|
Default: |
false |
||
Syntax: |
setX1MustIncludeZero ( true | false ); |
||
|
boolean = getX1MustIncludeZero(); |
||
Example: |
perspective1.setMarkerSizeDefault(60); |
||
|
|
||
|
perspective1.setX1MustIncludeZero(false); |
||
|
|
||
Also See: |
|
This property enables/disables the display of values that are out of range by clipping them to fit within the range. When this property is enabled (true), values smaller than or greater than a given range are represented as markers or risers at the scale limit (minimum or maximum). For example, a value of 700 goes beyond the specified range of 250-500, so its marker in a scatter chart would be displayed at the right edge of the chart. When this property is disabled (false), only values that fall directly between a given range are displayed (e.g. in the example above, the 700 marker would be omitted.) |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Display out-of-range values at scale limit (minimum or maximum) |
|
false= |
Only display values that fall between a given range |
Default: |
true |
|
Syntax: |
setX1OffScaleDisplay ( true | false ); |
|
|
boolean = getX1OffScaleDisplay (); |
|
Example: |
perspective1.setMarkerSizeDefault(60); |
|
|
|
|
|
perspective1.setX1OffScaleDisplay(false); |
|
|
|
|
Also See: |
|
This property specifies the maximum data value that can be used to image the graph and its axis. When a value is assigned to this property, the X1ScaleMaxAuto property is automatically set to false. |
Data Type: |
Double |
Range: |
Any value |
Default: |
100 |
Syntax: |
setX1ScaleMax ( value ); |
|
value = getX1ScaleMax(); |
Example: |
perspective1.setMarkerSizeDefault(60); |
|
|
|
perspective1.setX1ScaleMax(40.0); |
|
|
Notes: |
If X1ScaleMax is set to a value less than X1ScaleMin, the values will be automatically switched and the X1AxisDescending property will be set to true. |
Also See: |
X1ScaleMaxAuto, X1ScaleMin, X1ScaleMinAuto, getScaleMax(), setScaleMax(), getScaleMaxAuto(), setScaleMaxAuto() |
|
This property enables (true) / disables (false) use of the value assigned to the setX1ScaleMax property. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Automatically calculate maximum scale |
|
false= |
Use value set by X1ScaleMax |
Default: |
true |
|
Syntax: |
setX1ScaleMaxAuto ( true | false ); |
|
|
boolean = getX1ScaleMaxAuto (); |
|
Example: |
perspective1.setX1MinorGridStyle(2); |
|
|
|
|
|
perspective1.setX1ScaleMaxAuto(true); |
|
|
|
|
Also See: |
X1ScaleMax, X1ScaleMin, X1ScaleMinAuto, getScaleMax(), setScaleMax(), getScaleMaxAuto(), setScaleMaxAuto(), getX1ScaleMaxAutoValue() |
|
This property specifies the minimum data value that can be used to manually image the graph and its axis. When a value is assigned to this property, the X1ScaleMinAuto property is automatically set to false. |
Data Type: |
Double |
Range: |
Any number |
Default: |
0.0 |
Syntax: |
setX1ScaleMin ( value ); |
|
value = getX1ScaleMin(); |
Example: |
perspective1.setGraphType(61); |
|
|
|
perspective1.setX1ScaleMin(4); |
|
|
Notes: |
If X1ScaleMax is set to a value less than X1ScaleMin, the values will be automatically switched and the X1AxisDescending property will be set to true. |
Also See: |
X1ScaleMinAuto, X1ScaleMax, X1ScaleMaxAuto, getScaleMin(), setScaleMin(), getScaleMinAuto(), setScaleMinAuto() |
|
This property enables (true) /disables (false) automatic minimum scaling. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
automatically calculate minimum scale |
|
false= |
use the value set by X1ScaleMin |
Default: |
true |
|
Syntax: |
setX1ScaleMinAuto ( true | false ); |
|
|
boolean = getX1ScaleMinAuto (); |
|
Example: |
perspective1.setX1MinorGridStyle(2); |
|
|
|
|
|
perspective1.setX1ScaleMinAuto(true); |
|
|
|
|
Also See: |
X1ScaleMin, X1ScaleMax, X1ScaleMaxAuto, getScaleMin(), |
|
This property enables (true) /disables (false) automatic fitting of the X-axis title that is defined by the X1TitleString property and enabled for display by the X1TitleDisplay property. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Automatically fit/size X-axis title string |
|
false= |
Allow X-axis title string to be any size |
Default: |
true |
|
Syntax: |
setX1TitleAutofit ( true | false ); |
|
|
boolean = getX1TitleAutofit(); |
|
Example: |
perspective1.setGraphType(61); |
|
|
|
|
|
perspective1.setX1TitleAutofit(true); |
|
|
|
|
Also See: |
|
This property enables (true) /disables (false) drawing of X-axis title string that is defined by the X1TitleString property. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Draw X-axis title string defined by X1TitleString |
|
false= |
Do not draw X-axis title |
Default: |
false |
|
Syntax: |
setX1TitleDisplay ( true | false ); |
|
|
boolean = getX1TitleDisplay(); |
|
Example: |
perspective1.setGraphType(61); |
|
|
|
|
Notes: |
If the X1LabelDisplay property is set to false, the title string will not be drawn regardless of the X1TitleDisplay or X1TitleString property. |
|
Also See: |
|
This property can be used to define the title string for the X-axis in a chart. When a title string is assigned to this property, the X1TitleDisplay property is automatically set to true. |
Data Type: |
String |
Range: |
Any printable characters |
Default: |
Null string |
Syntax: |
setX1TitleString ( "String" ); |
|
String = getX1TitleString(); |
Example: |
perspective1.setGraphType(61); |
|
|
Notes: |
If the X1LabelDisplay property is set to false, the title string will not be drawn regardless of the X1TitleDisplay or X1TitleString property. |
Also See: |
|
This property enables/disables drawing of the zero line on the X-axis when zero is within the X1 axis scale range. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Draw zero line |
|
false= |
Do not draw zero line |
Default: |
false |
|
Syntax: |
setX1ZeroLineDisplay( true | false ); |
|
|
boolean = getX1ZeroLineDisplay (); |
|
Example: |
perspective1.setGraphType(61); |
|
|
|
|
|
perspective1.setX1ZeroLineDisplay(false); |
|
|
|
|
Also See: |