Dokumentation
IPS_GetPresentation
Benötigt: Symcon >= 8.0
array IPS_GetPresentation (string $DarstellungsID)
Parameterliste
| DarstellungsID | Die ID der Darstellung, als GUID formatiert |
Rückgabewert
Folgende Informationen stehen als key => value Paare zur Verfügung:
| Index | Typ | Beschreibung |
|---|---|---|
| caption | string | Der Anzeigename der Darstellung. |
| chart | array | Ein Array mit den Zuweisungen der Parameter für die Darstellung eines Diagramms (Siehe chart Tabelle) |
| condition | array | Eine Liste an Bedingungen, welche die Parameter der Darstellung erfüllen müssen. |
| conversions | array | Eine Liste von Anweisungen, die angewandt werden, um Parameter für verschiedene Variablentypen anzupassen |
| customIcon | boolean | Optional. TRUE, wenn die Darstellung eigene Parameter für das Icon (z.B. ICON) mitbringt |
| form | array/string | Das Konfigurationsformular bestimmt, wie die Parameter im Variablen-Dialog oder dem Vorlagenmanager angepasst werden können. |
| format | array/string | Die Formatierung von Werten innerhalb dieser Darstellung |
| groups | array | Optional. Eine Liste von Gruppen mit Anpassungen für bestimmte Variablentypen (Siehe groups Tabelle) |
| id | string | Die ID der Darstellung, als GUID formatiert |
| locale | array | Die Lokalisierung der Darstellung |
| presentationParameters | array | Eine Liste, welche die Standardwerte der Parameter dieser Darstellung beschreibt |
| presentationValue | mixed | Der Standardwert, welcher in der Darstellungsvorschau angezeigt wird. Kann alternativ auch PHP-Code als Array von Strings enthalten, welcher den Wert zurückgibt |
| restrictions | array | Eine Liste an Einschränkungen, welche festlegt, für welche Variablen diese Darstellung verfügbar ist |
chart Tabelle
Jeder Wert kann entweder eine Zahl sein oder der Name des Parameters, dessen Wert verwendet werden soll.
| Index | Typ | Beschreibung |
|---|---|---|
| min | integer/float/string | Parameter für den Minimalwert |
| max | integer/float/string | Parameter für den Maximalwert |
| stepSize | integer/float/string | Parameter für die Schrittweite |
groups Tabelle
Es wird die erste Gruppe verwendet, deren restrictions den Variablentyp der Variable enthalten. Deren Werte ergänzen bzw. überschreiben die gleichnamigen Werte der Darstellung.
| Index | Typ | Beschreibung |
|---|---|---|
| id | string | Die ID der Gruppe, als GUID formatiert |
| name | string | Der Name der Gruppe |
| restrictions | array | Einschränkungen, für welche Variablen diese Gruppe gilt. Der Eintrag variableType ist eine Liste der Variablentypen |
| presentationParameters | array | Die Standardwerte der Parameter für diese Gruppe |
| format | array/string | Optional. Die Formatierung von Werten für diese Gruppe |
| chart | array | Optional. Die Parameter für die Darstellung eines Diagramms für diese Gruppe |
| condition | array | Optional. Bedingungen, welche die Parameter für diese Gruppe erfüllen müssen |
Beschreibung
Die Funktion liefert ein Array mit Informationen über die Variablendarstellung mit der ID DarstellungsID.
Beispiel
IPS_GetPresentation('{6B9CAEEC-5958-C223-30F7-BD36569FC57A}' /* Schieberegler */);