DonutGauge

Ringdiagramm für die Anzeige eines Prozessvariablenwertes.

Symbol

Menüband

Start > Steuerelemente > Ein-/Ausgabe > Variablenausgabe > DonutGauge

Das Steuerelement "DonutGauge" zeigt einen Ring an, der den ganzen darstellbaren Wertebereich der angebundenen Prozessvariablen repräsentiert. Der aktuelle Wert der Variablen wird durch einen andersfarbigen Indikator als Teil des Rings dargestellt. Zusätzlich kann der aktuelle Wert als Zahl dargestellt werden.

Beispiel: Das DonutGauge wird z. B. zur Anzeige eines Fortschritts verwendet.

Der Indikator (blau) des DonutGauge zeigt den aktuellen Wert der angebundenen Prozessvariablen an.

Funktionalitäten

Das Steuerelement unterstützt folgende Funktionalität:

Diese Funktionalitäten können Sie über die Eigenschaften im Fenster Eigenschaften konfigurieren, wenn Sie das Steuerelement im Designer oder in der Dokumentgliederung markieren.

Style

Für das Steuerelement stehen keine System-Styles zur Verfügung. Sie können eigene Styles für das Steuerelement erstellen. Diese Styles stehen nach der Erstellung in der Eigenschaft "Style" zur Auswahl.

Aufbau

Das Steuerelement besteht aus einer Reihe weiterer Elemente. Sowohl das Steuerelement selbst als auch seine Elemente können über die Eigenschaften des Steuerelements konfiguriert werden. Eigenschaften für ein Unterelement des Steuerelements sind in der Regel in der Kategorie zu finden, die den Namen dieses Elements trägt.

Beispiel: Die Eigenschaften zur Konfiguration des Elements "Unit" finden Sie im Fenster Eigenschaften in der Kategorie "Unit", wenn Sie das Steuerelement im Designer oder in der Dokumentgliederung markieren.

Das DonutGauge und seine Elemente sowie spezifische Eigenschaften

Ringdiagramm

Das DonutGauge enthält eine Grafik (SVG), die einen Ring darstellt. Dabei repräsentiert ein Teil des Rings (Indicator) den aktuellen Wert, der andere Teil des Rings (IndicatorBackground) den Rest des darzustellenden Wertebereichs. Eigenschaften zur Konfiguration des Ringdiagramms sind in der Kategorie "DonutGauge" enthalten. Die Farben können über Eigenschaften in der Kategorie "Colors" festgelegt werden.

EndAngle

Legt den Endpunkt für den Ring fest.

Beispiel: Während die Angabe von "StartAngle" = 0 und "EndAngle" = 360 zur Darstellung eines geschlossenen Rings führt, kann bei der Angabe von "StartAngle" = 0 und "EndAngle" = 361 das Steuerelement nicht mehr korrekt dargestellt werden.

StartAngle

Legt den Startpunkt für den Ring fest. Der 0-Punkt (0-Grad-Winkel) befindet sich oben im Steuerelement. Von hier aus kann ein negativer oder positiver Winkel für den Startpunkt des Rings angegeben werden. Der Ring wird immer im Uhrzeigersinn gezeichnet.

Beispiel: Wenn Sie ein DonutGauge auf einer Page im Designer platzieren, sind der Start- und der Endpunkt für den Ring bereits voreingestellt (StartAngle = -135, EndAngle = 135). Der Indikator für den aktuellen Wert wird ab dem Startpunkt gezeichnet und erstreckt sich mit wachsendem Wert im Uhrzeigersinn maximal bis zum Endpunkt. Der voreingestellte Wertebereich von 0 bis 100 wird auf die Länge des Rings abgebildet. Der untere Grenzwert (0) liegt am Startpunkt, der obere Grenzwert (100) am Endpunkt des Rings.

InnerRadius

Legt den Radius für die Innenseite des Rings fest. Möglich sind Angaben in Pixel oder Prozent. Die Angabe von 70 % bedeutet, dass der Radius 70 % der Strecke vom Mittelpunkt bis zur Grenze des Steuerelements entspricht. Sind die Höhe und die Breite des Steuerelements unterschiedlich, dann zählt für die Berechnung des Radius die kürzere Strecke.

OuterRadius

Legt den Radius für die Außenseite des Rings fest. Möglich sind Angaben in Pixel oder in Prozent. Die Angabe von 100 % bedeutet, dass der Radius 100 % der Strecke vom Mittelpunkt bis zur Grenze des Steuerelements entspricht. Sind die Höhe und die Breite des Steuerelements unterschiedlich, dann zählt für die Berechnung des Radius die kürzere Strecke.

Verwandte Themen: