Skip to main content

Visualisierungselement: Trend

Symbol:

_visu_icon_trend_neu.png

Kategorie: Spezielle Steuerelemente

Das Element stellt den Verlauf von Variablenwerten als Trenddiagramm dar. Das Trenddiagramm ist geeignet, einen langfristigen Datenverlauf darzustellen, denn die Daten werden aus einer Trendaufzeichnung und damit aus einer Datenbank ausgelesen. Außerdem können Sie das Element Trend zusammen mit den Bedienelementen Datumsbereichsauswahl, Legende und Zeitbereichsauswahl ausführen, so dass der Benutzer komfortabel im Diagramm navigieren kann.

Tipp

Sie können die aufgezeichnete Trendkurve zur Laufzeit programmatisch löschen. Ab dem Zeitpunkt des Löschens beginnt die Aufzeichnung erneut.

Für weitere Informationen siehe: Trendvisualisierung programmieren

Elementeigenschaften

Sind alle Elementeigenschaften verfügbar?

Nur wenn Sie in der Eigenschaften die Option Erweitert oder den Filter Alle Kategorien aktiviert haben, stehen Ihnen alle Eigenschaften sichtbar zur Verfügung.

Elementname

Beispiel: Velocity

Tipp

Durch die Vergabe von eigenen Elementnamen werden die Elemente in der Elementliste schnell gefunden.

Datenquelle

Datenquelle für die Verbindung über das Gerät und die Applikation zum Objekt Trendaufzeichnung, wo die Trenddaten, die Sie anzeigen möchten, gespeichert wurden

Wenn das Objekt Trendaufzeichnung auf dem lokalen Gerät ist, genügt es, wenn Sie die zugehörige Applikation angeben. Wenn die Trendaufzeichnung auf einem entfernten Gerät ist, geben Sie die Datenquellenverbindung zu diesem Gerät an.

  • _cds_icon_application.png <lokale Applikation>

    Das Objekt Trendaufzeichnung befindet sich auf dem lokalen Gerät in der lokalen Applikation.

  • < device name> . < application name>

    Beispiel: Device_A.App_A

    Das Objekt Trendaufzeichnung befindet sich auf dem lokalen Gerät Device_A unter der Applikation App_A.

  • _visu_icon_data_sources.png < data source name >

    Beispiel: _visu_icon_data_sources.png DataSource_B

    Das Objekt Trendaufzeichnung befindet sich auf einem entfernten Gerät, das über die Datenquelle DataSource_B verbunden ist. Unter der (nun sichtbaren) Eigenschaft Applikation wird die entfernte Applikation angezeigt, so wie in der Datenquelle konfiguriert.

    Beispiel: _cds_icon_application.png App_B

    Hinweis: Wenn auf die Datenquelle symbolisch per Symboldatei zugriffen wird CODESYS( Symbolic), dann muss die dafür benötigte Symboldatei und das zugehörige Projekt im gleichen Ordner gespeichert sein.

Elementtyp

Trend

Trendaufzeichnung

_visu_icon_trend_recording_manager.png: Trendaufzeichnung, deren Daten als Diagramm dargestellt werden

Die Trendaufzeichnung befindet sich auf dem in Datenquelle bestimmten Gerät.

Für weitere Informationen siehe: Trendaufzeichnung

Anzeigeeinstellung

_visu_icon_trend_diagram.png: Die Schaltfläche öffnet denAnzeigeeinstellungen bearbeiten

Position

Die Position definiert die Lage und Größe des Elements im Fenster der Visualisierung. Sie bezieht sich auf ein kartesisches Koordinatensystem. Der Ursprung liegt in der oberen linken Fensterecke. Die positive horizontale X-Achse verläuft nach rechts. Die positive vertikale Y-Achse verläuft nach unten.

X

X-Koordinate (in Pixel) der linken oberen Ecke des Elements

Beispiel: 10

Y

Y-Koordinate (in Pixel) der linken oberen Ecke des Elements

Beispiel: 10

Breite

Breite (in Pixel)

Beispiel: 150

Höhe

Höhe (in Pixel)

Beispiel: 30

Tipp

Die Werte in X, Y, Breite und Höhe können auch geändert werden, indem Sie im Editor das entsprechende Symbole _visu_icon_position_element.png an eine andere Stelle ziehen.

Winkel

Statischer Drehwinkel (in Grad)

Beispiel: 35

Das Element wird im Editor gedreht dargestellt. Rotationspunkt ist das Zentrum des Elements. Ein positiver Wert bewirkt eine Rechtsdrehung.

Tipp

Sie können den Wert im Editor ändern, indem Sie das Element am Griff fokussieren. Wenn der Cursor daraufhin als Drehpfeil _visu_icon_rotate_statically.png dargestellt wird, können Sie das Element wie am Griff haltend um sein Zentrum drehen.

_visu_img_selected_rectangle_with_handle.png(1): Griff

Anmerkung

Wenn zusätzlich in der Eigenschaft Absolute Bewegung → Innere Rotation ein dynamischer Drehwinkel konfiguriert ist, werden zur Laufzeit der statische und der dynamische Drehwinkel addiert. Der statische Drehwinkel fungiert als Offset.

Cursor

Cursor anzeigen

standard icon: Im Trenddiagramm wird ein Cursor (schwarzes Dreieck mit vertikaler Linie) eingeblendet.

Verhalten zur Laufzeit:

Wenn der Graph „steht“, kann der Benutzer den Cursor an der Zeitachse entlang verschieben, um einen Zeitpunkt zu markieren. Dann wird der zur Cursorposition gehörende Variablenwert oberhalb des Graphen in der Legende angezeigt.

_cds_img_trend_with_cursor.png

Tooltip anzeigen

Voraussetzung: Cursor anzeigen ist aktiviert

standard icon: Beim Cursor erscheint ein Tooltip.

Verhalten zur Laufzeit: Der zur Cursorposition gehörende Variablenwert wird als Tooltip angezeigt.

Rahmen anzeigen

standard icon: Das Trenddiagramm wird mit einem Rahmen gezeichnet

Zahlenformat

Formatangabe in printf-Syntax, die bestimmt, wie die Werte im Tooltip und in der Legende dargestellt werden

Beispiel: %d (Ganzzahlige Variable) oder %5.2f (Gleitpunktzahl)

Beschriftung der Skalenstriche der Zeitachse

Tipp

Die in der Trendaufzeichnung gespeicherte Zeit wird in der UTC-Zeitzone gespeichert. Wenn die Zeit im Trend des Visualisierungselements angezeigt wird, werden die Zeitstempel in die lokale Zeitzone des Betriebssystems der Steuerung umgewandelt.

Stellen Sie die Zeitzone im Betriebssystem um, wenn die Zeiten im Trenddiagramm nicht in der gewünschten Zone sind.

Tipp

Sie können programmatisch die lokale Zeitzone der Systemzeit auf die Weltzeit (UTC) umschalten.

Wenn die Variable VisuElems.Visu_DateTime.DisplayUTC auf TRUE gesetzt ist, erfolgt die Darstellung der Systemzeit in Weltzeit (UTC). Standardmäßig ist die Variable VisuElems.Visu_DateTime.DisplayUTC auf FALSE gesetzt ist, so dass die Systemzeit in der lokalen Zeitzone dargestellt wird.

Bei der Anzeige von Datums- und Zeitwerten können Sie den zugehörigen Formatstring um die Zeitzonenkennung Z erweitern. Bei Ausgabe in lokaler Systemzeit wird dann der Offset zur Weltzeit(UTC) angezeigt. Beispielsweise bewirkt dd:MM:yyyy HH:mm:ss:ms:Z die Ausgabe 01.08.2021 12:00:00:001:+02:00. Wenn die Zeit in Weltzeit (UTC) angezeigt wird, wird die UTC-Kennung angezeigt. Beispiel: 01.08.2021 10:00:00:001:Z

Zeitstempel

X-Wert des Trenddiagramms

  • Absolute Zeitstempel

    An jedem Skalenstrich der Zeitachse wird die Zeit absolut mit Datum und Uhrzeit angezeigt.

    Beispiel: 18.03.2016 12h30m50s

  • Relative Zeitstempel

    An jedem Skalenstrich wird die Zeitdauer ab dem Start der Aufzeichnung (=0) angezeigt.

    Beispiel: 5m30s

Zweizeilige Beschriftung

standard icon: Die Zeitstempel werden in zwei Zeilen ausgegeben, beispielsweise wird in der ersten Zeile das Datum und in der zweiten Zeile die Uhrzeit ausgegeben.

_cds_icon_option_deactivated.png: Der Zeitstempel wird in einer Zeile ausgegeben. Beispiel: 2019-11-01-12:30:50.

Unwichtige Informationen im Zeitstempel weglassen

standard icon: Die Zeitstempel werden verkürzt (ohne belanglose Informationen) dargestellt. Beispielsweise wird beim ersten Skalenstrich das Datum und bei den folgenden Skalenstrichen nur noch die Uhrzeit ausgegeben. Die Eigenschaft Internationalisierung (Formatstrings) ist nicht sichtbar und wird ignoriert.

_cds_icon_option_deactivated.png: Die Zeitstempel werden mit allen Informationen angezeigt. Dabei wird Eigenschaften Internationalisierung (Formatstrings) berücksichtigt, die für die Datums- und Uhrzeitausgabe die Formatangabe enthält.

Internationalisierung (Formatstrings)

Formatangabe für die Datums- und Uhrzeitausgabe des Zeitstempel, wenn dieser vollständig angezeigt wird

Anmerkung

Die Eigenschaft ist nur sichtbar, wenn Unwichtige Informationen im Zeitstempel weglassen nicht aktiviert ist.

Tipp

Grundsätzlich werden alle %t-Formatoptionen, die im Kapitel „Platzhalter mit Formatangabe“ beschrieben sind, unterstützt.Platzhalter mit Formatangabe

Datum

Formatstring, der die Datumsdarstellung schematisch wiedergibt. Als Standardeinstellung wird die des Betriebssystems (Locale) übernommen.

. Schema des Formatstrings für Datum:
  • Jahreszahl: yyyy, yy, y

  • Monat: MM, M

  • Tag: dd, d

  • Empfohlene Trennzeichen: - . /

Beispiel:

yyyy-MM-d bewirkt die Ausgabe 2019-10-25

yyyy-MM-dd bewirkt die Ausgabe 2019-10-25

dd.MM.yyyy bewirkt die Ausgabe 25.10.2019

dd/MM/yyyy bewirkt die Ausgabe 25/10/2019

Zeit

Formatstring, der die Darstellung der Zeit (oder Tageszeit) schematisch wiedergibt. Als Standardeinstellung wird die des Betriebssystems (Locale) übernommen.

. Schema des Formatstrings für Zeit:
  • 24-Stunden-Zeitangabe: HH, H

  • 12-Stunden-Zeitangabe: hh, h

  • AM/PM-Kürzel bei 12-Stunden-Zeitangabe: tt

  • Minuten: mm, m

  • Sekunden: ss, s

  • Millisekunden: ms

  • Mikrosekunden: us

  • Empfohlene Trennzeichen: : oder Leerzeichen

Beispiel:

HH:mm:ss:ms bewirkt die Ausgabe 15:30:59:123

h:mm:ss tt bewirkt die Ausgabe 3:30:59 PM

Zugeordnete Steuerelemente

Diese Elemente werden automatisch angelegt, wenn die Steuerelemente mit dem Befehl Elemente zur Steuerung des Trends einfügenhinzugefügt werden.

Datumsbereichsauswahl

Steuerelement, mit dem das Datum und die Uhrzeit der angezeigten Datensätze verändert werden kann

Über _cds_icon_three_dots.png werden alle Elemente, die die Schnittstelle IDateRangeSelector implementiert haben, angeboten. Standardmäßig sind Instanzen des Visualisierungselements Datumsbereichsauswahl verfügbar.

Zeitbereichsauswahl

Steuerelement, mit dem die Zeit der angezeigten Datensätze verändert werden kann

Über _cds_icon_three_dots.png werden alle Elemente angeboten, die die Schnittstelle ITimeSelector implementiert haben. Standardmäßig sind Instanzen des Visualisierungselements Zeitbereichsauswahl verfügbar.

Legende

Steuerelement, mit dem eine Legende zu den Grafen angezeigt wird

Über _cds_icon_three_dots.png werden alle Elemente angeboten, die die Schnittstelle ILegendDisplayer implementiert haben.

Steuervariablen

Tabelle 666. Zoom

Zoomen der Kurvendarstellung ist mit der Maus oder auf einem Multitouchgerät mittels der Fingergeste Pinch möglich. Es wirkt sich auch auf alle Achsen aus.

Zur Laufzeit wenn Enable TRUE ist, können Sie mit der Maus bei gedrückter linker Maustaste ein Rechteck aufziehen. Wenn Sie die Maustaste loslassen, wird in das Rechteck gezoomt und die Kurven werden vergrößert dargestellt. Um bei einem Multitouchgerät zu zoomen, bewegen Sie 2 Finger auseinander oder zusammen.

Zoomen und Schwenken können zusammen arbeiten.

Aktivieren

Variable (BOOL), die das Zoomen aktiviert oder deaktiviert.

TRUE: Aktiviert das Zoomen

Beispiel: PLC_PRG.xZoomEnable

Grundposition

Variable (BOOL)

Steigende Flanke: Setzt die Kurvendarstellung auf den Ausgangszustand zurück, nachdem die Darstellung durch Zoomen verändert wurde.

Beispiel: PLC_PRG.xZoomHome

Rückgängig

Variable (BOOL)

Steigende Flanke: Setzt die Kurvendarstellung auf die vorherige Position zurück, nachdem die Darstellung durch Zoomen verändert wurde.

Beispiel: PLC_PRG.xZoomUndo

Ist gezoomt

Variable (BOOL), die angibt, ob die Kurvendarstellung durch Zoomen verändert wurde.

TRUE: Kurvendarstellung wurde gezoomt.

Beispiel: PLC_PRG.xIsZoomed



Tabelle 667. Schwenk

Schwenken der Kurvendarstellung ist mit der Maus oder auf einem Multitouchgerät mittels der Fingergeste Pinch möglich. Es wirkt sich auch auf alle Achsen aus.

Wenn zur Laufzeit Enable TRUE ist, können Sie die Kurvendarstellung mit der Maus bei gedrückter linker Maustaste an eine andere Position ziehen. Um bei einem Multitouchgerät die Kurvendarstellung zu schwenken, ziehen Sie diese mit einem Finger an eine andere Position.

Aktivieren

Variable (BOOL), um das Schwenken zu aktivieren oder zu deaktivieren.

TRUE: Aktiviert das Schwenken

Beispiel: PLC_PRG.xPanEnable

Grundposition

Variable (BOOL)

Steigende Flanke: Setzt die Kurvendarstellung auf die Ausgangsposition zurück, nachdem die Darstellung durch Schwenken verändert wurde.

Beispiel: PLC_PRG.xPanHome

Ist geschwenkt

Variable (BOOL), deren Zustand angibt, ob die Kurvendarstellung durch Zoomen verändert wurde.

TRUE: Kurvendarstellung wurde geschwenkt.

Beispiel: PLC_PRG.xIsPanned



Zentrum

Die Eigenschaften enthalten feste Werte für die Koordinaten des Rotationspunkts. Der Rotationspunkt ist im Editor als Symbol _visu_icon_center_point.png dargestellt und dient als Zentrum für die Rotation und die Skalierung.

Tipp

Die Werte können auch geändert werden, indem Sie im Editor das Symbol _visu_icon_center_point.png an eine andere Stelle ziehen.

X

X-Koordinate des Rotationspunkts

Y

Y-Koordinate des Rotationspunkts

Absolute Bewegung

Die Eigenschaften enthalten IEC-Variablen, um die Position des Elements dynamisch zu steuern. Bezugspunkt ist die linke obere Ecke des Elements. Zur Laufzeit wird das Element als Ganzes bewegt.

Bewegung

X

Variable (numerischer Datentyp) für die X-Position (in Pixel)

Beispiel: PLC_PRG.iPos_X

Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach rechts.

Y

Variable (numerischer Datentyp) für die Y-Position (in Pixel)

Beispiel: PLC_PRG.iPos_Y

Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach unten.

Rotation

Variable (numerischer Datentyp) für den Drehwinkel (in Grad)

Beispiel: PLC_PRG.iAngle1

Der Mittelpunkt des Elements rotiert um den Punkt in Zentrum. Dieser Rotationspunkt wird im Editor als Symbol _visu_icon_center_point.png dargestellt.

Zur Laufzeit bleibt die Ausrichtung des Elements in Bezug zum Koordinatensystem der Visualisierung erhalten. Ein Erhöhen des Werts führt zu einer Rechtsdrehung.

_visu_img_prp_rotation.png

Innere Rotation

Variable (numerischer Datentyp) für den Drehwinkel (in Grad)

Beispiel: PLC_PRG.iAngle2

Zur Laufzeit rotiert das Elements entsprechend dem Variablenwert um den Rotationspunkt in Zentrum. Zudem dreht die Ausrichtung des Elements bezüglich des Koordinatensystems der Visualisierung. Ein Erhöhen des Werts im Code bewirkt eine Rechtsdrehung.

Der Rotationspunkt wird im Editor als Symbol _visu_icon_center_point.png dargestellt.

Anmerkung

Wenn in der Eigenschaft Position → Winkel ein statischer Drehwinkel angegeben ist, wird bei der Visualisierungsausführung zum variablen Drehwinkel der statische Drehwinkel addiert (Offset).

_visu_img_prp_inner_rotation.png

Tipp

Sie können die Variablen mit einer Einheitenumrechnung kombinieren.

Tipp

Die Eigenschaften X, Y, Rotation und Innere Rotation werden von der Funktionalität „Client-Animation“ unterstützt.

Zustandsvariablen

Die Variablen steuern dynamisch das Verhalten des Elements.

Unsichtbarkeit

Variable (BOOL) für das Umschalten der Sichtbarkeit des Elements

TRUE: Das Element ist zur Laufzeit nicht sichtbar.

Tipp

Die Eigenschaft Unsichtbarkeit wird von der Funktionalität „Client-Animation“ unterstützt.

Animation

Tipp

Diese Eigenschaften sind nur verfügbar, wenn Sie im Visualisierungmanager die Option Client-Animationen und Überlagerung systemeigener Elemente unterstützen aktiviert haben.

Animationsdauer

Vairable für die Dauer in Millisekunden, in der das Element eine Animation ausführt

  • Variable (Ganzzahliger Wert)

    Beispiel: Menu.tContent mit VAR tContent : INT := 500; END_VAR

  • Ganzzahliges Literal

    Beispiel: 500

. Animierbare Eigenschaften:
  • Absolute Bewegung, Bewegung, X, Y

  • Absolute Bewegung, Rotation

  • Absolute Bewegung, Innere Rotation

  • Absolute Bewegung, Äußere Rotation

Die animierte Bewegung wird ausgeführt, wenn mindestens ein Wert einer animierbaren Eigenschaft geändert wird. Die dann ausgeführte Bewegung ist nicht ruckartig, sondern wird reibungslos in der angegebenen Animationsdauer ausgeführt. Das Visualisierungselement fliegt die Sollposition an und rotiert dabei dynamisch. Die Übergänge sind fließend.

In den Vordergrund bringen

Variable (BOOL) für das Stellen des Elements in den Vordergrund

TRUE: Das Visualisierungselement wird zur Laufzeit im Vordergrund dargestellt.

FALSE: Das Visualisierungselement wird zur Laufzeit in der Ebene dargestellt, in der es im Visualisierungseditor eingefügt wurde.

Beispiel: bIsInForeground mit VAR bIsInForeground : BOOL := FALSE; END_VAR

Zugriffsrechte

Anmerkung

Nur verfügbar, wenn eine Benutzerverwaltung für die Visualisierung eingerichtet ist.

Schaltfläche Zugriffsrechte

Öffnet den Dialog Zugriffsrechte. Dort können Sie die Zugriffsrechte für das Element ändern.

. Statusmeldungen:
  • Nicht gesetzt. Alle Rechte: Zugriffsrecht für alle Benutzergruppen: bedienbar

  • Rechte sind vergeben: eingeschränkte Rechte: Mindestens für eine Gruppe ist der Zugriff eingeschränkt