LABEL FORM
 Emite etiquetas
------------------------------------------------------------------------------

 Sintaxe

     LABEL FORM <xcArquivo>
        [TO PRINTER] [TO FILE <xcArquivo>]
        [<abrangência>] [WHILE <lCondiçao>] [FOR <lCondiçao>]
        [SAMPLE]

 Argumentos

     <xcArquivo> é o nome do arquivo de etiquetas (.lbl) que contém a
     definiçao da forma da etiqueta e pode ser especificado literalmente ou
     por expressao caractere entre parênteses.  Se nao for especificada
     extensao, será assumido (.lbl).

     TO PRINTER envia a saída para a impressora.

     TO FILE <xcArquivo> envia a saída para <xcArquivo>.  <xcArquivo>
     pode ser especificado literalmente ou por uma expressao caractere entre
     parênteses.  Se nao for especificada extensao, será assumido (.txt).

     <abrangência> é a parte do arquivo de dados corrente que deverá ser
     usado.  O padrao é todos (ALL) os registros.

     WHILE <lCondiçao> especifica o conjunto de registros que atendem a
     condiçao do registro corrente até que a condiçao seja falsa.

     FOR <lCondiçao> especifica o conjunto condicional de registros de
     onde serao tiradas as informaçoes para etiquetas dentro da abrangência
     dada.

     SAMPLE emite etiquetas com conteúdo de asteriscos.  Cada etiqueta
     texto tem o mesmo número de colunas e linhas da definiçao da etiqueta.
     Após cada exibiçao de etiqueta texto, aparece a pergunta, "Deseja mais
     amostras?"  A resposta nao "N" faz o comando LABEL FORM exibir as
     etiquetas reais para a condiçao e abrangência especificadas.

 Descriçao

     LABEL FORM é um comando de console que acessa sequencialmente registros
     na área de trabalho corrente, exibindo etiquetas que usam uma definiçao
     armazenada num arquivo (.lbl).  Este arquivo pode ser criado usando-se
     RL.EXE.  Consulte o capítulo Utilitário de Relatórios e Etiquetas no
     livro Programando e Utilitários para mais informaçoes sobre a criaçao
     de definiçoes de etiquetas.

     Quando chamada, a saída é enviada para a tela e opcionalmente para a
     impressora e/ou para um arquivo.  Para evitar que a saída apareça na
     tela enquanto esta estiver sendo impressa ou enviada para um arquivo,
     use o comando SET CONSOLE OFF antes de usar o comando LABEL FORM.

     Quando chamado, o comando LABEL FORM procura no diretório e disco
     correntes, caso o arquivo <xcArquivo> nao seja encontrado no diretório
     corrente e o path nao tenha sido especificado.

 Notas

       Interrompendo LABEL FORM: Para interromper o comando
        LABEL FORM, use a funçao INKEY() como parte da condiçao FOR,
        verificando se acontece a interrupçao ao toque de uma tecla.  Veja o
        exemplo abaixo.

       Margem da impressora: Sendo LABEL FORM um comando de
        console, ele obedece ao que estiver especificado correntemente por
        SET MARGIN para saídas repetidas para a impressora.

 Exemplos

       O seguinte exemplo imprime um conjunto de etiquetas e
        escreve-as num arquivo com um único comando. Duas formas do comando
        sao mostradas:

        USE Sales INDEX Sales NEW
        LABEL FORM Sales TO PRINTER TO FILE Sales
        LABEL FORM Sales TO PRINTER TO FILE Sales

       Este exemplo demonstra como interromper um comando LABEL FORM
        usando a funçao INKEY() para verificar se o usuário teclou Esc:

        #define K_ESC  27
        USE Sales NEW
        LABEL FORM Sales FOR INKEY() != K_ESC

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

See Also: REPORT FORM SET PRINTER