xHarbour Reference Documentation > Function Reference

KeySec()

Starts a timer to write a key code into the keyboard buffer.

Syntax

Keysec( <nKey>     , ;
        <nTime>    , ;
       [<nCounter>], ;
       [<lMode>]     ) --> lSuccess

Arguments

<nKey>

This is the numeric key code to write into the keyboard buffer. #define constants listed in the Inkey.ch file are used for <nKey>.

<nTime>

This is a numeric value specifying the time after which the character is written into the keyboard buffer. Positive values indicate the time in seconds, while negative values are interpreted as multiples of 1/18.2 seconds.

<nCounter>

This parameter specifies the number of times <nKey> should be placed into the keyboard buffer before the timer ends. The default value is 1.

<lMode>

This parameter defaults to .F. (false). When .T. (true) is passed, the timer is reset when a key is pressed.

Return

The function returns .T. (true) when the timer is successfully activated, otherwise .F. (false).

Note:  when the function is called without a parameter, the timer is deactivated.

Info

See also:	HB_IdleAdd(), KEYBOARD, KeyTime()
Category:	CT:Miscellaneous , Keyboard functions , Miscellaneous functions
Source:	ct\keysec.prg
LIB:	xhb.lib
DLL:	xhbdll.dll