<< Click to display table of contents >> TRVReportColoredShapeVisualizer.ConditionalShapeProperties

Specifies a set of shape properties that are applied depending on the visualized value.

property ConditionalShapeProperties: TRVConditionalShapePropertiesCollection;

The programmer must ensure that items in this collection are sorted in an ascending order by ConditionalShapeProperties[].Value.

The visualizer searches the item to apply using the following algorithm. Items are enumerated from the last one to the first one. If the comparison between the current item's Value and the visualized value returns True, this item is used. If all comparisons return False, Color and ShapeProperties.StartAngle are applied.

If the Index-th item of this collection is used, a shape is displayed using ConditionalShapeProperties[Index].Color and ShapeProperties.StartAngle + ConditionalShapeProperties[Index].DeltaAngle.

Comparisons with the visualized value depend on AbsoluteValues property.

•If AbsoluteValues = True, values are compared as:
Visualized_Value >= ConditionalShapeProperties[].Value

•If AbsoluteValues = False, values are compared as:
(Visualized_Value - MinValue) *100 / (MaxValue - MinValue) >= ConditionalShapeProperties[].Value)

Values less than MinValue are treated as MinValue, values greater than MaxValue are treated as MaxValue.

Example

Let this collection has two items:

•ConditionalShapeProperties[0].Value = 3

•ConditionalShapeProperties[1].Value = 7

AbsoluteValues = True

In this case:

•for all values >=7, ConditionalShapeProperties[1] is applied

•for all values >=3 and <7, ConditionalShapeProperties[0] is applied

•for all values < 3, default properties are applied.