[<<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