openAES()
Öffnet den Alarm- und Ereignisschirm an gewünschte x/y-Position und erlaubt eine Aktion auszuführen wie z.B. die obere Tabelle des Alarm- und Ereignisschirms auszudrucken oder die Tabelle zu speichern.
Synopsis
int openAES ( string screenConfig, string module, int action, [ string fileName], int xPos, int yPos);
Parameter
| Parameter | Bedeutung |
| screenConfig | Name der Schirmkonfiguration. Hier wird der Name der Schirmkonfiguration aus dem Panel Tabellenkonfiguration angegeben z.B. "aes_default". Sie können hier auch eine selbst erstellte Konfiguration verwenden. |
| module |
Name des Moduls in dem der Alarm- und Ereignisschirm geöffnet werden soll. Der Defaultwert ist "WinCC OA AES". Wenn also kein Modulname angegeben wird, wird der Modulname "WinCC OA AES" verwendet. Sie können den Wert TRUE anstatt einen Modulnamen angeben und der Alarm- und Ereignisschirm wird onTop (der Schirm bleibt immer das oberste Panel) geöffnet. Wenn Sie wiederum den Wert FALSE angeben, wird der Alarm- und Ereignisschirm notOnTop (es können andere Panels im Vordergrund gezeigt werden obwohl der Alarm- und Ereignisschirm geöffnet ist) geöffnet. Wenn der Parameter nicht leer (ein Modulname wurde definiert) und nicht TRUE oder FALSE ist, wird der Modulname verwendet.
openAES("aes_default") // Öffnet laut Einstellung openAES("aes_default", TRUE) // Öffnet onTop openAES("aes_default", FALSE) // Öffnet notOnTop openAES("aes_default", "HUGO") // Öffnet nach Einstellung im Modul HUGO |
| action |
Die Aktion, die ausgeführt werden soll. Die Aktion wird als Konstante angegeben. Mögliche Konstante sind: const int AES_ACTION_INTERACT = 0; // Default Modus const int AES_ACTION_AUTORUN = 1; // Startet den Schirm laufend. const int AES_ACTION_PRINT = 2; //Druckt die obere Tabelle des Alarm- und Ereignisschirms aus.
Hinweis: Beachten Sie, dass Drucken nur im geschlossenen Modus möglich ist. D.H. selektieren Sie den geschlossenen Modus im Panel Eigenschaften der Meldetabelle und speichern Sie diese Konfiguration. Im Panel Tabellenkonfiguration selektieren Sie dann diese Konfiguration für die Option "Eigenschaften" auf der Registerkarte "Allgemeine AES-Einstellungen".
const int AES_ACTION_SAVE = 3; // Ermöglicht den Alarm- und Ereignisschirm zu speichern.
Die Konstanten finden Sie unter <version_path>/scripts/libs/aes.ctl |
|
fileName
|
Der Dateiname der Datei, die ausgedruckt werden soll. Beachten Sie, dass hier ein relativer Pfad verwendet werden soll. Die Dateien, die über den Alarm- und Ereignisschirm gespeichert werden (und ausgedruckt werden können), liegen unter <proj_path>/data. |
| xPos | Die X-Position vom Panel z.B. 200. openAES(screenConfig, module, action," ",200,100 ); |
| yPos | Die Y-Position vom Panel z.B. 100. openAES(screenConfig, module, action," ",200,100 ); |
Rückgabewert
Im Normalfall 0, bei Fehlern (wenn die Schirmkonfiguration nicht gefunden wurde) -1.
Fehler
Wenn die Schirmkonfiguration nicht gefunden wurde.
Beschreibung
Öffnet den Alarm- und Ereignisschirm.
Beispiel
Das Beispiel öffnet den Alarm- und Ereignisschirm.
| main(){ string screenConfig, module, fileName; int action = AES_ACTION_PRINT; // Druckt die Tabelle aus screenConfig = "config"; /* Schirmkonfiguration aus dem Panel Tabellenkonfiguration */ module = "Vision_2"; /* Name des Moduls in dem der Alarm- und Ereignisschirm geöffnet werden soll */ fileName = "tabelle1"; /* Name der Datei, die ausgedruckt werden soll. Die Dateien, die über den Alarm- und Ereignisschirm gespeichert werden (und ausgedruckt werden können), liegen unter <proj_path>/data */ openAES(screenConfig, module, action, fileName); DebugN("Funktion erfolgreich ausgeführt");} |
Zuordnung
Alarm- und Ereignisschirm, Meldebehandlung
Verfügbarkeit
CTRL
Siehe auch
