Angular Gauge Tool - ActiveX Properties

The Angular Gauge Tool is an ActiveX control. As such, an Angular Gauge Tool object has an ActiveX page on the Property Sheet. Many of these properties are the object’s formatting properties. Values for the ActiveX Properties can be set directly on the ActiveX page or in the OCXProperties dialog box, which is accessed by clicking the (OCXProperties) property.

Browse by letter:     [A]     [B]     [C]     [E]     [H]     [L]     [M]     [O]     [P]     [R]     [S]     [T]     [U]     [V]     [W]

Property Description Related Properties

ArcRadius

Specifies the radius (in pixels) of the arc scale. Default is 60. The amount of the circle shown is dependent upon ArcRangeDegrees.

ArcRangeDegrees

Specifies the number of degrees of the arc is drawn. Default is 60. Valid values are 0 to 360. If set to 360, one of the labels will overlap.

ArcStartDegrees

Specifies the starting degree at which the arc is drawn clockwise. Default is 180. Valid values are 0 to 360.

AutoCenter

Enables automatic centering of the component within its boundary. Default is 1 - Yes.

If set to 0 - No, the component is aligned in the top, left corner in the boundary.

OffsetX and OffsetY can be used to move the placement of the component in the boundary.

AutoFrameRate

Specifies whether the object controls its update rate. Default is 0 - No.

When set to 1 - Yes, the object is repainted at the rate specified by the UpdateFrameRate property.

UpdateFrameRate

AutoScaleDesiredTicks

Specifies the desired TickMajorCount when AutoScaleEnabled is set to 1 - Yes. Default is 5. Due to the algorithm used to calculate the tick counts, the actual count can vary.

AutoScaleEnabled

AutoScaleEnabled

Enables auto scaling of the indicator. Default is 0 - No.

AutoScaleMaxTicks

Specifies the maximum TickMajorCount when AutoScaleEnabled is set to 1 - Yes. Due to the algorithm used to calculate the tick counts, the actual count can vary. Default is 6.

AutoScaleEnabled

AutoScaleStyle

Specifies the style of adjustment for the PositionMin and PositionMax when AutoScaleEnabled is set to 1 - Yes. When set to 0 - iassAutoMinMax, PositionMin and PositionMax are adjusted so that the scale starts and stops on a major tick.

AutoSize

Enables automatic adjustment of the ArcRadius. Default is 0 - No. If set to 1 - Yes, the radius will be adjusted to maximize the boundary (less the OuterMargin).

OuterMargin

BackGroundColor

Specifies the color of the object background. Default is gray (RGB 236.233.216). The background color is not shown if the Transparent property is set to 1 — Yes.

BackGroundPicture

Specifies the name of an image file to show on the background of the object. Default is blank.

 

BorderStyle

Specifies the border style of the object. Default is 0 - ibsNone. Other options are 1 - ibsRaised and 2 - ibsLowered.

 

CachedDrawing

Enables optimizing the display of the object. Default is 1 - Yes.

 

CurrentMax

Specifies the maximum value reached by the Position property. It is reset each time the Position value is greater than the CurrentMax value. The only way to access the value is programmatically (i.e., using script).

CurrentMin

Specifies the minimum value reached by the Position property. It is reset each time the Position value is less than the CurrentMin value. The only way to access the value is programmatically (i.e., using script).

Enabled

Enables user interaction with the object. If set to 0 - No, the object is still shown but its context menu is disabled. Default is 1 - Yes.

 

Height

Specifies the height (in pixels) of the object.

 

HubColor

Specifies the color of the hub. Default is black (RGB 0.0.0).

 

HubSize

Specifies the size of the hub (in pixels). Default is 14.

 

Label1AlignHorizontal

Specifies the horizontal alignment of Label 1. Default is * -iahCenter

 

Label1AlignVertical

Specifies the vertical alignment of Label 1. Default is 0 - iavCenter.

 

Label1Font

Specifies the font of Label 1. Default is MS Sans Serif (8 point).

 

Label1FontColor

Specifies the font color of Label 1. Default is black (RGB 0.0.0).

 

Label1OffSetX

Specifies the offset of Label 1 from the object’s x-axis. Default is -15.

 

Label1OffsetY

Specifies the offset of Label 1 from the object’s y-axis. Default is -35.

 

Label1Text

Specifies the text for Label 1. Default is blank.

 

Label2AlignHorizontal

Specifies the horizontal alignment of Label 2. Default is 0 -iahCenter

 

Label2AlignVertical

Specifies the vertical alignment of Label 2. Default is 0 - iavCenter.

 

Label2Font

Specifies the font of Label 2. Default is MS Sans Serif (8 point).

 

Label2FontColor

Specifies the font color of Label 2. Default is black (RGB 0.0.0).

 

Label2OffSetX

Specifies the offset of Label 2 from the object’s x-axis. Default is -15.

 

Label2OffsetY

Specifies the offset of Label 2 from the object’s y-axis. Default is -20.

 

Label2Text

Specifies the text for Label 2. Default is blank.

 

MaxPointerColor

Specifies the color of the max pointer. Default is cyan (RGB 0.255.255).

ShowMaxPointer

MinMaxFixed

Enables the Min and Max pointers to remain in fixed positions rather than to track Pointer(0). Default is 0 - No, which means that the Min and Max pointers will track the Position. When set to 1 - Yes, the values specified in Edit mode by the CurrentMin and CurrentMax remain fixed.

MinMaxPointerMargin

Specifies in pixels the MinPointer and MaxPointer margin from the position indicator or scale. Default is 0.

MinMaxPointerSize

Specifies the size (in pixels) of the Min and Max pointers. Default is 8.

MinMaxPointerStyle

Specifies the style of the Min and Max pointers. The style will be the same for both. Default is 0 - iagpsArrow. Other options are 1 - iagpsArrow, 2 - iagpsLine, and 3 - iagpsTriangle.

MinMaxUserCanMove

Enables the user to move the Min and Max pointer positions in Run mode.

MinPointerColor

Specifies the color of the Min pointer. Default is yellow (RGB 255.255.0).

OffsetX

Specifies the offset of the gauge from the object’s x-axis. Default is 0.

 

OffsetY

Specifies the offset of the gauge from the object’s y-axis. Default is 0.

 

OptionSaveAllProperties

Enables the SaveAllPropertiesToFile method to save just the ActiveX Properties or all object properties. Default is 0 - No, which means that only ActiveX Properties are saved.

 

OuterMargin

Specifies the margin (in pixels) of the between the gauge and the boundary when AutoSizeEnabled is set to 1 - Yes. Default is 5.

 

PointerColor

Specifies the color of Pointer(0). Default is black (RGB 0.0.0).

[AlarmElement]

PointerMargin

Specifies the margin (in pixels) between the tip of Pointer(0) and the scale. Default is 0.

 

PointerSize

Specifies the width (in pixels) of Pointer(0). Default is 10.

 

PointerStyle

Specifies the style of Pointer(0). Default is * - iagpsArrow. Other options are 1 - iagpsArrow, 2-iagpsLine, and 3 - iagpsTriangle.

 

Position

Specifies the position of indicator. Default is 0. If the object is associated with a point, the point’s value sets the position. If PositionPercent is specified, this value is calculated. If this value is specified, PositionPercent is calculated.

PositionMax

Specifies the upper limit of the indicator level. Default is 100.

PositionMin

Specifies the lower limit of the indicator level. Default is 0.

PositionPercent

Specifies the level of the indicator in terms of percent in regards to the range (PositionMax and PositionMin). If Position is specified, this value is calculated. If this value is specified, Position is calculated. Default is 0. Valid range is 0.00 (0%) and 1.00 (100%).

PrecisionStyle

Specifies if the labels will show precision as significant digits (integers) or with decimal places. Default is 1 - ipsFixedDecimal Points, which enables the labels to show the number of decimal places specified by the TickLabelPrecision property.

ReverseScale

Enables reversing the scale. Normal scaling runs negative to positive left to right or bottom to top. Default is 0 - No.

 

SectionColor1

Specifies the color of Section 1. Default is green (RGB 0.128.0).

Note: In script, you can set this and other color properties using the VBScript function 'control.somecolor = RGB (255,0,0).'

 

SectionColor2

Specifies the color of Section 2. Default is yellow (RGB 255.255.0).

Note: In script, you can set this and other color properties using the VBScript function 'control.somecolor = RGB (255,0,0).'

 

SectionColor3

Specifies the color of Section 3. Default is red (RGB 255.0.0).

Note: In script, you can set this and other color properties using the VBScript function 'control.somecolor = RGB (255,0,0).'

 

SectionColor4

Specifies the color of Section 4. Default is yellow (RGB 255.255.0).

Note: In script, you can set this and other color properties using the VBScript function 'control.somecolor = RGB (255,0,0).'

 

SectionColor5

Specifies the color of Section 5. Default is yellow (RGB 255.255.0).

Note: In script, you can set this and other color properties using the VBScript function 'control.somecolor = RGB (255,0,0).'

 

SectionCount

Specifies the number of color sections. Default is 0.

 

SectionEnd1

Specifies the end value for Section 1. Default is 50.

 

SectionEnd2

Specifies the end value for Section 2. Default is 75.

 

SectionEnd3

Specifies the end value for Section 3. Default is 0.

 

SectionEnd4

Specifies the end value for Section 4. Default is 0.

 

ShowHub

Enables display of the hub. Default is 1 - Yes.

 

ShowInnerArcRadius

Enables display of the inner arc radius line. Default is 0 - No.

 

ShowLabel1

Enables display of Label 1. Default is 0 - No.

 

ShowLabel2

Enables display of Label 2. Default is 0 - No.

 

ShowMaxPointer

Enables display of the Max Pointer. Default is 0 - No.

ShowMinPointer

Enables display of the Min Pointer. Default is 0 - No.

ShowOuterArcRadius

Enables display of the outer arc radius. Default is 0 - No.

 

ShowTickLabels

Enables display of the tick mark labels. Default is 1 - Yes.

 

ShowTicksMajor

Enables display of the major tick marks. Default is 1 - Yes

 

ShowTicksMinor

Enables display of the minor tick marks. Default is 1 - Yes.

 

TickLabelAlignment

Specifies alignment of the tick mark labels. Default is 0- ilaCenter.

 

TickLabelFont

Specifies the font for the tick labels. Default is MS Sans Serif (8 point).

 

TickLabelFontColor

Specifies the color of the tick mark labels. Default is black (RGB 0.0.0).

 

TickLabelMargin

Specifies the margin (in pixels) between the labels and major tick marks. Default is 5.

 

TickLabelPrecision

Specifies the number of decimal places for the tick labels. Default is 0.

To use any value other than 0, TickLabelPrecision must be set to 1 - ipsFixedDecimal Points.

TickMajorColor

Specifies the color of the major tick marks. Default is black (RGB 0.0.0).

 

TickMajorCount

Specifies the number of major tick marks displayed on the scale span. Default is 5.

 

TickMajorLength

Specifies the length (in pixels) of the major tick marks. Default is 20.

 

TickMargin

Specifies the size of the margin (in pixels) between the tip of the pointer and the tick marks. Default is 0.

 

TickMinorAlignment

Specifies the alignment of the minor tick marks in relation to the major tick marks. Default is 0 - itmnaInside. Other options are 1 - itmnaCenter and 2 - itmnaOutside.

 

TickMinorColor

Specifies the color of the minor tick marks. Default is black (RGB 0.0.0).

 

TickMinorCount

Specifies the number of minor tick marks displayed between major tick marks. Default is 4.

 

TickMinorLength

Specifies the length (in pixels) of the minor tick marks. Default is 3.

 

Transparent

Enables transparency of the object background. Default is 0 - No.

 

UpdateFrameRate

Specifies the rate (in seconds) of repainting the object. Default is 60.

Applicable only when AutoFrameRate is set to 1 - Yes.

Visible

Enables the visibility of the object on TheView. Default is 1 - Yes.

 

Width

Specifies the width (in pixels) of the object.

 

Back to top