[<<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
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson