Programmer Guide/Macro Library/PROGRESSBOX: Difference between revisions
m (1 revision: Initial import) |
|||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:{{SUBPAGENAME}}}} | {{DISPLAYTITLE:{{SUBPAGENAME}}}} | ||
| {{TOC limit|3}} | ||
==PROGRESSBOX== | ==PROGRESSBOX== | ||
This is a simple implementation of a progress bar dialog which can be used to display information about a running process. Most progress dialogs in | This is a simple implementation of a progress bar dialog which can be used to display information about a running process. Most progress dialogs in {{STX}} use this function. | ||
| | ||
==BEGIN== | ===BEGIN=== | ||
Initialize the progress box and create the progress box window. | Initialize the progress box and create the progress box window. | ||
| Line 45: | Line 43: | ||
The progress box handle; This result value must be used as the handle for all other calls to [[Programmer Guide/Macro Library/PROGRESSBOX|PROGRESSBOX]]! | The progress box handle; This result value must be used as the handle for all other calls to [[Programmer Guide/Macro Library/PROGRESSBOX|PROGRESSBOX]]! | ||
===END=== | |||
==END== | |||
Deletes the progress box. | Deletes the progress box. | ||
| Line 64: | Line 61: | ||
none | none | ||
===SET=== | |||
==SET== | |||
Updates the progress bar position and text and checks if user input is available (e.g. Escape-key, close progress dialog, ...). If user input is available, the message is returned. | Updates the progress bar position and text and checks if user input is available (e.g. Escape-key, close progress dialog, ...). If user input is available, the message is returned. | ||
| Line 91: | Line 87: | ||
An empty string or a message from the progress dialog | An empty string or a message from the progress dialog | ||
===SETVALUE=== | |||
==SETVALUE== | |||
Updates progress bar position. | Updates progress bar position. | ||
| Line 113: | Line 108: | ||
none | none | ||
| | ||
==TITLE== | ===TITLE=== | ||
Updates the progress box caption. | Updates the progress box caption. | ||
| Line 137: | Line 131: | ||
none | none | ||
===TEXT=== | |||
==TEXT== | |||
Updates the progress box static text control. | Updates the progress box static text control. | ||
| Line 160: | Line 151: | ||
=====Result:===== | =====Result:===== | ||
An empty string or a message from the progress dialog | |||
Array | Array | ||
Latest revision as of 11:48, 22 March 2017
PROGRESSBOX
This is a simple implementation of a progress bar dialog which can be used to display information about a running process. Most progress dialogs in STx use this function.
BEGIN
Initialize the progress box and create the progress box window.
Usage:
PROGRESSBOX BEGIN parent|* style textwidth barrange ; title ; text
Parameters:
- parent
- The name of the parent display or dialog item or an asterisk.
- style
- This is not used and should be set to
0.
- textwidth
- The number of text characters used for the text control (static).
- barrange
- The progress bar range. barrange must be <= 0 if no progress bar should be displayed.
- title
- The dialog window caption.
- text
- The text to be displayed in the dialog.
Result:
The progress box handle; This result value must be used as the handle for all other calls to PROGRESSBOX!
END
Deletes the progress box.
Usage:
PROGRESSBOX END handle
Parameters:
- handle
- The handle returned by the call to
PROGRESSBOX BEGIN.
Result:
none
SET
Updates the progress bar position and text and checks if user input is available (e.g. Escape-key, close progress dialog, ...). If user input is available, the message is returned.
Usage:
PROGRESSBOX SET handle position text
Parameters:
- handle
- The handle returned by the call to
PROGRESSBOX BEGIN.
- position
- The progress bar position (0 .. progress bar range, as set in
PROGRESSBOX BEGIN)
- text
- The text to display in the progress box.
Result:
An empty string or a message from the progress dialog
SETVALUE
Updates progress bar position.
Usage:
PROGRESSBOX SETVALUE handle position
Parameters:
- handle
- The handle returned by the call to
PROGRESSBOX BEGIN.
- position
- The progress bar position (0 .. progress bar range, as set in
PROGRESSBOX BEGIN)
Result:
none
TITLE
Updates the progress box caption.
Usage:
PROGRESSBOX TITLE handle title
Parameters:
- handle
- The handle returned by the call to
PROGRESSBOX BEGIN.
- title
- The text to display in the progress box window caption.
Result:
none
TEXT
Updates the progress box static text control.
Usage:
PROGRESSBOX TEXT handle text
Parameters:
- handle
- The handle returned by the call to
PROGRESSBOX BEGIN.
- text
- The text to display in the progress box.
Result:
An empty string or a message from the progress dialog
Array
