GaugeAddColorRange method (WinStudio scripts)

Applies To

IWSFormComponent interface

Definition

This method adds a color range to a gauge component, using line elements to define the color range attributes.

Syntax

Dim colorRangeName As ColorRange

colorRangeName.attributeX = valueX

gauge.GaugeAddColorRange( colorRangeName )

Part	Description
`colorRangeName`	Required. Specifies the name by which the color range is to be identified.
`attributeX`	Optional. Specifies the name of a color range attribute.
`valueX`	One required for each attribute specified. Specifies the value to be assigned to `attirbuteX`.

Remarks

You should declare and name the each color range and its attributes before you attempt to use this method to add the color range to the gauge. It is also a good practice to employ the GaugeClearColorRanges method before you declare and use this one.

You can use this method to define multiple color ranges.

For a complete list and description of the color range attributes available for scripting, see Specifying color ranges for gauges.

Example

In this example, a GaugeClearColorRanges method is invoked first, to clear any color ranges that might currently be defined for the gauge component. Following that, three color ranges are declared, their attribute values assigned, and an instance of GaugeAddColorRange is invoked for each range.

This example is given in Visual Basic.

gauge.GaugeClearColorRanges()
Dim r1 As ColorRange
Dim r2 As ColorRange
Dim r3 As ColorRange

r1.MinValue = 0
r1.MaxValue = 20
r1.Code = "0000FF"
gauge.GaugeAddColorRange(r1)

r2.MinValue = 21
r2.MaxValue = 60
r2.Code = "00FF00"
gauge.GaugeAddColorRange(r2)
         
r3.MinValue = 61
r3.MaxValue = 100
r3.Code = "FF0000"
gauge.GaugeAddColorRange(r3)