show / hide menu

Progress Bar

A progress bar is a graphical control element utilized to represent the progress of a prolonged computer operation, like downloading, file transferring, or installing. Occasionally, the graphic is accompanied by a textual representation of progress in a percentage format. When the progress of the task cannot be determined, it could be expressed as a percentage in the progress bar.

Working with Progress Bar

1. Create a form with a ‘Progress Bar’, as shown below:

Figure1

2. In the general properties section of the properties tab, users can set the Default Value, Max Value, Show Text, Text, and Use MultiColor options.

Figure2: General properties

Default Value and Max Value

The Default Value and Max Value define the progress range for a single criterion. 

Figure 3

Example: If the Default Value is 75 and the Max Value is 100, the progress bar displays 75% progress. 

Figure 4: Default Value and Max Value preview

Example 2: Show Text is set to True, and Text is set to “In Progress”. 

   Figure 5

Use MultiColor

When the Use Multi Color option is enabled, the Configure option becomes available.

  • Click the Settings icon in the Configure column.
  • The Progress Bar Configuration window opens.
  • Configure the following properties for each progress segment:
    • Progress Color
    • Font Weight
    • Font Color
    • Percentage
    • Text
  • Click OK to save the configuration.

Figure 7

The configuration of a multicolor progress bar is used to visually represent the progress of multiple criteria.

Figure 8: Progress bar configuration window

In the Progress Bar Configuration window, the total percentage must equal 100. If the total is not 100, a warning message is displayed, and the configuration cannot be saved until the percentages are adjusted to total 100.

Figure9: Warning message


Figure 10

After clicking the ‘OK’ button, the applied configuration values will appear in the progress bar.

Figure 11: Preview_multicolor

3: In the Properties Tab, users have the ability to adjust parameters such as width, height, progress color, border color, border thickness, box shadow, etc. (See Figure 12)

Figure 12

Designer Properties

Here is the list of available properties in the progress bar from the designer:

General
S.NoProperty NameData TypeDescription
1Control Name  StringIt specifies a unique name for the control within the form.  
2Control Type  StringIt specifies the type of control.  
3ID  IntegerSpecifies a unique identifier for the Progress Bar control  
4Default Value  Int  Specifies the initial value of the Progress Bar when the form  
5Max ValueIntSpecifies the maximum value that the Progress Bar can reach.  
6Show TextBoolean  Displays text inside the progress bar. 
7TextStringSets text displayed in the progress bar. 
8RemarksStringIt is used to add notes, comments, or explanations about the Progress Bar control.  
9Use MulticolorBoolean  Determines whether the progress bar can display multiple colors along its fill instead of a single, uniform color.  
10Configure  Configures the progress bar colors. 
Style
11WidthInt  Set the control width. 
12HeightInt Set the control height. 
13Line HeightIntSets the line height of the displayed text. 
14Text AlignmentStringAligns the text inside the progress bar. 
15MarginStringSets the edge or outer margin to the control.
16PaddingStringSets the space inside the progress bar, between its border and its content.  
17Progress colorStringSets the color of the filled portion that indicates the progress.  
18BorderBooleanSets the outline around the progress bar, giving it a visible edge.  
19Border ThicknessStringSets the border width. 
20Border StyleStringSet the border style. 
21Border RadiusStringRounds the border corners. 
22Border colorStringSets the border color of the control.
23Box shadowStringApplies a shadow effect. 
24Enable Custom fontStringAllows using a custom font. 
25FontStringSets the font face\style.
26Custom FontStringSets the custom font style of the text on the Progress bar. This will be available only on enabling “Enable Custom Font” property.
27Font SizeStringSet the font size.
28Font ColorStringSet the text color. 
29Background ColorStringSets the background color of the unfilled area.  
30VisibleBooleanShows or hides the control. 
31BoldStringTo make the control text Bold.
32ItalicStringDisplays text in italics. 
33UnderlineStringUnderlines the text. 
34Column SpanIntegerDefines the number of grid columns occupied. 
Rules
35Rules Opens the Rules Engine for the selected control. 
Template
36Inherit TemplateBooleanEnable this property to inherit control style from applied template
Custom Style
37CSS ClassStringAllows you to add CSS class to your control to change the default formatting for any of our themes
Reports
38Control Report Control Report will redirect to the Reports tab that will display all the configurations, rules and data sources details associated with the selected control.
Custom Property
39HTML AttributeStringAdds custom HTML attributes to the control.
Responsive Options
40Template NameStringRepresents the template name of the control shown in the Responsive UI configuration. The template name is the same as the control’s name.