SET CONSOLE
 Comuta a exibiçao do console para a tela
------------------------------------------------------------------------------

 Sintaxe

     SET CONSOLE ON | off | <xlComuta>

 Argumentos

     ON exibe a saída dos comandos de console na tela.

     OFF suprime a visualizaçao em tela dos comandos de console.

     <xlComuta> é uma expressao lógica entre parênteses. O valor
     verdadeiro (.T.) é o mesmo que ON, e o valor falso (.F.) tem o mesmo
     significado que OFF.

 Descriçao

     SET CONSOLE determina se os comandos de console serao ou nao enviados
     para a tela. Os comandos de console sao aqueles exibidos em tela sem a
     referência de posicionamento de linha e coluna. Além do envio de algo
     para a tela, podemos citar que os comandos de console podem também ser
     enviados simultaneamente para a impressora e/ou para um arquivo texto
     do DOS. A saída é enviada para a impressora utilizando a cláusula TO
     PRINTER, comum à maioria dos comandos de console, ou utilizando o
     comando SET PRINTER ON. A saída é enviada para um arquivo quando
     utilizamos a cláusula TO FILE, SET ALTERNATE, ou SET PRINTER TO.

     Com o CONSOLE ON (ativado), os comandos de console sao exibidos na
     tela. Com o CONSOLE OFF (desativado), a exibiçao dos comandos de
     console sao suprimidos, mas o ecoamento da saída para um arquivo ou
     para a impressora nao é afetado. Isto permite a você enviar como saída
     os comandos de console tal como REPORT e LABEL FORM para a impressora
     sem que sejam exibidos na tela --como costuma ocorrer.

 Notas

       Entradas via teclado: Para os comandos de console que
        aceitam entrada via teclado (incluindo ACCEPT, INPUT, e WAIT), o SET
        CONSOLE afeta tanto a exibiçao dos prompts como as áreas de entrada
        de dados. Consequentemente, se houver um SET CONSOLE OFF antes de um
        desses comandos nao irá somente evitar que você visualize o que está
        digitando, como também evitará a exibiçao da mensagem emitida por
        este prompt.

       Comandos de tela: Comandos de tela tais como o @...SAY
        sao exibidos independentemente da configuraçao do SET CONSOLE
        corrente. Para esta categoria de comandos de saída, o controle do
        dispositivo (DEVICE) é realizado utilizando o SET DEVICE para
        indicar se a saída se dará na tela ou na impressora, e o SET PRINTER
        TO para ecoar a saída para um arquivo.

 Exemplos

     Este exemplo utiliza o comando REPORT FORM para enviar à impressora
     registros de um arquivo de banco de dados enquanto é suprimida a
     exibiçao em tela:

     USE Sales NEW
     SET CONSOLE OFF
     REPORT FORM Sales TO PRINTER
     SET CONSOLE ON

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

See Also: SET DEVICE