Variablenscript
Das Script zum Variablendialog erlaubt es automatisch oder nach Benutzeraktionen den Variablendialog zu steuern und die Variablenw zu verwalten.
Steuerfunktionen
Ereignisgrundfunktionen des Variablendialogs
| Funktion | Beschreibung | Beispiel |
|---|---|---|
function Init() |
Wird beim Öffnen des Variablendialogs aufgerufen. | void function Init(){ «Script»} |
function Exit() |
Wird beim Schliessen des Variablendialogs aufgerufen. Die Funktion muss true zurück geben ansonsten wird der Variablendialog nicht geschlosen. Dies dient zur Prüfung der Variablenwerte ob diese Konsistent sind. | bool function Exit(){ «Script» return true;} |
Grundfunktionen
Variablen Grundfunktionen
| Funktion | Beschreibung | Beispiel |
|---|---|---|
|
||
AfterEditOf_Variablenname |
Wird nach dem Ändern einer Variablen aufgerufen. | void function AfterEditOf_BREITE()
{ «Script» } |
AfterEditOfUnhandledVariable() |
Wird nach dem Ändern einer Variablen aufgerufen, für die kein AfterEditOf definiert ist. | void function AfterEditOfUnhandledVariable()
{ «Script» } |
LockVariable(string _ep_VarName) |
Sperrt die entsprechende Variable. Es können keine Werte mehr gesetzt werden. |
LockVariable("BREITE"); |
UnlockVariable(string _ep_VarName) |
Entsperrt die entsprechende Variable. Es können wieder Werte gesetzt werden. | UnlockVariable("BREITE"); |
HideVariable(string _ep_VarName) |
Blendet die entsprechende Variable aus. | HideVariable("BREITE"); |
ShowVariable(string _ep_VarName) |
Blendet die entsprechende Variable ein. | ShowVariable("BREITE"); |
SelectVariable(string _ep_VarName) |
Springt in der Variablenabfrage auf die bestimmte Variable | SelectVariable("M_ZUBEHOER"); |
SetFilter(string _ep_VarName, string _ep_Filter) |
Setzt den Datenbankfilter bei der entsprechenden Variablen. Die Variable muss vom Typ „Datenbankzugriff“ sein.
Parameter: _ep_VarName: Name der Variablen in Doppelhochkomma. _ep_Filter: Der where-Teil einer SQL-Querry in Doppelhochkomma. |
SetFilter("ARTIKEL", "M_MATGRUPPE_ID = 1050 and PD_STATUS_ID = 1 and PD_BEZ like '%schrank%'"); |
Menü Grundfunktionen
| Funktion | Beschreibung | Beispiel |
|---|---|---|
|
||
HideMenu(string _ep_VarName) |
Versteckt das ganze Menü mit den darin enthaltenen Menüs und Variablen | HideMenu("M_ZUBEHOER"); |
ShowMenu(string _ep_VarName) |
Blendet das ganze Menü ein | ShowMenu("M_ZUBEHOER"); |
ExpandMenu(string _ep_VarName) |
Öffnet ein Menü | ExpandMenu("M_ZUBEHOER"); |
CollapseMenu(string _ep_VarName) |
Schliesst ein Menü | CollapseMenu("M_ZUBEHOER"); |
SelectMenu(string _ep_VarName) |
Springt in der Variablenabfrage auf das entsprechende Menü. | SelectMenu("M_ZUBEHOER"); |
Funktionen für Scriptvariablen
| Funktion | Beschreibung | Beispiel |
|---|---|---|
|
||
OnEdit_Variablenname() |
Diese Funktion wird bei Variablen vom Typ Script benötigt. Sie wird ausgeführt, wenn die Variable im Variablendialog aufgerufen wird. | void function OnEdit_BREITE(){ «Script»} |
ShowdetailsOf_Variablenname() |
Die angesprochene Variable sollte vom Typ Scriptabfrage sein, wodurch der rechte Fensterbereich ein Infoview wird. Es können mit der Funktion Daten und Zeichnungen im Infoview angezeigt werden. Zum Beispiel können über Scriptvariablen durch Dialoge mehrere Eingaben/Auswahlen getroffen werden und die Zusammenfassung dazu kann im Infoview angezeigt werden. | bool function OnEdit_BREITE();
void function ShowdetailsOf_BREITE() { SetPosition(5,5); DrawText("TEST",500); } |
Erweiterte Steuerfunktionen
| Funktion | Beschreibung | Beispiel |
|---|---|---|
|
||
SetVariableFromDouble(string __varname, double __val_d); |
Setzt einen Wert im angesprochenen Werte-Bereich der Variablen.
Parameter __varname: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. __val_d: Wert vom Typ double, der im angesprochenen Werte-Bereich gesetzt werden soll. |
SetVariableFromDouble("BREITE_STD", 300.5); |
SetVariableFromLong(string __varname, long __val_l); |
Setzt einen Wert im angesprochenen Werte-Bereich der Variablen.
Parameter __varname: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. __val_d: Wert vom Typ long, der im angesprochenen Werte-Bereich gesetzt werden soll. |
SetVariableFromLong("BREITE_STD", 300); |
SetVariableFromString(string __varname, string __val_s); |
Setzt einen Wert im angesprochenen Werte-Bereich der Variablen.
Parameter __varname: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. __val_d: Wert vom Typ string in Doppelhochkomma, der im angesprochenen Werte-Bereich gesetzt werden soll. |
SetVariableFromString("TABLAR_STD","WERT"); |
Subvariablen-Steuerfunktionen
| Funktion | Beschreibung | Beispiel | |
|---|---|---|---|
|
|||
|
SetSubVariable(string _ep_SubVarName, string _ep_VarName, string _ep_VarValue) | Setzt einen Wert im angesprochenen Werte-Bereich der Subvariablen.
Parameter _ep_SubVarName: Name der Variablen in Doppelhochkomma _ep_VarName: Name der Subvariable in Doppelhochkomma _ep_VarValue: Wert, der im angesprochenen Werte-Bereich gesetzt werden soll in Doppelhochkomma. |
SetSubVariable("ZUBEHOER", "BREITE_STD", "200"); |
SetVGRVariable(string _ep_VarName, string _ep_VarValue) |
Setzt einen Wert im angesprochenen Werte-Bereich der Variablen. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehrere Subvariablen hinweg) gesetzt werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss.
Parameter _ep_VarName: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. Optional kann davor der Parent- Variablennamen der angesprochenen Subvariablen angegeben werden, welcher durch einen Punkt getrennt wird. _ep_VarValue: Wert, der im angesprochenen Werte-Bereich gesetzt werden soll in Doppelhochkomma. Die Typkonvertierung erfolgt automatisch. |
SetVGRVariable ("ZUBEHOER.BREITE_STD", "300");
Das Ergebnis der obigen Funktion entspricht dem Ergebnis folgender Funktion: SetSubVariable("ZUBEHOER", "BREITE_STD", "300"); | |
SetVGRVariableFromString(string _ep_VarName, string _ep_VarValue) |
Setzt einen Wert im angesprochenen Werte-Bereich der Variablen. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehrere Subvariablen hinweg) gesetzt werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss.
Parameter _ep_VarName: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. Optional kann davor der Parent- Variablennamen der angesprochenen Subvariablen angegeben werden, welcher durch einen Punkt getrennt wird. _ep_VarValue: Wert vom Typ string, der im angesprochenen Werte-Bereich gesetzt werden soll in Doppelhochkomma. |
SetVGRVariableFromString ("ZUBEHOER.BREITE_STD", "300"); | |
SetVGRVariableFromLong(string _ep_VarName, long _ep_VarValue) |
Setzt einen Wert im angesprochenen Werte-Bereich der Variablen. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehrere Subvariablen hinweg) gesetzt werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss.
Parameter _ep_VarName: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. Optional kann davor der Parent- Variablennamen der angesprochenen Subvariablen angegeben werden, welcher durch einen Punkt getrennt wird. _ep_VarValue: Wert vom Typ long, der im angesprochenen Werte-Bereich gesetzt werden soll. |
SetVGRVariableFromLong("ZUBEHOER.BREITE_STD", 300); | |
SetVGRVariableFromDouble(string _ep_VarName, double _ep_VarValue) |
Setzt einen Wert im angesprochenen Werte-Bereich der Variablen. Bei dieser Funktion können auch Werte in Subvariablen (auch über mehreren Subvariablen hinweg) gesetzt werden, wobei bei dieser Funktion vor der Subvariablen die dazugehörige Parent-Variable – durch einen Punkt getrennt – angeführt werden muss.
Parameter _ep_VarName: Name der Variablen mit angeführtem Werte-Bereich, in Doppelhochkomma. Optional kann davor der Parent- Variablennamen der angesprochenen Subvariablen angegeben werden, welcher durch einen Punkt getrennt wird. _ep_VarValue: Wert vom Typ double, der im angesprochenen Werte-Bereich gesetzt werden soll. |
SetVGRVariableFromDouble("ZUBEHOER.BREITE_STD", 300.5); |
Parent-Steuerfunktionen
| Funktion | Beschreibung | Beispiel |
|---|---|---|
SetParentVariable(string _ep_VarName, string _ep_VarValue) |
Setzt einen Wert im angesprochenen Werte-Bereich der Parent-Variablen.
Parameter _ep_VarName: Name der Variablen mit angeführtem Werte-Bereich der Parent-Variablen, in Doppelhochkomma _ep_VarValue: Wert, der im angesprochenen Werte-Bereich gesetzt werden soll in Doppelhochkomma. |
SetParentVariable("BREITE_STD", "200"); |
Abfragefunktionen
Allgemeine Abfragefunktionen
| Funktion | Beschreibung | Beispiel |
|---|---|---|
|
||
IsVariableVisible(long _ep_idx) |
Zum Abfragen, ob die angesprochene Variable unsichtbar oder sichtbar ist. | MgB( string(IsVariableVisible(0) );
Rückgabewert vom Typ long: 0 = Variable ist unsichtbar 1 = Variable ist sichtbar |
IsVariableLocked(long _ep_idx) |
Zum Abfragen, ob die angesprochene Variable nicht gesperrt oder gesperrt ist. | MgB( string(IsVariableLocked(0) );
Rückgabewert vom Typ long: 0 = Variable ist nicht gesperrt 1 = Variable ist gesperrt |
GetVariableIndex(string _ep_VarName) |
Gibt die Indexnummer der entsprechenden Variablen wieder. | MgB(string( GetVariableIndex("BREITE") ));
Rückgabewert vom Typ long. |
GetVariableCount() |
Gibt die Anzahl der Variablen in der Variablengruppe wider. | MgB( GetVariableCount() );
Rückgabewert vom Typ long. |
GetVariableName(long _ep_idx) |
Gibt den Namen der Variablen wider, welche die entsprechende Indexnummer besitzt. Die fortlaufende Indexnummerierung der Variablengruppe beginnt mit 0. |
MgB( GetVariableName(0) ); Rückgabewert vom Typ string. |
GetVariableBez(long _ep_idx) |
Gibt die Bezeichnung der Variablen wider, welche die entsprechende Indexnummer besitzt. | MgB( GetVariableBez(0) );
|
GetVariableId(long _ep_idx) |
Gibt die ID der Variablen wider, welche die entsprechende Indexnummer besitzt. | MgB(string( GetVariableId(0) ));
Rückgabewert vom Typ long. |
GetVariableType(long _ep_idx, long _ep_bereich) |
Gibt einen Wert vom Typ long wider, welcher den Grundtyp der Variable im jeweiligen Werte-Bereich beschreibt.
Parameter _ep_idx : Indexnummer der Variablen _ep_bereich: Werte-Bereich der Variablen, der angesprochen werden soll: 0 = STD 1 = CAD 2 = PE 3 = AV |
MgB( string(GetVariableType(2, 0) );
Rückgabewert vom Typ long: 0 = keinen Typ definiert 1 = A (alphanummerische Zeichen = string) 2 = I (ganze Zahlen = long) 3 = N (nummerische Zahlen = double)
|
GetVariableTypeDynamic(long _ep_idx, long _ep_bereich) |
Funktioniert wie GetVariableType, nur wenn im angesprochenen Werte-Bereich kein Typ definiert ist, wird der Typ vom STD-Werte-Bereich widergegeben. | |
GetVariableTypeDef(long _ep_idx, long _ep_bereich) |
Gibt den genauen Wert wider, welcher den Typ der Variable im jeweiligen Werte-Bereich beschreibt.
Parameter _ep_idx : Indexnummer der Variablen _ep_bereich: Werte-Bereich der Variablen, der angesprochen werden soll: 0 = STD 1 = CAD 2 = PE 3 = AV |
MgB( string(GetVariableTypeDef(2, 0) );
Rückgabewert vom Typ string, zum Beispiel: A30 N10.2 I |
GetVariableDBTable(long _ep_idx) |
Gibt den/die Tabellennamen-Feld der Variablen wider. Die Variable muss vom Typ Datenbankzugriff sein. | MgB( GetVariableDBTable(4) );
Rückgabewert vom Typ string. |
GetVariableDBFilter(long _ep_idx) |
Gibt das Filter-Feld der Variablen wider. Die Variable muss vom Typ Datenbankzugriff sein. Es wird nur der string widergegeben, der im Filter-Feld der Variablen in der Variablendefinition enthalten ist. Wird ein Filter per Script mit SetFilter gesetzt, wird dieser nicht widergegeben. | MgB( GetVariableDBFilter(4) );
Rückgabewert vom Typ string.
|
GetVariableDBSearchField(long _ep_idx) |
Gibt das Suchfeld der Variablen wider. Die Variable muss vom Typ Datenbankzugriff sein. Es wird nur der string widergegeben, der im Suchfeld der Variablen in der Variablendefinition enthalten ist. | MgB( GetVariableDBSearchField(4) );
Rückgabewert vom Typ string. |
GetVariableAsLong(string __VarName) |
Gibt den Wert der Variablen im angegebenen Werte-Bereich als long wider. Der Variablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | MgB(string( GetVariableAsLong("BREITE_STD") ));
Rückgabewert vom Typ long. |
GetVariableAsDouble(string __VarName) |
Gibt den Wert der Variablen im angegebenen Werte-Bereich als double wider. Der Variablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | MgB(string( GetVariableAsDouble("BREITE_STD") ));
Rückgabewert vom Typ double. |
GetVariableAsString(string __VarName) |
Gibt den Wert der Variablen im angegebenen Werte-Bereich als string wider. Der Variablennamen mit _Werte-Bereich muss in Doppelhochkomma angeführt werden. | MgB( GetVariableAsString("BREITE_STD") );
Rückgabewert vom Typ string. |