Migration - Smarthome-Components

IPS_CreateCategory
integer IPS_CreateCategory ( )
Rückgabewerte
ID des neu erstellten Objekts
Beschreibung
Der Befehl legt eine neue Kategorie an. Er benötigt keine Parameter. Nach Ausführung des Befehls erscheint im
Kategorienbaum von IP-Symcon ein neues Objekt mit der Bezeichnung z.B. ”Unnamed Object (ID: 48490)”. Mit Hilfe
des Befehls IPS_SetName kann dem Objekt (hier der Kategorie) ein aussagefähiger Name gegeben werden. Der Name ist
jedoch für die Identifikation irrelevant. Hierfür ist immer die ID zuständig.
Die Funktion liefert eine ID, mit deren Hilfe die erzeugte Kategorie eindeutig identifiziert werden kann.
Beispiel
// Anlegen einer neuen Kategorie mit dem namen "Regenerfassung"
$CatID = IPS_CreateCategory(); // Kategorie anlegen
IPS_SetName($CatID, "Regenerfassung"); // Kategorie benennen