Skip to main content

Registerkarte: Einstellungen

Funktion: Die Registerkarte enthält Einstellungen für alle applikationsweit verfügbaren Visualisierungen.

Symbol: _visu_icon.png

Anmerkung

Bei einer integrierten CODESYS -Visualisierung stehen nicht alle Einstellungen zur Verfügung.

Gruppe: Allgemeine Einstellungen

Unicode-Zeichenfolgen verwenden

standard icon: Die Visualisierung kodiert Zeichenfolgen als Unicode

CurrentVisu-Variable verwenden

standard icon: Die Applikation kennt und verwendet die globale Variable VisuElems.CurrentVisu des Typs STRING

Sie enthält zur Laufzeit der Applikation den Namen der gerade aktiven Visualisierung.

Im Applikationscode kann die Variable gelesen werden, um den Namen der gerade aktiven Visualisierung zu erhalten. Auf die Variable kann geschrieben wird, um einen Visualisierungswechsel hervorrufen. Die Umschaltung erfolgt auf allen Anzeigegeräten parallel.

Beispiel: Es sind aktuell eine TargetVisu- und mehrere WebVisu-Darstellungsvarianten aktiv. Wenn auf die CurrentVisu-Variable geschrieben wird, wechseln alle Darstellungsvarianten zu dieser Visualisierung.

Voraussetzung: Die Applikation enthält eine Visualisierung, die weitere Visualisierungen aufruft

Beispiel:

  • Zuweisung Variable: VisuElems.CurrentVisu := strVisuName;

  • Zuweisung Visualisierungsname: VisuElems.CurrentVisu := 'visu1';

Client-Animation und Überlagerung systemeigener Elemente unterstützen

standard icon: Visualisierungselemente können durch den Client animiert werden

Diese Funktion ist nur im Browser einer CODESYS WebVisu und in einer CODESYS TargetVisu möglich. Die CODESYS TargetVisu muss diese Funktion jedoch unterstützen. In den Visualisierungselementen werden dann zusätzliche Eigenschaften sichtbar.

Weiterhin können systemeigene Elemente, die in die Visualisierung eingebunden sind (beispielsweise ein Webbrowser), mit CODESYS-eigenen Elementen überlagert werden. Dies ist mit CODESYS-Versionen vor 3.5.16.0 nicht möglich.

Anmerkung

Es gilt momentan folgende Einschränkung:

Bei verschachtelten Frames in Kombination mit einer Skalierung können Elemente minimal anders positioniert sein.

Gruppe: Stilkonfiguration

Tipp

Sie können mit dem Visualisierungsstil-Editor neue Stile erzeugen, überprüfen und im Visualisierungsstil-Repository installieren.

Ausgewählter Stil

  • Stil aus dem Visualisierungsstil-Repository, den jede Visualisierung der Applikation anwendet

    Beispiel Flat Style

  • <Kein>: Die Visualisierung stellt ihre Elemente stillos oder gemäß interner Voreinstellung dar. In den Elementeigenschaften Farbe und Schriftart erscheint zur Auswahl ein Standarddialog statt einer Auswahlliste.

_cds_icon_drop_down_list.png

Öffnet eine Auswahlliste mit Stilen, die im Visualisierungsstil-Repository installiert sind

Alle Versionen anzeigen (nur für Experten)

_cds_icon_option_deactivated.png: Die Auswahlliste enthält jeweils nur die neueste Version des ausgewählten Stils und aller weiteren Stile. Wenn für den ausgewählten Stil eine neuere Version installiert ist, wird diese auch angezeigt.

standard icon: Die Auswahlliste enthält alle Versionen aller installierten Stile

Schaltfläche _visu_icon_activate_style_editor_cmds.png

Öffnet eine Auswahlliste mit Befehlen für die Anwendung des Visualisierungsstil-Editor

Stileditor öffnen

Der Visualisierungsstil-Editor öffnet sich

Abgeleiteten Stil erstellen und bearbeiten

Der Visualisierungsstil-Editor öffnet sich mit dem Dialog Neuen Visualisierungsstil erzeugen. Der Dialog enthält die Einstellungen für den ersten Konfigurationsschritt.

Voraussetzung: In Ausgewählter Stil ist ein Stil ausgewählt, der als Basisstil eingetragen wird.

Anmerkung

Ein abgeleiteter Stil ist sinnvoll, wenn Sie nur wenige Stileigenschaften anpassen oder ergänzen möchten.

Stil kopieren und bearbeiten

Der Visualisierungsstil-Editor öffnet sich mit dem Dialog Bestehenden Stil als Kopie öffnen. Der Dialog enthält die Einstellungen für den ersten Konfigurationsschritt.

Voraussetzung: In Ausgewählter Stil ist ein Stil ausgewählt.

Vorschau

Die dargestellten Elemente repräsentieren den in Ausgewählter Stil angegebenen Stil

Gruppe: Spracheinstellung

Ausgewählte Sprache

Sprache, die die Darstellungsvariante bei Start einer Visualisierung verwendet

Gruppe: Zusätzliche Einstellungen

Multitouch-Bedienung

Diese Eigenschaft legt fest, wer die Touch-Ereignisse handhabt. Entweder übernimmt dies die Visualisierung oder im Falle der WebVisu der Browser. Mit dieser Einstellung können Touch-Gesten auf verschiedenen Visualisierungselementen ausgeführt werden.

standard icon: Die Visualisierung verarbeitet Benutzereingaben über Gesten, Touch- und Mausereignisse. Die WebVisu leitet diese Ereignisse nicht an den Browser weiter (kein Scrollen möglich). Das Weiterleiten der Ereignisse betrifft nur die WebVisu, nicht die TargetVisu)

_cds_icon_option_deactivated.png: Die Visualisierung verarbeitet Eingabeereignisse nicht explitzit. Im Browser funktionieren Maus-, Touch- und Gestenereignisse wie gewohnt.

Betroffene Elemente

  • Elemente mit Eingabekonfiguration

  • Element des Typs Frame

  • Element des Typs Registerkarten

  • Tabelle, Alarmtabelle, Combobox Integer, Combobox Array mit der Eigenschaft Unskaliert und scrollbar

    Diese Scrollelemente können entweder mit einer Geste (Touch-Ereignis) oder mit einem Scrollbar (Mausereignis) gescrollt werden. Der Scrollbar muss explizit konfiguriert werden. Aktivieren Sie daher die Eigenschaft Scrollelemente mit Scrollbar, wenn ein Element mit Scrollbar ausgestattet sein soll.

Scrollelemente mit Scrollbar

standard icon: Die Scrollelemente werden mit einem Scrollbar dargestellt. Nur damit kann der Inhaltsausschnitt mit Maus gescrollt werden.

_cds_icon_option_deactivated.png: Das Scrollen mit einer Pan-Geste ist aktiviert.

Betroffen von dieser Option sind die Visualisierungselemente Tabelle, Alarmtabelle, Combobox Integer, Combobox Array und Frame mit der Eigenschaft Unskaliert und scrollbar.

Semitransparentes Zeichnen

standard icon: Die Visualisierung zeichnet die Elemente in semitransparenter Farbe.

Dafür können Sie bei der Definition einer Farbe zusätzlich einen Abstufungswert für die Transparenz angeben. In der Eigenschaft Transparenz ist die Durchsichtigkeit definiert.

In Farbvariablen wird das führende Byte ausgewertet.

Voreinstellung: Aktiviert.

Voraussetzung: Sie erstellen eine Visualisierung neu und die Darstellungsvarianten können semitransparent zeichnen.

Standardtastaturbedienung

Folgende Benutzereingaben werden standardmäßig bereitgestellt:

  • Tabulator

    Tipp

    Konfigurieten Sie dessen Verhalten in Tabulatorreihenfolge in der Elementliste.

  • Umschalt + Tabulator

  • Eingabe

  • Pfeil nach oben

  • Pfeil nach unten

  • Pfeil nach rechts

  • Pfeil nach links

Deaktivierte Elemente grau zeichnen

standard icon: Alle deaktivierten Elemente werden ausgegraut, ohne dass Sie deren Elementeigenschaften, wie beispielsweise Farbvariablen, konfiguriert haben.

Folgendes führt dazu, dass ein Element deaktiviert ist:

  • Die Variable, die der Elementeigenschaft Zustandsvariablen, Eingaben deaktivieren zugewiesene wurde, ist auf TRUE gesetzt.

  • Die Visualisierungsbenutzerverwaltung verbietet dem Benutzer die Durchführung von Eingaben. Der Benutzer hat das Zugriffsrecht nur sichtbar.

Aufrufen nach Visualisierungsinitialisierung

Funktionsname. Die Funktion wird nach der Initialisierung aufgerufen. Das ist der richtige Zeitpunkt, um einen zusätzlich gewünschten Eventhandler beim EventManager zu registrieren.

Beispiel: VisuInit

Implementierung von VisuInit:

// This function is called after visu initialization (see Visualization Manager 'Call after visu initialization')
FUNCTION VisuInit : BOOL
VAR_INPUT
END_VAR
// Set the mouse event handler
VisuElems.VisuElemBase.g_VisuEventManager.SetMouseEventHandler(PLC_PRG.evHandler);

Ein weiterer Anwendungsfall ist die Registrierung des ClientManagerListener beim ClientManager.

Responsive Visualisierungsgröße

standard icon Die Größe der Visualisierung wird aktualisiert, wenn die Client-Größe geändert wird. Die Elemente in der Top-Level-Visualisierung können dynamisch positioniert werden. Voraussetzung ist eine isotropische oder anisotropische Skalierung.

Die Clientgröße kann mit den Variablen Container.Width und Container.Height abgefragt werden.

Container.Size ist die Client-Größe für alle Toplevel-Visualisierungen. Damit eine Visualisierung mit neu positionierten Elementen wieder richtig skaliert, muss Visu.Size neu ermittelt werden.

Beispiel:

Container.Width - Visu.Width
Container.Width - Visu.Width - 50