<< Click to Display Table of Contents >> Navigation: Object Reference > Palette Objects > Linear Bargraph |
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.
DirectionThe 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 OrientationA 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 |
The following events can be configured for the linear bargraph object: •OnOpenForInput •OnEnabledWithFocus •OnEnabledWithoutFocus •OnValueChange •OnEnterValue •OnEnterNewValue •OnEscape See here for the descriptions of all event and possible actions that can be assigned. |