$Group

Top  Previous  Next

Mit $Group=<name> wird eine Gruppe von zusammengehörigen Objekten definiert. Damit kann der Anwender eigene Objekte aus Kombinationen von Basis-Objekten wie z.B. #Bar mit Skala und Wert, usw. definieren.

Die Definition erfolgt wie bei einer #Page nach einer Leerzeile. Als erstes wird der Objekttyp $Group=<name> mit einem eindeutigen Namen versehen. Das $ anstelle von # zeigt an, dass es sich hier um die Definition handelt.  Nach der $Group-Definition werden die zu der Gruppe zusammengefassten Objekte projektiert.

 

Bei der $Group-Objekt Definition wird die Hintergrundfarbe und das Format definiert:

 

Parameter

Wert

M/O

Default

Kommentar

Object        

$Group=<name>

M


Das $ anstelle von # zeigt an, dass sich hier um eine Definition handelt. Dem Objektbezeichner Group folgt durch ein = getrennt die ID. Ein eindeutiger Name in Bezug auf Group.

Text/File


 



Font


 



X


 



Y


 



DX

Ganzzahl

O


Breite des Group-Objekts

DY

Ganzzahl

O


Höhe des Group-Objekts

Color


 



Backcolor

Color

O

Transparent

Hintergrundfarbe:

Statisch oder Group Parameter (Platzhalter s.u.)

Format

Format

O


Art des Rahmen:

statisch oder Group Parameter (Platzhalter s.u.)

Action


 



Limit1


 



Limit2


 



ActionLimit1


 



ActionLimit2


 



VarValue


 



VarType


 



VarState

<variable>

O


Siehe: VarState column

Damit kann die ganze Group ausgeblendet werden

 

statisch oder Group Parameter (Platzhalter s.u.)

Option

VarStateOnOffInverted

 

O


Invertiert die On / Off Funktion der VarState Variable:

 

VarState = 0 -> Off

VarState = 1 -> On

 

statisch oder als Group Parameter (Platzhalter s.u.)

 

Ein #Group Objekt kann jedes beliebige Objekt aufnehmen. Aber nur folgende Objekte können via Group parametriert werden:

 

#Group
#Bar
#Button
#DiagSig
#DropDownList
#Message
#Meter
#MvImg
#Radiobutton
#Signal
#Slider
#Switch
#Textlist
#Trend
#Variable
#VBar
#VMeter

 

Parameter

Den Objekten innerhalb einer $Group-Definition können Parameter übergeben werden. Parameter können pro Spalte mit dem Platzhalter {%x} übergeben werden (x=1 bis n). Wenn mehrere Group-Parameter übergeben werden sollen, so müssen diese kommagetrennt angegeben werden. Der erste Parameter entspricht dann dem Platzhalter {%1}. Jeder weitere durch ein Komma getrennte Parameter wird durch das Erhöhen der Zahl ( {%2} ) projektiert.

Wenn beim Aufruf eines #Group-Objekts ein Komma in einem Parameter übergeben werden soll, muss der Parameter in geschweifte Klammern stehen (Bsp: {text, text} ).

Parameter können optional übergeben werden. D.h. Platzhalter für die kein Parameter übergeben wird, werden entfernt. (durch Leerstring ersetzt)

 

Platzhalter

Ein Platzhalter hat folgendes Format: {%<Paramterernummer>}.

Die Nummerierung der Platzhalter beginnt bei jeder Spalte bei 1.

 

Der Gruppe selber können folgende Properties via Parameter übergeben werden:

BackColor: Hintergrund Farbe setzen
Format:  Border setzen
VarState :Ganze Group ausschalten
Option: Optionen

 

 

 

Beispiel $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

 

 

Beispiel #Group-Objekt

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

 

 

Anzeige

Group