Promotic
WikipediaLinkedInYoutubeTwitterFacebook

LabelBorderFormat - property of the tvScale object

Description:
Format of scale edge legends.
Syntax:
Variant LabelBorderFormat
Note:
Property access for read and write. The preset value of this property is defined in the "Format value:" configurator of this object. 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 tvTrend.LabelBorderFormat).
 
Setting this property differs according to setting the LabelBorderFormatType property:
If LabelBorderFormatType=0, then the legent is a number, with the accuracy 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 format formula 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. 2020),
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 figures 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 the 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:
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.13 SCADA system documentation - MICROSYS, spol. s r.o.

Send page remarkContact responsible person
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice