Dokumentation
IPS_SetEventScheduleGroupPoint
Benötigt: Symcon >= 3.2
bool IPS_SetEventScheduleGroupPoint (int $EreignisID, int $GruppenID, int $SchaltpunktID, int $StartStunde, int $StartMinute, int $StartSekunde, int $AktionsID)
Parameterliste
| EreignisID | ID des zu verändernden Ereignisses |
| GruppenID | ID der Gruppe, zu welcher der Schaltpunkt gehört. Die Gruppe muss bereits existieren. |
| SchaltpunktID | Eindeutige ID für diesen Schaltpunkt. IDs müssen nur für diese Gruppe eindeutig sein. |
| StartStunde | Start-Stunde (0..23) |
| StartMinute | Start-Minute (0..59) |
| StartSekunde | Start-Sekunde (0..59) |
| AktionsID | ID der Wochenplanaktion, welche zum Zeitpunkt ausgeführt werden soll. Die ID muss gültig sein. |
Rückgabewert
Konnte die Funktion erfolgreich ausgeführt werden, liefert sie als Ergebnis TRUE, andernfalls FALSE.
Beschreibung
Die Funktion setzt den Schaltpunkt mit der Kombination aus StartStunde, StartMinute und StartSekunde für die SchaltpunktID der Gruppe mit GruppenID eines Wochenplan Ereignisses mit der ID EreignisID.
Wenn StartStunde, StartMinute oder StartSekunde außerhalb des gültigen Bereichs ist (StartStunde < 0 oder > 23, StartMinute < 0 oder > 59, StartSekunde < 0 oder > 59, z.B. -1), wird der Schaltpunkt mit der angegebenen SchaltpunktID gelöscht. Existiert kein Schaltpunkt mit dieser ID, wird ein Fehler ausgegeben.
Innerhalb einer Gruppe darf maximal ein Schaltpunkt dieselbe Kombination aus StartStunde, StartMinute und StartSekunde besitzen
Beispiel
//Anlegen von Schaltpunkten für Gruppe mit ID = 0 (=Mo-Fr)
IPS_SetEventScheduleGroupPoint($EreignisID, 0, 0, 8, 0, 0, 1); //Um 8:00 Aktion mit ID 1 (=Warm) aufrufen
IPS_SetEventScheduleGroupPoint($EreignisID, 0, 1, 22, 30, 0, 3); //Um 22:30 Aktion mit ID 3 (=Öko) aufrufen
//Schaltpunkt mit ID 1 für Gruppe mit ID = 0 (=Mo-Fr) wieder löschen
IPS_SetEventScheduleGroupPoint($EreignisID, 0, 1, -1, -1, -1, 1);