Platforms to show: All Mac Windows Linux Cross-Platform

Back to CDLinearMeterMBS class.

CDLinearMeterMBS.addBar(startValue as Double, endValue as Double, colorvalue as color, effect as Integer = 0, roundedCorner as Integer = 0) as CDTextBoxMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds a bar to the meter.

This method adds an empty TextBox to the meter. It configures the textbox position, size and color so that it looks like a bar on the meter scale.

ArgumentDefaultDescription
startValue(Mandatory)The start value of the bar.
endValue(Mandatory)The end value of the bar.
color(Mandatory)The color of the bar.
raisedEffect0The 3D border width. For positive values, the border will appear raised. For negative values, the border will appear depressed. A zero value means the border will appear flat. This argument can also be used to specify Chart::glassEffect, Chart::softLighting, Chart::cylinderEffect or Chart::flatBorder effects.
roundedCorners0The radius for the two corners at the end position of the bar.

Returns a CDTextBoxMBS object representing the bar. This may be used to fine-tune the appearance of the bar.

See also:

CDLinearMeterMBS.addBar(startValue as Double, endValue as Double, colorvalue as Integer, effect as Integer = 0, roundedCorner as Integer = 0) as CDTextBoxMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds a bar to the meter.

This method adds an empty TextBox to the meter. It configures the textbox position, size and color so that it looks like a bar on the meter scale.

ArgumentDefaultDescription
startValue(Mandatory)The start value of the bar.
endValue(Mandatory)The end value of the bar.
color(Mandatory)The color of the bar.
raisedEffect0The 3D border width. For positive values, the border will appear raised. For negative values, the border will appear depressed. A zero value means the border will appear flat. This argument can also be used to specify Chart::glassEffect, Chart::softLighting, Chart::cylinderEffect or Chart::flatBorder effects.
roundedCorners0The radius for the two corners at the end position of the bar.

Returns a CDTextBoxMBS object representing the bar. This may be used to fine-tune the appearance of the bar.

See also:

CDLinearMeterMBS.addZone(startValue as Double, endValue as Double, colorvalue as color, label as string = "") as CDTextBoxMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 11.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Same as the other addZone method, but uses color instead of integer data type for passing color values.

See also:

CDLinearMeterMBS.addZone(startValue as Double, endValue as Double, colorvalue as Integer, label as string = "") as CDTextBoxMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds a zone to the meter.

ArgumentDefaultDescription
startValue(Mandatory)The start value (the lower bound) for the zone.
endValue(Mandatory)The end value (the upper bound) for the zone.
color(Mandatory)The color of the zone.
label""The text to be put at the center of the zone.
Return Value
A TextBox object representing the label. This may be used to fine-tune the appearance of the label.

See also:

CDLinearMeterMBS.Constructor(width as Integer, height as Integer, bgColor as color, edgeColor as color, raisedEffect as Integer = 0)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 11.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Same as the other Constructor method, but uses color instead of integer data type for passing color values.

See also:

CDLinearMeterMBS.Constructor(width as Integer, height as Integer, bgColor as Integer = &hffff0000, edgeColor as Integer = &hff000000, raisedEffect as Integer = 0)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Creates a new LinearMeter object.

ArgumentDefaultDescription
width(Mandatory)The width of the chart in pixels.
height(Mandatory)The height of the chart in pixels.
bgColorBackgroundColorThe background color of the chart.
edgeColorTransparentThe edge color of the chart.
raisedEffect0The 3D border width. For positive values, the border will appear raised. For negative values, the border will appear depressed. A zero value means the border will appear flat.

See also:

CDLinearMeterMBS.setMeter(leftX as Integer, topY as Integer, width as Integer, height as Integer, axisPos as Integer = 4, isReversed as boolean=false)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the orientation and position of the meter plot area.

The plot area is a rectangular region of the linear meter. The meter scale (the labels showing the values) will be on one external side of the plot area (say on the left side). The pointer start on the opposite side and points towards the meter scale.

This method defines the position and size of the rectangular region, as well as which side the meter scale is on. If the scale is on the left or right side, the meter is assumed to be a horizontal linear meter. If the scale is on the top or bottom side, the meter is assumed to be a vertical linear meter.
ArgumentDefaultDescription
leftX(Mandatory)The x-coordinate of the top-left corner of the meter plot area.
topY(Mandatory)The y-coordinate of the top-left corner of the meter plot area.
width(Mandatory)The horizontal width of the meter plot area.
height(Mandatory)The vertical height of the meter plot area.
axisPosLeftThe position of the meter scale. The scale should be on one of the 4 sides of the plot area border, specified by Left, Top, Right and Bottom.
isReversedfalseBy default, if the meter is horizontal, the meter scale will run from left to right. If the meter is vertical, the meter scale will run from bottom to top. If this argument is set to true, the meter scale will be reversed.

CDLinearMeterMBS.setRail(railColor as color, railWidth as Integer = 2, railOffset as Integer = 6)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 11.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Same as the other setRail method, but uses color instead of integer data type for passing color values.

See also:

Some examples using this method:

CDLinearMeterMBS.setRail(railColor as Integer, railWidth as Integer = 2, railOffset as Integer = 6)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the position, width and color of the pointer rail.

The pointer rail is the locus traced out by the starting point of the meter pointer as the pointer slides on the meter. The pointer rail is on the opposite side of the meter scale.
ArgumentDefaultDescription
railColor(Mandatory)The color of the pointer rail.
railWidth2The line width of the the pointer rail in pixels.
railOffset6The gap between the pointer rail and the plot area in pixels. A negative value will mean the pointer rail may move within the plot area.

See also:

The items on this page are in the following plugins: MBS ChartDirector Plugin.


The biggest plugin in space...