|
This property enables/disables drawing of the O1 axis line. The value assigned to O1AxisSide determines the location of the O1 axis line. The O1 axis line is typically displayed on the bottom of a vertical chart or on the left side of a horizontal chart. The O1AxisSide property may be used to change the location of the O1 axis line. Because the O1 axis base line is typically at the base or side of the chart frame, the line may not be visible even when this property is enabled. To make the O1 axis line wider and, therefore, more visible, use the getO1AxisLine() method to get the object ID of the line and the setLineWidth() method define the width of the line. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Draw O1-axis base line |
|
false= |
Do not draw O1-axis line |
Default: |
true |
|
Syntax: |
setO1AxisLineDisplay ( true | false ); |
|
|
boolean = getO1AxisLineDisplay(); |
|
Example: |
perspective1.setDepthRadius(0); |
|
|
|
|
|
perspective1.setO1AxisLineDisplay(false); |
|
|
|
|
Also See: |
|
This property controls which side of the graph the primary ordinal (O1) axis will be imaged. It also determines where axis labels will be drawn when the O1LabelDisplay property is set to true. The primary ordinal axis is typically imaged at the bottom of the chart in vertical charts and on the left side of the chart in horizontal charts. This property lets you image the axis at the top of the chart, top and bottom of the chart, right side of the chart, or both sides of the chart. |
|
Data Type: |
Integer |
|
Range: |
0...2 |
|
|
0= |
Vertical: Bottom / Horizontal: Left |
|
1= |
Vertical: Top / Horizontal: Right |
|
2= |
Vertical: Top and Bottom / Horizontal: Right and Left |
Default: |
0 (bottom/left) |
|
Syntax: |
setO1AxisSide ( value ); |
|
|
value = getO1AxisSide(); |
|
Example: |
perspective1.setDepthRadius(0); |
|
|
|
|
|
perspective1.setO1AxisSide(2); |
|
|
|
|
Also See: |
|
This property enables (true) / disables (false) drawing of the maximum label on the primary ordinal (O1) axis. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Exclude the maximum label on the O1-axis |
|
false= |
Include the maximum label on the O1-axis |
Default: |
false |
|
Syntax: |
setO1ExcludeMaxLabel ( true | false ); |
|
|
boolean = getO1ExcludeMaxLabel (); |
|
Example: |
perspective1.setDepthRadius(0); |
|
|
|
|
|
perspective1.setO1ExcludeMaxLabel(false); |
|
|
|
|
Also See: |
O1ExcludeMinLabel, getExcludeMaxLabel(), setExcludeMaxLabel() |
|
This property enables (true) / disables (false) drawing of the minimum label on the primary ordinal (O1) axis. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Exclude the minimum label on the O1-axis |
|
false= |
Include the minimum label |
Default: |
false |
|
Syntax: |
setO1ExcludeMinLabel ( true | false ); |
|
|
boolean = getO1ExcludeMinLabel (); |
|
Example: |
perspective1.setDepthRadius(0); |
|
|
|
|
|
perspective1.setO1ExcludeMinLabel(true); |
|
|
|
|
Also See: |
O1ExcludeMaxLabel, getExcludeMinLabel(), setExcludeMinLabel() |
|
This property is used to automatically fit/size all text labels on the primary ordinal (O1) axis. When auto-fitting 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. The TextAutofitMax and TextAutofitMin properties define the maximum and minimum size (in virtual coordinates) that can be used to auto-fit/size the label when this property is enabled. When auto-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= |
Automatically fit and size labels on the O1-axis |
|
false= |
Do not automatically fit and size labels |
Default: |
true |
|
Syntax: |
setO1LabelAutofit ( true | false ); |
|
|
boolean = getO1LabelAutofit (); |
|
Example: |
perspective1.setDepthRadius(0); |
|
|
|
|
|
perspective1.setO1LabelAutofit(false); |
|
|
|
|
Notes: |
Labels can overlap each other when the font size is too large and O1LabelAutofit is disabled. If you want to use a larger font size but do not want the labels to overlap, use O1LabelRotate, O1LabelStagger, or O1LabelWrap to change the labels so that they don't overlap. |
|
Also See: |
O1LabelDisplay, O1LabelRotate, O1LabelStagger, O1LabelWrap, TextAutofitMax, TextAutofitMin |
|
This property sets or disables label skip for labels on the O1 axis. If this property is set to manual skip (2), use the O1LabelSkipBegin property to define the first label to skip and O1LabelSkipCount to define the skip interval. If this property is set to automatic (1), Perspective will automatically omit labels at regular intervals when the chart size is reduced in order to maintain a reasonable, readable font size (8 point or larger). |
|
Data Type: |
Integer |
|
Range: |
0...2 |
|
|
0= |
No skipping |
|
1= |
Automatic Skip |
|
2= |
Manual Skip |
Default: |
Zero (No Skipping) |
|
Syntax: |
setO1LabelAutoSkip ( value ); |
|
|
value = getO1LabelAutoSkip); |
|
Example: |
perspective1.setO1LabelSkipBegin(1); |
|
|
|
|
Also See: |
|
This property enables/disables the display of labels and the title on the O1 axis. O1AxisSide defines the location where labels are displayed. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Display labels on the O1-axis |
|
false= |
Do not display labels |
Default: |
true |
|
Syntax: |
setO1LabelDisplay ( true | false ); |
|
|
boolean = getO1LabelDisplay (); |
|
Example: |
perspective1.setY1MajorGridDisplay(false); |
|
|
|
|
|
perspective1.setO1LabelDisplay(false); |
|
|
|
|
Also See: |
O1LabelAutofit, O1AxisSide, O1LabelRotate, O1LabelStagger, O1LabelWrap |
|
This property selects the percentage (0...100) of the label width that will be used as margin between labels on the O1 axis. |
Data Type: |
Integer |
Range: |
0...100 |
Default: |
Zero |
Syntax: |
setO1LabelMargin( value ); |
|
value = getO1LabelMargin(); |
Example: |
perspective1.setDepthRadius(0); |
|
|
|
perspective1.setO1LabelMargin(50); |
|
|
|
This property selects an angle at which labels on the primary ordinal (O1) axis are rotated. |
|
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 |
|
Syntax: |
setO1LabelRotate ( value ); |
|
|
value = getO1LabelRotate(); |
|
Example: |
perspective1.setViewableGroups(3); |
|
|
|
|
|
perspective1.setO1LabelRotate(1); |
|
|
|
|
Also See: |
O1AxisSide, O1LabelAutofit, O1LabelDisplay, O1LabelStagger, O1LabelWrap |
|
When O1LabelAutoSkip is set to two (manual), this property defines the first label on the O1-Axis to be omitted. Use the O1LabelSkipCount property to define the label skip interval. |
Data Type: |
Integer |
Range: |
Zero to number of groups in graph |
Default: |
Zero |
Syntax: |
setO1LabelSkipBegin ( value ); |
|
value = getO1LabelSkipBegin(); |
Example: |
perspective1.setO1LabelSkipCount(1); |
|
|
|
perspective1.setO1LabelSkipCount(1); |
|
|
Also See: |
|
When O1LabelAutoSkip is set to manual (2), this property defines the label skip interval. Use O1LabelSkipBegin to define the first label to be omitted. |
Data Type: |
Integer |
Range: |
Zero to number of groups in graph |
Default: |
Zero |
Syntax: |
setO1LabelSkipCount ( value ); |
|
value = getO1LabelSkipCount(); |
Example: |
perspective1.setO1LabelSkipBegin(1); |
|
|
|
perspective1.setO1LabelSkipBegin(0); |
|
|
Also See: |
|
This property enables/disables staggered labels on the O1 axis. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Stagger labels on the O1-axis |
|
false= |
Do not stagger labels |
Default: |
false |
|
Syntax: |
setO1LabelStagger ( true | false ); |
|
|
boolean = getO1LabelStagger (); |
|
Example: |
perspective1.setY1MajorGridDisplay(false); |
|
|
|
|
|
perspective1.setO1LabelStagger(false); |
|
|
|
|
Notes: |
This property only applies to 2D graphs, staggered labels are not supported in 3D graphs. |
|
Also See: |
O1AxisSide, O1LabelAutofit, O1LabelDisplay, O1LabelRotate, O1LabelWrap, getLabelStagger(), setLabelStagger() |
|
This property controls whether header labels on the primary ordinal (O1) axis will be drawn on more than one line. When label wrapping is enabled, the charting engine will look for space characters in the label string and draw the label on multiple lines at space character boundaries. When label wrapping is disabled, the label string will always be drawn on a single line. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Wrap labels on the O1-axis |
|
false= |
Draw labels on a single line |
Default: |
false |
|
Syntax: |
setO1LabelWrap( true | false ); |
|
|
boolean = getO1LabelWrap (); |
|
Example: |
perspective1.setDepthRadius(0); |
|
|
|
|
|
perspective1.setO1LabelWrap(false); |
|
|
|
|
Notes: |
If a "\n" is encountered in the label string, the string will be wrapped even if this property is disabled (setO1LabelWrap(false);). |
|
Also See: |
O1AxisSide, O1LabelAutofit, O1LabelDisplay, O1LabelRotate, O1LabelStagger |
|
This property enables (true) / disables (false) the display of major grid lines on the primary ordinal (O1) axis grid (i.e., lines attached to a text-based axis, like the "bottom" axis of a bar graph). The O1AxisSide property determines the location where grids/ticks are displayed. Use O1MajorGridStyle to define the style of major grid lines. The primary ordinal axis can have major and minor grid lines. In the default configuration, major grid lines are drawn and minor grid lines are not. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Draw major grid lines on the O1-axis |
|
false= |
Do not draw major grid lines |
Default: |
true |
|
Syntax: |
setO1MajorGridDisplay ( true | false ); |
|
|
boolean = getO1MajorGridDisplay (); |
|
Example: |
perspective1.setDepthRadius(0); |
|
|
|
|
|
perspective1.setO1MajorGridDisplay(false); |
|
|
|
|
Also See: |
O1AxisSide, O1MajorGridStyle, O1MinorGridDisplay, O1MinorGridStyle, getGridStyle(), setGridStyle() |
|
|
|
This property controls the style of major grid lines that are shown on the primary ordinal (O1) axis (i.e., lines attached to a text-based axis, like the "bottom" axis of a bar graph). The primary ordinal axis can have major and minor grid lines. Different styles should be selected for major and minor grid lines so 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 lines) |
|
Syntax: |
setO1MajorGridStyle ( value ); |
|
value = getO1MajorGridStyle(); |
||
Example: |
perspective1.setDepthRadius(0); |
|
|
||
perspective1.setO1MajorGridStyle(4); |
||
|
||
Also See: |
O1AxisSide, O1MajorGridDisplay, O1MinorGridDisplay, O1MinorGridStyle, getGridStyle(), setGridStyle() |
|
This property controls the number of minor grid lines between the major grid lines on the O1 axis. |
Data Type: |
Integer |
Range: |
1...50 |
Default: |
1 |
Syntax: |
setO1MinorGridCount ( value ); |
|
value = getO1MinorGridCount (); |
Example: |
perspective1.setDepthRadius(0); |
|
|
|
perspective1.setO1MinorGridCount(3); |
|
|
Also See: |
O1MinorGridDisplay, O1MinorGridStyle, getGridCount(), setGridCount() |
|
This property enables (true) / disables (false) the display of minor grid lines on the primary ordinal (O1) axis grid (i.e., lines attached to a text-based axis, like the "bottom" axis of a bar graph). Use O1MinorGridStyle to define the style of minor grid lines. The primary ordinal axis can have major and minor grid lines. In the default configuration, major grid lines are drawn and minor grid lines are not. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Draw minor grid lines on the O1-axis |
|
false= |
Do not draw minor grid lines |
Default: |
false |
|
Syntax: |
setO1MinorGridDisplay ( true | false ); |
|
|
boolean = getO1MinorGridDisplay (); |
|
Example: |
perspective1.setDepthRadius(0); |
|
|
|
|
|
perspective1.setO1MinorGridDisplay(false); |
|
|
|
|
Also See: |
O1AxisSide, O1MajorGridDisplay, O1MajorGridStyle, O1MinorGridStyle |
|
This property controls the style of the minor grid lines on the primary ordinal (O1) axis. The primary ordinal axis can have major and minor grid lines. Different styles should be selected for major and minor grid lines so 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 lines) |
|
Syntax: |
setO1MinorGridStyle ( value ); |
|
|
value = getO1MinorGridStyle (); |
|
Example: |
perspective1.setDepthRadius(0); |
|
|
|
|
|
perspective1.setO1MinorGridStyle(1); |
|
|
|
|
Also See: |
O1AxisSide, O1MajorGridDisplay, O1MajorGridStyle, O1MinorGridDisplay, getGridStyle(), setGridStyle() |
|
This property enables/disables automatic fitting and sizing of the O1 axis title.. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Automatically fit and size the O1-Axis title string |
|
false= |
Do not automatically fit and size the title string |
Default: |
true |
|
Syntax: |
setO1TitleAutofit ( true | false ); |
|
|
boolean = getO1TitleAutofit (); |
|
Example: |
perspective1.setDepthRadius(0); |
|
|
|
|
|
perspective1.setO1TitleAutofit(false); |
|
|
|
|
Also See: |
O1AxisSide, O1LabelDisplay, O1TitleDisplay, O1TitleString, |
|
This property determines whether or not the string of characters assigned to the O1TitleString property is displayed in the graph. Note that the O1LabelDisplay property MUST also be set to true in order for the axis title to be displayed. |
|
Data Type: |
Boolean |
|
Range: |
true / false |
|
|
true= |
Draw O1-axis title |
|
false= |
Do not draw title |
Default: |
false |
|
Syntax: |
setO1TitleDisplay ( true | false ); |
|
|
boolean = getO1TitleDisplay (); |
|
Example: |
perspective1.setDepthRadius(0); |
|
|
|
|
|
perspective1.setO1TitleDisplay(false); |
|
|
|
|
Notes: |
If O1LabelDisplay is false, the O1-axis title will not be drawn regardless of the O1TitleDisplay or O1TitleString properties. |
|
Also See: |
|
This property defines the O1-axis title string displayed by the O1TitleDisplay property. |
Data Type: |
String |
Range: |
Any printable characters |
Default: |
null string |
Syntax: |
setO1TitleString ( string ); |
|
string = getO1TitleString(); |
Example: |
perspective1.setDepthRadius(0); |
|
|
Notes: |
The O1AxisSide property determines where the O1TitleString is drawn in chart. Also note that setting any string to O1TitleString will automatically set O1TitleDisplay to true. |
Also See: |