SAVE SCREEN*
 Grava a tela corrente num buffer ou variável
------------------------------------------------------------------------------

 Sintaxe

     SAVE SCREEN [TO <idVar>]

 Argumentos

     TO <idVar> especifica a variável à qual serao atribuídos os
     conteúdos da tela corrente como um valor de caractere.  Se <idVar> nao
     for visível ou nao existir, uma variável de memória do tipo privada é
     criada e a ela atribuída a tela.

 Descriçao

     SAVE SCREEN é um comando sinônimo à funçao SAVESCREEN() que grava a
     tela de 0, 0 a MAXROW(), MAXCOL() no buffer de tela padrao, ou em uma
     variável opcional.  Se a tela for gravada em uma variável, esta pode
     ser de qualquer classe de armazenamento, inclusive campo, local,
     estática, ou elemento de vetor.  Observe, porém, que você nao pode
     gravar variáveis tipo vetor, local ou estática em arquivos (.mem) com a
     finalidade de gravar telas mútiplas no disco.

     O comando SAVE SCREEN é utilizado juntamente com o comando RESTORE
     SCREEN para impossibilitar que uma tela original que tenha sido
     temporariamente substituída seja re-escrita.  Telas múltiplas podem ser
     gravadas através da atribuiçao de cada tela a uma variável diferente.

     SAVE SCREEN é um comando de compatibilidade e, portanto,
     desaconselhado.  Ele está superado pela funçao SAVESCREEN(), a qual
     pode gravar telas parciais ou completas.

     -----------------------------------------------------------------------
     . Aviso

     Os comandos e funçoes SAVE SCREEN, RESTORE SCREEN, SAVESCREEN(), e
     RESTSCREEN() nao sao aceitos quando ANSI.OBJ ou IBMANSI.OBJ estao
     linkados ao programa corrente.
     -----------------------------------------------------------------------

 Exemplos

       Este fragmento de código demonstra o uso de um vetor estático
        para armazenar telas gravadas:

        STATIC aScreens[10]
        SAVE SCREEN TO aScreens[1]
        //
        <declaraçooes>...
        //
        RESTORE SCREEN FROM aScreens[1]

       Este exemplo demonstra como gravar e recuperar telas
        utilizando um arquivo de dados:

        USE Screens INDEX Name NEW
        APPEND BLANK
        Screens->Name := "Screen001"          // Guarda o nome da tela
        SAVE SCREEN TO Screens->Image         // Guarda uma tela
        //
        <declaraçoes>...
        //
        SEEK "Screen001"                      // Acha a tela
        RESTORE SCREEN FROM Screens->Image    // Restaura

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

See Also: RESTORE SAVE RESTSCREEN() SAVESCREEN()