Introduction
A non-visible extension that indicates the progress of an operation using an animated linear bar.
Release date: 2022-04-19T04:30:00Z
Version: 2
Package name: com.gordonlu.linearprogressbar
Built with: Niotron IDE
Some things to note:
-
the Theme of Screen1 must not be Classic.
-
you cannot use a linear progress bar ID that you have previously used in the same screen.
Documentation
Event blocks
ProgressChanged
This event is fired when the progress of a linear progress bar has changed. The progress parameter returns the current progress value. If you have enabled Inderterminate for this progress bar, 'progress' will be 0.
Parameters: container = component, id = number (int), progress = number (int)
Method blocks
CreateLinearProgressbar
Creates a linear progress bar in the given container. If indeterminate is true, an infinite loading animation will be shown on the progress bar.
Parameters: container = component, id = number (int), color = color, indeterminate = boolean
CreateUsableId
Creates a usable ID that you can use to create a new progress bar. Each progress bars in every screen should have a unique ID. You should save this in a global variable for later use and to avoid conflicts.
Returns: number (int)
Parameters: container = component
GetMaximum
Returns the upper range of the progress bar.
Returns: number (int)
Parameters: container = component, id = number (int)
GetMinimum
Returns the lower range of the progress bar. Only works in devices with Android >= 8.
Returns: number (int)
Parameters: container = component, id = number (int)
GetProgress
Get the progress bar's current level of progress. Return 0 when the progress bar is in indeterminate mode.
Returns: number (int)
Parameters: container = component, id = number (int)
IncrementProgressBy
Increases the progress bar's progress by the specified amount.
Parameters: container = component, id = number (int), value = number (int)
IsIndeterminate
Checks whether the progress bar is indeterminate or not.
Returns: boolean
Parameters: container = component, id = number (int)
SetIndeterminate
Change the indeterminate mode for this progress bar. In indeterminate mode, the progress is ignored and the progress bar shows an infinite animation instead.
Parameters: container = component, id = number (int), indeterminate = boolean
SetIndeterminateColor
Changes the indeterminate color of the progress bar.
Parameters: container = component, id = number (int), color = color
SetMaximum
Sets the upper range of the progress bar.
Parameters: container = component, id = number (int), max = number (int)
SetMinimum
Sets the lower range of the progress bar. Only works in devices with Android >= 8.
Parameters: container = component, id = number (int), min = number (int)
SetPadding
Sets the padding for the progress bar.
Parameters: container = component, id = number (int), left = number (int), top = number (int), right = number (int), bottom = number (int)
SetProgress
Sets the current progress to the specified value. Does not do anything if the progress bar is in indeterminate mode.
Parameters: container = component, id = number (int), progress = number (int)
SetProgressColor
Changes the progress color of the progress bar.
Parameters: container = component, id = number (int), color = color
FAQ
Q1: What is the difference between progress color and indeterminate color?
A1: You set the color of the progress bar with SetIndeterminateColor if your progress bar is indeterminate. Else use SetProgressColor.
Q2: What is a container?
A2: A container is used to contain your progress bar. The height and the width of the progress bar will be adjusted to the dimensions of the container. The container should only contain the progress bar, as if you put other components in the container, the progress bar will overlap them.
The container can be a horizontal or vertical arrangement, but not a scroll arrangement.
Q3: Sample blocks?
A3: Sure, here.
Downloads
AIX: com.gordonlu.linearprogressbar.aix (10.7 KB)
History
Version 1, April 19 2022
AIX:
com.gordonlu.linearprogressbar.aix (9.7 KB)
Made with Niotron IDE.
Kindly 
PM me if you have any questions! Also, if you like my extension, please 
like it! It takes some effort for me to make it...
Likes tell me the general user feedback of my extension. If you read this extension, please take 20 seconds to drop by and give a like!
If you have any features that you want to add and you know the code, PM me or directly reply below using the 
button.
If you find any 
bugs, please reply below.
Gordon Lu
Message
Website
