[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
SETBOXGROW()
Opens boxes with a time delay
------------------------------------------------------------------------------
Syntax
SETBOXGROW(<nTimeDelay>) --> cBlank
Argument
<nTimeDelay> Designates the time delay in milliseconds with which
boxes are opened in "grow" mode.
Returns
The function always returns a null string.
Description
Normally boxes are only formed with the WBOX() function, the CA-Clipper
@ .. BOX command, or the CA-Clipper @ .. CLEAR TO .. [DOUBLE]
command. By using SETBOXGROW(), you can establish the display for empty
boxes in a "grow" mode
A box grows from the midpoint of the window outward when SETBOXGROW()
has been set. The <nTimeDelay> parameter is the time delay in
milliseconds between the individual steps.
But there are two exceptions to the rule on the <nTimeDelay> parameter.
If the parameter is 0, the box is (re)opened, but not in "grow" mode.
And if the parameter is 1, the box is opened in "grow" mode, but without
a time delay.
Notes
. The "grow" mode is only functional when a fill character has
been specified. If you do not specify a parameter with WBOX(), the
default settings are used.
. When you work with "snow prevent", do not specify a time delay
for boxes.
Example
Specify 10 milliseconds between each growth step of a box:
SETBOXGROW(10)
WOPEN(2, 2, 23, 78) // Nothing happens
WBOX() // The box is generated with
// a time delay
See Also:
WBOX()
GETBOXGROW()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson