AppCtrlScript

MAY Computer

Help

PRGFORMSHOW

Applies to  

AppCtrlScript (Module: wmACScr1.dll)

Group  

Other

See also  

PRGFORMCLOSE, PRGFORMSETINFO, PRGFORMSETPROGRESS, PRGFORMSETNEXT

Displays a small window informing about work in progress. Optionally a progress bar can be displayed also. To set the progress bar current value use PRGFORMSETPROGRESS or PRGFORMSETNEXT.

With the variable %PRGFORMCANCEL% you can check if the cancel button on the progress form has been pressed (if enabled). Result will be 1 if cancel has been pressed.

Syntax

PRGFORMSHOW [<FormType>][, <FormTitle>][, <InfoText>][, <FormWidth>][, <MaxItems> 

Part

Description

<FormType>

The visibility of some parts of the form can be changed by specifying one of the keywords below:

  • INFO ... Only show info text
  • CANCEL ... Show info text and cancel button
  • PROGRESS ... Show info text and progress bar
  • PROGRESS[AND]CANCEL ... Info text, progress bar and cancel button
  • PROGRESS[AND]ESTIMATE ... Info text, progress bar and remaining time estimation
  • ALL ... Info text, progress bar, cancel button and remaining time estimation

Default is INFO.

<FormTitle> Title bar caption of the form window. If missing no title bar is displayed.
<InfoText> Short information text describing what is done right now. Default is "Please wait...".
<FormWidth> Width of the form in twips. Default is 4770.
<MaxItems> Number of items that have to be processed (=maximum value for progress bar). Default is 100.