Data Properties

<< Click to Display Table of Contents >>

Manual > Control Reference > Data > Chart Ver2 control >

Data Properties

The Data property is the property of the Chart2 Control chart's data.
 
AddData / AddXYData / AddXYZData / SetDataProperty / GetDataProperty
 

The "Props" parameter of each of these methods can be specified and retrieved using the following property setting format.

 

"Property name: Setting value"

 

You can also set multiple properties at once by specifying them in an array.

 

c("Property name 1: Setting value 1", "Property name 2: Setting value 2" [, ...])

 

hint

Below is an example of setting the data properties:
 
Setting example)

this.AddData(        

                 c("RenderType:COLUMN", "Name:Apple"),

                 c(53, 66, 22, 12, 88, 39));

 

 

 

Data Properties

Property Name

explanation

Name

Data name (displayed in legend)

RenderType

When ChartType is set to STANDARD, select which graph to display from the following. The default is LINE.

LINE

Line graph (displayed as a plot graph or bubble graph depending on the combination with other settings)

AREA

Area Chart

COLUMN

bar graph

 

Show

Show/hide the graph. Default is TRUE.

AxisY

The axis name to use (L2, R1, etc.), default is L1.

AxisX

The axis name to adopt (B2, T1, etc.), default is B1.

DataColor

Graph color. Default is automatically selected from the control's Palette property.

DataAlpha

The transparency of the graph (0 to 1).

FillStyle

Fill style for bar graphs. Gradient and other styles can be specified. GD_VERTICAL1 and GD_HORIZONTAL4 are recommended. The default is SOLID.

LineType

How to draw lines in line graphs. Default is NONE.

NONE

Do not display lines

STRAIGHT

Draw a straight line

CURVE

Draw with curves

 

LineWidth

Thickness of the lines in the line graph. Default is 1.

TitleFont

Font for the X-axis title.

LineStyle

Line style, default is SOLID.

SOLID

Straight Line

DASH

dotted line

DOT

Dotted line

DASHDOT

Dotted line + dotted line

DASHDOTDOT

Dotted line + dotted line + dotted line

 

ColumnSize

The thickness of the bars. Default is 1.

AnchorType

The type of anchor. Default is NONE.

NONE

Do not display anchors

CIRCLE

circle

TRIANGLE

triangle

RECTANGLE

square

 

AnchorSize

The size of the anchor, default is 6.

AnchorFill

Whether to fill the anchor. Default is FALSE.

ShowBubble

Whether to display as a bubble graph (enabled when RenderType is LINE and data is added with AddXYZData). Default is FALSE.

BubbleMaxSize

Size when Z value is at maximum. Default is 50.

BubbleMinSize

The size when the Z value is at its minimum. Default is 6.

BubbleMaxValue

Maximum Z value. Default is 1.

BubbleMinValue

The minimum Z value. Default is 0.

ShowValue

Whether to display data values on the graph. Default is DEFAULT.

DEFAULT

Follow the setting of the ShowValue property of Chart control

TRUE

View

FALSE

Do not display

 

InsideValueColor

The color to display data values inside the bars.

OutsideValueColor

The color to use when displaying data values outside the bars of a bar chart, or when displaying values in LINE or AREA charts.

ValuePos

Specify the position of the data value when displaying it in the bar graph. The default is AUTO.

AUTO

Select the most suitable position based on the size.

INSIDETOP

Displayed inside the top of the bar graph.

INSIDECENTER

Displayed inside the center of the bar graph.

INSIDEBOTTOM

Displayed inside the bottom of the bar graph.

OUTSIDE

Displayed outside the bar graph.

 

RotateValue

Whether to rotate the data values when displaying them in the bar graph. The default is AUTO.

AUTO

Select the most suitable condition based on the size.

TRUE

Rotate 90 degrees.

FALSE

Do not rotate 90 degrees.

 

ValueDisplayFormat

Display format for displaying values (see "Display Format"). (When ChartType is STANDARD) If nothing is specified, the root ValueDisplayFormat property is used. The default is not specified.

ValueDisplayFormatPie

Display format for displaying values (see "Display Format"). (When ChartType is PIE) If nothing is specified, the root ValueDisplayFormat property is used. The default is not specified.

TooltipDisplayFormat

The format of the text displayed in the tooltip of the standard graph. If nothing is specified, the root TooltipDisplayFormat property is used. The default is not specified.

TooltipDisplayFormatPie

The format of the text displayed in the tooltip of the pie chart. If nothing is specified, the root TooltipDisplayFormatPie property is used. The default is not specified.

ShowRegressionLine

Whether to show the forecast line. Default is FALSE.

RegressionLineDrawArea

The range of the prediction line. Default is DATA.

DATA

Draw a prediction line within the range of maximum and minimum X values of data.

CHART

Draws a forecast line across the entire x-axis of the chart.

 

RegressionLineColor

Color of the forecast line. If not specified, it follows DataColor. Default is not specified.

RegressionLineWidth

Line thickness of the forecast line. Default is 1.

RegressionLineStyle

Line style for forecast lines. Default is SOLID.

SOLID

Straight Line

DASH

dotted line

DOT

Dotted line

DASHDOT

Dotted line + dotted line

DASHDOTDOT

Dotted line + dotted line + dotted line

 

TargetOfPie

Whether to include the data in the pie graph. Default is TRUE.

 

The following properties specify the numeric format for displaying Y values in graphs and tooltips (the TooltipDisplayFormat property's $FY and $DY). (You can add "Y" to the beginning of the property name.)

Property Name

explanation

ValueDefaultFormat

Default is TRUE.

TRUE

Follows the setting of the Y axis to which it belongs.

FALSE

Follows the settings of the Data object.

* Pie charts always follow the settings of the Data object.

ValueType

The type of value. Default is NUMBER.

NUMBER

Number

DATETIME

Date and Time

PERCENT

percent

LOG10

Logarithm

 

ValueHeader

Adds a string to the front of the value.

ValueFooter

Adds a string to the end of the value.

ValueDecimals

Number of decimal places. Default is 1. If -1 is specified, no decimal places are specified.

ValueZeroSuppress

Zero suppression enabled or disabled. Default is TRUE.

ValueScale

Display according to the format specified by ScaleUnit. Default is TRUE.

ValueScaleUnit

Sets the unit of scale processing when displaying values. Units are displayed by listing the units separated by semicolons (;). If DEFAULT is specified, the ScaleUnit setting for the Y axis is followed. The default is "K=1000;M=1000;B=1000".

 

Example) If you want to display the value in units of K/M/B

K=1000;M=1000;B=1000

 

Example) To display values in units of Sec/Min/Hr/Day/Wk

Sec=1;Min=60;Hr=60;Day=24;Wk=7

ValueScaleMaxRecursion

When displaying according to the format specified by ScaleUnit, the maximum number of units to display. The default is 1.

 

The following properties specify the numeric format for displaying X values in graphs and tooltips ($FX in the TooltipDisplayFormat property).

Property Name

explanation

XValueDefaultFormat

Default is TRUE.

TRUE

Follows the settings of the X-axis to which it belongs.

FALSE

Follows the settings of the Data object.

* Pie charts always follow the settings of the Data object.

XValueType

The type of value. Default is NUMBER.

NUMBER

Number

DATETIME

Date and Time

PERCENT

percent

LOG10

Logarithm

 

XValueHeader

Adds a string to the front of the value.

XValueFooter

Adds a string to the end of the value.

XValueDecimals

Number of decimal places. Default is 1. If -1 is specified, no decimal places are specified.

XValueZeroSuppress

Zero suppression enabled or disabled. Default is TRUE.

XValueScale

Display according to the format specified by ScaleUnit. Default is TRUE.

XValueScaleUnit

Sets the unit of scale processing when displaying values. Units are displayed by listing the units separated by semicolons (;). If DEFAULT is specified, the ScaleUnit setting for the X-axis is followed. The default is "K=1000;M=1000;B=1000".

 

Example) If you want to display the value in units of K/M/B

K=1000;M=1000;B=1000

 

Example) To display values in units of Sec/Min/Hr/Day/Wk

Sec=1;Min=60;Hr=60;Day=24;Wk=7

XValueScaleMaxRecursion

When displaying according to the format specified by ScaleUnit, the maximum number of units to display. The default is 1.

 

The following property specifies the numeric format for displaying Z values in graphs and tooltips ($FZ in the TooltipDisplayFormat property).

Property Name

explanation

ZValueType

The type of value. Default is NUMBER.

NUMBER

Number

DATETIME

Date and Time

PERCENT

percent

LOG10

Logarithm

 

ZValueHeader

Adds a string to the front of the value.

ZValueFooter

Adds a string to the end of the value.

ZValueDecimals

Number of decimal places. Default is 1. If -1 is specified, no decimal places are specified.

ZValueZeroSuppress

Zero suppression enabled or disabled. Default is TRUE.

ZValueScale

Display according to the format specified by ScaleUnit. Default is TRUE.

ZValueScaleUnit

Sets the unit of scale processing when displaying values. Units are displayed by listing the units separated by semicolons (;). If DEFAULT is specified, the ScaleUnit setting for the Y axis is followed. The default is "K=1000;M=1000;B=1000".

 

Example) If you want to display the value in units of K/M/B

K=1000;M=1000;B=1000

 

Example) To display values in units of Sec/Min/Hr/Day/Wk

Sec=1;Min=60;Hr=60;Day=24;Wk=7

ZValueScaleMaxRecursion

When displaying according to the format specified by ScaleUnit, the maximum number of units to display. The default is 1.