$Group=<name> is used to define a group of associated objects. This enables the user to define his own objects from combinations of basic objects such as #Bar with scale and value etc.
The definition is carried out as for a #Page after a blank line. The $Group=<name> object type is first given a unique name. The $ instead of # indicates that this is the definition. After the $Group definition the objects combined for the group are configured.
The $Group object definition is used to define the background color and the format:
Parameters |
Value |
M/O |
Default |
Comment |
Object |
$Group=<name> |
M |
The $ instead of # indicates that this is a definition. The object identifier Group is followed by the ID separated by =. A unique name referenced to Group. |
|
Text/File |
|
|||
Font |
|
|||
X |
|
|||
Y |
|
|||
DX |
Integer |
O |
Width of the Group object |
|
DY |
Integer |
O |
Height of the Group object |
|
Color |
|
|||
Backcolor |
O |
Transparent |
Background color: Static or Group parameter (placeholder see below) |
|
Format |
O |
Type of frame: Static or Group parameter (placeholder see below) |
||
Action |
|
|||
Limit1 |
|
|||
Limit2 |
|
|||
ActionLimit1 |
|
|||
ActionLimit2 |
|
|||
VarValue |
|
|||
VarType |
|
|||
VarState |
<variable> |
|
See: VarState column May be used switch off the whole group
Static or Group parameter (placeholder see below) |
|
Option |
VarStateOnOffInverted |
|
Inverts the On / Off functionality of VarState:
VarState = 0 -> Off VarState = 1 -> On
Static or Group parameter (placeholder see below) |
A #Group object can incorporate any object. However, only the following objects can be assigned parameters via Group:
| • | #Bar |
Parameters
The objects within a $Group definition can be assigned parameters. Parameters can be assigned by column with the placeholder {%x} (x=1 to n). If several Group parameters are to be assigned, these must be separated by commas. The first parameter then corresponds to the placeholder {%1}. Each further parameter separated by a comma is configured by increasing the number ( {%2} ).
If a comma is to be assigned in a parameter for a called #Group object, this parameter must be placed in braces (Example: {text, text} ).
Parameters can be assigned as required. In other words, placeholders for which no parameter is assigned are removed. (replaced by an empty string)
A placeholder has the following format: {%<Parameter number>}.
The numbering of the placeholders starts for each column with 1.
It's possible to provide the following properties by parameter:
| • | BackColor |
| • | Format |
| • | VarState |
| • | Option |
Example of $Group definition
Object |
Text/File |
Font |
X [Pixel] |
Y [Pixel] |
DX [Pixel] |
DY [Pixel] |
Color |
BackColor |
Format |
$Group=myVariable |
|
0 |
0 |
200 |
30 |
black |
grey |
|
|
#Signal |
{%1} |
Arial12.FNT |
0 |
0 |
200 |
30 |
black |
transparent |
Border=R1 |
#Variable |
{%2} |
Arial12.FNT |
100 |
1 |
50 |
28 |
black |
grey |
Border=Signal |
#Signal |
{%3} |
Arial12.FNT |
150 |
0 |
50 |
30 |
black |
transparent |
|
#Group object example
Object |
Text/File |
Font |
X [Pixel] |
Y [Pixel] |
DX [Pixel] |
DY [Pixel] |
Color |
BackColor |
Format |
#Page=Init |
|
|
|
|
|
|
|
|
|
#Page=start |
start |
Arial12.FNT |
0 |
0 |
640 |
480 |
black |
white |
Border=R1 |
#Group=myVariable |
Text,%3d,Einheit |
Arial12.FNT |
180 |
175 |
200 |
30 |
black |
white |
|
Display
