LABEL FORM 
 Muestra etiquetas en la consola
------------------------------------------------------------------------------
 Sintaxis

     LABEL FORM <xcEtiqueta>
        [TO PRINTER] [TO FILE <xcFichero>] [NOCONSOLE]
        [<ámbito>] [WHILE <lCondición>] [FOR <lCondición>]
        [SAMPLE]

 Argumentos

     <xcEtiqueta> es el nombre de un fichero de etiquetas (.lbl) que
     contiene la definición de la etiqueta y puede especificarse como un
     nombre de fichero literal o como una expresión de caracteres encerrada
     entre paréntesis. Si no se utiliza una extensión, se toma por defecto
     .lbl.

     TO PRINTER envía la salida a la impresora.

     TO FILE <xcFichero> envía la salida a <xcFichero>. Especifique
     <xcFichero> como un nombre de fichero literal o como una expresión de
     caracteres encerrada entre paréntesis. Si no se utiliza una extensión,
     se supone .txt.

     NOCONSOLE suprime todas las salidas de LABEL FORM a la consola. Si
     no se especifica, la salida se muestra automáticamente en la pantalla,
     a menos que SET CONSOLE esté desactivado (OFF).

     <ámbito> es la parte del fichero actual de base de datos del que se
     van a mostrar las etiquetas. El valor por defecto es todos los
     registros (ALL).

     WHILE <lCondición> especifica el conjunto de registros que cumplen
     la condición desde el registro actual hasta que la condición no se
     cumpla.

     FOR <lCondición> especifica a LABEL FORM el conjunto condicional de
     registros dentro del ámbito especificado.

     SAMPLE muestra etiquetas de prueba como filas de asteriscos. Cada
     una de estas etiquetas tiene el mismo número de filas y columnas que la
     definición de etiqueta. Después de visualizar cada etiqueta de prueba,
     aparece la pregunta "¿Do you want more samples?". Responda "Y" si
     desea mostrar otra etiqueta o "N" para que LABEL FORM muestre las
     etiquetas con los valores reales para el ámbito y condición
     especificados.

 Descripción

     LABEL FORM es un mandato de consola que accede secuencialmente a los
     registros en el área de trabajo actual, mostrando las etiquetas por
     medio de una definición almacenada en un fichero .lbl. Cree el fichero
     .lbl utilizando RL.EXE o con dBASE III PLUS. Consulte el capítulo
     "Utilidad de Informes y Etiquetas" en la Guía de Programación y
     Utilidades si desea más información sobre la creación de definiciones
     de etiqueta.

     Cuando se invoca, la salida se envía a la pantalla y, opcionalmente, a
     la impresora y/o a un fichero. Para eliminar la salida por pantalla
     mientras se imprime o se envía la salida a un fichero, seleccione SET
     CONSOLE OFF antes de invocar LABEL FORM o utilice la palabra clave
     NOCONSOLE.

     Cuando se invoca, LABEL FORM busca en la unidad y directorio
     establecido por  SET PATH si <xcEtiqueta> no se encuentra en el
     directorio actual y no se ha especificado la vía.

 Notas

     ■ Interrupción de LABEL FORM: Para interrumpir un mandato LABEL
        FORM, utilice INKEY() como parte de una condición FOR para comprobar
        la pulsación de una tecla de interrupción. Consulte el ejemplo
        siguiente.

     ■ Margen de impresora: LABEL FORM utiliza el valor actual de SET
        MARGIN para la salida dirigida a la impresora.

Ejemplos

      Este ejemplo imprime un conjunto de etiquetas y las escribe en
        un fichero con un solo mandato. Se utilizan dos formas del mandato:

        LOCAL cEtiqueta := "Ventas", cFichero := "Ventas"
        USE Ventas INDEX Ventas NEW
        LABEL FORM Ventas TO PRINTER TO FILE Ventas
        LABEL FORM (cEtiqueta) TO PRINTER TO FILE (cFichero)

      Este ejemplo interrumpe LABEL FORM utilizando INKEY() para
        comprobar si el usuario ha pulsado la tecla Esc:

        #define K_ESC 27
        USE Ventas INDEX Ventas NEW
        LABEL FORM Ventas WHILE INKEY() != K_ESC

Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: REPORT FORM SET PRINTER