Documentation / Widgets / Visualiser / Bar

Bar

A progress bar. Bind its Value to a variable for a level readout.

Group: Visualiser · Default size: 180 × 16 · Style parts: Main, Indicator

A dropped Bar: a pale blue track filled blue to 60 percent.
A Bar as it is dropped, at 60.
The Bar settings section: Min 0, Max 100, Mode Normal, Orientation Auto (from the size), Value 60, Animate, Anim time 0 ms.
Its settings.
SettingDefaultWhat it does
Min / Max0 / 100The range.
ModeNormalThe same three as the slider: Normal from the start, Symmetrical from zero, Range between a start value and the value.
Value60The initial value.
Start value0The lower end of the fill in Range mode.
AnimateoffWhether value changes slide rather than jump.
Anim time0 msHow long the slide takes.

Example: a battery level

  1. On the Data tab add an Integer variable called battery, with Initial value 72.
  2. Drag a Bar onto the screen and name it Battery: X 60, Y 120, Width 200, Height 20. Bind its Value to battery.
  3. Drag a Label above it and bind its Text to battery, with Prefix Battery and Postfix %.
  4. Press Preview: 72%. Give the variable a Source - an analog input reading the battery, say - and the bar follows the board’s own reading.
Preview: the words Battery 72% above a bar filled almost three quarters.
The bar and its label in Preview.
The bar's Data bindings: Variable battery, Drives Value.
The bar follows the variable.