Dokumentation
IPS_SetEventConditionVariableDynamicRule
Benötigt: Symcon >= 6.1
bool IPS_SetEventConditionVariableDynamicRule (int $EreignisID, int $BedingungsID, int $RegelID, int $VariablenID, int $Vergleich, int $VergleichVariablenID)
Parameterliste
| EreignisID | ID des zu verändernden Ereignisses |
|||||||||||||||||||||
| BedingungsID | ID der Bedingung, welche die Regel beinhaltet |
|||||||||||||||||||||
| RegelID | Eindeutige ID für diese Regel. IDs müssen nur für diese Bedingung eindeutig sein. |
|||||||||||||||||||||
| VariablenID | ID der geprüften Variable |
|||||||||||||||||||||
| Vergleich |
|
|||||||||||||||||||||
| VergleichVariablenID | ID der Variablen, mit der der Wert verglichen werden soll |
Rückgabewert
Konnte die Funktion erfolgreich ausgeführt werden, liefert sie als Ergebnis TRUE, andernfalls FALSE.
Beschreibung
Diese Funktion modifiziert die Regel mit der ID RegelID der Bedingung mit der ID BedingungsID des Ereignisses mit der ID EreignisID. Die Regel vergleicht die Variable mit der ID VariablenID mit dem Wert der Variable mit der ID VergleichVariablenID entsprechend der Vergleichsoperation Vergleich. Falls keine Regel mit der ID RegelID existiert, wird eine erstellt.
Ist VariablenID 0, wird die Regel mit der ID RegelID gelöscht.
Für die Variablentypen Boolean und String stehen nur die ersten beiden Vergleichsoperatoren zur Verfügung. Dies gilt sowohl für VariablenID als auch für VergleichVariablenID.
Beispiel
// Erstelle eine Wurzelbedingung für das Ereignis mit ID 12345
IPS_SetEventCondition(12345, 0, 0, EVENT_CONDITION_OPERATION_AND);
// Füge eine Regel mit der ID 2 hinzu: Variable 23456 < Variable 34567
IPS_SetEventConditionVariableDynamicRule(12345, 0, 2, 23456, EVENTCONDITIONCOMPARISON_SMALLER, 34567);
// Lösche die Regel mit der ID 2
IPS_SetEventConditionVariableDynamicRule(12345, 0, 2, 0, 0, 0);