Migration - Smarthome-Components

IPS_CreateLink
integer IPS_CreateLink ( )
Rückgabewerte
ID des neu erstellten Links
Beschreibung
Der Befehl legt eine neuen Link 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 Link) ein aussagefähiger Name gegeben werden. Der Name ist
jedoch für die Identifikation irrelevant. Hierfür ist immer die ID zuständig. Weiterhin sollte der Link mit einem anderen
Objekt verknüpft werden. Dies kann über die Funktion IPS_SetLinkTargetID gemacht werden.
Die Funktion liefert eine ID, mit deren Hilfe der erzeugte Link eindeutig identifiziert werden kann.
Beispiel
//Anlegen einer neuen Kategorie mit dem Namen "Regenerfassung"
$LinkID = IPS_CreateLink(); //Link anlegen
IPS_SetName($LinkID, "Regenerfassung"); //Link benennen
IPS_SetLinkChildID($LinkID, 12345); //Link verknüpfen
Benötigt: IP-Symcon >= 2.1