ValueComparison API 

Definition

Das Oberflächenelement ValueComparison (IWDValueComparison) dient zur vergleichenden grafischen Darstellung von mehreren Werten. Sie können mit den Eigenschaften boxValue, markerValue und barValue das Verhältnis von bis zu drei Vergleichswerte visualisieren. Zudem können Sie zwei Grenzwerte festlegen und damit drei verschiedene farbliche Bereiche definieren.

 

Verwendung

Die typische Verwendung des ValueComparison-Elements ist innerhalb einer Tabelle. Sie können den Vergleich von jeweils bis zu drei Werten zeilenweise visualisieren.

Das ValueComparison-Element wird bei der Darstellung in einer Tabellenspalte immer links ausgerichtet.

 

Beschreibung der Eigenschaften des Oberflächenelements

·        barValue
Bestimmt die Breite des Balkens.

·        boxValue
Bestimmt die Breite der Box.

·        colorAboveThreshold
Bestimmt die Farbe des Balkens oberhalb des oberen Grenzwerts.

·        colorBelowThreshold
Bestimmt die Farbe des Balkens unterhalb des unteren Grenzwerts

·        colorBetweenThresholds
Bestimmt die Farbe zwischen den Grenzwerten
         colorAboveThreshold, colorBelowThreshold und colorBetweenThresholds sind              vom Aufzählungstyp WDBarColor und können folgende Werte annehmen:

¡        critical

¡        negative

¡        neutral1

¡        neutral2

¡        neutral3

¡        positive

·        lowerThresholdValue
Bestimmt den unteren Grenzwert.

·        markerType
Bestimmt den Typ der Markierungslinie. markerType ist vom Aufzählungstyp WDMarkerType und kann zwei verschiedene Werte annehmen:

¡        critical für einen kritischen Wert und

¡        neutral für einen neutralen Wert.

·        markerValue
Bestimmt die Platzierung der Markierungslinie.

·        maxValue
definiert einen maximalen Wert, der benötigt wird, wenn Sie mehrere ValueComparison-Elemente zum Beispiel in einer Tabelle anzeigen wollen. Mit der Eigenschaft maxValue können Sie einen gemeinsamen Höchstwert festlegen, der den Vergleich zwischen den verschiedenen ValueComparison-Elementen ermöglicht.

·        text
Bestimmt den Text des ValueComparison-Elements.

·        upperThresholdValue
Bestimmt den oberen Grenzwert.

·        width
Bestimmt die Breite des ValueComparison-Elements in Pixeln.

Geerbte und zusätzliche Eigenschaften im Überblick

Name	Interface	Typ	Anfangswert	Bindable	Wert erforderlich
barValue	IWDValueComparison	double	-1	bindable	Nein
boxValue	IWDValueComparison	double	-1	bindable	Nein
colorAboveThreshold	IWDValueComparison	WDBarColor	negative	bindable	Nein
colorBelowThreshold	IWDValueComparison	WDBarColor	neutral1	bindable	Nein
colorBetweenThresholds	IWDValueComparison	WDBarColor	critical	bindable	Nein
enabled	IWDUIElement	boolean	true	bindable	Nein
lowerThresholdValue	IWDValueComparison	double	-1	bindable	Nein
markerType	IWDValueComparison	WDMarkerType	neutral	bindable	Nein
markerValue	IWDValueComparison	double	-1	bindable	Nein
maxValue	IWDValueComparison	double	-1	bindable	Nein
text	IWDValueComparison	String		bindable	Nein
tooltip	IWDUIElement	String		bindable	Nein
upperThresholdValue	IWDValueComparison	double	-1	bindable	Nein
visible	IWDUIElement	WDVisibility	visible	bindable	Nein
width	IWDValueComparison	int	0	bindable	Nein