Promotic

Object PmgTrendViewer (Trend viewer)

Description:
See: PmgTrendViewer - Deatiled object description

Graphic Object used for viewing trends.

The whole panel containing this object used for viewing the trends including trend list table, the instrumental buttons, etc. can be created easily - see Preconfiguration "Trend viewer".
This object inherits properties, methods and events of the PmgObject object.
Properties and methods of this object:
Action Performs the action in the trend viewer
AddServer Registration of server into list in the viewer
AddTrend Creates a new object of the tvTrend type
Autoscroll Enable/disable Autoscroll
AutoscrollRate Period of reading data in seconds while autoscroll is switched on
AutoscrollSize How much to scroll
AutoscrollSizeUnit Unit of the AutoscrollSize property values
AutoscrollType Automatic scroll type
BackgroundColor Background color of the viewer
CompressType Evaluation type for the data compression
CursorColor Color of the cursor
CursorTime Time referring to vertical cursor line
CursorTimeColor Color of the cursor label time
CursorTimeLocation Cursor time location
CursorType Cursor type, its appearance
DataTimeout Maximum time to wait for data
DlgTrends Opens the window for runtime configuration of trend viewer
Draw Redrawing of whole object
FindTrend Searching object of the tvTrend type
GetCfg Returns current values of configuration data of the viewer and displayed treds
GetState Returns viewer state
GetStateText Returns the current state of the viewer in text form
GraphInit Returns tvGraph object - initializing object for drawing
GridTime Returns object of the tvGrid type (vertical lines of the time axis grid)
GridValue Returns object of the tvGrid type (horizontal lines of grid on the value axis)
InsertTrend Creates a new object of the tvTrend type
LastCfgSrc Reference to recently loaded configuration file
LastCfgTitle The name of the recently loaded configuration file
LastErr Numeric code of the last risen error
LastErrText Text of the last risen error
LoadCfg Reading configuration data of the viewer
PointsMaxVisibleCount Maximum number of displayed points in viewer range
ReadData Sending the request for current data
RemoveAllTrends Deletes all trends
RemoveTrend Removes the specified trend
SaveCfg Saving current configuration data of the viewer
SaveToHtm Creates an HTML page for data of the viewer
ScaleTime Returns object of the tvScale type (time scale)
ScaleValue Returns object of the tvScale type (value scale)
ScrollTime Scroll of the viewer on the time axis
ScrollValue Scroll of the viewer on the value axis
SetUserControl Enables/disables the user control of the viewer
TableHeadBgColor Background color of head in the table mode
TableHeadFont Font of head legends in the table mode
TableHeadRowHigh Height of head row in the table mode
TableHeadTextColor Color of head legends in the table mode
TableOper Setting some parameters in the table mode
TableRowHigh Height of data row in the table mode
TableTimeBgColor Background color of time column in the table mode
TableTimeColumnWidth Width of time column in the table mode
TableTimeFont Font of time column in the table mode
TableTimeFormat Format of time column values in the table mode
TableTimeFormatType Format type of time column values in the table mode
TableTimeTextColor Color of time column values in the table mode
TimeMax Time of viewer right edge
TimeMin Time of viewer left edge
TimeSetType Type of input time values in viewer methods
TimeType Type of values on horizontal axis (time or number)
TimeZoomMax Maximum limit of viewer time axis range
TimeZoomMaxForPoints Maximum limit of viewer time axis range for displaying points
TimeZoomMaxForValues Maximum limit for the range (length) of the time axis of the viewer for displaying values.
TimeZoomMin Minimum limit of viewer time axis range
TimeZoomMinForCompress Minimum range of viewer time axis range for displaying calculated points
TrendActive Index of active tvTrend object
TrendArea Returns tvTrendArea object (trends area)
Trends Returns tvTrend object
TrendsCount Returns number of tvTrend subobjects
ValueZoomMode Value axis range setup method
ViewMode Switches from/to the table mode
ZoomTime Change of range, viewer zoom on the time axis
ZoomValue Zooming trends on the value axis
Properties and methods inherited from the PmgBox object:
BorderType Type of the box border
BorderWidth Width of the box border
ColorDark Dark color of the 3D Pmg object border
ColorItem Background color of the box
ColorLight Light color of the 3D Pmg object border
Properties and methods inherited from the PmgObject object:
AddEvent Registers a function into selected event
Blink Starts/stops blinking of the Pmg object
Dx Width of the Pmg object
Dy Height of the Pmg object
Enabled Enable/disable the control, i.e. user's inputs to the object
Focus Detects/set the focus of the Pmg object
GetChildByIndex Returns the nested Pmg object defined by order
GetChildCount Returns the number of nested Pmg objects
GetPathName Object name with the path to this object
GetItemInfo Returns special information regarding the Pmg object
GetPar Reading the value of the Pmg object parameter (or its parents)
IniDx Initial width of the Pmg object
IniDy Initial height of the Pmg object
IniX Initial X-position of the left upper corner of the Pmg object relative to superior object
IniY Initial Y-position of the left upper corner of the Pmg object relative to superior object
Items Returns reference to Pmg object
Methods Access to designer's methods of this object
MouseOn Identification if the mouse cursor finds itself over the Pmg object
Name The name of the Pmg object
Parent Returns reference to the parent Pmg object
Pm Returns the Pma object (obsolete)
PmPanel Returns reference to the PmaPanel object where the Pmg object is placed
Refresh Refresh of the Pmg object
RemoveEvent Deregisters the function in the specified event
Root Returns reference to the root PmgRoot object
ShowMenu Opens local menu of the Pmg object
ScreenX X-coordinate of the left upper corner of the Pmg object relative to computer screen
ScreenY Y-coordinate of the left upper corner of the Pmg object relative to computer screen
ToolTip Tooltip text of the Pmg object
Vars Returns the variable of the Pmg object
ViewX Position of X-coordinate of the left upper corner of the Pmg object relative to the PmgRoot object
ViewY Position of the Y-coordinate of the left upper corner of the Pmg object relative to the PmgRoot object
Visible Sets the visibility/invisibility of the Pmg object
X X-coordinate of the left upper corner of the Pmg object relative to superior Pmg object
Y Y-coordinate of the left upper corner of the Pmg object relative to superior Pmg object
Events of this object:
onCursorTimeChange Is triggered when time on vertical cursor line position changed
onDataTrendReady Is triggered when viewer got data from server
onMouseArea Is triggered when user clicked into the graph drawing area by the mouse
onReadData Is triggered any time when viewer asks for new data
onTimeChange Is triggered when begin or end time of viewer changed
onTrendParamsChange Is triggered on viewer start or if basic parameter of one of the tvTrend type object has been changed
onError Is triggered if error occured in the viewer
Events inherited from the PmgObject object:
onStart Is triggered on the construction of the Pmg object in the course of opening the panel
onStop Is triggered on the destruction of the Pmg object in the course of closing the panel
onRefresh Is triggered on the data refresh of the Pmg object
onKeyPress Is triggered after pressing or releasing the key of the keyboard
onMousePress Is triggered after pressing or releasing the left mouse button
onMenuFill Is triggered after pressing by the right mouse button over the Pmg object
onMenuSelect Is triggered on the selection of an item from the Pmg object local menu
onModeChange Is triggered when the Pmg object mode changes
onFocusIn Is triggered if the object receives focus
onFocusOut Is triggered if the object loses focus
Related objects:
tvTrendArea(TrendViewer area) Object represents area where graphs are drawn
tvGraph(TrendViewer graph) The object for drawing trend
tvGrid(TrendViewer grid) Object that represents grid lines
tvPoints(TrendViewer points) Object that holds data points of trend
tvScale(TrendViewer scale) Object represents a scale
tvTicks(TrendViewer scale ticks) Object for configuration of scale ticks or grid lines layout
tvTrend(TrendsView trend) Object represents one trend variable
Configuration tabs:
Object General information about the object
Position Setting the position, width and height of the Pmg object
Variables List and configuration of user defined Pmg object variables
Events Algorithms definition for the object events
Methods Definition of designer's method of the Pmg object
Box Setting the background area of the Pmg object
Viewer Trend viewer basic parameters setup
Trends Create and edit a list of trends
Appearance Appearance setup of individual parts of the trend viewer.

History:
Pm9.00.14: Modified preconfiguration controls, added context menu in the viewer and new function for displaying values of the active trend as a table in new window.
Pm9.00.08: It allows to connect to HTTPS servers
Pm9.00.05: When displaying the value (Label)
- for long names the buffer of 101 characters could overflow and cause malfunction
- the accuracy mask had only 6 places. When trying to display to many decimal digits only the integer was shown.
Pm9.00.00: Object name changed: PmiAx-TrendsView -> PmgTrendViewer
Pm8.03.29: Fixed bug: for Web panels
Pm8.03.22: Fixed bug: in Web panels:
- Improved transition between standard and daylight saving time.
- Repeated calling the RemoveAllTrends method did not work.
- Setting the properties ValueMin and ValueMax in reversed order caused the scale to flip.
Pm8.03.20: Fixed bug: Web panels - Trends can now be viewed also from other PROMOTIC applications.
Pm8.03.17: Web panels - In Chrome browser, the configuration of trends (colours, styles etc.) is now functional.
Pm8.03.14: Web panel - in JavaScript Web panels:
- The "PmgTrendViewer > Value axis grid > Line type" configurator is now functional.
- Fixed bug: if tvTrend was set as invisible in the configuration file, then it was still visible on the Web.
- Fixed bug: The RemoveAllTrends method generated error if no trend was present.
- showing a trend description on the cursor position now including the timestamp - see SetUserControl("click:showvaltimename(trend=all)").
Pm8.03.13: in JavaScript Web panels:
- Fixed bug: Chart of the Constant type was not rendered correctly under some conditions.
- Fixed bug: Texts rendered next to points were not appearing beneath each other but were overlaping.
Pm8.03.11: Bugfix vulnerability of this object in HTML pages.
Pm8.03.07: Fixed bug: in JavaScript Web panels: sometimes did not render correctly in Chrome browser.
Pm8.03.06: Fixed bug: in JavaScript Web panels:
- Rendering when no trend was connected.
- Rendering when scrolling in the table mode.
Pm8.03.05: Fixed bug: While configuring the object the panel editor sometimes failed (bug since Pm8.3.4 version).
Pm8.03.04: in JavaScript panels:
- Improved values rendering in trends after mouseclick.
Pm8.02.16: Bugfixes and improvements in JavaScript panels.
Pm8.02.15:
The printing in the table mode used incorrect formatting.
- Trend printing from Web browser is now functional by using the methods SaveToHtm and Pm.PrintHtmlPage. The print button in the preconfiguration of the trend viewer is now configured correctly.
- Several rendering bugfixes.
Pm8.02.14: in JavaScript panels:
- The scale background color is now functional (the "Background color" configurator).
- The CursorTime and CursorValue properties are now functional.
- The onCursorTimeChange event is now functional.
Pm8.02.13: emulated in HTML (i.e. in JavaScript panels):
- The time is now displayed on mouse cursor.
- Bugfix in the AddTrend method.
Pm8.02.12: emulated in HTML (i.e. in JavaScript panels):
- The TimeMin and TimeMax properties are now functional
- Table view of trends is now functional
Pm8.01.06:
- sometimes the SaveCfg and LoadCfg methods did not work (bug since Pm8.1.5 version).
- The SaveToHtm method did not work on the Web.
- The autoscroll stopped if the time was changed from normal to daylight saving time.
Pm8.01.04: flickering of axis descriptors when filling graphs with large number of points has been removed.
Pm8.01.00:
- converted to Unicode.
- The LoadCfg method: may now contain the "serverfile.tg:" option allowing to read the group by unified way both locally and on the Web.
Pm8.00.09: Fixed bug: on the Web, it was not possible to add new trends manually.
PROMOTIC 9.0.17 SCADA system documentation - MICROSYS, spol. s r.o.

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