BarLabel Benutzer definierte Funktionen

In BarLabel besteht die Möglichkeit, zusätzlich zu den vorhandenen Funktionen, eigene Funktionen selbst zu programmieren. Dies ist nützlich, wenn z.B. geänderte Prüfziffernalgorithmen benutzt werden sollen oder zur komfortablen Zusammenfassung von verschachtelten, immer wiederkehrenden Funktionen.

Hierfür wird die Programmiersprache VB-Script verwendet. Die Funktionen werden im Quellcode in der im Installationsordner vorhandenen Datei "Vbslib.dat" abgespeichert. Diese Datei ist eine reine Textdatei und kann mit jedem Editor selbst bearbeitet werden. Sofort nach dem Speichern der Datei stehen die neuen Funktionen in BarLabel zur Erstellung eines Ausdrucks zur Verfügung.

Jede Funktion hat folgenden Grundaufbau:
Function Funktionsname(Übergabeparameter)
   VB-Script Befehle ....
   .....
   .....
   .....
   Funktionsname = Rückgabewert
End Function


Es können alle gängigen VB-Script Befehle verwendet werden, die zur Berechnung von Werten dienen. Jedoch keine Befehle für Benutzeroberflächen, Datei- oder Registry-Operationen o.ä.


Beispiel:
die Funktion "FormatNullen()" soll eine übergebene Zahl durch das Anfügen führender Nullen auf eine festgelegte Anzahl Stellen formatieren.
Function FormatNullen(Zahl, AnzahlNullen)    'Funktionsname mit den zu übergebenden Parametern
    If AnzahlNullen >= Len(Zahl) Then        'VB-Befehle.....
       Zahl = String(AnzahlNullen - Len(Zahl), "0") & Zahl 
'Formatieren der Zahl
    End If
    FormatNullen = Zahl                     
'Rückgabe der Funktion ist die formatierte Zahl
End Function                                 'Ende dieser Funktion

Weitere Beispiele für mitgelieferte Funktionen:
FormatDatZeit(UebergabeDatum, Datumsformat)
Mehrzeil(Zeile, Anzahl)
pruefz_mod10(param1)


Achtung: bei Neu-Installation der Software und bei Installation eines Updates wird die Datei "Vbslib.dat" überschrieben. Eigene Funktionen werden hierbei gelöscht. Daher ist es sinnvoll, selbst hinzugefügte Funktionen vorher zu sichern und dann in diese Textdatei wieder einzufügen.