Skip to main content

Visualisierungselement: Zeitbereichsauswahl

Symbol:

_visu_icon_time_range_picker.png

Kategorie: Datums-/Zeitsteuerelemente

Das Element bietet konfigurierbare Schaltflächen, mit denen der Zeitbereich einer Trendanzeige auf eine definierte Zeit gesetzt wird. Dabei wird der Endzeitpunkt der bisherigen Darstellung belassen und der Anfangszeitpunkt angepasst.

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

Tipp

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

Elementtyp

Zeitbereichsauswahl

Ausrichtung

Ausrichtung

Gibt an, ob das Zeitauswahlelement im Editor horizontal oder vertikal ausgerichtet ist.

Tipp: Ändern Sie im Editor beim Element das Verhältnis von Breite zu Höhe.

Rahmen anzeigen

standard icon: Visualisierungselement wird mit einem Rahmen gezeichnet.

Auflösung

Auflösung, mit der der Zeitstempel gespeichert wurde: Millisekunde oder Microsekunde

Zugeordnetes Visualisierungselement

Zuordnung zum Element, das die Zeitauswahl weiterverarbeitet

Das Element kann beispielsweise einem Visualisierungselement Trend zugewiesen werden. Dann kann der Zeitbereich des Trend-Elements verändert werden. Die verfügbaren Visualisierungselemente werden über die Eingabeunterstützung ausgewählt (_cds_icon_three_dots.png).

Beispiel: GenElemInst_1

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.

Texte

Text

Zeichenfolge (ohne einfache Anführungszeichen)

Beispiel: Main page %i

Das Element wird mit diesem Text beschriftet. Wenn im Text ein Platzhalter %<format string> angegeben ist, wird an der Stelle des Platzhalters der Wert der Variable in Eigenschaft Textvariable → Text ausgegeben.

Tipp

Mit dem Tastaturkürzel Strg + Eingabe fügen Sie einen Zeilenumbruch ein.

Tipp

Die eingegebenen Texte werden automatisch in die Textliste GlobalTextList übernommen. Somit können diese Texte lokalisiert werden.

Texteigenschaften

Die Eigenschaften erhalten feste Werte für die Texteigenschaften und wirken auf die Texte, die in Texte → Text oderTexte → Tooltip konfiguriert sind.

Schriftart

Beispiel: Standard

_cds_icon_three_dots.png: Dialog Schriftart öffnet sich.

_cds_icon_arrow_down.png: Auswahlliste mit Stilschriftarten

Farbe Schriftart

Beispiel: Schwarz

_cds_icon_three_dots.png: Dialog Farbe öffnet sich.

_cds_icon_arrow_down.png: Auswahlliste mit Stilfarben

Transparenz

Ganze Zahl (Wertebereich von 255 bis 0)

Der Transparenzwert bestimmt die Durchsichtigkeit der zugehörigen Farbe.

255: Die Farbe ist deckend.

0: Die Farbe ist voll transparent.

Anmerkung

Wenn die Farbe eine Stilfarbe ist und bereits einen Transparenzwert enthält, ist diese Eigenschaft schreibgeschützt.

Zeiten

Unter Zeiten werden die Schaltflächen, die das Element zur Laufzeit zur Verfügung stellt, als Array definiert und konfiguriert.

Auswahlmöglichkeit "Alle" anbieten

standard icon: Erweitert die Zeitauswahlleiste um die Alles-Schaltfläche

Das Diagramm stellt ein Zeitintervall dar, das alle Zeitstempel umfasst.

Zeiten

_visu_icon_create_new.png: Fügt eine weitere Schaltfläche in die Zeitauswahlleiste hinzu und erweitert das Array um einen Eintrag.

Unter der Eigenschaft Zeiten → Zeiten → Zeiten → [<neu>] ist ein weiterer Index vorhanden. Unter diesem Index befindet sich Zeit. Dort ist die Konfiguration der Schaltfläche einzutragen.

. Zeiten

  • [Index]

mit Index ∈ {0, 1, 2,…}

Array von allen Schaltflächen der Zeitauswahlleiste. Der Index entspricht der Anzahl an Schaltflächen.

_visu_icon_delete.png: Die zugehörige Schaltfläche wird aus der Zeitauswahlleiste entfernt. Der Konfigurationseintrag wird aus der Eigenschaftenliste Zeiten entfernt.

. [Index]

  • Zeit

_visu_icon_time.png: Zeitintervall in normierter Schreibweise

Beispiel: 3M für 3 Monate, 30m für 30 Minuten.

Wenn im Feld ein Zeitintervall angeben ist, wird die Schaltfläche damit beschriftet. Wenn ein Benutzer zur Laufzeit die Schaltfläche klickt, wird der Befehl zum Umschalten des Diagramms auf dieses Zeitintervall ausgeführt. Die Voreinstellung ist leer.

Steuervariablen

Zeit

Variable (LINT) für eine Zeit in µs

Variable, um die Auswahl des Zeitbereichs programmatisch zu steuern.

Beispiel:

Für 1 s: liSelectedTimeIndex := 1000000;

Für 30 s: liSelectedTimeIndex := 30000000;

Alles ausgewählt

Variable (BOOL)

Variable, um programmatisch zu steuern, dass alle Zeitbereiche aktiviert sind

TRUE: Alle Zeitbereiche sind aktiviert.

FALSE: Hier sind nicht alle Zeitbereiche aktiviert.

Beispiel: PLC_PRG.xAllTimesAreSelected

Beispiel 40. Beispiel
PROGRAM PLC_ORG
VAR
	liSelectedTimeIndex : LINT := 1000000;
	bIsAllTimes : BOOL := TRUE;
END_VAR


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.

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

In diesem Abschnitt: