O1AxisLineDisplay

 

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.setY1MajorGridDisplay(false);
perspective1.setY1AxisLineDisplay(false);
perspective1.setO1MajorGridDisplay(false);
perspective1.setFrameDisplay(false);
perspective1.setO1AxisLineDisplay(true);

 

 

perspective1.setO1AxisLineDisplay(false);

 

Also See:

O1AxisSide, O1LabelDisplay, setAxisSide(), setLineWidth()

O1AxisSide

 

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.setY1MajorGridDisplay(false);
perspective1.setY1AxisLineDisplay(false);
perspective1.setO1MajorGridDisplay(false);
perspective1.setFrameDisplay(false);
perspective1.setO1AxisSide(1);

 

 

perspective1.setO1AxisSide(2);

 

Also See:

O1AxisLineDisplay, getAxisSide(), setAxisSide()

O1ExcludeMaxLabel

 

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.setY1MajorGridDisplay(false);
perspective1.setY1AxisLineDisplay(false);
perspective1.setO1MajorGridDisplay(false);
perspective1.setO1ExcludeMaxLabel(true);

 

 

perspective1.setO1ExcludeMaxLabel(false);

 

Also See:

O1ExcludeMinLabel, getExcludeMaxLabel(), setExcludeMaxLabel()

O1ExcludeMinLabel

 

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.setY1MajorGridDisplay(false);
perspective1.setY1AxisLineDisplay(false);
perspective1.setO1MajorGridDisplay(false);
perspective1.setO1ExcludeMinLabel(true);

 

 

perspective1.setO1ExcludeMinLabel(true);

 

Also See:

O1ExcludeMaxLabel, getExcludeMinLabel(), setExcludeMinLabel()

O1LabelAutofit

 

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.setFontSize(perspective1.getO1Label(),6);
perspective1.setO1LabelAutofit(true);

 

 

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

O1LabelAutoSkip

 

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);
perspective1.setO1LabelSkipCount(1);
perspective1.setY1MajorGridDisplay(false);
perspective1.setY1AxisLineDisplay(false);
perspective1.setO1MajorGridDisplay(false);
perspective1.setDepthRadius(0);
perspective1.setO1LabelAutoSkip(2);

 

Also See:

O1LabelSkipBegin, O1LabelSkipCount

O1LabelDisplay

 

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.setY1AxisLineDisplay(false);
perspective1.setO1MajorGridDisplay(false);
perspective1.setDepthRadius(0);
perspective1.setO1LabelDisplay(true);

 

 

perspective1.setO1LabelDisplay(false);

 

Also See:

O1LabelAutofit, O1AxisSide, O1LabelRotate, O1LabelStagger, O1LabelWrap

O1LabelMargin

 

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.setViewableGroups(4);
perspective1.setViewableSeries(5);
perspective1.setDataScrollerPresenceGroups(0);
perspective1.setO1LabelMargin(10);

 

 

perspective1.setO1LabelMargin(50);

 

O1LabelRotate

 

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.setDataScrollerPresenceGroups(0);
perspective1.setY1MajorGridDisplay(false);
perspective1.setY1AxisLineDisplay(false);
perspective1.setO1MajorGridDisplay(false);
perspective1.setDepthRadius(0);
perspective1.setLegendDisplay(false);
perspective1.setO1LabelRotate(2);

 

 

perspective1.setO1LabelRotate(1);

 

Also See:

O1AxisSide, O1LabelAutofit, O1LabelDisplay, O1LabelStagger, O1LabelWrap

O1LabelSkipBegin

 

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.setO1LabelAutoSkip(2);
perspective1.setY1MajorGridDisplay(false);
perspective1.setY1AxisLineDisplay(false);
perspective1.setO1MajorGridDisplay(false);
perspective1.setDepthRadius(0);
perspective1.setO1LabelSkipBegin(1);

 

 

perspective1.setO1LabelSkipCount(1);
perspective1.setO1LabelSkipBegin(0);

 

Also See:

O1LabelAutoSkip, O1LabelSkipCount

O1LabelSkipCount

 

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.setO1LabelAutoSkip(2);
perspective1.setY1MajorGridDisplay(false);
perspective1.setY1AxisLineDisplay(false);
perspective1.setO1MajorGridDisplay(false);
perspective1.setDepthRadius(0);
perspective1.setO1LabelSkipCount(1);

 

 

perspective1.setO1LabelSkipBegin(0);
perspective1.setO1LabelSkipCount(2);

 

Also See:

O1LabelAutoSkip, O1LabelSkipBegin

O1LabelStagger

 

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.setY1AxisLineDisplay(false);
perspective1.setO1MajorGridDisplay(false);
perspective1.setDepthRadius(0);
perspective1.setO1LabelStagger(true);

 

 

 

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

O1LabelWrap

 

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.setY1MajorGridDisplay(false);
perspective1.setY1AxisLineDisplay(false);
perspective1.setO1MajorGridDisplay(false);
perspective1.setO1LabelWrap(true);

 

 

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

O1MajorGridDisplay

 

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.setY1MajorGridDisplay(false);
perspective1.setY1AxisLineDisplay(false);
perspective1.setO1MajorGridDisplay(true);

 

 

perspective1.setO1MajorGridDisplay(false);

 

Also See:

O1AxisSide, O1MajorGridStyle, O1MinorGridDisplay, O1MinorGridStyle, getGridStyle(), setGridStyle()

 

 

O1MajorGridStyle

 

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.setY1MajorGridDisplay(false);
perspective1.setY1AxisLineDisplay(false);
perspective1.setLineWidth(perspective1.
    getO1MajorGrid(),4);
perspective1.setO1MajorGridStyle(3);

 

 

perspective1.setO1MajorGridStyle(4);

 

Also See:

O1AxisSide, O1MajorGridDisplay, O1MinorGridDisplay, O1MinorGridStyle, getGridStyle(), setGridStyle()

O1MinorGridCount

 

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.setY1MajorGridDisplay(false);
perspective1.setO1MajorGridStyle(4);
perspective1.setO1MinorGridDisplay(true);
perspective1.setLineWidth(
    perspective1.getO1MinorGrid(),4);
perspective1.setBorderColor(
    perspective1.getO1MinorGrid(),new Color(255,0,0));
perspective1.setO1MinorGridCount(2);

 

 

perspective1.setO1MinorGridCount(3);

 

Also See:

O1MinorGridDisplay, O1MinorGridStyle, getGridCount(), setGridCount()

O1MinorGridDisplay

 

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.setY1MajorGridDisplay(false);
perspective1.setO1MajorGridStyle(4);
perspective1.setLineWidth(
    perspective1.getO1MinorGrid(),4);
perspective1.setBorderColor(
    perspective1.getO1MinorGrid(),new Color(255,0,0));
perspective1.setO1MinorGridCount(2);
perspective1.setO1MinorGridDisplay(true);

 

 

perspective1.setO1MinorGridDisplay(false);

 

Also See:

O1AxisSide, O1MajorGridDisplay, O1MajorGridStyle, O1MinorGridStyle

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.setY1MajorGridDisplay(false);
perspective1.setO1MajorGridStyle(0);
perspective1.setO1MinorGridDisplay(true);
perspective1.setLineWidth(perspective1.
    getO1MinorGrid(),4);
perspective1.setBorderColor(perspective1.
    getO1MinorGrid(),new Color(0,255,0));
perspective1.setO1MinorGridStyle(3);

 

 

perspective1.setO1MinorGridStyle(1);

 

Also See:

O1AxisSide, O1MajorGridDisplay, O1MajorGridStyle, O1MinorGridDisplay, getGridStyle(), setGridStyle()

O1TitleAutofit

 

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.setLegendDisplay(false);
perspective1.setO1TitleString(
    "This is the O1/Group Axis");
perspective1.setFontSize(perspective1.getO1Title(),8);
perspective1.setO1TitleDisplay(true);
perspective1.setO1TitleAutofit(true);

 

 

perspective1.setO1TitleAutofit(false);

 

Also See:

O1AxisSide, O1LabelDisplay, O1TitleDisplay, O1TitleString,
setFontSizeVC()

O1TitleDisplay

 

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.setLegendDisplay(false);
perspective1.setO1TitleString(
    "This is the O1/Group Axis");
perspective1.setFontSize(perspective1.getO1Title(),8);
perspective1.setO1TitleAutofit(false);
perspective1.setO1TitleDisplay(true);

 

 

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:

O1AxisSide, O1LabelDisplay, O1TitleAutofit, O1TitleString

O1TitleString

 

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);
perspective1.setLegendDisplay(false);
perspective1.setO1TitleString("This is the O1/Group Axis");
perspective1.setTitleDisplay(true);
perspective1.setFontSize(perspective1.getO1Title(),8);
perspective1.setO1TitleAutofit(true);

 

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:

O1AxisSide, O1LabelDisplay, O1TitleAutofit, O1TitleDisplay