SCROLL()
 Rola uma regiao de tela para cima ou para baixo
------------------------------------------------------------------------------

 Sintaxe

     SCROLL(<nTopo>, <nEsquerda>,
        <nBase>, <nDireita>, <nLinhas>) --> NIL

 Argumentos

     <nTopo>, <nEsquerda>, <nBase>, e <nDireita> definem as
     coordenadas da regiao a ser rolada.  Valores de linha e coluna podem
     variar entre 0, 0 e MAXROW(), MAXCOL().

     <nLinhas> define a quantidade de linhas a serem roladas.  Um valor
     maior do que zero rola para cima a quantidade especificada de linhas.
     Um valor menor do que zero rola para baixo a quantidade especificada de
     linhas.  Um valor de zero apaga a área especificada.

 Retorno

     SCROLL() sempre retorna NIL.

 Descriçao

     SCROLL() é uma funçao de tratamento de tela que rola uma regiao de tela
     para cima ou para baixo uma quantidade de linhas especificada.  Quando
     uma tela rola a primeira linha da regiao apagada para cima, todas as
     outras linhas sao movidas para cima, e uma linha em branco é exibida na
     cor padrao corrente na última linha da regiao especificada.  Se a
     regiao rolar para baixo, esta orientaçao é revertida.  Caso a regiao de
     tela seja rolada mais de uma linha, este processo é repetido.

     SCROLL() é utilizada primordialmente para exibir informaçoes de status
     em uma regiao de tela definida.  Cada vez que uma nova mensagem for
     exibida, a regiao de tela é rolada uma linha para cima, e uma nova
     linha é exibida no final.

 Exemplos

     A seguinte funçao definida pelo usuário exibe uma mensagem no fim de
     uma regiao de tela após a rolar a regiao uma linha para cima:

     FUNCTION ScrollUp( nTop, nLeft, nBottom, nRight, expDisplay )
        //
        SCROLL(nTop, nLeft, nBottom, nRight, 1)
        @ nBottom, nLeft SAY expDisplay
        //
        RETURN NIL

 Arquivos:  Biblioteca EXTEND.LIB.
 To download this example - click here.

See Also: @...BOX @...CLEAR @...TO