Widget "ProgressBar" displays a progress indicator bar. The bar is displayed as a range from 0-100%.
The following properties cannot be used in compound widget "Mapping":
zIndex, left, top, height, width
Appearance
|
|
Editor |
Web browser |
Properties
Type |
Description |
Bindable |
Necessary |
Default value |
|
barAnimation |
Defines whether the progress bar's animation is displayed. This option has no effect if "stripedProgressBar" is set to value false. |
|
|
false |
|
Defines the usability of the widget. A disabled widget (enable=false) does not react to user interaction and does not trigger events. The "enable" behavior is inherited from the container widgets to the child widgets. |
|
|
true |
||
labelPosition |
Defines the position of the text field for displaying the percentage. Possible values: right, left, middle, center, top, bottom |
|
|
right |
|
labelSize |
Defines the minimum width or height of the text field depending on the alignment of the widget. |
|
|
30 |
|
Defines the maximum permissible value for value binding. Value value is scaled in the configurable range of minValue and maxValue. |
|
|
100 |
||
Defines the minimum permissible value for value binding. Value value is scaled in the configurable range of minValue and maxValue. |
|
|
0 |
||
orientation |
Defines the direction in which the bar is filled. |
|
|
LeftToRight |
|
permissionOperate |
Defines the roles that are permitted to use the widget. For roles without sufficient rights, the widget does not react to user interaction and does not trigger events. |
|
|
|
|
permissionView |
Defines the roles that are permitted to see the widget. For roles without sufficient rights, the widget is hidden. |
|
|
|
|
showLabel |
Defines whether the text field for displaying the percentage is shown. |
|
|
true |
|
stripedProgressBar |
Defines whether striped styling is applied to the bar. |
|
|
false |
|
Reference to a customizable widget style. |
|
|
default |
||
Defines the value of the widget (permissible value between minValue and maxValue) Set value value is displayed as a percentage within the range of minValue and maxValue. |
|
|
0 |
||
Value with minValue and maxValue for node binding. Set value node is displayed as a percentage within the range of minValue and maxValue. Note: The unit symbol, such as °C, is not displayed. |
|
|
|
||
Defines the visibility of the widget. The widget can be hidden with visible=false. (visible = true, hidden = false). The "visible" behavior is inherited from the container widget to the child widgets. |
|
|
true |
||
zIndex determines the z-order of the widget. With overlapping widgets, the zIndex determines which widget is on the top and which one is on the bottom. The widget with the larger zIndex is on top, and the one with the smaller zIndex is on the bottom. The zIndex must be unique within a piece of content or a container widget. The zIndex is automatically assigned by the visual editor and can therefore be changed via the toolbar. |
|
|
|
||
left |
Absolute position measured from the left border of the surrounded element (e.g. container widget or content). |
|
|
|
|
top |
Absolute position measured from the top border of the surrounded element (e.g. container widget or content). |
|
|
|
|
height |
Defines the total height of the widget in pixels. A value in % refers to the height of the surrounding element. |
|
|
25 |
|
width |
Defines the total width of the widget in pixels. A value in % refers to the width of the surrounding element. |
|
|
400 |
|
transitionTime |
Defines the time (ms) the bar needs to move to a new position when a value changes. |
|
|
500 |
|
tooltip |
Defines the text that should appear as information when the tooltip indicator is pressed. You can use a static text or a text from the text system. For more information, see here. Mode "Tooltip" must be enabled for this. There are two different options for this: •Using action "ShowTooltip" •Using action "Client system" ShowTooltips. |
|
|
|
|
tabIndex |
Property tabIndex is used to manage the tab order during keyboard operation. For additional information, see Keyboard operation. ENTER triggers event Click if tabIndex ≥0. |
|
|
-1 |
Styleable properties
Type |
Description |
Default value |
|
opacity |
Defines the transparency of the widget. The lower the value, the more transparent the widget. |
1 |
|
padding |
Defines the spacing between the outer boundary of the widget and its content. For more information, see here. |
0px |
|
margin |
Defines the offset of the external boundary of the widget to the widget's actual set position. For more information, see here. |
0px |
|
shadow |
Defines the shadow of the widget. |
none |
|
barBorderStyle |
Defines the style of the bar's border. Borders can be unbroken, dashed or dotted. |
none |
|
barBorderWidth |
Defines the width of the bar's border. |
1px |
|
barBorderColor |
Defines the color of the bar's border. |
#000000 |
|
barCornerRadius |
Defines the corner style of the bar. |
20px |
|
barBackColor |
Defines the background color of the bar. |
#E0E0E0 |
|
barColor |
Defines the foreground color of the bar. |
#FF8800 |
|
barBackGroundGradient |
Defines the background color of the progress bar as a color gradient. |
|
|
barGradient |
Defines the foreground color of the bar as a color gradient. If property stripedProgressBar is defined as true, "barGradient" is not applied. |
|
|
borderStyle |
Defines the style of the border around the widget. Borders can be unbroken, dashed or dotted. |
solid |
|
borderWidth |
Defines the width of the border around the widget. |
1px |
|
borderColor |
Defines the color of the border around the widget. |
#000000 |
|
cornerRadius |
Defines the corner style of the widget. |
4px |
|
backColor |
Defines the background color of the widget. |
Transparent |
|
fontName |
Defines the font used for the text shown. |
Arial |
|
fontSize |
Defines the size of the font used to display the text. |
12px |
|
fontColor |
Defines the color used to display the text. |
#000000 |
|
bold |
Defines whether the text is shown in bold. |
false |