Promotic

LabelBorderFormat - property of the tvScale object

Description:
Format of scale edge legends.
Syntax:
Variant LabelBorderFormat
Note:
Property access for read and write. The default value of this property is defined in the "Format value:" configurator of this object.
 
This property is also functional in Web panels.
 
Drawing the scale legends proceeds according to setting of this property only if the value oTrend.LabelBorderFormat="$dbind" is set in the tvTrend.LabelBorderFormat property (otherwise by the tvTrend.LabelBorderFormat property).

Setting this property differs according to setting the LabelBorderFormatType property:
If LabelBorderFormatType=0, then the legent is a number, with the precision defined in LabelBorderFormat meaning the number of valid digits of the difference between tvTrend.ValueMax and tvTrend.ValueMin.
If LabelBorderFormatType=1, then the legend is a number and the number of decimal places is set into the LabelBorderFormat.
If LabelBorderFormatType=10, then the legend is a time and the formatting rule is set into the LabelBorderFormat in the form for example "%d.%m.%Y %H:%M:%S.%T", where:
d=day (01-31),
m=month (01-12),
Y=year (e.g. 2023),
H=hour (00-23),
M=minute (00-59),
S=second (00-59),
T=millisecond (000-999) - it is possible %nT, where n is count of digits 1, 2 or 3

Any of the chars %d, %m, %Y, %M, ... can be omitted and so to omit the corresponding time item in the presentation.

If the legend has to be divided into more lines, then it is necessary to enter "new line" character (vbLf constant) into a text string.
Initial value at the value scale is 1 (i.e. 1 decimal place), at the time scale it is the string "%d.%m.%Y" & vbLf & "%H:%M:%S".
See also:
- tvScale.LabelBorderVisible (property)
- tvScale.LabelFormatType (property)
- tvScale.LabelFormat (property)
- tvTrend.LabelFormat (property)
Example1:
Legends of the value scale edges are numeric values to 2 decimal places. Legends of the time scale edges are a time with the format: day.month.year NewLine hour:minute:second.
JavaScriptVBScriptSelect and copy to clipboard

var oTView = pMe.Items("../TrendView");
var oScaleTime = oTView.ScaleTime;
var oScaleValue = oTView.ScaleValue;

oScaleTime.LabelBorderFormatType = 10;

oScaleValue.LabelBorderFormatType = 1;
oScaleValue.LabelBorderFormat = 2;
Example2:
Legends of the time scale adges are in the time format: day.month.year NewLine hour:minute:second.millisecond (millisecond is on 2 places).
JavaScriptVBScriptSelect and copy to clipboard

oScaleTime.LabelBorderFormatType = 10;
oScaleTime.LabelBorderFormat = "%d.%m.%Y\\n%H:%M:%S";
PROMOTIC 9.0.27 SCADA system documentation MICROSYS, spol. s r.o.

Send page remarkContact responsible person
© MICROSYS, spol. s r.o.