ScaleFromZero

 

In applications where the data range can include negative numbers, this property determines whether the risers will be drawn pointing up and down from a zero line or whether all risers will draw straight up from the "bottom" of the graph. It affects risers on 3D graphs and all 2D graphs except Pies charts.

Data Type:

Boolean

Range:

true / false

 

true=

Draw from the zero line

 

false=

Draw from the base of the frame

Default:

true

Syntax:

setScaleFromZero ( true | false );

 

boolean = getScaleFromZero();

Example:

perspective1.setY1MajorGridStep(20.0);
perspective1.setScaleFromZero(true);
perspective1.setY1ScaleMax(80.0);
perspective1.setY1ScaleMaxAuto(false);
perspective1.setY1ScaleMin(-40.0);
perspective1.setY1ScaleMinAuto(false);
perspective1.setDepthRadius(0);

 

 

perspective1.setScaleFromZero(false);

 

 

 

ScrollOffsetGroup

 

When the ViewableGroups property is set to a value greater than zero, this property selects the first group to be displayed in the graph.

Data Type:

Integer

Range:

Zero to the number of viewable groups in chart

Default:

Zero

Syntax:

setScrollOffsetGroup ( value );

 

value = getScrollOffsetGroup();

Example:

perspective1.setViewableGroups(5);
perspective1.setScrollOffsetGroup(1);
perspective1.setDataScrollerPresenceGroups(0);
perspective1.setDepthRadius(0);

 

 

perspective1.setViewableGroups(2);
perspective1.setScrollOffsetGroup(4);

 

 

Notes:

1.

This property will only function if ViewableGroups is set to a value greater than zero.

 

2.

The DataScrollerPresenceGroups property can be used to display a data scrolling bar on the group axis. The data scrolling bar can be used to adjust the ScrollOffsetGroups via the user interface.

Also See:

DataScrollerPresenceGroups, ViewableGroups, ScrollOffsetSeries

ScrollOffsetSeries

 

When ViewableSeries is set to a value greater than zero, this property selects the first series to be displayed in the graph.

Data Type:

Integer

Range:

Zero to the number of viewable series in chart

Default:

Zero

Syntax:

setScrollOffsetSeries ( value );

 

value = getScrollOffsetSeries();

Example:

perspective1.setViewableSeries(4);
perspective1.setViewableGroups(2);
perspective1.setDepthRadius(0);
perspective1.setDataScrollerPresenceGroups(0);
perspective1.setScrollOffsetSeries(1);

 

 

perspective1.setViewableSeries(2);
perspective1.setScrollOffsetSeries(2);

 

 

Since there are only five series in the data that defines this graph, setViewableSeries(3) and setScrollOffsetSeries(3) results in only two series remaining in the chart.

Notes:

1.

This property will only function if ViewableSeries is set to a value greater than zero.

 

2.

The DataScrollerPresenceSeries property can be used to display a data scrolling bar for the series. The data scrolling bar can be used to adjust the ScrollOffsetSeries via the user interface.

Also See:

DataScrollerPresenceSeries, ViewableSeries, ScrollOffsetGroup

SelectionEnable

 

This property defines the user's ability to select objects in a chart and the operations that can be performed when one or more objects are selected.

 

When setSelectionEnable(1) is used, the user can select individual objects (risers, markers, labels, etc.) in a chart. The charting engine highlights each object that is selected.

 

When setSelectionEnable(2) is used, the user can only select data-related objects (bars, legends, etc.). The charting engine will highlight the selected data objects and all related objects.

 

When setSelectionEnable(3) is used, the user cannot select individual objects. When one object is selected, all related objects will also be selected and highlighted.

 

When setSelectionEnable(4) is used, the user can click on a single point and have the chart zoom at the rate of 50% on both axes with the selected point used as the center of the zoom rectangle.

 

When setSelectionEnable(5) is used, it allows the user to drag out a rectangle and drill-down on the data within the rectangle area. When this mode is used, a single mouse click will back up one data-zoom level or drill-down. Double click will restore the original un-zoomed data state.

Data Type:

Integer

Range:

0...5

 

0=

No Selection

 

1=

Select a single element, only one object is highlighted

 

2=

Select only data related objects (bar, legend) and select all related objects when clicking on one

 

3=

Select all related objects when one is clicked

 

4=

Select 50% data zooming on user-selected object

 

5=

Select drill-down/data zooming mode

Default:

3

Syntax:

setSelectionEnable ( value );

 

value = getSelectionEnable();

Also See:

SelectionEnableMove

SelectionEnableMove

 

This property enables (true) / disables (false) the users ability to select and move individual moveable objects (title, subtitle, footnote, chart frame, and legend box) in a chart.

Data Type:

Boolean

Range:

true / false

 

true=

User can select and move objects

 

false=

Objects can be selected but not moved

Default:

true

Syntax:

setSelectionEnableMove ( true | false );

 

boolean = getSelectionEnableMove();

Also See:

SelectionEnable

SeriesAreRows

 

When this property is enabled (true), series values are stored as rows. When it is disabled (false), series values are stored as columns.

Data Type:

Boolean

Range:

true / false

 

true=

Series are stored as rows

 

false=

Series are stored as columns

Default:

true

Syntax:

setSeriesAreRows ( true | false );

 

boolean = setSeriesAreRows();

Example:

perspective1.setDepthAngle(0);
perspective1.setSeriesAreRows(true);
perspective1.setDepthRadius(0);

 

 

perspective1.setSeriesAreRows(false);

 

Also See:

ReverseSeries, ReverseGroups

SeriesDefaultBorderColor

 

This property sets the default color to use for riser edges when the UseSeriesBorderDefaults property is enabled. This property is only used when UseSeriesBorderDefaults is enabled (true). When UseSeriesBorderDefaults is disabled (false), this property is ignored.

Data Type:

color

Range:

any java color value

Default:

black

Syntax:

setSeriesDefaultBorderColor ( new Color );

 

color = setSeriesDefaultBorderColor();

Example:

perspective1.setUseSeriesBorderDefaults(true);
perspective1.setSeriesDefaultBorderColor(
    new java.awt.Color(8388863));

 

 

perspective1.setUseSeriesBorderDefaults(true);
perspective1.setSeriesDefaultBorderColor(
    new java.awt.Color(16711808));

 

Also See:

SeriesDefaultTransparentBorderColor, UseSeriesBorderDefaults

 

 

SeriesDefaultTransparentBorderColor

 

When UseSeriesBorderDefaults is enabled, this property enables/disables the use of a transparent border color around the edges of risers. This property is only used when UseSeriesBorderDefaults is enabled (true). When UseSeriesBorderDefaults is disabled (false), this property is ignored.

Data Type:

boolean

Range:

true / false

 

true=

Use transparent edges around risers

 

false=

Use the color assigned to SeriesDefaultBorderColor

Default:

true

Syntax:

setSeriesDefaultTransparentBorderColor ( new Color );

 

color = setSeriesDefaultTransparentBorderColor();

Example:

perspective1.setUseSeriesBorderDefaults(true);
perspective1.setSeriesDefaultTransparentBorderColor(true);

 

Also See:

SeriesDefaultBorderColor, UseSeriesBorderDefaults

   

SeriesLooping

 

This property is used to select the interval at which series color values are repeated. The default setting (32) defines different colors from the first 32 series (0...31). Starting with series 32, the colors are repeated (i.e., series 32...64 have the same colors and 0...31, respectively).

Data Type:

Integer

Range:

1...number of series in data that defines the graph. 1=All series will have the same color.

Default:

32 (start repeating the defined series color at series 31)

Syntax:

setSeriesLooping( value );

 

value = getSeriesLooping();

Example:

perspective1.setViewableGroups(4);
perspective1.setViewableSeries(4);
perspective1.setDepthRadius(0);
perspective1.setDataScrollerPresenceGroups(0);
perspective1.setSeriesLooping(3);

 

 

perspective1.setSeriesLooping(2);

 

 

 

ShadowXOffsetDefault

 

This property sets the default value for the X-Offset of a drop shadow.

Data Type:

Integer

Range:

-20...20

Default:

2

Syntax:

setShadowXOffsetDefault ( value );

 

value = getShadowXOffsetDefault();

Also See:

getShadowColor(), getShadowDisplay(), getShadowXOffset(), getShadowYOffset(), setShadowColor(), setShadowDisplay(), setShadowXOffset(), setShadowYOffset()

 

 

ShadowYOffsetDefault

 

This property sets the default value for the Y-Offset of a drop shadow..

Data Type:

Integer

Range:

-20...20

Default:

2

Syntax:

setShadowYOffsetDefault ( value );

 

value = getShadowYOffsetDefault();

Also See:

getShadowColor(), getShadowDisplay(), getShadowXOffset(), getShadowYOffset(), setShadowColor(), setShadowDisplay(), setShadowXOffset(), setShadowYOffset()

 

 

SquareMarkers

 

This property enables (true) / disables (false) square markers in the legend area. If different marker shapes (circle, plus, triangle, etc.) are used for each series by UseSeriesShapes, the marker shape will be redrawn within a square rectangle area. The legend marker position must not be set for the legend labels to appear on of the legend markers.

Data Type:

Boolean

Range:

true / false

 

true=

Force markers to be square

 

false=

Markers do not need to be square

Default:

true

Syntax:

setSquareMarkers ( true | false );

 

boolean = getSquareMarkers();

Example:

perspective1.setGraphType(61);
perspective1.setSquareMarkers(true);

 

 

perspective1.setSquareMarkers(false);

 

Notes:

This property is ignored if LegendMarkerPosition(4) is used.

Also See:

LegendMarkerPosition, UseSeriesShapes

StackedDataValueSum

 

When a stacked chart type is selected and data text is displayed with DataTextDisplay set to true, the value assigned to this property determines how data values are displayed. When StackedDataValueSum is false, the values reflecting individual segments of the risers are displayed. When StackedDataValueSum is true, cummulative sums of riser segments are displayed. .

Data Type:

Boolean

Range:

true / false

 

true=

Show sums

 

false=

Show individual value

Default:

true

Syntax:

setStackedDataValueSum ( true | false );

 

boolean = getStackedDataValueSum();

Example:

perspective1.setDataTextDisplay(true);
perspective1.setDepthAngle(0);
perspective1.setViewableSeries(4);
perspective1.setStackedDataValueSum(false);
perspective1.setGraphType(18);
perspective1.setViewableGroups(3);
perspective1.setDepthRadius(0);

 

 

perspective1.setStackedDataValueSum(true);

 

Also See:

DataTextDisplay

Stock52WeekHighDisplay

 

This property enables (true) / disables (false) the display of a 52-week high line in a stock chart. The GraphType property must be set to one of the stock charts (73...83). However, note that a 52-week high line is not available in bi-polar stock charts. The Stock52WeekHighValue property must define the 52-week high value.

Data Type:

Boolean

Range:

true / false

 

true=

Draw 52-week high line

 

false=

Do not draw 52-week high line

Default:

false

Syntax:

setStock52WeekHighDisplay ( true | false );

 

boolean = getStock52WeekHighDisplay();

Example:

perspective1.setGraphType(73);
perspective1.setStock52WeekHighDisplay(true);

 

 

perspective1.setStock52WeekHighDisplay(false);

 

Also See:

Stock52WeekHighValue, Stock52WeekLowValue, Stock52WeekLowDisplay

Stock52WeekHighValue

 

This property is used to set a 52-week high value in a stock chart. The GraphType property must be set to one of the stock charts (73...83). However, note that a 52-week high line is not available in bi-polar stock charts. The Stock52WeekHighDisplay property must be set to true in order to display a line in the chart identifying the 52-week high value. Only one line per chart is available..

Data Type:

double

Range:

Any value that falls within the data range of the chart.

Default:

40.0

Syntax:

setStock52WeekHighValue ( value );

 

value = getStock52WeekHighValue();

Example:

perspective1.setGraphType(73);
perspective1.setStock52WeekHighValue(20.0);
perspective1.setStock52WeekHighDisplay(true);

 

 

perspective1.setStock52WeekHighValue(60.0);

 

Also See:

Stock52WeekHighDisplay

Stock52WeekLowDisplay

 

This property enables (true) / disables (false) the display of a 52-week low line in a stock chart. The GraphType property must be set to one of the stock charts (73...83). However, note that a 52-week low line is not available in bi-polar stock charts. The Stock52WeekLowValue property must define the 52-week low value. Only one line per chart is available.

Data Type:

Boolean

Range:

true / false

 

true=

Draw 52-week low line

 

false=

Do not draw 52-week low line

Default:

false

Syntax:

setStock52WeekLowDisplay ( true | false );

 

boolean = getStock52WeekLowDisplay();

Example:

perspective1.setGraphType(73);
perspective1.setStock52WeekHighDisplay(true);
perspective1.setStock52WeekLowDisplay(true);

 

 

perspective1.setStock52WeekLowDisplay(false);

 

Also See:

Stock52WeekLowValue, Stock52WeekHighValue, Stock52WeekHighDisplay

Stock52WeekLowValue

 

This property is used to set a 52-week low value in a stock chart. The GraphType property must be set to one of the stock charts (73...83). However note that a 52-week low line is not available for bi-polar stock charts. The Stock52WeekLowDisplay property must be set to true in order to display a line in the chart identifying the 52-week low value. Only one line per chart is available..

Data Type:

double

Range:

Any double number within the data range of the chart

Default:

10.0

Syntax:

setStock52WeekLowValue ( value );

 

value = getStock52WeekLowValue();

Example:

perspective1.setStock52WeekLowValue(20.0);
perspective1.setGraphType(73);
perspective1.setStock52WeekHighDisplay(true);
perspective1.setStock52WeekLowDisplay(true);

 

 

perspective1.setStock52WeekLowValue(30.0);

 

Also See:

Stock52WeekLowDisplay

StockCloseSplitDisplay

 

This property enables (true) / disables (false) the display of split risers at the stock close value. The GraphType property must be set to one of the stock charts (73...83). If a close value is not available, this property is ignored..

Data Type:

Boolean

Range:

true / false

 

true=

Split risers at close value

 

false=

Do not split risers at close value

Default:

true

Syntax:

setStockCloseSplitDisplay ( true | false );

 

boolean = getStockCloseSplitDisplay();

Example:

perspective1.setGraphType(76);
perspective1.setStockCloseSplitDisplay(true);

 

 

perspective1.setStockCloseSplitDisplay(false);

 

Also See:

StockCloseTicksDisplay, StockOpenTicksDisplay

StockCloseTicksDisplay

 

This property enables (true) / disables (false) the tick marks at the stock close value. The GraphType property must be set to one of the stock charts (73...83). If a close value is not available, this property is ignored. The StockTickLength property determines the size of the tick marks..

Data Type:

Boolean

Range:

true / false

 

true=

Display close value tick marks

 

false=

Do not display close value tick marks

Default:

true

Syntax:

setStockCloseTicksDisplay ( true | false );

 

boolean = getStockCloseTicksDisplay();

Example:

perspective1.setGraphType(76);
perspective1.setStockCloseTicksDisplay(true);

 

 

perspective1.setStockCloseTicksDisplay(false);

 

Also See:

StockCloseSplitDisplay, StockOpenTicksDisplay, StockTickLength

StockMovingAverageDisplay

 

This property enables (true) / disables (false) the display of a moving average line in a stock chart. The GraphType property must be set to one of the stock charts (73...83)..

Data Type:

Boolean

Range:

true / false

 

true=

Draw moving average line

 

false=

Do not draw moving average line

Default:

false

Syntax:

setStockMovingAverageDisplay ( true | false );

 

boolean = getStockMovingAverageDisplay();

Example:

perspective1.setGraphType(76);
perspective1.setStockMovingAverageDisplay(true);

 

 

perspective1.setStockMovingAverageDisplay(false);

 

Also See:

Stock52WeekHighDisplay, Stock52WeekLowDisplay, StockCloseSplitDisplay, StockCloseTicksDisplay, StockOpenTicksDisplay, setLineWidth()

StockOpenTicksDisplay

 

This property enables (true) / disables (false) the tick marks at the stock open values. The GraphType property must be set to one of the stock charts (73...83). If an open value is not available, this property is ignored. the StockTickLength property determines the size of the tick marks..

Data Type:

Boolean

Range:

true / false

 

true=

Display open value tick marks

 

false=

Do not draw open value tick marks

Default:

true

Syntax:

setStockOpenTicksDisplay ( true | false );

 

boolean = getStockOpenTicksDisplay();

Example:

perspective1.setViewableGroupsStock(6);
perspective1.setDataScrollerPresenceGroups(0);
perspective1.setGraphType(79);
perspective1.setStockOpenTicksDisplay(true);

 

 

perspective1.setStockOpenTicksDisplay(false);

 

Also See:

StockCloseTicksDisplay, StockTickLength

StockTickLength

 

This property determines the length of tick marks in a stock chart. The GraphType property must be set to one of the stock charts (73...83). The StockCloseTicksDisplay and/or StockOpenTicksDisplay property must be enabled (true). If close and/or open values are not available, the tick mark(s) will not be displayed..

Data Type:

Integer

Range:

0...100

Default:

50

Syntax:

setStockTickLength ( value );

 

value = getStockTickLength();

Example:

perspective1.setViewableSeries(12);
perspective1.setViewableGroupsStock(6);
perspective1.setDataScrollerPresenceGroups(0);
perspective1.setGraphType(79);
perspective1.setStockCloseTicksDisplay(false);
perspective1.setStockTickLength(10);
perspective1.setViewableSeriesStock(8);

 

 

perspective1.setStockTickLength(100);

 

Also See:

StockCloseTicksDisplay, StockOpenTicksDisplay

SubtitleAutofit

 

This property enables (true) / disables (false) automatic fitting of the subtitle string that is defined by the SubtitleString property and enabled for display by the SubtitleDisplay property.

Data Type:

Boolean

Range:

true / false

 

true=

automatically fit/size subtitle string within the bounds set by setRect(getSubtitle();)

 

false=

Allow subtitle string to be any size

Default:

true

Syntax:

setSubtitleAutofit ( true | false );

 

boolean = setSubtitleAutofit();

Example:

perspective1.setSubtitleAutofit(true);
perspective1.setFontSizeVC(
    perspective1.getSubtitle(),2782);
perspective1.setSubtitleString(
    "THIS IS THE CHART'S SUBTITLE");

 

 

perspective1.setSubtitleAutofit(false);

 

Also See:

SubtitleDisplay, SubtitleString, setFontSizeVC()

SubtitleDisplay

 

This property enables (true) / disables (false) display of the chart subtitle defined by the SubtitleString property.

Range:

true / false

 

true=

Display chart subtitle

 

false=

Do not display chart subtitle

Default:

true

Syntax:

setSubtitleDisplay ( true | false );

 

boolean = setSubtitleDisplay();

Example:

perspective1.setSubtitleAutofit(true);
perspective1.setFontSizeVC(
    perspective1.getSubtitle(),2782);
perspective1.setSubtitleString(
    "THIS IS THE CHART'S SUBTITLE");

 

 

perspective1.setSubtitleDisplay(false);

 

Also See:

SubtitleAutofit, SubtitleString

SubtitleString

 

This property to used to define the subtitle text that is drawn in the chart when the SubtitleDisplay property is set to true. When a subtitle string is defined with this property, the SubtitleDisplay property is automatically set to true.

Data Type:

String

Range:

Any printable characters

Default:

"Chart Subtitle"

Syntax:

setSubtitleString ( "string" );

 

string = getSubtitleString();

Example:

perspective1.setSubtitleAutofit(true);
perspective1.setFontSizeVC(
    perspective1.getSubtitle(),2782);
perspective1.setSubtitleString(
    "THIS IS THE CHART'S SUBTITLE");

 

Also See:

SubtitleAutofit(), SubtitleDisplay