|
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(false); |
|
|
|
|
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(10); |
|
|
Also See: |
|
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); |
|
|
|
|
Also See: |
DataScrollerPresenceSeries, ScrollOffsetGroup, ViewableGroups |
|
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 |
|
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); |
|
|
|
setDataTextAngleDefault (90); |
|
|
|
setDataTextAngleDefault (120); |
|
|
|
setDataTextAngleDefault (360); |
|
|
Also See: |
|
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.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() |
|
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); |
|
|
|
|
Also See: |
DataTextAngleDefault, DataTextRadiusDefault, DataTextDisplay, DataTextFormatPattern, DataTextPosition, PieFeelerTextFormat, PieFeelerTextFormatPattern, PieRingTotalFormat, PieRingTotalFormatPattern |
|
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 |
|
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.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 |
|
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.setDataTextRadiusDefault(40); |
|
|
Notes: |
This property will be ignored if DataTextPosition is not set to zero. |
Also See: |
DataTextAngleDefault, DataTextDisplay, DataTextPosition, setDataTextAngle(), setDataTextRadius() |
|
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.setDataTextTemplateBubble("Size=[SIZE]"); |
|
|
Also See: |
|
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("[CLOSE]"); |
|
|
Also See: |
|
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.setDataTextDisplay(true); |
|
|
Also See: |
|
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: |
|
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: |
|
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(false); |
|
|
|
|
Notes: |
This property only applies to 3D graph types. It will be ignored if any other chart type is selected. |
|
Also See: |
|
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.setDisplay3DLeftWall(false); |
|
|
|
|
Notes: |
This property only applies to 3D graph types. It will be ignored if any other chart type is selected. |
|
Also See: |
|
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.setDisplay3DRightWall(false); |
|
|
|
|
Notes: |
This property only applies to 3D graph types. It will be ignored if any other chart type is selected. |
|
Also See: |
|
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); |
|
|
|
|
Also See: |
setTextureURL(), getTextureDisplayMode(), setTextureDisplayMode(), getFillType(), setFillType() |
|
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(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: |
|
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(40); |
|
|
Also See: |