Properties

<< Click to Display Table of Contents >>

Manual > Control Reference > Data > Plot graph control >

Properties

Property Name

explanation

All common properties

For details, please refer to Common Properties.

 

 

Property Name

explanation

ShowScaleX

Whether to display tick marks on the X-axis.

ShowScaleY

Whether to display the Y-axis scale.

OffsetScaleX

Offset the X axis downwards.

OffsetScaleY

Offset the Y axis to the left.

ShowRangeController

Whether to display a controller for changing the range.

PowerfactorMaxMinType

Select the method for calculating the maximum and minimum power factor values.

TYPE1

Minimum value: Power factor close to -0.5 in the negative direction / Maximum value: Power factor close to 0.5 in the positive direction (default)

TYPE2

Minimum value: Power factor whose absolute value is farthest from 1 (100%) / Maximum value: Power factor whose absolute value is closest to 1 (100%)

* This is valid when the pen property "DataType" set by AddPen / SetPenProperty is powerfactorXX.

 

AutoDeleteMode

Whether to automatically delete off-screen data.

Unless there is a specific reason, please select "OUTOFSCREEN".

NONE

Do not automatically delete.

OUTOFSCREEN

Automatically remove points outside the screen range (default).

 

 

 

Property Name

explanation

MouseZoom

Whether to use the function to enlarge the area dragged with the mouse.

To reset zooming caused by dragging the mouse, call the ResetMouseZoom method.

NONE

Do not expand

ZOOM_X

Drag range to expand only in the X-axis direction

ZOOM_Y

Drag to expand the area along the Y axis only.

ZOOM_XY

Expand by dragging area

 

 

 

Property Name

explanation

Probe

Whether the cursor is visible.

NONE

Do not display

SINGLE

Show one cursor

DUAL

Show two cursors

 

ProbeColor

Cursor color. If you select no color, the probe will not be drawn.

ProbeData

Whether to display the time above the cursor.

OffsetProbeData

Offsets the time position of the top cursor.

 

 

Property Name

explanation

DrawOutOfRange

How to display graph lines that extend beyond the graph.

ALL

Show all

LIMIT_X

Any part that extends beyond the left or right side of the drawing frame will not be drawn.

LIMIT_Y

Any part that extends beyond the top or bottom of the drawing frame will not be drawn.

LIMIT_XY

Any part that goes beyond the drawing frame will not be drawn.

 

PlotOutOfRange

How to display out-of-range data (values outside the High/KLow range specified by AddPen).

ALL

Show all even if out of range. (default)

DELETEDATA

Delete data outside the range

FLATMAXMINDATA

Data outside the range is rounded to the maximum or minimum value set and displayed. Data passed by OnPlotValueChanged or OnProbeChanged is also rounded.

FLATMAXMINPLOT

Data outside the range is rounded to the maximum or minimum value set and displayed. Data passed to OnPlotValueChanged or OnProbeChanged remains the original data.

 

DrawPlotLineFront

The order in which plot and graph lines are displayed.

TRUE

Draws the graph line after drawing the plot line.

FALSE

Draws the plot line after drawing the graph line.

 

PlotLineSize

The thickness of the graph line.

-1

Display according to the settings of each pen (SetPenPlotSize)

0

Do not display

1 or more

Draws all graph lines with the specified thickness.

 

PlotBarSize

The thickness of the bar graph.

-1

Display according to the settings of each pen (SetPenPlotSize)

0

Do not display

1 or more

Draws the bar graphs of all pens with the specified width.

 

PlotBarAdjustment

When a bar graph is displayed using multiple pens, the bars are automatically shifted horizontally for each pen so that they do not overlap.

PlotPointSize

The size of the graph points.

-1

Display according to the settings of each pen (SetPenPlotSize)

0

Do not display

1 or more

Draws all graph points at the specified size.

 

PlotLackLineSize

The thickness of the graph line for missing values.

-1

Display according to the settings of each pen (SetPenPlotSize)

0

Do not display

1 or more

Draws all graph lines with the specified thickness.

 

PlotLackPointSize

The size of the graph points for missing values.

-1

Display according to the settings of each pen (SetPenPlotSize)

0

Do not display

1 or more

Draws all graph points at the specified size.

 

PlotLackLineStyle

Missing value line style.

SOLID

Straight Line

DASH

dotted line

DOT

Dotted line

DASHDOT

Dotted line + dotted line

DASHDOTDOT

Dotted line + dotted line + dotted line

 

PlotColorBarAlpha

The transparency (0 to 1) of the horizontal bar when colorbar is selected as the PlotType in AddPen.

If you want to change the transparency for each pen, specify -1 for the PlotColorBarAlpha property and specify a value for each pen in the "ColorBarAlpha" property of SetPenProperty.

PlotColorBarColor

When you select colorbar for PlotType in AddPen, the bar display colors are listed below. From the left, the colors are specified in RGB, separated by commas: color when the value is 0, color when the value is 1, color when the value is 2, etc.

 

Example: #00FF00, #FF0000

When the value is 0 (FALSE), it will be drawn in green (#00FF00), and when the value is 1 (TRUE), it will be drawn in red (#FF0000).

 

Example) #00FF00,#FF0000,#0000FF

When the value is 0, it is drawn in green (#00FF00), when it is 1, it is drawn in red (#FF0000), and when it is 2, it is drawn in blue (#0000FF).

 

If you want to specify a different color for each pen, specify an empty string for the PlotColorBarColor property and specify a color for each pen using the "ColorBarColor" property of SetPenProperty.

 

 

Property Name

explanation

DiffForLack

The difference between the values considered to be data missing intervals (X-axis value).

If the difference between the previous data and the previous data is equal to or greater than DiffForLack, the missing value is considered to exist between the previous data and the previous data. For trend graphs and historical trend graphs, specify the time in seconds. For details, see "Customizing the graph display when data is missing".

ValueForLack

The value to consider as missing.

Valid when the ValueForLackType property is STR and NUM.

ValueForLackType

The type of values to consider as missing.

NONE

All data is considered valid. If there is no actual data, the value is set to "0".

NULL

Empty strings are considered missing values.

STR

The characters set in the ValueForLack property are considered missing values.

NUM

The value set in the ValueForLack property is considered a missing value.

 

 

 

Property Name

explanation

SpaceX

The gap between the actual graph and the control border (on the x-axis).

0 - 0.4

Specify the space as a percentage of the control's size

1 or more

Space in pixels

 

SpaceY

The gap between the actual graph and the control border (on the y-axis).

0 - 0.4

Specify the space as a percentage of the control's size

1 or more

Space in pixels

 

 

 

Property Name

explanation

GridSpaceX

Space on either side of the plot area along the x-axis.

0 - 0.4

Specify the space as a percentage of the control's size

1 or more

Space in pixels

 

When mainly displaying bar graphs, specify the drawing space to prevent the bars on both sides from being cut in half.

GridLineX

Whether to show grid lines (x-axis direction).

GridLineY

Whether to show grid lines (Y axis direction).

GridLineBound

Whether to show the grid borders.

GridLineColor

The color of the grid lines.

GridLineStyle

The line style of the grid.

The default is " DOT ".

SOLID

Straight Line

DASH

dotted line

DOT

Dotted line

DASHDOT

Dotted line + dotted line

DASHDOTDOT

Dotted line + dotted line + dotted line

 

GridCountX

The number of grids along the x-axis.

GridCountY

The number of grids along the Y axis.

 

 

Property Name

explanation

FormatNumber

The number format for displaying numbers on the X and Y axes.

FormatNumberX

The number format for displaying numbers on the x-axis.

If you do not set anything, the X-axis will be displayed according to the FormatNumber property setting.

FormatNumberY

The number format for displaying numbers on the Y-axis.

If you do not set anything, the Y axis will be displayed according to the setting of the FormatNumber property.

FormatPowerfactorPlus

You can specify the sign of the Y-axis scale when the power factor is positive (default is blank).

 

example)

this.FormatPowerfactorPlus = "LEG";

 

FormatPowerfactorMinus

You can specify the sign of the Y-axis scale when the power factor is negative (default is "-").

 

example)

this.FormatPowerfactorMinus = "LEAD";

 

 

 

Property Name

explanation

TitleLeft

Title text (left).

If the displays overlap, adjust them using SpaceX/Y.

TitleRight

Title text (right).

If the displays overlap, adjust them using SpaceX/Y.

TitleBottom

Title text (below).

If the displays overlap, adjust them using SpaceX/Y.

TitleTop

Title text (above).

If the displays overlap, adjust them using SpaceX/Y.

 

 

Property Name

explanation

TextFont

Font of the text.

TextColor

Text color.

AutoChangeTextColor

Specify the text color.

TRUE

Changes the text color to the currently selected pen color.

FALSE

The text color is fixed to the color of the TextColor property.

 

 

 

Property Name

explanation

Border

Whether to show the border.

BorderColor

Border color.

BorderWidth

Border thickness.

 

 

Property Name

explanation

Fill

Whether to fill the background.

FillColor

Background color.

FillGrid

Whether to fill the grid background.

FillGridColor

Grid background color.

 

 

Property Name

explanation

All common properties (library)

For details, please refer to Common Properties (Library).