Eine Einzelinstanz-Steuerung prüft, ob der Prozeß bereits ausgeführt wird, der mit PUSH_ACTION gestartet wurde. Wurde der Prozeß noch nicht gestartet, wird PUSH_ACTION ausgeführt. Läuft der Prozeß bereits, wird das betreffende Fenster in den Vordergrund des aktuellen Arbeitsbereichs gebracht.
Mit den folgenden Feldern wird die Funktionsweise der Steuerung definiert:
PUSH_RECALL: Hat den Wert True.
CLIENT_NAME: Gibt der Steuerung den Namen des Client an.
Der Wert von CLIENT_NAME muß mit der ersten Zeichenfolge (res_name) der Eigenschaft WM_CLASS des Hauptfensters der Anwendung übereinstimmen. Weitere Informationen hierzu finden Sie auf der Hilfeseite xprop(1).
PUSH_ACTION: Gibt die Aktion an, die beim Klicken auf die Steuerung ausgeführt wird.
Folgende Steuerung startet eine Instanz einer Anwendung, deren Aktion den Namen 'MyEditor' hat.
CONTROL MyEditor { TYPE icon CONTAINER_NAME Top CONTAINER_TYPE BOX POSITION_HINTS 15 PUSH_RECALL True CLIENT_NAME BestEditor PUSH_ACTION StartMyEditor ICON MyEd }