xHarbour Reference Documentation > Function Reference

ShowTime()

Displays the system time continuously at a specified screen position.

Syntax

ShowTime( [<nRow>]     , ;
          [<nCol>]     , ;
          [<lHideSecs>], ;
          [<cColor>]   , ;
          [<l12h>]     , ;
          [<lAmPm>]      ) --> cNull

Arguments

<nRow>

This is a numeric value in the range of 0 to MaxRow(). It specifies the row position for the time display. It defaults to Row().

<nCol>

This is a numeric value in the range of 0 to MaxCol(). It specifies the column position for the time display. It defaults to Col().

<lHideSecs>

If this parameter is set to .T. (true), the time is displayed without seconds. The default value is .F. (false).

<cColor>

An optional SetColor() compliant color string can be specified to display the time. It defaults to the standard color of SetColor().

<l12h>

If this parameter is set to .T. (true), the time is displayed using a 12h clock. The default value is .F. (false), i.e. a 24h clock is used.

<lAmPm>

If <l12h> is .T. (true), an AM/PM indicator can be added to the time display by by setting <lAmPm> to .T. (true). The default is .F. (false).

Return

The function returns a null string ("").

Description

The ShowTime() function must be called at least with one parameter to install the time display at the specified position. Calling ShowTime() without a parameter again stops the time display.

Info

See also:	Time()
Category:	CT:DateTime , Date and time
Source:	ct\dattime3.prg
LIB:	xhb.lib
DLL:	xhbdll.dll

Example

// The example displays the time using a 12h clock
// while the Browse() function is active.

   PROCEDURE Main
      CLS
      ShowTime( 0, MaxCol()-8,,"N/BG" ,.T. , .T. )

      USE Customer

      Browse()

   RETURN