DataItemsAlongSeries

 

This property determines whether data items are aligned parallel to the series (both rows or both columns). This property is only used with a chart type that requires more than one value per series (such as Scatter, Polar, or Stock charts). If any other chart type is selected, the property is ignored.

Data Type:

Boolean

Range:

true / false

 

true=

Align data items parallel to series

 

false=

Align data items vertically within series

Default:

true (Align data items parallel to series)

Syntax:

setDataItemsAlongSeries ( true | false );

 

boolean = getDataItemsAlongSeries();

Example:

perspective1.setGraphType(63);
perspective1.setDataItemsAlongSeries(true);

 

 

perspective1.setDataItemsAlongSeries(false);

 

DataLineThickness

 

When a "2.5D effect" is applied to a vertical or horizontal line chart with DepthAngle and DepthRadius, the DataLineThickness property defines the width of the "fake 3D" lines in the chart. It is expressed as a value in the range 1 to 100. A value of one produces very thin lines, a value of 100 produces very thick 3D ribbons.

Data Type:

Integer

Range:

1...100

Default:

30

Syntax:

setDataLineThickness ( value );

 

value = getDataLineThickness();

Example:

perspective1.setGraphType(53);
perspective1.setDataLineThickness(90);

 

 

perspective1.setDataLineThickness(10);

 

Also See:

DepthAngle, DepthRadius

DataScrollerPresenceGroups

 

This property controls the presence of data scroller bars on the group axis. This property can be used for all 2D charts except pies. It is not applicable for 3D charts or 2D pie charts. When the number of viewable groups is set to a value less than the number of groups in the data set, the scroller bar can be used to change the first group in the chart that is displayed (i.e., it effectively changes the value assigned to ScrollOffsetGroup). The data scroller bar consists of two segments: 1) a segment that can be used to click and drag to the first group to be displayed and 2) a status bar that shows the number of the first group (i.e., the ScrollOffsetGroup value), the total number of viewable groups, and the remaining number of groups in the data set. In the first segment, the darker, movable thumb can be dragged to change the group offset. In the second segment, the total of the three numbers indicates the total number of groups defined in the data set. For example, the status area of the scroll bar displays "2 3 1". These numbers indicate that ScrollOffsetGroup is "2", ViewableGroups is "3", there is "1" group in the data set that is not displayed, and there are a total of six groups defined in the data set. The user can click on these numbers and edit them with the arrow keys.

Data Type:

Integer

Range:

0...2

 

0=

Never display data scroller bar

 

1=

Only display data scroller bar when ViewableGroups is greater than zero

 

2=

Always display data scroller bar

Default:

0 (Never)

Syntax:

setDataScrollerPresenceGroups ( value );

 

value = getDataScrollerPresenceGroups();

Example:

perspective1.setDepthRadius(0);
perspective1.setDataScrollerPresenceGroups(2);
perspective1.setViewableGroups(4);

 

Also See:

DataScrollerPresenceSeries, ScrollOffsetGroup, ViewableGroups

DataScrollerPresenceSeries

 

This property controls the presence of data scroller bars on the series in a chart. This property can be used for all 2D charts. It is not applicable for 3D charts. When the number of viewable series is set to a value less than the number of series in the data set, the scroller bar can be used to change the first series in the chart that is displayed (i.e., it effectively changes the value assigned to ScrollOffsetSeries). The data scroller bar consists of two segments: 1) a segment that can be used to click and drag to the first series to be displayed and 2) a status bar that shows the number of the first series (i.e., the ScrollOffsetSeries value), the total number of viewable series, and the remaining number of series in the data set. In the first segment, the darker, movable thumb can be dragged to change the series offset. In the second segment, the total of the three numbers indicates the total number of series defined in the data set. For example, the status area of the scroll bar displays "2 3 1". These numbers indicate that ScrollOffsetSeries is "2", ViewableSeries is "3", there is "1" series in the data set that is not displayed, and there are a total of six series defined in the data set. The user can click on these numbers and edit them with the arrow keys.

Range:

0...2

 

0=

Never display data scroller bar

 

1=

Only display data scroller bar when ViewableSeries is greater than zero

 

2=

Always display data scroller bar

Default:

0 (Never)

Syntax:

setDataScrollerPresenceSeries ( value );

 

value = getDataScrollerPresenceSeries();

Also See:

DataScrollerPresenceGroups, ScrollOffsetSeries, ViewableSeries

DataTextAngleDefault

 

This property sets an angle from center-point that all data text is drawn from. The setDataTextAngle() method can override this property by applying an angle to an individual series/group intersection. This property is only used if DataTextPosition is set to zero.

Data Type:

Integer

Range:

0...360

Default:

90

Syntax:

setDataTextAngleDefault ( value );

 

value = getDataTextAngleDefault();

Example:

perspective1.setDepthRadius(0);
perspective1.setViewableGroups(3);
perspective1.setViewableSeries(3);
perspective1.setDataScrollerPresenceGroups(0);
perspective1.setDataScrollerPresenceSeries(0);
perspective1.setDataTextDisplay(true);
perspective1.setDataTextPosition(0);
perspective1.setDataTextAngleDefault(45);

 

 

setDataTextAngleDefault(90);

 

 

setDataTextAngleDefault(120);

 

 

setDataTextAngleDefault(360);

 

Also See:

DataTextPosition, setDataTextAngle()

DataTextDisplay

 

This property enables (true) / disables (false) the display of data values next to risers or markers in a chart. DataTextFormat can be used to define the format (i.e., %, $, etc.) of values displayed on the risers. DataTextPosition or DataTextAngleDefault and DataTextRadiusDefault can be used to define the location where data text values are displayed.

Data Type:

Boolean

Range:

true / false

 

true=

Enable the display of data values

 

false=

Disable the display of data values

Default:

false

Syntax:

setDataTextDisplay ( true | false );

 

boolean = getDataTextDisplay();

Example:

perspective1.setDataTextDisplay(true);
perspective1.setDepthRadius(0);
perspective1.setViewableGroups(3);
perspective1.setViewableSeries(3);
perspective1.setDataTextPosition(3);
perspective1.setGraphType(23);
perspective1.setDataScrollerPresenceGroups(0);

 

 

perspective1.setDataTextDisplay(false);

 

Notes:

Use PieFeelerTextDisplay and PieRingTotalDisplay to display data values in a pie chart.

Also See:

DataTextAngleDefault, DataTextFormat, DataTextPosition, DataTextRadiusDefault, PieFeelerTextDisplay, PieRingTotalDisplay setDataTextAngle(), setDataTextRadius()

DataTextFormat

 

When DataTextDisplay is set to true and data values are displayed next to markers and risers in a chart, this property is used to select one of the preset data text formats. Set this property to minus one and use DataTextFormatPattern if you want to define a custom data text format.

Data Type:

Integer

Range:

-1...17

 

Value

Format (Example)

 

-1

Use the pattern defined by DataTextFormatPattern

 

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:

setDataTextFormat ( value );

 

value = getDataTextFormat ();

Notes:

1.

Use DataTextPosition or DataTextAngleDefault and DataTextRadiusDefault to define the location where data text values are displayed.

 

2.

Use PieFeelerTextFormat and PieFeelerTextFormatPattern to format data text associated with feelers in a pie chart.

 

3.

Use PieRingTotalFormat and PieRingTotalFormatPattern to format the total value in the center of a ring pie chart.

Example

perspective1.setDataTextFormat(1);
perspective1.setDataTextDisplay(true);

 

Also See:

DataTextAngleDefault, DataTextRadiusDefault, DataTextDisplay, DataTextFormatPattern, DataTextPosition, PieFeelerTextFormat, PieFeelerTextFormatPattern, PieRingTotalFormat, PieRingTotalFormatPattern

DataTextFormatPattern

 

When DataTextDisplay is set to true and DataTextFormat is set to minus one, this property is used to specify a standard Java number format pattern for data text values.

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:

setDataTextFormatPattern ( pattern );

 

pattern = getDataTextFormatPattern();

Notes:

1.

DataTextFormat must be set to minus one in order for this property to have any effect on the graph.

 

2.

Use DataTextPosition or DataTextAngleDefault and DataTextRadiusDefault to define the location where data text values are displayed.

 

3.

Use PieFeelerTextFormat and PieFeelerTextFormatPattern to format data text associated with feelers in a pie chart.

 

4.

Use PieRingTotalFormat and PieRingTotalFormatPattern to format the total value in the center of a ring pie chart.

Also See:

DataTextAngleDefault, DataTextRadiusDefault, DataTextDisplay, DataTextFormat, DataTextPosition, PieFeelerTextFormat, PieFeelerTextFormatPattern, PieRingTotalFormat, PieRingTotalFormatPattern

DataTextPosition

 

When the DataTextDisplay property is enabled (true), this property defines the position where data text is displayed next to risers in a chart.

Data Type:

Integer

Range:

0...5

 

0=

Custom, use angle and radius set by DataTextAngleDefault and DataTextRadiusDefault

 

1=

Above risers

 

2=

Center on riser top edge

 

3=

Below riser top edge

 

4=

Center of riser

 

5=

Base of riser

Default:

1 (above risers)

Syntax:

setDataTextPosition ( value );

 

value = getDataTextPosition();

Example:

perspective1.setDepthRadius(0);
perspective1.setViewableGroups(3);
perspective1.setViewableSeries(3);
perspective1.setDataScrollerPresenceGroups(0);
perspective1.setDataScrollerPresenceSeries(0);
perspective1.setDataTextDisplay(true);
perspective1.setDataTextPosition(1);

 

 

perspective1.setDataTextPosition(2);

 

 

perspective1.setDataTextPosition(3);

 

 

perspective1.setDataTextPosition(4);

 

 

perspective1.setDataTextPosition(5);

 

Notes:

If this property is set to zero, the DataTextAngleDefault and DataTextRadiusDefault properties and the setDataTextAngle() and setDataTextRadius() methods control the location of data text.

Also See:

DataTextDisplay, DataTextAngleDefault, DataTextRadiusDefault, setDataTextAngle(), PieRingTotalFormatPattern

DataTextRadiusDefault

 

This property sets the radius that a data text value will be drawn out from the center of a chart riser by default. The setDataTextRadius() method can override this value by setting a specific series/group intersection format for the default data text position.

Data Type:

Integer

Range:

0...100

Default:

20

Syntax:

setDataTextRadiusDefault ( value );

 

value = getDataTextRadiusDefault ();

Example:

perspective1.setDepthRadius(0);
perspective1.setViewableGroups(3);
perspective1.setViewableSeries(3);
perspective1.setDataScrollerPresenceGroups(0);
perspective1.setDataScrollerPresenceSeries(0);
perspective1.setDataTextDisplay(true);
perspective1.setDataTextPosition(0);
perspective1.setDataTextAngleDefault(90);
perspective1.setDataTextRadiusDefault(10);

 

 

perspective1.setDataTextRadiusDefault(40);

 

Notes:

This property will be ignored if DataTextPosition is not set to zero.

Also See:

DataTextAngleDefault, DataTextDisplay, DataTextPosition, setDataTextAngle(), setDataTextRadius()

DataTextTemplateBubble

 

This is a global string property that can be used to define a MACRO-based format for data text labels in a bubble chart. This property can be used to customize the data text labels and insert MACROS for the actual data any place in a defined string. The DataTextDisplay property must be set to true in order for the data text labels to be displayed in the graph.

Data Type:

String

Range:

Any printable characters which may or may not include this macro:

 

SIZE_VALUE_MACRO = "[SIZE]"

Default:

[SIZE]

Syntax:

setDataTextTemplateBubble ( value );

 

value = getDataTextTemplateBubble ();

Example:

perspective1.setDataTextDisplay(true);
perspective1.setGraphType(89);
perspective1.setDataTextTemplateBubble("Temp=[SIZE]");

 

 

perspective1.setDataTextTemplateBubble("Size=[SIZE]");

 

Also See:

DataTextDisplay

DataTextTemplateHiLo

 

This is a global string property that can be used to define a MACRO-based format for data text labels in a stock chart. The default is a null string. If the default is used, a "[CLOSE]" value is used if the Graph Type has a close data item or "[HIGH]" otherwise. This property can be used to customize the data text labels and insert MACROS for the actual data any place in a defined string. The DataTextDisplay property must be set to true in order for the data text labels to be displayed in the graph.

Data Type:

String

Range:

Any printable characters which may or may not include these macros:

 

OPEN_VALUE_MACRO = "[OPEN]"

 

HI_VALUE_MACRO = "[HIGH]"

 

LOW_VALUE_MACRO = "[LOW]"

 

CLOSE_VALUE_MACRO = "[CLOSE]"

Default:

Null String

Syntax:

setDataTextTemplateHiLo ( "String" );

 

"String" = getDataTextTemplateHiLo ();

Example:

perspective1.setDataTextDisplay(true);
perspective1.setDataTextTemplateHiLo("[OPEN]");
perspective1.setGraphType(72);
perspective1.setDataTextFormat(6);
perspective1.setViewableGroupsStock(6);
perspective1.setDataScrollerPresenceGroups(0);

 

 

perspective1.setDataTextTemplateHiLo("[CLOSE]");

 

Also See:

DataTextDisplay

DataTextTemplateScatter

 

This is a global string property that can be used to define a MACRO-based format for data text labels in a scatter chart. Currently defined macros are "[X]" and "[Y]". This property can be used to customize the data text labels and insert MACROS for the actual data any place in a defined string. The DataTextDisplay property must be set to true in order for the data text labels to be displayed in the graph.

Data Type:

String

Range:

Any printable characters which may or may not include these macros:

 

X_VALUE_MACRO = "[X]"

 

Y_VALUE_MARCO = "[Y]"

 

X_Y_VALUE_MARCO = "[X], [Y]"

Default:

[X],[Y]

Syntax:

setDataTextTemplateScatter ( "string" );

 

"string" = getDataTextTemplateScatter ();

Example:

perspective1.setDataTextDisplay(true);
perspective1.setDataTextTemplateScatter("<[X]/[Y]>");
perspective1.setGraphType(61);

 

 

perspective1.setDataTextDisplay(true);
perspective1.setDataTextTemplateScatter("<[Y]/[X]>");
perspective1.setGraphType(61);

 

Also See:

DataTextDisplay

DepthAngle

 

This property sets the angle of a line from the front of the chart frame to the back (in degrees).

Data Type:

Integer

Range:

0...180 degrees

Default:

45 degrees

Syntax:

setDepthAngle ( value );

 

value = getDepthAngle();

Example:

perspective1.setDepthAngle(20);

 

 

perspective1.setDepthAngle(60);

 

Notes:

1.

This property applies to Bar, Line, and Area charts only. It will be ignored if any other chart type is selected.

 

2.

The DepthRadius property must be greater than zero in order for this property to be properly applied to the graph.

Also See:

DepthRadius

DepthRadius

 

When charts are drawn with a 2.5D effect, this property sets how far out the extruded frame will be extended. Small values produce a very narrow chart, larger values produce a thicker chart.

Data Type:

Integer

Range:

0...100

Default:

40

Syntax:

setDepthRadius ( value );

 

value = getDepthRadius();

Example:

perspective1.setDepthRadius(20);

 

 

perspective1.setDepthRadius(60);

 

Notes:

This property applies to Bar, Line, and Area charts only. It will be ignored if any other chart type is selected.

Also See:

DepthAngle

Display3DFloor

 

This property enables / disables drawing of the cube floor in a 3D chart.

Data Type:

Boolean

Range:

true / false

 

true=

Draw cube floor

 

false=

Do not draw cube floor

Default:

true

Syntax:

setDisplay3DFloor ( true | false );

 

boolean = getDisplay3DFloor();

Example:

perspective1.setGraphType(4);
perspective1.setDisplay3DFloor(true);

 

 

perspective1.setDisplay3DFloor(false);

 

Notes:

This property only applies to 3D graph types. It will be ignored if any other chart type is selected.

Also See:

Display3DLeftWall, Display3DRightWall, GraphType

Display3DLeftWall

 

This property enables / disables drawing of the cube left wall in a 3D chart.

Data Type:

Boolean

Range:

true / false

 

true=

Draw left wall of 3D cube

 

false=

Do not draw left wall of 3D cube

Default:

true

Syntax:

setDisplay3DLeftWall ( true | false );

 

boolean = getDisplay3DLeftWall();

Example:

perspective1.setDisplay3DLeftWall(true);
perspective1.setGraphType(4);

 

 

perspective1.setDisplay3DLeftWall(false);

 

Notes:

This property only applies to 3D graph types. It will be ignored if any other chart type is selected.

Also See:

Display3DFloor, Display3DRightWall, GraphType

Display3DRightWall

 

This property enables/disables drawing of the cube right wall in a 3D chart.

Data Type:

Boolean

Range:

true / false

 

true=

Draw right wall of 3D cube

 

false=

Do not draw right wall of 3D cube

Default:

true

Syntax:

setDisplay3DRightWall ( true | false );

 

boolean = getDisplay3DRightWall();

Example:

perspective1.setDisplay3DRightWall(true);
perspective1.setGraphType(4);

 

 

perspective1.setDisplay3DRightWall(false);

 

Notes:

This property only applies to 3D graph types. It will be ignored if any other chart type is selected.

Also See:

Display3DLeftWall, Display3DFloor, GraphType

DisplayBarAsPictograph

 

This property enables (true) / disables (false) the display of bars as pictographs in a flat 2D chart. When this property is set to true, the picture (.GIF image) identified by the setTextureURL() method will be applied to the bar. The setTextureURL() method must be used to identify a valid .GIF image. If a texture has not been identified with setTextureURL(), this property may cause jagged lines to be displayed on the bars. The setFillType() method should also be set to identify textures (i.e., setFillType (3); ) as the fill type.

Data Type:

Boolean

Range:

true / false

 

true=

Display bars as pictographs

 

false=

Display bars normally

Default:

false

Syntax:

setDisplayBarAsPictograph ( true | false );

 

boolean = getDisplayBarAsPictograph();

Example:

perspective1.setFillType(perspective1.getSeries(3),3);
perspective1.setFillType(perspective1.getSeries(4),3);
perspective1.setTextureDisplayMode(0);
perspective1.setTextureURL(
    perspective1.getSeries(3),
    "file:/C:/PJE/tiles/Azul_Granite.gif");
perspective1.setTextureURL(
    perspective1.getSeries(4),
    "file:/C:/PJE/tiles/Azul_Granite.gif");
perspective1.setDisplayBarAsPictograph(true);

 

Also See:

setTextureURL(), getTextureDisplayMode(), setTextureDisplayMode(), getFillType(), setFillType()

DualAxisLineDisplay

 

This property enables/disables the display of a line that separates the two halves of a dual axes chart. The chart type must be a bipolar graph or a stock chart with volume in order to see the effect of this property.

Data Type:

Boolean

Range:

true / false

 

true=

Display the dual axes line

 

false=

Do not display the dual axes line

Default:

true

Syntax:

setDualAxisLineDisplay ( true | false );

 

boolean = getDualAxisLineDisplay();

Example:

perspective1.setDepthRadius(0);
perspective1.setDualAxisLineDisplay(true);
perspective1.setGraphType(21);

 

 

perspective1.setDualAxisLineDisplay(false);

 

Notes:

For Bar, Line, and Area charts with DepthRadius set to any value greater than zero, a BiPolar plane will be displayed instead of a solid line.

Also See:

DualAxisSplitPosition

DualAxisSplitPosition

 

This property sets the position within the chart frame where the Dual-Y split position will be created. The default value of 50 is exactly in the middle. A lower number will move the split position closer to the bottom of the chart; a higher value will move it closer to the top of the chart.

Data Type:

Integer

Range:

10...90

Default:

50

Syntax:

setDualAxisSplitPosition ( value );

 

value = getDualAxisSplitPosition();

Example:

perspective1.setDepthRadius(0);
perspective1.setDualAxisSplitPosition(60);
perspective1.setGraphType(21);
perspective1.setLineWidth(
    perspective1.getFrameSeparator(),4);

 

 

perspective1.setDualAxisSplitPosition(40);

 

Also See:

DualAxisLineDisplay