PROGRESS

PLBCMP GUI Only

The PROGRESS instruction defines an object variable for a progress bar. Progress bars provide users with visual feedback about the progress of a procedure within an application. As the procedure progresses, the rectangular progress bar gradually fills. To define a PROGRESS bar, use one of the following statement formats:

(1)	[label]	PROGRESS	[%]
(2)	[label]	PROGRESS	(arraysize)
(3)	[label]	PROGRESS	^
(4)	[label]	PROGRESS	^,{target}
(5)	[label]	PROGRESS	^(arraysize)
(6)	[label]	PROGRESS	^(arraysize),({target}),...,({target})

Where:

label

Optional. A Data Label.

Optional. Denotes the item as being GLOBAL.

arraysize

Required. An integer decimal constant, CONST variable, or EQUATEd value indicating the number of array items.

Optional. Denotes the item as being a POINTER.

target

Required. The name of a previously defined data item of the same type.

Flags Affected: NONE

Note the following:

The PROGRESS object allows a user to provide a visible indication of a percentage completion of a task. This is accomplished by filling a portion of the bar representing the percentage of completion.
The percentage value is displayed in the center of the bar.
Multi-dimension arrays are supported up to a maximum of fourteen dimensions.
The ^ denotes Pointer Variable.
Although a PROGRESS object may be defined as Global, it is DESTROYed during a CHAIN instruction.