Promotic

SetUserControl - method of the PmgTrendViewer object

Description:
The method enables/disables the user control of the viewer, for example, it disables scrolling by dragging the mouse or on the keyboard, zooming by dragging the mouse, etc. By default the full control of the viewer by the mouse and the keyboard is enabled.
Syntax:
Empty SetUserControl(String sOptions)
Parameters:
sOptions(String) Text string enables/disables scrolling by dragging the mouse or on the keyboard, zooming by dragging the mouse etc.
The following strings can be concatenated by the separator ; into one string.
"zoomtime:xxx" - Setting the zoom control on the time axis:
"zoomtime:no" - Disable the control
"zoomtime:full" - Enable the control by the mouse and the keyboard
"zoomtime:mouse" - Enable the control only by the mouse
"zoomtime:key" - Enable the control only by the keyboard
"zoomvalue:xxx" - Setting the zoom control on the value axis.
xxx holds the same meanings as zoomtime.
"zoom:xxx" - Setting the zoom control on the value axis and on the time axis.
xxx holds the same meanings as zoomtime.
"scrolltime:xxx" - Setting the scroll control on the time axis.
xxx holds the same meanings as zoomtime.
"scrollvalue:xxx" - Setting the scroll control on the value axis.
xxx holds the same meanings as zoomtime.
"scroll:xxx" - Setting the scroll control on the value axis and on the time axis.
xxx holds the same meanings as zoomtime.
"click:xxx" - Setting the controll by the mouse click on the area during the trend process (values are displayed only if Autoscroll is switched off). The font of displayed legends equals to the legends font of the value scale, see the ScaleValue property.
"click:no" - do nothing
"click:showval(trend=near)" - displays the nearest value of the nearest trend
"click:showval(trend=active)" - displays the nearest value of the active trend
"click:showval(trend=all)" - displays the nearest value of all trends
"click:showvalname(trend=near)" - displays the nearest value and the name of the nearest trend
"click:showvalname(trend=active)" - displays the nearest value and the name of the active trend
"click:showvalname(trend=all)" - displays the nearest value and the name of all trends
"click:showvaltime(trend=near)" - displays the nearest value and time of the nearest trend
"click:showvaltime(trend=active)" - displays the nearest value and time of the active trend
"click:showvaltime(trend=all)" - displays the nearest value and time of all trends
"click:showvaltimename(trend=near)" - displays the nearest value, time and the name of the nearest trend
"click:showvaltimename(trend=active)" - displays the nearest value, time and the name of the active trend
"click:showvaltimename(trend=all)" - displays the nearest value, time and the name of all trends
Note:
This method is also functional in Web panels.
 
The keyboard control is not functional when using the viewer in the HTML page, there it is necessary to configure is by the HTML page events.
Example:
JavaScriptVBScriptSelect and copy to clipboard

var oTView = pMe.Items("../TrendView");
oTView.SetUserControl("zoom:no;scrolltime:mouse;click:showval(trend=near)");
PROMOTIC 9.0.27 SCADA system documentation MICROSYS, spol. s r.o.

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