Dokumentation
MaintainVariable
Benötigt: IP-Symcon >= 4.0
variant MaintainVariable (string $Ident, string $Name, int $Typ, variant $ProfilOderDarstellung, int $Position, boolean $Beibehalten)
Parameterliste
| Ident | Ident der Statusvariable |
| Name | Name der Statusvariable |
| Typ | Typ der Statusvariable |
| ProfilOderDarstellung | Name des Variablenprofils oder Konfiguration der Darstellung welche verwendet werden soll |
| Position | Postion im Objektbaum und somit auch im WebFront |
| Beibehalten | Register wenn True, Unregister wenn False |
Rückgabewert
| Klasse | Typ | Beschreibung |
|---|---|---|
| IPSModuleStrict | boolean | Gibt zurück, ob die Variable erstellt wurde. Der Rückgabewert kann genutzt werden, um z.B. einen Initialwert zu setzen |
| IPSModule | integer | VariablenID der erstellten Statusvariable |
Beschreibung
Wenn der Parameter Beibehalten == true ist, dann wird die Typ Typ passende Statusvariable mit dem Ident Ident und dem Namen Name erstellt.
Wenn der Parameter Beibehalten == false ist, dann wird die Statusvariable mit dem Ident Ident gelöscht.
Darstellung für Variablen gibt es seit der Version 8.0
Der Wert von Typ enthält den Variablentyp (0: Boolean, 1: Integer, 2: Float, 3: String). Siehe auch IPS_CreateVariable oder IPS_GetVariable
Beispiel
// Wir haben diese Statusvariable nur, wenn der Gerätetyp == 5 ist
// IPSModuleStrict
$erstellt = $this->MaintainVariable("Status", "Status des Device", 3, "MeinVariablenProfilfuerStatus", 0, $this->ReadPropertyInteger("DeviceType") == 5);
if ($erstellt) {
// Initialer Wert soll true sein
$this-SetValue("Status", true);
}
// IPSModule
$variablenID = $this->MaintainVariable("Status", "Status des Device", 3, "MeinVariablenProfilfuerStatus", 0, $this->ReadPropertyInteger("DeviceType") == 5);