Dokumentation
IPS_SetVariableProfileAssociation
boolean IPS_SetVariableProfileAssociation (string $ProfilName, variant $Wert, string $Name, string $Icon, int $Farbe)
Parameterliste
| ProfilName | Name des Profils. Verfügbare Profile können über IPS_GetVariableProfileList abgefragt werden. |
| Wert | Wert, zu dem der Name, das Icon und die Farbe verknüpft werden sollen |
| Name | Name zum angegebenen Wert |
| Icon | Icon zum angegebenen Wert |
| Farbe | Farbwert im HTML Farbcode (z.b. 0x0000FF für Blau). Sonderfall: -1 für transparent |
Rückgabewert
Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis TRUE, andernfalls FALSE.
Beschreibung
Die Funktion setzt den Namen, das Icon und die Farbe für einen Wert eines Variablenprofils mit Namen ProfilName. Die Farbe wird nicht angezeigt für Profile vom Typ Wertanzeige/Slider (siehe Objekt-Darstellung).
Wenn Name und Icon leer sind, wird die Assoziation zum angegebenen Wert gelöscht. Bei Boolean Profilen kann keine Assoziation gelöscht werden.
Standardprofile, die nicht geändert werden können, fangen mit einer Tilde (~) an.
Beispiel
//Anlegen für Wert 1 in der Farbe weiß
IPS_SetVariableProfileAssociation("Temperatur", 1, "Wert 1", "Speaker", 0xFFFFFF);
//Anlegen für Wert "sum" in der Farbe gelb
IPS_SetVariableProfileAssociation("Jahreszeit", "sum", "Sommer", "Sun", 0xFFFF00);
//Löschen für Wert 1
IPS_SetVariableProfileAssociation("Temperatur", 1, "", "", -1);