The UI element ValueComparison (IWDValueComparison) can be used to compare the graphic display of several values. You can use the properties boxValue, markerValue and barValue to visualize the relation of up to three comparison values. In addition, you can set two threshold values and thus define three differently colored areas.
Typically, the ValueComparison element is used within a table. You can visualize the comparison of up to three values on a row-by-row basis.
The ValueComparison-Element in its representation in a table column is always justified to the left.
·
barValue
Specifies the width of the bar.
·
boxValue
Specifies
the width of the box.
·
colorAboveThreshold
Specifies
the color of the bar above the upper threshold value.
·
colorBelowThreshold
Specifies
the color of the bar below the lower threshold value.
·
colorBetweenThresholds
Specifies
the color between the threshold values.
colorAboveThreshold,
colorBelowThreshold and
colorBetweenThresholds are of
enumeration type WDBarColor and can accept the following values:
¡ critical
¡ negative
¡ neutral1
¡ neutral2
¡ neutral3
¡ positive
·
lowerThresholdValue
Specifies
the lower threshold value.
·
markerType
Specifies
the type of the marker line.
markerType is of
enumeration type WDMarkerType and can accept two different values:
¡ critical for a critical value and
¡ neutral for a neutral value.
·
markerValue
Specifies
the position of the marker line.
·
maxValue
Defines a
maximum value, which is needed if you want to display several ValueComparison
elements, for example, in a table. The maxValueproperty
allows you to define a common maximum value which allows the comparison
between the different ValueComparison elements.
·
text
Specifies
the text of the ValueComparison element.
·
upperThresholdValue
Specifies
the upper threshold value.
·
width
Specifies
the width of the ValueComparison element in pixels.
Name |
Interface |
Type |
Initial Value |
Bindable |
Value Required |
barValue |
IWDValueComparison |
double |
-1 |
bindable |
No |
boxValue |
IWDValueComparison |
double |
-1 |
bindable |
No |
colorAboveThreshold |
IWDValueComparison |
WDBarColor |
negative |
bindable |
No |
colorBelowThreshold |
IWDValueComparison |
WDBarColor |
neutral1 |
bindable |
No |
colorBetweenThresholds |
IWDValueComparison |
WDBarColor |
critical |
bindable |
No |
enabled |
IWDUIElement |
boolean |
true |
bindable |
No |
lowerThresholdValue |
IWDValueComparison |
double |
-1 |
bindable |
No |
markerType |
IWDValueComparison |
WDMarkerType |
neutral |
bindable |
No |
markerValue |
IWDValueComparison |
double |
-1 |
bindable |
No |
maxValue |
IWDValueComparison |
double |
-1 |
bindable |
No |
text |
IWDValueComparison |
String |
|
bindable |
No |
tooltip |
IWDUIElement |
String |
|
bindable |
No |
upperThresholdValue |
IWDValueComparison |
double |
-1 |
bindable |
No |
visible |
IWDUIElement |
WDVisibility |
visible |
bindable |
No |
width |
IWDValueComparison |
int |
0 |
bindable |
No |