Share via

LABEL (Comando)

  • Artículo

Imprime etiquetas desde un archivo de tabla y un archivo de definición de etiqueta.

LABEL [FORM FileName1 | FORM ?] [ENVIRONMENT] [Scope]
   [FOR lExpression1] [WHILE lExpression2] [NOCONSOLE]
   [NOOPTIMIZE] [PDSETUP] [PREVIEW [NOWAIT]] [NAME ObjectName]
   [TO PRINTER [PROMPT] | TO FILE FileName2]

Parámetros

  • FORM FileName1
    Especifica el nombre de un archivo de definición de etiqueta cuyas etiquetas se desea imprimir. La extensión predeterminada para un archivo de definición de etiquetas es .lbx. Si este archivo de definición de etiquetas está en una unidad distinta de la predeterminada o en un directorio distinto del actual, también deberá especificar el designador de unidad y el directorio.

  • FORM ?
    Muestra el cuadro de diálogo Abrir, en el que puede elegir un archivo de etiqueta existente.

  • ENVIRONMENT
    Se incluye por compatibilidad con las etiquetas de la versión 2.x. Para restaurar el entorno de datos asociado a una etiqueta de Visual FoxPro, establezca la propiedad AutoOpenTables del entorno de datos en el valor verdadero (.T.), que es el valor predeterminado. Para asegurarse de que el entorno de etiquetas está cerrado cuando se termina de imprimir una etiqueta, establezca la propiedad AutoCloseTables del entorno de datos en el valor verdadero (.T.), que también es el valor predeterminado.

    Cuando cree o modifique etiquetas, puede guardar el entorno de datos actual de Visual FoxPro con el archivo de definición de etiquetas. Al guardar el entorno de datos de Visual FoxPro se incluyen registros adicionales en la tabla de definición de etiquetas para todas las tablas y archivos de índice abiertos, el orden de índice y cualquier relación entre las tablas.

  • Scope
    Especifica un intervalo de registros. Solamente se imprimen los registros incluidos en el intervalo. Las cláusulas de alcance son: ALL, NEXT nRecords, RECORD nRecordNumber y REST. Para obtener más información acerca de las cláusulas de alcance, vea los temas en pantalla Scope (Cláusulas) e Introducción al lenguaje. Los comandos que incluyen Scope sólo actúan sobre la tabla del área de trabajo activa.

    El alcance predeterminado de LABEL es ALL (todos los registros).

  • FOR lExpression1
    Especifica una condición por la cual solamente se imprimen los registros que satisfacen la condición lógica lExpression1. Este argumento permite filtrar los registros que no desea imprimir.

    Rushmore optimizará una consulta creada con LABEL ... FOR si lExpression1 es una expresión optimizable. Para obtener el máximo rendimiento, utilice una expresión optimizable en la cláusula FOR.

    Si desea obtener más información, vea SET OPTIMIZE y Usar Rushmore para agilizar el acceso a los datos.

  • WHILE lExpression2
    Especifica una condición por la cual los registros se imprimen siempre y cuando la expresión lógica lExpression2 dé como resultado verdadero (.T.).

  • NOCONSOLE
    Suprime la presentación del resultado de la etiqueta en la ventana principal de Visual FoxPro o en una ventana definida por el usuario en el momento de imprimir etiquetas o de enviarlas a un archivo.

  • NOOPTIMIZE
    Desactiva la optimización Rushmore de LABEL.

    Si desea obtener más información, vea SET OPTIMIZE y Usar Rushmore para agilizar el acceso a los datos.

  • PDSETUP
    Carga una configuración del controlador de impresora.

    En Visual FoxPro, puede incluir PDSETUP de forma que pueda utilizar una configuración del controlador de impresora para imprimir etiquetas basadas en caracteres creadas en FoxPro para MS-DOS. PDSETUP se pasa por alto durante la impresión de etiquetas basadas en gráficos creadas en Visual FoxPro.

  • PREVIEW [NOWAIT]
    Muestra las etiquetas en una ventana de vista previa antes de imprimir, pero no imprime las etiquetas. Para imprimir las etiquetas, deberá volver a ejecutar LABEL sin la cláusula PREVIEW.

    En Visual FoxPro, se puede incluir la cláusula opcional NOWAIT para que, en tiempo de ejecución, Visual FoxPro no espere a que se cierre la ventana de vista previa de la página para continuar la ejecución del programa. En lugar de esto, Visual FoxPro continuará la ejecución del programa mientras esté abierta la ventana de vista previa de la página.

  • NAME ObjectName
    Especifica un nombre de variable de objeto para el entorno de datos de una etiqueta. El entorno de datos y los objetos del entorno de datos tienen propiedades y métodos, como AddObject, que necesitan establecerse o llamarse en tiempo de ejecución. La variable de objeto ofrece acceso a estas propiedades y métodos. Si no especifica NAME, Visual FoxPro usará un valor predeterminado para el nombre del archivo de etiqueta al que se puede hacer referencia en el código asociado a los eventos.

  • TO PRINTER [PROMPT]
    Envía una etiqueta a la impresora. Puede incluir la cláusula opcional PROMPT para mostrar el cuadro de diálogo Imprimir antes de que comience la impresión.

  • TO FILE FileName2
    Envía etiquetas basadas en caracteres creadas en FoxPro para MS-DOS al archivo de texto especificado con FileName2. El archivo que se crea cuando se incluye TO FILE tiene la extensión predeterminada .TXT.

Observaciones

Los archivos de definición de etiqueta se crean con MODIFY LABEL o CREATE LABEL.

Si ejecuta LABEL sin argumentos adicionales, aparecerá el cuadro de diálogo Abrir, que muestra una lista de los archivos de etiqueta existentes para que usted elija.

Vea también

CREATE LABEL | MODIFY LABEL | Scope (Cláusulas) | Introducción al lenguaje