[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
SHOWTIME()
Continuously displays the time at desired screen position
------------------------------------------------------------------------------
Syntax
SHOWTIME([<nRow>], [<nColumn>], [<lMode>],
[<cAttr|nAttr>], [<l12/24>], [<lAM/PM>]) --> cNull
Arguments
<nRow> Designates the row where the time is displayed. The default
is the cursor row.
<nColumn> Designates the column where the time is displayed. The
default is the cursor column.
<lMode> Designates whether seconds are to appear in the time
display (.F.), or not (.T.). The default is display seconds (.F.).
<cAttr|nAttr> Designates to the screen attribute to use for the
time display. Strings in the form "NN/NN" or "CC/CC" (e.g., "0/7" or
"B/GR") are possible. The default is the setting for CLEARA (see
Introduction, Video Functions).
<l12/24> By designating this parameter as .T., a 12-hour display is
selected. The default is a 24-hour display (.F.).
<lAM/PM> If you have a 24-hour display, you may want to switch on
an am/pm display. When you specify this parameter as .T., an "a" or "p"
(as in DOS), appears to reflect the time. The default is no display
(.F.).
() A call without parameters uninstalls the time display.
Returns
SHOWTIME() always returns a null string.
Description
This function permits you to constantly display the time in any screen
position desired. SHOWTIME() is interrupt controlled and has the ability
to display the time in either "hh:mm:ss" or "hh:mm" format. A 12- or 24-
hour display can be selected, with or without an am/pm display.
Notes
Warning! SHOWTIME() works with the interrupt system. Before
leaving your CA-Clipper application, you must uninstall SHOWTIME() , so
that the interrupt vectors can be restored. Otherwise, the system will
be unstable and will eventually crash. Simultaneous use of the
accompanying Extended Drivers Modules automatically restores the
interrupt vectors in use.
. Specify the screen attribute as either a numeric or a string
in "NN/NN" form. If no attribute is specified, the value for CLEARA
applies (see Introduction Video Functions).
Examples
. Display a clock in row 0, column 70, with no seconds display
and the standard attribute. When a display is shown in row 0, switch
SCOREBOARD off!
SET SCOREBOARD OFF
SHOWTIME(0, 70, .T.) // Turn on clock
*...
*...
nSHOWTIME() // Uninstall clock
. Show a 12-hour display with am/pm on the lowest row. White
letters on a blue background:
SHOWTIME(24, 70, .T., "W/B")
See Also:
Introduction
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson