Lenze VisiWinNet VisiWinNET Smart - Handbuch (Seite 120)

Anhang
Skripte
Grundlagen
6
l
120 SHP−VWNS DE/EN 6.1
Rahmenfunktion einfügen
Durch die Auswahl eines Ereignisnamens rechts wird eine Rahmenfunktion eingefügt.
Beispiel für eine Ereignis−Rahmenfunktion:
Private Sub VarIn1_Change(ByVal sender As System.Object, _
ByVal e As VisiWinNET.DataAccess.ChangeEventArgs) Handles VarIn1.Change
End Sub
Das gewählte Objekt "VarIn1" stellt das "Change"−Ereignis zur Verfügung, das die Ände-
rung des Variablenwertes signalisiert. Zum Einfügen der Funktion wurde in der linken Aus-
wahlliste das Objekt "VarIn1" ausgewählt, anschließend in der rechten Auswahlliste
"Change".
Der Funktionskopf der eingefügten Rahmenfunktion beinhaltet:
ƒ Einen Namen für die Funktion ("VarIn1_Change"). Der Name muss innerhalb eines
Codemoduls eindeutig sein.
ƒ Die Parameter "sender" und "e", "sender" ist dabei üblicherweise ein Verweis auf
das Objekt, in dem das Ereignis ausgelöst wurde. "e" beinhaltet üblicherweise
weitere Informationen zum Ereignis.
ƒ Die "Handles"−Klausel bezeichnet die Objekte und Ereignisse, durch die die Funktion
angesprungen wird. In diesem Fall also nur das Change−Ereignis von VarIn1. Sie
können aber weitere Ereignisse mit gleichen Parametern auf die Funktion
umlenken, indem Sie, durch Kommata getrennt, weitere Ereignisbezeichener
(<Objektname>.<Ereignisname>) an die "Handles"−Klausel anfügen. In diesem Fall
wird klar, warum der "Sender"−Parameter mit in die Funktion übergeben wird. Über
"Sender" kann dann das Objekt ermittelt werden, das dieses Ereignis ausgelöst hat.
Das Funktionsende wird durch "End Sub" repräsentiert. Zwischen Funktionskopf und
Funktionsende ist der ausführbare VB−Code erlaubt:
Private Sub VarIn1_Change(ByVal sender As System.Object, _
ByVal e As VisiWinNET.DataAccess.ChangeEventArgs) Handles VarIn1.Change
If e.Value > 50 Then
VarIn1.DataBackColor = System.Drawing.Color.Red
Else
VarIn1.DataBackColor = System.Drawing.SystemColors.Window
End If
End Sub
Beispiel: Innerhalb des e−Arguments werden weitere Informationen zum Ereignis zur Ver-
fügung gestellt. Hier wird anhand der Value−Eigenschaft aus dem Variablen−Kern die Hin-
tergrundfarbe im Datenbereich von "VarIn1" umgeschaltet.
Hilfe beim Erstellen von Skripten
VisiWinNET
â
Smart beinhaltet Programmierschnittstellen für die Oberflächenelemente
und das darunterliegende System.
Welche Funktionen (Eigenschaften/Methoden/Ereignisse) ein Objekt zur Verfügung
stellt, erfahren Sie in Kurzform über das im Quellcodeeditor implementierte Intellisense−
Fenster, das sich automatisch bei der Eingabe von z. B. Objektnamen oder Namensräumen
öffnet (Groß−/Kleinschreibung ist von Bedeutung!).