4D Doc Center : SET PRINT OPTION

4D v13.4

SET PRINT OPTION


SET PRINT OPTION ( opcion ; valor1 {; valor2} )

Parámetro	Tipo	Descripción
opcion	Entero largo, Cadena	Número de opción o código de opción PDF
valor1	Entero largo, Cadena	Valor 1 de la opción
valor2	Entero largo, Cadena	Valor 2 de la opción

Descripción

El comando SET PRINT OPTION se utiliza para modificar por programación el valor de una opción de impresión.
Cada opción definida utilizando este comando se aplica a toda la base y durante toda la sesión siempre que no se llame otro comando que modifique los parámetros de impresión (PRINT SETTINGS, PRINT SELECTION sin el parámetro > parámetro, etc.).

El parámetro opcion le permite indicar la opción a modificar. Puede pasar una de las constantes predefinidas del tema “Opciones de impresión Opciones de impresión”, o un código de opción PDF (utilizable con el driver PDFCreator bajo Windows únicamente).
Pase en los parámetros valor1 y valor2 (opcionalmente) los nuevos valores de la opcion especificada. El número y naturaleza de los valores pasados depende del tipo de opción especificada.

Utilizar un número de opción (constante)

La siguiente tabla lista las opciones y sus posibles valores:

Opción (constante)	valor1	valor2
1 (Paper option)	Nombre	-
	Ancho	Alto
2 (Orientation option)	1=Vertical, 2=Horizontal	-
3 (Scale option)	Número (%)	-
4 (Number of copies option)	Número	-
5 (Paper source option)	Windows únicamente:
	Índice (número)	-
8 (Color option)	Windows únicamente:
	1=N/B, 2=Color	-
9 (Destination option)	1=Impresora,	-
	2=Archivo (PC)/PS (Mac),	Ruta de acceso
	3=Archivo PDF,	Ruta de acceso
	5=Pantalla (Mac)	-
11 (Double sided option)	Windows únicamente:
	0=Single-sided (estándar)	-
	1=Double-sided	Binding: 0=Izquierda, 1=Arriba
12 (Spooler document name option)	Nombre del documento a imprimir	-
13 (Mac spool file format option)	0=modo PDF, 1= modo PostScript	-
14 (Hide printing progress option)	0=Mostrar (por defecto), 1=Ocultar	-

Paper option (1): la lista de todos los nombres de papeles disponibles puede obtenerse utilizando el comando PRINT OPTION VALUES.
Puede pasar el nombre del papel en valor1 (y, en este caso, omitir valor2), o pasar el largo del papel en valor1 y su ancho en valor2. La altura y ancho debe ser expresada en píxeles de pantalla.
Orientation option (2): puede pasar 1 (Portrait), o 2 (Landscape) en valor1.
Scale option (3): pase un porcentaje en valor1. Atención, algunas impresoras no permiten modificar la escala. Si pasa un valor inválido, la propiedad se reajusta al 100% en el momento de la impresión..
Number of copies option (4): pase el número de copias a imprimir en valor1.
Paper source option (5): pase el número correspondiente al índice, en el array de bandejas devuelto por el comando PRINT OPTION VALUES, de la bandeja de papel a utilizar.
Nota: esta opción sólo puede utilizarse en Windows.
Color option (8): en valor1, pase el código especificando el modo para administrar el color: 1=Blanco y negro (monocromo), 2=Color.
Nota: esta opción sólo puede utilizarse en Windows.
Destination option (9): en valor1, pase el código especificando el tipo de destino de impresión: 1=Impresora, 2=Archivo (PC)/PS (Mac), 3=PDF Archivo , 5=Pantalla (opción de driver Mac OS X).
Si valor1 es diferente de 1 ó 5, pase en valor2 la ruta de acceso para el documento resultante. Esta ruta será utilizada hasta que otra ruta se especifique. Si ya existe un archivo con el mismo nombre en la ubicación de destino, se remplazará.
Nota: en Windows, puede definir el destino de la impresión en 3 (Archivo PDF) cuando el driver PDF Creator se ha instalado a partir de la versión 12 de 4D. Este parámetro es obligatorio para que 4D pueda controlar la impresión vía PDF Creator bajo Windows. Cuando se pasan los valores (9;3;ruta), 4D lanza automáticamente una impresión PDF "silenciosa" y tiene en cuenta los códigos de opciones pasados eventualmente (note que si pasa una cadena vacía en valor2 u omite este parámetro, aparece una caja de diálogo de guardar archivo en el momento de la impresión. Después de la impresión, los parámetros actuales se restauran. Esto simplifica el control de las impresiones PDF por 4D y permite escribir código multiplataforma.
Si no se pasan los valores (9;3;ruta), la impresión no es controlada por 4D y los posibles códigos de opciones de PDF Creator se ignoran.
Double sided option (11): puede pasar 0 (Single-sided o standard), o 1 (Double-sided) en valor1. Si valor1 es igual a 1, puede definir la referencia a aplicar utilizando valor2: 0=Left binding (valor por defecto), 1=Top binding.
Nota: esta opción sólo puede ser utilizada bajo Windows.
Spooler document name option (12): pase en valor1, el nombre del documento de impresión que debe aparecer en la lista de documentos del spooler.
Para utilizar o restablecer la operación estándar (utilizando el nombre del método en el caso de un método, el nombre de la tabla para un registro, etc.), pase una cadena vacía en valor1.
Advertencia: el nombre definido por esta instrucción será utilizado para todos los documentos de impresión de la sesión mientras no se pase un nuevo nombre o una cadena vacía.
Mac spool file format option (13): en valor1, pase 0 para fijar el trabajo de impresión en modo PDF (valor por defecto) y 1 para “forzar” el trabajo de impresión en modo PostScript. Esta opción no tiene efecto bajo Windows.
Nota: bajo Mac OS X, la impresión se realizar por defecto como un PDF. Sin embargo, el driver de impresión PDF no soporta imágenes PICT encapsuladas con información PostScript, estas imágenes son generadas, más particularmente, por software de dibujo vectorial.
Para evitar este problema, esta opción le permite modificar el modo de impresión bajo Mac OS X para la sesión actual. Recuerde que la impresión en modo PostScript puede traer efectos indeseables.
Hide printing progress option (14): pase 1 en valor1 para ocultar las ventanas de progreso y 0 para mostrarla nuevamente (operación por defecto). Esta opción es particularmente útil en el caso de impresión PDF bajo Mac OS X.
Nota: ya existe una opción de progreso de impresión accesible vía la caja de diálogo de Propiedades de la base (página Interfaz). Sin embargo, se aplica globalmente a la aplicación y no oculta todas las ventanas bajo Mac OS X.

Una vez fijado utilizando este comando, una opción de impresión se conservará durante toda la sesión para toda la aplicación 4D. Será utilizada por los comandos PRINT SELECTION, PRINT RECORD, Print form y QR REPORT, como también por la impresión de 4D, incluyendo en modo Diseño.

Notas:

Es indispensable utilizar el parámetro opcional > con los comandos PRINT SELECTION, PRINT RECORD y PAGE BREAK para evitar reinicializar las opciones de impresión que fueron definidas utilizando el comando SET PRINT OPTION.
El comando SET PRINT OPTION sólo opera con impresoras PostScript.

Utilizar un código de opción PDF (Windows)

Para poder utilizar un código de opción PDF en el parámetro opcion, debe haber instalado el driver PDFCreator en su entorno 4D (para mayor información, consulte la sección Integración del driver PDFCreator bajo Windows ).
Además, para que el código de opción sea tenido en cuenta, debe haber activado el driver de impresión PDF para 4D vía la siguiente instrucción:

SET PRINT OPTION(Destination option;3;nomArchivo)

De lo contrario, los códigos de opción se ignoran.

Un código de opción PDF es un valor de tipo texto que consta de dos partes, TipoOpcion y NombreOpción, combinados como "TipoOpcion:NombreOpcion". Esta es la descripción de este código:

TipoOpcion indica si usted especifica una opción nativa de PDFCreator o una opción de administración PDF de 4D. Se aceptan dos valores:
- PDFOptions = opción nativa
- PDFInfo = opción interna.
NombreOpcion especifica la opción a definir (dependiendo del valor de TipoOpcion).
- Si TipoOpcion = PDFOptions, puede pasar una de las numerosas opciones nativas de PDFCreator. Por ejemplo, la opción UseAutosave afecta el backup automático. Para poder modificar esta opción, pase "PDFOptions:UseAutosave" en el parámetro opcion y el valor a utilizar en el parámetro valor1. Para una descripción completa de las opciones nativas de PDFCreator, consulte la documentación del driver PDFCreator.
- Si TipoOpcion = PDFInfo, puede pasar en NombreOpcion uno de los siguientes selectores específicos:

Nota: luego de cada impresión, 4D restablece automáticamente los parámetros anteriores del driver PDFCreator con el fin de evitar toda interferencia con los otros programas que utilizan PDFCreator.

Ejemplo

El siguiente método activa el driver PDF de manera que para imprimir todos los registros de la tabla en la ubicación C:\Test_PDF_X donde X es el número de secuencia del registro:

 SET CURRENT PRINTER(PDFCreator Printer Name)

  // Bajo Windows, seleccione la impresora virtual instalada por PDFCreator

 If(OK=1) // Si PDFCreator está instalado</p><p>ALL RECORDS([Table_1])

    For($i;1;Records in selection([Table_1]))

       SET PRINT OPTION(Destination option;3;"C:\\Test\\Test_PDF_"+String($i))

  // La opción de destino 3 lanza una tarea de impresión PDFCreator

       PRINT RECORD([Table_1];*)

       NEXT RECORD([Table_1])

    End for

  // Reinicialización de las opciones del driver PDFCreator

    SET PRINT OPTION("PDFInfo:Reset standard options";0)

 End if

Variables y conjuntos del sistema

La variable sistema OK toma el valor 1 si el comando ha sido ejecutado correctamente; de lo contrario, toma el valor 0.

Si pasa un código de opción invalido (opción no reconocida por PDFCreator por ejemplo), OK toma el valor 0.

Gestión de errores

Si el valor pasado por una opción es incorrecto o si no está disponible en la impresora, el comando devuelve un error (que puede interceptar utilizando un método de gestión de errores instalado por el comando ON ERR CALL) y el valor actual de la opción permanece sin cambios.