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