Platzhalter

Wo können Platzhalter verwendet werden?

Platzhalter können Sie in Eigenschaftswerte, Regeln und Aktionen verwenden. Dort wird jeder Platzhalter zur Laufzeit durch den Wert ersetzt, der dem Platzhalter im platzierten Faceplate zugewiesen wird.

Wie definiere ich einen Platzhalter?

Platzhalter werden im Faceplate-Inspektor im Tab Platzhalter definiert.

Im rechten Eingabefeld Placeholder (Platzhalter) geben Sie den Platzhalter ein, wie Sie Ihn an anderen Stellen innerhalb des Faceplates verwenden möchte. Dies kann ein einzelnes Zeichen, aber auch eine Zeichenkette sein. Bitte beachten Sie, dass wenn Sie den Platzhalter im nachhinein ändern, nicht automatisch alle Vorkommnisse dieses Platzhalters im Faceplate aktualisiert werden. Ändern Sie beispielsweise den Platzhalter von „*“ zu „^“ so müssen Sie die Platzhalter in allen Eigenschaftswerten, Regeln und Aktionen anpassen.

Im linken Eingabefeld Name vergeben Sie dann noch einen eindeutigen Namen, unter dem dieser Platzhalter später im platzierten Faceplate unter den anderen Eigenschaften angezeigt wird.

Wie verwende ich einen Platzhalter?

Einen Platzhalter verwenden Sie, indem Sie den Wert, den Sie als Platzhalter definiert haben, an einer beliebigen Stelle verwenden. Der Platzhalter wird zur Laufzeit automatisch ersetzt.

Beispiel Eigenschaftswert

Wählen Sie zum Beispiel ein Label innerhalb eines Faceplates aus, können Sie als Text-Eigenschaft zum Beispiel den Wert „Output *“ angeben:

Da Sie den Platzhalter „*“ mit dem Namen „Output“ zuvor definiert haben, steht Ihnen dieser Platzhalter nun als Eigenschaft des platzierten Faceplates zur Verfügung:

Im Editor werden Platzhalter noch nicht ausgewertet, erst zur Laufzeit zeigt sich, dass der Platzhalter durch den Wert „1“ ersetzt wird.

Beispiel Eigenschafts-Regel

Innerhalb eines Faceplates können Sie selbstverständlich die Eigenschaften und Ereignisse der Steuerelemente genauso bearbeiten, wie Sie es auch auf einer einfachen Seite können.

Sie können also genauso Regeln und Aktionen anlegen, die dann für alle platzierten Faceplates genau gleich verarbeitet beziehungsweise ausgewertet werden.

Platzieren Sie nun aber ein Faceplate mehrmals, dann haben Sie mit Hilfe von Platzhaltern auch die Möglichkeit, die Regeln und Aktionen innerhalb des Faceplates dynamisch auf verschiedene Variablen verweisen zu lassen. Sie geben also anstelle einer konkreten Variable nur einen Namen ein. Dieser Name kann Platzhalter enthalten, die zur Laufzeit ersetzt werden.

In obigem Beispiel haben wir die Eigenschaft „IsUsed“ des oberen Fördertechnikelements mit einer Regel auf den Wert „test.isused_output*_ft_1“ gebunden. Den Platzhalter (*) können wir nun für jedes einzelne platzierte Faceplate individuell belegen.