A progress bar is a window that an application can use to indicate the progress of a lengthy operation. It consists of a rectangle that is gradually filled, from left to right, with the system highlight color as an operation progresses. It has a range and a current position. The range represents the entire duration of the operation, and the current position represents the progress that the application has made toward completing the operation.
The ProgressBar class provides methods to change the range and the current position of the progress bar. The window procedure uses the range and the current position to determine the percentage of the progress bar. The highest possible range or current position value is 65,535.
Refer to OODPBAR.REX and PROPDEMO.REX in the OODIALOG\SAMPLES directory for an example.
The ProgressBar class does not send any notification messages. For information about notification messages, refer to ConnectListNotify.
The ProgressBar class requires the class definition file oodwin32.cls:
::requires "oodwin32.cls"
Instances of the ProgressBar class implement the methods listed in the ProgressBar Instance Methods table.
>>-aProgressBarControl~Step(--+-----------+--)-----------------><
+-increment-+
The Step method advances the current position of a progress bar or the increment set with the SetStep method (see SetStep), and redraws the bar to reflect the new position.
The only argument is:
The value for advancing the current position. If you do not specify this argument, the position is advanced by the value set with the SetStep method. If the position exceeds the maximum range value, the progress indicator starts at the beginning again.
The previous position.