Skip to main content

Visualisierungselement: Datumsauswahl

Symbol:

_visu_icon_date_picker.png

Kategorie: Datums-/Zeitsteuerelemente

Das Element stellt einen Kalender dar und zeigt das aktuelle Datum an. Ein Benutzer kann mit Klick auf einen Tag ein Datum auswählen, das in einer Variablen gespeichert wird. Außerdem kann er den Zeitabschnitt anpassen, den der Kalender darstellt. Ein Klick auf den Kalenderkopf ermöglicht einen Jahreswechsel. Ein Klick auf die Pfeile im Kalenderkopf ermöglicht einen Monatswechsel.

Sprachabhängige Texte des Elements

Das Element enthält sprachabhängige Texte, die in der Textliste System verwaltet werden. Dabei handelt es sich um die Monatsnamen und die Wochentage in ausgeschriebener und abgekürzter Schreibweise. Wenn die Datumsauswahl in eine Visualisierung eingefügt wird, wird automatisch die Textliste unter der POUs-Ansicht generiert. Die IDs entsprechen dem Standardtext und somit den englischen Begriffen. Die Textliste ermöglicht das Übersetzen dieser Texte.

Beispiel 31. Beispiel

Textliste System

ID

Standard

Apr

Apr

April

April



Elementeigenschaften

Sind alle Elementeigenschaften verfügbar?

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

Elementname

Beispiel: DueDateCalendar

Tipp

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

Elementtyp

Datumsauswahl

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

Sie können die Werte ändern, indem Sie im Editor die Symbole _visu_icon_position_element.png an eine andere Stelle ziehen.

Variable

Variable

Eingabevariable (DATE). Enthält das Datum, das ein Benutzer im Kalender auswählt.

Beispiel: PLC_PRG.dtDueDate

Design

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

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

Design-Einstellungen

Voraussetzung: Nur wenn die Eigenschaft Design auf Explizit gesetzt ist, ist diese Eigenschaft sichtbar. Diese Einstellung ermöglicht Ihnen, ein benutzerdefinertes, festes Design zu erstellen.

Tipp

Wenn ein Design global im Stil definiert wurde, dann erhalten die Design-Einstellungen automatisch diese Stilwerte zugewiesen.

Sie können diese Werte explizit ändern und andere Werte aus der Stilauswahlliste (_cds_icon_arrow_down.png) oder oder mit Hilfe des Farbauswahdilaogs (_cds_icon_three_dots.png) zuweisen, so dass Sie Ihr Element in einem benutzerdefinertes Design dargestellt wird.

Eigenschaften

Beschreibung

Kopfzeile der Datumsauswahl

Design der Kopfzeile

Schrift

Farbe Schriftart

Beispiel: Datumsauswahl Überschrift Schriftfarbe

Zeiger

Zeigerfarbe

Beispiel: Datumsauswahl Zeigerfarbe

Farbe des gedrückten Pfeils

Beispiel: Datumsauswahl Zeigerfarbe gedrückt

Hintergrund

Hintergrund zeichnen

Aus dem Stil: Hintergrunddarstellung so, wie global im Stil definiert

Ja: Der Hintergrund wird mit der in der Eigenschaft Füllfarbe angegebenen Farbe gefüllt

Nein: Der Hintergrund wird nicht farbig gefüllt.

Füllfarbe

Voraussetzung: Wird verwendet, wenn Sie in Hintergrund zeichnen Ja ausgewählt haben.

Beispiel: Datumsauswahl Überschrift Hintergrundfarbe

Haupt-anzeige-bereich

Design des Hauptanzeigebereichs

Aktueller Tag

Design des heutigen Tags

Schrift

Farbe Schriftart

Beispiel: Datumsauswahl aktueller Tag Schriftfarbe

Hintergrund zeichnen

Aus dem Stil: Hintergrunddarstellung so, wie global im Stil definiert

Ja: Der Hintergrund wird mit der in der Eigenschaft Hintergrundfarbe angegebenen Farbe gefüllt.

Nein: Der Hintergrund wird nicht farbig gefüllt.

Hintergrundfarbe

Voraussetzung: Wird verwendet, wenn Sie in Hintergrund zeichnen Ja ausgewählt haben.

Beispiel: Datumsauswahl aueller Monat Hintergrundfarbe

Rahmen anzeigen

Aus dem Stil: Der Rahmen wird so dargestellt, wie global im Stil definiert

Ja: Der Rahmen wird mit den nachfolgenden Eigenschaften (Rahmenfarbe, Rechtecktyp, Linienstärke) dargestellt.

Nein: Es wird kein Rahmen dargestellt

Rahmenfarbe

Rechtecktyp

Linienstärke

Voraussetzung: Werden verwendet, wenn in Rahmen anzeigen Ja ausgewählt ist.

Beispiel: Grau

Beispiel: Abgerundestes Rechteck

Beispiel: 1

Selektierter Tag

Design des selektierten Tags

Schrift

Farbe Schriftart

Beispiel: Grau

Hintergrund zeichnen

Aus dem Stil: Hintergrunddarstellung so, wie global im Stil definiert

Ja: Der Hintergrund wird mit der in der Eigenschaft Hintergrundfarbe angegebenen Farbe gefüllt.

Nein: Der Hintergrund wird nicht farbig gefüllt.

Hintergrundfarbe

Voraussetzung: Wird verwendet, wenn Sie in Hintergrund zeichnen Ja ausgewählt haben.

Rahmen anzeigen

Aus dem Stil: Der Rahmen wird so dargestellt, wie global im Stil definiert

Ja: Der Rahmen wird mit den nachfolgenden Eigenschaften (Rahmenfarbe, Rechtecktyp, Linienstärke) dargestellt.

Nein: Es wird kein Rahmen dargestellt

Rahmenfarbe

Rechtecktyp

Linienstärke

Voraussetzung: Werden verwendet, wenn in Rahmen anzeigen Ja ausgewählt ist.

Aktueller Monat

Design des selektierten Monats

Schrift

Farbe Schriftart

Beispiel: Grau

Hintergrund zeichnen

Aus dem Stil: Hintergrunddarstellung so, wie global im Stil definiert

Ja: Der Hintergrund wird mit der in der Eigenschaft Hintergrundfarbe angegebenen Farbe gefüllt.

Nein: Der Hintergrund wird nicht farbig gefüllt.

Hintergrundfarbe

Voraussetzung: Wird verwendet, wenn Sie in Hintergrund zeichnen Ja ausgewählt haben.

Rahmen anzeigen

Aus dem Stil: Der Rahmen wird so dargestellt, wie global im Stil definiert

Ja: Der Rahmen wird mit den nachfolgenden Eigenschaften (Rahmenfarbe, Rechtecktyp, Linienstärke) dargestellt.

Nein: Es wird kein Rahmen dargestellt

Rahmenfarbe

Rechtecktyp

Linienstärke

Voraussetzung: Werden verwendet, wenn in Rahmen anzeigen Ja ausgewählt ist.

Anderer Monat

Design des Vor- und Folgemonate

Schrift

Farbe Schriftart

Beispiel: Grau

Anderen Monat anzeigen

Aus dem Stil: Die Vor- und Folgemonate werden so wie im Stil definert dargestellt

Ja: Die nachfolgenden Eigenschaften werden für die Darstellung angewendet.

Nein: Keine Darstellung

Hintergrund zeichnen

Aus dem Stil: Hintergrunddarstellung so, wie global im Stil definiert

Ja: Der Hintergrund wird mit der in der Eigenschaft Hintergrundfarbe angegebenen Farbe gefüllt.

Nein: Der Hintergrund wird nicht farbig gefüllt.

Hintergrundfarbe

Voraussetzung: Wird verwendet, wenn Sie in Hintergrund zeichnen Ja ausgewählt haben.

Rahmen anzeigen

Aus dem Stil: Der Rahmen wird so dargestellt, wie global im Stil definiert

Ja: Der Rahmen wird mit den nachfolgenden Eigenschaften (Rahmenfarbe, Rechtecktyp, Linienstärke) dargestellt.

Nein: Es wird kein Rahmen dargestellt

Rahmenfarbe

Rechtecktyp

Linienstärke

Voraussetzung: Werden verwendet, wenn in Rahmen anzeigen Ja ausgewählt ist.

Wochentage Überschrift

Design der Überschrift mit den Wochentagen

Schrift

Farbe Schriftart

Beispiel: Grau

Hintergrund zeichnen

Aus dem Stil: Hintergrunddarstellung so, wie global im Stil definiert

Ja: Der Hintergrund wird mit der in der Eigenschaft Hintergrundfarbe angegebenen Farbe gefüllt.

Nein: Der Hintergrund wird nicht farbig gefüllt.

Hintergrundfarbe

Voraussetzung: Wird verwendet, wenn Sie in Hintergrund zeichnen Ja ausgewählt haben.

Rahmen anzeigen

Aus dem Stil: Der Rahmen wird so dargestellt, wie global im Stil definiert

Ja: Der Rahmen wird mit den nachfolgenden Eigenschaften (Rahmenfarbe, Rechtecktyp, Linienstärke) dargestellt.

Nein: Es wird kein Rahmen dargestellt

Rahmenfarbe

Rechtecktyp

Linienstärke

Voraussetzung: Werden verwendet, wenn in Rahmen anzeigen Ja ausgewählt ist.

Trennlinie darstellen

Aus dem Stil: Die Trennlinie wird so dargestellt, wie global im Stil definiert.

Ja: Darstellung mit den nachfolgenden Eigenschaften

Nein: Es wird keine Trennlinie dargestellt

Farbe der Trennlinie

Stärke der Trennlinie

Werden verwendet, wenn in Trennlinie darstellen Ja ausgewählt ist.

Hintergrund

Design der Kalendertage

Hintergrund zeichnen

Aus dem Stil: Hintergrunddarstellung so, wie global im Stil definiert

Ja: Der Hintergrund ist mit der Farbe der Eigenschaft Füllfarbe gefüllt und in Rahmenfarbe gerahmt.

Nein: Der Hintergrund wird nicht farbig gefüllt.

Füllfarbe

Rahmenfarbe

Beispiel: Grau

Darstellungsart

Zeilen

Anzahl der Monatskalender pro Reihe, Voreinstellung 1

Spalten

Anzahl der Monatskalender pro Spalte, Voreinstellung 1

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

Den Eigenschaften können IEC-Variablen zugewiesen werden, 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

  • Containervariable Container.Height

    Für weitere Informationen siehe: Position und Größe optimal anpassen

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.

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

Die Eigenschaften enthalten die Konfigurationen für die Benutzereingabe bei Maus- oder Tastaturbedienung. Eine Benutzereingabe definiert ein Ereignis und eine oder mehrere Aktionen, die bei Eintreten des Ereignisses ausgeführt werden.

Tipp

Die Schaltfläche Konfigurieren öffnet den Dialog Eingabekonfiguration. Dort können Sie eine Benutzereingabe erstellen oder bearbeiten.

Unter den Ereignissen werden bereits konfigurierte Benutzereingaben aufgelistet. Sie enthalten jeweils die Aktion, die ausgelöst wird, und in knapper Form deren Einstellung.

Beispiel: ST-Code ausführen: _visu_icon_action.png PLC_PRG.i_x := 0;

OnDialogClosed

Eingabeereignis: Der Benutzer schließt einen Dialog.

OnMouseClick

Eingabeereignis: Der Benutzer führt im Elementbereich einen vollständigen Mausklick aus. Er drückt die Maustaste und gibt sie wieder frei.

OnMouseDown

Eingabeereignis: Der Benutzer drückt die Maustaste.

OnMouseEnter

Eingabeereignis: Der Benutzer zieht den Mauszeiger auf das Element

OnMouseLeave

Eingabeereignis: Der Benutzer zieht den Mauszeiger von einem Element weg

OnMouseMove

Eingabeereignis: Der Benutzer bewegt den Mauszeiger innerhalb des Elementbereichs

OnMouseUp

. Eingabeereignisse:
  • Der Benutzer gibt die Maustaste innerhalb des Elementbereichs frei. Dabei ist es unerheblich, ob der Benutzer vorher innerhalb oder außerhalb des Elementbereichs die Maustaste gedrückt hat.

  • Der Benutzer drückt die Maustaste innerhalb des Elementbereichs, verlässt den Elementbereich und gibt dann die Maustaste frei.

Anmerkung

Dieses CODESYS-spezifische Auslöseverhalten stellt bei Tastelementen das Beenden von Aktionen sicher. Ein Tastelement startet bei OnMouseDown eine Aktion, die bei OnMouseUp beendet wird.

Beispielsituation: Ein Visualisierungsbenutzer drückt die Maustaste innerhalb des Elementbereichs des Tastelements und verrutscht dann die Cursorposition so, dass diese außerhalb des Elementbereichs liegt. Die Aktion wird trotzdem beendet, da OnMouseUp auslöst.

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.

Tasten

Bei Auftreten eines Mausklickereignisses wird in der Applikation die unter Variable festgelegte Variable beschrieben. Die Codierung hängt von den Optionen FALSE Tasten und Beim Betreten tasten, falls Maus gefangen ab.

Variable

Voraussetzung: Die Option FALSE Tasten ist nicht aktiviert.

Variable (BOOL) für das Mausklickereignis

TRUE: Es liegt ein Mausklickereignis an. Es dauert solange ein Benutzer die Maustaste drückt, während er mit dem Mauszeiger das Element fokussiert. Es endet, wenn er die Taste freigibt.

FALSE: Es liegt kein Mausklickereignis an.

Beispiel: PLC_PRG.bIsTapped

FALSE Tasten

standard icon: Das Mausklickereignis führt zum komplementären Wert in Variable.

TRUE: Es liegt kein Mausklickereignis an.

FALSE: Solange das Mausklickereignis dauert.

Beim Betreten tasten, falls Maus gefangen

standard icon: Bei der Benutzereingabe wird zusätzlich berücksichtigt, ob bei gedrückter Maustaste der Mauszeiger innerhalb oder außerhalb des Elementbereichs gezogen wird.

TRUE: Solange das Mausklickereignis dauert und dabei der Mauszeiger innerhalb des Elementbereichs bewegt wird.

FALSE: Es liegt kein Mausklickereignis an. Oder aber der Benutzer bewegt den Mauszeiger bei gedrückter Maustaste außerhalb des Elementbereichs.

Sobald der Benutzer den Mauszeiger in den Elementbereich zurückbewegt, ist der Wert wieder TRUE. Man sagt, die „Maus ist gefangen“.

Umschalten

Bei Auftreten eines Mausklickereignisses wird die Variable gesetzt und bei Beenden des Mausklickereignisses zurückgesetzt.

Variable

Variable (BOOL) für das Umschalten beim Beenden des Mausklickereignisses

Das ist, wenn der Benutzer die Maustaste freigibt und dabei der Mauszeiger im Elementbereich ist. Wenn der Benutzer die Maustaste freigibt und dabei der Mauszeiger außerhalb des Elementbereich ist, liegt kein Beenden des Mausklickereignisses vor und der Wert wird nicht umgeschaltet.

Tipp

Der Benutzer kann damit eine begonnene Umschalteingabe abbrechen, indem er den Mauszeiger aus den Elementbereich zieht.

Umschalten beim Loslassen, falls Maus gefangen

standard icon: Der Wert schaltet um, unabhängig davon, wo der Mauszeiger beim Freigeben der Maustaste ist. Man sagt, die „Maus ist gefangen“.

Tastaturkürzel

Tastaturkürzel auf dem Element, um bestimmte Eingabeaktionen auszulösen

Bei Eintreten des Tastaturkürzel-Ereignisses werden die unter der Eigenschaft Ereignis(se) angegebenen Eingabeaktionen ausgelöst. Dabei ist nicht die Eingabeaktion selbst angegeben, sondern das Mauseingabeereignis, das auch zu dieser Eingabeaktion führt.

Taste

Taste, bei deren Drücken eine Eingabeaktion folgt.

Beispiel: T

Die folgenden Eigenschaften erscheinen, wenn eine Taste ausgewählt wird.

Ereignis(se)

  • Keine Aktion

  • MouseDown-Aktion: Ein Drücken der Taste lösen die Eingabeaktionen aus, die in der Eigenschaft OnMouseDown konfiguriert sind.

  • MouseUp-Aktion: Ein Freilassen der Taste lösen die Eingabeaktionen aus, die in der Eigenschaft OnMouseUp konfiguriert sind.

  • MouseDown/MouseUp-Aktion: Ein Drücken und Loslassen der Taste lösen die Eingabeaktionen aus, die in der Eigenschaft OnMouseDown und OnMouseUp konfiguriert sind.

Umschalten

standard icon: Kombination mit Umschalttaste

Beispiel: Umschalt + T

Steuerung

standard icon: Kombination mit Steuerungstaste

Beispiel: Strg + T

Alt

standard icon: Kombination mit Alt-Taste

Beispiel: Alt + T

Tipp

In der Registerkarte Tastaturkonfiguration sind alle Tastaturkürzel und deren Folgeaktionen aufgelistet, die in der Visualisierung konfiguriert sind.

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