Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Nanforum Toolkit v2.1 Reference Guide - <b>ft_pending()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 FT_PENDING()
 Display same-line pending messages after a wait.
------------------------------------------------------------------------------

 Syntax

      FT_PENDING ( <cMsg>, [ <nRow> ], [ <nCol> ], ;
                        [ <nWait> ], [ <cColor> ] ) -> NIL

 Arguments

     <cMsg> is the message string to display.

     <nRow> is an optional screen row for message display, default row 24.

     <nCol> is an optional screen col for message display, default col 0.

     <nWait> is an optional wait (sec) between messages, default 5 sec.

     <cColor> is an optional color string for displayed messages, default
              is white text over red background.

 Returns

     NIL

 Description

     A good way to display information messages during the running
     of an application is to send them all to the SAME line on the
     screen where users are expected to look for them. In order to
     give users a chance to read the current message before the next one
     is displayed we may need to insert a delay after each message.

     FT_PENDING() function displays messages by keeping track of
     the time of the last message and providing a delay ONLY if the next
     pending message is issued much too soon after the current one.

 Examples

     FT_PENDING("Message one",20,0,3,"W+/G") // Displays "Message one."
                                             // sets row to 20, col to 0.
                                             // wait to 3 and color to
                                             // bright white over green.
     FT_PENDING("Message two")   // Displays "Message two", after 5 sec.
     FT_PENDING("Message three") // Displays "Message three", after 5 sec.


     Note that default row, col, wait time and color need to be set only
     once in the very first call to FT_PENDING() and only if the internal
     default values are not appropriate.


 Source: PENDING.PRG

 Author: Isa Asudeh

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson