[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 SETBELL()
 Sets the tone frequency and duration for CHR(7) or CA-Clipper's "beep"
------------------------------------------------------------------------------
 Syntax

     SETBELL([<nFrequency>,<nDuration>]) --> cBlank

 Arguments

     <nFrequency>  Designates the frequency for the bell tone in Hertz.
     Values from 21 to 65535 are possible.

     <nDuration>  Designates the duration of the bell tone in 1/100
     seconds.  Values from 1 to 65535 are possible.

     ()  Calling this function without parameters resets the function to the
     default value of 880.30 (a frequency of 880 Hertz and a duration of 0.3
     seconds).

 Returns

     This function always returns a null string.

 Description

     Previously, when you output CHR(7) or completed a GET command with SET
     BELL ON, only an unchangeable tone was produced.  With SETBELL(), the
     frequency and duration of this tone can be modified.  The frequency
     range for this tone is between 21 and 65535 Hertz.  However, the use of
     frequencies outside the audible range (above approximately 16000)
     doesn't make much sense.

     The bell tone default setting is 880 Hertz with a duration of 0.3
     seconds.  These values are reset if no parameters are passed.

 Examples

     .  Select a tone of 300 Hz with 0.2 second duration:

        SETBELL(300, 20)

     .  Reset the function to the default values:

        SETBELL()


See Also: SOUND()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson