isCOBOL Evolve : Appendices : Library Routines : W$PROGRESSDIALOG : WPROGRESSDIALOG-CREATE
WPROGRESSDIALOG-CREATE
The WPROGRESSDIALOG-CREATE function creates and starts the progress dialog.
Syntax:
 CALL "W$PROGRESSDIALOG" USING WPROGRESSDIALOG-CREATE
                               title
                               cancelMessage
                               flags
                              [bitmapHandle]
                        GIVING pDialogHandle
Parameters:
WPROGRESSDIALOG-CREATE
Constant
 
title
PIC X(n)
It specifies the text that will appear in the title bar of the progress dialog.
cancelMessage
PIC X(n)
It specifies the text that is shown on line 3 (below the progress bar) when the user clicks the Cancel button.
flags
PIC 9(n)
It specifies flags that determine the operation of the progress dialog. This can be a combination of the following values, defined in isgui.def:
 
WPROGRESSDIALOG-NORMAL (value 0): Normal progress dialog behavior.
WPROGRESSDIALOG-MODAL (value 1): The progress dialog box will be modal to the current window. By default, a progress dialog box is modeless.
WPROGRESSDIALOG-AUTOTIME (value 2): Automatically estimate the remaining time and display the estimate on line 3. If this flag is set, WPROGRESSDIALOG-SET-LINE can be used only to display text on lines 1 and 2.
WPROGRESSDIALOG-NOTIME (value 4): Do not show the "time remaining" text.
WPROGRESSDIALOG-NOPROGRESSBAR (value 16): Display a progress bar in indeterminate state.
bitmapHandle
PIC S9(9) COMP-4
Optional parameter. It specifies an icon to be shown top-right of the dialog.
Return code:
pDialogHandle must be a USAGE HANDLE data item. It receives the handle of the list of users and will be used with the other W$PROGRESSDIALOG functions.