Visualization Element ‘Bar display’

Symbol:

Tag: Measurement controls

This element displays the value of a variable.

Element properties

Element name	Example: GenElemInst_2
Element type	bar display
Value	Variable (numeric data type) The value of the variable is displayed as a bar length.

Element property ‘Position’

The position defines the location and size of the element in the visualization window. These are based on the Cartesian coordinate system. The origin is located at the upper left corner of the window. The positive horizontal x-axis runs to the right. The positive vertical y-axis runs downwards.

X	X coordinate of the upper left corner of the element Specified in pixels. Example: 10.
Y	Y coordinate of the upper left corner of the element Specified in pixels. Example: 10.
Width	Specified in pixels. Example: 150
Height	Specified in pixels. Example: 30

Note

You can also change the values by dragging the box symbols ( ) to other positions in the editor.

See also

• Positioning Elements, Adapting Size and Layer

Element property ‘Background’

Background color	Drop-down list with background colors Note: This property depends on the style. For example, there are no heterochromatic background images for FlatStyle and Whitestyle.
Own image	image: Image ID of the background image. You select the background image from an image pool by clicking the symbol. Info: If you specify the <default> value or select the image from the Default category in the input assistant, then the original element background image is used. Transparent color: Color of pixels that are displayed as transparent. Selection from drop-down list or input assistant.
Optimized drawing	: The background image is drawn one time. If there is a change in the foreground, then only the affected part of the image is redrawn. : The background image is redrawn in cycles. Note: Deactivating this option is sensible only in certain exceptional cases.

Element property ‘Bar’

Diagram type	Position of the scale Scale besides bar Scale in bar Bar in scale No scale
Orientation	Orientation depending on the ratio of width to height of the bar display: Horizontal Vertical
Running direction	Direction the values are increased. Drop-down list for Orientation Horizontal: Left to right Right to left Drop-down list for Orientation Vertical: Bottom to top Top to bottom
Optimum size for bar	: The bar width requires the majority of the element surface. Note: This property depends on the style. It is not provided for FlatStyle or WhiteStyle.

Element property ‘Scale’

Scale start	Lowest value of the scale and the lower limit of the value range for the element (example : 0).
Scale end	Highest value of the scale and the upper limit of the value range for the element (example : 100).
Main scale	Distance between two tick marks of the rough scale (example: 10).
Subscale	Distance between two tick marks of the fine scale (example: 2). You can hide the fine scale by setting the value to 0.
Scale line width	Specified in pixels. Example: 3
Scale color	Color of scale lines : The Color dialog box opens. : A drop-down list with color names opens.
Scale in 3D	: Tick marks are displayed with slight 3D shadowing. Note: This property depends on the style. Not available for FlatStyle.
Element frame	: A frame is drawn around the element.

Element property ‘Label’

Unit	Text that is displayed in the element. Example: Units displayed in m/s.
Font	Font for labels (example: scale numbering). Selection from the drop-down list or by clicking the button.
Scale format (C Syntax)	Values scaled in “printf” syntax Examples: %d, %5.2f
Max. text width of labels	(optional) Value that redefines the maximum width of the scale label. The correct value is normally set automatically. Note: Change this value only if the automatic adjustment does not yield the expected result.
Text height of labels	(optional) Value that redefines the maximum height of the scale label. The correct value is normally set automatically. Note: Change this value only if the automatic adjustment does not yield the expected result.
Font color	Selection from the drop-down list or by clicking the button.

Element property ‘Positioning’

Horizontal offset	Distance from the scale (bar) to the horizontal element frame Specified in pixels. Used for achieving the exact position relative to the background image.
Vertical offset	Distance from the scale (bar) to the vertical element frame Specified in pixels. Used for achieving the exact position relative to the background image.
Horizontal scaling	Horizontal division of the scale Specified in pixels. Used for achieving the exact positioning relative to the background image.
Vertical scaling	Vertical division of the scale Specified in pixels. Used for achieving the exact positioning relative to the background image.

Element property ‘Colors’

Graph color	Color of the bar
Bar background	: The background of the bar is black. : The background of the bar is white.
Frame color	Color that the frames are drawn.
Switch whole color	: The total color of the bar is switched to the color of the color area of the current value.
Use gradient color for bar	: Bar is displayed with a gradient.
Color range markers	The color areas can be separated from each other inside the bar with a vertical mark. No markers: No display. Marker forwards: The color of the vertical mark corresponds to the color of the previous color area. Marker backwards: The color of the vertical mark corresponds to the color of the next color area.
Color areas
Create new	A new color area is added.
Delete	The color area is removed from the list.
Begin of area	Start value of the color area
End of area	End value of the color area
Color	Color that is used for displaying the area.

Element property ‘State variables’

Invisible

Variable (BOOL). Toggles the visibility of the element. TRUE: The element is not visible at runtime.

Element property ‘Access rights’

Requirement: User management is set up for the visualization.

Access rights

Opens the Access rights dialog box for changing the access rights for the element. Status messages: Not set. All rights.: Access rights for all user groups : operable Rights are assigned: limited rights: Access is restricted for at least one group.

See also

• Dialog Box ‘Access rights’