TONE()
 Aciona o alto-falante por uma duraçao e frequência especificadas
------------------------------------------------------------------------------

 Sintaxe

     TONE(<nFrequência>, <nDuraçao>) --> NIL

 Argumentos

     <nFrequência> é um valor numérico positivo que indica a frequência
     do som a ser produzido.

     <nDuraçao> é um valor numérico positivo que indica a duraçao do
     som, medida em incrementos de 1/18 de segundo; um segundo, portanto, é
     18.

     Para os dois argumentos, valores nao inteiros sao truncados--e nao
     arredondados--para sua porçao inteira.

 Retorno

     TONE() sempre retorna NIL.

 Descriçao

     TONE() é uma funçao de tratamento de sons utilizada para indicar ao
     usuário os vários estados do programa.  Por estados entende-se estados
     de erro, condiçoes de limite, ou o final de um processo longo.  Por
     exemplo, um estado de erro pode acionar um som de erro antes de alertar
     o usuário através de uma mensagem ou diálogo interativo.  Um condiçao
     de limite pode indicar que o usuário está tentando levar o cursor para
     além dos limites superior ou inferior de uma coluna em um objeto
     TBrowse.  Um processo de batch também pode indicar que chegou ao seu
     final através de um som para alertar o usuário, caso este tenha se
     afastado da tela.

     TONE() funciona acionando o alto-falante na frequência especificada, e
     pela duraçao especificada.  A duraçao é medida em incrementos de 1/18
     de segundo.  A frequência é medida em hertz (ciclos por segundo).
     Frequências abaixo de 20 sao inaudíveis.  A tabela abaixo demonstra as
     frequências de notas musicais padrao.

     ------------------------------------------------------------------------
     . Nota

     TONE() funciona apenas em IBM-PC e computadores 100% compatíveis.
     ------------------------------------------------------------------------


     Tabela 5-33: Notas Musicais
     ------------------------------------------------------------------------
     Nota           Frequência        Nota           Frequência
     ------------------------------------------------------------------------
     C              130.80            mid C          261.70
     C#             138.60            C#             277.20
     D              146.80            D              293.70
     D#             155.60            D#             311.10
     E              164.80            E              329.60
     F              174.60            F              349.20
     F#             185.00            F#             370.00
     G              196.00            G              392.00
     G#             207.70            G#             415.30
     A              220.00            A              440.00
     A#             233.10            A#             466.20
     B              246.90            B              493.90
                                      C              523.30
     ------------------------------------------------------------------------

 Exemplos

       O exemplo a seguir é uma funçao de bip, utilizada para
        indicar que uma operaçao de batch terminou:

        FUNCTION DoneBeep
           TONE(300, 1)
           TONE(100, 1)
           TONE(300, 1)
           TONE(100, 1)
           RETURN NIL

       Este exemplo é uma sequência de sons usada para indicar
        teclagens inválidas ou condiçoes de limite:

        FUNCTION ErrorBeep
           TONE(100, 3)
           RETURN NIL

 Arquivos:  Biblioteca EXTEND.LIB, fonte EXAMPLEA.ASM.
 To download this example - click here.

See Also: CHR() SET BELL