Promotic
WikipediaLinkedInYoutubeTwitterFacebook

Preconfiguration "Layered bar graph"

Creates the PmgCanvas object configured as layered bar graph.
 
This preconfiguration can be activated when creating a new Pmg object and is included in the group: " / Chart, functions".
 
This object contains embedded PmgCanvas object named "Dynamic". The item has the variable values0, values1, ... of the String type containing values separated by semicolon. It is possible to connect it to the measured value of the same data structure by data binding. The variables of the parent object are accessible in the onDraw event by using the pEvent.GetParentVar().
 
In the PmgCanvas object, there are variables minX, maxX, minY, maxY, spaceX and spaceY. These variables define the scale range in both x and y axes and also the offset of axes from left and bottom edge of the Pmg object.
 
Additional configuration variables are located at the beginning of context itself, or at the beginning of designer's method. The following items can be set:
- colorScale color of ticks and scale descriptions
- nMajY number of main ticks on y axis
- nMinY number of minor ticks (between two main ticks) on y axis
- nDescPer specifies the quantity of displayed descriptors of main ticks (0 = no, 1 = every main, 2 = every second main)
- nMajX number of main ticks on x axis
- nMinX number of minor ticks (between two main ticks) on x axis
- colorArea background color of the graph rendering area
- colorGrid grid color
- nGridPer specifies quantity of displayed horizontal/vertical grid lines (0 = no, 1 = every main, 2 = every second main)
- nTextSize scale description text size

The parent Pmg object contains other variables

- spaceX value defines the distance of y axis from the left border
- spaceY value defines the distance of x axis from the bottom border
 
The preconfiguration is set for 4 values composing color layers of each bar. If you need to change the number of values (layers), then follow these steps:
- in variables of the parent object change the number of defined colors
- create or delete variable valuesN in the embedded Dynamic object
- on the "Draw" tab of the embedded object make the change on the row marked by the comment // other values
These configurators can be set before the preconfiguration is created:
Object nameName (identifier) of the Pmg object. It is used to obtain the Pmg object by the PmgObject.Items method.

This configurator sets the initial value of the Name property.

The maximum name length is 30 characters. This is a system name, so it must contain only alphanumeric and must not contain any diacritics, empty string, spaces and the first character must not be a number.

Range from minimum (y)Low limit of the y axis
Range to maximum (y)High limit of the y axis
Bar namesNames of graph bars separated by semicolon
ColorColors in the HTML format (Working with colors description)separated by semicolon.
ValuesBase values(val0)
ValuesBase values(val1)
ValuesBase values(val2)
ValuesBase values(val3)
Data emulation in control variable bindingEmulated data will be generated in the control variable

History:
Pm8.02.06: Created
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