Comandos para a Configuração do Ambiente Clipper

                                                                                                

SET ALTERNATE

 

SET ALTERNATE abre um arquivo-texto (.TXT) que receberá todas as saídas de dados envidas para o console. Esse comando apenas abre o arquivo-texto. Para ativar a gravação dos dados. É necessário o uso do comando SET ALTERNATE ON.

 

Sintaxe: SET ALTERNATE TO [<nomearq>]

 

 

SET ALTERNATE ON/OFF

 

Ativa a gravação das saídas de dados no arquivo aberto pelo comando SET ALTERNATE TO. O texto gravado estará no formato ASCII.

 

Sintaxe: SET ALTERNATE ON/OFF

 

 

SET BELL

 

Esse comando ativa ou desativa a emissão do beep quando um campo é totalmente preenchido em um comando READ ou quando é dado inválido e detectado pela cláusula <valid> ou <range>

 

Sintaxe: SET BELL ON/OFF/<1Exp>

 

 

SET CENTURY

 

Permite a digitação e exibição de datas com prefixo do século. As datas suportadas pelo Clipper devem estar entre 01/01/0100 a 31/12/2999. O formato da data deve ser especificado pelo comando SET DATE.

 

Sintaxe: SET CENTURY ON/OFF/<lExp>

 

 

SET COLOR

 

Determina as cores para um vídeo policromático ou os atributos de um vídeo monocromático exibidas pelo Clipper.

 

Sintaxe:                SET COLOR TO [[<standard>][,<enhanced>][,<borda>][,<background>][,<unselected>]]                             /<colortring>

 

 

SET CONFIRM

 

Determina quando o operador deve confirmar o conteúdo de uma variável de memória ou campo pelo pressionamento de <enter>. Se CONFIRM estiver desativado, o cursor será movido automaticamente para o campo seguinte quando o cursor encontrar o final do campo.

 

Sintaxe: SET CONFIRM ON/OFF /<1Exp>

 

 

SET CONSOLE

 

Ativa ou desativa a exibição de dados no vídeo. Esse comando normalmente é utilizado quando um relatório está sendo impresso e não se quer o envio de dados para a tela ou para evitar o envio de mensagens de mensagens geradas por comandos para a tela.

 

Sintaxe: SET CONSOLE ON/OFF/<lExp>

 

 

SET CURSOR

 

Ativa ou desativa a exibição do cursor

 

Sintaxe:                SET CURSOR ON/OFF / <lExp>

 

            Em telas onde dados ou menus são apenas exibidos, a presença do cursor "suja" a tela. Idealmente, um cursor deveria aparecer apenas em comandos de edição de dados.

 

 

SET DATE

 

Especifica o formato de variáveis e campos do tipo Data.

 

            Esse comando permite a especificação de seis formatos de data que são exibidos a seguir:

 

                AMERICAN        MM/DD/YY

                ANSI                     YY.MM.DD

                BRITISH              DD/MM/AA

                FRENCH              DD.MM.AA

                GERMAN             DD.MM.YY

                ITALIAN              DD-MM-YY

                JAPAN                  YY/MM/DD

                USA                       MM-DD-YY

 

Sintaxe: SET DATE [to] AMERICAN/ansi/british/italian/french/german/usa

 

 

 

SET DATE FORMAT [TO] <string>

 

O segundo formato do comando é usado para que seja especificado dentro de uma string exatamente o formato da data desejada, incluindo a quantidade de dígitos para o ano.

 

 

SET DECIMALS

 

Determina o número mínimo de casas decimais exibidas como resultado de cálculos ou funções envolvendo divisão ou as funções LOG, EXP ou SQRT.

 

Sintaxe: SET DECIMALS TO <nExp>

 

 

SET DEFAULT

 

Estabelece o drive em que todas as operações com arquivos serão realizadas, a menos que outro drive seja especificado.

 

Sintaxe: SET DEFAULT TO <drive>

 

 

SET DELETED

 

Determina se os registros marcados para deleção devem ser desativados, ou seja, faz com que eles sejam transparentes para comandos que pesquisem ou acessem o arquivo.

 

Sintaxe: SET DELETED ON/OFF /<lExp>

 

 

SET DELIMITERS

 

Permite a ativação de caracteres que serão usados para a delimitação de campos e variáveis em comandos GET.

 

Sintaxe: SET DELIMITERS ON/OFF /<lExp>

 

 

SET DELIMITERS TO

 

Determina se os campos em comandos do tipo Full Screen serão cercados por delimitadores. Podem ser especificados um ou dois delimitadores. Se apenas um for especificado, ele será usado no ínicio e fim do campo. Se forem especificados dois, o primeiro será usado no começo e o segundo no final do campo.

 

Sintaxe: SET DELIMITERS TO [<delimitador>] [DEFAULT]

 

 

SET DEVICE

 

Determina se os comandos @...SAY devem ser exibidos na tela ou na impressora. Quando PRINT estiver selecionado os comandos GET serão ignorados. Se os dados estiverem sendo enviados para a impressora e for especificado um número de linha menor do que o último especificado, ocorrerá um avanço de página.

 

Sintaxe: SET DEVICE TO SCREEN / print

 

 

SET EPOCH

 

Este comando permite controlar melhor as datas que não possuem o ano com quatro dígitos.

 

Sintaxe: SET EPOCH TO <nAno>

 

 

SET ESCAPE

 

Determina quando o pressionamento de <alt c> interromperá a execução de um programa ou, em um comando GET, causará a desconsideração da cláusula <valid>. Se SET ESCAPE estiver OFF, apenas o desligamento do computador interromperá o programa.

 

Sintaxe: SET ESCAPE ON/OFF / <lExp>

 

 

SET EXACT

 

Determina se a comparação de duas strings deve ser feita tomando o tamanho inteiro de ambas ou apenas parte das mesmas.

 

Sintaxe: SET EXACT ON/OFF / <lExp>

 

 

SET EXCLUSIVE

 

Em um ambiente de rede, determina os quando os arquivos serão abertos no modo exclusivo ou partilhado. O modo que um arquivo está aberto é determinado pelo status da opção exclusive quando da sua abertura. ON indica que o arquivo será aberto da forma não compartilhada, enquanto que OFF abre o arquivo de forma compartilhada. Use a opção exclusive do comando USE em vez desse comando.

 

Sintaxe: SET EXCLUSIVE ON/OFF / <lExp>

 

 

SET FILTER

 

Estabelece uma ou mais condições que determinam quando um registro deve ser considerado para processamento pelos comandos do Clipper. Com um filtro ativado, os registros que não passarem na condição de filtro serão ignorados pelos comandos que usam o arquivo.

 

Sintaxe: SET FILTER TO [<condição>]

 

 

SET FIXED

 

Determina o número de casas decimais a ser usado para todas as saídas numéricas. Quando ativado, o número de decimais utilizado é aquele especificado pelo comando SET DECIMALS. Se SET DECIMALS for omitido, o número de casas decimais será duas.

 

Sintaxe: SET FIXED ON/OFF / <lExp>

 

 

SET FORMAT

 

Ativa um arquivo de formato de tela quando um READ é executado. Para desativar um arquivo de formato, deve ser usado o comando SET FORMAT TO sem a especificação de um nome de arquivo.

 

Sintaxe: SET FORMAT TO [<nomearq>]

 

 

SET FUNCTION

 

Reprograma uma tecla de função. A tecla F1 não é reprogramável, pois é a tecla de HELP. A expressão a ser atribuída à tecla deve vir entre aspas ou apóstrofos e pode conter mais de 30 caracteres.

 

Sintaxe: SET FUNCTION <nExp> TO <cExp> [;]

 

 

SET INDEX

 

Abre o índice especificado relacionado ao arquivo em uso. Mais de um arquivo índice pode ser aberto ao mesmo tempo. Nesse caso, separe o nome dos arquivos com vírgula.

 

            Podem ser abertos até 15 índices simultaneamente para cada arquivo. Quando um índice está aberto, todas as mudanças feitas em campos-chave automaticamente o atualizam.

 

Sintaxe: SET INDEX TO [<lista>] [ADDITIVE]

 

            A cláusula ADDITIVE adiciona o índice ou lista especificadas na lista atual. Sem essa cláusula, a lista atual é fechada para abertura de nova lista/índice.

 

 

SET INTENSITY

 

Determina quando os campos de edição (enhanced display) GETS e os prompts serão exibidos em vídeo reverso para operações de entrada de dados. Quando desativados, os atributos da área standard são usados em toda a tela.

 

Sintaxe: SET INTENSITY ON/OFF / <lExp>

 

 

SET KEY

 

Permite que uma procedure seja acionada pelo pressionamento de uma tecla específica durante um comando de "wait state", ou seja, ACCEPT, INPUT, MENUT TO, READ WAIT, ACHOICE(), DBEDIT() e MEMOEDIT().

 

Sintaxe: SET KEY <nExp> TO [<idProc>]

 

 

SET MARGIN

 

Estabelece o tamanho da margem esquerda para a impressão de relatórios. O valor default é zero.

 

Sintaxe: SET MARGIN TO <nExp>

 

 

SET MESSAGE

 

Esse comando é usado juntamente com o comando PROMPT e serve para indicar em que linha deverão ser exibidas as mensagens especificadas pela clásula MESSAGE do comando PROMPT.

 

Sintaxe: SET MESSAGE TO <nExp> [CENTER]

 

 

SET ORDER

 

Especifica qual dos índices abertos será o novo índice Master. O valor especificado pode variar entre 0 e 15, sendo que, se 0 for especificado, o arquivo é tratado como se não estivesse indexado, apesar de os índices continuarem abertos. Se for usado um RDD do FOX ou dBase IV, as opções TAG e IN podem ser usadas para especificar o nome do subíndice e arquivo de índices múltiplos.

 

Sintaxe:                SET ORDER TO [<nExp>] [TAG <cNomeind>] [IN <cNomearqind>]

 

 

SET PATH

 

Define o caminho de busca que deve ser usado pelo Clipper para abrir arquivos não encontrados no diretório atual.

 

Sintaxe: SET PATH TO [<path>]

 

 

SET PRINTER ON

 

Determina quando a saída de dados não formatada por comandos ? ou ?? deve ser enviada para a impressora. Para evitar que os dados enviados para a impressora ecoem na tela, use também o comando SET CONSOLE OFF junto com esse comando.

 

Sintaxe:                SET PRINTER ON/OFF / <lExp>

 

 

SET PRINTER TO

 

Seleciona um dispositivo do DOS como saída de impressão. Os dispositivos disponíveis são as saídas paralelas LPT1, LPT2, LPT3 e as saídas seriais COM1 e COM2. Se o arquivo foi redirecionado para um arquivo texto previamente, a opção ADDITIVE adiciona o texto ao arquivo ao invés de sobregravá-lo.

 

Sintaxe: SET PRINTER TO [<dispositivo DOS>]

                                               [ \ \ SPOOLER / <nome do computador> /

                                               <nome da impressora>=<dispositivo DOS>]

                                                               [ADDITIVE]

 

 

SET PROCEDURE

 

Abre um arquivo de procedure e compila suas procedures e funções para dentro do arquivo OBJ atual.

 

Sintaxe: SET PROCEDURE TO <nomearq>

 

 

SET RELATION

 

Liga dois ou mais arquivos abertos através de um campo-chave comum ou pelo número do registro. No Clipper podem ser relacionados até oito arquivos ao arquivo em uso, enquanto no dBase apenas um pode ser relacionado. O arquivo atual é chamado arquivo pai e os arquivos ligados a ele, filhos.

 

Sintaxe: SET RELATION TO [<cChave> |  <RECNO()> | <nExp>] INTO <ALIAS> ] [ADDITIVE]

 

 

SET SCOREBOARD

 

Determina se as mensagens do Clipper serão exibidas ou não na Linha de STATUS (linha 0).

 

Sintaxe: SET SCOREBOARD ON/OFF / <lExp>

 

 

SET SOFTSEEK

 

Permite uma pesquisa relativa em um banco de dados indexado.

 

Sintaxe: SET SOFTSEEK ON / OFF / <lExp>

 

 

SET TYPEHEAD

 

Especifica o tamanho do buffer de teclado. O tamanho máximo do buffer é 4.096 bytes.

 

Sintaxe: SET TYPEHEAD TO <nExp>

 

 

SET UNIQUE

 

Determina quando um índice pode conter chaves duplicadas.

 

            Com SET UNIQUE ativado, apenas o primeiro registro que contém a chave será incluido no índice durante um comando INDEX.

 

Sintaxe: SET UNIQUE ON/ OFF / <lExp>

 

 

SET WRAP

 

Ativa/desativa o rolamento do cursor em um menu gerado por @PROMPT.

 

Sintaxe: SKIP [<nRegistro>] [ALIAS <idAlias>]

 

 

 

SETBLINK( )

 

Ativa ou desativa o efeito do asterisco(*) durante a especificação de intensidade ou vídeo pulsante em um comando ou função SETCOLOR( ).

 

Sintaxe: SETBLINK(<lexp>)

 

 

 

 

SETCANCEL( )

 

Ativa ou desativa as teclas ALT-C como forma de se terminar um programa. Se o argumento fornecido for (.f.), o pressionamento de ALT-C não cancelará o programa. O comando SET KEY tem precedência sobre o comando ALT-C.

 

Sintaxe: SETCANCEL(<expL>)

 

 

SETCOLOR( )

 

Retorna uma string contendo a definição de cores estipulada ativa. Se o argumento for especificado, ele deve conter apenas letras para especificar o ajuste das cores. Números não são permitidos como parâmetros, apenas letras.

 

Sintaxe: SET COLOR([<expC>])

 

            A <expC> deve seguir a mesma sintaxe do comando SET COLOR, especificando as cores das áreas STANDARD, ENHANCED, BORDER, BACKGROUND e UNSELECT. As cores de frente e fundo devem ser separadas por uma barra (/).

 

 

SETCURSOR

 

Essa função ajusta a forma e o tamanho do cursor.

 

Sintaxe: SETCURSOR([<tipo_cur>])

 

            <TIPO_CUR> Indica o tipo do cursor a ser ativado. O argumento fornecido deve respeitar a tabela seguinte:

 

Tipo                            Valor                          Constante Manifesta

Nenhum                      0                                 SC_NONE

Sublinhado                 1                                 SC_NORMAL

Meio bloco inf.           2                                 SC_INSERT

BLOCO INTEIRO    3                                 SC_SPECIAL1

Meio bloco sup.          4                                 SC_SPECIAL2

 

            As constantes dessa tabela são definidas no arquivo Cursor.ch

 

 

SETKEY( )

 

Atribui um code block a uma determinada tecla.

 

Sintaxe: SETKEY(<Cod_tecla>,[<bBloco>])

 

            <COD_TECLA> É o valor INKEY( ) retornado pela tecla a ser alterada.

            <BLOCO> É o nome do code block que será executado quando a tecla for pressionada.

            A tecla configurada é acionada somente a partir de algum comando que gere estado de espera, como READ, WAIT, ACHOICE( ) etc. Até 32 teclas podem estar configuradas.

 

 

SETMODE( )

 

Ajusta o vídeo para o número de linhas e colunas especificadas.

 

Sintaxe: SETMODE(<lin>,<col>)

 

 

SETPOS ( )

 

Move o cursor para a posição especificada. É semelhante à SETPRC, só que atua no vídeo.

 

Sintaxe: SETPOS(<lin>,<col>)

 

 

SETPRC( )

 

Ajusta os valores das funções PROW( ) e PCOL( ) para os valores fornecidos como argumentos.

 

Sintaxe: SETPRC(<expN>,<expN>)

 

            Quando um eject é executado, os valores da linha e coluna se tornam 0.