Data Text Properties

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:

void setDataItemsAlongSeries(boolean newValue);
boolean getDataItemsAlongSeries();

EXAMPLE:

setGraphType(63);
setDataItemsAlongSeries(true);

setDataItemsAlongSeries(false);

DataTextAngleDefault

This property gets/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:

void setDataTextAngleDefault(int newValue);
int getDataTextAngleDefault();

EXAMPLE:

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

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 defines 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:

void setDataTextDisplay(boolean newValue);
boolean getDataTextDisplay();

EXAMPLE:

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

setDataTextDisplay(false);

NOTE:

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

ALSO SEE:

DataTextAngleDefault, DataTextFormat, DataTextPosition, DataTextRadiusDefault

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 to define a custom data text format.

DATA TYPE:

integer

RANGE:

-1...21

Value

Description

-1

Use the pattern defined by DataTextFormatPattern

0/1 =

# (e.g., 123 = 123)

2 =

#% (e.g., 123 = 12,300%)

3 =

#.#% (e.g., 123 = 12,300.0%)

4 =

#.##% (e.g., 123 = 12,300.00%)

5 =

$#.## (e.g., 123 = $123.00)

6 =

$# (e.g., 123 = $123)

7 =

#K (Show K for values over 999) (e.g., 1,234 = 1K)

8 =

$#K (Show K for values over 999) (e.g., 1,234 = $1K)

9 =

#M (Show M for millions)(e.g., 1,234,567 = 1M)

10 =

$#M (Show M for millions)(e.g., 1,234,567 = $1M)

11 =

#B (Show B for billions)(e.g., 1,234,567,891 = 1B)

12 =

$#B (Show B for billions)(e.g., 1,234,567,891 = $1B)

13 =

#T (Show T for trillions)(e.g., 1,234,567,891,234 = 1T)

14 =

$#T (Show T for trillions)(e.g., 1,234,567,891,234 = $1T)

15 =

Number with thousands separators, no decimal places(e.g., 1,234 = 1K)

16 =

Number with thousands separators, two decimal places (e.g., 1,234 = 1.23K)

17 =

General currency format for current Locale

18 =

Short Date Format: MM/DD/YY (e.g., 10/01/03)

19 =

Medium Date Format: Mon. DD, YYYY (e.g., Oct. 01, 2003)

20 =

Long Date Format: Month DD, YYYY (e.g., October 01, 2003)

21 =

Full Date Format: Day, Month DD, YYYY (e.g., Wednesday, October 01, 2003)

DEFAULT:

0 (General)

SYNTAX:

void setDataTextFormat(int newValue);
int getDataTextFormat();

NOTE:

ALSO SEE:

DataTextAngleDefault, DataTextRadiusDefault, DataTextDisplay, DataTextFormatPattern, DataTextPosition

DataTextFormatPattern

When DataTextDisplay is set to true and DataTextFormat is set to minus one, this property is specifies 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'* '#'*

Where:

X*

0 or more instances of X

(X|Y) 

either X or Y.

X..Y

any character from X up to Y, inclusive.

S - T

characters in S, except those in T

The first subpattern is for positive numbers. The second (optional) subpattern is for negative numbers. In both cases, a comma(,) can occur inside the integer portion. The special characters used in the parts of the subpattern are:

0

a digit

#

a digit, zero shows as absent

.

a period(.) is a placeholder for decimal separator

,

a comma(,) is a placeholder for grouping separator

;

a semicolon(;) separates formats

-

a minus sign/dash(-) is the default negative prefix

%

divide by 100 and show as percentage

x

any other characters can be used in the prefix or suffix

'

a single quote(') is used to quote special characters in a prefix or suffix

If there is no explicit negative subpattern, a minus sign(-) is prefixed to the positive form (i.e, "0.00" alone is equivalent to "0.00;-0.00"). Illegal formats, such as "#.#.#" or mixing '_' and '*' in the same format, will cause a ParseException. The ParseException string will show where the error occurred. The grouping separator is commonly used for thousands, but in some countries for ten-thousands. The interval is a constant number of digits between the grouping characters (e.g., 100,000,000 or 1,0000,0000). If you supply a pattern with multiple grouping characters, the interval between the last one and the end of the integer is the one that is used. So "#,##,###,####" == "######,####" == "##,####,####". This class only handles localized digits where the 10 digits are contiguous in Unicode, from 0 to 9.

DEFAULT:

"#.#"

SYNTAX:

void setDataTextFormatPattern (String newValue);
String getDataTextFormatPattern();

NOTE:

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

ALSO SEE:

DataTextDisplay, DataTextFormat, DataTextPosition

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:

void setDataTextPosition(int newValue);
int getDataTextPosition();

EXAMPLE:

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

setDataTextPosition(5);

NOTE:

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

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:

void setDataTextRadiusDefault(int newValue);
int getDataTextRadiusDefault();

EXAMPLE:

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

setDataTextRadiusDefault(40);

NOTE:

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

ALSO SEE:

DataTextAngleDefault, DataTextDisplay, DataTextPosition

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_MACRO = "[Y]"
X_Y_VALUE_MACRO = "[X], [Y]"

DEFAULT:

[X],[Y]

SYNTAX:

void setDataTextTemplateScatter (String newValue);
String getDataTextTemplateScatter();

EXAMPLE:

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

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

ALSO SEE:

DataTextDisplay

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:

void setStackedDataValueSum(boolean newValue);
boolean getStackedDataValueSum();

EXAMPLE:

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

setStackedDataValueSum(true);

ALSO SEE:

DataTextDisplay