Object Reference > Palette Objects

The linear bargraph is an object for showing a numerical value in a graph.

The linear bargraph shares a lot of common properties with other objects. See here for a description. Here only the linear bargraph specific properties are described.

Download this project to see an example how to use the linear bargraph. A PDF is included which explains how the project works.

Direction

The direction of the fill or value line of the bargraph.

For vertical bargraphs a positive direction means that the value grows from bottom to top. A negative direction means that the value grows from top to bottom.

For horizontal bargraphs a positive direction means that the value grows from left to right. A negative direction means that the value grows from right to left.

Default value: Positive

Possible values: Positive or Negative

Axis Orientation

A bargraph can either be vertical or horizontal. Depending on this property the drawing of the bargraph itself and the value changes accordingly.

Default value: Vertical

Possible values: Vertical or Horizontal

Draw Target Line (Theme dependent)

When enabling this property, a line will be drawn at the position of the Target Value property value.

Default value: Enabled

Possible values Enabled or disabled.

Target Line Color (Theme dependent)

The color in which the target line (see above) will be drawn.

Default value:black (RGB 0, 0, 0)

Possible values: Any 24Bit RGB color

Fill Mode (Theme dependent)

If Fill Mode is enabled, the value will be shown as a filled area in the bargraph. If Fill Mode is disabled only a line will be drawn at the value's position.

Default value: Enabled

Possible values: Enabled or disabled.

Draw Ticks (Theme dependent)

It is possible to draw ticks - small lines at the side of the bargraph. The color and the number of the ticks can be configured with the properties below.

Default value: Enabled

Possible values: Enabled or Disabled

Tick Color (Theme dependent)

Define the color of the ticks that shall be drawn with this property. Only has an effect if Draw Ticks is enabled.

Default value: black (0, 0, 0)

Possible values: any 24Bit RGB color

Number Of Ticks (Theme dependent)

As the name of this property implies, the number of the ticks that shall be drawn if Draw Ticks is enabled, can be configured with this property.

The ticks are evenly positioned at the bargraph.

Default value: 12

Possible values: 0 ... 32767 (but not greater than the height of a vertical bargraph or width of a horizontal bargraph)

Needle Image (Theme dependent)

A so called Needle Image can be assigned to a bargraph as a value indicator. It will be moved at the horizontal or vertical axis of the bargraph according to it's value.

Please note that there is a little different behavior for SVG images. If an SVG image shall be used as needle, it needs to have the same size as the bargraph and the needle has to be placed directly in the middle of the needle SVG image. The preview in the design tool will also be different to the look at runtime.

Default value: No image

Possible image: Any image from file system

Linear Bargraph

Linear Bargraph