Skip to main content

Visualisierungselement: Datums-/Uhrzeitauswahl

Symbol:

_visu_icon_date_and_time_picker.png

Kategorie: Datums-/Zeitsteuerelemente

Das Element ermöglicht dem Visualisierungsbenutzer ein Datum (in einem Kalender) mit einer Uhrzeit auszuwählen.

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: StartDateAndTime

Tipp

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

Elementtyp

Datums-/Uhrzeitauswahl

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

Angabe in Pixel

Beispiel: 150

Höhe

Angabe in Pixel

Beispiel: 30

Tipp

Die Werte können auch geändert werden, indem Sie im Editor die Symbole _visu_icon_position_element.png an eine andere Stelle ziehen.

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.

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

Eingaben deaktivieren

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

TRUE: Benutzereingaben zur Laufzeit haben keine Auswirkung. Das Element wird deaktiviert angezeigt.

Tipp

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

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

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

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

Skalierung

Variable (ganzzahliger Datentyp), um eine zentrische Streckung zu bewirken

Beispiel PLC_PRG.iScaling

Bezugspunkt ist die Eigenschaft Zentrum.

Der Wert 1 verkleinert das Element um den Faktor 0.001. Der Wert 1000 belässt das Element in Originalgröße.

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.

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

Eingabekonfiguration

Tipp

Die Schaltfläche Konfigurieren öffnet den Dialog Dialog: Eingabekonfiguration. Dort können Sie dem Ereignis Folgeaktionen zuweisen.Dialog: Eingabekonfiguration

OnValueChanged

Ereignis, das durch eine Wertänderung Folgeaktionen auslöst

Welche Folgeaktionen ausgelöst werden, wird im Dialog Eingabekonfiguration konfiguriert.

Die festgelegten Folgeaktionen und die jeweils dazugehörige Konfiguration werden unterhalb der Elementeigenschaft angezeigt.

Das Ereignis OnValueChanged kann durch das Compiler-Define VISU_NO_VALUECHANGED im Eigenschaftendialog der Applikation deaktiviert werden.

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

Angabe in Pixel

Beispiel: 150

Höhe

Angabe in Pixel

Beispiel: 30

Tipp

Die Werte können auch geändert werden, indem Sie im Editor die Symbole _visu_icon_position_element.png an eine andere Stelle ziehen.

Variable

Variable

Optional

Variable (DATE, DT, LDATE, LDT, LTIME, LTOD, TIME, TOD) für den Datums- und Uhrzeitwert

Wenn keine Variable konfiguriert ist, zeigt das Element automatisch die Systemzeit an. Der Wert kann vom Visualisierungsbenutzer angepasst werden.

Tipp

Wenn die Systemzeit ausgegeben wird und zusätzlich die Variable VisuElems.Visu_DateTime.DisplayUTC auf TRUE gesetzt ist, erfolgt die Ausgabe der Systemzeit in Weltzeit (UTC). Außerdem können Sie die Darstellung der Weltzeit (UTC) mit der Formatoption Z anpassen.

. Der Datentyp bestimmt automatisch die angezeigten Werteinheiten:
  • DATE: Jahr, Monat, Tag

  • DT: Jahr, Monat, Tag, Stunde, Minute, Sekunde

  • LTIME: Tag, Stunde, Minute, Sekunde (Millisekunde, Microsekunde und Nanosekunde werden standardmäßig nicht angezeigt)

  • TIME: Tag, Stunde, Minute, Sekunde, (Millisekunde wird standardmäßig nicht angezeigt)

  • TOD: Stunde, Minute, Sekunde, (Millisekunde wird standardmäßig nicht angezeigt)

Formatstring

Formatiert die Darstellung des Datums- und Uhrzeitwerts, so dass beispielsweise die Darstellung auf eine Zeiteinheit beschränkt werden kann

Beispiele:

LTIME-Variable mit Formatstring HH:mm:ss.ms.us.ns –> Anzeige: 08:15:12.780.150.360

LTIME-Variable mit eingeschränkendem Formatstring HH:mm –> Anzeige: 08:15

DATE-Variable mit Formatstring yyyy/MM/dd –> Anzeige: 2015/12/17

Systemzeitanzeige (keine Variable) undVisuElems.Visu_DateTime.DisplayUTC = TRUE mit Formatstring dd:MM:yyyy HH:mm:ss:ms:Z –> Anzeige der Weltzeit mit Z-Kennung 01.08.2021 10:12:03:450:Z

Systemzeitanzeige (keine Variable) und VisuElems.Visu_DateTime.DisplayUTC = FALSE mit Formatstring dd:MM:yyyy HH:mm:ss:ms:Z –> Anzeige der lokalen Zeit mit Versatz zur Weltzeit 01.08.2021 10:12:03:450:+02:00

Anmerkung

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

Design Datums- u. Uhrzeitauswahl

  • Aus dem Stil: Alle Einstellungen sind im Stil vorkonfiguriert.

  • Explizit: Die Eigenschaft Design-Einstellungen erscheint. Dort können Sie den Kalender anpassen

Design Datumsauswahl

  • Aus dem Stil: Alle Einstellungen sind im Stil vorkonfiguriert.

  • Explizit: Die Eigenschaft Design-Einstellungen erscheint. Dort können Sie den Kalender anpassen

Positionieren der Datumsauswahl

  • Dynamisch: Der Kalender wird automatisch angepasst und positioniert.

  • Manuell: Die Eigenschaft Positionsinstellungen erscheint. Dort können Sie den Kalender individuell anpassen.

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:ZPlatzhalter mit Formatangabe

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.

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

Eingaben deaktivieren

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

TRUE: Benutzereingaben zur Laufzeit haben keine Auswirkung. Das Element wird deaktiviert angezeigt.

Tipp

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

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

Skalierung

Variable (ganzzahliger Datentyp), um eine zentrische Streckung zu bewirken

Beispiel PLC_PRG.iScaling

Bezugspunkt ist die Eigenschaft Zentrum.

Der Wert 1 verkleinert das Element um den Faktor 0.001. Der Wert 1000 belässt das Element in Originalgröße.

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.

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

Eingabekonfiguration

Tipp

Die Schaltfläche Konfigurieren öffnet den Dialog Dialog: Eingabekonfiguration. Dort können Sie dem Ereignis Folgeaktionen zuweisen.Dialog: Eingabekonfiguration

OnValueChanged

Ereignis, das durch eine Wertänderung Folgeaktionen auslöst

Welche Folgeaktionen ausgelöst werden, wird im Dialog Eingabekonfiguration konfiguriert.

Die festgelegten Folgeaktionen und die jeweils dazugehörige Konfiguration werden unterhalb der Elementeigenschaft angezeigt.

Das Ereignis OnValueChanged kann durch das Compiler-Define VISU_NO_VALUECHANGED im Eigenschaftendialog der Applikation deaktiviert werden.

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