Skip to main content

Visualisierungselement: Donut-Diagramm

Symbol:

_visu_icon_donut_chart.png

Kategorie: Messgeräte

Ein Donut-Diagramm (Ringdiagramm) ist ein Anzeigeelement. Es zeigt an, wie sich etwas Ganzes prozentual zusammensetzt. Es ist eine spezielle Ausprägung des Kreisdiagramms, bei dem die Mitte frei bleibt. Der freie Bereich in der Mitte kann für die Darstellung von zusätzlicher Information und für die Ausgabe von Text genutzt werden.

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

GenElemInst_1

Namen vergeben

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

Elementtyp

Donut-Diagramm

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.

Datenarray

Datenarray

Daten (Arrayvariable ARRAY[..]), die mit diesem Element visualisiert werden

Es wird ein eindimensionales Array mit numerischem Basistyp erwartet. Alle verwendeten Arrays müssen in diesem Element die gleiche Dimension verwenden.

Beispiel: PLC_PRG.arrInt

Während der Ausführung werden die Daten des Arrays als Donut-Diagramm angezeigt.

PROGRAM PLC_PRG
VAR
	arrInt : ARRAY[0..3] OF INT := [45, 12, 58, 32];
END_VAR

Farben und Beschriftungen

Textliste

Textliste für das Diagramm, verwendet für die Beschriftungen in der Legende

_cds_icon_arrow_down.png: Auswahlliste mit Einträgen aller im Projekt definierten Textlisten

Beispiel: 'Textlist_1'

Segmente

Statische Konfiguration der Segmente des Donut-Diagramms

Mit einem Klick auf die Schaltfläche _visu_icon_create_new.png Neu erstellen wird unterhalb ein weiteres Segment hinzugefügt.

[<Index>]

Konfiguration für das jeweilige, indizierte Segments

Farbe

Farbe des Segments

  • _cds_icon_arrow_down.png

    Auswahlliste mit Stilfarben

    Beispiel: Gelb

  • _cds_icon_three_dots.png

    Dialog Farbe öffnet sich. In diesem können Sie eine Farbe detailliert festlegen.

Text-ID

Referenziert einen Text aus der Textliste, für die Beschriftungen in der Legende

  • <Textliste>.<ID>

  • Ein Doppelklick in das Wertefeld öffnet den Zeileneditor. Mit einem Klick auf das _cds_icon_three_dots.png-Symbol rechts daneben erhalten Sie Unterstützung bei der Eingabe eines Textes aus einer Textliste.

Dynamische Konfiguration

Wichtig

Alle verwendeten Arrays sollten gleich dimensioniert sein.

Array für Beschriftungen

Variable des Typs ARRAY OF STRING oder ARRAY OF WSTRING für dynamische Beschriftungen

Beispiel: PLC_PRG.arrWstring

Um die sich zur Laufzeit ändernden Texte anzuzeigen, kann eine Variable übergeben werden, die programmgesteuert die aktuellen Texte für das jeweilige Segment enthält.

Ein Doppelklick in das Wertefeld öffnet den Zeileneditor. Mit Klick auf das _visu_icon_input_assistant.png-Symbol erhalten Sie Unterstützung bei der Eingabe.

Array für Farben

Variable des Typs ARRAY OF DWORD für dynamische Farben

Beispiel: PLC_PRG.arrDword

Um die sich zur Laufzeit ändernden Farben anzuzeigen, kann eine Variable übergeben werden, die programmgesteuert die aktuellen Farben für das jeweilige Segment enthält.

Ein Doppelklick in das Wertefeld öffnet den Zeileneditor. Mit Klick auf das _visu_icon_input_assistant.png-Symbol erhalten Sie Unterstützung bei der Eingabe.

Array für Sichtbarkeit von Segmenten

Variable des Typs ARRAY OF BOOL für die dynamische Sichtbarkeit von Segmenten.

Beispiel: PLC_PRG.arrBool

Um die sich zur Laufzeit ändernden Sichtbarkeit anzuzeigen, kann eine eine Variable übergeben werden, die programmgesteuert das aktuelle Flag für das jeweilige Segment enthält.

Ein Doppelklick in das Wertefeld öffnet den Zeileneditor. Mit Klick auf das _visu_icon_input_assistant.png-Symbol erhalten Sie Unterstützung bei der Eingabe.

Eigenschaft

Donut-Ringdicke

Fester Wert für die Ringdicke des Donut-Diagramms in Pixeln

Beispiel: 40

Tooltip anzeigen

standard icon: Sobald ein Visualisierungsbenutzer mit dem Mauscursor über das Element zieht, erscheint ein Tooltip.

Hinweis

Nur bei Nutzung der Überlagerungsfunktionalität ist dies möglich.

Für weitere Informationen siehe: Einstellungen

Werte in Prozent anzeigen

standard icon: Die Werte werden in Prozent angezeigt.

Legende

Legende anzeigen

standard icon: Das Donut-Diagramm wird mit Legende angezeigt.

Legendenposition

Die Legende kann oberhalb oder unterhalb des Donuts liegen.

  • Oben

  • Unten

Wertformat

Legt das Format für die Legende fest. Die Formatangabe muss kompatibel zum Basisdatentyp des Datenarray sein.

Beispiel: %5.2f

Schriftart

Schriftart für die Textausgabe auf der Legende

  • _cds_icon_arrow_down.png

    Auswahlliste mit Stilschriftarten

    Beispiel: Kleine Überschrift

  • _cds_icon_three_dots.png

    Dialog Schriftart öffnet sich. In diesem können Sie eine Schriftart detailliert festlegen.

Farbe Schriftart

Farbe für die Textausgabe auf der Legende

  • _cds_icon_arrow_down.png

    Auswahlliste mit Stilfarben

    Beispiel: Grau

  • _cds_icon_three_dots.png

    Dialog Farbe öffnet sich. In diesem können Sie eine Farbe detailliert festlegen

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

Editierbare X-Koordinate des Rotationspunkts

Mit einem Doppelklick in das Wertefeld öffnet sich der Zeileneditor.

Y

Editierbare Y-Koordinate des Rotationspunkts

Mit einem Doppelklick in das Wertefeld öffnet sich der Zeileneditor.

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

  • Containervariable Container.Width

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

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

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.

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:
Siehe auch: