NEXTKEY()
 Lê a tecla pendente no buffer de teclado
------------------------------------------------------------------------------

 Sintaxe

     NEXTKEY() --> nCodInkey

 Retorno

     NEXTKEY() retorna um valor numérico inteiro que varia entre -39 e 386.
     Se o buffer de teclado estiver vazio, NEXTKEY() retorna 0.  Se SET
     TYPEAHEAD for zero, NEXTKEY() sempre retorna zero.

 Descriçao

     NEXTKEY() é uma funçao de tratamento de teclado que lê a tecla pendente
     no buffer de teclado sem removê-la.  O valor retornado é o código
     INKEY() da tecla pressionada--o mesmo valor retornado por INKEY() e
     LASTKEY().  NEXTKEY() retorna valores para todos os caracteres ASCII,
     bem como combinaçoes de teclas de funçoes, Alt-teclas de funçao,
     Ctrl-teclas de funçao, Alt-letra, e Ctrl-letra.

     NEXTKEY() é semelhante à funçao INKEY(), porém difere em um aspecto
     fundamental.  INKEY() remove a tecla pendente do buffer de teclado e
     atualiza LASTKEY() com o valor da tecla.  NEXTKEY(), por outro lado, lê
     mas nao remove a tecla o buffer de teclado, e nao atualiza LASTKEY().

     Como NEXTKEY() nao remove a tecla do buffer de teclado, ela pode ser
     utilizada para receber o buffer de teclado e depois passar o controle
     para uma rotina que usa um estado de espera ou a funçao INKEY() para
     efetivamente capturar a tecla do buffer.

     Para uma lista completa dos códigos INKEY() e constantes Inkey.ch,
     consulte o Apêndice C neste livro.

 Exemplos

     Este exemplo coloca uma tecla Esc no buffer de teclado, e depois mostra
     as diferenças entre INKEY(), LASTKEY(), e NEXTKEY():

     #include "Inkey.ch"
     //
     CLEAR TYPEAHEAD
     KEYBOARD CHR(K_ESC)
     //
     ? NEXTKEY(), LASTKEY()              // Resulta: 27 0
     ? INKEY(), LASTKEY()                // Resulta: 27 27
     ? NEXTKEY()                         // Resulta: 0

 Arquivos:  Biblioteca EXTEND.LIB, arquivo header Inkey.ch.
 To download this example - click here.

See Also: INKEY() LASTKEY() KEYBOARD SET TYPEAHEAD Códigos INKEY()